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
@@ -0,0 +1,137 @@
1
+ import { describeError } from './describe-error'
2
+ import { readLastAlive, writeLastAlive } from './last-alive'
3
+ import type { AdapterId } from './schema'
4
+ import type { InboundMessage, RouteReceipt } from './types'
5
+
6
+ export const CHAT_CATCH_UP_MAX_AGE_MS = 15 * 60 * 1000
7
+ export const CATCH_UP_HEARTBEAT_MS = 30 * 1000
8
+ export const CATCH_UP_CONVERSATION_LIMIT = 20
9
+
10
+ export type MissedInbound = {
11
+ readonly message: InboundMessage
12
+ // Latest post in the source conversation, including self/system posts that
13
+ // classification drops. Slack's reply-routing anchor is NOT this scope.
14
+ readonly latestTs: number
15
+ }
16
+ export type ListMissedInbound = (since: number) => Promise<readonly MissedInbound[]>
17
+
18
+ export function createInboundCatchUp(options: {
19
+ agentDir: string
20
+ route: (message: InboundMessage) => Promise<RouteReceipt>
21
+ logger: { info: (message: string) => void; warn: (message: string) => void }
22
+ now?: () => number
23
+ }) {
24
+ const now = options.now ?? Date.now
25
+ // Admission dedup is durable in the router journal. Observation has no
26
+ // journal row, so retain those live receipts for the chat replay window.
27
+ const observed = new Map<string, number>()
28
+ const observationKey = (message: InboundMessage) =>
29
+ JSON.stringify([
30
+ message.adapter,
31
+ message.accountIdentity,
32
+ message.workspace,
33
+ message.chat,
34
+ message.externalMessageId,
35
+ message.authorId,
36
+ message.eventKind,
37
+ message.revision,
38
+ ])
39
+ const states = new Map<
40
+ AdapterId,
41
+ {
42
+ callback: ListMissedInbound
43
+ connected: boolean
44
+ generation: number
45
+ healthy: boolean
46
+ since: Promise<number | null>
47
+ lane: Promise<void>
48
+ }
49
+ >()
50
+
51
+ const run = (adapter: AdapterId): Promise<void> => {
52
+ const state = states.get(adapter)
53
+ if (!state) return Promise.resolve()
54
+ state.connected = true
55
+ const generation = state.generation
56
+ const active = () => states.get(adapter) === state && state.connected && state.generation === generation
57
+ const task = state.lane.then(async () => {
58
+ if (!active()) return
59
+ const at = now()
60
+ const since = (await state.since) ?? at
61
+ const items = await state.callback(Math.max(since, at - CHAT_CATCH_UP_MAX_AGE_MS))
62
+ for (const { message, latestTs } of items) {
63
+ if (!active()) return
64
+ if (message.adapter !== adapter) throw new Error('Catch-up adapter identity mismatch')
65
+ const stale = message.ts < now() - CHAT_CATCH_UP_MAX_AGE_MS || message.ts <= 0
66
+ const movedOn = latestTs > message.ts
67
+ if (message.ts < since || stale || movedOn) {
68
+ options.logger.info(
69
+ `[channels] catch-up ${adapter} dropped id=${message.externalMessageId} reason=${movedOn ? 'moved-on' : 'stale'}`,
70
+ )
71
+ continue
72
+ }
73
+ if ((observed.get(observationKey(message)) ?? 0) > now()) continue
74
+ // The live router owns durable admission dedup and engagement. Never
75
+ // mark replay as an explicit mention or manufacture a wake-up.
76
+ await options.route(message)
77
+ }
78
+ if (!active()) return
79
+ await writeLastAlive(options.agentDir, adapter, at)
80
+ state.since = Promise.resolve(at)
81
+ state.healthy = true
82
+ })
83
+ state.healthy = false
84
+ state.lane = task.catch((error: unknown) => {
85
+ options.logger.warn(`[channels] catch-up ${adapter} failed: ${describeError(error)}`)
86
+ })
87
+ return state.lane
88
+ }
89
+
90
+ // This timer only persists liveness; it never lists history or replays chat.
91
+ const heartbeat = setInterval(() => {
92
+ for (const [adapter, state] of states) {
93
+ if (!state.connected || !state.healthy) continue
94
+ state.lane = state.lane
95
+ .then(async () => {
96
+ if (states.get(adapter) !== state || !state.connected || !state.healthy) return
97
+ const at = now()
98
+ await writeLastAlive(options.agentDir, adapter, at)
99
+ state.since = Promise.resolve(at)
100
+ })
101
+ .catch((error: unknown) => {
102
+ options.logger.warn(`[channels] catch-up heartbeat ${adapter} failed: ${describeError(error)}`)
103
+ })
104
+ }
105
+ }, CATCH_UP_HEARTBEAT_MS)
106
+ heartbeat.unref?.()
107
+
108
+ return {
109
+ noteObserved(message: InboundMessage): void {
110
+ const at = now()
111
+ for (const [key, expires] of observed) if (expires <= at) observed.delete(key)
112
+ observed.set(observationKey(message), at + CHAT_CATCH_UP_MAX_AGE_MS)
113
+ },
114
+ register(adapter: AdapterId, callback: ListMissedInbound): void {
115
+ const since = readLastAlive(options.agentDir, adapter)
116
+ // Defer a read failure into the run's operator-only error boundary.
117
+ void since.catch(() => undefined)
118
+ states.set(adapter, { callback, connected: false, generation: 0, healthy: false, since, lane: Promise.resolve() })
119
+ },
120
+ unregister(adapter: AdapterId, callback: ListMissedInbound): void {
121
+ if (states.get(adapter)?.callback === callback) states.delete(adapter)
122
+ },
123
+ disconnect(adapter: AdapterId): void {
124
+ const state = states.get(adapter)
125
+ if (!state) return
126
+ state.connected = false
127
+ state.generation++
128
+ },
129
+ run,
130
+ async stop(): Promise<void> {
131
+ clearInterval(heartbeat)
132
+ const pending = [...states.values()].map((state) => state.lane)
133
+ states.clear()
134
+ await Promise.all(pending)
135
+ },
136
+ }
137
+ }
@@ -1,7 +1,7 @@
1
1
  // A channel turn ends after a successful `channel_reply` (the terminal-reply
