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,5 +1,5 @@
1
1
  import { existsSync } from 'node:fs'
2
- import { lstat, open, readFile, unlink, writeFile } from 'node:fs/promises'
2
+ import { appendFile, lstat, open, readFile, stat, unlink, writeFile } from 'node:fs/promises'
3
3
 
4
4
  import lockfile from 'proper-lockfile'
5
5
 
@@ -34,6 +34,12 @@ const EXIT_SETTLE_MS = 500
34
34
  // seen as stale by a contender — only a crashed holder, whose refresh timer
35
35
  // died with it, is reclaimed. Mirrors the models/secrets locks' 30s ceiling.
36
36
  const LOCK_STALE_MS = 30_000
37
+ // A pidfile child that is still unreachable this long after it was spawned is
38
+ // wedged (e.g. stuck in Bun's crash handler after a segfault), not slow-booting.
39
+ // The pidfile is written at spawn time, so its mtime is the child's birth time.
40
+ const WEDGED_DAEMON_AGE_MS = 30_000
41
+ const SHUTDOWN_EXIT_GRACE_MS = 2_000
42
+ const KILL_GRACE_MS = 2_000
37
43
  const LOCK_RETRY_BACKOFF = {
38
44
  factor: 1,
39
45
  minTimeout: POLL_INTERVAL_MS,
@@ -90,6 +96,7 @@ async function readHttpPort(): Promise<number | null> {
90
96
  }
91
97
 
92
98
  async function requestShutdownAndWait(): Promise<boolean> {
99
+ const pid = await readPidQuiet()
93
100
  const reply = await send({ kind: 'shutdown' }, { timeoutMs: 1_000 })
94
101
  if (!reply.ok) return false
95
102
  const deadline = Date.now() + SHUTDOWN_TIMEOUT_MS
@@ -99,12 +106,31 @@ async function requestShutdownAndWait(): Promise<boolean> {
99
106
  await sleep(POLL_INTERVAL_MS)
100
107
  continue
101
108
  }
102
- if (!existsSync(socketPath())) return true
109
+ if (!existsSync(socketPath())) {
110
+ await reapLingeringDaemon(pid)
111
+ return true
112
+ }
103
113
  await sleep(POLL_INTERVAL_MS)
104
114
  }
105
115
  return false
106
116
  }
107
117
 
118
+ // The daemon unlinks its socket at the end of stop(), before exiting. A daemon
119
+ // that never makes it to exit (observed in the field: "stopping" logged, process
120
+ // alive for days) keeps its HTTP control port and renewal timers, so the fresh
121
+ // daemon falls back to another port and two daemons run against one home.
122
+ async function reapLingeringDaemon(pid: number): Promise<void> {
123
+ if (pid <= 0) return
124
+ if (await waitForExit(pid, SHUTDOWN_EXIT_GRACE_MS)) return
125
+ if (!(await isHostdProcess(pid))) return
126
+ const reaped = await terminateProcess(pid)
127
+ await appendSpawnLog(
128
+ reaped
129
+ ? `reaped host daemon pid ${pid} that acknowledged shutdown but did not exit`
130
+ : `host daemon pid ${pid} acknowledged shutdown but did not exit and could not be terminated`,
131
+ )
132
+ }
133
+
108
134
  type SpawnAttemptResult = { ok: true; pid: number; spawned: boolean; httpPort: number } | { ok: false; reason: string }
109
135
 
