{"_id":"@atom-workflow-agent/atom-sdk","name":"@atom-workflow-agent/atom-sdk","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@atom-workflow-agent/atom-sdk","version":"0.1.0","description":"Authoring API for typed, lifecycle-based atom packages.","license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/joekbits/atom-workflow-agent.git","directory":"packages/atom-sdk"},"homepage":"https://github.com/joekbits/atom-workflow-agent/tree/main/packages/atom-sdk#readme","bugs":{"url":"https://github.com/joekbits/atom-workflow-agent/issues"},"keywords":["atom","workflow","sdk","typescript"],"type":"module","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./testing":{"types":"./dist/testing/index.d.ts","default":"./dist/testing/index.js"}},"publishConfig":{"access":"public","provenance":true},"engines":{"node":">=22"},"dependencies":{"zod":"^4.0.0","@atom-workflow-agent/contracts":"0.1.0"},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"vitest run"},"_id":"@atom-workflow-agent/atom-sdk@0.1.0","_integrity":"sha512-6+FaLUJncxDPpGAJS3thvrOUSym9CMSsiKMyc/DVYp9SyNGlGOC/L3iE7iIKeY1D5AifLxF2lRe+KwaLhYGAsA==","_resolved":"/private/tmp/atomflow-npm-release-20260902-1720/atom-workflow-agent-atom-sdk-0.1.0.tgz","_from":"file:/private/tmp/atomflow-npm-release-20260902-1720/atom-workflow-agent-atom-sdk-0.1.0.tgz","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-6+FaLUJncxDPpGAJS3thvrOUSym9CMSsiKMyc/DVYp9SyNGlGOC/L3iE7iIKeY1D5AifLxF2lRe+KwaLhYGAsA==","shasum":"53ea9aca87f6ba4e861c5ecc2a9658efa77fb867","tarball":"https://registry.npmjs.org/@atom-workflow-agent/atom-sdk/-/atom-sdk-0.1.0.tgz","fileCount":44,"unpackedSize":71956,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCfqOc7BeBOccI5iUo2A+YZ4Ru5M4MTxWq78W/R8IYLZgIgUd0ACqHa+I8U51uxXuEgsdnLpziLuVBt1fdgARA5RFM="}]},"_npmUser":{"name":"joekbits","email":"wangfeihong868@foxmail.com"},"directories":{},"maintainers":[{"name":"joekbits","email":"wangfeihong868@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/atom-sdk_0.1.0_1788341360646_0.34273503974966846"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-02T09:29:20.470Z","0.1.0":"2026-09-02T09:29:20.775Z","modified":"2026-09-02T09:29:21.137Z"},"maintainers":[{"name":"joekbits","email":"wangfeihong868@foxmail.com"}],"description":"Authoring API for typed, lifecycle-based atom packages.","homepage":"https://github.com/joekbits/atom-workflow-agent/tree/main/packages/atom-sdk#readme","keywords":["atom","workflow","sdk","typescript"],"repository":{"type":"git","url":"git+https://github.com/joekbits/atom-workflow-agent.git","directory":"packages/atom-sdk"},"bugs":{"url":"https://github.com/joekbits/atom-workflow-agent/issues"},"license":"Apache-2.0","readme":"# @atom-workflow-agent/atom-sdk\n\n[English](README.md) | [简体中文](README.zh-CN.md)\n\n面向生命周期 Atom 与 Atom Package 的公开 TypeScript Authoring API。\n\n```bash\nnpm install @atom-workflow-agent/atom-sdk zod\n```\n\n## 职责\n\n- 使用 Zod 或 JSON Schema 输入输出契约定义 Atom。\n- 提供执行 Context、Artifact、暂停 helper 与 AtomExecutionError。\n- 从一个 Authoring Definition 派生稳定的用户、Planner 和 Runtime 投影。\n\n## 边界\n\n- 不发现 Package、不调度 Workflow，也不注入模型 Client、浏览器或文件系统 wrapper。\n- 需要模型的 Atom 将 `@atom-workflow-agent/acp-sdk` 或其他模型 SDK 作为普通依赖导入。\n- Worker 隔离不是权限沙箱。\n\n## 主要入口\n\n| 入口 | 用途 |\n| --- | --- |\n| `defineAtom` | 从一个 Authoring Definition 派生 Manifest、Catalog 与 Runtime 契约 |\n| `defineAtomPackage` | 将一个或多个独立 Atom 组成可发现 Package |\n| `createAtomLifecycleHelpers` | 在单元测试 Context 中构造 `continue`、Signal 和 HostTask transition |\n| `AtomExecutionError` | 表达带稳定错误码、重试属性和 JSON details 的预期技术失败 |\n| `@atom-workflow-agent/atom-sdk/testing` | `createFakeAtom`、`findUndescribedSchemaFields` 等测试专用工具 |\n\nAtom 可以直接使用 Zod 或 JSON Schema。每个命名字段都应提供业务描述；Runtime 会校验输入和最终输出，生命周期 transition 则由 Runtime 转换为持久化暂停协议。\n\n最小实现、Package 注册、独立 CLI 调试和测试方式见 [Atom 开发指南](../../docs/atom-authoring.zh-CN.md)。真实浏览器、模型、Signal 和批量处理案例见 [示例 Package](../../examples/atoms/README.zh-CN.md)。\n\n## 开发\n\n```bash\npnpm --filter @atom-workflow-agent/atom-sdk typecheck\npnpm --filter @atom-workflow-agent/atom-sdk test\n```\n\n通用概念与完整流程见项目[中文文档](../../docs/README.zh-CN.md)。\n","readmeFilename":"README.zh-CN.md","_rev":"1-aa20489c36ae764eb3719d91a7c7faa4"}