{"_id":"@buckeyestudio/toh-subagent-spawn-in-process","name":"@buckeyestudio/toh-subagent-spawn-in-process","dist-tags":{"next":"0.1.1-rc.2","latest":"0.1.1-rc.2"},"versions":{"0.1.1-rc.2":{"name":"@buckeyestudio/toh-subagent-spawn-in-process","description":"In-process spawn subagent backend: runs a fresh child agent on ctx.agents","version":"0.1.1-rc.2","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/dustinwloring1988/theopen-harness.git","directory":"packages/subagent/subagent-spawn-in-process"},"type":"module","main":"lib/index.js","types":"lib/types/index.d.ts","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","author":{"name":"buckeyestudio"},"peerDependencies":{"@buckeyestudio/toh-invariants":"^0.1.1-rc.2","@buckeyestudio/toh-subagent-in-process-driver":"^0.1.1-rc.2","@buckeyestudio/cordis":"^4.0.1","@buckeyestudio/toh-subagent":"^0.1.1-rc.2"},"dependencies":{"@buckeyestudio/schemastery":"^3.18.1"},"devDependencies":{"@buckeyestudio/cordis-plugin-loader":"^1.0.2","@buckeyestudio/toh-agent-loop-testkit":"^0.1.1-rc.2","@buckeyestudio/toh-bash-local":"^0.1.1-rc.2","@buckeyestudio/toh-agent":"^0.1.1-rc.2","@buckeyestudio/toh-agent-loop":"^0.1.1-rc.2","@buckeyestudio/toh-subprocess-local":"^0.1.1-rc.2","@buckeyestudio/toh-invariants":"^0.1.1-rc.2","@buckeyestudio/toh-llm":"^0.1.1-rc.2","@buckeyestudio/toh-llm-deepseek":"^0.1.1-rc.2","@buckeyestudio/toh-session":"^0.1.1-rc.2","@buckeyestudio/toh-subagent-in-process-driver":"^0.1.1-rc.2","@buckeyestudio/toh-subagent":"^0.1.1-rc.2","@buckeyestudio/toh-tool-bash":"^0.1.1-rc.2","@buckeyestudio/toh-tool-subagent":"^0.1.1-rc.2","@buckeyestudio/cordis":"^4.0.1"},"_id":"@buckeyestudio/toh-subagent-spawn-in-process@0.1.1-rc.2","bugs":{"url":"https://github.com/dustinwloring1988/theopen-harness/issues"},"homepage":"https://github.com/dustinwloring1988/theopen-harness#readme","_integrity":"sha512-M92w95QgMBL44ZcAONrwZa3xedk+qBBt18ZnbCpvKNci5h6BLukgAiUaCFN0idsnyvHtS3z+2RSdQ4REnOvY0g==","_resolved":"/home/runner/work/theopen-harness/theopen-harness/dist/npm/buckeyestudio-toh-subagent-spawn-in-process-0.1.1-rc.2.tgz","_from":"file:/home/runner/work/theopen-harness/theopen-harness/dist/npm/buckeyestudio-toh-subagent-spawn-in-process-0.1.1-rc.2.tgz","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-M92w95QgMBL44ZcAONrwZa3xedk+qBBt18ZnbCpvKNci5h6BLukgAiUaCFN0idsnyvHtS3z+2RSdQ4REnOvY0g==","shasum":"e78fbb8d5c3b2886dbf0bde289ce51a4aaa34f1b","tarball":"https://registry.npmjs.org/@buckeyestudio/toh-subagent-spawn-in-process/-/toh-subagent-spawn-in-process-0.1.1-rc.2.tgz","fileCount":9,"unpackedSize":13431,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAGa1xdRFjfaNHSTfIbu6KCb7YXsffznKZ7UAgJNIPK1AiBeenxT3Ajq986juXUiVrlDqbkEk1pLnei16XKwuj+TlQ=="}]},"_npmUser":{"name":"buckeyestudio","email":"dustinwloring1988@gmail.com"},"directories":{},"maintainers":[{"name":"buckeyestudio","email":"dustinwloring1988@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/toh-subagent-spawn-in-process_0.1.1-rc.2_1787489351969_0.18102445251501464"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-23T12:49:11.835Z","0.1.1-rc.2":"2026-08-23T12:49:12.112Z","modified":"2026-08-23T12:49:12.296Z"},"maintainers":[{"name":"buckeyestudio","email":"dustinwloring1988@gmail.com"}],"description":"In-process spawn subagent backend: runs a fresh child agent on ctx.agents","homepage":"https://github.com/dustinwloring1988/theopen-harness#readme","repository":{"type":"git","url":"git+https://github.com/dustinwloring1988/theopen-harness.git","directory":"packages/subagent/subagent-spawn-in-process"},"author":{"name":"buckeyestudio"},"bugs":{"url":"https://github.com/dustinwloring1988/theopen-harness/issues"},"license":"MIT","readme":"# @buckeyestudio/toh-subagent-spawn-in-process\n\n[English](README.md) | 中文\n\nspawn 提供方会在当前进程中创建一个全新的子 `Agent`。子 agent（智能体）有自己的会话，看不到父 agent 的对话历史，并复用宿主的 agent 工厂及 LLM（大语言模型）/工具服务。\n\n## 行为\n\n`start(request)` 不传入 seed，直接委托给 [`startInProcessRun`](../subagent-in-process-driver/README.zh.md)，并在子 agent 发布后才返回。子 agent 获得父 agent 的工作目录/会话谱系，并默认继承父 agent 模型（除非覆盖），但以空对话开始运行。\n\n共享驱动器负责深度检查、persona 与工具过滤器设置、结构化输出、通过必需的信号执行取消、单次执行、结果读取和完全停稳后的 dispose（资源释放）。启动遭拒不会留下已发布的子 agent；启动调用兑现后卸载提供方，也不会撤销由持有方拥有的运行。\n\n## 能力\n\nspawn 声明 `{ outputSchema: true, depthLimit: true, toolFilter: true, persona: true }`，因为它控制子 agent 的创建窗口，能够强制执行全部四项功能。\n\n## 配置\n\n| 键 | 含义 |\n|---|---|\n| `providerName` | `ctx.subagents` 上的注册表名称（默认 `spawn`）。 |\n\n## 模型体验\n\n### 子 agent 请求\n\n#### 模型看到的内容\n\n全新的子 agent 逐字接收独立任务内容，默认继承父 agent 的模型和工作区，并看到带有已配置子 agent 作用域 persona 遮蔽的全局提示词。工具过滤器会为该子 agent 移除全局协议 schema、可执行工具查找和 Code Mode SDK 绑定，但保留独立注册的指导内容。它不接收任何父 agent 对话消息；过滤控制的是可见性与组合，并非从父 agent 继承的权限授予。\n\n#### Token 影响\n\n子 agent 会为全新的独立上下文和历史消耗 token；不会复制父 agent 历史的 token。persona 会改变该子 agent 反复使用的提示词成本，过滤则会改变其 schema 或生成 SDK 的成本。\n\n#### KV Cache 影响\n\n与父 agent 请求缓存相互独立。子 agent 历史仅追加；persona、工具过滤、生成 SDK、提供方或模型变化会建立不同的子 agent 前缀。\n\n### 父 agent 工具结果（间接）\n\n#### 模型看到的内容\n\n通过 `toh-tool-subagent`，父 agent 只接收子 agent 的最终输出或结束原因错误。\n\n#### Token 影响\n\n父 agent 输入会增加一个取决于数据的结果，并保留到压缩（compaction）为止。\n\n#### KV Cache 影响\n\n仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。\n\n## 已知限制与暂缓事项\n\n- **全新表示不含父 agent transcript（文本记录）**：子 agent 会继承 cwd、谱系、模型及显式配置的 persona/工具限制，但不继承父 agent 的任何对话；需要已完成轮次上下文时，请使用 fork 提供方。\n","readmeFilename":"README.zh.md","_rev":"1-c00c54fcbead52d6b6a795553968551c"}