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
@@ -1,8 +1,8 @@
1
1
  import { randomBytes } from 'node:crypto'
2
2
  import { accessSync, constants as fsConstants, existsSync, realpathSync } from 'node:fs'
3
3
  import { cp, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
4
- import { tmpdir } from 'node:os'
5
- import { isAbsolute, join, relative, resolve } from 'node:path'
4
+ import { homedir, tmpdir } from 'node:os'
5
+ import { isAbsolute, join, posix, relative, resolve } from 'node:path'
6
6
 
7
7
  import { migrateAgentMessengerConfigDir, resolveAgentMessengerConfigPolicy } from '@/agent-messenger/config-dir'
8
8
  import { expandMountPath, loadConfigSync, withDefaultPlugins, type Config, type PortForward } from '@/config'
@@ -27,6 +27,7 @@ import { resolveBaseImageVersion, resolveTypeclawSpec, typeclawCheckoutRoot } fr
27
27
  import { buildDockerfile, classifyDockerfileAppend, DOCKERFILE } from '@/init/dockerfile'
28
28
  import { ensureDepsInstalled, type EnsureDepsResult } from '@/init/ensure-deps'
29
29
  import { buildGitignore, GITIGNORE_FILE } from '@/init/gitignore'
30
+ import { localSourceFingerprint, readLocalSourceStamp, writeLocalSourceStamp } from '@/init/local-source-stamp'
30
31
  import { refreshPackageJson } from '@/init/packagejson'
31
32
  import { reconcilePluginDeps } from '@/init/reconcile-plugin-deps'
32
33
  import { runBunUpdate, type UpdateRunner } from '@/init/run-bun-install'
@@ -43,6 +44,7 @@ import { hostLocaleIsCjk } from '@/shared/host-locale'
43
44
  import { type AgentOperationLease, type WithAgentOperationLock, withAgentOperationLock } from './agent-operation-lock'
44
45
  import { acquireManagedBuildCache, type ManagedBuildCacheLease } from './build-cache'
45
46
  import { COMPOSE_PROJECT } from './compose-project'
47
+ import { inspectContainerExit } from './exit-reason'
46
48
  import { archiveContainerLogs, dockerLogsUnavailableWarning, type DockerLogArchiver } from './log-archive'
47
49
  import { formatMemorySize, readDockerTotalMemory, resolveMemoryLimit } from './memory-limit'
48
50
  import {
@@ -85,6 +87,35 @@ const CONTAINER_HOSTD_HOST = 'host.docker.internal'
85
87
  const HOST_GATEWAY_ALIAS = `${CONTAINER_HOSTD_HOST}:host-gateway`
86
88
 
87
89
  const MOUNT_TARGET_PREFIX = '/agent/mounts'
90
+ const HOST_FONTS_TARGET_PREFIX = '/usr/share/fonts/host'
91
+
92
+ // Only user-installed folders: macOS `/System/Library/Fonts` is licensed for
93
+ // macOS only and mostly holds system UI fonts no document needs.
94
+ export function resolveHostFontMounts({
95
+ platform,
96
+ home,
97
+ exists = existsSync,
98
+ }: {
99
+ platform: NodeJS.Platform
100
+ home: string
101
+ exists?: (path: string) => boolean
102
+ }): Array<{ src: string; dst: string; readonly: true }> {
103
+ const sources: Array<[string, string]> =
104
+ platform === 'darwin'
105
+ ? [
106
+ ['user', posix.join(home, 'Library', 'Fonts')],
107
+ ['system', '/Library/Fonts'],
108
+ ]
109
+ : platform === 'linux'
110
+ ? [
111
+ ['user', posix.join(home, '.local', 'share', 'fonts')],
112
+ ['system', '/usr/share/fonts'],
113
+ ]
114
+ : []
115
+ return sources
116
+ .filter(([, src]) => exists(src))
117
+ .map(([name, src]) => ({ src, dst: `${HOST_FONTS_TARGET_PREFIX}-${name}`, readonly: true }))
118
+ }
88
119
 
89
120
  export type StartPlan = {
90
121
  containerName: string
@@ -119,6 +150,7 @@ export type PlanStartOptions = {
119
150
  // rather than from os.totalmem(). Omitted by callers that have no exec (and
120
151
  // by tests), in which case the default applies unclamped.
121
152
  totalMemoryBytes?: number | undefined
153
+ hostHome?: string
122
154
  }
123
155
 
124
156
  export type HostDaemonControl = {
@@ -157,6 +189,8 @@ export type StartOptions = {
157
189
  // disables process output so child progress and warnings cannot corrupt it.
158
190
  streamOutput?: boolean
159
191
  onWarning?: (warning: string) => void
192
+ // Compose runs one fleet-wide check after every agent settled instead.
193
+ skipMemoryOversubscriptionCheck?: boolean
160
194
  exec?: DockerExec
161
195
  // Test seam: allows tests to inject a deterministic port allocator. In
162
196
  // production we go through the real kernel via `findFreePort`.
@@ -272,6 +306,7 @@ async function runStart({
272
306
  forceBuild = false,
273
307
  streamOutput = true,
274
308
  onWarning,
309
+ skipMemoryOversubscriptionCheck = false,
275
310
  exec = defaultDockerExec,
276
311
  allocatePort = findFreePort,
277
312
  cliEntry,
@@ -296,21 +331,27 @@ async function runStart({
296
331
  const containerName = containerNameFromCwd(cwd)
297
332
  const imageTagValue = imageTagFromCwd(cwd)
298
333
  const archiveBeforeRemove = async (containerId: string) => {
334
+ const exit = await inspectContainerExit(exec, containerId)
299
335
  const archive = await archiveLogs({
300
336
  agentDir: cwd,
301
337
  containerId,
302
338
  retentionDays: (await loadTypeclawConfig(cwd)).logs.retentionDays,
303
339
  })
304
- if (archive.ok) return { ok: true as const }
305
- if (archive.kind === 'failed') return { ok: false as const, reason: archive.reason }
340
+ if (!archive.ok && archive.kind === 'failed') return { ok: false as const, reason: archive.reason }
306
341
  // Dispatch on the callback, NOT on streamOutput. `streamOutput` defaults
307
342
  // to true, and standalone start/restart both stream Docker build output
308
343
  // AND pass a collector so they can render warnings after their spinner
309
344
  // settles; keying on streamOutput writes under the live spinner and
310
345
  // leaves that collector empty. stderr stays the no-callback fallback.
311
- const warning = dockerLogsUnavailableWarning(containerId)
312
- if (onWarning !== undefined) onWarning(warning)
313
- else if (streamOutput) process.stderr.write(`${warning}\n`)
346
+ if (!archive.ok) {
347
+ const warning = dockerLogsUnavailableWarning(containerId)
348
+ if (onWarning !== undefined) onWarning(warning)
349
+ else if (streamOutput) process.stderr.write(`${warning}\n`)
350
+ }
351
+ if (exit?.kind === 'stopped' && exit.reason !== null) {
352
+ if (onWarning !== undefined) onWarning(exit.reason)
353
+ else if (streamOutput) process.stderr.write(`typeclaw: ${exit.reason}\n`)
354
+ }
314
355
  return { ok: true as const }
315
356
  }
316
357
 
@@ -370,8 +411,18 @@ async function runStart({
370
411
  }
371
412
  }
372
413
 
373
- const githubCliDeniedRoots = resolveGithubCliDeniedRoots(cwd, await loadTypeclawConfig(cwd))
374
- const githubCliWarning = await refreshGithubCliStore(cwd, githubCliDeniedRoots, provisionGithubCliStoreForAgent)
414
+ const githubCliConfig = await loadTypeclawConfig(cwd)
415
+ if (!githubCliConfig.githubCli.importHostAuth) {
416
+ const removalFailure = removeGithubCliStore(cwd)
417
+ if (removalFailure !== null) return { ok: false, reason: removalFailure }
418
+ }
419
+ const githubCliWarning = githubCliConfig.githubCli.importHostAuth
420
+ ? await refreshGithubCliStore(
421
+ cwd,
422
+ resolveGithubCliDeniedRoots(cwd, githubCliConfig),
423
+ provisionGithubCliStoreForAgent,
424
+ )
425
+ : null
375
426
  if (githubCliWarning !== null) {
376
427
  if (streamOutput) process.stderr.write(githubCliWarning)
377
428
  else onWarning?.(githubCliWarning.trim())
@@ -510,7 +561,14 @@ async function runStart({
510
561
  // version bump (dir already present) or a removal (stale dir left behind)
511
562
  // would otherwise leave bun.lock/node_modules out of sync with the
512
563
  // reconciled package.json.
564
+ //
565
+ // A `file:` dep is a snapshot copy taken at install time, so pulling or
566
+ // editing the checkout leaves the agent running old code until something
567
+ // re-copies it. Fingerprint the checkout and force a reinstall only when it
568
+ // moved since the last install, so routine restarts stay fast.
569
+ const staleLocalFingerprint = await staleLocalTypeclawCopyFingerprint(cwd)
513
570
  const forceDepsReinstall =
571
+ staleLocalFingerprint !== null ||
514
572
  (forceBuild && (await hasLocallyLinkedTypeclawDep(cwd))) ||
515
573
  pluginReconcile.changed ||
516
574
  outcomeRequiresForceInstall(upgrade) ||
@@ -519,6 +577,7 @@ async function runStart({
519
577
  if (!deps.ok) {
520
578
  return { ok: false, reason: `dependency install failed: ${deps.reason}` }
521
579
  }
580
+ if (staleLocalFingerprint !== null) await writeLocalSourceStamp(cwd, staleLocalFingerprint)
522
581
  await commitSystemFile(cwd, DEPENDENCY_FILES, upgradeCommitMessage ?? 'Update dependencies')
523
582
  // Probe buildx up front so the Dockerfile we write matches the builder we
524
583
  // will use. buildx present -> emit the BuildKit Dockerfile and build with
@@ -601,14 +660,16 @@ async function runStart({
601
660
  totalMemoryBytes,
602
661
  })
603
662
 
604
- await warnOnMemoryOversubscription({
605
- exec,
606
- containerName,
607
- memoryLimitBytes: plan.memoryLimitBytes,
608
- totalMemoryBytes,
609
- onWarning,
610
- streamOutput,
611
- })
663
+ if (!skipMemoryOversubscriptionCheck) {
664
+ await warnOnMemoryOversubscription({
665
+ exec,
666
+ containerName,
667
+ memoryLimitBytes: plan.memoryLimitBytes,
668
+ totalMemoryBytes,
669
+ onWarning,
670
+ streamOutput,
671
+ })
672
+ }
612
673
 
613
674
  let built = false
614
675
  if (plan.needsBuild) {
@@ -843,6 +904,22 @@ async function refreshGithubCliStore(
843
904
  )
844
905
  }
845
906
 
907
+ // Without opt-in, a store persisted by an earlier start (when copying was
908
+ // unconditional) still carries the operator's identity. The container exports
909
+ // whatever store secrets.json holds, so a failed removal must stop the launch
910
+ // rather than run the agent as the operator.
911
+ function removeGithubCliStore(agentDir: string): string | null {
912
+ try {
913
+ new SecretsBackend(join(agentDir, 'secrets.json')).removeGithubCliSync()
914
+ return null
915
+ } catch {
916
+ return (
917
+ 'Could not remove the host GitHub CLI credential from secrets.json (githubCli.importHostAuth is off). ' +
918
+ 'Delete the `githubCli` entry from secrets.json by hand, or fix the file if it is malformed, then run typeclaw start again.'
919
+ )
920
+ }
921
+ }
922
+
846
923
  // An unreadable or malformed secrets.json cannot prove the store is absent, so
847
924
  // it takes the warning — silence is reserved for a confirmed no-store agent.
848
925
  function hasPersistedGithubCliStore(agentDir: string): boolean {
@@ -910,6 +987,7 @@ export async function planStart({
910
987
  hostIdentity = currentHostIdentity(),
911
988
  gitIdentity,
912
989
  totalMemoryBytes,
990
+ hostHome = homedir(),
913
991
  }: PlanStartOptions): Promise<StartPlan> {
914
992
  const containerName = containerNameFromCwd(cwd)
915
993
  const imageTag = imageTagFromCwd(cwd)
@@ -1150,6 +1228,12 @@ export async function planStart({
1150
1228
  runArgs.push(...dockerBindMount({ src: hostPath, dst: target, readonly: mount.readOnly }))
1151
1229
  }
1152
1230
 
1231
+ if (cfg.hostFonts) {
1232
+ for (const fontMount of resolveHostFontMounts({ platform, home: hostHome })) {
1233
+ runArgs.push(...dockerBindMount(fontMount))
1234
+ }
1235
+ }
1236
+
1153
1237
  // Shared model cache mount for embeddings. Vector memory is always on, and
1154
1238
  // the embedder runs with local_files_only inside the container.
1155
1239
  runArgs.push(...dockerBindMount({ src: join(homeRoot(), 'models'), dst: '/opt/models', readonly: true }))
@@ -1222,6 +1306,7 @@ export async function refreshDockerfile(
1222
1306
  // path. Mirrors the same gate in writeDockerAssets (src/init/index.ts).
1223
1307
  const devMode = await hasLocallyLinkedTypeclawDep(cwd)
1224
1308
  const next = buildDockerfile(cfg.docker.file, {
1309
+ browser: cfg.browser,
1225
1310
  baseImageVersion: devMode ? null : resolveBaseImageVersion(cwd),
1226
1311
  cjkFontsAuto: hostLocaleIsCjk(),
1227
1312
  buildKit: opts.buildKit,
@@ -1686,6 +1771,24 @@ async function hasLocallyLinkedTypeclawDep(cwd: string): Promise<boolean> {
1686
1771
  return spec !== null && (spec.startsWith('file:') || spec.startsWith('link:'))
1687
1772
  }
1688
1773
 
1774
+ // Returns the checkout's current fingerprint when the agent's `file:` copy of
1775
+ // typeclaw no longer matches it, else null. An install that resolves to the
1776
+ // checkout itself is live and never stale. A symlink alone does not prove that:
1777
+ // bun's isolated linker symlinks into its own store, which is still a copy.
1778
+ async function staleLocalTypeclawCopyFingerprint(cwd: string): Promise<string | null> {
1779
+ if (!(await readTypeclawDepSpec(cwd))?.startsWith('file:')) return null
1780
+ const source = await detectDevSource(cwd)
1781
+ if (source === null) return null
1782
+ try {
1783
+ if (realpathSync(join(cwd, 'node_modules', TYPECLAW_PACKAGE)) === realpathSync(source)) return null
1784
+ } catch {
1785
+ // Not installed yet, or the checkout is missing: fall through to the fingerprint.
1786
+ }
1787
+ const fingerprint = await localSourceFingerprint(source)
1788
+ if (fingerprint === null || fingerprint === (await readLocalSourceStamp(cwd))) return null
1789
+ return fingerprint
1790
+ }
1791
+
1689
1792
  async function readTypeclawDepSpec(cwd: string): Promise<string | null> {
1690
1793
  try {
1691
1794
  const raw = await readFile(join(cwd, PACKAGE_FILE), 'utf8')
@@ -2,9 +2,11 @@ import { DEFAULT_LOG_RETENTION_DAYS, loadConfigSync } from '@/config'
2
2
  import { isDaemonReachable, send as sendToDaemon } from '@/hostd/client'
3
3
 
4
4
  import { type AgentOperationLease, type WithAgentOperationLock, withAgentOperationLock } from './agent-operation-lock'
5
+ import { inspectContainerExit } from './exit-reason'
5
6
  import { archiveContainerLogs, dockerLogsUnavailableWarning, type DockerLogArchiver } from './log-archive'
6
7
  import {
7
8
  classifyRmStderr,
9
+ CONTAINER_REMOVAL_TIMEOUT_MS,
8
10
  containerNameFromCwd,
9
11
  defaultDockerExec,
10
12
  type DockerExec,
@@ -78,6 +80,7 @@ async function runStop({
78
80
  }
79
81
  }
80
82
  const { containerId, running } = parsed
83
+ const staleExit = running ? null : await inspectContainerExit(exec, containerId)
81
84
 
82
85
  // Only call `docker stop` when the container is actually running. A stopped
83
86
  // corpse from a prior crash is left around by design (no `--rm`), and
@@ -100,6 +103,7 @@ async function runStop({
100
103
  }
101
104
  onWarning?.(dockerLogsUnavailableWarning(containerId))
102
105
  }
106
+ if (staleExit?.kind === 'stopped' && staleExit.reason !== null) onWarning?.(staleExit.reason)
103
107
 
104
108
  // Containers run without `--rm`, so `docker stop` only stops them. Remove
105
109
  // the inspected ID without force after archival. If that same ID resumed,
@@ -134,12 +138,12 @@ async function runStop({
134
138
  return { ok: false, reason: diagnosis === null ? reason : `${reason} ${diagnosis}` }
135
139
  }
136
140
  if (kind === 'in-progress' && !(await waitForRemoval(exec, containerName))) {
137
- const reason = `Container ${containerName} is still being removed by docker after 10s.`
141
+ const reason = `Container ${containerName} is still being removed by docker after ${CONTAINER_REMOVAL_TIMEOUT_MS / 1000}s.`
138
142
  const diagnosis = await describeUnremovableContainer(exec, containerId)
139
143
  return { ok: false, reason: diagnosis === null ? reason : `${reason} ${diagnosis}` }
140
144
  }
141
145
  } else if (!(await waitForRemoval(exec, containerName))) {
142
- const reason = `Container ${containerName} is still being removed by docker after 10s.`
146
+ const reason = `Container ${containerName} is still being removed by docker after ${CONTAINER_REMOVAL_TIMEOUT_MS / 1000}s.`
143
147
  const diagnosis = await describeUnremovableContainer(exec, containerId)
144
148
  return { ok: false, reason: diagnosis === null ? reason : `${reason} ${diagnosis}` }
145
149
  }
@@ -0,0 +1,32 @@
1
+ // Under a 6 GiB memcg, a ~230 MiB tool process contributes only ~38 points
2
+ // from RSS, versus ~230 for a 1.4 GiB agent runtime. +600 puts even that
3
+ // tool ahead of the runtime without using the maximum (+1000) and making
4
+ // tiny helper processes unconditional first victims. Children inherit the
5
+ // score across fork/exec. The shell writes its OWN score before any command
6
+ // can fork; writing /proc/<pid> from the parent after spawn would race.
7
+ const OOM_SCORE_ADJ = 600
8
+ const SCORE_PATH = '/proc/self/oom_score_adj'
9
+ const PRIORITY_SCRIPT = `if [ -w ${SCORE_PATH} ]; then printf '%s\\n' ${OOM_SCORE_ADJ} 2>/dev/null >${SCORE_PATH} || :; fi`
10
+
11
+ function priorityScript(scorePath: string): string {
12
+ // The default is pre-rendered; alternate paths are solely a test seam for
13
+ // an absent or write-failing procfs, never derived from a tool command.
14
+ return scorePath === SCORE_PATH
15
+ ? PRIORITY_SCRIPT
16
+ : `if [ -w '${scorePath}' ]; then printf '%s\\n' ${OOM_SCORE_ADJ} 2>/dev/null >'${scorePath}' || :; fi`
17
+ }
18
+
19
+ // Shell built-in printf runs in this process. An absent/unwritable procfs
20
+ // (including non-container dev environments) fails open without changing the
21
+ // command's output, exit status, environment, or timeout behavior.
22
+ export function withToolOomPriorityCommand(command: string, scorePath = SCORE_PATH): string {
23
+ return process.platform === 'linux' ? `${priorityScript(scorePath)}\n${command}` : command
24
+ }
25
+
26
+ export function withToolOomPriorityArgv(command: string[], scorePath = SCORE_PATH): string[] {
27
+ return process.platform === 'linux'
28
+ ? ['/bin/sh', '-c', `${priorityScript(scorePath)}\nexec "$@"`, 'tool-oom-priority', ...command]
29
+ : command
30
+ }
31
+
32
+ export { OOM_SCORE_ADJ }
@@ -4,6 +4,8 @@ import { promptWithFallback, resolveFallbackChain } from '@/agent/model-fallback
4
4
  import type { SessionOrigin } from '@/agent/session-origin'
5
5
  import { getConfig } from '@/config'
6
6
  import type { ModelRef } from '@/config/providers'
7
+ import { readOomEvents, toolOomNote } from '@/container/oom-events'
8
+ import { withToolOomPriorityArgv } from '@/container/tool-oom-priority'
7
9
  import type { HookBus } from '@/plugin'
8
10
  import type { Stream, Unsubscribe } from '@/stream'
9
11
 
@@ -143,7 +145,7 @@ export function createCronConsumer({
143
145
  if (job.kind === 'prompt') {
144
146
  if (!(await runPrompt(job, createSessionForCron, stream, logger))) outcome = 'failed'
145
147
  } else if (job.kind === 'exec') {
146
- await runExec(job, cwd)
148
+ await runExec(job, cwd, logger)
147
149
  } else {
148
150
  if (invokeHandler === undefined) {
149
151
  throw new Error(
@@ -347,7 +349,7 @@ function describe(err: unknown): string {
347
349
  return err instanceof Error ? err.message : String(err)
348
350
  }
349
351
 
350
- async function runExec(job: ExecJob, cwd: string): Promise<void> {
352
+ async function runExec(job: ExecJob, cwd: string, logger: CronConsumerLogger): Promise<void> {
351
353
  const [cmd, ...args] = job.command
352
354
  if (!cmd) throw new Error(`exec job ${job.id}: empty command`)
353
355
  // Inject TYPECLAW_PARENT_ORIGIN_JSON so a child that proxies into the
@@ -363,8 +365,9 @@ async function runExec(job: ExecJob, cwd: string): Promise<void> {
363
365
  ...(job.scheduledByRole !== undefined ? { scheduledByRole: job.scheduledByRole } : {}),
364
366
  ...(job.scheduledByOrigin !== undefined ? { scheduledByOrigin: job.scheduledByOrigin } : {}),
365
367
  }
368
+ const oomBefore = readOomEvents()
366
369
  const proc = Bun.spawn({
367
- cmd: [cmd, ...args],
370
+ cmd: withToolOomPriorityArgv([cmd, ...args]),
368
371
  cwd,
369
372
  stdout: 'ignore',
370
373
  stderr: 'pipe',
@@ -375,8 +378,11 @@ async function runExec(job: ExecJob, cwd: string): Promise<void> {
375
378
  })
376
379
  const stderrText = new Response(proc.stderr).text()
377
380
  const [code, stderr] = await Promise.all([proc.exited, stderrText])
381
+ const note = toolOomNote(oomBefore, code, 'cron exec', { log: logger.warn })
378
382
  if (code !== 0) {
379
- throw new Error(`exec job ${job.id} exited with code ${code}: ${stderr.trim() || 'no stderr'}`)
383
+ throw new Error(
384
+ `exec job ${job.id} exited with code ${code}: ${stderr.trim() || 'no stderr'}${note === null ? '' : `\n${note}`}`,
385
+ )
380
386
  }
381
387
  }
382
388
 
@@ -3,7 +3,7 @@ import type { Reloadable, ReloadResult } from '@/reload'
3
3
 
4
4
  import { loadCron } from './index'
5
5
  import type { JobDiff, Scheduler } from './scheduler'
6
- import type { CronJob } from './schema'
6
+ import type { CronJob, HandlerJob, ParsedCronJob } from './schema'
7
7
 
8
8
  export type CreateCronReloadableOptions = {
9
9
  cwd: string
@@ -74,7 +74,28 @@ async function doReload({
74
74
  return { scope: 'cron', ok: false, reason: `apply failed (schedule unchanged): ${message}` }
75
75
  }
76
76
 
77
- return { scope: 'cron', ok: true, summary: formatSummary(diff, nextJobs.length), details: diff }
77
+ return { scope: 'cron', ok: true, summary: formatSummary(diff, nextJobs.length), details: plainDiff(diff) }
78
+ }
79
+
80
+ // `details` lands in the reload tool result, which pi structuredClones on every
81
+ // later request in that session. A plugin handler job's function would make
82
+ // that clone throw DataCloneError and wedge the session, so details carry data only.
83
+ type CronJobData = ParsedCronJob | Omit<HandlerJob, 'handler'>
84
+ type CronReloadDetails = Record<keyof JobDiff, CronJobData[]>
85
+
86
+ function plainDiff(diff: JobDiff): CronReloadDetails {
87
+ const plain = (jobs: CronJob[]): CronJobData[] =>
88
+ jobs.map((job) => {
89
+ if (job.kind !== 'handler') return job
90
+ const { handler: _handler, ...data } = job
91
+ return data
92
+ })
93
+ return {
94
+ added: plain(diff.added),
95
+ removed: plain(diff.removed),
96
+ updated: plain(diff.updated),
97
+ unchanged: plain(diff.unchanged),
98
+ }
78
99
  }
79
100
 
80
101
  function formatSummary(diff: JobDiff, total: number): string {
@@ -3,7 +3,7 @@ import { readFile } from 'node:fs/promises'
3
3
  import { homedir } from 'node:os'
4
4
  import { join, relative } from 'node:path'
5
5
 
6
- import { loadConfigSync, validateConfig } from '@/config'
6
+ import { type Config, loadConfigSync, validateConfig } from '@/config'
7
7
  import {
8
8
  checkDockerAvailable,
9
9
  containerNameFromCwd,
@@ -17,6 +17,7 @@ import {
17
17
  type DockerExec,
18
18
  } from '@/container'
19
19
  import { homeRoot, isDaemonReachable, send } from '@/hostd'
20
+ import { hostBunVersionWarning } from '@/hostd/version'
20
21
  import { resolveBaseImageVersion } from '@/init/cli-version'
21
22
  import { buildDockerfile, DOCKERFILE } from '@/init/dockerfile'
22
23
  import { detectMissingDeps } from '@/init/ensure-deps'
@@ -99,7 +100,7 @@ function dockerDaemonFix(reason: DockerUnavailableReason): string {
99
100
  }
100
101
  }
101
102
 
102
- function bunRuntime(): DoctorCheck {
103
+ export function bunRuntime(bunVersion: string | undefined = process.versions.bun): DoctorCheck {
103
104
  return {
104
105
  name: 'runtime.bun-available',
105
106
  category: 'runtime',
@@ -113,7 +114,18 @@ function bunRuntime(): DoctorCheck {
113
114
  fix: { description: 'Install Bun (https://bun.sh) and ensure the typeclaw CLI runs under it.' },
114
115
  }
115
116
  }
116
- return { status: 'ok', message: `Bun ${process.versions.bun ?? 'present'}` }
117
+ const outdated = hostBunVersionWarning(bunVersion)
118
+ if (outdated) {
119
+ return {
120
+ status: 'warning',
121
+ message: outdated,
122
+ fix: {
123
+ description:
124
+ 'Run `bun upgrade`. The host daemon respawns on the new runtime at the next `typeclaw start` or `restart`.',
125
+ },
126
+ }
127
+ }
128
+ return { status: 'ok', message: `Bun ${bunVersion ?? 'present'}` }
117
129
  },
118
130
  }
119
131
  }
@@ -523,7 +535,7 @@ function buildExpectedDockerfile(cwd: string): string | null {
523
535
  try {
524
536
  const cfg = loadConfigStrictForTemplate(cwd)
525
537
  if (cfg === null) return null
526
- return buildDockerfile(cfg.dockerfile, { baseImageVersion: resolveBaseImageVersion(cwd) })
538
+ return buildDockerfile(cfg.dockerfile, { browser: cfg.browser, baseImageVersion: resolveBaseImageVersion(cwd) })
527
539
  } catch {
528
540
  return null
529
541
  }
@@ -539,13 +551,15 @@ function buildExpectedGitignore(cwd: string): string | null {
539
551
  }
540
552
  }
541
553
 
542
- function loadConfigStrictForTemplate(
543
- cwd: string,
544
- ): { dockerfile: Parameters<typeof buildDockerfile>[0]; gitignore: Parameters<typeof buildGitignore>[0] } | null {
554
+ function loadConfigStrictForTemplate(cwd: string): {
555
+ dockerfile: Parameters<typeof buildDockerfile>[0]
556
+ browser: Config['browser']
557
+ gitignore: Parameters<typeof buildGitignore>[0]
558
+ } | null {
545
559
  const result = validateConfig(cwd)
546
560
  if (!result.ok) return null
547
561
  const cfg = loadConfigSync(cwd)
548
- return { dockerfile: cfg.docker.file, gitignore: cfg.git.ignore }
562
+ return { dockerfile: cfg.docker.file, browser: cfg.browser, gitignore: cfg.git.ignore }
549
563
  }
550
564
 
551
565
  // Normalizes CRLF to LF: the managed templates are emitted with `\n`, but a
@@ -5,6 +5,7 @@ import { join } from 'node:path'
5
5
 
6
6
  import type { PortForward } from '@/config'
7
7
  import { defaultDockerExec, type DockerExec, type HostDaemonRegisterPayload } from '@/container'
8
+ import { inspectContainerExit } from '@/container/exit-reason'
8
9
  import type { PortForwardEvent } from '@/portbroker'
9
10
  import {
10
11
  discordChannelBlockSchema,
@@ -126,6 +127,7 @@ export type DaemonLogEvent =
126
127
  | { kind: 'register'; containerName: string }
127
128
  | { kind: 'deregister'; containerName: string; reason: 'requested' | 'gone' }
128
129
  | { kind: 'registration-skipped'; containerName: string; reason: string }
130
+ | { kind: 'container-exited'; containerName: string; reason: string }
129
131
  | { kind: 'shutdown-requested' }
130
132
  | { kind: 'port-forward-event'; event: PortForwardEvent }
131
133
  | { kind: 'tailscale-serve-event'; event: TailscaleServeEvent }
@@ -236,7 +238,14 @@ async function restorePersistedRegistrations(
236
238
  log({ kind: 'registration-skipped', containerName: expectedName, reason: 'container not running' })
237
239
  continue
238
240
  }
239
- await apply(parsed)
241
+ // One registration whose revival throws (e.g. portbroker.start) must not
242
+ // abort the loop: restoreComplete would reject and every gated RPC would
243
+ // fail until the daemon is respawned.
244
+ try {
245
+ await apply(parsed)
246
+ } catch (error) {
247
+ log({ kind: 'registration-skipped', containerName: expectedName, reason: stringifyError(error) })
248
+ }
240
249
  }
241
250
  }
242
251
 
@@ -327,6 +336,7 @@ export async function startDaemon(opts: DaemonOptions = {}): Promise<Daemon> {
327
336
  let nextRegistrationGeneration = 0
328
337
  const perContainerSerial = new Map<string, Promise<unknown>>()
329
338
  const gcMisses = new Map<string, number>()
339
+ const reportedExits = new Map<string, string>()
330
340
  let stopped = false
331
341
  let httpPort = 0
332
342
  // Boot-time restore runs concurrently with the listeners (see the kickoff
@@ -440,6 +450,11 @@ export async function startDaemon(opts: DaemonOptions = {}): Promise<Daemon> {
440
450
  void handleFatalAuthFailure(payload.containerName, brokerToken, reason)
441
451
  },
442
452
  })
453
+ } else if (opts.portbroker && brokerTokens.delete(payload.containerName)) {
454
+ // A re-register without broker fields must retire the previous broker;
455
+ // otherwise its stale token could later match a fatal-auth callback and
456
+ // tear down this live registration.
457
+ await withCleanupTimeout(opts.portbroker.stop(payload.containerName, 'deregistered'), cleanupStepTimeoutMs)
443
458
  }
444
459
  if (opts.kakaoRenewal) {
445
460
  opts.kakaoRenewal.start({ containerName: payload.containerName, cwd: payload.cwd })
@@ -736,20 +751,27 @@ export async function startDaemon(opts: DaemonOptions = {}): Promise<Daemon> {
736
751
  return json(rpc.kind === 'restart' ? await handleRestart(rpc) : await handleSecretsPatch(rpc))
737
752
  }
738
753
 
739
- // GC tick distinguishes "container confirmed gone" from "docker call failed":
740
- // a `docker ps` blip should not deregister a live container registration, so
741
- // we require gcMissesToDeregister consecutive confirmed absences. Boot-time
742
- // restore reuses the same probe but with a stricter policy — see
743
- // restorePersistedRegistrations.
754
+ // A stopped container is still present in `docker ps -a` and may be
755
+ // restarted by Docker; retain its registration and tokens. Inspect only
756
+ // for diagnostics, never to decide whether to GC a present container.
744
757
  const probeContainerAlive = async (name: string): Promise<'alive' | 'gone' | 'unknown'> => {
745
758
  try {
746
759
  const result = await exec(['ps', '-a', '--filter', `name=^${name}$`, '--format', '{{.Names}}'])
747
760
  if (result.exitCode !== 0) return 'unknown'
748
- const names = result.stdout
749
- .trim()
750
- .split('\n')
751
- .filter((s) => s.length > 0)
752
- return names.includes(name) ? 'alive' : 'gone'
761
+ const names = result.stdout.trim().split('\n')
762
+ if (!names.includes(name)) return 'gone'
763
+ const state = await inspectContainerExit(exec, name)
764
+ // Report each stop once. The container ID survives restarts, so key the
765
+ // report by ID and FinishedAt: repeated probes of one stop share a key,
766
+ // while a restart that crashes again between two probes gets a new one.
767
+ if (state?.kind === 'stopped' && state.reason !== null) {
768
+ const exitKey = `${state.containerId}@${state.finishedAt}`
769
+ if (reportedExits.get(name) !== exitKey) {
770
+ reportedExits.set(name, exitKey)
771
+ log({ kind: 'container-exited', containerName: name, reason: state.reason })
772
+ }
773
+ }
774
+ return 'alive'
753
775
  } catch {
754
776
  return 'unknown'
755
777
  }