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
@@ -312,9 +312,8 @@ export const KNOWN_PROVIDERS = {
312
312
  // subscriber's `claude setup-token` credential authorizes. The OAuth dance
313
313
  // itself is authorization-code + PKCE against `claude.ai/oauth/authorize`
314
314
  // with a localhost callback server (not device-code); the existing
315
- // `typeclaw-claude-code` skill documents the user-side flow for getting
316
- // a subscription credential onto the agent when the in-container browser
317
- // callback can't reach the user's machine.
315
+ // host provider setup owns login. coding_agent delegates inference through
316
+ // a fixed-upstream broker; it never exports a provider token to the CLI.
318
317
  //
319
318
  // anthropic is the FIRST provider in the registry where both auth modes
320
319
  // coexist on one entry. The runtime in src/agent/auth.ts has a load-bearing
@@ -393,6 +392,13 @@ export const KNOWN_PROVIDERS = {
393
392
  // these catalog fields Sonnet 4.6 and Opus 4.7 fall back to budget
394
393
  // thinking, which Anthropic deprecates on 4.6 and rejects with a 400 on
395
394
  // 4.7+ (platform.claude.com/docs/en/build-with-claude/extended-thinking).
395
+ //
396
+ // No Anthropic record sets `compat.supportsStrictTools`. With it, pi sends
397
+ // its strict-preferring built-ins (read/write/edit/bash) as strict tools,
398
+ // turning each optional param into a nullable union. Together with our
399
+ // own enum-union tool params that exceeds Anthropic's 16-union-param
400
+ // request cap, and every channel turn 400s. Guarded by
401
+ // anthropic-payload.test.ts.
396
402
  'claude-sonnet-4-6': {
397
403
  id: 'claude-sonnet-4-6',
398
404
  name: 'Claude Sonnet 4.6',
@@ -405,7 +411,7 @@ export const KNOWN_PROVIDERS = {
405
411
  contextWindow: 1000000,
406
412
  maxTokens: 64000,
407
413
  thinkingLevelMap: { max: 'max' },
408
- compat: { forceAdaptiveThinking: true, supportsStrictTools: true },
414
+ compat: { forceAdaptiveThinking: true },
409
415
  },
410
416
  // Sonnet 5 (Jul 1 2026) is the drop-in successor to Sonnet 4.6 with a
411
417
  // caveat set that affects consumers of this record:
@@ -431,7 +437,7 @@ export const KNOWN_PROVIDERS = {
431
437
  contextWindow: 1000000,
432
438
  maxTokens: 128000,
433
439
  thinkingLevelMap: { xhigh: 'xhigh', max: 'max' },
434
- compat: { forceAdaptiveThinking: true, supportsStrictTools: true },
440
+ compat: { forceAdaptiveThinking: true },
435
441
  },
436
442
  'claude-opus-4-7': {
437
443
  id: 'claude-opus-4-7',
@@ -445,7 +451,7 @@ export const KNOWN_PROVIDERS = {
445
451
  contextWindow: 1000000,
446
452
  maxTokens: 128000,
447
453
  thinkingLevelMap: { xhigh: 'xhigh', max: 'max' },
448
- compat: { forceAdaptiveThinking: true, supportsTemperature: false, supportsStrictTools: true },
454
+ compat: { forceAdaptiveThinking: true, supportsTemperature: false },
449
455
  },
450
456
  // Opus 4.8 was never in pi 0.73's adaptive id list, so it already got
451
457
  // budget thinking (a 400 on 4.7+) before this migration. The catalog
@@ -467,7 +473,6 @@ export const KNOWN_PROVIDERS = {
467
473
  supportsMidConvoToolChanges: true,
468
474
  forceAdaptiveThinking: true,
469
475
  supportsTemperature: false,
470
- supportsStrictTools: true,
471
476
  },
472
477
  },
473
478
  // Opus 5.5 (Sep 22 2026) keeps adaptive thinking permanently on: both
@@ -504,7 +509,6 @@ export const KNOWN_PROVIDERS = {
504
509
  supportsMidConvoToolChanges: true,
505
510
  forceAdaptiveThinking: true,
506
511
  supportsTemperature: false,
507
- supportsStrictTools: true,
508
512
  },
509
513
  },
510
514
  // Fable 5 (Jun 2026) is a NEW TIER above Opus — Anthropic's most
@@ -533,7 +537,6 @@ export const KNOWN_PROVIDERS = {
533
537
  supportsMidConvoSystemMessages: true,
534
538
  supportsMidConvoToolChanges: true,
535
539
  forceAdaptiveThinking: true,
536
- supportsStrictTools: true,
537
540
  },
538
541
  },
539
542
  },
