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,798 @@
1
+ import { type AgentSession } from "../agent/index.js";
2
+ import { type QuestionSignal } from "../agent/attention-escalation.js";
3
+ import { resolveFallbackChain } from "../agent/model-fallback.js";
4
+ import type { RestartHandoff } from "../agent/restart-handoff/index.js";
5
+ import type { ChannelParticipant, SessionOrigin } from "../agent/session-origin.js";
6
+ import { recordTurnOutcome, runIdleContinuation } from "../agent/todo/continuation-wiring.js";
7
+ import { type PermissionService } from "../permissions/index.js";
8
+ import type { ChannelOutboundBeforeEvent, ChannelOutboundOrigin, HookBus } from "../plugin/index.js";
9
+ import type { Stream } from "../stream/index.js";
10
+ import { BackgroundObligationStore, type BackgroundObligationRef } from "./background-obligations.js";
11
+ import { type ListMissedInbound } from "./catch-up.js";
12
+ import type { RecoveryFailure, RecoveryRecord } from "./continuity-types.js";
13
+ import { type ReviewOutputState, type ReviewRoundOutcome } from "./github-review-turn-ledger.js";
14
+ import { InboundJournal, type InboundRef } from "./inbound-journal.js";
15
+ import { type MembershipCount, type MembershipResolver } from "./membership.js";
16
+ import { channelsSessionsPath, type ChannelSessionRecord } from "./persistence.js";
17
+ import { RecoveryOutbox } from "./recovery-outbox.js";
18
+ import { type AdapterId, type ChannelAdapterConfig } from "./schema.js";
19
+ import { type ChannelHandoffResult } from "./session-handoff.js";
20
+ import { type SessionActivity, type SessionSearchArgs, type SessionSearchTarget } from "./session-search.js";
21
+ import type { ChannelHistoryMessage, ChannelKey, ChannelNameResolver, ChannelSelfIdentityResolver, EditMessageCallback, EditMessageRequest, EditMessageResult, FetchAttachmentArgs, FetchAttachmentCallback, FetchAttachmentResult, FetchHistoryArgs, FetchHistoryResult, GetMessageArgs, GetMessageResult, HistoryCallback, InboundAttachment, GithubReviewFollowupRound, GithubReviewThreadCloseout, InboundMessage, RouteReceipt, InboundReferenceContext, ListCallback, ListChannelsArgs, ListChannelsResult, MessageGetCallback, RemoveReactionCallback, RemoveReactionRequest, PrepareOwnReactionCallback, RemoveOwnReactionCallback, RemoveOwnReactionRequest, RemoveOwnReactionResult, OutboundCallback, OutboundMessage, QuoteAnchorSource, ReactionCallback, ReactionRef, ReactionRequest, ReactionResult, ResolvedChannelNames, ReviewSubmitter, ReviewStateRequest, ReviewStateResolver, ReviewStateResult, ReviewThreadResolveRequest, ReviewThreadResolveResult, ReviewThreadResolver, SendResult, SubmitReviewRequest, SubmitReviewResult, TypingCallback } from "./types.js";
22
+ import type { RecoveryAdapterCallbacks, RecoveryReconcileResult, RecoveryRedelivery, SendOptions as TransportSendOptions } from "./types.js";
23
+ import { type WaitingReactionHandle } from "./waiting-reactions.js";
24
+ export declare const INITIAL_DEBOUNCE_MS = 600;
25
+ export declare const HOT_DEBOUNCE_MS = 1500;
26
+ export declare const MAX_DEBOUNCE_MS = 4000;
27
+ export declare const HOT_THRESHOLD_MS = 3000;
28
+ export declare const MAX_CONSECUTIVE_ABORTS = 3;
29
+ export declare const CONTEXT_BUFFER_SIZE = 20;
30
+ export declare const OBSERVED_MESSAGE_MAX_CHARS = 800;
31
+ export declare const WAKE_REQUEST_LOOKBACK_MS = 60000;
32
+ export declare const TYPING_HEARTBEAT_MS = 8000;
33
+ export declare const MAX_TYPING_HEARTBEAT_MS: number;
34
+ export declare const SESSION_IDLE_MS: number;
35
+ export declare const SESSION_GC_INTERVAL_MS: number;
36
+ export declare const MAX_CHANNEL_SENDS_PER_TURN = 10;
37
+ export declare const ENGAGE_REACTION_EMOJI = "eyes";
38
+ export declare const CONTINUATION_REACTION_EMOJI = "hourglass_flowing_sand";
39
+ export declare const QUEUED_REACTION_EMOJI = "hourglass_flowing_sand";
40
+ export declare const TURN_FAILED_REACTION_EMOJI = "warning";
41
+ export declare const DISENGAGE_REACTION_EMOJI = "zipper_mouth_face";
42
+ export declare function disengageReactionEmojiFor(adapter: AdapterId): string;
43
+ type PendingProviderError = {
44
+ turnSeq: number;
45
+ safeMessage: string;
46
+ retryAndSee: boolean;
47
+ };
48
+ type SilentAckReason = 'github_review_output' | 'awaiting_background_child';
49
+ export declare const RESTART_RESUME_WAKE_REMINDER: string;
50
+ export declare const MAX_POLICY_DENIED_CHANNEL_SENDS_PER_TURN = 3;
51
+ export declare const CHANNEL_MAX_OUTPUT_TOKENS = 16384;
52
+ export declare const CHANNEL_EMPTY_TURN_RETRY_MAX_OUTPUT_TOKENS = 32768;
53
+ export declare const MAX_EMPTY_TURN_RETRIES = 2;
54
+ export declare const MAX_TOOL_LEAK_RETRIES = 1;
55
+ export declare const TOOL_CALL_LEAK_NUDGE: string;
56
+ export declare const EMPTY_TURN_RETRY_NUDGE: string;
57
+ export declare const STRANDED_TOOLUSE_CONTINUATION_NUDGE: string;
58
+ export declare const EMPTY_TURN_FALLBACK_TEXT = "I got stuck putting together a reply and couldn't finish. Could you rephrase or try again?";
59
+ export declare const GITHUB_REVIEW_THREAD_CLOSEOUT_FALLBACK_TEXT = "I wasn't able to complete this follow-up. Leaving this thread open for manual review.";
60
+ export declare const COLD_START_REPLY_NUDGE: string;
61
+ export declare const EMPTY_STOP_AFTER_TOOL_WORK_NUDGE: string;
62
+ export declare const MAX_WILLINGNESS_NUDGES = 1;
63
+ export declare const WILLINGNESS_NUDGE: string;
64
+ export declare const SEND_WILLINGNESS_NUDGE: string;
65
+ export declare const SEND_RATE_WINDOW_MS = 5000;
66
+ export declare const SEND_RATE_WARN_THRESHOLD = 3;
67
+ export declare const OUTBOUND_FLOOD_ERROR = "outbound message denied: content looks like a repeated-character flood";
68
+ /**
69
+ * Soft freshness boundary: the age of the last engaged inbound past which the
70
+ * provider's server-side KV prompt-cache for this session's prefix is assumed
71
+ * cold. Set to the LLM provider's KV-cache TTL (5 min) so a session reused
72
+ * WITHIN this window is guaranteed a cache hit on the provider side.
73
+ *
74
+ * Reaching this boundary no longer forces an immediate rollover. Between the
75
+ * soft boundary and SESSION_GRACE_HARD_TTL_MS, the live path defers to a
76
+ * cost-aware grace decision (see `isGraceWorthReusing`): a session whose fixed
77
+ * base context (rendered system prompt + injected memory + prefetched channel
78
+ * context) still costs more to rebuild than its accumulated transcript is
79
+ * reused for one more turn rather than torn down. This targets the common
80
+ * channel shape — a human replying a few minutes past the cache TTL — where a
81
+ * full cold-start rebuild of a large memory/index-mode base context dominates
82
+ * the cost of carrying a modest transcript forward.
83
+ *
84
+ * Unlike SESSION_IDLE_MS (which evicts the in-memory entry without rollover), a
85
+ * rollover triggers a full tearDownLive + recreate on the next engaged inbound.
86
+ * The old session's transcript is preserved on disk; only the in-memory live
87
+ * entry and sessions.json pointer are replaced.
88
+ */
89
+ export declare const SESSION_FRESHNESS_TTL_MS: number;
90
+ /**
91
+ * Hard ceiling on the cost-aware grace window. Past this age the live session is
92
+ * rolled over unconditionally regardless of base-vs-transcript cost: the grace
93
+ * decision only defers rollover, it never makes the session immortal. Bounding
94
+ * grace at 2x the soft TTL keeps a never-quite-idle session from accumulating an
95
+ * ever-growing, fully-uncached prefix (every turn past the soft boundary re-sends
96
+ * the whole prefix at no provider-cache discount) and prevents grace from
97
+ * silently becoming an unbounded TTL increase.
98
+ */
99
+ export declare const SESSION_GRACE_HARD_TTL_MS: number;
100
+ /**
101
+ * Leak guard — NOT a freshness cap. A running background subagent pins its parent
102
+ * channel session against idle GC and stale-rollover for as long as the child is
103
+ * actually running, because the next inbound would otherwise start a fresh session
104
+ * that has lost track of the in-flight task and spawns a DUPLICATE child, and — the
105
+ * bug this backstop is sized around — a completion arriving after teardown has no
106
+ * live session to deliver its system-reminder to and is silently dropped.
107
+ *
108
+ * The pin is bounded only so a genuinely stuck/wedged child cannot make the session
109
+ * immortal. Subagent `timeoutMs` is optional (operator declares none), so a hung
110
+ * child stays `status: 'running'` forever; without this ceiling its parent session
111
+ * would leak indefinitely. Past this age the child is treated as stuck: GC/rollover
112
+ * proceeds and the session falls back to completion-reroute.
113
+ *
114
+ * Sized as an ANOMALY threshold, deliberately far above any legitimate run (deep
115
+ * operator work is minutes-to-an-hour, not hours), so it never fires for real work.
116
+ * The prior 45m value was close enough to plausible deep work to turn a legitimate
117
+ * long run into a routine drop — the reported 65m completion loss. 6h is clearly
118
+ * "this child is wedged," not "this child is busy".
119
+ */
120
+ export declare const SESSION_CHILD_STUCK_BACKSTOP_MS: number;
121
+ /**
122
+ * Cost-aware grace decision for the soft→hard TTL band. Returns true when reusing
123
+ * the (now cache-cold) live session is cheaper than a fresh cold-start.
124
+ *
125
+ * After the soft TTL the provider prefix is cold either way, so the choice is:
126
+ * - rollover: pay to rebuild the fixed base context (system prompt + memory +
127
+ * prefetched context) plus a fresh first model call, OR
128
+ * - reuse: re-send the cold base context PLUS the accumulated transcript.
129
+ *
130
+ * Rollover only wins once the transcript a reused session would carry forward
131
+ * exceeds the base context a rollover would rebuild. We approximate both with the
132
+ * session transcript file: `baseContextBytes` is its size captured right after
133
+ * cold-start (the rendered prompt before any user turn), and the live delta is
134
+ * the growth since. While `baseContextBytes > transcriptDeltaBytes`, the fixed
135
+ * rebuild is the larger cost and grace is worth it. A `baseContextBytes` of 0
136
+ * (no transcript path available) disables grace — fail closed to the prior
137
+ * roll-over-at-soft-TTL behavior.
138
+ */
139
+ export declare function isGraceWorthReusing(baseContextBytes: number, transcriptDeltaBytes: number): boolean;
140
+ export declare const ENSURE_LIVE_TIMEOUT_MS = 30000;
141
+ export declare class StaleLiveSessionError extends Error {
142
+ constructor(keyId: string);
143
+ }
144
+ export declare const RESOLVE_CHANNEL_NAMES_TIMEOUT_MS = 5000;
145
+ export declare const FETCH_HISTORY_TIMEOUT_MS = 5000;
146
+ export declare const HISTORY_ATTACHMENT_LIMIT = 50;
147
+ export declare const SESSION_IDLE_TIMEOUT_MS = 30000;
148
+ export declare const PEER_BOT_TURNS_WINDOW_MS = 60000;
149
+ export declare const MAX_PEER_BOT_TURNS_IN_WINDOW = 5;
150
+ export declare const MAX_CONSECUTIVE_PEER_BOT_TURNS_SINCE_HUMAN = 5;
151
+ export type RouterLogger = {
152
+ info: (msg: string) => void;
153
+ warn: (msg: string) => void;
154
+ error: (msg: string) => void;
155
+ };
156
+ export type CreateSessionForChannel = (params: {
157
+ key: ChannelKey;
158
+ existingSessionId?: string;
159
+ existingSessionFile?: string;
160
+ participants: readonly ChannelParticipant[];
161
+ origin: SessionOrigin;
162
+ originRef: {
163
+ current: SessionOrigin | undefined;
164
+ };
165
+ }) => Promise<{
166
+ session: ChannelAgentSession;
167
+ sessionId: string;
168
+ dispose: () => Promise<void>;
169
+ hooks?: HookBus;
170
+ getTranscriptPath?: () => string | undefined;
171
+ }>;
172
+ export type ConfigForAdapter = (adapter: ChannelKey['adapter']) => ChannelAdapterConfig | undefined;
173
+ export type { ChannelHandoffResult } from "./session-handoff.js";
174
+ type QueuedInbound = {
175
+ inputId: string;
176
+ text: string;
177
+ referenceContext?: InboundReferenceContext;
178
+ attachments?: readonly InboundAttachment[];
179
+ authorId: string;
180
+ authorAdapter?: AdapterId;
181
+ authorName: string;
182
+ authorIsBot: boolean;
183
+ externalMessageId: string;
184
+ reactionRef?: ReactionRef;
185
+ engageReaction?: WaitingReactionHandle;
186
+ isBotMention: boolean;
187
+ isBotMentionOnly?: boolean;
188
+ replyToBotMessageId: string | null;
189
+ isDm: boolean;
190
+ typingThread?: string;
191
+ receivedAt: number;
192
+ ts: number;
193
+ githubReviewRound?: GithubReviewFollowupRound;
194
+ githubReviewThreadCloseout?: GithubReviewThreadCloseout;
195
+ routingNote?: string;
196
+ handoff?: true;
197
+ };
198
+ type ObservedInbound = {
199
+ text: string;
200
+ referenceContext?: InboundReferenceContext;
201
+ attachments?: readonly InboundAttachment[];
202
+ authorId: string;
203
+ authorName: string;
204
+ authorIsBot: boolean;
205
+ receivedAt: number;
206
+ ts: number;
207
+ source: 'prefetch' | 'observed';
208
+ };
209
+ type TimedAttachment = {
210
+ ts: number;
211
+ attachment: InboundAttachment;
212
+ current?: boolean;
213
+ };
214
+ type ChannelAgentSession = AgentSession & {
215
+ getAbortReason?: () => string | undefined;
216
+ };
217
+ type PendingSystemReminder = {
218
+ text: string;
219
+ kind: 'retry' | 'wakeup';
220
+ githubReviewRoundKey?: string;
221
+ backgroundObligationId?: string;
222
+ backgroundWake?: boolean;
223
+ inboundRetry?: {
224
+ inputIds: string[];
225
+ turnId: string;
226
+ };
227
+ backgroundRetry?: {
228
+ turnId: string;
229
+ obligationIds: string[];
230
+ emptyTurnRetries: number;
231
+ toolLeakRetries: number;
232
+ willingnessNudges: number;
233
+ nextPromptMaxTokens: number | undefined;
234
+ };
235
+ };
236
+ type LiveSession = {
237
+ key: ChannelKey;
238
+ keyId: string;
239
+ room: InboundMessage['room'];
240
+ session: ChannelAgentSession;
241
+ activeModelRef: ReturnType<typeof resolveFallbackChain>[number];
242
+ turnThinkingDefault: AgentSession['thinkingLevel'];
243
+ lastQuestionSignal: QuestionSignal | null;
244
+ pendingUserTurnSignal: {
245
+ signal: QuestionSignal;
246
+ } | null;
247
+ sessionId: string;
248
+ dispose: () => Promise<void>;
249
+ hooks: HookBus | undefined;
250
+ getTranscriptPath: (() => string | undefined) | undefined;
251
+ participants: ChannelParticipant[];
252
+ resolvedNames: ResolvedChannelNames;
253
+ originRef: {
254
+ current: SessionOrigin | undefined;
255
+ };
256
+ githubReviewRound: GithubReviewFollowupRound | null;
257
+ githubReviewThreadCloseout: (GithubReviewThreadCloseout & {
258
+ startedAt: number;
259
+ correctionAttempts: number;
260
+ deferred: boolean;
261
+ }) | null;
262
+ githubReviewThreadCloseoutDecisionTurn: number | null;
263
+ pendingGithubReviewRoundCloseout: string | null;
264
+ promptQueue: QueuedInbound[];
265
+ contextBuffer: ObservedInbound[];
266
+ currentTurnAttachments: readonly TimedAttachment[];
267
+ historyTimedAttachments: readonly TimedAttachment[];
268
+ draining: boolean;
269
+ activeDrains: Set<Promise<void>>;
270
+ debounceTimer: ReturnType<typeof setTimeout> | null;
271
+ typingTimer: ReturnType<typeof setInterval> | null;
272
+ typingStartedAt: number;
273
+ typingTimedOut: boolean;
274
+ typingStopPromise: Promise<void> | null;
275
+ typingEpoch: number;
276
+ promptInFlight: boolean;
277
+ lastInboundAt: number;
278
+ recentMessages: SessionActivity[];
279
+ baseContextBytes: number;
280
+ firstUnprocessedAt: number;
281
+ currentTurnAuthorId: string | null;
282
+ currentTurnAuthorAdapter: AdapterId;
283
+ currentTurnAuthorIds: Set<string>;
284
+ currentTurnReactionRef: ReactionRef | null;
285
+ currentTurnExplicitlyAddressed: boolean;
286
+ currentTurnHandoff: boolean;
287
+ lastInboundIsDm: boolean;
288
+ originHintedKeys: Set<string>;
289
+ currentTurnTypingThread: string | null;
290
+ dirtyTypingThreads: Set<string>;
291
+ currentTurnEngageReactions: WaitingReactionHandle[];
292
+ pendingTurnReactions: ReactionRequest[];
293
+ silentAckTurn: {
294
+ turnSeq: number;
295
+ reason: SilentAckReason;
296
+ } | null;
297
+ activeContinuationReactions: WaitingReactionHandle[];
298
+ lastTurnAuthorIds: Set<string>;
299
+ lastTurnAuthorId: string | null;
300
+ lastTurnAuthorAdapter: AdapterId;
301
+ lastTurnHandoff: boolean;
302
+ consecutiveAborts: number;
303
+ pendingSystemReminders: PendingSystemReminder[];
304
+ backgroundCoverage: string[];
305
+ inboundCoverage: string[];
306
+ turnAccountIdentity?: string;
307
+ backgroundTurnId: string;
308
+ backgroundTurnOwnerSessionId: string;
309
+ backgroundStopVersion: number;
310
+ willingnessReminderIteration: boolean;
311
+ consecutiveSends: Map<string, number>;
312
+ lastSentText: Map<string, string>;
313
+ lastSendLeafId: string | null;
314
+ sendTimestamps: Map<string, number[]>;
315
+ successfulChannelSends: number;
316
+ turnSeq: number;
317
+ logicalTurnStartedAt: number;
318
+ coverageDeferredSince: number | null;
319
+ coverageDeferredParentSessionId: string | null;
320
+ successfulSendsAtTurnStart: number;
321
+ inFlightToolSends: Map<string, number>;
322
+ policyDeniedToolSendsThisTurn: Map<string, number>;
323
+ emptyTurnRetries: number;
324
+ toolLeakRetries: number;
325
+ emptyStopAfterToolWorkArmed: boolean;
326
+ willingnessNudges: number;
327
+ lastTerminalReplyCompletion: {
328
+ turnSeq: number;
329
+ text?: string;
330
+ tokens: number;
331
+ } | null;
332
+ pendingTerminalReplyStop: {
333
+ turnSeq: number;
334
+ tokens: number;
335
+ } | null;
336
+ continueReplyTurn: {
337
+ turnSeq: number;
338
+ sendCount: number;
339
+ } | null;
340
+ abortReasonThisTurn: {
341
+ turnSeq: number;
342
+ reason: string;
343
+ } | null;
344
+ userStoppedTurnSeq: number | null;
345
+ nextPromptMaxTokens: number | undefined;
346
+ skippedTurn: {
347
+ turnSeq: number;
348
+ reason: string;
349
+ } | null;
350
+ skipLockedSendTurn: number | null;
351
+ disengagedTurn: number | null;
352
+ emptyTurnFallbackTurn: number | null;
353
+ stagedFallbackCause: {
354
+ cause: string;
355
+ sendCountAtStage: number;
356
+ } | null;
357
+ githubReviewOutputTurn: number | null;
358
+ toolExecutionThisLogicalTurn: boolean;
359
+ backgroundWakeLogicalTurn: boolean;
360
+ providerErrorSilencedThisLogicalTurn: boolean;
361
+ qualifyingWorkThisLogicalTurn: boolean;
362
+ promisedWorkOutstandingThisLogicalTurn: boolean;
363
+ statusOutputOutstandingThisLogicalTurn: boolean;
364
+ nextInboundContinuationTurnId: string | null;
365
+ pendingQuoteCandidate: QuoteAnchorCandidate | null;
366
+ recentEngagedPeerBotTurns: {
367
+ authorId: string;
368
+ ts: number;
369
+ }[];
370
+ consecutiveEngagedPeerBotTurns: number;
371
+ loopGuardActive: boolean;
372
+ multiHumanGroup: boolean;
373
+ createdFromColdStart: boolean;
374
+ coldStartSoloFallbackTurnActive: boolean;
375
+ membershipFetch: Promise<MembershipCount | null> | null;
376
+ pendingProviderError: PendingProviderError | null;
377
+ destroyed: boolean;
378
+ pendingTeardown: boolean;
379
+ unsubProviderErrors: (() => void) | null;
380
+ unsubTypingActivity: (() => void) | null;
381
+ unsubTodoOutcome: (() => void) | null;
382
+ todoOutcomeWrite: Promise<boolean>;
383
+ };
384
+ export type ExecuteCommandResult = {
385
+ kind: 'handled';
386
+ name: string;
387
+ reply?: string;
388
+ } | {
389
+ kind: 'unknown-command';
390
+ name: string;
391
+ } | {
392
+ kind: 'no-live-session';
393
+ } | {
394
+ kind: 'permission-denied';
395
+ } | {
396
+ kind: 'ambiguous';
397
+ matchCount: number;
398
+ };
399
+ export type ExecuteCommandOptions = {
400
+ invokerId: string;
401
+ parentChat?: string;
402
+ };
403
+ export type SendSource = 'tool' | 'system';
404
+ export type SendOptions = TransportSendOptions & {
405
+ source?: SendSource;
406
+ accountingTarget?: ChannelKey;
407
+ outputKind?: 'substantive' | 'status' | 'meta';
408
+ origin?: ChannelOutboundOrigin;
409
+ };
410
+ export type EditMessageOptions = {
411
+ origin?: ChannelOutboundOrigin;
412
+ };
413
+ export type ChannelOutboundReviewer = (event: ChannelOutboundBeforeEvent) => Promise<{
414
+ text: string;
415
+ }>;
416
+ export declare const DUPLICATE_SEND_ERROR: string;
417
+ export declare const TURN_CAP_ERROR: string;
418
+ export declare const SKIP_RESPONSE_LOCK_ERROR: string;
419
+ export type ChannelRouter = {
420
+ registerMissedInbound: (adapter: AdapterId, callback: ListMissedInbound) => void;
421
+ unregisterMissedInbound: (adapter: AdapterId, callback: ListMissedInbound) => void;
422
+ catchUp: (adapter: AdapterId) => Promise<void>;
423
+ disconnectCatchUp: (adapter: AdapterId) => void;
424
+ catchUpTargets: (adapter: AdapterId) => Promise<readonly ChannelKey[]>;
425
+ route: (event: InboundMessage, onAdmitted?: () => Promise<void>) => Promise<RouteReceipt>;
426
+ send: (msg: OutboundMessage, opts?: SendOptions) => Promise<SendResult>;
427
+ acceptBackgroundResponse: (args: {
428
+ parentSessionId: string;
429
+ parentSessionFile?: string;
430
+ key: ChannelKey;
431
+ taskId: string;
432
+ subagentName: string;
433
+ startedAt: number;
434
+ accountIdentity: string;
435
+ triggeringAuthorId?: string;
436
+ parentChat?: string;
437
+ }) => Promise<BackgroundObligationRef>;
438
+ suppressUnstartedBackgroundResponse: (ref: BackgroundObligationRef, reason: string) => Promise<void>;
439
+ attachBackgroundResultCoverage: (args: {
440
+ parentSessionId: string;
441
+ taskId: string;
442
+ }) => Promise<void>;
443
+ captureBackgroundResultCoverage?: (parentSessionId: string) => Promise<BackgroundObligationRef[]>;
444
+ captureInboundResultCoverage?: (parentSessionId: string) => Promise<InboundRef[]>;
445
+ captureTurnAccountIdentity?: (parentSessionId: string, adapter: ChannelKey['adapter']) => Promise<string | undefined>;
446
+ getConsecutiveSendCount: (target: {
447
+ adapter: ChannelKey['adapter'];
448
+ workspace: string;
449
+ chat: string;
450
+ thread?: string | null;
451
+ }) => number;
452
+ hasQualifyingWorkThisLogicalTurn?: (target: ChannelKey) => boolean;
453
+ getSendRate: (target: {
454
+ adapter: ChannelKey['adapter'];
455
+ workspace: string;
456
+ chat: string;
457
+ thread?: string | null;
458
+ }) => {
459
+ count: number;
460
+ windowMs: number;
461
+ };
462
+ registerOutbound: (adapter: ChannelKey['adapter'], cb: OutboundCallback) => void;
463
+ unregisterOutbound: (adapter: ChannelKey['adapter'], cb: OutboundCallback) => void;
464
+ registerRecoveryAdapter: (adapter: ChannelKey['adapter'], callbacks: RecoveryAdapterCallbacks) => void;
465
+ unregisterRecoveryAdapter: (adapter: ChannelKey['adapter'], callbacks: RecoveryAdapterCallbacks) => void;
466
+ getRecoveryAccountIdentity: (adapter: ChannelKey['adapter'], workspace?: string) => Promise<string | undefined>;
467
+ validateRecovery: (record: RecoveryRecord) => Promise<RecoveryFailure | undefined>;
468
+ reconcileRecovery: (record: RecoveryRecord) => Promise<RecoveryReconcileResult>;
469
+ recoveryRedelivery?: (record: RecoveryRecord, eventKinds: readonly string[]) => RecoveryRedelivery;
470
+ setRecoveryStopHandler: (handler: (target: ChannelKey, parentSessionId: string) => Promise<void>) => void;
471
+ registerReaction: (adapter: ChannelKey['adapter'], cb: ReactionCallback) => void;
472
+ unregisterReaction: (adapter: ChannelKey['adapter'], cb: ReactionCallback) => void;
473
+ react: (req: ReactionRequest) => Promise<ReactionResult>;
474
+ queueReactionAfterReply: (req: ReactionRequest) => Promise<ReactionResult>;
475
+ registerRemoveReaction: (adapter: ChannelKey['adapter'], cb: RemoveReactionCallback) => void;
476
+ unregisterRemoveReaction: (adapter: ChannelKey['adapter'], cb: RemoveReactionCallback) => void;
477
+ removeReaction: (req: RemoveReactionRequest) => Promise<ReactionResult>;
478
+ registerPrepareOwnReaction: (adapter: ChannelKey['adapter'], cb: PrepareOwnReactionCallback) => void;
479
+ unregisterPrepareOwnReaction: (adapter: ChannelKey['adapter'], cb: PrepareOwnReactionCallback) => void;
480
+ registerRemoveOwnReaction: (adapter: ChannelKey['adapter'], cb: RemoveOwnReactionCallback) => void;
481
+ unregisterRemoveOwnReaction: (adapter: ChannelKey['adapter'], cb: RemoveOwnReactionCallback) => void;
482
+ removeOwnReaction: (req: RemoveOwnReactionRequest) => Promise<RemoveOwnReactionResult>;
483
+ recoverWaitingReactions: (adapter?: ChannelKey['adapter']) => Promise<void>;
484
+ registerTyping: (adapter: ChannelKey['adapter'], cb: TypingCallback) => void;
485
+ unregisterTyping: (adapter: ChannelKey['adapter'], cb: TypingCallback) => void;
486
+ setTypingCapability: (adapter: ChannelKey['adapter'], supported: boolean) => void;
487
+ setTypingHeartbeatInterval: (adapter: ChannelKey['adapter'], intervalMs: number) => void;
488
+ setAdapterConfigured: (adapter: ChannelKey['adapter'], configured: boolean) => void;
489
+ registerChannelNameResolver: (adapter: ChannelKey['adapter'], resolver: ChannelNameResolver) => void;
490
+ unregisterChannelNameResolver: (adapter: ChannelKey['adapter'], resolver: ChannelNameResolver) => void;
491
+ registerSelfIdentity: (adapter: ChannelKey['adapter'], resolver: ChannelSelfIdentityResolver) => void;
492
+ unregisterSelfIdentity: (adapter: ChannelKey['adapter'], resolver: ChannelSelfIdentityResolver) => void;
493
+ registerMembership: (adapter: ChannelKey['adapter'], resolver: MembershipResolver) => void;
494
+ unregisterMembership: (adapter: ChannelKey['adapter'], resolver: MembershipResolver) => void;
495
+ registerHistory: (adapter: ChannelKey['adapter'], cb: HistoryCallback) => void;
496
+ unregisterHistory: (adapter: ChannelKey['adapter'], cb: HistoryCallback) => void;
497
+ fetchHistory: (adapter: ChannelKey['adapter'], args: FetchHistoryArgs) => Promise<FetchHistoryResult>;
498
+ registerMessageGet: (adapter: ChannelKey['adapter'], cb: MessageGetCallback) => void;
499
+ unregisterMessageGet: (adapter: ChannelKey['adapter'], cb: MessageGetCallback) => void;
500
+ getMessage: (adapter: ChannelKey['adapter'], args: GetMessageArgs) => Promise<GetMessageResult>;
501
+ registerList: (adapter: ChannelKey['adapter'], cb: ListCallback) => void;
502
+ unregisterList: (adapter: ChannelKey['adapter'], cb: ListCallback) => void;
503
+ listChannels: (adapter: ChannelKey['adapter'], args: ListChannelsArgs) => Promise<ListChannelsResult>;
504
+ registerEditMessage: (adapter: ChannelKey['adapter'], cb: EditMessageCallback) => void;
505
+ unregisterEditMessage: (adapter: ChannelKey['adapter'], cb: EditMessageCallback) => void;
506
+ editMessage: (req: EditMessageRequest, opts?: EditMessageOptions) => Promise<EditMessageResult>;
507
+ reviewOutbound: (event: ChannelOutboundBeforeEvent) => Promise<string>;
508
+ hasOutboundReviewer: () => boolean;
509
+ registerFetchAttachment: (adapter: ChannelKey['adapter'], cb: FetchAttachmentCallback) => void;
510
+ unregisterFetchAttachment: (adapter: ChannelKey['adapter'], cb: FetchAttachmentCallback) => void;
511
+ fetchAttachment: (adapter: ChannelKey['adapter'], args: FetchAttachmentArgs) => Promise<FetchAttachmentResult>;
512
+ registerReviewThreadResolver: (adapter: ChannelKey['adapter'], resolver: ReviewThreadResolver) => void;
513
+ unregisterReviewThreadResolver: (adapter: ChannelKey['adapter'], resolver: ReviewThreadResolver) => void;
514
+ resolveReviewThread: (req: ReviewThreadResolveRequest) => Promise<ReviewThreadResolveResult>;
515
+ registerReviewStateResolver: (adapter: ChannelKey['adapter'], resolver: ReviewStateResolver) => void;
516
+ unregisterReviewStateResolver: (adapter: ChannelKey['adapter'], resolver: ReviewStateResolver) => void;
517
+ getReviewState: (req: ReviewStateRequest) => Promise<ReviewStateResult>;
518
+ registerReviewSubmitter: (adapter: ChannelKey['adapter'], submitter: ReviewSubmitter) => void;
519
+ unregisterReviewSubmitter: (adapter: ChannelKey['adapter'], submitter: ReviewSubmitter) => void;
520
+ submitReview: (req: SubmitReviewRequest) => Promise<SubmitReviewResult>;
521
+ lookupInboundAttachment: (args: ChannelKey & {
522
+ id: number;
523
+ ref?: string;
524
+ }) => InboundAttachment | null;
525
+ listInboundAttachmentIds: (args: ChannelKey) => readonly number[];
526
+ registerHistoryAttachments: (key: ChannelKey, messages: readonly ChannelHistoryMessage[]) => void;
527
+ executeCommand: (key: ChannelKey, name: string, options: ExecuteCommandOptions) => Promise<ExecuteCommandResult>;
528
+ getSelfAliases: () => readonly string[];
529
+ handoff: (args: {
530
+ fromSessionId: string;
531
+ target: ChannelKey;
532
+ text: string;
533
+ }) => Promise<ChannelHandoffResult>;
534
+ searchSessions: (args: SessionSearchArgs) => SessionSearchTarget[];
535
+ injectSubagentCompletionReminder: (args: {
536
+ parentSessionId: string;
537
+ subagent: string;
538
+ taskId: string;
539
+ ok: boolean;
540
+ durationMs: number;
541
+ error?: string;
542
+ channelKey?: {
543
+ adapter: string;
544
+ workspace: string;
545
+ chat: string;
546
+ thread: string | null;
547
+ };
548
+ }) => Promise<{
549
+ kind: 'delivered';
550
+ keyId: string;
551
+ } | {
552
+ kind: 'no-live-session';
553
+ }>;
554
+ injectPrVerdictActivity: (args: {
555
+ workspace: string;
556
+ prNumber: number;
557
+ verdict: ReviewRoundOutcome;
558
+ sessionId: string;
559
+ }) => {
560
+ kind: 'delivered';
561
+ count: number;
562
+ };
563
+ abortGithubPrTurn?: (workspace: string, prNumber: number, reason: string) => Promise<{
564
+ kind: 'aborted';
565
+ matchedSessions: number;
566
+ matchedReviewers: number;
567
+ abortFailures: number;
568
+ } | {
569
+ kind: 'no-live-session';
570
+ }>;
571
+ completeGithubReviewRound?: (args: {
572
+ workspace: string;
573
+ prNumber: number;
574
+ verdict: ReviewRoundOutcome;
575
+ sessionId: string;
576
+ commitSha?: string;
577
+ }) => Promise<{
578
+ kind: 'completed' | 'no-round';
579
+ }>;
580
+ finishGithubReviewThreadCloseout?: (args: {
581
+ sessionId: string;
582
+ workspace: string;
583
+ prNumber: number;
584
+ thread: string | null;
585
+ decision: 'resolved' | 'left-open';
586
+ }) => void;
587
+ noteGithubReviewOutput: (args: {
588
+ sessionId: string;
589
+ workspace: string;
590
+ prNumber: number;
591
+ state: ReviewOutputState;
592
+ inboundCoverage?: InboundRef[];
593
+ backgroundCoverage?: BackgroundObligationRef[];
594
+ }) => Promise<{
595
+ kind: 'stamped' | 'no-live-session';
596
+ }>;
597
+ hasOutstandingGithubReviewThreadCloseout?: (sessionId: string) => boolean;
598
+ markTurnSkipped: (args: {
599
+ parentSessionId: string;
600
+ reason: string;
601
+ }) => Promise<{
602
+ kind: 'recorded';
603
+ keyId: string;
604
+ } | {
605
+ kind: 'recorded-after-send';
606
+ keyId: string;
607
+ } | {
608
+ kind: 'no-live-session';
609
+ }>;
610
+ clearSticky: (key: ChannelKey) => {
611
+ keyId: string;
612
+ cleared: number;
613
+ };
614
+ reserveRestartHandoff: (handoff: RestartHandoff) => RestartReservation | null;
615
+ resumeRestartHandoff: (handoff: RestartHandoff) => Promise<void>;
616
+ stop: () => Promise<void>;
617
+ tearDownAllLive: () => Promise<void>;
618
+ markRestartAbortForAllLive: () => Promise<void>;
619
+ liveCount: () => number;
620
+ __testing?: {
621
+ getRecoveryAccountingSnapshot: (key: ChannelKey) => Record<string, unknown> | undefined;
622
+ flushDebounce: (key: ChannelKey) => Promise<void>;
623
+ fireTypingHeartbeat: (key: ChannelKey, phase?: 'tick' | 'stop') => Promise<void>;
624
+ fireTypingInterval: (key: ChannelKey) => Promise<void>;
625
+ fireTypingTick: (key: ChannelKey, epoch: number) => Promise<void>;
626
+ typingEpoch: (key: ChannelKey) => number | undefined;
627
+ isTypingActive: (key: ChannelKey) => boolean;
628
+ stopTyping: (key: ChannelKey) => Promise<void>;
629
+ typingHeartbeatIntervalFor: (adapter: ChannelKey['adapter']) => number;
630
+ githubReviewRoundFor: (key: ChannelKey) => GithubReviewFollowupRound | null | undefined;
631
+ pendingReminderCount: (key: ChannelKey) => number | undefined;
632
+ creationTokenCount: () => number;
633
+ runIdleGc: () => Promise<void>;
634
+ getLiveAuthorState: (key: ChannelKey) => {
635
+ currentTurnAuthorId: string | null;
636
+ currentTurnAuthorIds: readonly string[];
637
+ lastTurnAuthorId: string | null;
638
+ lastTurnAuthorIds: readonly string[];
639
+ } | undefined;
640
+ injectContinuationReminder: (key: ChannelKey, text: string) => void;
641
+ getLiveOriginSnapshot: (key: ChannelKey) => SessionOrigin | undefined;
642
+ };
643
+ };
644
+ export type AliasesProvider = () => readonly string[];
645
+ export type CreateChannelRouterOptions = {
646
+ agentDir: string;
647
+ bootEpoch?: string;
648
+ backgroundObligations?: BackgroundObligationStore;
649
+ inboundJournal?: InboundJournal;
650
+ recoveryOutbox?: RecoveryOutbox;
651
+ configForAdapter: ConfigForAdapter;
652
+ configuredAliases?: AliasesProvider;
653
+ createSessionForChannel?: CreateSessionForChannel;
654
+ sessionDir?: string;
655
+ logger?: RouterLogger;
656
+ now?: () => number;
657
+ retryRandom?: () => number;
658
+ onRetryBackoffStart?: () => void;
659
+ measureTranscriptBytes?: (path: string) => number;
660
+ runIdleContinuation?: typeof runIdleContinuation;
661
+ recordTurnOutcome?: typeof recordTurnOutcome;
662
+ ensureLiveTimeoutMs?: number;
663
+ handoffRetryRetentionMs?: number;
664
+ handoffRetryItemLimit?: number;
665
+ handoffRetryByteLimit?: number;
666
+ resolveChannelNamesTimeoutMs?: number;
667
+ fetchHistoryTimeoutMs?: number;
668
+ sessionIdleTimeoutMs?: number;
669
+ permissions?: PermissionService;
670
+ claimHandler?: ClaimHandler;
671
+ stream?: Stream;
672
+ onReload?: () => Promise<string>;
673
+ onRestart?: (ctx?: RestartCommandContext) => Promise<string>;
674
+ saveChannelSessions?: (agentDir: string, sessions: readonly ChannelSessionRecord[]) => Promise<void>;
675
+ newestRunningChildSubagentStartedAt?: (sessionId: string) => number | null;
676
+ cancelRunningSubagentsByWorkKey?: (workKey: string, reason: string) => Promise<{
677
+ matched: number;
678
+ cancelled: number;
679
+ failures: number;
680
+ }>;
681
+ reviewOutbound?: ChannelOutboundReviewer;
682
+ outboundReviewerActive?: () => boolean;
683
+ };
684
+ export type RestartCommandContext = {
685
+ originatingSessionId: string;
686
+ originatingSessionFile?: string;
687
+ handoffOrigin: {
688
+ kind: 'channel';
689
+ key: ChannelKey;
690
+ };
691
+ triggeringAuthorId?: string;
692
+ };
693
+ export type ClaimHandlerInput = {
694
+ adapter: ChannelKey['adapter'];
695
+ workspace: string;
696
+ chat: string;
697
+ isDm: boolean;
698
+ authorId: string;
699
+ text: string;
700
+ };
701
+ export type ClaimHandlerOutcome = {
702
+ kind: 'consumed';
703
+ reply: string;
704
+ } | {
705
+ kind: 'fail';
706
+ reply: string;
707
+ } | {
708
+ kind: 'fallthrough';
709
+ };
710
+ export type RestartReservation = {
711
+ keyId: string;
712
+ sawInbound: boolean;
713
+ resume: () => Promise<void>;
714
+ release: () => void;
715
+ };
716
+ export type ClaimHandler = (input: ClaimHandlerInput) => Promise<ClaimHandlerOutcome>;
717
+ export declare function createChannelRouter(options: CreateChannelRouterOptions): ChannelRouter;
718
+ export declare function composeTurnPrompt(observed: readonly ObservedInbound[], batch: readonly QueuedInbound[], state?: {
719
+ adapter?: AdapterId;
720
+ loopGuardActive: boolean;
721
+ groupChatNudge?: boolean;
722
+ systemReminders?: readonly string[];
723
+ now?: Date;
724
+ role?: string;
725
+ }): string;
726
+ export type { QuoteAnchorSource } from "./types.js";
727
+ export declare function formatAuthorAttribution(adapter: AdapterId, authorId: string, authorName: string): string;
728
+ export declare function renderQuoteAnchor(source: QuoteAnchorSource): string;
729
+ export declare function prependQuoteAnchor(replyText: string, source: QuoteAnchorSource): string;
730
+ type QuoteAnchorBatchEntry = {
731
+ text: string;
732
+ authorId: string;
733
+ authorName: string;
734
+ authorIsBot: boolean;
735
+ receivedAt: number;
736
+ externalMessageId: string;
737
+ };
738
+ type QuoteAnchorObservedEntry = {
739
+ receivedAt: number;
740
+ source: 'prefetch' | 'observed';
741
+ };
742
+ export type QuoteAnchorCandidate = {
743
+ source: QuoteAnchorSource;
744
+ externalMessageId: string;
745
+ primaryReceivedAt: number;
746
+ hadInterveningObserved: boolean;
747
+ };
748
+ export type QuoteAnchorTarget = {
749
+ source: QuoteAnchorSource;
750
+ externalMessageId: string;
751
+ };
752
+ export declare function stripChannelMediaPlaceholders(text: string): string;
753
+ export declare function captureQuoteCandidate(adapter: AdapterId, batch: readonly QuoteAnchorBatchEntry[], observed: readonly QuoteAnchorObservedEntry[]): QuoteAnchorCandidate | null;
754
+ export declare function decideQuoteAnchor(candidate: QuoteAnchorCandidate | null, _nowMs: number, adapterConfig: ChannelAdapterConfig | undefined): QuoteAnchorTarget | null;
755
+ export type ReplyRenderMode = 'native' | 'quote';
756
+ export declare function resolveReplyRenderMode(msg: OutboundMessage): ReplyRenderMode;
757
+ type Sliced = {
758
+ kind: 'message';
759
+ message: ChannelHistoryMessage;
760
+ } | {
761
+ kind: 'elision';
762
+ elidedCount: number;
763
+ };
764
+ export declare function sliceHeadTail(messages: readonly ChannelHistoryMessage[], head: number, tail: number): Sliced[];
765
+ export type ResolveLiveSessionResult = {
766
+ kind: 'found';
767
+ session: LiveSession;
768
+ } | {
769
+ kind: 'none';
770
+ } | {
771
+ kind: 'ambiguous';
772
+ count: number;
773
+ };
774
+ export declare function resolveLiveSessionForCommand(liveSessions: ReadonlyMap<string, LiveSession>, key: ChannelKey): ResolveLiveSessionResult;
775
+ export declare function stripThinkBlocks(text: string): string;
776
+ export declare function isNoReplySignal(text: string): boolean;
777
+ export declare function endsWithNoReplySignal(text: string): boolean;
778
+ export declare function isUpstreamEmptyResponseSentinel(text: string): boolean;
779
+ export declare function containsKimiToolDelimiter(text: string): boolean;
780
+ export declare function isLikelyKimiChannelToolLeak(text: string): boolean;
781
+ export type PlainTextChannelToolCallKind = 'reply' | 'send' | 'suppress-silent' | 'suppress-warn';
782
+ export declare function getPlainTextChannelToolCallKind(text: string): PlainTextChannelToolCallKind | null;
783
+ export declare function isLikelyPlainTextChannelToolCall(text: string): boolean;
784
+ export declare function isWholeMessageToolCall(text: string): string | null;
785
+ export type JsonToolCallLeak = {
786
+ toolName: string;
787
+ params: Record<string, unknown>;
788
+ };
789
+ export declare function parseWholeMessageJsonToolCall(text: string): JsonToolCallLeak | null;
790
+ export type TrailingToolCallLeak = {
791
+ text: string;
792
+ toolName: string;
793
+ leakedCall: string;
794
+ };
795
+ export declare function stripTrailingLeakedToolCall(text: string): TrailingToolCallLeak | null;
796
+ export declare function extractPlainTextChannelToolCallText(text: string): string | null;
797
+ export type { ChannelSessionRecord };
798
+ export { channelsSessionsPath };