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
@@ -45,14 +45,12 @@ export type LlmFetchObserverOptions = {
45
45
  // Override the default pre-headers (TTFB) deadline applied to the outer
46
46
  // fetch(). When a provider silently holds a request without sending response
47
47
  // headers, this is the timer that releases the request so `pi-coding-agent`'s
48
- // `_isRetryableError` can retry. Default: 15_000 ms.
48
+ // `_isRetryableError` can retry. Default: 30_000 ms.
49
49
  //
50
- // Healthy turns return response headers within ~1s (observed Codex production
51
- // p50: ~860ms). Pathological-but-healthy upper bounds: TLS handshake on a cold
52
- // connection (~2s), prompt-prefill on a cache miss with large input (~3s),
53
- // edge routing slowness (~2s) — sum ~7s. 15s is ~2x that, so anything past it
54
- // is almost certainly the silent-hang failure mode rather than a real request
55
- // making progress. False-positive cost is one retry (~5s extra); false-negative
50
+ // Most providers return response headers within ~1s, but slow-but-healthy
51
+ // OpenAI-compatible providers (e.g. z.ai GLM) routinely take 12-16s to send
52
+ // headers on large prompts, so a 15s deadline aborted real requests. 30s keeps
53
+ // a margin over that tail while still bounding a silent hang. False-positive cost is one retry (~5s extra); false-negative
56
54
  // cost is the full Bun socket deadline (~268s). Aggressive wins.
57
55
  ttfbMs?: number
58
56
  // Override the sliding inter-chunk idle deadline applied to the SSE body
@@ -101,11 +99,11 @@ const ENV_OVERALL_MS = 'TYPECLAW_LLM_OVERALL_MS'
101
99
  const ENV_CODEX_TTFB_MS = 'TYPECLAW_CODEX_TTFB_MS'
102
100
  const ENV_CODEX_IDLE_MS = 'TYPECLAW_CODEX_IDLE_MS'
103
101
  const ENV_CODEX_OVERALL_MS = 'TYPECLAW_CODEX_OVERALL_MS'
104
- const DEFAULT_TTFB_MS = 15_000
102
+ const DEFAULT_TTFB_MS = 30_000
105
103
  const DEFAULT_IDLE_MS = 120_000
106
104
  const DEFAULT_OVERALL_MS = 300_000
107
105
  // Codex is healthy-FAST but silently hangs: observed header latency p50~1s /
108
- // p99~8s / max~10.8s, yet hung requests wait out the generic 15s floor. Pinning
106
+ // p99~8s / max~10.8s, yet hung requests wait out the generic 30s floor. Pinning
109
107
  // 13s detects hangs ~2s sooner with ~2.2s margin over the healthy max. Pinned,
110
108
  // not adaptive: codex's p95 (~5.6s) never crosses the floor so widening is a
111
109
  // no-op, and a longer deadline only makes each silent hang costlier to recover.
@@ -116,8 +114,7 @@ const LOG_PREFIX = '[llm-fetch]'
116
114
 
117
115
  // Adaptive TTFB: give a provider that is OBSERVED to be slow-but-healthy more
118
116
  // pre-headers room, without blunting silent-hang detection for fast providers.
119
- // A fixed 15s guillotine kills legitimately-slow providers (e.g. GLM cold-start
120
- // TTFB ~16.5s while its p50 is ~1s); a uniform higher default would let a truly
117
+ // A fixed floor kills legitimately-slow providers whose tail exceeds it; a uniform higher default would let a truly
121
118
  // hung FAST provider stall for the same widened window. So widening is scoped to
122
119
  // the specific origin whose recent successful header latency is actually high.
123
120
  //
@@ -125,15 +122,15 @@ const LOG_PREFIX = '[llm-fetch]'
125
122
  // are bimodal, mostly-1s with occasional 10–16s, so a mean-tracker sits low and
126
123
  // never widens for the spike). Nearest-rank p95 over the last ADAPTIVE_WINDOW_MS
127
124
  // of samples reacts to the current upper tail and forgets stale slowness.
128
- const ADAPTIVE_TTFB_FLOOR_MS = 15_000
129
- const ADAPTIVE_TTFB_CEIL_MS = 30_000
125
+ const ADAPTIVE_TTFB_FLOOR_MS = 30_000
126
+ const ADAPTIVE_TTFB_CEIL_MS = 60_000
130
127
  const ADAPTIVE_TTFB_MULTIPLIER = 2
131
128
  const ADAPTIVE_MIN_SAMPLES = 8
132
129
  const ADAPTIVE_MAX_SAMPLES = 32
133
130
  const ADAPTIVE_WINDOW_MS = 5 * 60_000
134
131
  // After a timeout at the CEIL budget, the origin is treated as slow-then-hung:
135
132
  // suppress all widening (learned + probe) and fail closed to the floor for this
136
- // long, so five rapid retries can't each inherit the 30s budget. A sub-floor
133
+ // long, so five rapid retries can't each inherit the ceil budget. A sub-floor
137
134
  // success clears the suppression early.
138
135
  const ADAPTIVE_COOLDOWN_MS = 5 * 60_000
139
136
 
@@ -256,7 +253,7 @@ export function defaultLlmFetchEndpoints(env: NodeJS.ProcessEnv = process.env):
256
253
  // GETs to the same host (auth probes, etc.) are deliberately ignored.
257
254
  match: (url, method) =>
258
255
  method === 'POST' && url.hostname === 'chatgpt.com' && url.pathname.includes('/codex/responses'),
259
- // TTFB is pinned to the codex-specific default (not the generic 15s) so a
256
+ // TTFB is pinned to the codex-specific default (not the generic 30s) so a
260
257
  // silent hang is caught fast and adaptation is bypassed for this endpoint;
261
258
  // an operator-set TYPECLAW_CODEX_TTFB_MS still wins. Idle/overall keep the
262
259
  // fall-through shape (unset → generic TYPECLAW_LLM_* / built-in default) so
@@ -1,5 +1,7 @@
1
1
  import { readdirSync, readFileSync, statfsSync } from 'node:fs'
2
2
 
3
+ import { readOomEvents, unclaimedOomEvents, type OomEventsReader } from '@/container/oom-events'
4
+
3
5
  const BYTES_PER_MB = 1024 * 1024
4
6
 
5
7
  export type ResourceSample = {
@@ -140,6 +142,7 @@ export type ResourceSamplerOptions = {
140
142
  collect?: () => ResourceSample
141
143
  emit?: (line: string) => void
142
144
  now?: () => number
145
+ readOomEvents?: OomEventsReader
143
146
  }
144
147
 
145
148
  // Returns a stop function rather than running forever so the caller owns the
@@ -150,10 +153,26 @@ export function startResourceSampler(options: ResourceSamplerOptions = {}): () =
150
153
  const collect = options.collect ?? (() => collectResourceSample())
151
154
  const emit = options.emit ?? ((line: string) => console.info(line))
152
155
  const now = options.now ?? (() => Date.now())
156
+ const readEvents = options.readOomEvents ?? readOomEvents
157
+ let previousOomEvents = readEvents()
153
158
 
154
159
  let watermark: SampleWatermark | null = null
155
160
  const tick = (): void => {
156
161
  try {
162
+ const currentOomEvents = readEvents()
163
+ if (currentOomEvents !== null) {
164
+ const events = previousOomEvents === null ? null : unclaimedOomEvents(previousOomEvents, currentOomEvents)
165
+ previousOomEvents = currentOomEvents
166
+ if (events !== null) {
167
+ const pressure = events.reachedLimit
168
+ ? 'container reached its memory limit'
169
+ : 'no container memory-limit event recorded (possible Docker VM/ancestor pressure)'
170
+ emit(
171
+ `[resource] OOM kill observed (oom_kill ${events.from}→${events.to}); runtime survived — a subprocess was killed; ${pressure}` +
172
+ (events.claimed.length === 0 ? '' : `; claimed by ${events.claimed.join(', ')}`),
173
+ )
174
+ }
175
+ }
157
176
  const sample = collect()
158
177
  const at = now()
159
178
  if (!shouldEmitSample(watermark, sample, at)) return
@@ -278,6 +278,10 @@ function appendMount(argv: string[], mount: SandboxMount): void {
278
278
  case 'bind':
279
279
  argv.push('--bind', mount.source, mount.dest)
280
280
  return
281
+ case 'ro-bind-fd':
282
+ case 'bind-fd':
283
+ argv.push(`--${mount.type}`, String(mount.fd), mount.dest)
284
+ return
281
285
  case 'tmpfs':
282
286
  argv.push('--tmpfs', mount.dest)
283
287
  return
@@ -3,6 +3,9 @@ import {
3
3
  LEGACY_AGENT_MESSENGER_CONFIG_RELATIVE_DIR,
4
4
  } from '@/agent-messenger/config-dir'
5
5
 
6
+ // The managed Chrome profile: cookies and logins persist across container restarts.
7
+ export const BROWSER_PROFILE_RELATIVE_DIR = '.typeclaw/browser-profile'
8
+
6
9
  // Runtime-owned credential stores: TypeClaw writes and reads these itself, and
7
10
  // no shipped skill ever invokes a CLI that reads them. Masked at EVERY role.
8
11
  export const RUNTIME_OWNED_SECRET_DIRS = [
@@ -12,6 +15,7 @@ export const RUNTIME_OWNED_SECRET_DIRS = [
12
15
  LEGACY_AGENT_MESSENGER_CONFIG_RELATIVE_DIR,
13
16
  '.typeclaw/home',
14
17
  '.typeclaw/logs',
18
+ BROWSER_PROFILE_RELATIVE_DIR,
15
19
  ] as const
16
20
 
17
21
  // SECURITY / classification: operator-provisioned CLI credential stores. TypeClaw
@@ -0,0 +1,214 @@
1
+ import { lstat, realpath } from 'node:fs/promises'
2
+ import { join, posix, resolve } from 'node:path'
3
+
4
+ import { createAndOpenAnchoredDirectory } from '@/agent/tool-file-safety'
5
+ import { config } from '@/config/config'
6
+
7
+ import { canMountRealProc, ensureBwrapAvailable, getProcBindSafetyVerdict } from './availability'
8
+ import { buildSandboxedCommand, type SandboxedCommand } from './build'
9
+ import {
10
+ CANONICAL_AGENT_SECRET_DIRS,
11
+ CANONICAL_AGENT_SECRET_FILES,
12
+ CANONICAL_HOME_SECRET_DIRS,
13
+ CANONICAL_HOME_SECRET_FILES,
14
+ } from './canonical-secrets'
15
+ import { verifyHiddenMaskTargets } from './hidden-paths'
16
+ import { DEFAULT_SANDBOX_ENV, type SandboxMount, type SandboxPolicy, type SandboxProcStrategy } from './policy'
17
+ import { formatCommand } from './quote'
18
+ import { CANONICAL_AGENT_RUNTIME_PRIVATE_FILES } from './runtime-private'
19
+
20
+ export const CODING_SOURCE = '/typeclaw-coding-source'
21
+ export const CODING_MASK_DIRS = [
22
+ ...CANONICAL_AGENT_SECRET_DIRS,
23
+ // Repository-scoped Claude/Codex settings are executable project context,
24
+ // not the runtime HOME profiles (HOME is never mounted). Mask their auth files.
25
+ ...CANONICAL_HOME_SECRET_DIRS.filter((dir) => dir !== '.claude' && dir !== '.codex'),
26
+ '.typeclaw',
27
+ ] as const
28
+ export const CODING_MASK_FILES = [
29
+ ...CANONICAL_AGENT_SECRET_FILES,
30
+ ...CANONICAL_HOME_SECRET_FILES,
31
+ ...CANONICAL_AGENT_RUNTIME_PRIVATE_FILES,
32
+ '.claude/.credentials.json',
33
+ '.codex/auth.json',
34
+ ] as const
35
+
36
+ export function codingSourceMaskDirs(source: string, taskRoot: string): readonly string[] {
37
+ return source === resolve(taskRoot, '../../..') ? [...CODING_MASK_DIRS, 'workspace'] : CODING_MASK_DIRS
38
+ }
39
+
40
+ export type CodingSandboxOptions = {
41
+ readonly source: string
42
+ readonly taskRoot: string
43
+ readonly mode: 'code' | 'plan' | 'snapshot'
44
+ readonly cwd: string
45
+ readonly env?: Record<string, string>
46
+ readonly engine?: 'claude' | 'codex' | 'omo'
47
+ }
48
+
49
+ export async function assertCodingDirectory(path: string): Promise<void> {
50
+ const absolute = resolve(path)
51
+ if ((await realpath(absolute)) !== absolute || !(await lstat(absolute)).isDirectory()) {
52
+ throw new Error('Coding task directory is a symlink or changed identity.')
53
+ }
54
+ }
55
+
56
+ export async function codingSandboxPolicy(
57
+ options: CodingSandboxOptions,
58
+ proc: SandboxProcStrategy,
59
+ ): Promise<SandboxPolicy> {
60
+ await assertCodingDirectory(options.source)
61
+ await assertCodingDirectory(options.taskRoot)
62
+ // Keep the canonical alias checks: unmounting the write directory must not
63
+ // admit a pre-existing credential hardlink into otherwise visible Git/task data.
64
+ const dirs: string[] = []
65
+ const files: string[] = []
66
+ for (const name of new Set([...codingSourceMaskDirs(options.source, options.taskRoot), ...CODING_MASK_FILES])) {
67
+ const path = join(options.source, name)
68
+ const stat = await lstat(path).catch((error: unknown) => {
69
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined
70
+ throw error
71
+ })
72
+ if (!stat) continue
73
+ if (stat.isSymbolicLink() || (!stat.isDirectory() && (!stat.isFile() || stat.nlink !== 1))) {
74
+ throw new Error('Source has an unsafe canonical mask target.')
75
+ }
76
+ if (stat.isDirectory()) dirs.push(path)
77
+ else files.push(path)
78
+ }
79
+ await verifyHiddenMaskTargets({ dirs, files })
80
+ const sourceGit = join(options.source, '.git')
81
+ if (options.mode === 'snapshot') {
82
+ await assertCodingDirectory(sourceGit)
83
+ }
84
+ const configMasks: string[] = []
85
+ if (options.engine === 'omo') {
86
+ // Only these ancestors are visible through the task bind. Other host
87
+ // ancestors (including the real HOME) are absent in the empty sandbox root.
88
+ for (const directory of [options.taskRoot, join(options.taskRoot, 'worktree')]) {
89
+ const omo = join(directory, '.omo')
90
+ const stat = await lstat(omo).catch((error: unknown) => {
91
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined
92
+ throw error
93
+ })
94
+ if (!stat) continue
95
+ await assertCodingDirectory(omo)
96
+ for (const name of ['omo.json', 'omo.jsonc']) {
97
+ const file = join(omo, name)
98
+ const target = await lstat(file).catch((error: unknown) => {
99
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined
100
+ throw error
101
+ })
102
+ if (!target) continue
103
+ if (!target.isFile() || target.nlink !== 1) throw new Error('Unsafe OmO project configuration operand.')
104
+ configMasks.push(file)
105
+ }
106
+ }
107
+ }
108
+ return {
109
+ cwd: options.cwd,
110
+ proc,
111
+ network: 'inherit',
112
+ env: { set: options.env ?? {} },
113
+ ...(configMasks.length ? { masks: { files: configMasks } } : {}),
114
+ mounts: [
115
+ // Never bind the live source worktree: credential rotation can create
116
+ // arbitrary siblings and replace masked inodes there during an invocation.
117
+ // Only snapshot bootstrap needs source Git metadata, not its parent.
118
+ ...(options.mode === 'snapshot'
119
+ ? [{ type: 'ro-bind' as const, source: sourceGit, dest: posix.join(CODING_SOURCE, '.git') }]
120
+ : []),
121
+ { type: 'bind', source: options.taskRoot, dest: options.taskRoot },
122
+ ...(options.mode === 'plan'
123
+ ? [
124
+ { type: 'ro-bind' as const, source: join(options.taskRoot, 'git'), dest: join(options.taskRoot, 'git') },
125
+ {
126
+ type: 'ro-bind' as const,
127
+ source: join(options.taskRoot, 'worktree'),
128
+ dest: join(options.taskRoot, 'worktree'),
129
+ },
130
+ ]
131
+ : []),
132
+ ],
133
+ }
134
+ }
135
+
136
+ export async function prepareCodingCommand(
137
+ argv: readonly string[],
138
+ options: CodingSandboxOptions,
139
+ ): Promise<SandboxedCommand & { extraFiles: Array<number | 'ignore'>; cleanup(): Promise<void> }> {
140
+ await ensureBwrapAvailable()
141
+ fdBindSupport ??= supportsFdBinds()
142
+ if (!(await fdBindSupport)) {
143
+ throw new Error(
144
+ 'Coding delegation requires bwrap --bind-fd support. Rebuild the TypeClaw container image; ordinary bash is unaffected.',
145
+ )
146
+ }
147
+ const proc =
148
+ config.sandbox.realProc && (await canMountRealProc())
149
+ ? 'real-proc'
150
+ : (await getProcBindSafetyVerdict()) === 'safe'
151
+ ? 'proc-bind'
152
+ : undefined
153
+ if (!proc)
154
+ throw new Error(
155
+ 'Coding delegation requires a verified safe /proc sandbox. Fix the container user-namespace policy and retry.',
156
+ )
157
+ const policy = await codingSandboxPolicy(options, proc)
158
+ const capabilities: Record<string, string> = {}
159
+ const settings = { ...options.env }
160
+ for (const name of ['ANTHROPIC_AUTH_TOKEN', 'TYPECLAW_CODING_AGENT_CAPABILITY']) {
161
+ const value = settings[name]
162
+ if (value) {
163
+ capabilities[name] = value
164
+ delete settings[name]
165
+ }
166
+ }
167
+ // Capabilities travel in the explicit environment, never visible process argv.
168
+ policy.env = { set: settings, inherit: Object.keys(capabilities) }
169
+ const opened: Awaited<ReturnType<typeof createAndOpenAnchoredDirectory>>[] = []
170
+ // buildSandboxedCommand reserves descriptors starting at 3 for file masks.
171
+ // Keep anchored bind descriptors above them: shell mask redirects must never
172
+ // replace the task/source directory handles before bwrap consumes them.
173
+ const extraFiles: Array<number | 'ignore'> = (policy.masks?.files ?? []).map(() => 'ignore')
174
+ try {
175
+ const mounts: SandboxMount[] = []
176
+ // Native FD binds verify inode identity after mounting AND consume the FD.
177
+ // A plain bind of /proc/self/fd/N does neither: it resolves the path and
178
+ // leaves a directory handle capable of bypassing masks in the final child.
179
+ for (const mount of policy.mounts ?? []) {
180
+ if (mount.type !== 'bind' && mount.type !== 'ro-bind') {
181
+ mounts.push(mount)
182
+ continue
183
+ }
184
+ const file = await createAndOpenAnchoredDirectory(mount.source, false)
185
+ opened.push(file)
186
+ mounts.push({
187
+ type: mount.type === 'bind' ? 'bind-fd' : 'ro-bind-fd',
188
+ fd: 3 + extraFiles.length,
189
+ dest: mount.dest,
190
+ })
191
+ extraFiles.push(file.fd)
192
+ }
193
+ policy.mounts = mounts
194
+ const built = buildSandboxedCommand(`exec ${formatCommand([...argv])}`, policy)
195
+ return {
196
+ ...built,
197
+ spawnEnv: { ...built.spawnEnv, ...capabilities },
198
+ extraFiles,
199
+ cleanup: async () => {
200
+ await Promise.all(opened.map((file) => file.close()))
201
+ },
202
+ }
203
+ } catch (error) {
204
+ await Promise.all(opened.map((file) => file.close()))
205
+ throw error
206
+ }
207
+ }
208
+
209
+ let fdBindSupport: Promise<boolean> | undefined
210
+ async function supportsFdBinds(): Promise<boolean> {
211
+ const child = Bun.spawn(['bwrap', '--help'], { env: DEFAULT_SANDBOX_ENV, stdout: 'pipe', stderr: 'ignore' })
212
+ const help = await new Response(child.stdout).text()
213
+ return (await child.exited) === 0 && help.includes('--bind-fd') && help.includes('--ro-bind-fd')
214
+ }
@@ -0,0 +1,26 @@
1
+ import { realpath } from 'node:fs/promises'
2
+ import { dirname, isAbsolute, relative } from 'node:path'
3
+ import { fileURLToPath } from 'node:url'
4
+
5
+ import type { SandboxMount } from './policy'
6
+
7
+ const RUNTIME_MODULE_FILE = fileURLToPath(import.meta.url)
8
+
9
+ // Dev mode (`file:`/`link:` typeclaw dep): files under node_modules/typeclaw
10
+ // are symlinks into a checkout outside the agent folder. `typeclaw start`
11
+ // mirror-mounts that checkout read-only into the container, but bwrap only
12
+ // binds the agent folder, so bundled SKILL.md symlinks dangle inside model
13
+ // bash. Bind only the checkout's `src/` (where every bundled skill lives),
14
+ // never the checkout root, so a developer's `.env` or `.git` stays out of the
15
+ // sandbox. The path comes from the running module's own realpath, which the
16
+ // model cannot redirect by rewriting node_modules. Registry installs resolve
17
+ // inside the agent folder and get no mount.
18
+ export async function resolveDevSourceMount(
19
+ agentDir: string,
20
+ moduleFile: string = RUNTIME_MODULE_FILE,
21
+ ): Promise<Extract<SandboxMount, { type: 'ro-bind' }> | undefined> {
22
+ const srcDir = dirname(dirname(await realpath(moduleFile)))
23
+ const rel = relative(await realpath(agentDir), srcDir)
24
+ if (rel === '' || (!rel.startsWith('..') && !isAbsolute(rel))) return undefined
25
+ return { type: 'ro-bind', source: srcDir, dest: srcDir }
26
+ }
@@ -6,6 +6,7 @@ import { CORE_PERMISSIONS } from '@/permissions/builtins'
6
6
  import type { PermissionService } from '@/permissions/permissions'
7
7
 
8
8
  import {
9
+ BROWSER_PROFILE_RELATIVE_DIR,
9
10
  CANONICAL_AGENT_SECRET_DIRS,
10
11
  CANONICAL_AGENT_SECRET_FILES,
11
12
  OPERATOR_CLI_CREDENTIAL_DIRS,
@@ -121,11 +122,24 @@ async function verifyRequiredMaskTarget(target: string, kind: 'dir' | 'file'): P
121
122
  if (kind === 'dir' && isCanonicalSecretDir(target)) await rejectHardlinksUnderCanonicalDir(target)
122
123
  }
123
124
 
125
+ // The browser profile grows past the bounded scan through ordinary browsing
126
+ // (Chromium caches use about one file per entry), so scanning it per bash call
127
+ // would eventually block every command. Its only writer is the managed Chrome,
128
+ // which sees nothing but the profile and files directories, and every model tool
129
+ // masks it, so no alias can be planted while the runtime is up. Pre-existing
130
+ // aliases are refused once at browser boot instead (startManagedBrowser), which
131
+ // disables only the browser.
124
132
  function isCanonicalSecretDir(target: string): boolean {
125
- return CANONICAL_AGENT_SECRET_DIRS.some((dir) => target.endsWith(`${sep}${dir.split('/').join(sep)}`))
133
+ return CANONICAL_AGENT_SECRET_DIRS.some(
134
+ (dir) => dir !== BROWSER_PROFILE_RELATIVE_DIR && target.endsWith(`${sep}${dir.split('/').join(sep)}`),
135
+ )
126
136
  }
127
137
 
128
138
  async function rejectHardlinksUnderCanonicalDir(root: string): Promise<void> {
139
+ await rejectHardlinkAliases(root, MAX_CANONICAL_SECRET_SCAN_ENTRIES)
140
+ }
141
+
142
+ export async function rejectHardlinkAliases(root: string, maxEntries = Number.POSITIVE_INFINITY): Promise<void> {
129
143
  const pending = [root]
130
144
  let visited = 0
131
145
  while (pending.length > 0) {
@@ -136,7 +150,7 @@ async function rejectHardlinksUnderCanonicalDir(root: string): Promise<void> {
136
150
  try {
137
151
  for await (const entry of dir) {
138
152
  visited += 1
139
- if (visited > MAX_CANONICAL_SECRET_SCAN_ENTRIES) {
153
+ if (visited > maxEntries) {
140
154
  throw new SandboxMaskTargetError(root, 'canonical secret directory exceeds bounded hardlink scan')
141
155
  }
142
156
  const child = join(current, entry.name)
@@ -1,6 +1,7 @@
1
1
  export type SandboxMount =
2
2
  | { type: 'ro-bind'; source: string; dest: string }
3
3
  | { type: 'bind'; source: string; dest: string }
4
+ | { type: 'ro-bind-fd' | 'bind-fd'; fd: number; dest: string }
4
5
  | { type: 'tmpfs'; dest: string }
5
6
  | { type: 'dev'; dest: string }
6
7
 
@@ -1,4 +1,7 @@
1
1
  // Runtime-owned operational state is private to TypeClaw, but is not a
2
2
  // credential. Keep this category separate from canonical-secrets so security
3
3
  // diagnostics never mislabel incident metadata as secret material.
4
- export const CANONICAL_AGENT_RUNTIME_PRIVATE_FILES = ['.typeclaw/incidents.json'] as const
4
+ export const CANONICAL_AGENT_RUNTIME_PRIVATE_FILES = [
5
+ '.typeclaw/incidents.json',
6
+ '.typeclaw/coding-agent-tasks.json',
7
+ ] as const
@@ -0,0 +1,97 @@
1
+ import { join } from 'node:path'
2
+
3
+ import type { Credential, CredentialStore } from '@earendil-works/pi-ai'
4
+ import { ModelRuntime } from '@earendil-works/pi-coding-agent'
5
+
6
+ import { createSecretsStoreForAgent } from './storage'
7
+
8
+ /** Runtime-only value. Never serialize this into a tool receipt or child configuration. */
9
+ export type CodingAgentProvider = 'anthropic' | 'openai-codex'
10
+ export type CodingAgentAuth = {
11
+ readonly token: string
12
+ readonly secrets: readonly string[]
13
+ } & (
14
+ | { readonly provider?: 'anthropic'; readonly type: 'api_key' | 'oauth' }
15
+ | { readonly provider: 'openai-codex'; readonly type: 'oauth'; readonly accountId: string }
16
+ )
17
+
18
+ export class CodingAgentAuthError extends Error {
19
+ constructor(provider: CodingAgentProvider) {
20
+ super(
21
+ `${provider} authentication is unavailable. On the host, run \`typeclaw provider add ${provider}\`, then retry this task.`,
22
+ )
23
+ }
24
+ }
25
+
26
+ export type CodingAgentAuthResolver = {
27
+ resolve(signal?: AbortSignal, rejected?: CodingAgentAuth, provider?: CodingAgentProvider): Promise<CodingAgentAuth>
28
+ }
29
+
30
+ export async function createCodingAgentAuthResolver(
31
+ agentDir: string,
32
+ dependencies?: { credentials: CredentialStore; runtime: ModelRuntime },
33
+ ): Promise<CodingAgentAuthResolver> {
34
+ const credentials = dependencies?.credentials ?? createSecretsStoreForAgent(join(agentDir, 'secrets.json'))
35
+ const runtime =
36
+ dependencies?.runtime ?? (await ModelRuntime.create({ credentials, modelsPath: null, refreshOnCreate: false }))
37
+
38
+ return {
39
+ async resolve(signal, rejected, provider = 'anthropic') {
40
+ try {
41
+ // Invalidate only the rejected generation, under the SAME lock used by pi.
42
+ // A concurrent refresh or host re-login must never be overwritten.
43
+ if (rejected?.provider === provider && rejected.type === 'oauth') {
44
+ await credentials.modify(
45
+ provider,
46
+ async (current) => {
47
+ if (current?.type === 'oauth' && current.access === rejected.token) {
48
+ return { ...current, expires: 0 }
49
+ }
50
+ return undefined
51
+ },
52
+ { signal },
53
+ )
54
+ }
55
+ const stored = await credentials.read(provider, { signal })
56
+ // Subscription delegation must never fall back to separately billed API auth.
57
+ if (provider === 'openai-codex' && stored?.type !== 'oauth') throw new CodingAgentAuthError(provider)
58
+ const resolved = await runtime.getAuth(provider, {
59
+ signal,
60
+ // Persisted OAuth wins over ambient API keys, as on the main-agent path.
61
+ ...(stored?.type === 'oauth' || dependencies ? { env: {} } : {}),
62
+ })
63
+ if (!resolved?.auth.apiKey) throw new CodingAgentAuthError(provider)
64
+ const token = resolved.auth.apiKey
65
+ const current = await credentials.read(provider, { signal })
66
+ const secrets = [token, ...credentialSecrets(stored), ...credentialSecrets(current)].filter(Boolean)
67
+ if (provider === 'openai-codex') {
68
+ // Bind the account to the exact resolved token generation, not a racing re-login.
69
+ const credential = [current, stored].find((value) => value?.type === 'oauth' && value.access === token)
70
+ if (
71
+ credential?.type !== 'oauth' ||
72
+ typeof credential.accountId !== 'string' ||
73
+ !/^[\x21-\x7e]+$/.test(credential.accountId)
74
+ )
75
+ throw new CodingAgentAuthError(provider)
76
+ return { provider, type: 'oauth', token, accountId: credential.accountId, secrets }
77
+ }
78
+ return {
79
+ provider,
80
+ type: current?.type === 'oauth' ? 'oauth' : 'api_key',
81
+ token,
82
+ secrets,
83
+ }
84
+ } catch {
85
+ // OAuth transports can include token endpoint bodies in their errors.
86
+ throw new CodingAgentAuthError(provider)
87
+ }
88
+ },
89
+ }
90
+ }
91
+
92
+ function credentialSecrets(credential: Credential | undefined): string[] {
93
+ if (credential?.type !== 'oauth') return []
94
+ return [credential.access, credential.refresh, credential.idToken, credential.id_token].filter(
95
+ (value): value is string => typeof value === 'string' && value.length > 0,
96
+ )
97
+ }
@@ -24,22 +24,6 @@ export {
24
24
  exportGithubCliStoreIfApplicable,
25
25
  } from './export-github-cli-store'
26
26
 
27
- export {
28
- type ExportCodexAuthFileResult,
29
- exportCodexAuthFileForAgent,
30
- exportCodexAuthFileIfApplicable,
31
- } from './export-codex-auth-file'
32
-
33
- export {
34
- CLAUDE_CREDENTIALS_FILE_NAME,
35
- CLAUDE_CREDENTIALS_RELATIVE_PATH,
36
- CLAUDE_DEFAULT_CONFIG_DIR_NAME,
37
- type ExportClaudeCredentialsFileResult,
38
- exportClaudeCredentialsFileForAgent,
39
- exportClaudeCredentialsFileIfApplicable,
40
- resolveClaudeCredentialsPath,
41
- } from './export-claude-credentials-file'
42
-
43
27
  export {
44
28
  type ProviderRefreshEntry,
45
29
  type ProviderRefreshOutcome,
@@ -230,6 +230,19 @@ export class SecretsBackend implements CredentialStore {
230
230
  }
231
231
  }
232
232
 
233
+ removeGithubCliSync(): void {
234
+ if (!existsSync(this.secretsPath)) return
235
+ let release: (() => void) | undefined
236
+ try {
237
+ release = this.acquireSyncLockWithRetry()
238
+ const { githubCli, ...rest } = this.readEnvelope()
239
+ if (githubCli === undefined) return
240
+ this.writeEnvelopeAtomic(rest)
241
+ } finally {
242
+ release?.()
243
+ }
244
+ }
245
+
233
246
  readMcpCredentialSync(serverName: string): McpCredential | undefined {
234
247
  if (!existsSync(this.secretsPath)) return undefined
235
248
  let release: (() => void) | undefined
@@ -10,6 +10,8 @@ import {
10
10
  import { applyTurnThinkingLevel } from '@/agent/attention-escalation'
11
11
  import { promptWithSameRefRetryOnly } from '@/agent/retry-same-ref'
12
12
  import type { ChannelRouter } from '@/channels/router'
13
+ import { readOomEvents, toolOomNote } from '@/container/oom-events'
14
+ import { withToolOomPriorityArgv } from '@/container/tool-oom-priority'
13
15
  import type { McpManager } from '@/mcp'
14
16
  import type { PermissionService } from '@/permissions'
15
17
  import type {
@@ -554,8 +556,9 @@ export async function runExecForCommand(
554
556
  // server started by sh -c "node server.js") would keep stdout pipes open
555
557
  // for minutes, masking the abort. See src/agent/tools/ddg.ts for the
556
558
  // same pattern applied to curl-impersonate wrappers.
559
+ const oomBefore = readOomEvents()
557
560
  const proc = Bun.spawn({
558
- cmd: ['sh', '-c', cmd],
561
+ cmd: withToolOomPriorityArgv(['sh', '-c', cmd]),
559
562
  cwd: opts.cwd,
560
563
  env: buildExecEnv(opts.cwd),
561
564
  stdout: 'pipe',
@@ -582,7 +585,8 @@ export async function runExecForCommand(
582
585
  new Response(proc.stdout as unknown as ReadableStream<Uint8Array>).text(),
583
586
  new Response(proc.stderr as unknown as ReadableStream<Uint8Array>).text(),
584
587
  ])
585
- return { stdout: stdoutText, stderr: stderrText, exitCode }
588
+ const note = toolOomNote(oomBefore, exitCode, 'plugin exec', { log: (line) => console.warn(line) })
589
+ return { stdout: stdoutText, stderr: note === null ? stderrText : `${stderrText}${note}\n`, exitCode }
586
590
  } finally {
587
591
  opts.signal.removeEventListener('abort', onAbort)
588
592
  if (escalationTimer !== null) clearTimeout(escalationTimer)