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
@@ -115,17 +115,30 @@ export type StatusSnapshot = {
115
115
  }
116
116
 
117
117
  export class LiveSubagentRegistry {
118
+ private readonly listeners = new Set<(parentSessionId: string | undefined) => void>()
118
119
  private readonly entries = new Map<string, LiveSubagent>()
119
120
  private readonly events = new Map<string, SubagentProgressEvent[]>()
120
121
  private readonly capturedFinalMessages = new Map<string, string>()
121
122
  private readonly pendingWorkKeyRegistrations = new Map<string, Set<PendingWorkKeyRegistration>>()
122
123
 
124
+ subscribe(listener: (parentSessionId: string | undefined) => void): () => void {
125
+ this.listeners.add(listener)
126
+ return () => {
127
+ this.listeners.delete(listener)
128
+ }
129
+ }
130
+
131
+ private notify(parentSessionId: string | undefined): void {
132
+ for (const listener of this.listeners) listener(parentSessionId)
133
+ }
134
+
123
135
  register(live: LiveSubagent): void {
124
136
  if (this.entries.has(live.taskId)) {
125
137
  throw new Error(`task ${live.taskId} already registered`)
126
138
  }
127
139
  this.entries.set(live.taskId, live)
128
140
  this.events.set(live.taskId, [{ kind: 'started', ts: live.startedAt }])
141
+ this.notify(live.parentSessionId)
129
142
  }
130
143
 
131
144
  beginWorkKeyRegistration(workKey: string): PendingWorkKeyRegistration {
@@ -151,9 +164,11 @@ export class LiveSubagentRegistry {
151
164
  }
152
165
 
153
166
  unregister(taskId: string): void {
167
+ const entry = this.entries.get(taskId)
154
168
  this.entries.delete(taskId)
155
169
  this.events.delete(taskId)
156
170
  this.capturedFinalMessages.delete(taskId)
171
+ if (entry) this.notify(entry.parentSessionId)
157
172
  }
158
173
 
159
174
  get(taskId: string): LiveSubagent | undefined {
@@ -198,6 +213,7 @@ export class LiveSubagentRegistry {
198
213
  if (entry === undefined) return
199
214
  entry.completion = completion
200
215
  entry.status = completion.ok ? 'completed' : 'failed'
216
+ this.notify(entry.parentSessionId)
201
217
  }
202
218
 
203
219
  // First-writer-wins settlement, returning whether THIS caller won. A subagent
@@ -215,6 +231,7 @@ export class LiveSubagentRegistry {
215
231
  if (entry === undefined || entry.status !== 'running') return false
216
232
  entry.completion = completion
217
233
  entry.status = completion.ok ? 'completed' : 'failed'
234
+ this.notify(entry.parentSessionId)
218
235
  return true
219
236
  }
220
237
 
@@ -287,10 +304,13 @@ export class LiveSubagentRegistry {
287
304
  }
288
305
 
289
306
  clear(): void {
307
+ // Shutdown must not erase evidence of children that have not terminated.
308
+ const parents = new Set(Array.from(this.entries.values(), (entry) => entry.parentSessionId))
290
309
  this.entries.clear()
291
310
  this.events.clear()
292
311
  this.capturedFinalMessages.clear()
293
312
  this.pendingWorkKeyRegistrations.clear()
313
+ for (const parent of parents) this.notify(parent)
294
314
  }
295
315
 
296
316
  private removePendingWorkKeyRegistration(registration: PendingWorkKeyRegistration): void {
@@ -116,19 +116,28 @@ export function createChannelLookAtTool(
116
116
  description:
117
117
  'View an image attached to a channel message. Inbound messages show ' +
118
118
  '`[<Platform> attachment #N: <kind> <metadata>]`; pass `N` as `attachment_id`. Do not invent ids. ' +
119
- 'Images on the CURRENT inbound resolve directly; for one from an EARLIER message, call channel_history ' +
120
- 'first to make it resolvable by the same id.',
119
+ 'Images on the CURRENT inbound resolve directly; for an EARLIER message call channel_history first. ' +
120
+ 'On Slack pass file_id when the request names an exact file or several messages reuse #1.',
121
121
  parameters: Type.Object({
122
122
  attachment_id: Type.Integer({
123
123
  description: 'The number N from the inbound `[<Platform> attachment #N: ...]` placeholder.',
124
124
  minimum: 1,
125
125
  }),
126
+ file_id: Type.Optional(
127
+ Type.String({ pattern: '^F[A-Z0-9]+$', description: 'Exact Slack file ID from the request or history.' }),
128
+ ),
126
129
  prompt: Type.Optional(
127
130
  Type.String({ description: 'Optional question to ask about the image; omitted means describe it.' }),
128
131
  ),
129
132
  }),
130
133
  async execute(_toolCallId, params) {
131
- const found = router.lookupInboundAttachment({ ...origin, id: params.attachment_id })
134
+ if (params.file_id !== undefined && origin.adapter !== 'slack' && origin.adapter !== 'slack-bot')
135
+ return errorResult('file_id is only supported for Slack attachments', { count: 0, prompt: params.prompt })
136
+ const found = router.lookupInboundAttachment({
137
+ ...origin,
138
+ id: params.attachment_id,
139
+ ...(params.file_id !== undefined ? { ref: params.file_id } : {}),
140
+ })
132
141
  if (found === null) {
133
142
  const validIds = router.listInboundAttachmentIds(origin)
134
143
  const validMsg =
@@ -151,12 +160,16 @@ export function createChannelLookAtTool(
151
160
  maxBytes: LOOK_AT_MAX_BYTES,
152
161
  ...(found.filename !== undefined ? { filename: found.filename } : {}),
153
162
  })
154
- if (!result.ok) return errorResult(result.error, { count: 0, prompt: params.prompt })
155
- return await runLookAtImages(
156
- [toImageContent(result.buffer.toString('base64'), result.mimetype ?? 'image/jpeg')],
157
- params.prompt,
158
- permissions,
159
- )
163
+ const viewed = result.ok
164
+ ? await runLookAtImages(
165
+ [toImageContent(result.buffer.toString('base64'), result.mimetype ?? 'image/jpeg')],
166
+ params.prompt,
167
+ permissions,
168
+ )
169
+ : errorResult(result.error, { count: 0, prompt: params.prompt })
170
+ if (origin.adapter === 'slack' || origin.adapter === 'slack-bot')
171
+ viewed.content.unshift({ type: 'text', text: `Selected Slack file_id=${found.ref}` })
172
+ return viewed
160
173
  },
161
174
  })
162
175
  }
@@ -4,6 +4,7 @@ import { join, relative, sep } from 'node:path'
4
4
 
5
5
  import {
6
6
  createBashToolDefinition as piCreateBashToolDefinition,
7
+ createLocalBashOperations,
7
8
  createEditToolDefinition as piCreateEditToolDefinition,
8
9
  createFindToolDefinition as piCreateFindToolDefinition,
9
10
  createGrepToolDefinition as piCreateGrepToolDefinition,
@@ -19,6 +20,8 @@ import { z } from 'zod'
19
20
 
20
21
  import { ACKNOWLEDGE_GUARDS } from '@/bundled-plugins/guard/keys'
21
22
  import { config, getSandboxWritablePathSpecs } from '@/config/config'
23
+ import { readOomEvents, toolOomNote } from '@/container/oom-events'
24
+ import { withToolOomPriorityCommand } from '@/container/tool-oom-priority'
22
25
  import { readEnvFile } from '@/init/env-file'
23
26
  import {
24
27
  classifyToolOutcome,
@@ -75,6 +78,7 @@ import {
75
78
  verifyHiddenMaskTargets,
76
79
  verifyPrivilegedSandboxRuntime,
77
80
  } from '@/sandbox'
81
+ import { resolveDevSourceMount } from '@/sandbox/dev-source'
78
82
  import { resolveExposableEnvNames } from '@/sandbox/env-exposure'
79
83
 
80
84
  import type { InternalGuard } from './guard-types'
@@ -136,6 +140,7 @@ type BashSpawnEnvContext = {
136
140
  // that appears in process.env between policy build and spawn stays out of the
137
141
  // sandbox (closes the inherit TOCTOU).
138
142
  sandboxSpawnEnv?: Record<string, string>
143
+ oomNote?: string
139
144
  }
140
145
 
141
146
  const bashEnvStore = new AsyncLocalStorage<BashSpawnEnvContext | undefined>()
@@ -164,8 +169,9 @@ function readBashPreparation(args: Record<string, unknown>): DeferredBashPrepara
164
169
 
165
170
  function bashSpawnHookWithOverlay(context: BashSpawnContext): BashSpawnContext {
166
171
  const store = bashEnvStore.getStore()
167
- if (store?.sandboxSpawnEnv !== undefined) return { ...context, env: { ...store.sandboxSpawnEnv } }
168
- return { ...context, env: sanitizeBashSpawnEnvironment(context.env, store?.overlay, store?.withhold) }
172
+ const command = withToolOomPriorityCommand(context.command)
173
+ if (store?.sandboxSpawnEnv !== undefined) return { ...context, command, env: { ...store.sandboxSpawnEnv } }
174
+ return { ...context, command, env: sanitizeBashSpawnEnvironment(context.env, store?.overlay, store?.withhold) }
169
175
  }
170
176
 
171
177
  export function sanitizeBashSpawnEnvironment(
@@ -204,14 +210,33 @@ function createPiBuiltinToolDefinition(name: PiBuiltinToolName, cwd: string): To
204
210
  switch (name) {
205
211
  case 'read':
206
212
  return piCreateReadToolDefinition(cwd)
207
- case 'bash':
213
+ case 'bash': {
214
+ const operations = createLocalBashOperations()
208
215
  return piCreateBashToolDefinition(cwd, {
209
- // Pi 0.87 assumes a non-empty ExtensionContext when session metadata is
210
- // enabled (tools/bash.js:122-143). TypeClaw owns the bash environment
211
- // boundary, so disable Pi metadata rather than bypassing the spawn hook.
216
+ // TypeClaw owns the bash environment boundary, so disable Pi session
217
+ // metadata rather than bypassing the spawn hook. Bracket the real
218
+ // process at the operation boundary: only there can memory.events be
219
+ // read before spawn and after exit (Pi 0.99 reports a signal-killed
220
+ // shell as 128+signal, so a SIGKILLed shell surfaces as 137 too).
212
221
  exposeSessionEnvironment: false,
213
222
  spawnHook: bashSpawnHookWithOverlay,
223
+ operations: {
224
+ async exec(command, dir, options) {
225
+ const before = readOomEvents()
226
+ const result = await operations.exec(command, dir, options)
227
+ const note =
228
+ result.exitCode === null
229
+ ? null
230
+ : toolOomNote(before, result.exitCode, 'bash', { log: (line) => console.warn(line) })
231
+ if (note !== null) {
232
+ const context = bashEnvStore.getStore()
233
+ if (context !== undefined) context.oomNote = note
234
+ }
235
+ return result
236
+ },
237
+ },
214
238
  })
239
+ }
215
240
  case 'edit':
216
241
  return piCreateEditToolDefinition(cwd)
217
242
  case 'write':
@@ -249,11 +274,17 @@ function isTypeclawToolName(name: string): name is TypeclawToolName {
249
274
  return name in TYPECLAW_TOOL_DEFINITION_MAP
250
275
  }
251
276
 
252
- export function resolveBuiltinToolRefs(refs: BuiltinToolRef[], cwd: string): ToolDefinition<any, any, any>[] {
277
+ export function resolveBuiltinToolRefs(
278
+ refs: BuiltinToolRef[],
279
+ cwd: string,
280
+ contextTools: ReadonlyMap<string, ToolDefinition<any, any, any>> = new Map(),
281
+ ): ToolDefinition<any, any, any>[] {
253
282
  return refs.map((ref) => {
254
283
  const name = ref.__builtinTool
255
284
  if (isPiBuiltinToolName(name)) return createPiBuiltinToolDefinition(name, cwd)
256
285
  if (isTypeclawToolName(name)) return TYPECLAW_TOOL_DEFINITION_MAP[name]
286
+ const contextual = contextTools.get(name)
287
+ if (contextual) return contextual
257
288
  throw new Error(`unknown built-in tool ref: ${name}`)
258
289
  })
259
290
  }
@@ -639,6 +670,7 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
639
670
  cleanupError = undefined
640
671
  sandboxedRealProcSucceeded = false
641
672
  const attemptArgs = { ...originalArgs }
673
+ let spawnEnvContext: BashSpawnEnvContext | undefined
642
674
  try {
643
675
  if (tool.name === 'bash') {
644
676
  if (opts.permissions === undefined) {
@@ -678,7 +710,7 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
678
710
  signal,
679
711
  })
680
712
  await preparedSandboxRuntime?.verify()
681
- const spawnEnvContext: BashSpawnEnvContext | undefined =
713
+ spawnEnvContext =
682
714
  bashEnvOverlay !== undefined ||
683
715
  bashEnvWithhold !== undefined ||
684
716
  preparedSandboxRuntime?.spawnEnv !== undefined
@@ -689,17 +721,28 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
689
721
  ? { sandboxSpawnEnv: preparedSandboxRuntime.spawnEnv }
690
722
  : {}),
691
723
  }
692
- : undefined
693
- rawResult = await bashEnvStore.run(spawnEnvContext, () =>
724
+ : tool.name === 'bash'
725
+ ? {}
726
+ : undefined
727
+ const executed = await bashEnvStore.run(spawnEnvContext, () =>
694
728
  tool.execute(toolCallId, attemptArgs as Static<TParams>, signal, onUpdate, ctx),
695
729
  )
730
+ // Pi 0.99 bash returns a nonzero exit as an `isError` result whose text
731
+ // is the message 0.87 threw (tools/bash.js). This wrapper returns only
732
+ // content/details, so rethrow to keep the failure on the error path
733
+ // (remediation, incident repair, sandbox note, model-facing isError).
734
+ if (executed.isError === true) {
735
+ throw new Error(executed.content.map((part) => (part.type === 'text' ? part.text : '')).join('\n'))
736
+ }
737
+ rawResult = executed
696
738
  const originalCommand = originalArgs.command
697
739
  sandboxedRealProcSucceeded =
698
740
  preparedSandboxRuntime !== undefined &&
699
741
  typeof originalCommand === 'string' &&
700
742
  (opts.realProcDependencyCheck ?? commandNeedsRealProc)(originalCommand)
701
743
  } catch (error) {
702
- executionError = error
744
+ executionError =
745
+ spawnEnvContext?.oomNote === undefined ? error : appendErrorText(error, spawnEnvContext.oomNote)
703
746
  } finally {
704
747
  const cleanup = [pinnedFiles?.cleanup(), preparedSandboxRuntime?.cleanup()].filter(
705
748
  (task): task is Promise<void> => task !== undefined,
@@ -778,7 +821,16 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
778
821
  renderSandboxPolicyNote(preparedSandboxRuntime.withheld, opts.agentDir),
779
822
  )
780
823
  }
781
- await runToolAfterSafely(opts, tool.name, toolCallId, toErrorResult(finalError))
824
+ const errorResult = toErrorResult(finalError)
825
+ await runToolAfterSafely(opts, tool.name, toolCallId, errorResult)
826
+ const annotatedMessage = errorResult.content
827
+ .filter((part) => part.type === 'text')
828
+ .map((part) => part.text)
829
+ .join('\n')
830
+ if (annotatedMessage !== (finalError instanceof Error ? finalError.message : String(finalError))) {
831
+ if (finalError instanceof Error) finalError.message = annotatedMessage
832
+ else finalError = new Error(annotatedMessage)
833
+ }
782
834
  throw finalError
783
835
  }
784
836
  if (pinnedFiles === undefined) throw new Error('tool file boundary was not initialized')
@@ -954,6 +1006,7 @@ async function applyBashSandbox(
954
1006
  env: sandboxEnvOverlay,
955
1007
  })
956
1008
  await verifyHiddenMaskTargets(maskTargets)
1009
+ const devSourceMount = await resolveDevSourceMount(agentDir)
957
1010
  const { commandString, spawnEnv } = boundary.buildCommand(command, {
958
1011
  mounts: [
959
1012
  { type: 'ro-bind', source: agentDir, dest: agentDir },
@@ -962,6 +1015,7 @@ async function applyBashSandbox(
962
1015
  // the lifetime of this command. Last-op-wins makes this narrow re-bind
963
1016
  // read-only without adding any broader filesystem exposure.
964
1017
  { type: 'ro-bind', source: dependencyBins.wrapperDir, dest: DEPENDENCY_BIN_SANDBOX_DIR },
1018
+ ...(devSourceMount === undefined ? [] : [devSourceMount]),
965
1019
  ...(privilegedRuntime?.mounts ?? []),
966
1020
  ...(preparation === undefined ? [] : [preparation.mount]),
967
1021
  ],
@@ -0,0 +1,42 @@
1
+ import type { SessionOrigin } from './session-origin'
2
+
3
+ // Mirrors pi-ai's OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH, which pi applies before
4
+ // `onPayload` runs, so a replaced key must be bounded here too. Truncation can
5
+ // only merge two long-named origins into one cache bucket, which is harmless.
6
+ const PROMPT_CACHE_KEY_MAX_LENGTH = 64
7
+
8
+ // pi defaults OpenAI's `prompt_cache_key` to the session id, and OpenAI routes
9
+ // requests to cache machines by that key. Every new subagent/cron/channel
10
+ // session therefore landed on a cold machine and re-paid its whole ~10K-token
11
+ // system+tools prefix even though sibling sessions of the same kind had just
12
+ // sent the identical prefix. Keying by origin kind (and subagent/component
13
+ // name, whose prompts differ) lets those sessions share the warm prefix. Only
14
+ // the body key changes: pi still uses the session id for the Codex websocket
15
+ // session cache and request headers.
16
+ export function promptCacheKeyForOrigin(origin: SessionOrigin | undefined): string | undefined {
17
+ const key = unboundedPromptCacheKey(origin)
18
+ return key === undefined ? undefined : Array.from(key).slice(0, PROMPT_CACHE_KEY_MAX_LENGTH).join('')
19
+ }
20
+
21
+ function unboundedPromptCacheKey(origin: SessionOrigin | undefined): string | undefined {
22
+ if (origin === undefined) return undefined
23
+ switch (origin.kind) {
24
+ case 'subagent':
25
+ return `typeclaw:subagent:${origin.subagent}`
26
+ case 'system':
27
+ return `typeclaw:system:${origin.component}`
28
+ case 'tui':
29
+ case 'cron':
30
+ case 'channel':
31
+ return `typeclaw:${origin.kind}`
32
+ }
33
+ }
34
+
35
+ // Rewrites only payloads that already carry a string `prompt_cache_key`, so
36
+ // providers without the field and `cacheRetention: 'none'` (which omits it)
37
+ // are left untouched.
38
+ export function withPromptCacheKey(payload: unknown, key: string): unknown {
39
+ if (typeof payload !== 'object' || payload === null) return payload
40
+ if (typeof (payload as { prompt_cache_key?: unknown }).prompt_cache_key !== 'string') return payload
41
+ return { ...payload, prompt_cache_key: key }
42
+ }
@@ -1,3 +1,5 @@
1
+ import { isContextOverflow, type AssistantMessage } from '@earendil-works/pi-ai'
2
+
1
3
  import type { AgentSession } from './index'
2
4
 
3
5
  // pi-coding-agent encodes upstream LLM failures (billing, rate limit, network,
@@ -24,14 +26,138 @@ export type DetectedProviderError = {
24
26
  safeMessage: string
25
27
  }
26
28
 
27
- const GENERIC_SAFE_NOTICE = 'The upstream LLM provider failed. Operators can check `typeclaw logs` for details.'
29
+ // Origin-neutral on purpose: an unclassified failure may come from the
30
+ // provider, the network, or TypeClaw itself, and the raw text alone can't say
31
+ // which. Naming the provider here blamed it for local bugs.
32
+ const GENERIC_SAFE_NOTICE = 'The assistant turn failed. Operators can check `typeclaw logs` for details.'
33
+
34
+ // pi-agent-core turns ANY throw inside its loop into the same
35
+ // `stopReason: 'error'` assistant message a provider failure produces, keeping
36
+ // only `errorMessage` (agent.js handleRunFailure) — the error's name, cause and
37
+ // throw site are dropped. So origin must be stamped into the message at the
38
+ // throw site: `wrapTransformContextWithLocalFailureMarker` appends this marker
39
+ // when the context-preparation step that runs before the next provider request
40
+ // throws. It covers only that request; earlier requests in the same run may
41
+ // have reached the provider. Anchored at the end so provider text echoed
42
+ // mid-message can't impersonate it. System token — English by design, like
43
+ // OBSERVER_TIMEOUT.
44
+ const LOCAL_FAILURE_NAME = /^[A-Za-z][A-Za-z0-9_]{0,63}$/
45
+ const LOCAL_PRE_REQUEST_FAILURE = /\(typeclaw local failure before provider request: [A-Za-z][A-Za-z0-9_]{0,63}\)$/
46
+
47
+ type TransformContext = NonNullable<AgentSession['agent']['transformContext']>
48
+
49
+ function readOr<T>(read: () => T, fallback: T): T {
50
+ try {
51
+ return read()
52
+ } catch {
53
+ return fallback
54
+ }
55
+ }
56
+
57
+ export type LocalFailureMarkerOptions = {
58
+ // Provider of the model pi stamps on the failure message. Pi's overflow
59
+ // check has a provider-specific branch, so the same text can trip it for one
60
+ // provider and not another.
61
+ getProvider?: () => string | undefined
62
+ // Receives the raw text when it is withheld from the transcript (see
63
+ // markLocalPreRequestFailure). Defaults to console.error.
64
+ logWithheld?: (line: string) => void
65
+ }
66
+
67
+ const WITHHELD_LOCAL_TEXT =
68
+ 'local error text withheld from the transcript; it resembled provider context-overflow wording and is in typeclaw logs'
69
+
70
+ const NO_USAGE: AssistantMessage['usage'] = {
71
+ input: 0,
72
+ output: 0,
73
+ cacheRead: 0,
74
+ cacheWrite: 0,
75
+ totalTokens: 0,
76
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
77
+ }
78
+
79
+ // Pi's auto-compaction takes any `stopReason:'error'` message its public
80
+ // `isContextOverflow` accepts as a provider context overflow, then compacts and
81
+ // retries the turn (AgentSession._checkCompaction `explicitOverflow`). Called
82
+ // without a context window, this is that exact check, so pattern updates in Pi
83
+ // apply here too.
84
+ function wouldTripPiOverflow(errorMessage: string, provider: string | undefined): boolean {
85
+ return isContextOverflow({
86
+ role: 'assistant',
87
+ content: [],
88
+ api: '',
89
+ provider: provider ?? '',
90
+ model: '',
91
+ usage: NO_USAGE,
92
+ stopReason: 'error',
93
+ errorMessage,
94
+ timestamp: 0,
95
+ })
96
+ }
97
+
98
+ // Only an identifier-shaped `Error.name` is embedded, so a hostile or odd name
99
+ // can't inject parentheses/newlines into the marker. The raw text normally
100
+ // stays on the message for logs and operator surfaces; channels only ever see
101
+ // the fixed LOCAL sentence, never this text. One exception: when the marked
102
+ // text (raw text or name) would trip Pi's overflow check, pi would compact the
103
+ // session and replay a turn that never reached the provider. Then the
104
+ // transcript gets a fixed placeholder and the raw text moves to one
105
+ // `logWithheld` line instead. Reading a throwing getter/`toString`, or a
106
+ // throwing log sink, must not replace the original failure with a new one.
107
+ function markLocalPreRequestFailure(err: unknown, options: LocalFailureMarkerOptions): Error {
108
+ const provider = readOr(() => options.getProvider?.(), undefined)
109
+ const isError = readOr(() => err instanceof Error, false)
110
+ const text = readOr(() => String(isError ? (err as Error).message : err), 'unprintable thrown value')
111
+ if (isError && LOCAL_PRE_REQUEST_FAILURE.test(text) && !wouldTripPiOverflow(text, provider)) return err as Error
112
+ const rawName = readOr(() => (isError ? (err as Error).name : undefined), undefined)
113
+ const name = typeof rawName === 'string' && LOCAL_FAILURE_NAME.test(rawName) ? rawName : 'Error'
114
+ const marked = `${text} (typeclaw local failure before provider request: ${name})`
115
+ if (!wouldTripPiOverflow(marked, provider)) return new Error(marked, { cause: err })
116
+ try {
117
+ ;(options.logWithheld ?? console.error)(`local failure text withheld from the transcript (${name}): ${text}`)
118
+ } catch {
119
+ // The failure being reported matters more than its log line.
120
+ }
121
+ const withheld = `${WITHHELD_LOCAL_TEXT} (typeclaw local failure before provider request: ${name})`
122
+ if (!wouldTripPiOverflow(withheld, provider)) return new Error(withheld, { cause: err })
123
+ // The name itself trips the check (e.g. `request_too_large`).
124
+ return new Error(`${WITHHELD_LOCAL_TEXT} (typeclaw local failure before provider request: Error)`, { cause: err })
125
+ }
126
+
127
+ // Wraps an agent's `transformContext` (the step pi runs right before
128
+ // `convertToLlm`/`getApiKey`/`streamFunction` on every request) so a throw from
129
+ // it — sync or async — is re-thrown with the local-origin marker. An abort is
130
+ // re-thrown untouched: it's a cancellation, and pi reports it as `aborted`.
131
+ export function wrapTransformContextWithLocalFailureMarker(
132
+ inner: TransformContext | undefined,
133
+ options: LocalFailureMarkerOptions = {},
134
+ ): TransformContext {
135
+ return async (messages, signal) => {
136
+ if (!inner) return messages
137
+ try {
138
+ return await inner(messages, signal)
139
+ } catch (err) {
140
+ if (signal?.aborted) throw err
141
+ throw markLocalPreRequestFailure(err, options)
142
+ }
143
+ }
144
+ }
28
145
 
29
146
  // The fetch observer (`llm-fetch-observer`) aborts a stalled provider stream
30
147
  // with a message ending in this marker (TTFB / idle / overall deadline). Such a
31
148
  // stall is a hard throw, not a `stopReason: 'error'` soft error, so it never
32
149
  // reaches `detectProviderError`; the marker lets the hard-throw path recognize
33
150
  // and surface it. The literal is the system's own token — English by design.
34
- const OBSERVER_TIMEOUT = /\(typeclaw observer timeout\)/i
151
+ //
152
+ // The OpenAI and Anthropic SDKs don't let the marker through for the TTFB case:
153
+ // any fetch rejection that mentions "timed out" is replaced by a bare
154
+ // `APIConnectionTimeoutError('Request timed out.')` with no cause. That error is
155
+ // only raised when fetch itself rejects, i.e. before response headers, so it is
156
+ // the same pre-headers stall and must classify like the marked one. Matched as
157
+ // the whole message so the sentence echoed inside other text can't claim it.
158
+ const MARKED_OBSERVER_TIMEOUT = /\(typeclaw observer timeout\)/i
159
+ const SDK_CONNECTION_TIMEOUT = /^Request timed out\.$/
160
+ const OBSERVER_TIMEOUT = new RegExp(`${MARKED_OBSERVER_TIMEOUT.source}|${SDK_CONNECTION_TIMEOUT.source}`, 'i')
35
161
  const OBSERVER_TTFB_TIMEOUT = /timed out before response headers/i
36
162
 
37
163
  // Transport-layer failure: the request died at the connection/session before a
@@ -91,8 +217,14 @@ const INVALID_REQUEST = /\binvalid_request_error\b/i
91
217
  // text, so adding a new class is opt-in and never widens what we expose.
92
218
  const SAFE_CLASSES: ReadonlyArray<{ match: RegExp; safe: string }> = [
93
219
  {
94
- // Matched first because a 401 body can also mention "account", which would
95
- // otherwise fall into the billing class below.
220
+ // First, so provider-looking text inside a local error (a `401` or `429`
221
+ // echoed by a tool, a `quota` word) can't pull it into a provider class.
222
+ match: LOCAL_PRE_REQUEST_FAILURE,
223
+ safe: 'TypeClaw could not prepare the conversation for the LLM request. Operators can check `typeclaw logs` for details.',
224
+ },
225
+ {
226
+ // Matched before billing because a 401 body can also mention "account",
227
+ // which would otherwise fall into the billing class below.
96
228
  match: AUTH_FAULT,
97
229
  safe: 'The upstream LLM provider rejected the request as unauthorized. Operators should check the provider API key configuration and `typeclaw logs`.',
98
230
  },
@@ -141,6 +273,12 @@ const SAFE_CLASSES: ReadonlyArray<{ match: RegExp; safe: string }> = [
141
273
  },
142
274
  ]
143
275
 
276
+ // An unclassified failure names no cause the chat user can act on, so channels
277
+ // treat it as retry-and-see rather than posting the generic notice.
278
+ export function isUnclassifiedProviderNotice(safeMessage: string): boolean {
279
+ return safeMessage === GENERIC_SAFE_NOTICE
280
+ }
281
+
144
282
  function toSafeMessage(raw: string): string {
145
283
  for (const { match, safe } of SAFE_CLASSES) {
146
284
  if (match.test(raw)) return safe
@@ -162,8 +300,11 @@ const THROTTLE_OR_OVERLOAD =
162
300
  // status with a quota/billing/auth reason (e.g. `429 insufficient quota`) — the
163
301
  // status code alone must not force a pointless failover. The auth arm reuses the
164
302
  // shared `AUTH_FAULT` source so it stays in lockstep with the safe-message class.
303
+ // A local pre-request failure is in the same bucket: preparing the context is
304
+ // model-independent, so every ref (and a same-ref replay) would fail the same
305
+ // way — and it must never count as provider throttling.
165
306
  const NON_FAILOVER_FAULT = new RegExp(
166
- `${INVALID_MODEL.source}|${INVALID_REQUEST.source}|\\bcyber_policy\\b|insufficient.*(?:quota|credit|fund|balance)|\\bquota\\b|billing|payment|account is not active|${AUTH_FAULT.source}`,
307
+ `${LOCAL_PRE_REQUEST_FAILURE.source}|${INVALID_MODEL.source}|${INVALID_REQUEST.source}|\\bcyber_policy\\b|insufficient.*(?:quota|credit|fund|balance)|\\bquota\\b|billing|payment|account is not active|${AUTH_FAULT.source}`,
167
308
  'i',
168
309
  )
169
310
 
@@ -177,8 +318,12 @@ export function isThrottleOrOverload(raw: string): boolean {
177
318
  return THROTTLE_OR_OVERLOAD.test(raw)
178
319
  }
179
320
 
321
+ // A local pre-request failure can carry observer text it merely echoes; the
322
+ // request it was preparing was never sent, so it must not count toward the
323
+ // no-progress envelope or trip the codex provider circuit.
180
324
  export function isObserverTtfbTimeout(raw: string): boolean {
181
- return OBSERVER_TIMEOUT.test(raw) && OBSERVER_TTFB_TIMEOUT.test(raw)
325
+ if (LOCAL_PRE_REQUEST_FAILURE.test(raw)) return false
326
+ return (MARKED_OBSERVER_TIMEOUT.test(raw) && OBSERVER_TTFB_TIMEOUT.test(raw)) || SDK_CONNECTION_TIMEOUT.test(raw)
182
327
  }
183
328
 
184
329
  // Failover predicate for turn-drivers' `shouldFailover`: rotate to the next model
@@ -199,10 +344,16 @@ export function isFailoverWorthy(raw: string): boolean {
199
344
  // means the model is out of capacity NOW, so the right move is to fail OVER to a
200
345
  // different ref, not hammer the same one — whereas a socket hang-up or a 500 is a
201
346
  // one-off blip a replay against the SAME ref often fixes. `\b` anchors the 5xx
202
- // codes so they don't match digit runs in prose. Provider protocol tokens —
203
- // English by design (the system-token exception to the multi-language rule).
347
+ // codes so they don't match digit runs in prose. Streaming APIs often report a
348
+ // provider-side 500 inside the event stream with no status code at all, only
349
+ // the provider's own name for it: OpenAI/Codex `server_error` ("An error
350
+ // occurred while processing your request"), Anthropic `api_error`, Gemini
351
+ // `INTERNAL` ("An internal error has occurred"), and the generic "internal
352
+ // server error" / "bad gateway" / "gateway timeout" wording proxies use.
353
+ // Provider protocol tokens — English by design (the system-token exception to
354
+ // the multi-language rule).
204
355
  const NETWORK_OR_5XX =
205
- /econnreset|econnrefused|etimedout|enetunreach|socket hang up|network.?error|connection.?(?:error|refused|reset|lost)|fetch failed|other side closed|reset before headers|http2 request did not get a response|\b(?:500|502|504)\b/i
356
+ /econnreset|econnrefused|etimedout|enetunreach|socket hang up|network.?error|connection.?(?:error|refused|reset|lost)|fetch failed|other side closed|reset before headers|http2 request did not get a response|\b(?:server_error|api_error)\b|"INTERNAL"|an error occurred while processing your request|an internal error has occurred|internal server error|bad gateway|gateway time-?out|\b(?:500|502|504)\b/i
206
357
 
207
358
  // Retry predicate for typeclaw-owned SAME-REF retry: replay the SAME model ref
208
359
  // before advancing the chain. Deliberately NARROWER than `isFailoverWorthy` —
@@ -225,6 +376,22 @@ export function isRetryableSameRef(raw: string): boolean {
225
376
  return TRANSPORT_FAILURE.test(raw) || OBSERVER_TIMEOUT.test(raw) || NETWORK_OR_5XX.test(raw)
226
377
  }
227
378
 
379
+ // Failures a user can only answer with "try again": a dropped transport, an
380
+ // observer stall, a network/5xx blip, or a provider overload. Channels mark
381
+ // these with a reaction instead of posting a notice. Rate/usage limits are
382
+ // excluded even though they say "try again shortly": they can last hours, and
383
+ // a bare reaction on every message would hide why the agent stopped
384
+ // answering. Account-wide faults stay out via `isRetryableSameRef` and
385
+ // NON_FAILOVER_FAULT.
386
+ const OVERLOAD = /overloaded|service.?unavailable|\b503\b/i
387
+ const RATE_OR_USAGE_LIMIT = /usage.?limit|rate.?limit|too many requests|\b429\b/i
388
+
389
+ export function isTransientProviderFailure(raw: string): boolean {
390
+ if (RATE_OR_USAGE_LIMIT.test(raw)) return false
391
+ if (isRetryableSameRef(raw)) return true
392
+ return !NON_FAILOVER_FAULT.test(raw) && !CONTEXT_OVERFLOW.test(raw) && OVERLOAD.test(raw)
393
+ }
394
+
228
395
  export function detectProviderError(message: unknown): DetectedProviderError | null {
229
396
  if (typeof message !== 'object' || message === null) return null
230
397
  const m = message as { role?: unknown; stopReason?: unknown; errorMessage?: unknown }
@@ -243,7 +410,9 @@ export function detectProviderError(message: unknown): DetectedProviderError | n
243
410
  // NOT an operator-actionable provider failure (internal bugs, network blips),
244
411
  // so the caller stays silent-with-log rather than spamming channels. The three
245
412
  // recognized classes are: failover-worthy throttle/overload, account-wide faults
246
- // (billing/quota/auth) that must surface, and observer stall timeouts.
413
+ // (billing/quota/auth) that must surface, and observer stall timeouts. A throw
414
+ // carrying the local pre-request marker surfaces too (via NON_FAILOVER_FAULT)
415
+ // with the LOCAL notice; an unmarked internal error still returns `null`.
247
416
  export function detectHardProviderError(err: unknown): DetectedProviderError | null {
248
417
  const message = err instanceof Error ? err.message : String(err)
249
418
  const isProviderFailure =
@@ -10,15 +10,10 @@ export { restartHandoffPath } from './paths'
10
10
 
11
11
  export const RESTART_HANDOFF_TTL_MS = 60_000
12
12
 
13
- // Process-local serialization of the two same-process handoff producers that
14
- // race during a restart: the in-session `/restart` tool (which writes the
15
- // originating handoff post-ACK) and the SIGTERM writer (which peek-augments it).
16
- // hostd fires `docker stop` → SIGTERM before its ACK reaches the container, so
17
- // without this the SIGTERM read-modify-write can interleave with `/restart`'s
18
- // write and drop the originating session's origin/author or its interrupted
19
- // children. This is NOT a cross-process lock — both producers live in this one
20
- // container process; the event loop yields at every await, so a promise-chain
21
- // mutex is all that's needed. Keyed by handoff path so distinct agent dirs
13
+ // Serialize ordinary restart-handoff reads and writes within one process.
14
+ // This is not a cross-process lock. Background launch inventory transfers
15
+ // non-TTL interrupted work to the runtime outbox; it neither augments this
16
+ // greeting nor relies on a SIGTERM sampler. Key by path so distinct agent dirs
22
17
  // (tests) never contend.
23
18
  const handoffLocks = new Map<string, Promise<void>>()
24
19
 
@@ -76,11 +71,9 @@ export type RestartHandoff = {
76
71
  // whatever bare-channel rule matches on every "I'm back" turn. Optional and
77
72
  // additive: pre-field v2 handoffs and tui handoffs omit it.
78
73
  triggeringAuthorId?: string
79
- // Names of background subagents still running when the restart fired, so the
80
- // resumed session can tell the thread its promised result was lost. Absent
81
- // (never an empty array) when nothing was in flight. Rides the handoff's 60s
82
- // TTL, so a stop→idle-for-hours→start drops it instead of replaying a stale
83
- // notice into a moved-on conversation.
74
+ // Lost-work names accepted from older handoffs. Channel boot excludes these
75
+ // from model greetings: covered launch recovery belongs to the outbox.
76
+ // Ordinary handoffs retain the greeting's 60s TTL.
84
77
  interruptedSubagents?: string[]
85
78
  }
86
79