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
@@ -295,12 +295,19 @@ export const DEFAULT_GITHUB_REVIEW_ON: GithubReviewOn = 'review_requested'
295
295
  // Enforced in the inbound text rather than at the bash layer because the
296
296
  // review posts via `gh api --input <file>`, so the `event` value lives in a
297
297
  // temp file the command interceptor never sees.
298
+ //
299
+ // `check` shows the agent's own review as a check named after the agent's
300
+ // GitHub login (`slug` for an App's `slug[bot]`) on the
301
+ // reviewed commit (in progress while reviewing, then the verdict). On by
302
+ // default; a token without check/status write permission skips it silently
303
+ // after one operator warning.
298
304
  const githubReviewSchema = z
299
305
  .object({
300
306
  on: z.enum(GITHUB_REVIEW_ON_VALUES).default(DEFAULT_GITHUB_REVIEW_ON),
301
307
  approve: z.boolean().default(true),
308
+ check: z.boolean().default(true),
302
309
  })
303
- .default({ on: DEFAULT_GITHUB_REVIEW_ON, approve: true })
310
+ .default({ on: DEFAULT_GITHUB_REVIEW_ON, approve: true, check: true })
304
311
 
305
312
  const githubChannelSchema = adapterSchema.extend({
306
313
  // Optional now (PR 2): when omitted and a `tunnels[]` entry with
@@ -0,0 +1,144 @@
1
+ import { mkdtemp, rm } from 'node:fs/promises'
2
+ import { tmpdir } from 'node:os'
3
+ import { join } from 'node:path'
4
+
5
+ import type { AssistantMessage } from '@earendil-works/pi-ai'
6
+ import { SessionManager, type ExtensionToolContext } from '@earendil-works/pi-coding-agent'
7
+
8
+ import { createSessionWithDispose } from '@/agent'
9
+ import type { SessionOrigin } from '@/agent/session-origin'
10
+ import { createPermissionService, rolesConfigSchema, type RolesConfig } from '@/permissions'
11
+
12
+ import { createChannelRouter, type CreateChannelRouterOptions } from './router'
13
+ import { defaultHistoryConfig } from './schema'
14
+ import { channelKeyId, type ChannelKey, type InboundMessage, type OutboundMessage } from './types'
15
+
16
+ export const sourceKey: ChannelKey = { adapter: 'discord', workspace: 'guild', chat: 'source', thread: null }
17
+ export const targetKey: ChannelKey = { adapter: 'discord-bot', workspace: 'guild', chat: 'target', thread: null }
18
+
19
+ export function inbound(key: ChannelKey, overrides: Partial<InboundMessage> = {}): InboundMessage {
20
+ return {
21
+ ...key,
22
+ accountIdentity: `${key.adapter}-account`,
23
+ externalMessageId: crypto.randomUUID(),
24
+ text: 'Please help.',
25
+ authorId: 'alice',
26
+ authorName: 'Alice',
27
+ authorIsBot: false,
28
+ isBotMention: true,
29
+ isDm: false,
30
+ mentionsOthers: false,
31
+ replyToBotMessageId: null,
32
+ replyToOtherMessageId: null,
33
+ ts: 1000,
34
+ ...overrides,
35
+ }
36
+ }
37
+
38
+ type SessionState = {
39
+ readonly id: string
40
+ readonly origin: { current: SessionOrigin | undefined }
41
+ readonly prompts: string[]
42
+ readonly context: ExtensionToolContext
43
+ onPrompt?: () => Promise<void>
44
+ }
45
+
46
+ export async function handoffFixture(
47
+ options: {
48
+ roles?: RolesConfig
49
+ claimHandler?: CreateChannelRouterOptions['claimHandler']
50
+ } = {},
51
+ ) {
52
+ const dir = await mkdtemp(join(tmpdir(), 'typeclaw-session-handoff-'))
53
+ const permissions = createPermissionService({
54
+ roles: options.roles ?? rolesConfigSchema.parse({ member: { match: ['discord:*'] } }),
55
+ })
56
+ const sessions = new Map<string, SessionState>()
57
+ const sent: OutboundMessage[] = []
58
+ const logs: string[] = []
59
+ const clock = { now: 1000 }
60
+ const router = createChannelRouter({
61
+ agentDir: dir,
62
+ permissions,
63
+ now: () => clock.now,
64
+ claimHandler: options.claimHandler,
65
+ logger: { info: (line) => logs.push(line), warn: (line) => logs.push(line), error: (line) => logs.push(line) },
66
+ configForAdapter: () => ({
67
+ enabled: true,
68
+ engagement: { trigger: ['mention', 'reply', 'dm'], stickiness: 'off' },
69
+ history: defaultHistoryConfig(),
70
+ }),
71
+ createSessionForChannel: async ({ key, origin, originRef }) => {
72
+ const result = await createSessionWithDispose({
73
+ sessionManager: SessionManager.create(dir, join(dir, 'sessions')),
74
+ systemPromptOverride: 'Use channel tools.',
75
+ tools: [],
76
+ customTools: [],
77
+ origin,
78
+ originRef,
79
+ })
80
+ const state: SessionState = {
81
+ id: result.session.sessionId,
82
+ origin: originRef,
83
+ prompts: [],
84
+ context: result.session.extensionRunner.createToolContext('handoff-test', undefined),
85
+ }
86
+ sessions.set(channelKeyId(key), state)
87
+ result.session.prompt = async (text) => {
88
+ if (typeof text === 'string') state.prompts.push(text)
89
+ await state.onPrompt?.()
90
+ const response: AssistantMessage = {
91
+ role: 'assistant',
92
+ content: [{ type: 'text', text: 'NO_REPLY' }],
93
+ api: 'anthropic-messages',
94
+ provider: 'anthropic',
95
+ model: 'test-model',
96
+ usage: {
97
+ input: 0,
98
+ output: 0,
99
+ cacheRead: 0,
100
+ cacheWrite: 0,
101
+ totalTokens: 0,
102
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
103
+ },
104
+ stopReason: 'stop',
105
+ timestamp: clock.now,
106
+ }
107
+ result.session.sessionManager.appendMessage(response)
108
+ }
109
+ return { session: result.session, sessionId: state.id, dispose: result.dispose }
110
+ },
111
+ })
112
+ for (const adapter of ['discord', 'discord-bot', 'slack-bot'] as const) {
113
+ router.registerOutbound(adapter, async (message) => {
114
+ sent.push(message)
115
+ return { ok: true, messageId: 'posted-message' }
116
+ })
117
+ }
118
+ const testing = router.__testing
119
+ if (testing === undefined) throw new Error('router test controls are unavailable')
120
+ const session = (key: ChannelKey): SessionState => {
121
+ const state = sessions.get(channelKeyId(key))
122
+ if (state === undefined) throw new Error(`missing test session ${channelKeyId(key)}`)
123
+ return state
124
+ }
125
+ return {
126
+ agentDir: dir,
127
+ router,
128
+ permissions,
129
+ sessions,
130
+ session,
131
+ sent,
132
+ logs,
133
+ clock,
134
+ flush: testing.flushDebounce,
135
+ async receive(event: InboundMessage) {
136
+ await router.route(event)
137
+ await testing.flushDebounce(event)
138
+ },
139
+ async [Symbol.asyncDispose]() {
140
+ await router.stop()
141
+ await rm(dir, { recursive: true, force: true })
142
+ },
143
+ }
144
+ }
@@ -0,0 +1,175 @@
1
+ import { randomUUID } from 'node:crypto'
2
+
3
+ import type { ChannelParticipant, SessionOrigin } from '@/agent/session-origin'
4
+ import { CORE_PERMISSIONS, type PermissionService } from '@/permissions'
5
+
6
+ import type { AdapterId } from './schema'
7
+ import { channelKeyId, type ChannelKey, type InboundMessage, type RouteReceipt } from './types'
8
+
9
+ export type HandoffSession = {
10
+ readonly sessionId: string
11
+ readonly key: ChannelKey
12
+ readonly keyId: string
13
+ readonly destroyed: boolean
14
+ readonly currentTurnHandoff: boolean
15
+ readonly lastTurnHandoff: boolean
16
+ readonly draining: boolean
17
+ readonly currentTurnAuthorId: string | null
18
+ readonly lastTurnAuthorId: string | null
19
+ readonly currentTurnAuthorAdapter: AdapterId
20
+ readonly lastTurnAuthorAdapter: AdapterId
21
+ readonly participants: readonly ChannelParticipant[]
22
+ readonly room?: InboundMessage['room']
23
+ readonly lastInboundIsDm: boolean
24
+ }
25
+
26
+ export type ChannelHandoffResult =
27
+ | { ok: true; target: string }
28
+ | {
29
+ ok: false
30
+ code:
31
+ | 'no-source-session'
32
+ | 'loop'
33
+ | 'same-conversation'
34
+ | 'no-requester'
35
+ | 'target-not-live'
36
+ | 'requester-unknown-in-target'
37
+ | 'would-elevate'
38
+ | 'denied'
39
+ | 'not-engaged'
40
+ error: string
41
+ }
42
+
43
+ type HandoffAccess =
44
+ | {
45
+ ok: true
46
+ source: HandoffSession
47
+ target: HandoffSession
48
+ authorId: string
49
+ authorAdapter: AdapterId
50
+ authorName: string
51
+ }
52
+ | Extract<ChannelHandoffResult, { ok: false }>
53
+
54
+ export function findHandoffSource(sessions: ReadonlyMap<string, HandoffSession>, sessionId: string) {
55
+ return [...sessions.values()].find((session) => session.sessionId === sessionId && !session.destroyed)
56
+ }
57
+
58
+ export function checkHandoffAccess(args: {
59
+ source: HandoffSession | undefined
60
+ target: HandoffSession | undefined
61
+ permissions: PermissionService
62
+ }): HandoffAccess {
63
+ const { source, target, permissions } = args
64
+ if (source === undefined)
65
+ return { ok: false, code: 'no-source-session', error: 'handoff requires a live source channel session' }
66
+ if (source.currentTurnHandoff || (!source.draining && source.lastTurnHandoff))
67
+ return { ok: false, code: 'loop', error: 'this turn was started by a handoff; answer with channel_reply' }
68
+ if (target === undefined || target.destroyed)
69
+ return { ok: false, code: 'target-not-live', error: 'no live session owns that conversation' }
70
+ if (target.keyId === source.keyId)
71
+ return { ok: false, code: 'same-conversation', error: 'target is this conversation; use channel_reply' }
72
+ const authorId = source.currentTurnAuthorId ?? source.lastTurnAuthorId
73
+ if (authorId === null)
74
+ return { ok: false, code: 'no-requester', error: 'no authenticated requester to act on behalf of' }
75
+ const authorAdapter =
76
+ source.currentTurnAuthorId !== null ? source.currentTurnAuthorAdapter : source.lastTurnAuthorAdapter
77
+ const origin = (session: HandoffSession): SessionOrigin => ({
78
+ kind: 'channel',
79
+ ...session.key,
80
+ ...(session.room?.parentChat !== undefined ? { parentChat: session.room.parentChat } : {}),
81
+ lastInboundAuthorId: authorId,
82
+ lastInboundAuthorAdapter: authorAdapter,
83
+ })
84
+ const targetOrigin = origin(target)
85
+ const targetRole = permissions.resolveRole(targetOrigin, { requireMatch: true })
86
+ const targetPermissions = targetRole === undefined ? undefined : permissions.permissionsForRole(targetRole)
87
+ if (targetPermissions === undefined)
88
+ return {
89
+ ok: false,
90
+ code: 'requester-unknown-in-target',
91
+ error: 'the authenticated requester has no matching known role in the target conversation',
92
+ }
93
+ const sourceRole = permissions.resolveRole(origin(source))
94
+ const sourcePermissions = permissions.permissionsForRole(sourceRole)
95
+ if (
96
+ sourcePermissions === undefined ||
97
+ targetPermissions.some((permission) => !sourcePermissions.includes(permission))
98
+ )
99
+ return {
100
+ ok: false,
101
+ code: 'would-elevate',
102
+ error: 'the target grants authority the requester does not hold in the source; request there directly',
103
+ }
104
+ if (!permissions.has(targetOrigin, CORE_PERMISSIONS.channelRespond))
105
+ return { ok: false, code: 'denied', error: 'the requester cannot engage the agent in the target conversation' }
106
+ // Capability dominance already bounds every accepted handoff, including
107
+ // owners. Recent participation adds no authority proof and blocks legitimate
108
+ // work across accounts or after an idle period.
109
+ return {
110
+ ok: true,
111
+ source,
112
+ target,
113
+ authorId,
114
+ authorAdapter,
115
+ authorName: source.participants.find((participant) => participant.authorId === authorId)?.authorName ?? authorId,
116
+ }
117
+ }
118
+
119
+ export function createSessionHandoff(options: {
120
+ sessions: ReadonlyMap<string, HandoffSession>
121
+ permissions: PermissionService
122
+ route: (event: InboundMessage) => Promise<RouteReceipt>
123
+ logger: { info: (message: string) => void }
124
+ now: () => number
125
+ }) {
126
+ return async (args: { fromSessionId: string; target: ChannelKey; text: string }): Promise<ChannelHandoffResult> => {
127
+ const targetId = channelKeyId(args.target)
128
+ const access = checkHandoffAccess({
129
+ source: findHandoffSource(options.sessions, args.fromSessionId),
130
+ target: options.sessions.get(targetId),
131
+ permissions: options.permissions,
132
+ })
133
+ if (!access.ok) {
134
+ options.logger.info(`[channels] handoff ${args.fromSessionId} -> ${targetId}: refused ${access.code}`)
135
+ return access
136
+ }
137
+ const { source, target } = access
138
+ const fromWhere = source.lastInboundIsDm ? 'a private DM' : `another conversation (${source.keyId})`
139
+ const receipt = await options.route({
140
+ ...target.key,
141
+ ...(target.room !== undefined ? { room: target.room } : {}),
142
+ routingNote:
143
+ `[handoff: ${access.authorName} asked you for this in ${fromWhere}. It was NOT posted in this conversation and nobody ` +
144
+ "here has seen it. Read this conversation's latest messages first: if someone has since asked for something newer " +
145
+ 'or the result below is outdated, act on the current state instead of repeating it, or stay silent if nothing is ' +
146
+ 'needed. Share only what this conversation needs, not private details.]',
147
+ handoff: true,
148
+ text: args.text,
149
+ externalMessageId: `handoff:${randomUUID()}`,
150
+ eventKind: 'handoff',
151
+ authorId: access.authorId,
152
+ authorAdapter: access.authorAdapter,
153
+ authorName: access.authorName,
154
+ authorIsBot: false,
155
+ isBotMention: true,
156
+ suppressSticky: true,
157
+ replyToBotMessageId: null,
158
+ mentionsOthers: false,
159
+ replyToOtherMessageId: null,
160
+ isDm: target.lastInboundIsDm,
161
+ ts: options.now(),
162
+ })
163
+ options.logger.info(`[channels] handoff ${source.keyId} -> ${targetId}: ${receipt.kind}`)
164
+ switch (receipt.kind) {
165
+ case 'accepted':
166
+ case 'duplicate':
167
+ return { ok: true, target: targetId }
168
+ case 'denied':
169
+ return { ok: false, code: 'denied', error: 'target authorization changed or its adapter is unavailable' }
170
+ case 'observed':
171
+ case 'control':
172
+ return { ok: false, code: 'not-engaged', error: 'the target did not accept the handoff' }
173
+ }
174
+ }
175
+ }
@@ -0,0 +1,71 @@
1
+ import type { PermissionService } from '@/permissions'
2
+
3
+ import { adapterNamespace } from './adapter-namespace'
4
+ import type { ConfigForAdapter } from './router'
5
+ import { checkHandoffAccess, findHandoffSource, type HandoffSession } from './session-handoff'
6
+ import type { ChannelKey, ResolvedChannelNames } from './types'
7
+
8
+ export type SessionActivity = { readonly text: string; readonly at: number }
9
+ export type SearchableSession = HandoffSession & {
10
+ readonly resolvedNames: ResolvedChannelNames
11
+ readonly recentMessages: readonly SessionActivity[]
12
+ readonly lastInboundAt: number
13
+ }
14
+
15
+ export type SessionSearchTarget = {
16
+ readonly target: ChannelKey
17
+ readonly name: string
18
+ readonly activity: string
19
+ readonly lastActiveAt: number
20
+ }
21
+
22
+ export type SessionSearchArgs = {
23
+ readonly fromSessionId: string
24
+ readonly query: string
25
+ // Used by channel_read to disambiguate platform-local conversation IDs.
26
+ readonly conversation?: ChannelKey
27
+ }
28
+
29
+ export function createSessionSearch(options: {
30
+ sessions: ReadonlyMap<string, SearchableSession>
31
+ permissions: PermissionService
32
+ configForAdapter: ConfigForAdapter
33
+ }) {
34
+ return (args: SessionSearchArgs): SessionSearchTarget[] => {
35
+ const source = findHandoffSource(options.sessions, args.fromSessionId)
36
+ const query = args.query.trim().toLocaleLowerCase()
37
+ const results: SessionSearchTarget[] = []
38
+ for (const session of options.sessions.values()) {
39
+ if (!options.configForAdapter(session.key.adapter)?.enabled) continue
40
+ const conversation = args.conversation
41
+ if (
42
+ conversation !== undefined &&
43
+ (session.key.adapter === conversation.adapter ||
44
+ adapterNamespace(session.key.adapter) !== adapterNamespace(conversation.adapter) ||
45
+ session.key.workspace !== conversation.workspace ||
46
+ session.key.chat !== conversation.chat ||
47
+ session.key.thread !== conversation.thread)
48
+ )
49
+ continue
50
+ if (!checkHandoffAccess({ source, target: session, permissions: options.permissions }).ok) continue
51
+ const name = session.resolvedNames.chatName ?? session.key.chat
52
+ const values = [
53
+ name,
54
+ session.resolvedNames.workspaceName ?? session.key.workspace,
55
+ session.room?.parentChatName ?? '',
56
+ session.keyId,
57
+ ...session.participants.flatMap((participant) => [participant.authorId, participant.authorName]),
58
+ ...session.recentMessages.map((message) => message.text),
59
+ ]
60
+ if (!values.some((value) => value.toLocaleLowerCase().includes(query))) continue
61
+ const latest = session.recentMessages.at(-1)
62
+ results.push({
63
+ target: { ...session.key },
64
+ name,
65
+ activity: latest?.text.replace(/\s+/gu, ' ').slice(0, 160) ?? '',
66
+ lastActiveAt: latest?.at ?? session.lastInboundAt,
67
+ })
68
+ }
69
+ return results.sort((a, b) => b.lastActiveAt - a.lastActiveAt).slice(0, 20)
70
+ }
71
+ }
@@ -47,8 +47,8 @@ const consoleLogger: SubagentCompletionBridgeLogger = {
47
47
  // `LiveSession`, so the lookup is O(N) over live sessions with N small
48
48
  // (one per active conversation).
49
49
  //
50
- // On `no-live-session`, we drop the reminder. When the parent was a
51
- // channel session, the broadcast now carries the channel-key coordinate
50
+ // On `no-live-session`, live routing stops but the durable response remains owed.
51
+ // For a channel session, the broadcast carries the channel-key coordinate
52
52
  // `{ adapter, workspace, chat, thread }`, and the router first tries to
53
53
  // reroute to the live successor session for that key — covering the two
54
54
  // common drop paths where the exact sessionId is gone but the
@@ -62,22 +62,25 @@ const consoleLogger: SubagentCompletionBridgeLogger = {
62
62
  // A reminder still reaching this branch means there is no live session
63
63
  // for the key at all (the whole conversation went idle), or the parent
64
64
  // was a TUI session (handled by the TUI bridge in src/server/index.ts).
65
- // Logged at warn with the channel key so an undelivered completion is
66
- // diagnosable from logs alone.
65
+ // Logged at warn so absent-parent completion routing remains diagnosable.
67
66
  export function createSubagentCompletionBridge(options: SubagentCompletionBridgeOptions): SubagentCompletionBridge {
68
67
  const logger = options.logger ?? consoleLogger
69
- const unsubscribe = options.stream.subscribe({ target: { kind: 'broadcast' } }, (msg) => {
68
+ const unsubscribe = options.stream.subscribe({ target: { kind: 'broadcast' } }, async (msg) => {
70
69
  const parsed = parseSubagentCompletedPayload(msg.payload)
71
70
  if (parsed === null) return
72
- const result = options.router.injectSubagentCompletionReminder(parsed)
73
- if (result.kind === 'no-live-session') {
74
- const keyInfo =
75
- parsed.channelKey !== undefined
76
- ? ` channelKey=${parsed.channelKey.adapter}:${parsed.channelKey.workspace}:${parsed.channelKey.chat}:${parsed.channelKey.thread ?? ''}`
77
- : ''
78
- logger.warn(
79
- `[channels] subagent-completion reminder dropped: no live session for parentSessionId=${parsed.parentSessionId} task=${parsed.taskId}${keyInfo}`,
80
- )
71
+ try {
72
+ const result = await options.router.injectSubagentCompletionReminder(parsed)
73
+ if (result.kind === 'no-live-session') {
74
+ const keyInfo =
75
+ parsed.channelKey !== undefined
76
+ ? ` channelKey=${parsed.channelKey.adapter}:${parsed.channelKey.workspace}:${parsed.channelKey.chat}:${parsed.channelKey.thread ?? ''}`
77
+ : ''
78
+ logger.warn(
79
+ `[channels] subagent-completion reminder not routed: no live session for parentSessionId=${parsed.parentSessionId} task=${parsed.taskId}${keyInfo}`,
80
+ )
81
+ }
82
+ } catch {
83
+ logger.warn(`[channels] subagent-completion admission failed: task=${parsed.taskId}; response remains owed`)
81
84
  }
82
85
  })
83
86
  return { stop: unsubscribe }