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
@@ -20,7 +20,12 @@ export {
20
20
  type PrVerdictActivityBridge,
21
21
  type PrVerdictActivityBridgeOptions,
22
22
  } from './pr-verdict-activity-bridge'
23
- export { setReviewObserver, setReviewOutputObserver, type ReviewOutputState } from './github-review-turn-ledger'
23
+ export {
24
+ setReviewObserver,
25
+ setReviewOutputObserver,
26
+ setReviewCoverageCapture,
27
+ type ReviewOutputState,
28
+ } from './github-review-turn-ledger'
24
29
  export {
25
30
  createSubagentCompletionBridge,
26
31
  type SubagentCompletionBridge,
@@ -0,0 +1,34 @@
1
+ import { randomUUID } from 'node:crypto'
2
+ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises'
3
+ import { join } from 'node:path'
4
+
5
+ import { z } from 'zod'
6
+
7
+ import type { AdapterId } from './schema'
8
+
9
+ const markerSchema = z.object({ at: z.number().finite() })
10
+
11
+ export async function readLastAlive(agentDir: string, adapter: AdapterId): Promise<number | null> {
12
+ const dir = join(agentDir, 'channels')
13
+ const paths = [join(dir, `${adapter}-catch-up-last-alive.json`)]
14
+ if (adapter === 'github') paths.push(join(dir, 'github-last-alive.json'))
15
+ for (const path of paths) {
16
+ try {
17
+ const marker = markerSchema.safeParse(JSON.parse(await readFile(path, 'utf8')))
18
+ if (marker.success) return marker.data.at
19
+ } catch (error) {
20
+ if (!(error instanceof SyntaxError) && !(error instanceof Error && 'code' in error && error.code === 'ENOENT'))
21
+ throw error
22
+ }
23
+ }
24
+ return null
25
+ }
26
+
27
+ export async function writeLastAlive(agentDir: string, adapter: AdapterId, at: number): Promise<void> {
28
+ const dir = join(agentDir, 'channels')
29
+ await mkdir(dir, { recursive: true })
30
+ const path = join(dir, `${adapter}-catch-up-last-alive.json`)
31
+ const tmp = `${path}.${randomUUID()}.tmp`
32
+ await writeFile(tmp, JSON.stringify({ at }))
33
+ await rename(tmp, path)
34
+ }
@@ -21,18 +21,22 @@ import { createInstagramAdapter, type InstagramAdapter } from './adapters/instag
21
21
  import { createKakaotalkAdapter, type KakaotalkAdapter } from './adapters/kakaotalk'
22
22
  import { createLineAdapter, type LineAdapter } from './adapters/line'
23
23
  import { createSlackAdapter, type SlackAdapter } from './adapters/slack'
24
- import { createSlackBotAdapter, type SlackBotAdapter } from './adapters/slack-bot'
24
+ import { createSlackBotAdapter, type SlackBotAdapter, type SlackMessageObserver } from './adapters/slack-bot'
25
25
  import { createTeamsAdapter, type TeamsAdapter } from './adapters/teams'
26
26
  import { createTelegramBotAdapter, type TelegramBotAdapter } from './adapters/telegram-bot'
27
27
  import { createWebexAdapter, type WebexAdapter } from './adapters/webex'
28
28
  import { createWebexBotAdapter, type WebexBotAdapter } from './adapters/webex-bot'
29
+ import type { BackgroundObligationStore } from './background-obligations'
29
30
  import { describeError } from './describe-error'
30
31
  import type { GithubTokenBridge } from './github-token-bridge'
32
+ import type { InboundJournal } from './inbound-journal'
33
+ import type { RecoveryOutbox } from './recovery-outbox'
31
34
  import {
32
35
  createChannelRouter,
33
36
  type ChannelRouter,
34
37
  type ClaimHandler,
35
38
  type CreateSessionForChannel,
39
+ type ChannelOutboundReviewer,
36
40
  type RestartCommandContext,
37
41
  } from './router'
38
42
  import {
@@ -58,6 +62,7 @@ const consoleLogger: ChannelManagerLogger = {
58
62
  export type ChannelManagerOptions = {
59
63
  agentDir: string
60
64
  channelsConfigRef: () => ChannelsConfig
65
+ onRecoveryReady?: () => void
61
66
  // Plain-text names the agent answers to in channel engagement (the
62
67
  // `alias` field in `typeclaw.json`), forwarded to the router as
63
68
  // `configuredAliases`. Read live on every inbound so an `applied`-class
@@ -84,6 +89,9 @@ export type ChannelManagerOptions = {
84
89
  // cannot reply, which is fine for tests but a bug in production. See
85
90
  // src/run/index.ts where this is wired.
86
91
  createSessionForChannel?: CreateSessionForChannel
92
+ slackBotMessageObserver?: SlackMessageObserver
93
+ outboundReviewer?: ChannelOutboundReviewer
94
+ outboundReviewerActive?: () => boolean
87
95
  // Test seams: let fake adapters replace the real adapter wiring per id.
88
96
  createDiscordAdapter?: typeof createDiscordBotAdapter
89
97
  createDiscordUserAdapter?: typeof createDiscordAdapter
@@ -97,6 +105,9 @@ export type ChannelManagerOptions = {
97
105
  createTelegramAdapter?: typeof createTelegramBotAdapter
98
106
  createWebexAdapter?: typeof createWebexAdapter
99
107
  createWebexBotAdapter?: typeof createWebexBotAdapter
108
+ backgroundObligations?: BackgroundObligationStore
109
+ inboundJournal?: InboundJournal
110
+ recoveryOutbox?: RecoveryOutbox
100
111
  // Wake-up gate: forwarded to the router, which calls
101
112
  // `permissions.has(origin, 'channel.respond')` BEFORE creating a
102
113
  // session for any inbound. Optional here to keep direct manager-level
@@ -135,10 +146,6 @@ export type ChannelManagerOptions = {
135
146
  // otherwise spawn a duplicate child). Production wiring (src/run/index.ts)
136
147
  // supplies it from the LiveSubagentRegistry; tests omit it.
137
148
  newestRunningChildSubagentStartedAt?: (sessionId: string) => number | null
138
- // Forwarded to the router so the graceful-restart handoff can name the
139
- // background subagents a session was still awaiting. Same wiring shape as
140
- // newestRunningChildSubagentStartedAt; tests omit it.
141
- listRunningBackgroundSubagentNames?: (sessionId: string) => string[]
142
149
  // Forwarded to the router so an adapter-triggered work invalidation can stop
143
150
  // independent background sessions that a parent AgentSession abort cannot reach.
144
151
  cancelRunningSubagentsByWorkKey?: (
@@ -249,6 +256,9 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
249
256
  const env = options.env ?? process.env
250
257
  const router = createChannelRouter({
251
258
  agentDir: options.agentDir,
259
+ ...(options.backgroundObligations ? { backgroundObligations: options.backgroundObligations } : {}),
260
+ ...(options.inboundJournal ? { inboundJournal: options.inboundJournal } : {}),
261
+ ...(options.recoveryOutbox ? { recoveryOutbox: options.recoveryOutbox } : {}),
252
262
  configForAdapter: (adapter) => options.channelsConfigRef()[adapter],
253
263
  logger,
254
264
  ...(options.aliasesRef ? { configuredAliases: options.aliasesRef } : {}),
@@ -261,12 +271,11 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
261
271
  ...(options.newestRunningChildSubagentStartedAt
262
272
  ? { newestRunningChildSubagentStartedAt: options.newestRunningChildSubagentStartedAt }
263
273
  : {}),
264
- ...(options.listRunningBackgroundSubagentNames
265
- ? { listRunningBackgroundSubagentNames: options.listRunningBackgroundSubagentNames }
266
- : {}),
267
274
  ...(options.cancelRunningSubagentsByWorkKey
268
275
  ? { cancelRunningSubagentsByWorkKey: options.cancelRunningSubagentsByWorkKey }
269
276
  : {}),
277
+ ...(options.outboundReviewer ? { reviewOutbound: options.outboundReviewer } : {}),
278
+ ...(options.outboundReviewerActive ? { outboundReviewerActive: options.outboundReviewerActive } : {}),
270
279
  })
271
280
  const createDiscordBot = options.createDiscordAdapter ?? createDiscordBotAdapter
272
281
  const createDiscordUser = options.createDiscordUserAdapter ?? createDiscordAdapter
@@ -351,6 +360,7 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
351
360
  appToken,
352
361
  logger,
353
362
  selfAliasesRef: () => router.getSelfAliases(),
363
+ ...(options.slackBotMessageObserver ? { messageObserver: options.slackBotMessageObserver } : {}),
354
364
  })
355
365
  }
356
366
  if (name === 'line') {
@@ -528,6 +538,7 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
528
538
  recoveryRestartAttempts: 0,
529
539
  recoveryRestartQueued: false,
530
540
  })
541
+ options.onRecoveryReady?.()
531
542
  return { status: 'started' }
532
543
  } catch (err) {
533
544
  await cleanupPartialStart(adapter)
@@ -735,6 +746,11 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
735
746
  const now = recoveryNow()
736
747
  for (const [name, entry] of live) {
737
748
  if (entry.adapter.isConnected()) {
749
+ void router
750
+ .recoverWaitingReactions(name)
751
+ .catch((err) =>
752
+ logger.warn(`[channels] waiting reaction cleanup failed adapter="${name}": ${describeError(err)}`),
753
+ )
738
754
  entry.disconnectedSinceMs = null
739
755
  entry.nextRecoveryRestartAtMs = null
740
756
  entry.recoveryRestartAttempts = 0
@@ -1028,6 +1044,7 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
1028
1044
  }
1029
1045
  }
1030
1046
 
1047
+ options.onRecoveryReady?.()
1031
1048
  return { started, stopped, restarted, restartRequired, ...(credentialApply ? { credentialApply } : {}) }
1032
1049
  },
1033
1050
  }
@@ -0,0 +1,264 @@
1
+ import type { BackgroundObligationStore } from './background-obligations'
2
+ import type { RecoveryRecord } from './continuity-types'
3
+ import type { InboundJournal } from './inbound-journal'
4
+ import type { RecoveryOutbox } from './recovery-outbox'
5
+ import type { ChannelRouter } from './router'
6
+ import { channelKeyId, type ChannelKey, type RecoveryRedelivery } from './types'
7
+
8
+ // Bounds how long a restart notice waits for an adapter still deciding whether it re-admitted the
9
+ // interrupted work (GitHub's boot reconcile pass), so a stuck pass delays the notice, never loses it.
10
+ const REDELIVERY_WAIT_MS = 5 * 60_000
11
+
12
+ /** Transport-only recovery; each destination progresses independently. */
13
+ export class RecoveryDispatcher {
14
+ private readonly lanes = new Map<string, Promise<void>>()
15
+ private timer: NodeJS.Timeout | undefined
16
+ private stopped = false
17
+ /** Set by the first (boot) wake; imports never dispatch before adapters are ready. */
18
+ private woken = false
19
+ private readonly unsubscribe: () => void
20
+ /** Destinations whose due work was skipped while an earlier pass still held their lane. */
21
+ private readonly deferred = new Set<string>()
22
+
23
+ constructor(
24
+ private readonly outbox: RecoveryOutbox,
25
+ private readonly router: ChannelRouter,
26
+ private readonly options: {
27
+ now?: () => number
28
+ consistencyDelayMs?: number
29
+ onError?: (error: unknown) => void
30
+ backgroundObligations?: BackgroundObligationStore
31
+ inboundJournal?: InboundJournal
32
+ } = {},
33
+ ) {
34
+ router.setRecoveryStopHandler((target, parent) => this.suppressParent(target, parent))
35
+ // A transfer made durable after boot (a live turn that ended unanswered) dispatches now
36
+ // instead of at the next poll; multiple imports in one tick coalesce into one wake.
37
+ this.unsubscribe = outbox.subscribe(() => {
38
+ if (!this.woken || this.stopped) return
39
+ clearTimeout(this.timer)
40
+ this.timer = undefined
41
+ this.schedule(0)
42
+ })
43
+ }
44
+
45
+ private async validateCoverageInLane(record: RecoveryRecord): Promise<'open' | 'resolved'> {
46
+ if (record.covers.some((cover) => cover.store === 'inbound')) {
47
+ if (!this.options.inboundJournal) throw new Error('Inbound recovery requires journal authority')
48
+ return this.options.inboundJournal.validateNotice(record)
49
+ }
50
+ if (record.covers.some((cover) => cover.store === 'background')) {
51
+ this.options.inboundJournal?.assertAvailable()
52
+ if (!this.options.backgroundObligations) throw new Error('Background recovery requires source authority')
53
+ this.options.backgroundObligations.assertAvailable()
54
+ }
55
+ return this.options.backgroundObligations?.validateNotice(record) ?? 'open'
56
+ }
57
+
58
+ private async acknowledge(record: RecoveryRecord): Promise<void> {
59
+ if (record.covers.some((cover) => cover.store === 'inbound')) {
60
+ const journal = this.options.inboundJournal
61
+ if (!journal) throw new Error('Inbound recovery requires journal authority')
62
+ if (this.options.backgroundObligations)
63
+ await this.options.backgroundObligations.withTargetLane(record.target, () => journal.acknowledgeNotice(record))
64
+ else await journal.acknowledgeNotice(record)
65
+ return
66
+ }
67
+ const source = this.options.backgroundObligations
68
+ if (!source) return
69
+ if (record.covers.some((cover) => cover.store === 'background')) {
70
+ await source.withTargetLane(record.target, () => source.acknowledgeNotice(record))
71
+ } else {
72
+ // Legacy upgrade receipts have immutable inventory-only provenance.
73
+ await source.acknowledgeNotice(record)
74
+ }
75
+ }
76
+
77
+ /**
78
+ * Source acknowledgment, then retirement of the terminal outbox record. Retirement requires the
79
+ * source to validate the delivery as resolved in its lane, so no open or re-importable coverage
80
+ * can still point at it; the outbox keeps an immutable fence for any later identical import.
81
+ */
82
+ private async finish(record: RecoveryRecord, retire: boolean): Promise<void> {
83
+ await this.acknowledge(record)
84
+ if (!retire) return
85
+ const source = this.options.backgroundObligations
86
+ const coverage =
87
+ source && record.covers.some((cover) => cover.store !== 'inventory')
88
+ ? await source.withTargetLane(record.target, () => this.validateCoverageInLane(record))
89
+ : await this.validateCoverageInLane(record)
90
+ if (coverage === 'resolved') await this.outbox.retire(record.deliveryId, record.generation)
91
+ }
92
+
93
+ async wake(): Promise<void> {
94
+ if (this.stopped) return
95
+ this.woken = true
96
+ clearTimeout(this.timer)
97
+ this.timer = undefined
98
+ const now = this.options.now?.() ?? Date.now()
99
+ let next = now + 30_000
100
+ const started = new Set<string>()
101
+ for (const record of await this.outbox.list()) {
102
+ const key = channelKeyId(record.target)
103
+ if (record.state === 'delivered' || record.state === 'suppressed') {
104
+ // A lane from an earlier pass may still hold this record's in-flight send (a /stop raced
105
+ // it), so it is retired on a later pass. A lane started by this pass skips terminal records.
106
+ await this.finish(record, !this.lanes.has(key) || started.has(key)).catch((error) =>
107
+ this.options.onError?.(error),
108
+ )
109
+ continue
110
+ }
111
+ const due = record.nextAttemptAt ?? 0
112
+ if (due > now) {
113
+ next = Math.min(next, due)
114
+ continue
115
+ }
116
+ if (this.lanes.has(key)) {
117
+ // That lane listed the outbox before this record was due or existed; run again after it.
118
+ if (!started.has(key)) this.deferred.add(key)
119
+ continue
120
+ }
121
+ started.add(key)
122
+ const lane = this.dispatchTarget(key)
123
+ .catch((error) => this.options.onError?.(error))
124
+ .finally(() => {
125
+ this.lanes.delete(key)
126
+ if (this.deferred.delete(key)) {
127
+ clearTimeout(this.timer)
128
+ this.timer = undefined
129
+ this.schedule(0)
130
+ } else this.schedule(30_000)
131
+ })
132
+ this.lanes.set(key, lane)
133
+ }
134
+ this.schedule(Math.max(10, next - now))
135
+ }
136
+
137
+ private schedule(delay: number): void {
138
+ if (this.stopped || this.timer) return
139
+ this.timer = setTimeout(() => {
140
+ this.timer = undefined
141
+ void this.wake().catch((error) => this.options.onError?.(error))
142
+ }, delay)
143
+ this.timer.unref?.()
144
+ }
145
+ private async acquire(record: RecoveryRecord) {
146
+ const claim = async () => {
147
+ if ((await this.validateCoverageInLane(record)) === 'resolved') return undefined
148
+ if (record.lease?.epoch === this.outbox.epoch) {
149
+ return (await this.outbox.repairLease(record.deliveryId, record.lease)) ? record.lease : undefined
150
+ }
151
+ return this.outbox.lease(record.deliveryId, record.generation)
152
+ }
153
+ try {
154
+ const source = this.options.backgroundObligations
155
+ return source && record.covers.some((cover) => cover.store !== 'inventory')
156
+ ? await source.withTargetLane(record.target, claim)
157
+ : await claim()
158
+ } catch (error) {
159
+ this.options.onError?.(error)
160
+ return undefined
161
+ }
162
+ }
163
+
164
+ private async dispatchTarget(key: string): Promise<void> {
165
+ // One pass per wake avoids a blocked destination starving another record.
166
+ for (const snapshot of await this.outbox.list()) {
167
+ if (channelKeyId(snapshot.target) !== key || this.stopped) continue
168
+ const record = await this.outbox.get(snapshot.deliveryId)
169
+ const now = this.options.now?.() ?? Date.now()
170
+ if (!record || record.state === 'delivered' || record.state === 'suppressed' || (record.nextAttemptAt ?? 0) > now)
171
+ continue
172
+ try {
173
+ const source = this.options.backgroundObligations
174
+ const coverage =
175
+ source && record.covers.some((cover) => cover.store !== 'inventory')
176
+ ? await source.withTargetLane(record.target, () => this.validateCoverageInLane(record!))
177
+ : await this.validateCoverageInLane(record)
178
+ if (coverage === 'resolved') {
179
+ await this.outbox.suppress(record.deliveryId, 'coverage-resolved', crypto.randomUUID())
180
+ continue
181
+ }
182
+ const redelivery = this.redelivery(record, now)
183
+ if (redelivery === 'pending') continue
184
+ if (redelivery === 'redelivered' && this.options.inboundJournal) {
185
+ await this.suppressRedelivered(record, this.options.inboundJournal)
186
+ continue
187
+ }
188
+ // Runtime state (restarts, ended turns) is never posted to channel users; the operator log
189
+ // carries it instead. Closing the coverage keeps boot recovery from re-importing it.
190
+ await this.suppressRecord(record, 'operator-log-only', crypto.randomUUID())
191
+ console.log(
192
+ `[channels] interrupted request in ${key} not re-answered (${record.cause ?? 'restart'}); no notice posted to the channel`,
193
+ )
194
+ } catch (error) {
195
+ this.options.onError?.(error)
196
+ continue
197
+ }
198
+ }
199
+ }
200
+
201
+ /** Only a never-attempted restart notice over inbound rows can be superseded by adapter redelivery. */
202
+ private redelivery(record: RecoveryRecord, now: number): RecoveryRedelivery {
203
+ const journal = this.options.inboundJournal
204
+ if (!journal || record.cause !== undefined || record.attempts > 0 || !this.router.recoveryRedelivery)
205
+ return 'not-redelivered'
206
+ const eventKinds = journal.noticeEventKinds(record)
207
+ if (!eventKinds) return 'not-redelivered'
208
+ const answer = this.router.recoveryRedelivery(record, eventKinds)
209
+ return answer === 'pending' && now - record.createdAt >= REDELIVERY_WAIT_MS ? 'not-redelivered' : answer
210
+ }
211
+
212
+ private async suppressRedelivered(record: RecoveryRecord, journal: InboundJournal): Promise<void> {
213
+ const decisionId = crypto.randomUUID()
214
+ const suppress = () => journal.suppressNoticeCoverage(record, { decisionId, reason: 'adapter-redelivered' })
215
+ const source = this.options.backgroundObligations
216
+ if (source) await source.withTargetLane(record.target, suppress)
217
+ else await suppress()
218
+ await this.outbox.suppress(record.deliveryId, 'adapter-redelivered', decisionId)
219
+ }
220
+
221
+ async suppressParent(target: ChannelKey, parentSessionId: string): Promise<void> {
222
+ const parentDecisionId = crypto.randomUUID()
223
+ for (const record of await this.outbox.list()) {
224
+ if (channelKeyId(record.target) !== channelKeyId(target)) continue
225
+ if (
226
+ record.sourceParentSessionId === parentSessionId ||
227
+ (record.covers.length > 0 && record.covers.every((coverage) => coverage.parentSessionId === parentSessionId))
228
+ ) {
229
+ await this.suppressRecord(record, 'user-stop', `${parentDecisionId}:${record.deliveryId}`, 'user_stop')
230
+ }
231
+ }
232
+ }
233
+
234
+ private async suppressRecord(
235
+ record: RecoveryRecord,
236
+ reason: string,
237
+ decisionId: string,
238
+ outboxReason = reason,
239
+ ): Promise<void> {
240
+ const source = this.options.backgroundObligations
241
+ const suppress = async () => {
242
+ if (record.covers.some((cover) => cover.store === 'inbound')) {
243
+ if (!this.options.inboundJournal) throw new Error('Inbound recovery requires journal authority')
244
+ await this.options.inboundJournal.suppressNoticeCoverage(record, { decisionId, reason })
245
+ } else if (source) {
246
+ if (record.covers.some((cover) => cover.store === 'background')) this.options.inboundJournal?.assertAvailable()
247
+ await source.suppressNoticeCoverage(record, { decisionId, reason })
248
+ }
249
+ }
250
+ if (source && record.covers.some((cover) => cover.store !== 'inventory'))
251
+ await source.withTargetLane(record.target, suppress)
252
+ else await suppress()
253
+ await this.outbox.suppress(record.deliveryId, outboxReason, decisionId)
254
+ }
255
+
256
+ async stop(): Promise<void> {
257
+ this.stopped = true
258
+ this.unsubscribe()
259
+ clearTimeout(this.timer)
260
+ this.timer = undefined
261
+ await Promise.all(this.lanes.values())
262
+ await this.outbox.flush()
263
+ }
264
+ }
@@ -0,0 +1,94 @@
1
+ import type { MatchableOrigin } from '../permissions/resolve'
2
+ import {
3
+ LIVE_TURN_ENDED_NOTICE_TEXT,
4
+ parseRecoveryRecord,
5
+ RECOVERY_NOTICE_TEXT,
6
+ recoveryDeliveryId,
7
+ } from './continuity-types'
8
+ import type { RecoveryNoticeCause, RecoveryRecord } from './continuity-types'
9
+ import { channelKeyId } from './types'
10
+ import type { ChannelKey } from './types'
11
+
12
+ const canonicalPrincipal = (principal: MatchableOrigin) =>
13
+ Object.entries(principal)
14
+ .filter(([, value]) => value !== undefined)
15
+ .sort(([left], [right]) => left.localeCompare(right))
16
+
17
+ /** Frozen principals compare by content; persisted key order is a serialization detail. */
18
+ export function sameRecoveryPrincipal(left: MatchableOrigin, right: MatchableOrigin): boolean {
19
+ return JSON.stringify(canonicalPrincipal(left)) === JSON.stringify(canonicalPrincipal(right))
20
+ }
21
+
22
+ /**
23
+ * One interruption notice may cover only sources sharing destination, authenticated account,
24
+ * frozen principal and captured effective parent (the `/stop` authority). Chat, text, turn
25
+ * timing, the current mapping and the current adapter account are never grouping evidence.
26
+ */
27
+ export function recoveryNoticePartitionKey(input: {
28
+ target: ChannelKey
29
+ accountIdentity: string
30
+ principal: MatchableOrigin
31
+ parentSessionId?: string
32
+ }): string {
33
+ return JSON.stringify([
34
+ channelKeyId(input.target),
35
+ input.accountIdentity,
36
+ canonicalPrincipal(input.principal),
37
+ input.parentSessionId ?? null,
38
+ ])
39
+ }
40
+
41
+ /**
42
+ * Freezes a transfer at preparation. `restart` (the default) is the RFC en/v1 boot-recovery
43
+ * notice, byte- and ID-identical to every record written before causes existed. Same-process
44
+ * abandonment passes `live-turn-ended`, which never asserts a restart.
45
+ */
46
+ export function createRecoveryNotice(
47
+ input: Pick<
48
+ RecoveryRecord,
49
+ | 'target'
50
+ | 'accountIdentity'
51
+ | 'accountIdentityConflict'
52
+ | 'principal'
53
+ | 'covers'
54
+ | 'recoveryGeneration'
55
+ | 'transferId'
56
+ > & { createdAt?: number; sourceParentSessionId?: string; cause?: RecoveryNoticeCause },
57
+ ): RecoveryRecord {
58
+ const source = {
59
+ target: input.target,
60
+ accountIdentity: input.accountIdentity,
61
+ ...(input.accountIdentityConflict !== undefined ? { accountIdentityConflict: input.accountIdentityConflict } : {}),
62
+ principal: input.principal,
63
+ covers: input.covers,
64
+ recoveryGeneration: input.recoveryGeneration,
65
+ transferId: input.transferId,
66
+ ...(input.sourceParentSessionId !== undefined ? { sourceParentSessionId: input.sourceParentSessionId } : {}),
67
+ }
68
+ const template =
69
+ input.cause === 'live-turn-ended'
70
+ ? {
71
+ schemaVersion: 2 as const,
72
+ purpose: 'interruption-notice' as const,
73
+ cause: 'live-turn-ended' as const,
74
+ templateVersion: 1 as const,
75
+ locale: 'en' as const,
76
+ text: LIVE_TURN_ENDED_NOTICE_TEXT,
77
+ }
78
+ : {
79
+ schemaVersion: 1 as const,
80
+ purpose: 'interruption-notice' as const,
81
+ templateVersion: 1 as const,
82
+ locale: 'en' as const,
83
+ text: RECOVERY_NOTICE_TEXT,
84
+ }
85
+ const record = {
86
+ ...source,
87
+ ...template,
88
+ createdAt: input.createdAt ?? Date.now(),
89
+ generation: 1,
90
+ state: 'pending' as const,
91
+ attempts: 0,
92
+ }
93
+ return parseRecoveryRecord({ ...record, deliveryId: recoveryDeliveryId(record) })
94
+ }