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,272 @@
1
+ import type { MatchableOrigin } from "../permissions/resolve.js";
2
+ import type { BackgroundObligationRef, BackgroundObligationStore } from "./background-obligations.js";
3
+ import type { RecoveryNoticeCause, RecoveryRecord } from "./continuity-types.js";
4
+ import type { RecoveryOutbox } from "./recovery-outbox.js";
5
+ import type { ChannelKey } from "./types.js";
6
+ export type InboundRef = {
7
+ inputId: string;
8
+ generation: number;
9
+ };
10
+ export type InboundOutcome = {
11
+ kind: 'delivered' | 'intentionally-suppressed';
12
+ decisionId: string;
13
+ reason?: string;
14
+ deliveryId?: string;
15
+ };
16
+ type InboundReference = {
17
+ messageId?: string;
18
+ receiptId?: string;
19
+ };
20
+ /** An input that still owes a response or a notice keeps its full admission provenance. */
21
+ export type OpenInboundRecord = InboundRef & {
22
+ schemaVersion: 1;
23
+ identity: string;
24
+ accountIdentity: string;
25
+ target: ChannelKey;
26
+ principal: MatchableOrigin;
27
+ epoch: string;
28
+ acceptedAt: number;
29
+ reference?: InboundReference;
30
+ sourceParentSessionId?: string;
31
+ phase: 'admitted' | 'turn-owned' | 'notice-prepared' | 'notice-owned';
32
+ claim?: {
33
+ turnId: string;
34
+ ownerSessionId?: string;
35
+ epoch: string;
36
+ generation: number;
37
+ };
38
+ transfer?: RecoveryRecord;
39
+ };
40
+ /**
41
+ * Closed authority, kept indefinitely because no adapter replay floor is proven. It holds only what a
42
+ * later delivery or stale callback is judged against: the exact identity (`inputId`), the terminal
43
+ * generation and outcome, the frozen author fence, the Slack message representative (`messageKey`,
44
+ * ordered by `acceptedAt`), the platform reference, and the delivery of the frozen notice that
45
+ * covered it (whose payload the journal keeps once per delivery).
46
+ */
47
+ export type ClosedInboundRecord = InboundRef & {
48
+ phase: 'closed';
49
+ acceptedAt: number;
50
+ reference?: InboundReference;
51
+ principalDigest: string;
52
+ messageKey?: string;
53
+ outcome: InboundOutcome;
54
+ noticeDeliveryId?: string;
55
+ };
56
+ export type InboundRecord = OpenInboundRecord | ClosedInboundRecord;
57
+ export type InboundAdmission = {
58
+ accountIdentity: string;
59
+ target: ChannelKey;
60
+ principal: MatchableOrigin;
61
+ messageId?: string;
62
+ eventKind: string;
63
+ revision: string;
64
+ receiptId?: string;
65
+ reference?: {
66
+ messageId?: string;
67
+ receiptId?: string;
68
+ };
69
+ ownerSessionId?: string;
70
+ };
71
+ type Owner = {
72
+ turnId: string;
73
+ ownerSessionId?: string;
74
+ target: ChannelKey;
75
+ fromTurnId?: string;
76
+ };
77
+ /** Single-runtime writer. Callers hold the background target lane through coverage reads and cache publication. */
78
+ export declare class InboundJournal {
79
+ private readonly options;
80
+ readonly epoch: string;
81
+ readonly path: string;
82
+ private fd?;
83
+ private sequence;
84
+ /** Open rows in full, closed rows as tombstones. Never pruned: no replay floor is proven. */
85
+ private rows;
86
+ /** Slack message key → representative inputId; rebuilt from durable rows, never persisted. */
87
+ private slackMessages;
88
+ /** Frozen transfer payload, once per delivery; rows refer to it by deliveryId. */
89
+ private notices;
90
+ /** Mixed decisions not yet recorded as applied: the only decision bodies kept. */
91
+ private decisions;
92
+ /** Idempotency fences a caller can still present; see `retainsReceipt`. */
93
+ private receipts;
94
+ /** Transition IDs this writer minted itself and never handed to any caller. */
95
+ private minted;
96
+ private snapshotBytes;
97
+ private growthBytes;
98
+ private maintaining;
99
+ private compactionQueued;
100
+ /**
101
+ * True only while a healthy compaction swaps the closed handle for the installed file's reopened
102
+ * one. The writer queue is held for the whole swap, so in-memory state stays authoritative and
103
+ * readable; no write can run until the replacement handle exists.
104
+ */
105
+ private swapping;
106
+ private queue;
107
+ private initializing?;
108
+ private initialized;
109
+ private initializationCancelled;
110
+ private closing?;
111
+ private frozen?;
112
+ private readonly background?;
113
+ private readonly failureListeners;
114
+ constructor(agentDir: string, options?: {
115
+ epoch?: string;
116
+ backgroundObligations?: BackgroundObligationStore;
117
+ onError?: (error: unknown) => void;
118
+ now?: () => number;
119
+ onDurability?: (phase: 'initialization-directory-created' | 'initialization-read' | 'append-written' | 'append-synced' | 'mixed-json-applied' | 'compaction-started' | 'temp-synced' | 'handle-closed' | 'replaced' | 'directory-synced' | 'reopened', record?: unknown) => void | Promise<void>;
120
+ onSync?: (milliseconds: number) => void;
121
+ /** Internal: growth below which maintenance never rewrites. Not operator configuration. */
122
+ compactionFloorBytes?: number;
123
+ });
124
+ private fail;
125
+ subscribeFailure(listener: (error: unknown) => void): () => void;
126
+ /** Operational: initialized writer, not cancelled, frozen or closed, holding a handle or mid-swap. */
127
+ assertAvailable(): void;
128
+ health(): {
129
+ available: boolean;
130
+ error: unknown;
131
+ sequence: number;
132
+ };
133
+ private serialized;
134
+ /** Stop startup before teardown; an operational writer remains available for durable closeout. */
135
+ cancelInitialization(): void;
136
+ initialize(): Promise<void>;
137
+ /**
138
+ * One strict pass over the durable journal: each LF-terminated line is decoded as fatal UTF-8,
139
+ * parsed and folded as it is read, so only normalized state is retained. Bytes after the last LF
140
+ * are a torn append and are reported for truncation; any complete line that fails throws and
141
+ * leaves the file untouched.
142
+ */
143
+ private load;
144
+ private fold;
145
+ private foldLegacySnapshot;
146
+ private foldSnapshot;
147
+ private foldSnapshotHistory;
148
+ private foldDecision;
149
+ private foldApplied;
150
+ /** Applied history is normalized at once: a full decision body never outlives its application. */
151
+ private remember;
152
+ /**
153
+ * A receipt only matters to a caller that can still present its transition ID. Admission IDs are
154
+ * answered by the permanent row itself. A bare UUID is a runtime-local handle: once the epoch that
155
+ * minted or received it has ended, no live caller holds it and no durable record re-issues one.
156
+ * Derived and caller-named IDs (`prepare:`, `owned:`, `recovery:`, stop IDs, …) stay indefinitely.
157
+ */
158
+ private retainsReceipt;
159
+ /** Keeps open rows in full and closed rows as tombstones; the frozen transfer is stored once per delivery. */
160
+ private install;
161
+ private frozenNotice;
162
+ private indexSlackMessage;
163
+ private validateDecision;
164
+ private validateChange;
165
+ private append;
166
+ private applyBackground;
167
+ private repairInternal;
168
+ repair(): Promise<void>;
169
+ private commit;
170
+ /**
171
+ * The one duplicate authority for admission and pre-routing lookup. A Slack message resolves to its
172
+ * representative row whatever revision or thread shape arrives; only identities outside the message
173
+ * index (other adapters, receipt-only, undecodable rows) use exact identity. A duplicate returns the
174
+ * existing row untouched (its debt never follows a new routing thread), and a different author is a
175
+ * conflict, never a fresh slot — closed or open.
176
+ */
177
+ private existingAdmission;
178
+ admit(input: InboundAdmission): Promise<{
179
+ kind: 'accepted';
180
+ inputId: string;
181
+ generation: number;
182
+ } | {
183
+ kind: 'duplicate';
184
+ inputId: string;
185
+ outcome?: InboundOutcome;
186
+ }>;
187
+ get(inputId: string): InboundRecord | undefined;
188
+ list(): InboundRecord[];
189
+ resolve(ids: readonly string[]): InboundRef[];
190
+ private coverage;
191
+ private backgroundCoverage;
192
+ private result;
193
+ claim(refs: InboundRef[], owner: Owner, backgroundRefs?: BackgroundObligationRef[], decisionId?: string): Promise<{
194
+ inboundRefs: {
195
+ inputId: string;
196
+ generation: number;
197
+ }[];
198
+ backgroundRefs: {
199
+ obligationId: string;
200
+ generation: number;
201
+ }[];
202
+ }>;
203
+ move(refs: InboundRef[], owner: Owner & {
204
+ fromTurnId: string;
205
+ }, backgroundRefs?: BackgroundObligationRef[], decisionId?: string): Promise<{
206
+ inboundRefs: {
207
+ inputId: string;
208
+ generation: number;
209
+ }[];
210
+ backgroundRefs: {
211
+ obligationId: string;
212
+ generation: number;
213
+ }[];
214
+ }>;
215
+ private repeated;
216
+ private changeOwner;
217
+ settle(refs: InboundRef[], outcome: InboundOutcome, brefs?: BackgroundObligationRef[], target?: ChannelKey): Promise<{
218
+ inboundRefs: {
219
+ inputId: string;
220
+ generation: number;
221
+ }[];
222
+ backgroundRefs: {
223
+ obligationId: string;
224
+ generation: number;
225
+ }[];
226
+ }>;
227
+ /**
228
+ * Freezes a notice over owed coverage. `cause` picks the template: `restart` (the default) is the
229
+ * RFC boot-recovery notice with its original request digest; `live-turn-ended` is a same-process
230
+ * turn that ended unanswered and is frozen as its own distinct record.
231
+ */
232
+ prepareNotice(refs: InboundRef[], target: ChannelKey, brefs?: BackgroundObligationRef[], ownerSessionId?: string, cause?: RecoveryNoticeCause): Promise<RecoveryRecord>;
233
+ importPrepared(outbox: RecoveryOutbox, transfer: RecoveryRecord): Promise<RecoveryRecord>;
234
+ /** Pre-routing duplicate check; the same resolver and author fence as admission. */
235
+ lookupAdmission(input: InboundAdmission): InboundRecord | undefined;
236
+ /**
237
+ * Boot transfer of inbound authority no live turn can still answer. Issued transfers re-import
238
+ * unchanged first, so a late matching row forms its own notice instead of mutating one. Remaining
239
+ * old-epoch rows become one mixed notice per recovery partition, joined by compatible old-epoch
240
+ * children; unmatched children keep the background store's singleton fallback.
241
+ */
242
+ importOldEpoch(outbox: RecoveryOutbox): Promise<void>;
243
+ validateNotice(record: RecoveryRecord): Promise<'open' | 'resolved'>;
244
+ /** Admission event kinds of a notice covering only open inbound rows; undefined for any other coverage. */
245
+ noticeEventKinds(record: RecoveryRecord): string[] | undefined;
246
+ acknowledgeNotice(record: RecoveryRecord): Promise<void>;
247
+ suppressNoticeCoverage(record: RecoveryRecord, decision: {
248
+ decisionId: string;
249
+ reason: string;
250
+ }): Promise<void>;
251
+ private closeNotice;
252
+ /**
253
+ * Starts growth-driven compaction once boot recovery has finished. A compaction is queued on the
254
+ * writer's own queue when the bytes appended since the last snapshot reach the larger of a fixed
255
+ * floor and that snapshot's size, so rewrite work stays proportional to new growth (tombstones kept
256
+ * forever never cause repeated rewrites) and a journal that is not growing is never rewritten.
257
+ * Checked here and after each append; `close()` stops it.
258
+ */
259
+ startMaintenance(): void;
260
+ private scheduleCompaction;
261
+ compact(): Promise<void>;
262
+ /**
263
+ * Rewrites the journal as one compact snapshot of the already-normalized state: temp sync, close the
264
+ * old handle, replace, directory sync, reopen. Any failure freezes the writer; it never appends
265
+ * through a handle to an unlinked file.
266
+ */
267
+ private compactInternal;
268
+ private snapshot;
269
+ flush(): Promise<void>;
270
+ close(): Promise<void>;
271
+ }
272
+ export {};
@@ -0,0 +1,3 @@
1
+ import type { AdapterId } from "./schema.js";
2
+ export declare function readLastAlive(agentDir: string, adapter: AdapterId): Promise<number | null>;
3
+ export declare function writeLastAlive(agentDir: string, adapter: AdapterId, at: number): Promise<void>;
@@ -0,0 +1,27 @@
1
+ import { type MembershipCount, type MembershipResolver, type MembershipResolverFailure } from "./membership.js";
2
+ import type { ChannelKey } from "./types.js";
3
+ export type MembershipCacheRead = {
4
+ kind: 'hit';
5
+ membership: MembershipCount | null;
6
+ } | {
7
+ kind: 'stale';
8
+ membership: MembershipCount;
9
+ } | {
10
+ kind: 'miss';
11
+ };
12
+ export type MembershipCacheLogger = {
13
+ warn: (msg: string) => void;
14
+ };
15
+ export type MembershipCacheOptions = {
16
+ resolver: MembershipResolver;
17
+ now?: () => number;
18
+ logger?: MembershipCacheLogger;
19
+ };
20
+ export type MembershipCache = {
21
+ read: (key: ChannelKey) => MembershipCacheRead;
22
+ get: (key: ChannelKey) => MembershipCount | null;
23
+ warmUp: (key: ChannelKey) => Promise<MembershipCount | null>;
24
+ invalidate: (key: ChannelKey) => void;
25
+ };
26
+ export declare function createMembershipCache(options: MembershipCacheOptions): MembershipCache;
27
+ export type { MembershipResolverFailure };
@@ -0,0 +1,21 @@
1
+ import type { ChannelKey } from "./types.js";
2
+ export declare const MEMBERSHIP_ENUMERATION_CAP = 50;
3
+ export declare const MEMBERSHIP_CACHE_TTL_MS: number;
4
+ export declare const MEMBERSHIP_CACHE_PERMANENT_TTL_MS: number;
5
+ export declare const MEMBERSHIP_CACHE_TRANSIENT_TTL_MS = 30000;
6
+ export declare const MEMBERSHIP_FRESHNESS_MS = 60000;
7
+ export declare const MEMBERSHIP_COLD_FETCH_TIMEOUT_MS = 1500;
8
+ export type MembershipCount = {
9
+ humans: number;
10
+ bots: number;
11
+ fetchedAt: number;
12
+ truncated: boolean;
13
+ humanMemberIds?: readonly string[];
14
+ };
15
+ export type MembershipResolverFailure = {
16
+ kind: 'transient';
17
+ } | {
18
+ kind: 'permanent';
19
+ };
20
+ export type MembershipResolverResult = MembershipCount | MembershipResolverFailure;
21
+ export type MembershipResolver = (key: ChannelKey) => Promise<MembershipResolverResult>;
@@ -0,0 +1,7 @@
1
+ export type OutboundFloodCheckResult = {
2
+ ok: true;
3
+ } | {
4
+ ok: false;
5
+ reason: string;
6
+ };
7
+ export declare function checkOutboundFlood(text: string): OutboundFloodCheckResult;
@@ -0,0 +1,4 @@
1
+ import type { ChannelParticipant } from "../agent/session-origin.js";
2
+ export declare const PARTICIPANTS_MAX_PERSISTED = 50;
3
+ export declare const PARTICIPANTS_MAX_AGE_MS: number;
4
+ export declare function updateParticipants(current: readonly ChannelParticipant[], authorId: string, authorName: string, now: number, isBot?: boolean): ChannelParticipant[];
@@ -0,0 +1,32 @@
1
+ import type { ChannelParticipant } from "../agent/session-origin.js";
2
+ import type { AdapterId } from "./schema.js";
3
+ import type { ChannelKey, GithubReviewFollowupRound, GithubReviewThreadCloseout } from "./types.js";
4
+ export type ChannelSessionRecord = {
5
+ adapter: AdapterId;
6
+ workspace: string;
7
+ chat: string;
8
+ thread: string | null;
9
+ sessionId?: string;
10
+ sessionFile?: string;
11
+ lastInboundAt?: number;
12
+ participants: ChannelParticipant[];
13
+ githubReviewRound?: GithubReviewFollowupRound & {
14
+ status: 'pending' | 'completed';
15
+ createdAt: number;
16
+ attemptedCarriers: (string | null)[];
17
+ dismissalAttempted?: true;
18
+ requestChangesAttempted?: true;
19
+ };
20
+ githubReviewThreadCloseout?: GithubReviewThreadCloseout & {
21
+ deferred: true;
22
+ };
23
+ };
24
+ export type ChannelSessionsLogger = {
25
+ info: (msg: string) => void;
26
+ warn: (msg: string) => void;
27
+ error: (msg: string) => void;
28
+ };
29
+ export declare function channelsSessionsPath(agentDir: string): string;
30
+ export declare function loadChannelSessions(agentDir: string, logger?: ChannelSessionsLogger): Promise<ChannelSessionRecord[]>;
31
+ export declare function saveChannelSessions(agentDir: string, sessions: readonly ChannelSessionRecord[], logger?: ChannelSessionsLogger): Promise<void>;
32
+ export declare function findRecord(sessions: readonly ChannelSessionRecord[], key: ChannelKey): ChannelSessionRecord | undefined;
@@ -0,0 +1,26 @@
1
+ import type { MatchableOrigin } from "../permissions/resolve.js";
2
+ import type { RecoveryNoticeCause, RecoveryRecord } from "./continuity-types.js";
3
+ import type { ChannelKey } from "./types.js";
4
+ /** Frozen principals compare by content; persisted key order is a serialization detail. */
5
+ export declare function sameRecoveryPrincipal(left: MatchableOrigin, right: MatchableOrigin): boolean;
6
+ /**
7
+ * One interruption notice may cover only sources sharing destination, authenticated account,
8
+ * frozen principal and captured effective parent (the `/stop` authority). Chat, text, turn
9
+ * timing, the current mapping and the current adapter account are never grouping evidence.
10
+ */
11
+ export declare function recoveryNoticePartitionKey(input: {
12
+ target: ChannelKey;
13
+ accountIdentity: string;
14
+ principal: MatchableOrigin;
15
+ parentSessionId?: string;
16
+ }): string;
17
+ /**
18
+ * Freezes a transfer at preparation. `restart` (the default) is the RFC en/v1 boot-recovery
19
+ * notice, byte- and ID-identical to every record written before causes existed. Same-process
20
+ * abandonment passes `live-turn-ended`, which never asserts a restart.
21
+ */
22
+ export declare function createRecoveryNotice(input: Pick<RecoveryRecord, 'target' | 'accountIdentity' | 'accountIdentityConflict' | 'principal' | 'covers' | 'recoveryGeneration' | 'transferId'> & {
23
+ createdAt?: number;
24
+ sourceParentSessionId?: string;
25
+ cause?: RecoveryNoticeCause;
26
+ }): RecoveryRecord;
@@ -0,0 +1,58 @@
1
+ import type { RecoveryFailure, RecoveryLease, RecoveryReceipt, RecoveryRecord } from "./continuity-types.js";
2
+ export type RecoveryOutboxOptions = {
3
+ epoch?: string;
4
+ now?: () => number;
5
+ onError?: (error: unknown) => void;
6
+ /** Fault-injection boundary; production callers leave this unset. */
7
+ onDurability?: (phase: 'temp-synced' | 'replaced' | 'directory-synced' | 'retirement-synced' | 'retired', record: RecoveryRecord) => void | Promise<void>;
8
+ };
9
+ /**
10
+ * Immutable fence left when a terminal record leaves the active outbox. It keeps only the frozen
11
+ * payload digest and terminal dispatch state, so a later import of the same frozen transfer
12
+ * resolves to the finished delivery instead of creating a new send, without retaining the payload.
13
+ */
14
+ export type RecoveryRetirement = {
15
+ schemaVersion: 1;
16
+ deliveryId: string;
17
+ payloadDigest: string;
18
+ retiredAt: number;
19
+ dispatch: Pick<RecoveryRecord, 'generation' | 'attempts' | 'lease' | 'receipt' | 'failure' | 'suppression' | 'boundAccountIdentity'> & {
20
+ state: 'delivered' | 'suppressed';
21
+ };
22
+ };
23
+ export declare class RecoveryOutbox {
24
+ readonly epoch: string;
25
+ private readonly directory;
26
+ private readonly retiredDirectory;
27
+ private readonly now;
28
+ private readonly options;
29
+ private readonly pending;
30
+ private readonly importListeners;
31
+ constructor(agentDir: string, options?: RecoveryOutboxOptions);
32
+ private path;
33
+ private read;
34
+ private readRetirement;
35
+ private publish;
36
+ private serialized;
37
+ import(input: RecoveryRecord): Promise<RecoveryRecord>;
38
+ /** Called after each new record becomes durable; listeners must not throw. */
39
+ subscribe(listener: (record: RecoveryRecord) => void): () => void;
40
+ /**
41
+ * Moves a terminal record out of the active outbox once its source has acknowledged it and
42
+ * validates as resolved. The fence is durable before the active file is removed, so every crash
43
+ * point leaves the record, the fence, or both (the next retirement converges them).
44
+ */
45
+ retire(id: string, expectedGeneration: number): Promise<boolean>;
46
+ retired(id: string): Promise<RecoveryRetirement | undefined>;
47
+ listRetired(): Promise<RecoveryRetirement[]>;
48
+ get(id: string): Promise<RecoveryRecord | undefined>;
49
+ list(): Promise<RecoveryRecord[]>;
50
+ lease(id: string, expectedGeneration: number): Promise<RecoveryLease | undefined>;
51
+ repairLease(id: string, lease: RecoveryLease): Promise<boolean>;
52
+ delivered(id: string, lease: RecoveryLease, receipt: RecoveryReceipt): Promise<boolean>;
53
+ bindAccount(id: string, lease: RecoveryLease, identity: string): Promise<boolean>;
54
+ fail(id: string, lease: RecoveryLease, failure: RecoveryFailure): Promise<boolean>;
55
+ suppress(id: string, reason: string, decisionId: string): Promise<boolean>;
56
+ private owns;
57
+ flush(): Promise<void>;
58
+ }