TypeScript SDK

状态：已发布的 0.3.0 稳定版；支持平台：Windows、Linux。macOS 尚未列为正式支持。

目的

通过 coremind-ai 单一门面在 Node 工程中嵌入 Runtime、工具、会话、显式 Loop、评测和事件。

公共接口

• CoreMindRuntime
• ChatSession
• defineTool
• checkProject
• runEvaluationSuite
• LoopConfig / LoopPhase
• RunSnapshot / createRunSnapshot
• 生命周期扩展与轻量实验公共接口

错误与边界

• runtime.run() 与 ChatSession.chat() 通过 RunResult.outcome 返回失败、暂停、中止、超时和预算耗尽，不要求调用方用异常判断运行终态
• 创建/配置等运行前错误仍使用 CoreMindError.code
• defineTool 必须提供结构化 effect 副作用声明
• loop_state、RunOutcome、稳定快照和 Effect Receipt 与 CLI/Python 共用同一 Runtime 语义
• 库门面只 re-export，不复制业务逻辑
• RunResult.snapshot 是纯 JSON；Protocol 会对终态、指标、Trace、Checkpoint、Artifact 和扩展收据执行完整嵌套校验，拒绝跨语言结构漂移

CoreMind 只提供机制、质量护栏和开发指导。业务目标、规则、数据字段、审批责任和最终验收由用户或业务负责人决定。

源码、测试与示例

• packages/coremind/src/index.ts
• packages/coremind-runtime/src/public-tool.ts
• packages/coremind/src/index.test.ts
• packages/coremind-runtime/src/public-tool.test.ts
• 模块示例
• Module example
• Agent Skill