110
136
  async function spawnUnderLock(opts: EnsureDaemonOptions): Promise<SpawnAttemptResult> {
@@ -135,9 +161,18 @@ async function spawnUnderLock(opts: EnsureDaemonOptions): Promise<SpawnAttemptRe
135
161
  // adopt the existing child and poll IT for readiness instead of re-spawning.
136
162
  const existingPid = await livePidfileChild()
137
163
  if (existingPid !== null) {
138
- const ready = await pollForReadiness(opts.spawnTimeoutMs ?? DEFAULT_SPAWN_TIMEOUT_MS)
139
- if (ready === null) return { ok: false, reason: 'daemon spawned but did not become reachable yet' }
140
- return { ok: true, pid: existingPid, spawned: false, httpPort: ready }
164
+ if (!(await isWedgedDaemon(existingPid))) {
165
+ const ready = await pollForReadiness(opts.spawnTimeoutMs ?? DEFAULT_SPAWN_TIMEOUT_MS)
166
+ if (ready === null) return { ok: false, reason: 'daemon spawned but did not become reachable yet' }
167
+ return { ok: true, pid: existingPid, spawned: false, httpPort: ready }
168
+ }
169
+ // Adopting a wedged daemon would block every future start forever, so
170
+ // replace it. Only reached after isDaemonReachable() failed above.
171
+ if (!(await terminateProcess(existingPid))) {
172
+ await appendSpawnLog(`host daemon pid ${existingPid} is unresponsive and could not be terminated`)
173
+ return { ok: false, reason: `host daemon pid ${existingPid} is unresponsive and could not be terminated` }
174
+ }
175
+ await appendSpawnLog(`replaced unresponsive host daemon pid ${existingPid}`)
141
176
  }
142
177
  await opts.onSpawnEnter?.()
143
178
  return await spawnDaemonDetached(opts)
@@ -160,6 +195,72 @@ async function livePidfileChild(): Promise<number | null> {
160
195
  }
161
196
  }
162
197
 