@@ -1402,6 +1405,60 @@ export const KNOWN_PROVIDERS = {
1402
1405
  },
1403
1406
  },
1404
1407
  },
1408
+ // Inception (Mercury diffusion LLMs) official API. OpenAI-compatible
1409
+ // /v1/chat/completions with Bearer auth, so it goes through pi-ai's
1410
+ // `openai-completions` adapter with a custom baseUrl. api-key only.
1411
+ //
1412
+ // Only Mercury 3 is listed: Mercury 2 / 2.5 are closed to new users as of
1413
+ // 2026-10-19 and shut down for existing ones on 2026-11-15. Mercury Voice is
1414
+ // enterprise-gated, Mercury Decide and Mercury Edit 2 don't serve chat.
1415
+ //
1416
+ // Cost is the standard rate from docs.inceptionlabs.ai/get-started/models
1417
+ // as of 2026-10-20, not the 50%-off launch price, so the record doesn't go
1418
+ // stale when the promotion ends. No cache-write surcharge is published.
1419
+ //
1420
+ // reasoning_effort accepts instant/low/medium/high and defaults to `low`
1421
+ // when omitted. `off` maps to `instant` so a non-reasoning turn really drops
1422
+ // to the fastest mode instead of silently reasoning at the default.
1423
+ //
1424
+ // The OpenAPI spec (api.inceptionlabs.ai/openapi.json) documents neither
1425
+ // `store` nor the `developer` role, and pi-ai doesn't auto-detect compat
1426
+ // for this baseUrl, so both are turned off.
1427
+ inception: {
1428
+ id: 'inception',
1429
+ name: 'Inception (Mercury)',
1430
+ baseUrl: 'https://api.inceptionlabs.ai/v1',
1431
+ auth: ['api-key'],
1432
+ apiKeyEnv: 'INCEPTION_API_KEY',
1433
+ oauthProviderId: null,
1434
+ models: {
1435
+ 'mercury-3': {
1436
+ id: 'mercury-3',
1437
+ name: 'Mercury 3',
1438
+ api: 'openai-completions',
1439
+ provider: 'inception',
1440
+ baseUrl: 'https://api.inceptionlabs.ai/v1',
1441
+ reasoning: true,
1442
+ thinkingLevelMap: {
1443
+ off: 'instant',
1444
+ minimal: 'low',
1445
+ low: 'low',
1446
+ medium: 'medium',
1447
+ high: 'high',
1448
+ xhigh: 'high',
1449
+ },
1450
+ input: ['text'],
1451
+ cost: { input: 0.2, output: 0.7, cacheRead: 0.02, cacheWrite: 0 },
1452
+ contextWindow: 1000000,
1453
+ maxTokens: 131072,
1454
+ compat: {
1455
+ supportsStore: false,
1456
+ supportsDeveloperRole: false,
1457
+ supportsReasoningEffort: true,
1458
+ },
1459
+ },
1460
+ },
1461
+ },
1405
1462
  } as const satisfies Record<string, KnownProvider>
1406
1463
 
1407
1464
  export type KnownProviderId = keyof typeof KNOWN_PROVIDERS
@@ -1489,6 +1546,11 @@ export const KNOWN_PROVIDER_VENDORS = {
1489
1546
  'moonshot-coding': { label: 'Coding Plan', hint: 'Kimi Code subscription' },
1490
1547
  },
1491
1548
  },
1549
+ inception: {
1550
+ id: 'inception',
1551
+ name: 'Inception (Mercury)',
1552
+ providers: ['inception'],
1553
+ },
1492
1554
  // Listed last because it is a reseller, not a lab: a user who knows they want
