TypeScript SDK Development SOP
Prerequisites
Read the module overview, then confirm the business owner, inputs, outputs, failure conditions, and permission boundary.
Procedure
- Import public APIs only from coremind-ai.
- Validate external configuration with parseAndValidate.
- Give every defineTool tool a JSON Schema and
effect, then inject an approval handler. - Exhaustively consume all six RunOutcome terminal states and structured events; do not handle only success and exceptions.
- For explicit Loops, verify state order, pause-resume, exhaustion, timeout, abort, and effect receipts.
- Do not depend on package-internal paths.
- Across processes, languages, or storage, transmit only
RunResult.snapshot; fully validate operation, outcome, metrics, evaluation, trace, checkpoints, artifacts, and extension receipts. - Run the listed module tests and
npm run check:modules. - Preserve trace, evaluation, and owner-approval evidence; do not publish without explicit authorization.
Stop conditions
Stop for unconfirmed business rules, non-reversible side effects, access outside the workspace, unavailable real credentials, or failed security gates. Ask the owner instead of expanding scope.