typeclaw 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,261 @@
1
+ // Container-stage child entry. Never import this into the trusted runtime:
2
+ // arbitrary code, including native Bun APIs, executes only inside bwrap.
3
+ import { AsyncLocalStorage } from 'node:async_hooks'
4
+ import { start } from 'node:repl'
5
+ import { PassThrough, Writable } from 'node:stream'
6
+ import { format } from 'node:util'
7
+
8
+ import type { HostFrame, KernelFrame } from './protocol'
9
+ import { rewriteCell } from './redeclare'
10
+ import { EVAL_LIMITS, EvalError, FrameLines, FRAME_PREFIX, encodeFrame, assertNever } from './wire'
11
+
12
+ const write = process.stdout.write.bind(process.stdout)
13
+ // A leading delimiter also terminates ordinary stdout writes that omitted a
14
+ // newline. Raw output cannot accidentally swallow the following control frame.
15
+ const send = (frame: KernelFrame) => write('\n' + encodeFrame(frame))
16
+ const pending = new Map<string, { resolve(value: unknown): void; reject(error: Error): void }>()
17
+ const outstanding = new Set<Promise<unknown>>()
18
+ let cellId: string | undefined
19
+ // Timers and abandoned promises keep the async context of the cell that
20
+ // created them. Comparing it with the running cell stops a failed cell's
21
+ // leftover work from calling tools or printing under a later cell's id.
22
+ const origin = new AsyncLocalStorage<string>()
23
+ const currentCell = (): string | undefined => {
24
+ const id = origin.getStore()
25
+ return id !== undefined && id === cellId ? id : undefined
26
+ }
27
+ let sequence = 0
28
+ let rejectEvaluation: ((error: unknown) => void) | undefined
29
+
30
+ function print(...values: unknown[]): void {
31
+ const cellId = currentCell()
32
+ if (cellId === undefined) return
33
+ const text = format(...values) + '\n'
34
+ // Chunk before JSON framing so large printed values still reach the host's
35
+ // output cap instead of overflowing a single protocol frame.
36
+ let chunk = ''
37
+ for (const character of text) {
38
+ chunk += character
39
+ if (chunk.length >= 4096) {
40
+ send({ type: 'output', cellId, text: chunk })
41
+ chunk = ''
42
+ }
43
+ }
44
+ if (chunk !== '') send({ type: 'output', cellId, text: chunk })
45
+ }
46
+
47
+ type ToolArgs = Extract<KernelFrame, { type: 'tool-call' }>['args']
48
+ const tool = new Proxy<Record<string, (args: ToolArgs) => Promise<unknown>>>(
49
+ {},
50
+ {
51
+ get(_target, name) {
52
+ if (typeof name !== 'string' || name === 'then') return undefined
53
+ return (args: ToolArgs) => {
54
+ const activeCellId = currentCell()
55
+ if (activeCellId === undefined) return Promise.reject(new EvalError('closed', 'eval cell has already ended'))
56
+ const id = String(++sequence)
57
+ const result = new Promise<unknown>((resolve, reject) => {
58
+ pending.set(id, { resolve, reject })
59
+ send({ type: 'tool-call', cellId: activeCellId, id, name, args })
60
+ })
61
+ outstanding.add(result)
62
+ void result.then(
63
+ () => outstanding.delete(result),
64
+ () => outstanding.delete(result),
65
+ )
66
+ return result
67
+ }
68
+ },
69
+ },
70
+ )
71
+
72
+ async function parallel<T>(thunks: readonly (() => Promise<T>)[]): Promise<T[]> {
73
+ const notThunk = thunks.findIndex((thunk) => typeof thunk !== 'function')
74
+ if (notThunk !== -1) {
75
+ throw new TypeError(
76
+ `parallel() takes functions, but item ${notThunk} is not one; wrap each call: parallel([() => tool.read({...})])`,
77
+ )
78
+ }
79
+ let next = 0
80
+ const values: T[] = []
81
+ const failures: unknown[] = []
82
+ // A failed cell keeps the kernel, so every worker must settle before the
83
+ // failure propagates; a still-sleeping worker would otherwise dispatch tool
84
+ // calls under the next cell's id.
85
+ await Promise.all(
86
+ Array.from({ length: Math.min(EVAL_LIMITS.concurrency, thunks.length) }, async () => {
87
+ while (next < thunks.length && failures.length === 0) {
88
+ const index = next++
89
+ const thunk = thunks[index]
90
+ if (thunk === undefined) continue
91
+ try {
92
+ values[index] = await thunk()
93
+ } catch (error) {
94
+ failures.push(error)
95
+ }
96
+ }
97
+ }),
98
+ )
99
+ if (failures.length > 0) throw failures[0]
100
+ return values
101
+ }
102
+
103
+ // Printing a whole tool result dumps its content array and details into the
104
+ // transcript, defeating the point of a cell. text() pulls just the text parts.
105
+ function text(result: unknown, maxChars = 2000): string {
106
+ const content = (result as { content?: unknown } | null)?.content
107
+ const joined = Array.isArray(content)
108
+ ? content
109
+ .filter(
110
+ (part): part is { type: 'text'; text: string } => part?.type === 'text' && typeof part.text === 'string',
111
+ )
112
+ .map((part) => part.text)
113
+ .join('\n')
114
+ : typeof result === 'string'
115
+ ? result
116
+ : format(result)
117
+ return joined.length > maxChars ? `${joined.slice(0, maxChars)}\n…[${joined.length - maxChars} more chars]` : joined
118
+ }
119
+
120
+ const replOptions = {
121
+ input: new PassThrough(),
122
+ output: new Writable({
123
+ write(chunk: Buffer, _encoding: BufferEncoding, callback: (error?: Error | null) => void) {
124
+ if (cellId !== undefined) send({ type: 'output', cellId, text: chunk.toString('utf8') })
125
+ callback()
126
+ },
127
+ }),
128
+ terminal: false,
129
+ prompt: '',
130
+ // Bun's Node-compatible REPL routes uncaught awaited errors here instead of
131
+ // invoking eval's completion callback. Subscribe before executing each cell.
132
+ handleError(error: unknown) {
133
+ if (rejectEvaluation === undefined) process.exit(1)
134
+ rejectEvaluation(error)
135
+ return 'ignore' as const
136
+ },
137
+ }
138
+ const repl = start(replOptions)
139
+ const helpers = {
140
+ tool,
141
+ parallel,
142
+ print,
143
+ text,
144
+ display: print,
145
+ console: { log: print, info: print, warn: print, error: print, debug: print },
146
+ }
147
+ Object.assign(repl.context, helpers)
148
+
149
+ // Passing parallel()-style thunks to Promise.all resolves to the functions
150
+ // themselves, so the cell "succeeds" with no tool call made. Fail it instead.
151
+ function rejectFunctionItems(promise: PromiseConstructor): void {
152
+ for (const name of ['all', 'allSettled', 'any', 'race'] as const) {
153
+ const original = promise[name] as (this: PromiseConstructor, values: unknown[]) => Promise<unknown>
154
+ Object.defineProperty(promise, name, {
155
+ configurable: true,
156
+ writable: true,
157
+ value(this: PromiseConstructor, values: Iterable<unknown>) {
158
+ const items = Array.from(values)
159
+ const index = items.findIndex((item) => typeof item === 'function')
160
+ if (index !== -1) {
161
+ return Promise.reject(
162
+ new TypeError(
163
+ `Promise.${name}() got a function at item ${index}; call it (tool.read({...})) or use parallel([() => ...])`,
164
+ ),
165
+ )
166
+ }
167
+ return original.call(this, items)
168
+ },
169
+ })
170
+ }
171
+ }
172
+
173
+ async function run(id: string, code: string): Promise<void> {
174
+ if (cellId !== undefined) throw new EvalError('busy', 'eval kernel is busy')
175
+ cellId = id
176
+ const cell = rewriteCell(code)
177
+ const shadowed = cell.declared.filter((name) => Object.hasOwn(helpers, name))
178
+ const failure =
179
+ shadowed.length > 0
180
+ ? `${shadowed.map((name) => `\`${name}\``).join(', ')} is an eval helper and cannot be declared at top level; rename the variable`
181
+ : await origin.run(id, () => evaluate(cell.code))
182
+ // A forgotten await must not detach tool work from the foreground cell.
183
+ await Promise.allSettled(outstanding)
184
+ cellId = undefined
185
+ send({ type: 'done', cellId: id, ...(failure === undefined ? {} : { error: failure.slice(0, 4096) }) })
186
+ }
187
+
188
+ async function evaluate(code: string): Promise<string | undefined> {
189
+ try {
190
+ await new Promise<void>((resolve, reject) => {
191
+ rejectEvaluation = reject
192
+ repl.eval(code + '\n', repl.context, 'eval-cell', (error: Error | null) => {
193
+ if (error !== null && error !== undefined) reject(error)
194
+ else resolve()
195
+ })
196
+ })
197
+ return undefined
198
+ } catch (error) {
199
+ return error instanceof Error ? error.message : String(error)
200
+ } finally {
201
+ rejectEvaluation = undefined
202
+ }
203
+ }
204
+
205
+ const lines = new FrameLines()
206
+ // No package imports in the child: dev mode exposes src/, not a checkout's
207
+ // node_modules. The trusted host has already constructed these frames; the
208
+ // reverse direction is fully schema-validated by the host before dispatch.
209
+ function parseHostFrame(line: string): HostFrame {
210
+ const value: unknown = JSON.parse(line)
211
+ if (typeof value !== 'object' || value === null || !('type' in value)) {
212
+ throw new EvalError('protocol', 'invalid host frame')
213
+ }
214
+ switch (value.type) {
215
+ case 'run':
216
+ if ('cellId' in value && typeof value.cellId === 'string' && 'code' in value && typeof value.code === 'string') {
217
+ return { type: 'run', cellId: value.cellId, code: value.code }
218
+ }
219
+ break
220
+ case 'tool-result':
221
+ if ('id' in value && typeof value.id === 'string' && 'value' in value) {
222
+ return { type: 'tool-result', id: value.id, value: value.value }
223
+ }
224
+ break
225
+ case 'tool-error':
226
+ if ('id' in value && typeof value.id === 'string' && 'error' in value && typeof value.error === 'string') {
227
+ return { type: 'tool-error', id: value.id, error: value.error }
228
+ }
229
+ break
230
+ }
231
+ throw new EvalError('protocol', 'invalid host frame')
232
+ }
233
+ process.stdin.on('data', (chunk: Buffer) => {
234
+ for (const line of lines.push(chunk)) {
235
+ if (!line.startsWith(FRAME_PREFIX)) throw new EvalError('protocol', 'invalid host frame')
236
+ const frame = parseHostFrame(line.slice(FRAME_PREFIX.length))
237
+ switch (frame.type) {
238
+ case 'run':
239
+ void run(frame.cellId, frame.code)
240
+ break
241
+ case 'tool-result':
242
+ pending.get(frame.id)?.resolve(frame.value)
243
+ pending.delete(frame.id)
244
+ break
245
+ case 'tool-error':
246
+ pending.get(frame.id)?.reject(new EvalError('refused', frame.error))
247
+ pending.delete(frame.id)
248
+ break
249
+ default:
250
+ assertNever(frame)
251
+ }
252
+ }
253
+ })
254
+ process.stdin.on('end', () => process.exit(0))
255
+ // Cells run in the REPL's own realm, whose Promise is reachable only from
256
+ // inside it; patch that one before accepting the first cell.
257
+ repl.eval('Promise\n', repl.context, 'eval-init', (error: Error | null, value: unknown) => {
258
+ if (error !== null && error !== undefined) throw error
259
+ rejectFunctionItems(value as PromiseConstructor)
260
+ send({ type: 'ready' })
261
+ })
@@ -0,0 +1,154 @@
1
+ import { EvalCell, type EvalDispatch } from './cell'
2
+ import { KernelProcess, type KernelLaunch } from './process'
3
+ import { EVAL_LIMITS, EvalError } from './protocol'
4
+
5
+ export type EvalResult = {
6
+ readonly text: string
7
+ readonly isError: boolean
8
+ readonly truncated: boolean
9
+ readonly restarted: boolean
10
+ }
11
+
12
+ // Owns one serial, foreground-only process. Preparing again before each cell
13
+ // rechecks bash's live masks and environment; changed authority loses bindings
14
+ // rather than reusing a kernel with an earlier principal's capabilities.
15
+ export class EvalKernel {
16
+ private worker: { process: KernelProcess; launch: KernelLaunch } | undefined
17
+ private active: EvalCell | undefined
18
+ private controller: AbortController | undefined
19
+ private idle: ReturnType<typeof setTimeout> | undefined
20
+ private closed = false
21
+ private used = false
22
+ private stopping: Promise<void> = Promise.resolve()
23
+ private disposal: Promise<void> | undefined
24
+
25
+ constructor(
26
+ private readonly prepare: () => Promise<KernelLaunch>,
27
+ private readonly idleMs: number = EVAL_LIMITS.idleMs,
28
+ ) {}
29
+
30
+ async run(
31
+ code: string,
32
+ options: {
33
+ readonly dispatch: EvalDispatch
34
+ readonly signal?: AbortSignal
35
+ readonly timeoutMs?: number
36
+ },
37
+ ): Promise<EvalResult> {
38
+ if (this.closed) throw new EvalError('closed', 'eval session has ended')
39
+ if (this.controller !== undefined) throw new EvalError('busy', 'another eval cell is running')
40
+ if (Buffer.byteLength(code) > EVAL_LIMITS.codeBytes) throw new EvalError('refused', 'eval code exceeds 64 KiB')
41
+ clearTimeout(this.idle)
42
+ const controller = new AbortController()
43
+ this.controller = controller
44
+ const signal =
45
+ options.signal === undefined ? controller.signal : AbortSignal.any([controller.signal, options.signal])
46
+ const cell = new EvalCell(options.dispatch, signal)
47
+ this.active = cell
48
+ // Attach rejection handling before any startup event can fail the cell.
49
+ const failure = new Promise<never>((_resolve, reject) => {
50
+ const abort = () => reject(signal.reason)
51
+ if (signal.aborted) abort()
52
+ else signal.addEventListener('abort', abort, { once: true })
53
+ })
54
+ const timeout = setTimeout(
55
+ () => controller.abort(new EvalError('timeout', 'eval cell timed out; kernel killed and bindings lost')),
56
+ Math.min(Math.max(options.timeoutMs ?? EVAL_LIMITS.timeoutMs, 1), EVAL_LIMITS.maxTimeoutMs),
57
+ )
58
+ let restarted = false
59
+ const execute = async () => {
60
+ const launch = await this.prepare()
61
+ if (signal.aborted || this.closed) {
62
+ await launch.cleanup()
63
+ signal.throwIfAborted()
64
+ throw new EvalError('closed', 'eval session has ended')
65
+ }
66
+ if (this.worker?.process.alive === false || this.worker?.launch.fingerprint !== launch.fingerprint) {
67
+ await this.stopWorker()
68
+ }
69
+ if (signal.aborted || this.closed) {
70
+ await launch.cleanup()
71
+ signal.throwIfAborted()
72
+ throw new EvalError('closed', 'eval session has ended')
73
+ }
74
+ if (this.worker === undefined) {
75
+ restarted = this.used
76
+ this.used = true
77
+ const process = new KernelProcess(launch, {
78
+ frame: (frame) => cell.receive(frame, (reply) => process.send(reply)),
79
+ output: (text) => cell.output.append(text),
80
+ failure: (error) => {
81
+ if (this.worker?.process === process) this.active?.completed.reject(error)
82
+ },
83
+ })
84
+ this.worker = { process, launch }
85
+ } else {
86
+ await launch.cleanup()
87
+ }
88
+ const process = this.worker.process
89
+ await process.ready
90
+ signal.throwIfAborted()
91
+ // Keep old output attached to its original cell throughout preparation
92
+ // and replacement. Only transfer the lease immediately before execution.
93
+ process.onFrame = (frame) => cell.receive(frame, (reply) => process.send(reply))
94
+ process.onOutput = (text) => cell.output.append(text)
95
+ process.send({ type: 'run', cellId: cell.id, code })
96
+ await cell.completed.promise
97
+ }
98
+ // completed can reject during startup, before execute awaits it.
99
+ void cell.completed.promise.catch((error: unknown) => controller.abort(error))
100
+ const running = execute()
101
+ try {
102
+ await Promise.race([running, failure])
103
+ return {
104
+ text: (restarted ? '[eval kernel restarted; previous bindings lost]\n' : '') + cell.output.render(),
105
+ isError: false,
106
+ truncated: cell.output.truncated,
107
+ restarted,
108
+ }
109
+ } catch (error) {
110
+ controller.abort(error)
111
+ // The child reported a thrown or rejected cell after settling its tool
112
+ // calls, so the process is healthy and its bindings are still valid.
113
+ const cellFailed = error instanceof EvalError && error.kind === 'cell'
114
+ if (!cellFailed) await this.stopWorker()
115
+ cell.output.append('\n' + (error instanceof Error ? error.message : String(error)))
116
+ return {
117
+ text:
118
+ cell.output.render() +
119
+ (cellFailed ? '\n[eval cell failed; kernel and bindings kept]' : '\n[eval kernel stopped; bindings lost]'),
120
+ isError: true,
121
+ truncated: cell.output.truncated,
122
+ restarted,
123
+ }
124
+ } finally {
125
+ clearTimeout(timeout)
126
+ this.active = undefined
127
+ this.controller = undefined
128
+ if (!this.closed)
129
+ this.idle = setTimeout(() => {
130
+ void this.stopWorker()
131
+ }, this.idleMs)
132
+ this.idle?.unref()
133
+ }
134
+ }
135
+
136
+ async dispose(): Promise<void> {
137
+ if (this.disposal !== undefined) return await this.disposal
138
+ this.closed = true
139
+ clearTimeout(this.idle)
140
+ this.controller?.abort(new EvalError('closed', 'eval session ended; bindings lost'))
141
+ this.disposal = this.stopWorker()
142
+ await this.disposal
143
+ }
144
+
145
+ private async stopWorker(): Promise<void> {
146
+ const worker = this.worker
147
+ this.worker = undefined
148
+ if (worker === undefined) return await this.stopping
149
+ worker.process.stop()
150
+ const stopped = worker.process.exited.then(worker.launch.cleanup)
151
+ this.stopping = Promise.all([this.stopping, stopped]).then(() => {})
152
+ await this.stopping
153
+ }
154
+ }
@@ -0,0 +1,113 @@
1
+ import { spawn, type ChildProcessWithoutNullStreams } from 'node:child_process'
2
+
3
+ import { withToolOomPriorityCommand } from '@/container/tool-oom-priority'
4
+
5
+ import {
6
+ EvalError,
7
+ FrameLines,
8
+ FRAME_PREFIX,
9
+ encodeFrame,
10
+ kernelFrameSchema,
11
+ type HostFrame,
12
+ type KernelFrame,
13
+ } from './protocol'
14
+ import { assertNever } from './wire'
15
+
16
+ export type KernelLaunch = {
17
+ readonly command: string
18
+ readonly cwd: string
19
+ readonly env: Record<string, string>
20
+ readonly fingerprint: string
21
+ readonly cleanup: () => Promise<void>
22
+ }
23
+
24
+ export class KernelProcess {
25
+ readonly ready: Promise<void>
26
+ readonly exited: Promise<void>
27
+ onFrame: (frame: KernelFrame) => void
28
+ onOutput: (text: string) => void
29
+ alive = true
30
+ private readonly child: ChildProcessWithoutNullStreams
31
+
32
+ constructor(
33
+ launch: KernelLaunch,
34
+ callbacks: {
35
+ readonly frame: (frame: KernelFrame) => void
36
+ readonly output: (text: string) => void
37
+ readonly failure: (error: Error) => void
38
+ },
39
+ ) {
40
+ const ready = Promise.withResolvers<void>()
41
+ this.ready = ready.promise
42
+ this.onFrame = callbacks.frame
43
+ this.onOutput = callbacks.output
44
+ // exec retains the supervised PID. The new outer process group also covers
45
+ // unshare's helper in real-proc mode; bwrap's PID namespace and
46
+ // --die-with-parent own teardown of processes that create their own groups.
47
+ this.child = spawn('bash', ['-c', withToolOomPriorityCommand(`exec ${launch.command}`)], {
48
+ cwd: launch.cwd,
49
+ env: launch.env,
50
+ stdio: ['pipe', 'pipe', 'pipe'],
51
+ detached: true,
52
+ })
53
+ const lines = new FrameLines()
54
+ const fail = (error: Error) => {
55
+ ready.reject(error)
56
+ callbacks.failure(error)
57
+ this.stop()
58
+ }
59
+ this.child.stdout.on('data', (chunk: Buffer) => {
60
+ try {
61
+ for (const line of lines.push(chunk)) {
62
+ if (line === '') continue
63
+ if (!line.startsWith(FRAME_PREFIX)) {
64
+ this.onOutput(line + '\n')
65
+ continue
66
+ }
67
+ const frame = kernelFrameSchema.parse(JSON.parse(line.slice(FRAME_PREFIX.length)))
68
+ switch (frame.type) {
69
+ case 'ready':
70
+ ready.resolve()
71
+ break
72
+ case 'output':
73
+ case 'tool-call':
74
+ case 'done':
75
+ this.onFrame(frame)
76
+ break
77
+ default:
78
+ assertNever(frame)
79
+ }
80
+ }
81
+ } catch (error) {
82
+ fail(error instanceof Error ? error : new EvalError('protocol', String(error)))
83
+ }
84
+ })
85
+ this.child.stderr.on('data', (chunk: Buffer) => this.onOutput(chunk.toString('utf8')))
86
+ this.child.stdin.on('error', fail)
87
+ this.child.on('error', fail)
88
+ this.exited = new Promise((resolve) => {
89
+ this.child.on('close', () => {
90
+ this.alive = false
91
+ const error = new EvalError('closed', 'eval kernel exited; bindings lost')
92
+ ready.reject(error)
93
+ callbacks.failure(error)
94
+ resolve()
95
+ })
96
+ })
97
+ }
98
+
99
+ send(frame: HostFrame): void {
100
+ this.child.stdin.write(encodeFrame(frame))
101
+ }
102
+
103
+ stop(): void {
104
+ if (!this.alive) return
105
+ const pid = this.child.pid
106
+ if (pid === undefined) return
107
+ try {
108
+ process.kill(-pid, 'SIGKILL')
109
+ } catch (error) {
110
+ if (!(error instanceof Error && 'code' in error && error.code === 'ESRCH')) throw error
111
+ }
112
+ }
113
+ }
@@ -0,0 +1,26 @@
1
+ import { z } from 'zod'
2
+
3
+ import { EVAL_LIMITS } from './wire'
4
+ export { EVAL_LIMITS, FRAME_PREFIX, EvalError, encodeFrame, FrameLines, CellOutput } from './wire'
5
+
6
+ const id = z.string().min(1).max(128)
7
+ export const kernelFrameSchema = z.discriminatedUnion('type', [
8
+ z.strictObject({ type: z.literal('ready') }),
9
+ z.strictObject({ type: z.literal('output'), cellId: id, text: z.string() }),
10
+ z.strictObject({
11
+ type: z.literal('tool-call'),
12
+ cellId: id,
13
+ id,
14
+ name: z.string().min(1).max(128),
15
+ args: z.record(z.string(), z.json()),
16
+ }),
17
+ z.strictObject({ type: z.literal('done'), cellId: id, error: z.string().optional() }),
18
+ ])
19
+
20
+ export type KernelFrame = z.infer<typeof kernelFrameSchema>
21
+ export const hostFrameSchema = z.discriminatedUnion('type', [
22
+ z.strictObject({ type: z.literal('run'), cellId: id, code: z.string().max(EVAL_LIMITS.codeBytes) }),
23
+ z.strictObject({ type: z.literal('tool-result'), id, value: z.unknown() }),
24
+ z.strictObject({ type: z.literal('tool-error'), id, error: z.string() }),
25
+ ])
26
+ export type HostFrame = z.infer<typeof hostFrameSchema>