1493
1555
  // Anthropic should land on the Anthropic row, not the gateway that proxies it.
1494
1556
  opengateway: {
@@ -0,0 +1,44 @@
1
+ import type { DockerExec } from './shared'
2
+
3
+ // OOMKilled is container-wide: a killed subprocess can set it even when the runtime survives.
4
+ // `finishedAt` identifies one stop of a container: Docker keeps the container ID across
5
+ // restarts, so ID alone cannot tell a repeated observation of the same exit from a new one.
6
+ export async function inspectContainerExit(
7
+ exec: DockerExec,
8
+ name: string,
9
+ ): Promise<
10
+ | { kind: 'running'; containerId: string }
11
+ | { kind: 'stopped'; containerId: string; finishedAt: string; reason: string | null }
12
+ | null
13
+ > {
14
+ try {
15
+ const result = await exec([
16
+ 'inspect',
17
+ '--format',
18
+ '{{.Id}}|{{.State.Running}}|{{.State.OOMKilled}}|{{.State.ExitCode}}|{{.HostConfig.Memory}}|{{.State.FinishedAt}}',
19
+ name,
20
+ ])
21
+ if (result.exitCode !== 0) return null
22
+ const match = /^([0-9a-f]{64})\|(true|false)\|(true|false)\|(\d+)\|(\d+)\|(\S+)$/.exec(result.stdout.trim())
23
+ if (!match) return null
24
+ const containerId = match[1]!
25
+ if (match[2] === 'true') return { kind: 'running', containerId }
26
+ const limitBytes = Number(match[5])
27
+ const limit =
28
+ Number.isSafeInteger(limitBytes) && limitBytes > 0
29
+ ? ` (likely container memory limit ${Math.ceil(limitBytes / (1024 * 1024))} MiB)`
30
+ : ''
31
+ const exitCode = Number(match[4])
32
+ const reason =
33
+ match[3] === 'true'
34
+ ? exitCode === 137
35
+ ? `agent runtime was SIGKILLed (137) and the container recorded an OOM kill during this run${limit}. Restart the agent and reduce memory-heavy parallel work.`
36
+ : `agent runtime exited with code ${exitCode}; an OOM kill occurred in the container earlier in this run${limit}; a subprocess may have been killed. Restart the agent and reduce memory-heavy parallel work.`
37
+ : exitCode === 137
38
+ ? 'agent runtime exited with SIGKILL (137); Docker did not report an OOM kill.'
39
+ : null
40
+ return { kind: 'stopped', containerId, finishedAt: match[6]!, reason }
41
+ } catch {
42
+ return null
43
+ }
44
+ }
@@ -62,3 +62,8 @@ export {
62
62
  type WithAgentOperationLock,
63
63
  withAgentOperationLock,
64
64
  } from './agent-operation-lock'
65
+ export {
66
+ formatOversubscriptionWarning,
67
+ readFleetMemoryOversubscription,
68
+ type OversubscriptionWarning,
69
+ } from './memory-oversubscription'
@@ -4,7 +4,7 @@ import { join } from 'node:path'
4
4
 
5
5
  import { DEFAULT_LOG_RETENTION_DAYS, MAX_LOG_RETENTION_DAYS } from '@/config'
6
6
 
7
- import { resolveDockerBinary, sanitizeDockerStderr } from './shared'
7
+ import { defaultDockerExec, resolveDockerBinary, sanitizeDockerStderr, type DockerExecResult } from './shared'
8
8
 
9
9
  export type DockerLogArchiveResult =
10
10
  | { ok: true; status: 'archived'; path: string }
@@ -49,6 +49,7 @@ export type StreamCaptureResult = {
49
49
 
50
50
  export type DockerLogArchiveRuntime = {
51
51
  capture?: (input: StreamCaptureInput) => Promise<StreamCaptureResult>
52
+ inspectLogConfig?: (args: string[], options: { cwd: string; signal: AbortSignal }) => Promise<DockerExecResult>
52
53
  nonce?: () => string
53
54
  now?: () => Date
54
55
  resolveDockerBinary?: () => string | null
@@ -74,6 +75,43 @@ const CONTAINER_ID_PATTERN = /^[a-f0-9]{64}$/
74
75
  const NONCE_PATTERN = /^[a-f0-9]{32}$/
75
76
  const ARCHIVE_FILENAME_PATTERN = /^[a-f0-9]{64}-(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z-[a-f0-9]{32}\.log$/
76
77
  const PARTIAL_FILENAME_PATTERN = /^\.[a-f0-9]{64}-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z-[a-f0-9]{32}\.partial$/
78
+ const DOCKER_LOG_INSPECT_TIMEOUT_MS = 10_000
79
+
80
+ async function archiveByteLimit(
81
+ agentDir: string,
82
+ containerId: string,
83
+ inspect: NonNullable<DockerLogArchiveRuntime['inspectLogConfig']>,
84
+ ): Promise<number> {
85
+ try {
86
+ const result = await inspect(['inspect', '--format', '{{json .HostConfig.LogConfig}}', containerId], {
87
+ cwd: agentDir,
88
+ signal: AbortSignal.timeout(DOCKER_LOG_INSPECT_TIMEOUT_MS),
89
+ })
90
+ if (result.exitCode !== 0) return MAX_DOCKER_LOG_ARCHIVE_BYTES
91
+ const config: unknown = JSON.parse(result.stdout)
92
+ if (typeof config !== 'object' || config === null || !('Type' in config) || config.Type !== 'json-file')
93
+ return MAX_DOCKER_LOG_ARCHIVE_BYTES
94
+ if (!('Config' in config) || typeof config.Config !== 'object' || config.Config === null)
95
+ return MAX_DOCKER_LOG_ARCHIVE_BYTES
96
+ const opts = config.Config
97
+ if (!('max-size' in opts) || typeof opts['max-size'] !== 'string') return MAX_DOCKER_LOG_ARCHIVE_BYTES
98
+ const maxFiles = 'max-file' in opts ? opts['max-file'] : '1'
99
+ // Docker parses max-file with strconv.Atoi, so "05" is 5; only positive counts are bounded.
100
+ if (typeof maxFiles !== 'string' || !/^\+?\d+$/.test(maxFiles) || Number(maxFiles) < 1)
101
+ return MAX_DOCKER_LOG_ARCHIVE_BYTES
102
+ // Docker json-file uses go-units FromHumanSize: decimal powers even for "MiB".
103
+ const sizeMatch = /^(\+?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?)(?: ?(b|[kmgtp](?:i?b)?))?$/i.exec(opts['max-size'])
104
+ if (!sizeMatch) return MAX_DOCKER_LOG_ARCHIVE_BYTES
105
+ const prefix = sizeMatch[2]?.toLowerCase()[0]
106
+ const multiplier = prefix && prefix !== 'b' ? 1000 ** ('kmgtp'.indexOf(prefix) + 1) : 1
107
+ const size = Math.trunc(Number(sizeMatch[1]) * multiplier)
108
+ const capacity = size * Number(maxFiles)
109
+ if (size <= 0 || !Number.isSafeInteger(capacity)) return MAX_DOCKER_LOG_ARCHIVE_BYTES
110
+ return Math.min(MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES, Math.max(MAX_DOCKER_LOG_ARCHIVE_BYTES, capacity))
111
+ } catch {
112
+ return MAX_DOCKER_LOG_ARCHIVE_BYTES
113
+ }
114
+ }
77
115
 
78
116
  export async function archiveContainerLogs(
79
117
  { agentDir, containerId, retentionDays = DEFAULT_LOG_RETENTION_DAYS }: Parameters<DockerLogArchiver>[0],
@@ -106,18 +144,21 @@ export async function archiveContainerLogs(
106
144
  if (binary === null) throw new Error('Docker binary could not be resolved for log archival')
107
145
 
108
146
  const capture = runtime.capture ?? streamProcessOutput
147
+ const maxBytes = await archiveByteLimit(agentDir, containerId, runtime.inspectLogConfig ?? defaultDockerExec)
109
148
  const captured = await capture({
110
149
  args: ['logs', '--timestamps', containerId],
111
150
  binary,
112
151
  cwd: agentDir,
113
- maxBytes: MAX_DOCKER_LOG_ARCHIVE_BYTES,
152
+ maxBytes,
114
153
  output,
115
154
  timeoutMs: DOCKER_LOG_ARCHIVE_TIMEOUT_MS,
116
155
  })
117
156
  if (captured.terminationBoundExceeded) throw new Error('docker logs did not settle after SIGKILL')
118
157
  if (captured.timedOut) throw new Error(`docker logs timed out after ${DOCKER_LOG_ARCHIVE_TIMEOUT_MS}ms`)
119
158
  if (captured.overflowed) {
120
- throw new Error(`docker logs exceeded the ${MAX_DOCKER_LOG_ARCHIVE_BYTES}-byte archive limit`)
159
+ throw new Error(
160
+ `docker logs exceeded the ${maxBytes}-byte archive limit. Container ${containerId} was preserved; export both log streams with docker logs --timestamps ${containerId} > private-log-file 2>&1 (choose a private destination); confirm the export succeeded before removing it with docker rm ${containerId} and retrying.`,
161
+ )
121
162
  }
122
163
  if (captured.exitCode !== 0) {
123
164
  const detail = sanitizeDockerStderr(captured.stderrExcerpt)
@@ -128,13 +169,16 @@ export async function archiveContainerLogs(
128
169
 
129
170
  await output.chmod(0o600)
130
171
  const incomingSize = (await output.stat()).size
131
- await pruneToCapacity(logsDir, incomingSize)
172
+ if (incomingSize > MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES) {
173
+ throw new Error('Docker log archive exceeds total archive capacity')
174
+ }
132
175
  await output.close()
133
176
  output = null
134
177
 
135
178
  await rename(temporaryPath, allocation.finalPath)
136
179
  temporaryPath = null
137
180
  await chmod(allocation.finalPath, 0o600)
181
+ await pruneToCapacity(logsDir, allocation.finalPath)
138
182
  return { ok: true, status: 'archived', path: allocation.finalPath }
139
183
  } catch (error) {
140
184
  const cleanupErrors = await cleanupTemp(output, temporaryPath)
@@ -334,10 +378,7 @@ async function pruneByAgeAndRemoveStalePartials(logsDir: string, ageCutoff: numb
334
378
  }
335
379
  }
336
380
 
337
- async function pruneToCapacity(logsDir: string, incomingSize: number): Promise<void> {
338
- if (incomingSize > MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES) {
339
- throw new Error('Docker log archive exceeds total archive capacity')
340
- }
381
+ async function pruneToCapacity(logsDir: string, publishedPath: string): Promise<void> {
341
382
  const snapshots: Array<{ name: string; path: string; size: number; timestamp: number }> = []
342
383
  for (const entry of await collectDirectoryEntries(logsDir)) {
343
384
  if (!entry.isFile()) continue
@@ -351,11 +392,8 @@ async function pruneToCapacity(logsDir: string, incomingSize: number): Promise<v
351
392
  let totalBytes = snapshots.reduce((total, snapshot) => total + snapshot.size, 0)
352
393
  let count = snapshots.length
353
394
  for (const snapshot of snapshots) {
354
- if (
355
- count + 1 <= MAX_DOCKER_LOG_ARCHIVE_SNAPSHOTS &&
356
- totalBytes + incomingSize <= MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES
357
- )
358
- break
395
+ if (count <= MAX_DOCKER_LOG_ARCHIVE_SNAPSHOTS && totalBytes <= MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES) break
396
+ if (snapshot.path === publishedPath) continue
359
397
  await removeRaceSafe(snapshot.path)
360
398
  count -= 1
361
399
  totalBytes -= snapshot.size
@@ -14,7 +14,7 @@ export const DEFAULT_CONTAINER_MEMORY_BYTES = 6 * BYTES_PER_GIB
14
14
  // Memory left to the Docker VM itself (dockerd, containerd, the guest kernel,
15
15
  // page cache) when the default does not fit. Without it a single agent sized to
16
16
  // the whole machine reproduces the exhaustion this limit exists to prevent.
17
- const HOST_HEADROOM_BYTES = 2 * BYTES_PER_GIB
17
+ export const HOST_HEADROOM_BYTES = 2 * BYTES_PER_GIB
18
18
 
19
19
  // Below this a container cannot boot the agent at all, so clamping further down
20
20
  // would trade a slow host for an agent that never starts.
@@ -1,4 +1,5 @@
1
1
  import { COMPOSE_PROJECT } from './compose-project'
2
+ import { HOST_HEADROOM_BYTES, readDockerTotalMemory } from './memory-limit'
2
3
  import type { DockerExec } from './shared'
3
4
 
4
5
  // `bytes: null` means the container runs with NO memory limit. That is a
@@ -33,7 +34,8 @@ export type OversubscriptionWarning = {
33
34
  // crowded host. The operator gets the arithmetic and decides.
34
35
  export function decideMemoryOversubscription(options: {
35
36
  running: AgentMemoryClaim[]
36
- incoming: AgentMemoryClaim
37
+ // Omitted for a fleet-wide check run after every agent is already up.
38
+ incoming?: AgentMemoryClaim
37
39
  totalMemoryBytes: number | undefined
38
40
  }): OversubscriptionWarning | null {
39
41
  const { running, incoming, totalMemoryBytes } = options
@@ -41,8 +43,10 @@ export function decideMemoryOversubscription(options: {
41
43
  // A restart re-runs start for a container that is already listed, so drop any
42
44
  // running claim under the incoming name before summing. Counting it twice
43
45
  // would fire the warning on a plain `typeclaw restart` of a single agent.
44
- const others = running.filter((claim) => claim.containerName !== incoming.containerName)
45
- const claims = [...others, incoming]
46
+ const claims =
47
+ incoming === undefined
48
+ ? running
49
+ : [...running.filter((claim) => claim.containerName !== incoming.containerName), incoming]
46
50
  const unbounded = claims.filter((claim) => claim.bytes === null)
47
51
  const claimedBytes = claims.reduce((sum, claim) => sum + (claim.bytes ?? 0), 0)
48
52
 
@@ -63,9 +67,10 @@ export function decideMemoryOversubscription(options: {
63
67
 
64
68
  export function formatOversubscriptionWarning(warning: OversubscriptionWarning): string[] {
65
69
  const gib = (bytes: number): string => `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}GiB`
70
+ const width = warning.claims.reduce((w, claim) => Math.max(w, claim.containerName.length), 0)
66
71
  const roster = warning.claims
67
- .map((claim) => ` ${claim.containerName} ${claim.bytes === null ? 'unlimited' : gib(claim.bytes)}`)
68
- .sort((a, b) => a.localeCompare(b))
72
+ .toSorted((a, b) => a.containerName.localeCompare(b.containerName))
73
+ .map((claim) => ` ${claim.containerName.padEnd(width)} ${claim.bytes === null ? 'unlimited' : gib(claim.bytes)}`)
69
74
 
70
75
  const capacity = warning.totalMemoryBytes === null ? null : gib(warning.totalMemoryBytes)
71
76
  const names = warning.unbounded.map((claim) => claim.containerName).join(', ')
@@ -78,11 +83,36 @@ export function formatOversubscriptionWarning(warning: OversubscriptionWarning):
78
83
  const remedy =
79
84
  warning.unbounded.length > 0
80
85
  ? ['An unbounded agent can exhaust the host on its own. Restart it to apply', 'the current limit.']
81
- : ['If they peak together the host can still exhaust. Stop an agent, or', 'give Docker more memory.']
86
+ : oversubscriptionRemedy(warning.claimedBytes)
82
87
 
83
88
  return [headline, ...roster, ...remedy]
84
89
  }
85
90
 
91
+ function oversubscriptionRemedy(claimedBytes: number): string[] {
92
+ const targetGib = Math.ceil((claimedBytes + HOST_HEADROOM_BYTES) / (1024 * 1024 * 1024))
93
+ return [
94
+ 'If they peak together the host can still exhaust. Either:',
95
+ ' • Stop an agent: run `typeclaw stop` in its folder.',
96
+ ` • Give Docker at least ${targetGib}GiB of memory, then restart the runtime:`,
97
+ ' Docker Desktop: Settings → Resources → Memory limit → Apply & restart',
98
+ ` OrbStack: orb config set memory_mib ${targetGib * 1024}`,
99
+ ` Colima: colima stop && colima start --memory ${targetGib}`,
100
+ ' Linux Engine: Docker uses host RAM directly; stop an agent instead.',
101
+ ]
102
+ }
103
+
104
+ // Fleet-wide variant for `typeclaw compose`: agents start concurrently, so a
105
+ // per-agent check sees whichever siblings happened to be up and repeats the same
106
+ // advice once per agent. Checking once after the whole fleet settled reports the
107
+ // real total exactly once.
108
+ export async function readFleetMemoryOversubscription(exec: DockerExec): Promise<OversubscriptionWarning | null> {
109
+ const [running, totalMemoryBytes] = await Promise.all([
110
+ readRunningAgentMemoryClaims(exec),
111
+ readDockerTotalMemory(exec),
112
+ ])
113
+ return decideMemoryOversubscription({ running, totalMemoryBytes })
114
+ }
115
+
86
116
  // Reads the memory cap Docker actually applied to every running agent. Docker
87
117
  // reports 0 for a container created with no limit, which is UNLIMITED, not
88
118
  // missing — an agent started before this field existed is precisely the case
@@ -0,0 +1,86 @@
1
+ import { readFileSync } from 'node:fs'
2
+
3
+ export type OomEventCounts = { oom: number; oomKill: number }
4
+ export type OomEventsReader = () => OomEventCounts | null
5
+
6
+ // Docker's private cgroup namespace exposes its own v2 root here. Cgroup v1,
7
+ // dev hosts and unreadable/malformed files provide no reliable pair: fail open.
8
+ export function readOomEvents(path = '/sys/fs/cgroup/memory.events'): OomEventCounts | null {
9
+ try {
10
+ const events = readFileSync(path, 'utf8')
11
+ const oom = /^oom (\d+)$/m.exec(events)
12
+ const oomKill = /^oom_kill (\d+)$/m.exec(events)
13
+ if (oom === null || oomKill === null) return null
14
+ const counts = { oom: Number(oom[1]), oomKill: Number(oomKill[1]) }
15
+ return Number.isSafeInteger(counts.oom) && Number.isSafeInteger(counts.oomKill) ? counts : null
16
+ } catch {
17
+ return null
18
+ }
19
+ }
20
+
21
+ export function readMemoryLimitMiB(path = '/sys/fs/cgroup/memory.max'): number | null {
22
+ try {
23
+ const bytes = readFileSync(path, 'utf8').trim()
24
+ if (!/^\d+$/.test(bytes)) return null
25
+ const value = Number(bytes)
26
+ return Number.isSafeInteger(value) ? Math.round(value / 1048576) : null
27
+ } catch {
28
+ return null
29
+ }
30
+ }
31
+
32
+ const claimedCounts = new Map<number, string>()
33
+ const reportedCounts = new Set<number>()
34
+
35
+ // memory.events is CONTAINER-wide: a concurrent unrelated OOM may increase
36
+ // either counter during this command. A limit event plus kill is evidence of
37
+ // container pressure, not proof that the observed child was the victim.
38
+ export function toolOomNote(
39
+ before: OomEventCounts | null,
40
+ exitCode: number,
41
+ tool: string,
42
+ options: { read?: OomEventsReader; limitMiB?: () => number | null; log?: (line: string) => void } = {},
43
+ ): string | null {
44
+ if (exitCode !== 137 || before === null) return null
45
+ const after = (options.read ?? readOomEvents)()
46
+ if (after === null || after.oomKill <= before.oomKill) return null
47
+ // Only a single new event can be claimed unambiguously. A sampler may
48
+ // already have logged it before this command's stdout finished draining.
49
+ if (after.oomKill === before.oomKill + 1) claimedCounts.set(after.oomKill, tool)
50
+ const limit = (options.limitMiB ?? readMemoryLimitMiB)()
51
+ const reachedLimit = after.oom > before.oom
52
+ const detail = reachedLimit
53
+ ? `the container reached its memory limit${limit === null ? '' : ` (${limit} MiB)`}`
54
+ : `without a container memory-limit event${limit === null ? '' : ` (configured limit ${limit} MiB)`}`
55
+ if (!reportedCounts.has(after.oomKill)) {
56
+ options.log?.(`[tool] ${tool} subprocess SIGKILL; OOM kill observed while command ran; ${detail}`)
57
+ }
58
+ return `An OOM kill was observed while this command ran (exit 137); ${detail}. Reduce parallelism or memory use before retrying.`
59
+ }
60
+
61
+ export function unclaimedOomEvents(
62
+ previous: OomEventCounts,
63
+ current: OomEventCounts,
64
+ ): { from: number; to: number; claimed: string[]; reachedLimit: boolean } | null {
65
+ if (current.oomKill <= previous.oomKill) return null
66
+ const claimed: string[] = []
67
+ let unclaimed = false
68
+ for (let count = previous.oomKill + 1; count <= current.oomKill; count++) {
69
+ const tool = claimedCounts.get(count)
70
+ if (tool === undefined) {
71
+ unclaimed = true
72
+ reportedCounts.add(count)
73
+ } else {
74
+ claimed.push(tool)
75
+ }
76
+ claimedCounts.delete(count)
77
+ }
78
+ // Retain a bounded window for a late tool completion after the sampler's
79
+ // tick. Its model note still arrives, but the operator need not see two lines.
80
+ for (const count of reportedCounts) {
81
+ if (count < current.oomKill - 64) reportedCounts.delete(count)
82
+ }
83
+ return unclaimed
84
+ ? { from: previous.oomKill, to: current.oomKill, claimed, reachedLimit: current.oom > previous.oom }
85
+ : null
86
+ }
@@ -8,6 +8,7 @@ export type RestartOptions = {
8
8
  forceBuild?: boolean
9
9
  streamOutput?: boolean
10
10
  onWarning?: (warning: string) => void
11
+ skipMemoryOversubscriptionCheck?: boolean
11
12
  cliEntry?: string
12
13
  reuseCurrentHostDaemon?: boolean
13
14
  currentHostDaemon?: CurrentHostDaemon
@@ -53,6 +54,7 @@ async function restartWithLease(
53
54
  forceBuild: options.forceBuild,
54
55
  streamOutput: options.streamOutput,
55
56
  onWarning: options.onWarning,
57
+ skipMemoryOversubscriptionCheck: options.skipMemoryOversubscriptionCheck,
56
58
  cliEntry: options.cliEntry,
57
59
  reuseCurrentHostDaemon: options.reuseCurrentHostDaemon,
58
60
  currentHostDaemon: options.currentHostDaemon,
@@ -536,12 +536,19 @@ export async function cleanupRunCorpse(
536
536
  // `docker run --name <same>` to succeed — Docker's name-reservation table
537
537
  // drains independently. waitForRemoval is the fast path; the retry on
538
538
  // `docker run` (see isContainerNameConflict) is the safety net.
539
+ //
540
+ // The budget is generous because a draining removal is normal, not stuck:
541
+ // OrbStack has been observed taking ~40s to destroy agents with large
542
+ // writable layers. Timing out early makes `compose restart` report a healthy
543
+ // drain as stuck and tell the operator to restart Docker for nothing.
544
+ export const CONTAINER_REMOVAL_TIMEOUT_MS = 120_000
545
+
539
546
  export async function waitForRemoval(
540
547
  exec: DockerExec,
541
548
  name: string,
542
549
  options: { timeoutMs?: number; intervalMs?: number } = {},
543
550
  ): Promise<boolean> {
544
- const timeoutMs = options.timeoutMs ?? 10_000
551
+ const timeoutMs = options.timeoutMs ?? CONTAINER_REMOVAL_TIMEOUT_MS
545
552
  const intervalMs = options.intervalMs ?? 100
546
553
  const deadline = Date.now() + timeoutMs
547
554
  while (Date.now() < deadline) {