typeclaw 0.48.13 → 0.50.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 (572) 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/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -0,0 +1,512 @@
1
+ import { constants } from 'node:fs'
2
+ import { open, lstat } from 'node:fs/promises'
3
+ import { join } from 'node:path'
4
+
5
+ import { z } from 'zod'
6
+
7
+ import type { SessionOrigin } from '@/agent/session-origin'
8
+ import { adapterNamespace } from '@/channels/adapter-namespace'
9
+ import { getConfig, resolveModel } from '@/config'
10
+ import { KNOWN_PROVIDERS } from '@/config/providers'
11
+ import type { PermissionService } from '@/permissions'
12
+ import { resolveHiddenPaths } from '@/sandbox/hidden-paths'
13
+ import { createCodingAgentAuthResolver, type CodingAgentAuthResolver } from '@/secrets/coding-agent-auth'
14
+
15
+ import { CLAUDE_AUXILIARY_MODELS, CLAUDE_CODE_VERSION } from './claude'
16
+ import { CODEX_CLI_VERSION } from './codex'
17
+ import { OMO_CLI_VERSION, omoModelSchema } from './omo'
18
+ import { runCodingAgent, type CodingRunOptions, type CodingRunResult } from './runner'
19
+ import {
20
+ captureCodingChanges,
21
+ codingGitExecutor,
22
+ createCodingWorkspace,
23
+ createTaskDirectory,
24
+ disposeCodingWorkspace,
25
+ resolveCodingSource,
26
+ writeCodingArtifact,
27
+ writeTaskRegistry,
28
+ type ChangeArtifacts,
29
+ type CodingExecutor,
30
+ type CodingWorkspace,
31
+ } from './worktree'
32
+
33
+ export const codingRequestSchema = z.discriminatedUnion('action', [
34
+ z.strictObject({
35
+ action: z.literal('run'),
36
+ engine: z.enum(['claude', 'codex', 'omo']),
37
+ repo: z.string().min(1).optional(),
38
+ modelRef: z.string().min(1).optional(),
39
+ taskId: z.string().uuid().optional(),
40
+ prompt: z.string().min(1).max(1_000_000),
41
+ mode: z.enum(['plan', 'code']).optional(),
42
+ timeoutSeconds: z.number().finite().positive().max(2_147_483.647).default(1800),
43
+ }),
44
+ z.strictObject({ action: z.literal('result'), taskId: z.string().uuid() }),
45
+ z.strictObject({ action: z.literal('dispose'), taskId: z.string().uuid(), discard: z.literal(true) }),
46
+ ])
47
+ export type CodingRequest = z.infer<typeof codingRequestSchema>
48
+ const taskSchema = z
49
+ .object({
50
+ // PR2 registries predate the engine field and contain only Claude tasks.
51
+ engine: z.enum(['claude', 'codex', 'omo']).default('claude'),
52
+ provider: z.enum(['anthropic', 'openai-codex']).optional(),
53
+ modelMetadata: omoModelSchema.optional(),
54
+ taskId: z.string().uuid(),
55
+ ownerSessionId: z.string(),
56
+ parentSessionId: z.string().optional(),
57
+ principal: z.string(),
58
+ role: z.string(),
59
+ modelRef: z.string(),
60
+ model: z.string(),
61
+ mode: z.enum(['plan', 'code']),
62
+ permissions: z.array(z.string()),
63
+ allowedModels: z.array(z.string()),
64
+ engineVersion: z.string(),
65
+ source: z.string(),
66
+ sourceIdentity: z.string(),
67
+ baseSha: z.string(),
68
+ sessionId: z.string().uuid().optional(),
69
+ state: z.enum(['running', 'completed', 'incomplete', 'failed', 'cancelled', 'interrupted']),
70
+ finalMessage: z.string().default(''),
71
+ exitCode: z.number().nullable().default(null),
72
+ diagnostic: z.string().default(''),
73
+ changedFiles: z.array(z.string()).default([]),
74
+ untrackedFiles: z.array(z.string()).default([]),
75
+ oversized: z.boolean().default(false),
76
+ })
77
+ .refine((task) => task.engine !== 'omo' || (task.provider !== undefined && task.modelMetadata?.id === task.model), {
78
+ message: 'OmO tasks require recorded provider and model metadata.',
79
+ })
80
+ .transform((task) => ({
81
+ ...task,
82
+ provider: task.provider ?? (task.engine === 'claude' ? ('anthropic' as const) : ('openai-codex' as const)),
83
+ }))
84
+ const ENGINE_VERSIONS = { claude: CLAUDE_CODE_VERSION, codex: CODEX_CLI_VERSION, omo: OMO_CLI_VERSION } as const
85
+ const ENGINE_TOGGLES = { claude: 'claudeCode', codex: 'codexCli', omo: 'omoCli' } as const
86
+ type CodingTask = z.infer<typeof taskSchema>
87
+ export type CodingCaller = {
88
+ readonly sessionId: string
89
+ readonly origin: SessionOrigin | undefined
90
+ readonly permissions: PermissionService
91
+ readonly onPrepared?: (receipt: Record<string, unknown>) => void
92
+ }
93
+ type ServiceDependencies = {
94
+ auth?: () => Promise<CodingAgentAuthResolver>
95
+ executor?: (source: string, root: string, signal?: AbortSignal) => CodingExecutor
96
+ run?: (options: CodingRunOptions) => Promise<CodingRunResult>
97
+ writeArtifact?: (path: string, text: string) => Promise<void>
98
+ sourcePath?: (source: string) => string
99
+ }
100
+
101
+ export class CodingAgentService {
102
+ private readonly tasks = new Map<string, CodingTask>()
103
+ private readonly active = new Map<string, { controller: AbortController; done: Promise<void> }>()
104
+ private readonly ready: Promise<void>
105
+ private auth: Promise<CodingAgentAuthResolver> | undefined
106
+ private saving: Promise<void> = Promise.resolve()
107
+ private stopped = false
108
+ private registryUnavailable = false
109
+
110
+ constructor(
111
+ readonly agentDir: string,
112
+ private readonly dependencies: ServiceDependencies = {},
113
+ ) {
114
+ this.ready = this.load().catch(() => {
115
+ this.registryUnavailable = true
116
+ })
117
+ }
118
+
119
+ async execute(request: CodingRequest, caller: CodingCaller, signal?: AbortSignal): Promise<Record<string, unknown>> {
120
+ await this.ready
121
+ if (this.stopped) throw new Error('Coding delegation is shutting down.')
122
+ if (this.registryUnavailable)
123
+ throw new Error('Coding task registry is unreadable. The host operator must repair it before delegation resumes.')
124
+ authorize(caller, this.agentDir)
125
+ if (request.action === 'result') {
126
+ const task = this.tasks.get(request.taskId)
127
+ if (!task) throw new Error('Unknown coding task.')
128
+ this.authorizeTask(task, caller)
129
+ if (task.state !== 'interrupted' || this.active.has(task.taskId)) return this.receipt(task)
130
+ }
131
+ const id = request.taskId ?? crypto.randomUUID()
132
+ if (this.active.has(id)) throw new Error('Coding task already running.')
133
+ const controller = new AbortController()
134
+ const combined = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal
135
+ let finish: () => void = () => {}
136
+ const done = new Promise<void>((resolve) => {
137
+ finish = resolve
138
+ })
139
+ this.active.set(id, { controller, done })
140
+ const timer = setTimeout(
141
+ () => controller.abort(new DOMException('Coding invocation timed out', 'TimeoutError')),
142
+ request.action === 'run' ? request.timeoutSeconds * 1000 : 60_000,
143
+ )
144
+ try {
145
+ return await this.executeRequest(request, caller, combined, id)
146
+ } finally {
147
+ clearTimeout(timer)
148
+ this.active.delete(id)
149
+ finish()
150
+ }
151
+ }
152
+
153
+ private async executeRequest(
154
+ request: CodingRequest,
155
+ caller: CodingCaller,
156
+ signal?: AbortSignal,
157
+ creationId?: string,
158
+ ): Promise<Record<string, unknown>> {
159
+ if (request.action === 'run' && !request.taskId) {
160
+ if (!creationId) throw new Error('Missing coding task identity.')
161
+ return this.create(request, caller, creationId, signal)
162
+ }
163
+ const task = this.tasks.get(request.taskId ?? '')
164
+ if (!task) throw new Error('Unknown coding task.')
165
+ this.authorizeTask(task, caller)
166
+ if (request.action === 'result') {
167
+ const workspace = this.workspace(task)
168
+ const writeArtifact =
169
+ this.dependencies.writeArtifact ??
170
+ ((path: string, text: string) => writeCodingArtifact(this.agentDir, path, text))
171
+ const execute =
172
+ this.dependencies.executor?.(task.source, workspace.taskRoot, signal) ??
173
+ codingGitExecutor(task.source, workspace.taskRoot, signal, 'plan')
174
+ try {
175
+ Object.assign(task, await captureCodingChanges(workspace, execute, writeArtifact))
176
+ await this.save()
177
+ } catch {
178
+ return {
179
+ ...this.receipt(task),
180
+ diagnostic:
181
+ 'Runtime was interrupted. Current diff recovery failed; inspect the retained worktree before resuming.',
182
+ }
183
+ }
184
+ return this.receipt(task)
185
+ }
186
+ switch (request.action) {
187
+ case 'dispose': {
188
+ await disposeCodingWorkspace(this.workspace(task), this.executor(task))
189
+ this.tasks.delete(task.taskId)
190
+ await this.save()
191
+ return { ok: true, taskId: task.taskId, state: 'disposed' }
192
+ }
193
+ case 'run':
194
+ await resolveCodingSource(
195
+ this.agentDir,
196
+ task.source,
197
+ getConfig().mounts.map((mount) => mount.name),
198
+ )
199
+ if (
200
+ request.engine !== task.engine ||
201
+ (request.modelRef && request.modelRef !== task.modelRef) ||
202
+ (request.repo && request.repo !== task.source)
203
+ ) {
204
+ throw new Error('A resumed task keeps its recorded engine, repository and model.')
205
+ }
206
+ if (task.engineVersion !== ENGINE_VERSIONS[task.engine])
207
+ throw new Error('Task CLI version changed; preserve and review its diff before migrating.')
208
+ if (!task.sessionId)
209
+ throw new Error('This task has no resumable CLI session. Its partial work remains available.')
210
+ task.mode = request.mode ?? task.mode
211
+ return this.invoke(task, request, signal)
212
+ }
213
+ }
214
+
215
+ async stop(): Promise<void> {
216
+ this.stopped = true
217
+ const runs = [...this.active.values()]
218
+ for (const run of runs) run.controller.abort()
219
+ await Promise.allSettled(runs.map((run) => run.done))
220
+ await this.saving
221
+ }
222
+
223
+ private async create(
224
+ request: Extract<CodingRequest, { action: 'run' }>,
225
+ caller: CodingCaller,
226
+ taskId: string,
227
+ signal?: AbortSignal,
228
+ ) {
229
+ if (!request.repo || !request.modelRef)
230
+ throw new Error('A new task requires repo and a concrete engine-compatible modelRef.')
231
+ const config = getConfig()
232
+ const toggle = ENGINE_TOGGLES[request.engine]
233
+ const provider =
234
+ request.engine === 'omo'
235
+ ? request.modelRef.startsWith('anthropic/')
236
+ ? 'anthropic'
237
+ : request.modelRef.startsWith('openai-codex/')
238
+ ? 'openai-codex'
239
+ : undefined
240
+ : request.engine === 'claude'
241
+ ? 'anthropic'
242
+ : 'openai-codex'
243
+ if (!config.docker.file[toggle] && !this.dependencies.run) {
244
+ throw new Error(`Enable docker.file.${toggle} on the host and run \`typeclaw start\` to rebuild the image.`)
245
+ }
246
+ if (!provider)
247
+ throw new Error('OmO requires an anthropic or openai-codex modelRef; other providers are not brokered.')
248
+ if (
249
+ !request.modelRef.startsWith(`${provider}/`) ||
250
+ !(
251
+ request.modelRef.slice(provider.length + 1) in KNOWN_PROVIDERS[provider].models ||
252
+ request.modelRef in config.customModels
253
+ )
254
+ )
255
+ throw new Error(`Select a configured or curated ${provider} modelRef.`)
256
+ const resolvedModel = resolveModel(request.modelRef)
257
+ const model = resolvedModel.id
258
+ const source = await resolveCodingSource(
259
+ this.agentDir,
260
+ request.repo,
261
+ config.mounts.map((mount) => mount.name),
262
+ )
263
+ // Missing auth never creates a task, exits the runtime, or disables another provider.
264
+ await (await this.resolver()).resolve(signal, undefined, provider)
265
+ const taskRoot = await createTaskDirectory(this.agentDir, taskId)
266
+ const identity = await lstat(source)
267
+ const task: CodingTask = {
268
+ engine: request.engine,
269
+ provider,
270
+ ...(request.engine === 'omo' ? { modelMetadata: omoModelSchema.parse(resolvedModel) } : {}),
271
+ taskId,
272
+ ownerSessionId: caller.sessionId,
273
+ ...(caller.origin?.kind === 'subagent' ? { parentSessionId: caller.origin.parentSessionId } : {}),
274
+ principal: principal(caller.origin),
275
+ role: caller.permissions.resolveRole(caller.origin),
276
+ permissions: [...caller.permissions.describe(caller.origin).permissions],
277
+ modelRef: request.modelRef,
278
+ model,
279
+ mode: request.mode ?? 'code',
280
+ allowedModels: [...new Set([model, ...(request.engine === 'claude' ? CLAUDE_AUXILIARY_MODELS : [])])],
281
+ engineVersion: ENGINE_VERSIONS[request.engine],
282
+ source,
283
+ sourceIdentity: `${identity.dev}:${identity.ino}`,
284
+ baseSha: '',
285
+ state: 'running',
286
+ finalMessage: '',
287
+ diagnostic: '',
288
+ changedFiles: [],
289
+ untrackedFiles: [],
290
+ exitCode: null,
291
+ oversized: false,
292
+ }
293
+ this.tasks.set(taskId, task)
294
+ await this.save()
295
+ try {
296
+ const workspace = await createCodingWorkspace(
297
+ source,
298
+ taskRoot,
299
+ this.dependencies.executor?.(source, taskRoot, signal) ??
300
+ codingGitExecutor(source, taskRoot, signal, 'snapshot'),
301
+ this.dependencies.sourcePath?.(source),
302
+ )
303
+ task.baseSha = workspace.baseSha
304
+ task.sourceIdentity = workspace.sourceIdentity
305
+ } catch (error) {
306
+ task.state = signal?.aborted ? 'incomplete' : 'failed'
307
+ task.diagnostic =
308
+ error instanceof Error ? error.message : 'Source snapshot failed; the task directory is preserved.'
309
+ await this.save()
310
+ return this.receipt(task)
311
+ }
312
+ caller.onPrepared?.(this.receipt(task))
313
+ return this.invoke(task, request, signal)
314
+ }
315
+
316
+ private async invoke(task: CodingTask, request: Extract<CodingRequest, { action: 'run' }>, signal?: AbortSignal) {
317
+ const combined = signal ?? new AbortController().signal
318
+ const workspace = this.workspace(task)
319
+ const writeArtifact =
320
+ this.dependencies.writeArtifact ??
321
+ ((path: string, text: string) => writeCodingArtifact(this.agentDir, path, text))
322
+ try {
323
+ const source = await lstat(task.source)
324
+ if (`${source.dev}:${source.ino}` !== task.sourceIdentity) throw new Error('Source repository identity changed.')
325
+ const auth = await this.resolver()
326
+ await auth.resolve(combined, undefined, task.provider)
327
+ task.state = 'running'
328
+ await this.save()
329
+ const result = await (this.dependencies.run ?? runCodingAgent)({
330
+ engine: task.engine,
331
+ provider: task.provider,
332
+ ...(task.modelMetadata ? { modelMetadata: task.modelMetadata } : {}),
333
+ workspace,
334
+ auth,
335
+ model: task.model,
336
+ allowedModels: task.allowedModels,
337
+ sessionId: task.sessionId ?? crypto.randomUUID(),
338
+ resume: task.sessionId !== undefined,
339
+ mode: task.mode,
340
+ prompt: request.prompt,
341
+ timeoutSeconds: request.timeoutSeconds,
342
+ signal: combined,
343
+ writeArtifact,
344
+ })
345
+ Object.assign(task, result)
346
+ // Collect the diff even after cancellation; the child has already been killed and reaped.
347
+ const artifactExecutor =
348
+ this.dependencies.executor?.(task.source, workspace.taskRoot) ??
349
+ codingGitExecutor(task.source, workspace.taskRoot, undefined, 'plan')
350
+ const artifacts: ChangeArtifacts = await captureCodingChanges(workspace, artifactExecutor, writeArtifact)
351
+ Object.assign(task, artifacts)
352
+ if (artifacts.oversized) {
353
+ task.state = 'incomplete'
354
+ task.diagnostic =
355
+ 'Change artifact exceeds 64 MiB; inspect the retained worktree. No truncated patch was produced.'
356
+ }
357
+ await writeArtifact(
358
+ join(workspace.taskRoot, 'output', 'result.json'),
359
+ JSON.stringify(this.receipt(task), null, 2),
360
+ )
361
+ return this.receipt(task)
362
+ } catch (error) {
363
+ task.state = combined.aborted
364
+ ? combined.reason instanceof DOMException && combined.reason.name === 'TimeoutError'
365
+ ? 'incomplete'
366
+ : 'cancelled'
367
+ : 'failed'
368
+ task.diagnostic = error instanceof Error ? error.message : 'Coding task failed; partial work is preserved.'
369
+ return this.receipt(task)
370
+ } finally {
371
+ await this.save()
372
+ }
373
+ }
374
+
375
+ private authorizeTask(task: CodingTask, caller: CodingCaller): void {
376
+ const samePrincipal = task.principal === principal(caller.origin)
377
+ const sameScope = task.ownerSessionId === caller.sessionId || task.parentSessionId === caller.sessionId
378
+ const current = caller.permissions.describe(caller.origin).permissions
379
+ if (!samePrincipal || !sameScope || !task.permissions.every((permission) => current.includes(permission))) {
380
+ throw new Error('Coding task belongs to a different caller or authority scope.')
381
+ }
382
+ }
383
+
384
+ private workspace(task: CodingTask): CodingWorkspace {
385
+ return {
386
+ source: task.source,
387
+ sourceIdentity: task.sourceIdentity,
388
+ baseSha: task.baseSha,
389
+ taskRoot: join(this.agentDir, 'workspace', 'coding-agents', task.taskId),
390
+ }
391
+ }
392
+
393
+ private executor(task: CodingTask): CodingExecutor {
394
+ return (this.dependencies.executor ?? codingGitExecutor)(task.source, this.workspace(task).taskRoot)
395
+ }
396
+
397
+ private receipt(task: CodingTask): Record<string, unknown> {
398
+ const root = this.workspace(task).taskRoot
399
+ return {
400
+ ok: task.state === 'completed',
401
+ taskId: task.taskId,
402
+ state: task.state,
403
+ baseSha: task.baseSha,
404
+ source: task.source,
405
+ engine: task.engine,
406
+ provider: task.provider,
407
+ modelRef: task.modelRef,
408
+ engineVersion: task.engineVersion,
409
+ worktreePath: join(root, 'worktree'),
410
+ finalMessage: task.finalMessage,
411
+ changedFiles: task.changedFiles,
412
+ untrackedFiles: task.untrackedFiles,
413
+ patchPath: task.oversized ? null : join(root, 'output', 'changes.patch'),
414
+ exitCode: task.exitCode,
415
+ diagnostic: task.diagnostic,
416
+ warning: 'This task uses committed HEAD only; uncommitted source changes are excluded.',
417
+ oversized: task.oversized,
418
+ }
419
+ }
420
+
421
+ private resolver(): Promise<CodingAgentAuthResolver> {
422
+ this.auth ??= (this.dependencies.auth ?? (() => createCodingAgentAuthResolver(this.agentDir)))().catch((error) => {
423
+ this.auth = undefined
424
+ throw error
425
+ })
426
+ return this.auth
427
+ }
428
+
429
+ private async load(): Promise<void> {
430
+ const path = join(this.agentDir, '.typeclaw', 'coding-agent-tasks.json')
431
+ const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW).catch((error: unknown) => {
432
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined
433
+ throw error
434
+ })
435
+ if (!file) return
436
+ try {
437
+ const text = await file.readFile('utf8')
438
+ if (!text.trim()) return
439
+ for (const task of z.array(taskSchema).parse(JSON.parse(text))) {
440
+ if (task.state === 'running') {
441
+ task.state = 'interrupted'
442
+ task.diagnostic = 'Runtime restarted; resume explicitly with a fresh invocation.'
443
+ }
444
+ this.tasks.set(task.taskId, task)
445
+ }
446
+ } finally {
447
+ await file.close()
448
+ }
449
+ }
450
+
451
+ private save(): Promise<void> {
452
+ const text = JSON.stringify([...this.tasks.values()])
453
+ this.saving = this.saving.then(() =>
454
+ writeTaskRegistry(join(this.agentDir, '.typeclaw', 'coding-agent-tasks.json'), text),
455
+ )
456
+ return this.saving
457
+ }
458
+ }
459
+
460
+ function authorize(caller: CodingCaller, agentDir: string): void {
461
+ const origin = caller.origin
462
+ if (
463
+ !origin ||
464
+ (origin.kind !== 'tui' && origin.kind !== 'channel' && origin.kind !== 'subagent') ||
465
+ !caller.permissions.has(origin, 'subagent.spawn') ||
466
+ resolveHiddenPaths(caller.permissions, origin, agentDir).dirs.includes(join(agentDir, 'workspace'))
467
+ ) {
468
+ throw new Error('Coding delegation requires subagent.spawn and private workspace access.')
469
+ }
470
+ principal(origin)
471
+ }
472
+
473
+ function principal(origin: SessionOrigin | undefined): string {
474
+ let root = origin
475
+ for (let depth = 0; root?.kind === 'subagent' && depth < 8; depth++) root = root.spawnedByOrigin
476
+ if (root?.kind === 'tui') return JSON.stringify(['tui', root.sessionId])
477
+ if (root?.kind === 'channel' && root.lastInboundAuthorId) {
478
+ const fields = [root.adapter, root.workspace, root.chat, root.thread, root.lastInboundAuthorId]
479
+ const authorNamespace = adapterNamespace(root.lastInboundAuthorAdapter ?? root.adapter)
480
+ // Legacy keys implicitly belong to the target platform. Preserve native
481
+ // and shared-account owners, but never let a foreign ID match those keys.
482
+ if (authorNamespace !== adapterNamespace(root.adapter)) fields.push(authorNamespace)
483
+ return JSON.stringify(fields)
484
+ }
485
+ throw new Error('Coding delegation requires an attributable interactive caller.')
486
+ }
487
+
488
+ const services = new Map<string, { service: CodingAgentService; owners: number }>()
489
+ export function getCodingAgentService(agentDir: string): CodingAgentService {
490
+ let entry = services.get(agentDir)
491
+ if (!entry) {
492
+ entry = { service: new CodingAgentService(agentDir), owners: 0 }
493
+ services.set(agentDir, entry)
494
+ }
495
+ return entry.service
496
+ }
497
+ export function retainCodingAgentService(agentDir: string): () => Promise<void> {
498
+ const service = getCodingAgentService(agentDir)
499
+ const entry = services.get(agentDir)
500
+ if (!entry) throw new Error('Coding service was not initialized.')
501
+ entry.owners++
502
+ let released = false
503
+ return async () => {
504
+ if (released) return
505
+ released = true
506
+ entry.owners--
507
+ if (entry.owners === 0) {
508
+ services.delete(agentDir)
509
+ await service.stop()
510
+ }
511
+ }
512
+ }
@@ -0,0 +1,69 @@
1
+ import { constants } from 'node:fs'
2
+ import { mkdir, open, readdir, type FileHandle } from 'node:fs/promises'
3
+ import { join } from 'node:path'
4
+
5
+ import { z } from 'zod'
6
+
7
+ import { createAndOpenAnchoredDirectory } from '@/agent/tool-file-safety'
8
+ import { assertCodingDirectory } from '@/sandbox/coding-agent'
9
+
10
+ const DIRECTORIES = [
11
+ 'home',
12
+ 'home/.omo',
13
+ 'agent',
14
+ 'sessions',
15
+ 'task-state',
16
+ 'tmp',
17
+ 'config',
18
+ 'cache',
19
+ 'data',
20
+ 'state',
21
+ ] as const
22
+
23
+ export async function prepareOmoDirectories(configDir: string): Promise<void> {
24
+ for (const part of ['', ...DIRECTORIES]) {
25
+ const path = join(configDir, part)
26
+ if (process.platform === 'linux') {
27
+ const directory = await createAndOpenAnchoredDirectory(path)
28
+ await directory.close()
29
+ } else {
30
+ // Dev-stage fixtures only; production execution still requires Linux bwrap.
31
+ await mkdir(path, { recursive: true, mode: 0o700 })
32
+ await assertCodingDirectory(path)
33
+ }
34
+ }
35
+ }
36
+
37
+ export async function hasOmoSession(configDir: string, sessionId: string, cwd: string): Promise<boolean> {
38
+ const directory = join(configDir, 'sessions')
39
+ let anchor: FileHandle | undefined
40
+ try {
41
+ if (process.platform === 'linux') anchor = await createAndOpenAnchoredDirectory(directory, false)
42
+ else await assertCodingDirectory(directory)
43
+ const root = anchor ? `/proc/self/fd/${anchor.fd}` : directory
44
+ const files = (await readdir(root)).filter((name) => name.endsWith(`_${sessionId}.jsonl`))
45
+ if (files.length !== 1 || !files[0]) return false
46
+ const file = await open(join(root, files[0]), constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK)
47
+ try {
48
+ const stat = await file.stat()
49
+ if (!stat.isFile() || stat.nlink !== 1) return false
50
+ // Read only the bounded session header, never the model-controlled body.
51
+ const buffer = Buffer.alloc(16 * 1024)
52
+ const { bytesRead } = await file.read(buffer, 0, buffer.length, 0)
53
+ const text = buffer.subarray(0, bytesRead).toString('utf8')
54
+ const newline = text.indexOf('\n')
55
+ if (newline < 0) return false
56
+ const header = z
57
+ .object({ type: z.literal('session'), version: z.literal(3), id: z.string().uuid(), cwd: z.string() })
58
+ .parse(JSON.parse(text.slice(0, newline)))
59
+ return header.id === sessionId && header.cwd === cwd
60
+ } finally {
61
+ await file.close()
62
+ }
63
+ } catch {
64
+ // Unsafe or missing state must never silently start a new conversation.
65
+ return false
66
+ } finally {
67
+ await anchor?.close()
68
+ }
69
+ }