198
+ async function isWedgedDaemon(pid: number): Promise<boolean> {
199
+ if (isWindows()) return false
200
+ let spawnedAtMs: number
201
+ try {
202
+ spawnedAtMs = (await stat(pidfilePath())).mtimeMs
203
+ } catch {
204
+ return false
205
+ }
206
+ if (Date.now() - spawnedAtMs < WEDGED_DAEMON_AGE_MS) return false
207
+ return isHostdProcess(pid)
208
+ }
209
+
210
+ // PID-reuse guard: a pidfile pid is only signalled when its full command line
211
+ // is exactly the three-token launch signature from spawnDaemonDetached — the
212
+ // bun executable, the typeclaw CLI entry, `_hostd` — so a recycled pid that
213
+ // mentions `_hostd`, or passes the whole signature as arguments to another
214
+ // program (`watch … pgrep -f bun …/cli/index.ts _hostd`), is never killed.
215
+ // Tokens are whitespace-free: `ps` joins argv with spaces, so a path containing
216
+ // spaces is ambiguous and fails closed (adopted, never signalled).
217
+ const HOSTD_COMMAND_SIGNATURE = /^(?:\S*\/)?bun \S*\/(?:cli\/index\.ts|typeclaw) _hostd$/
218
+
219
+ async function isHostdProcess(pid: number): Promise<boolean> {
220
+ if (isWindows()) return false
221
+ try {
222
+ const proc = Bun.spawn({
223
+ cmd: ['ps', '-o', 'command=', '-p', String(pid)],
224
+ stdin: 'ignore',
225
+ stdout: 'pipe',
226
+ stderr: 'ignore',
227
+ })
228
+ const out = await new Response(proc.stdout).text()
229
+ await proc.exited
230
+ return HOSTD_COMMAND_SIGNATURE.test(out.trim())
231
+ } catch {
232
+ return false
233
+ }
234
+ }
235
+
236
+ // SIGTERM first so a merely-hung event loop can still run its shutdown handler;
237
+ // SIGKILL for a process that can't (e.g. spinning inside a crash handler).
238
+ async function terminateProcess(pid: number): Promise<boolean> {
239
+ for (const signal of ['SIGTERM', 'SIGKILL'] as const) {
240
+ try {
241
+ process.kill(pid, signal)
242
+ } catch (error) {
243
+ if (errorCode(error) === 'ESRCH') return true
244
+ return false
245
+ }
246
+ if (await waitForExit(pid, KILL_GRACE_MS)) return true
247
+ }
248
+ return false
249
+ }
250
+
251
+ async function waitForExit(pid: number, timeoutMs: number): Promise<boolean> {
252
+ const deadline = Date.now() + timeoutMs
253
+ while (processExists(pid)) {
254
+ if (Date.now() >= deadline) return false
255
+ await sleep(POLL_INTERVAL_MS)
256
+ }
257
+ return true
258
+ }
259
+
260
+ async function appendSpawnLog(message: string): Promise<void> {
261
+ await appendFile(logfilePath(), `${new Date().toISOString()} [hostd-spawn] ${message}\n`).catch(() => {})
262
+ }
263
+
163
264
  async function pollForReadiness(timeoutMs: number): Promise<number | null> {
164
265
  const deadline = Date.now() + timeoutMs
165
266
  while (Date.now() < deadline) {
@@ -28,6 +28,11 @@ import { dirname, join, resolve, sep } from 'node:path'
28
28
  // callback in `src/cli/hostd.ts` reaches into `src/container/` and
29
29
  // `src/config/`). Over-respawning on `src/agent/` changes is acceptable
30
30
  // cost: a daemon spawn is < 100ms.
31
+ //
32
+ // The Bun runtime version is folded in too. The daemon keeps running on the
33
+ // binary it was spawned with, so after `bun upgrade` it would otherwise stay on
34
+ // the old runtime until killed by hand — and an old runtime crashing is exactly
35
+ // what took hostd down in the field.
31
36
 
32
37
  export type SourceVersion = string
33
38
 
@@ -38,6 +43,8 @@ export type ComputeOptions = {
38
43
  // Test seam. Tests inject an in-memory file map to keep the unit tests
39
44
  // hermetic; production reads the real filesystem.
40
45
  fs?: VersionFs
46
+ // Test seam: defaults to the Bun running this process.
47
+ runtimeVersion?: string
41
48
  }
42
49
 
43
50
  export type VersionFs = {
@@ -60,6 +67,7 @@ export async function computeSourceVersion(opts: ComputeOptions): Promise<Source
60
67
  files.sort()
61
68
 
62
69
  const hash = createHash('sha256')
70
+ hash.update(`bun:${opts.runtimeVersion ?? process.versions.bun ?? 'unknown'}\u0000`)
63
71
  for (const rel of files) {
64
72
  const abs = join(root, rel)
65
73
  const bytes = await fs.readFile(abs)
@@ -113,3 +121,15 @@ export function resolveSrcRoot(cliEntry: string): string | null {
113
121
  // preserves correctness for non-dev installs at the cost of disabling drift
114
122
  // detection there.
115
123
  export const UNVERSIONED_SENTINEL: SourceVersion = 'unversioned'
124
+
125
+ // The Bun that CI and the container base image (`BUN_BASE_IMAGE`) run. Bump it
126
+ // together with the `bun-version:` pins in .github/workflows/*.yml.
127
+ export const TESTED_BUN_VERSION = '1.4.0'
128
+
129
+ // The host daemon runs on the host's Bun, not the container's pinned one, so an
130
+ // operator can silently stay on a runtime CI never tested (Bun 1.3.14's
131
+ // segfault-then-wedge is what took a host daemon down for days).
132
+ export function hostBunVersionWarning(hostBunVersion: string | undefined): string | null {
133
+ if (!hostBunVersion || Bun.semver.order(hostBunVersion, TESTED_BUN_VERSION) >= 0) return null
134
+ return `host Bun ${hostBunVersion} is older than Bun ${TESTED_BUN_VERSION}, which typeclaw is tested on; older runtimes have known crash bugs that take the host daemon down. Run \`bun upgrade\`.`
135
+ }
@@ -0,0 +1,241 @@
1
+ // The host daemon is a single long-lived Bun process, and a runtime fault in it
2
+ // takes every host-side service down with it: credential renewal, the
3
+ // portbroker, container self-restart. Worse, Bun's crash handler can wedge
4
+ // instead of exiting (observed in the field: a segfault left the process
5
+ // spinning at 100% CPU for days, holding the pidfile). Nothing re-spawned it
6
+ // until an operator happened to run a host CLI command.
7
+ //
8
+ // So `_hostd` is a thin parent that runs the real daemon as a child and keeps
9
+ // it alive: a child that exits non-zero is respawned, and a child that stops
10
+ // answering its control socket is SIGKILLed and respawned. The parent does
11
+ // nothing but spawn, probe, and kill, which keeps it off the fetch/WebSocket/
12
+ // timer-heavy paths where the runtime faults have been observed.
13
+ //
14
+ // A clean (code 0) child exit is an intentional shutdown — the version-drift
15
+ // `shutdown` RPC or SIGTERM — so the parent exits with it and the next CLI call
16
+ // respawns the pair, exactly as before the watchdog existed.
17
+
18
+ export type WatchdogWorkerExit = { code: number | null; signal: string | null }
19
+
20
+ export type WatchdogWorker = {
21
+ pid: number
22
+ exited: Promise<WatchdogWorkerExit>
23
+ kill: (signal: NodeJS.Signals) => void
24
+ }
25
+
26
+ export type WatchdogOptions = {
27
+ spawnWorker: () => WatchdogWorker
28
+ probe: () => Promise<boolean>
29
+ onLog: (message: string) => void
30
+ probeIntervalMs?: number
31
+ // A freshly spawned child needs time to bind its socket; probe misses inside
32
+ // this window don't count unless the child has already answered once.
33
+ startupGraceMs?: number
34
+ maxMisses?: number
35
+ initialBackoffMs?: number
36
+ maxBackoffMs?: number
37
+ // A child that stayed up this long was healthy, so the next respawn starts
38
+ // from the initial backoff again instead of the crash-loop ceiling.
39
+ healthyResetMs?: number
40
+ // `spawn.ts` escalates SIGTERM to SIGKILL on this parent after 2s, so the
41
+ // child must be forced down inside that window or it outlives the parent.
42
+ stopGraceMs?: number
43
+ }
44
+
45
+ export type Watchdog = {
46
+ done: Promise<number>
47
+ stop: () => Promise<void>
48
+ }
49
+
50
+ const DEFAULT_PROBE_INTERVAL_MS = 10_000
51
+ const DEFAULT_STARTUP_GRACE_MS = 30_000
52
+ const DEFAULT_MAX_MISSES = 3
53
+ const DEFAULT_INITIAL_BACKOFF_MS = 1_000
54
+ const DEFAULT_MAX_BACKOFF_MS = 60_000
55
+ const DEFAULT_HEALTHY_RESET_MS = 5 * 60_000
56
+ const DEFAULT_STOP_GRACE_MS = 1_500
57
+ const KILL_WAIT_MS = 5_000
58
+
59
+ type SuperviseOutcome =
60
+ | { kind: 'stopped' }
61
+ | { kind: 'exited'; exit: WatchdogWorkerExit }
62
+ | { kind: 'unresponsive'; misses: number }
63
+
64
+ export function runWatchdog(opts: WatchdogOptions): Watchdog {
65
+ const probeIntervalMs = opts.probeIntervalMs ?? DEFAULT_PROBE_INTERVAL_MS
66
+ const startupGraceMs = opts.startupGraceMs ?? DEFAULT_STARTUP_GRACE_MS
67
+ const maxMisses = opts.maxMisses ?? DEFAULT_MAX_MISSES
68
+ const initialBackoffMs = opts.initialBackoffMs ?? DEFAULT_INITIAL_BACKOFF_MS
69
+ const maxBackoffMs = opts.maxBackoffMs ?? DEFAULT_MAX_BACKOFF_MS
70
+ const healthyResetMs = opts.healthyResetMs ?? DEFAULT_HEALTHY_RESET_MS
71
+ const stopGraceMs = opts.stopGraceMs ?? DEFAULT_STOP_GRACE_MS
72
+ const log = opts.onLog
73
+
74
+ let stopping = false
75
+ let resolveStop: () => void = () => {}
76
+ const stopRequested = new Promise<'stop'>((resolve) => {
77
+ resolveStop = () => resolve('stop')
78
+ })
79
+
80
+ const done = (async (): Promise<number> => {
81
+ let backoffMs = initialBackoffMs
82
+ while (!stopping) {
83
+ const startedAt = Date.now()
84
+ let worker: WatchdogWorker
85
+ try {
86
+ worker = opts.spawnWorker()
87
+ } catch (error) {
88
+ log(`failed to spawn host daemon worker: ${error instanceof Error ? error.message : String(error)}`)
89
+ if (await sleepOrStop(backoffMs)) break
90
+ backoffMs = Math.min(backoffMs * 2, maxBackoffMs)
91
+ continue
92
+ }
93
+ log(`started host daemon worker pid ${worker.pid}`)
94
+
95
+ const outcome = await supervise(worker)
96
+ if (outcome.kind === 'stopped') break
97
+ if (outcome.kind === 'exited' && outcome.exit.code === 0) {
98
+ log(`host daemon worker pid ${worker.pid} exited cleanly; watchdog exiting`)
99
+ return 0
100
+ }
101
+
102
+ if (Date.now() - startedAt >= healthyResetMs) backoffMs = initialBackoffMs
103
+ const reason =
104
+ outcome.kind === 'exited'
105
+ ? `exited unexpectedly (${describeExit(outcome.exit)})`
106
+ : `stopped answering its control socket (${outcome.misses} missed probes) and was killed`
107
+ log(`host daemon worker pid ${worker.pid} ${reason}; respawning in ${backoffMs}ms`)
108
+ if (await sleepOrStop(backoffMs)) break
109
+ backoffMs = Math.min(backoffMs * 2, maxBackoffMs)
110
+ }
111
+ return 0
112
+ })()
113
+
114
+ return {
115
+ done,
116
+ stop: async () => {
117
+ stopping = true
118
+ resolveStop()
119
+ await done
120
+ },
121
+ }
122
+
123
+ async function supervise(worker: WatchdogWorker): Promise<SuperviseOutcome> {
124
+ const spawnedAt = Date.now()
125
+ const exit = worker.exited.then((result) => ({ kind: 'exit' as const, result }))
126
+ let answeredOnce = false
127
+ let misses = 0
128
+
129
+ while (true) {
130
+ const wake = await Promise.race([exit, stopRequested, sleep(probeIntervalMs).then(() => 'tick' as const)])
131
+ if (wake === 'stop') {
132
+ await terminate(worker, exit)
133
+ return { kind: 'stopped' }
134
+ }
135
+ if (wake !== 'tick') return { kind: 'exited', exit: wake.result }
136
+
137
+ // A stalled probe can take its full timeout; stop must not wait it out,
138
+ // or spawn.ts SIGKILLs this parent before the worker is down.
139
+ const answered = await Promise.race([opts.probe().catch(() => false), exit.then(() => null), stopRequested])
140
+ if (answered === 'stop') {
141
+ await terminate(worker, exit)
142
+ return { kind: 'stopped' }
143
+ }
144
+ if (answered === null) continue
145
+ if (answered) {
146
+ answeredOnce = true
147
+ misses = 0
148
+ continue
149
+ }
150
+ if (!answeredOnce && Date.now() - spawnedAt < startupGraceMs) continue
151
+ misses += 1
152
+ if (misses < maxMisses) continue
153
+
154
+ // A wedged Bun crash handler does not run signal handlers, so SIGTERM
155
+ // would just burn the wait; go straight to SIGKILL.
156
+ worker.kill('SIGKILL')
157
+ if ((await Promise.race([exit, sleep(KILL_WAIT_MS).then(() => 'timeout' as const)])) === 'timeout') {
158
+ log(`host daemon worker pid ${worker.pid} did not exit after SIGKILL; respawning anyway`)
159
+ }
160
+ return { kind: 'unresponsive', misses }
161
+ }
162
+ }
163
+
164
+ async function terminate(worker: WatchdogWorker, exit: Promise<unknown>): Promise<void> {
165
+ worker.kill('SIGTERM')
166
+ if ((await Promise.race([exit, sleep(stopGraceMs).then(() => 'timeout' as const)])) !== 'timeout') return
167
+ worker.kill('SIGKILL')
168
+ await Promise.race([exit, sleep(KILL_WAIT_MS)])
169
+ }
170
+
171
+ async function sleepOrStop(ms: number): Promise<boolean> {
172
+ return (await Promise.race([stopRequested, sleep(ms).then(() => 'slept' as const)])) === 'stop'
173
+ }
174
+ }
175
+
176
+ export type OrphanWatchOptions = {
177
+ // Passed from the parent rather than read from `process.ppid` at startup: a
178
+ // parent that dies before the worker finishes loading would otherwise be
179
+ // captured as the already-reparented pid and never noticed.
180
+ watchdogPid: number
181
+ onOrphaned: () => void
182
+ getParentPid?: () => number
183
+ exit?: (code: number) => void
184
+ intervalMs?: number
185
+ // Graceful shutdown awaits restore and renewal drains with no deadline of
186
+ // their own, and no supervisor is left to force it, so cap it here.
187
+ exitDeadlineMs?: number
188
+ }
189
+
190
+ const DEFAULT_ORPHAN_CHECK_INTERVAL_MS = 2_000
191
+ const DEFAULT_ORPHAN_EXIT_DEADLINE_MS = 3_000
192
+
193
+ // A worker whose watchdog parent was SIGKILLed would keep the socket and
194
+ // renewal timers alive with no pidfile pointing at it, so the next CLI call
195
+ // could neither reach a fresh daemon nor reap this one. Exits within
196
+ // intervalMs + exitDeadlineMs of the parent dying.
197
+ export function watchForOrphaning(opts: OrphanWatchOptions): () => void {
198
+ const getParentPid = opts.getParentPid ?? (() => process.ppid)
199
+ const exit = opts.exit ?? ((code: number) => process.exit(code))
200
+ const exitDeadlineMs = opts.exitDeadlineMs ?? DEFAULT_ORPHAN_EXIT_DEADLINE_MS
201
+ let interval: ReturnType<typeof setInterval> | undefined
202
+
203
+ const check = (): boolean => {
204
+ if (getParentPid() === opts.watchdogPid) return false
205
+ if (interval) clearInterval(interval)
206
+ setTimeout(() => exit(1), exitDeadlineMs)
207
+ opts.onOrphaned()
208
+ return true
209
+ }
210
+
211
+ if (check()) return () => {}
212
+ interval = setInterval(check, opts.intervalMs ?? DEFAULT_ORPHAN_CHECK_INTERVAL_MS)
213
+ interval.unref()
214
+ return () => clearInterval(interval)
215
+ }
216
+
217
+ export function spawnProcessWorker(cmd: string[]): WatchdogWorker {
218
+ const proc = Bun.spawn({
219
+ cmd,
220
+ stdin: 'ignore',
221
+ stdout: 'inherit',
222
+ stderr: 'inherit',
223
+ env: { ...process.env },
224
+ })
225
+ return {
226
+ pid: proc.pid,
227
+ exited: proc.exited.then(() => ({ code: proc.exitCode, signal: proc.signalCode })),
228
+ kill: (signal) => {
229
+ if (proc.exitCode === null && proc.signalCode === null) proc.kill(signal)
230
+ },
231
+ }
232
+ }
233
+
234
+ function describeExit(exit: WatchdogWorkerExit): string {
235
+ if (exit.signal) return `signal ${exit.signal}`
236
+ return `code ${exit.code}`
237
+ }
238
+
239
+ function sleep(ms: number): Promise<void> {
240
+ return new Promise((resolve) => setTimeout(resolve, ms))
241
+ }
@@ -141,8 +141,14 @@ export function outcomeForcesInstall(outcome: AutoUpgradeOutcome): boolean {
141
141
  // (file deps don't "update"), NOT the `bun update --latest` path above — and it
142
142
  // skips version verification, since a local install's version is whatever the
143
143
  // checkout declares. start.ts ORs this into its ensureDeps force flag.
144
+ //
145
+ // Leaving a local spec for a registry range needs the same force: `bun update
146
+ // --latest` rewrites bun.lock but keeps the local copy in node_modules when its
147
+ // version already satisfies the range, so the agent would keep running the
148
+ // checkout's code.
144
149
  export function outcomeRequiresForceInstall(outcome: AutoUpgradeOutcome): boolean {
145
- return outcome.kind === 'relinked-to-local'
150
+ if (outcome.kind === 'relinked-to-local') return true
151
+ return outcome.kind === 'spec-rewritten' && (outcome.from.startsWith('file:') || outcome.from.startsWith('link:'))
146
152
  }
147
153
 
148
154
  // The version we expect to find in node_modules/typeclaw after the