2
2
  // abort in router.ts). When the model's reply PROMISES to keep working this
3
3
  // turn ("바로 확인해볼게요", "let me check", "I'll continue now") but it forgot
4
- // to set `channel_reply({ more_work_this_turn: true })`, the turn aborts and the promised
4
+ // to set `channel_reply({ continue_after_reply: true })`, the turn aborts and the promised
5
5
  // follow-up never runs. The router uses this detector to inject ONE bounded
6
6
  // reminder nudge so the model gets a second chance. See the empty-turn retry
7
7
  // (router.ts) for the sibling mechanism this mirrors.
@@ -73,7 +73,7 @@ const EN_PHRASES: readonly string[] = [
73
73
  // Action/config verb family. The retrieval verbs above ("check/look/look up")
74
74
  // miss the much larger class of "I'll DO X" promises — update/configure/set up/
75
75
  // schedule/fix/apply/create — which is exactly the class that silently truncates
76
- // when the model forgets `more_work_this_turn: true` (the cron-update production miss).
76
+ // when the model forgets `continue_after_reply: true` (the cron-update production miss).
77
77
  "i'll update",
78
78
  "i'll set up",
79
79
  "i'll set it up",
@@ -0,0 +1,272 @@
1
+ import { createHash } from 'node:crypto'
2
+
3
+ import { z } from 'zod'
4
+
5
+ import type { MatchableOrigin } from '../permissions/resolve'
6
+ import { ADAPTER_IDS } from './schema'
7
+ import type { ChannelKey } from './types'
8
+
9
+ export type RecoveryCoverage = {
10
+ store: 'inventory' | 'background' | 'inbound'
11
+ id: string
12
+ generation: number
13
+ parentSessionId?: string
14
+ }
15
+ export type RecoveryLease = { epoch: string; generation: number; attemptId: string; acquiredAt: number }
16
+ export type RecoveryReceipt = { confirmedAt: number; messageId?: string; messageIds?: string[] }
17
+ export type RecoveryFailure = {
18
+ kind: 'transient' | 'rate-limit' | 'unavailable' | 'permission' | 'identity' | 'target' | 'configuration'
19
+ safeReason: string
20
+ /** Milliseconds until another attempt is permitted. */
21
+ retryAfter?: number
22
+ }
23
+ /**
24
+ * Why owed coverage was transferred to a notice. `restart` is the frozen RFC en/v1 boot-recovery
25
+ * notice (schemaVersion 1, no `cause` field). `live-turn-ended` is a same-process turn that ended
26
+ * without a confirmed reply; it is a distinct schemaVersion 2 record and never claims a restart.
27
+ */
28
+ export type RecoveryNoticeCause = 'restart' | 'live-turn-ended'
29
+ export type RecoveryRecord = {
30
+ schemaVersion: 1 | 2
31
+ deliveryId: string
32
+ purpose: 'interruption-notice'
33
+ /** Present exactly on schemaVersion 2; absent means the frozen v1 restart notice. */
34
+ cause?: Exclude<RecoveryNoticeCause, 'restart'>
35
+ target: ChannelKey
36
+ accountIdentity: string
37
+ accountIdentityConflict?: string[]
38
+ boundAccountIdentity?: string
39
+ principal: MatchableOrigin
40
+ sourceParentSessionId?: string
41
+ covers: RecoveryCoverage[]
42
+ transferId: string
43
+ recoveryGeneration: string
44
+ templateVersion: 1
45
+ locale: 'en'
46
+ text: string
47
+ createdAt: number
48
+ generation: number
49
+ state: 'pending' | 'leased' | 'delivered' | 'blocked' | 'suppressed'
50
+ lease?: RecoveryLease
51
+ attempts: number
52
+ nextAttemptAt?: number
53
+ receipt?: RecoveryReceipt
54
+ failure?: RecoveryFailure
55
+ suppression?: { reason: string; decisionId: string }
56
+ }
57
+
58
+ export const RECOVERY_NOTICE_TEXT =
59
+ "⚠️ I restarted before I could confirm a reply to your earlier request. I didn't rerun it automatically — please ask again if you still need it."
60
+ export const LIVE_TURN_ENDED_NOTICE_TEXT =
61
+ "⚠️ My earlier turn ended before I could confirm a reply to your request. I didn't rerun it automatically — please ask again if you still need it."
62
+ // Both templates are frozen into persisted outbox payloads (fenced by `recoveryPayload`), so their
63
+ // bytes keep the historical ⚠️ prefix. Users see this rendered form: an interrupted turn is not an
64
+ // alarm, and the emoji is reserved for failures someone has to act on.
65
+ export function recoveryNoticeDisplayText(record: Pick<RecoveryRecord, 'text'>): string {
66
+ return record.text.replace(/^⚠️ /, '')
67
+ }
68
+ const nonempty = z.string().min(1)
69
+ const timestamp = z.number().finite().nonnegative()
70
+ const generation = z.number().int().positive().max(Number.MAX_SAFE_INTEGER)
71
+ const target = z
72
+ .object({ adapter: z.enum(ADAPTER_IDS), workspace: z.string(), chat: nonempty, thread: z.string().nullable() })
73
+ .strict()
74
+ const principal = z.discriminatedUnion('kind', [
75
+ z.object({ kind: z.literal('tui'), sessionId: nonempty.optional() }).strict(),
76
+ z.object({ kind: z.literal('cron'), jobId: nonempty.optional() }).strict(),
77
+ z.object({ kind: z.literal('subagent'), subagent: nonempty.optional() }).strict(),
78
+ z
79
+ .object({
80
+ kind: z.literal('channel'),
81
+ adapter: z.enum(ADAPTER_IDS),
82
+ workspace: z.string(),
83
+ chat: nonempty,
84
+ parentChat: nonempty.optional(),
85
+ lastInboundAuthorId: nonempty.optional(),
86
+ lastInboundAuthorAdapter: z.enum(ADAPTER_IDS).optional(),
87
+ })
88
+ .strict(),
89
+ ])
90
+ // Frozen v1 field order: persisted outbox bytes follow it, so never reorder or insert here.
91
+ const recordFields = {
92
+ schemaVersion: z.literal(1),
93
+ deliveryId: z.string().regex(/^[a-f0-9]{64}$/),
94
+ purpose: z.literal('interruption-notice'),
95
+ target,
96
+ accountIdentity: nonempty,
97
+ accountIdentityConflict: z.array(nonempty).min(2).optional(),
98
+ boundAccountIdentity: nonempty.optional(),
99
+ principal,
100
+ sourceParentSessionId: nonempty.optional(),
101
+ covers: z
102
+ .array(
103
+ z
104
+ .object({
105
+ store: z.enum(['inventory', 'background', 'inbound']),
106
+ id: nonempty,
107
+ generation,
108
+ parentSessionId: nonempty.optional(),
109
+ })
110
+ .strict(),
111
+ )
112
+ .min(1),
113
+ transferId: nonempty,
114
+ recoveryGeneration: nonempty,
115
+ templateVersion: z.literal(1),
116
+ locale: z.literal('en'),
117
+ text: z.literal(RECOVERY_NOTICE_TEXT),
118
+ createdAt: timestamp,
119
+ generation,
120
+ state: z.enum(['pending', 'leased', 'delivered', 'blocked', 'suppressed']),
121
+ lease: z.object({ epoch: nonempty, generation, attemptId: nonempty, acquiredAt: timestamp }).strict().optional(),
122
+ attempts: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
123
+ nextAttemptAt: timestamp.optional(),
124
+ receipt: z
125
+ .object({
126
+ confirmedAt: timestamp,
127
+ messageId: nonempty.optional(),
128
+ messageIds: z.array(nonempty).min(1).optional(),
129
+ })
130
+ .strict()
131
+ .optional(),
132
+ failure: z
133
+ .object({
134
+ kind: z.enum(['transient', 'rate-limit', 'unavailable', 'permission', 'identity', 'target', 'configuration']),
135
+ safeReason: nonempty.max(512),
136
+ retryAfter: timestamp.optional(),
137
+ })
138
+ .strict()
139
+ .optional(),
140
+ suppression: z
141
+ .object({ reason: nonempty.max(512), decisionId: nonempty })
142
+ .strict()
143
+ .optional(),
144
+ }
145
+ const schema = z
146
+ .discriminatedUnion('schemaVersion', [
147
+ // en/v1 restart notice: the RFC's frozen boot-recovery template.
148
+ z.object(recordFields).strict(),
149
+ // v2 names its non-restart cause explicitly and pins that cause's own frozen template.
150
+ z
151
+ .object({
152
+ ...recordFields,
153
+ schemaVersion: z.literal(2),
154
+ text: z.literal(LIVE_TURN_ENDED_NOTICE_TEXT),
155
+ cause: z.literal('live-turn-ended'),
156
+ })
157
+ .strict(),
158
+ ])
159
+ .superRefine((record, context) => {
160
+ const invalid = (message: string) => context.addIssue({ code: 'custom', message })
161
+ if (new Set(record.covers.map((cover) => `${cover.store}:${cover.id}`)).size !== record.covers.length)
162
+ invalid('Duplicate coverage')
163
+ if (record.deliveryId !== recoveryDeliveryId(record)) invalid('Delivery identity mismatch')
164
+ if (
165
+ record.boundAccountIdentity !== undefined &&
166
+ (record.accountIdentity !== 'unbound-legacy' || record.boundAccountIdentity === 'unbound-legacy')
167
+ )
168
+ invalid('Invalid legacy account binding')
169
+ if (
170
+ record.accountIdentityConflict !== undefined &&
171
+ (record.accountIdentity !== 'unbound-legacy' ||
172
+ record.accountIdentityConflict.some(
173
+ (identity, index, identities) =>
174
+ identity === 'unbound-legacy' || (index > 0 && identities[index - 1]! >= identity),
175
+ ))
176
+ )
177
+ invalid('Invalid account identity conflict')
178
+ if (record.state === 'leased' && (!record.lease || record.lease.generation !== record.generation))
179
+ invalid('Invalid lease ownership')
180
+ if (record.lease && (record.lease.generation > record.generation || record.attempts === 0))
181
+ invalid('Invalid lease generation')
182
+ if (record.attempts >= record.generation) invalid('Attempts exceed ownership generation')
183
+ if (record.state === 'delivered' && (!record.lease || record.lease.generation !== record.generation))
184
+ invalid('Invalid delivered ownership')
185
+ if ((record.state === 'leased' || record.state === 'delivered') && record.failure)
186
+ invalid('Failure on active or delivered record')
187
+ if (record.failure && record.attempts === 0) invalid('Failure before dispatch attempt')
188
+ if (
189
+ record.state === 'blocked' &&
190
+ record.failure &&
191
+ !['permission', 'identity', 'target', 'configuration'].includes(record.failure.kind)
192
+ )
193
+ invalid('Transient failure cannot block')
194
+ if (record.receipt && !record.lease) invalid('Receipt without dispatch ownership')
195
+ if (record.state === 'delivered' && !record.receipt) invalid('Missing delivery receipt')
196
+ if (record.receipt && record.state !== 'delivered' && record.state !== 'suppressed')
197
+ invalid('Receipt on unresolved record')
198
+ if (record.state === 'blocked' && !record.failure) invalid('Missing blocked failure')
199
+ if ((record.state === 'pending' || record.state === 'blocked') && record.lease) invalid('Lease on unclaimed record')
200
+ if ((record.state === 'suppressed') !== !!record.suppression) invalid('Invalid suppression state')
201
+ if (record.nextAttemptAt !== undefined && record.state !== 'pending' && record.state !== 'blocked')
202
+ invalid('Retry on terminal or leased record')
203
+ })
204
+
205
+ type DeliveryIdentity = Pick<
206
+ RecoveryRecord,
207
+ 'purpose' | 'target' | 'accountIdentity' | 'covers' | 'recoveryGeneration' | 'cause'
208
+ >
209
+ export function recoveryDeliveryId(record: DeliveryIdentity): string {
210
+ const covers = record.covers
211
+ .map((cover) => [cover.store, cover.id, cover.generation, cover.parentSessionId ?? null])
212
+ .sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b)))
213
+ // The v1 restart seed is frozen; a non-restart notice gets its own seed so the two can never share an ID.
214
+ const seed = record.cause === undefined ? ['typeclaw:recovery:v1'] : ['typeclaw:recovery:v2', record.cause]
215
+ return createHash('sha256')
216
+ .update(
217
+ JSON.stringify([
218
+ ...seed,
219
+ record.purpose,
220
+ [record.target.adapter, record.target.workspace, record.target.chat, record.target.thread],
221
+ record.accountIdentity,
222
+ covers,
223
+ record.recoveryGeneration,
224
+ ]),
225
+ )
226
+ .digest('hex')
227
+ }
228
+ export function recoveryNoticeCause(record: Pick<RecoveryRecord, 'cause'>): RecoveryNoticeCause {
229
+ return record.cause ?? 'restart'
230
+ }
231
+ export function validateRecoveryRecord(value: unknown): value is RecoveryRecord {
232
+ return schema.safeParse(value).success
233
+ }
234
+ export function parseRecoveryRecord(value: unknown): RecoveryRecord {
235
+ return schema.parse(value) as RecoveryRecord
236
+ }
237
+
238
+ /** Stable comparison of the frozen transfer payload, excluding dispatch state. */
239
+ export function recoveryPayload(record: RecoveryRecord): string {
240
+ return JSON.stringify([
241
+ record.deliveryId,
242
+ record.purpose,
243
+ record.target.adapter,
244
+ record.target.workspace,
245
+ record.target.chat,
246
+ record.target.thread,
247
+ record.accountIdentity,
248
+ record.accountIdentityConflict ?? null,
249
+ canonical(record.principal),
250
+ record.sourceParentSessionId ?? null,
251
+ record.covers.map(canonical).sort(),
252
+ record.transferId,
253
+ record.recoveryGeneration,
254
+ record.templateVersion,
255
+ record.locale,
256
+ record.text,
257
+ record.createdAt,
258
+ // v1 strings stay byte-identical; later versions also compare their explicit cause.
259
+ ...(record.schemaVersion === 1 ? [] : [record.schemaVersion, record.cause ?? null]),
260
+ ])
261
+ }
262
+ /** Fixed-size fence for a frozen transfer payload once the full record is no longer retained. */
263
+ export function recoveryPayloadDigest(record: RecoveryRecord): string {
264
+ return createHash('sha256').update(recoveryPayload(record)).digest('hex')
265
+ }
266
+ function canonical(value: object): string {
267
+ return JSON.stringify(
268
+ Object.entries(value)
269
+ .filter(([, field]) => field !== undefined)
270
+ .sort(([a], [b]) => a.localeCompare(b)),
271
+ )
272
+ }
@@ -96,7 +96,7 @@ export function decideEngagement(input: EngagementInput): EngagementDecision {
96
96
 
97
97
  // Peer bots are excluded from the count — a 1-human-N-bot room is still
98
98
  // "solo" for the fallback at the bottom.
99
- const effectiveHumans = countEffectiveHumans(participants, input.membership, now)
99
+ const effectiveHumans = countEngagementHumans(message, participants, input.membership, now, botInThread)
100
100
 
101
101
  if (config.trigger.includes('dm') && message.isDm) return 'engage'
102
102
  if (config.trigger.includes('mention') && message.isBotMention) return 'engage'
@@ -281,6 +281,22 @@ function targetsSomeoneElse(
281
281
  return false
282
282
  }
283
283
 
284
+ // Membership is a room property, so a Slack thread inherits its parent
285
+ // channel's count. Once the bot is part of the thread, the thread's own
286
+ // speakers are the better signal: a thread between one human and the bot is a
287
+ // solo conversation even inside a crowded channel, and a second human posting
288
+ // there flips it back to multi-human.
289
+ export function countEngagementHumans(
290
+ message: InboundMessage,
291
+ participants: readonly ChannelParticipant[],
292
+ membership: MembershipCount | null,
293
+ now: number,
294
+ botInThread: boolean,
295
+ ): number {
296
+ if (botInThread && isThreadRoom(message)) return participants.filter((p) => p.isBot !== true).length
297
+ return countEffectiveHumans(participants, membership, now)
298
+ }
299
+
284
300
  export function countEffectiveHumans(
285
301
  participants: readonly ChannelParticipant[],
286
302
  membership: MembershipCount | null,
@@ -19,7 +19,7 @@ export type FalseReceiptInput = {
19
19
  chat: string
20
20
  thread: string | null
21
21
  text: string | undefined
22
- moreWorkThisTurn: boolean
22
+ continueAfterReply: boolean
23
23
  resolveReviewThread: boolean
24
24
  }
25
25
 
@@ -32,9 +32,9 @@ export function checkFalseReceipt(input: FalseReceiptInput): FalseReceiptDecisio
32
32
  if (claim === 'ignore') return { kind: 'allow' }
33
33
  if (claim === 'warn') return { kind: 'warn', notice: SOFT_NOTICE }
34
34
 
35
- // A turn the agent explicitly keeps alive (more_work_this_turn:true) is not yet
35
+ // A turn the agent explicitly keeps alive (continue_after_reply:true) is not yet
36
36
  // a receipt — the real action may still be coming. Never block; nudge instead.
37
- if (input.moreWorkThisTurn) return { kind: 'warn', notice: SOFT_NOTICE }
37
+ if (input.continueAfterReply) return { kind: 'warn', notice: SOFT_NOTICE }
38
38
 
39
39
  if (claim === 'block-resolve') {
40
40
  if (input.thread === null) return { kind: 'allow' }
@@ -19,10 +19,10 @@ export type RereviewGuardInput = {
19
19
  thread: string | null
20
20
  text: string | undefined
21
21
  wantsResolve: boolean
22
- // A mid-turn status reply (more_work_this_turn:true) is not the turn's receipt,
22
+ // A mid-turn status reply (continue_after_reply:true) is not the turn's receipt,
23
23
  // so it suppresses the warn-tier escalation below — but never the explicit
24
24
  // resolve, which is a real mutation. Mirrors the false-receipt guard's rule.
25
- moreWorkThisTurn: boolean
25
+ continueAfterReply: boolean
26
26
  getReviewState: (req: { adapter: 'github'; workspace: string; chat: string }) => Promise<ReviewStateResult>
27
27
  workspace: string
28
28
  round?: GithubReviewFollowupRound
@@ -42,7 +42,11 @@ export async function evaluateRereviewGuard(input: RereviewGuardInput): Promise<
42
42
  if (!isCloseoutAttempt(input)) return ALLOW
43
43
 
44
44
  const round = matchingRound(input)
45
- const state = await input.getReviewState({ adapter: 'github', workspace: input.workspace, chat: input.chat })
45
+ const request = { adapter: 'github', workspace: input.workspace, chat: input.chat } as const
46
+ let state = await input.getReviewState(request)
47
+ // One immediate re-query absorbs a single GitHub API blip, which would
48
+ // otherwise refuse a legitimate close-out the model has to re-author.
49
+ if (!state.ok && state.code === 'transient') state = await input.getReviewState(request)
46
50
 
47
51
  // Fail closed: an unverifiable review state is treated as a live block, so the
48
52
  // bot never strands a re-review on a transient API failure.
@@ -82,14 +86,14 @@ function matchingRound(input: RereviewGuardInput): GithubReviewFollowupRound | n
82
86
  // live CHANGES_REQUESTED, so casual approval-shaped chatter on an unblocked PR
83
87
  // still posts. Only POSITIVE warn phrases escalate — negative ones ("needs
84
88
  // changes", "still needs work") re-assert a block rather than strand it, so they
85
- // stay non-firing. `more_work_this_turn:true` exempts the warn escalation
89
+ // stay non-firing. `continue_after_reply:true` exempts the warn escalation
86
90
  // (mid-turn planning, not the receipt), but never the explicit resolve action.
87
91
  // Plain `ignore` text never fires.
88
92
  function isCloseoutAttempt(input: RereviewGuardInput): boolean {
89
93
  if (input.wantsResolve && input.thread !== null) return true
90
94
  const claim = classifyReviewClaim(input.text ?? '')
91
95
  if (claim === 'block-resolve' || claim === 'block-approve') return true
92
- return !input.moreWorkThisTurn && isPositiveWarnCloseout(input.text ?? '')
96
+ return !input.continueAfterReply && isPositiveWarnCloseout(input.text ?? '')
93
97
  }
94
98
 
95
99
  function unverifiableReason(error: string): string {