typeclaw 0.49.0 → 0.51.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 (502) 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/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -61,14 +61,17 @@ export function createChannelFetchAttachmentTool({
61
61
  'messages with attachments show `[<Platform> attachment #N: <kind> <metadata>]` in the text. Pass `N` as ' +
62
62
  '`attachment_id`; do not invent ids that are not present in the message. The router resolves the private ' +
63
63
  'platform ref itself. Attachments on the CURRENT inbound message resolve directly; for one from an EARLIER ' +
64
- 'message, call channel_history first (it makes those attachments resolvable by the same id). On success ' +
65
- 'returns the absolute path of the saved file plus its detected mimetype and size.',
64
+ 'message, call channel_history first. On Slack, pass the exact file_id when the request names one or ' +
65
+ 'several messages reuse #1. Returns the selected file identity, saved path, mimetype and size.',
66
66
  parameters: Type.Object({
67
67
  attachment_id: Type.Integer({
68
68
  description:
69
69
  'The number N from the inbound `[<Platform> attachment #N: ...]` placeholder. Must be present in this turn.',
70
70
  minimum: 1,
71
71
  }),
72
+ file_id: Type.Optional(
73
+ Type.String({ pattern: '^F[A-Z0-9]+$', description: 'Exact Slack file ID from the request or history.' }),
74
+ ),
72
75
  filename: Type.Optional(
73
76
  Type.String({
74
77
  description:
@@ -79,12 +82,15 @@ export function createChannelFetchAttachmentTool({
79
82
  }),
80
83
 
81
84
  async execute(_toolCallId, params) {
85
+ if (params.file_id !== undefined && adapter !== 'slack' && adapter !== 'slack-bot')
86
+ return errorResult('file_id is only supported for Slack attachments')
82
87
  const found = router.lookupInboundAttachment({
83
88
  adapter,
84
89
  workspace: origin.workspace,
85
90
  chat: origin.chat,
86
91
  thread: origin.thread,
87
92
  id: params.attachment_id,
93
+ ...(params.file_id !== undefined ? { ref: params.file_id } : {}),
88
94
  })
89
95
  if (found === null) {
90
96
  const validIds = router.listInboundAttachmentIds({
@@ -107,6 +113,7 @@ export function createChannelFetchAttachmentTool({
107
113
  )
108
114
  }
109
115
  const ref = found.ref
116
+ const identityPart = adapter === 'slack' || adapter === 'slack-bot' ? ` file_id=${ref}` : ''
110
117
  const filename = params.filename ?? found.filename
111
118
  const result = await router.fetchAttachment(adapter, {
112
119
  ref,
@@ -115,7 +122,7 @@ export function createChannelFetchAttachmentTool({
115
122
  })
116
123
  if (!result.ok) {
117
124
  logger.warn(formatChannelToolFailure('channel_fetch_attachment', `${adapter}: ${result.error}`))
118
- const text = `channel_fetch_attachment error: ${result.error}`
125
+ const text = `channel_fetch_attachment error:${identityPart} ${result.error}`
119
126
  const details: FetchAttachmentDetails = { ok: false, error: result.error }
120
127
  return { content: [{ type: 'text' as const, text }], details }
121
128
  }
@@ -135,13 +142,13 @@ export function createChannelFetchAttachmentTool({
135
142
  } catch (err) {
136
143
  const message = err instanceof Error ? err.message : String(err)
137
144
  logger.warn(formatChannelToolFailure('channel_fetch_attachment', `${adapter}: write failed: ${message}`))
138
- const text = `channel_fetch_attachment error: write failed: ${message}`
145
+ const text = `channel_fetch_attachment error:${identityPart} write failed: ${message}`
139
146
  const details: FetchAttachmentDetails = { ok: false, error: `write failed: ${message}` }
140
147
  return { content: [{ type: 'text' as const, text }], details }
141
148
  }
142
149
 
143
150
  const mimetypePart = result.mimetype !== undefined ? ` (${result.mimetype})` : ''
144
- const text = `saved ${result.size} bytes to ${targetPath}${mimetypePart}`
151
+ const text = `saved ${result.size} bytes to ${targetPath}${mimetypePart}${identityPart}`
145
152
  const details: FetchAttachmentDetails = {
146
153
  ok: true,
147
154
  path: targetPath,
@@ -0,0 +1,72 @@
1
+ import { Type } from '@earendil-works/pi-ai'
2
+ import { defineTool } from '@earendil-works/pi-coding-agent'
3
+
4
+ import type { ChannelHandoffResult, ChannelRouter } from '@/channels/router'
5
+ import { ADAPTER_IDS } from '@/channels/schema'
6
+
7
+ export type CreateChannelHandoffToolOptions = {
8
+ router: Pick<ChannelRouter, 'handoff'>
9
+ sessionId: string
10
+ }
11
+
12
+ // `channel_handoff` hands work to the session that owns another conversation
13
+ // instead of posting there with channel_send. A channel_send from here is
14
+ // written from THIS session's view of that conversation, which goes stale the
15
+ // moment people keep talking there; the owning session sees its latest
16
+ // messages and decides what (if anything) to post.
17
+ export function createChannelHandoffTool({ router, sessionId }: CreateChannelHandoffToolOptions) {
18
+ return defineTool({
19
+ name: 'channel_handoff',
20
+ label: 'Channel Handoff',
21
+ description:
22
+ 'Hand a result or request to the session that owns ANOTHER conversation, on any adapter. First use ' +
23
+ '`channel_session_search` to find its target by conversation name, topic, or participant. When the work ' +
24
+ 'belongs there, hand it off instead of reading or posting there directly from this session. ' +
25
+ 'The session that owns that conversation receives your `text` as a private note from ' +
26
+ 'the user, reads its own latest messages, and then decides what to post, so newer requests there are not ' +
27
+ 'answered with a stale result. Your `text` is not posted verbatim: write what was done and what is left, ' +
28
+ 'not a finished channel message. It acts on behalf of the user who asked you this turn, with their permissions ' +
29
+ 'in the target conversation, without gaining authority over their source role. No recent participation is required. ' +
30
+ 'After a successful handoff, briefly tell the user here that it was passed on. ' +
31
+ 'Not available in a turn that was itself started by a handoff (reply with `channel_reply` there).',
32
+ parameters: Type.Object({
33
+ adapter: Type.Union(
34
+ ADAPTER_IDS.map((a) => Type.Literal(a)),
35
+ { description: 'Target adapter id from channel_session_search; it can differ from this session.' },
36
+ ),
37
+ workspace: Type.String({
38
+ description: 'Discord guild id or Slack team id; "@dm" for direct-message channels.',
39
+ minLength: 1,
40
+ }),
41
+ chat: Type.String({ description: 'Target channel id.', minLength: 1 }),
42
+ thread: Type.Optional(
43
+ Type.String({
44
+ description: 'Optional thread id (Discord thread channel id, Slack parent thread_ts).',
45
+ minLength: 1,
46
+ }),
47
+ ),
48
+ text: Type.String({
49
+ description:
50
+ 'What the owning session needs to know: the request, what you already did, and the result. Plain context, not a ready-to-post message.',
51
+ minLength: 1,
52
+ }),
53
+ }),
54
+
55
+ async execute(_toolCallId, params) {
56
+ const result: ChannelHandoffResult = await router.handoff({
57
+ fromSessionId: sessionId,
58
+ target: {
59
+ adapter: params.adapter,
60
+ workspace: params.workspace,
61
+ chat: params.chat,
62
+ thread: params.thread ?? null,
63
+ },
64
+ text: params.text,
65
+ })
66
+ const text = result.ok
67
+ ? `Handed off to ${result.target}. That conversation's session will answer there with its current context; do not also post it yourself.`
68
+ : `channel_handoff denied (${result.code}): ${result.error}`
69
+ return { content: [{ type: 'text' as const, text }], details: result }
70
+ },
71
+ })
72
+ }
@@ -3,7 +3,7 @@ import { defineTool } from '@earendil-works/pi-coding-agent'
3
3
 
4
4
  import type { ChannelRouter } from '@/channels/router'
5
5
  import { ADAPTER_IDS, type AdapterId } from '@/channels/schema'
6
- import type { ChannelListEntry } from '@/channels/types'
6
+ import type { ChannelKey, ChannelListEntry } from '@/channels/types'
7
7
 
8
8
  import { renderHistoryMessage, renderHistoryMessages } from './channel-history-render'
9
9
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
@@ -11,6 +11,7 @@ import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure
11
11
  export type CreateChannelReadToolOptions = {
12
12
  router: ChannelRouter
13
13
  logger?: ChannelToolLogger
14
+ sessionId?: string
14
15
  }
15
16
 
16
17
  const DEFAULT_LIMIT = 20
@@ -22,7 +23,11 @@ const DEFAULT_LIMIT = 20
22
23
  // modes share one tool to keep the per-turn tool-schema budget small, mirroring
23
24
  // web_fetch's strategy union; mode-specific required params are validated at
24
25
  // runtime since JSON-Schema can't express "required-if".
25
- export function createChannelReadTool({ router, logger = consoleChannelLogger }: CreateChannelReadToolOptions) {
26
+ export function createChannelReadTool({
27
+ router,
28
+ logger = consoleChannelLogger,
29
+ sessionId,
30
+ }: CreateChannelReadToolOptions) {
26
31
  return defineTool({
27
32
  name: 'channel_read',
28
33
  label: 'Channel Read',
@@ -34,7 +39,8 @@ export function createChannelReadTool({ router, logger = consoleChannelLogger }:
34
39
  '- "list": discover channels/chats in `workspace` (no `chat` needed). Use when you do not yet know a chat id.\n' +
35
40
  'For Discord guild channels, `workspace` is the guild id; for Slack team channels, `workspace` is the team id (e.g. "T0ACME"); for DMs, "@dm". ' +
36
41
  'On failure returns { ok: false, error }. Not every adapter supports every mode — an unsupported mode returns a not-supported error rather than throwing. ' +
37
- 'This is read-only; use channel_send to post.',
42
+ 'This is read-only. When work belongs to another conversation, use channel_session_search and channel_handoff ' +
43
+ 'instead of reading or posting there directly. An access error may include an authorized handoff target.',
38
44
  parameters: Type.Object({
39
45
  mode: Type.Union([Type.Literal('history'), Type.Literal('message'), Type.Literal('list')], {
40
46
  description:
@@ -79,21 +85,62 @@ export function createChannelReadTool({ router, logger = consoleChannelLogger }:
79
85
  }),
80
86
 
81
87
  async execute(_toolCallId, params) {
82
- const adapter = params.adapter as AdapterId
88
+ const adapter = params.adapter
83
89
  const limit = params.limit ?? DEFAULT_LIMIT
84
90
 
85
- if (params.mode === 'history') {
86
- return await readHistory({ router, logger, adapter, params, limit })
91
+ let result: { content: { type: 'text'; text: string }[]; details: Details }
92
+ switch (params.mode) {
93
+ case 'history':
94
+ result = await readHistory({ router, logger, adapter, params, limit })
95
+ break
96
+ case 'message':
97
+ result = await readMessage({ router, logger, adapter, params })
98
+ break
99
+ case 'list':
100
+ result = await readList({ router, logger, adapter, params, limit })
101
+ break
87
102
  }
88
- if (params.mode === 'message') {
89
- return await readMessage({ router, logger, adapter, params })
103
+ // These are platform protocol errors, not natural-language intent matching.
104
+ const error = result.details.error?.toLocaleLowerCase() ?? ''
105
+ const accessDenied = [
106
+ 'missing access',
107
+ 'missing permissions',
108
+ 'access denied',
109
+ 'access_denied',
110
+ 'permission-denied',
111
+ 'forbidden',
112
+ 'http_403',
113
+ 'missing_scope',
114
+ 'not_in_channel',
115
+ ].some((code) => error.includes(code))
116
+ if (!result.details.ok && accessDenied && sessionId !== undefined && params.chat !== undefined) {
117
+ const handoffTargets = router
118
+ .searchSessions({
119
+ fromSessionId: sessionId,
120
+ query: '',
121
+ conversation: { adapter, workspace: params.workspace, chat: params.chat, thread: params.thread ?? null },
122
+ })
123
+ .map((entry) => entry.target)
124
+ if (handoffTargets.length > 0) {
125
+ const hint = `Another adapter has an authorized live session for this conversation. Use channel_handoff with a target below instead of asking the user to repair this account's access:\n${JSON.stringify(handoffTargets)}`
126
+ return {
127
+ content: result.content.map((part) => ({ ...part, text: `${part.text}\n\n${hint}` })),
128
+ details: { ...result.details, handoffTargets },
129
+ }
130
+ }
90
131
  }
91
- return await readList({ router, logger, adapter, params, limit })
132
+ return result
92
133
  },
93
134
  })
94
135
  }
95
136
 
96
- type Details = { ok: boolean; error?: string; count?: number; nextCursor?: string }
137
+ type Details = {
138
+ ok: boolean
139
+ error?: string
140
+ count?: number
141
+ nextCursor?: string
142
+ handoffTargets?: readonly ChannelKey[]
143
+ }
97
144
 
98
145
  function fail(error: string): { content: [{ type: 'text'; text: string }]; details: Details } {
99
146
  return { content: [{ type: 'text' as const, text: `channel_read error: ${error}` }], details: { ok: false, error } }
@@ -15,6 +15,7 @@ import {
15
15
  } from '@/channels/router'
16
16
  import type { AdapterId } from '@/channels/schema'
17
17
  import type { GithubReviewFollowupRound } from '@/channels/types'
18
+ import type { ChannelOutboundOrigin } from '@/plugin'
18
19
 
19
20
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
20
21
  import { fenceRuntimeNotice, fenceToolResult } from './runtime-notice'
@@ -30,6 +31,7 @@ export type ChannelReplyOrigin = {
30
31
  export type CreateChannelReplyToolOptions = {
31
32
  router: ChannelRouter
32
33
  origin: ChannelReplyOrigin
34
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined
33
35
  // Scopes the per-turn false-receipt ledger. Defaults to '' when a caller (e.g.
34
36
  // a focused test) has no session; the guard then simply finds no recorded
35
37
  // action and falls back to its safe default.
@@ -49,6 +51,7 @@ export type CreateChannelReplyToolOptions = {
49
51
  export function createChannelReplyTool({
50
52
  router,
51
53
  origin,
54
+ getOutboundOrigin,
52
55
  sessionId = '',
53
56
  logger = consoleChannelLogger,
54
57
  }: CreateChannelReplyToolOptions) {
@@ -58,8 +61,8 @@ export function createChannelReplyTool({
58
61
  description:
59
62
  'Reply in the current conversation. This is your default way to respond to a channel session — ' +
60
63
  'addressing fields (adapter, workspace, chat, thread) are filled in from the session origin, so ' +
61
- 'you only supply the text. To post somewhere else (different chat, break out of the current ' +
62
- 'thread, etc.), use `channel_send` instead. ' +
64
+ 'you only supply the text. For work belonging to another conversation, use `channel_session_search` ' +
65
+ 'then `channel_handoff` so its owning session answers with current context. ' +
63
66
  'On success the result carries adapter-reported posted-message ids (`messageId` and `messageIds` ' +
64
67
  'in send order) when available. For follow-ups, reuse `channel_reply` or the existing ' +
65
68
  '`channel_send` thread/root coordinates; a returned id starts a thread only where the adapter ' +
@@ -94,17 +97,17 @@ export function createChannelReplyTool({
94
97
  },
95
98
  ),
96
99
  ),
97
- more_work_this_turn: Type.Boolean({
100
+ continue_after_reply: Type.Boolean({
98
101
  description:
99
102
  'REQUIRED on every channel_reply — you must explicitly choose, there is no default. Set `true` when this reply is a mid-turn status update (e.g. "working on it…") and you still have MORE WORK to do THIS turn — fetching data, running a tool, spawning a subagent, then replying again; `true` keeps the turn alive so that follow-up actually runs. ' +
100
103
  'Set `false` when this reply is your final message for the turn (the common case). ' +
101
- 'This choice is mandatory precisely because a missing value used to default to ending the turn silently: a successful reply ends the turn unless `more_work_this_turn` is `true`, so a `false` on an ack you meant to keep working from drops the work you promised. ' +
104
+ 'This choice is mandatory precisely because a missing value used to default to ending the turn silently: a successful reply ends the turn unless `continue_after_reply` is `true`, so a `false` on an ack you meant to keep working from drops the work you promised. ' +
102
105
  'Do not set `true` just to seem responsive; only when genuine multi-step work follows in the same turn.',
103
106
  }),
104
107
  resolve_review_thread: Type.Optional(
105
108
  Type.Boolean({
106
109
  description:
107
- 'GitHub PR review threads ONLY. On a TERMINAL (`more_work_this_turn:false`) github PR review-thread reply that carries `text`, this is REQUIRED: you must set it to `true` or `false` and omitting it is rejected — you will be told to re-call with an explicit choice. (It stays a normal optional field everywhere else: ignored on Slack/Discord/Telegram/KakaoTalk and any non-github session, on github replies outside a review thread, on attachments-only replies, and on mid-turn `more_work_this_turn:true` status updates — leave it unset there.) ' +
110
+ 'GitHub PR review threads ONLY. On a TERMINAL (`continue_after_reply:false`) github PR review-thread reply that carries `text`, this is REQUIRED: you must set it to `true` or `false` and omitting it is rejected — you will be told to re-call with an explicit choice. (It stays a normal optional field everywhere else: ignored on Slack/Discord/Telegram/KakaoTalk and any non-github session, on github replies outside a review thread, on attachments-only replies, and on mid-turn `continue_after_reply:true` status updates — leave it unset there.) ' +
108
111
  'Set `true` when your `text` acknowledges the concern is fixed/verified/addressed (e.g. "verified at <sha>", "thanks, that resolves it"): the runtime resolves the thread BEFORE posting, so the close-out actually happens in this same turn — a successful reply ends the turn, so a resolve deferred to "later" never runs. ' +
109
112
  "Set `false` when the thread should stay open (partial fix, disagreement, mid-discussion). It is safe to set `true` by default: the runtime resolves ONLY if the thread's root comment is yours — it refuses (and blocks the reply) on a human reviewer's thread, so you never close someone else's open question. You need not pre-check authorship; let the runtime enforce ownership.",
110
113
  }),
@@ -114,7 +117,7 @@ export function createChannelReplyTool({
114
117
  async execute(_toolCallId, params) {
115
118
  let text = params.text
116
119
  const attachments = params.attachments
117
- const keepTurnAlive = params.more_work_this_turn === true
120
+ const keepTurnAlive = params.continue_after_reply === true
118
121
  if ((text === undefined || text === '') && (attachments === undefined || attachments.length === 0)) {
119
122
  logger.warn(formatChannelToolFailure('channel_reply', 'missing text and attachments'))
120
123
  return {
@@ -168,7 +171,7 @@ export function createChannelReplyTool({
168
171
  if (keepTurnAlive && params.resolve_review_thread !== undefined) {
169
172
  const error =
170
173
  '`resolve_review_thread` is a terminal close-out decision and cannot be combined with ' +
171
- '`more_work_this_turn: true`. Send a status without the decision, then close out the thread in a terminal reply.'
174
+ '`continue_after_reply: true`. Send a status without the decision, then close out the thread in a terminal reply.'
172
175
  logger.warn(formatChannelToolFailure('channel_reply', error))
173
176
  return {
174
177
  content: [{ type: 'text' as const, text: `channel_reply denied: ${error}` }],
@@ -186,7 +189,7 @@ export function createChannelReplyTool({
186
189
  const missingResolveChoice = missingReviewThreadResolveChoiceError({
187
190
  origin,
188
191
  text,
189
- moreWorkThisTurn: keepTurnAlive,
192
+ continueAfterReply: keepTurnAlive,
190
193
  resolveReviewThread: params.resolve_review_thread,
191
194
  })
192
195
  if (missingResolveChoice) {
@@ -207,7 +210,7 @@ export function createChannelReplyTool({
207
210
  chat: origin.chat,
208
211
  thread: origin.thread,
209
212
  text,
210
- moreWorkThisTurn: keepTurnAlive,
213
+ continueAfterReply: keepTurnAlive,
211
214
  resolveReviewThread: params.resolve_review_thread === true,
212
215
  })
213
216
  if (falseReceipt.kind === 'block') {
@@ -243,7 +246,7 @@ export function createChannelReplyTool({
243
246
  thread: origin.thread,
244
247
  text,
245
248
  wantsResolve: params.resolve_review_thread === true,
246
- moreWorkThisTurn: keepTurnAlive,
249
+ continueAfterReply: keepTurnAlive,
247
250
  getReviewState: (req) => router.getReviewState(req),
248
251
  ...(origin.githubReviewRound !== undefined ? { round: origin.githubReviewRound } : {}),
249
252
  })
@@ -280,7 +283,7 @@ export function createChannelReplyTool({
280
283
  })
281
284
  return {
282
285
  content: [{ type: 'text' as const, text: alreadyResolvedHint(origin.thread) }],
283
- details: { ok: true, ...(keepTurnAlive ? { more_work_this_turn: true } : {}) },
286
+ details: { ok: true, ...(keepTurnAlive ? { continue_after_reply: true } : {}) },
284
287
  }
285
288
  }
286
289
  // `no-match` stays non-blocking (the thread may be genuinely gone) but
@@ -301,15 +304,19 @@ export function createChannelReplyTool({
301
304
 
302
305
  const backgroundCoverage = (await router.captureBackgroundResultCoverage?.(sessionId)) ?? []
303
306
  const inboundCoverage = (await router.captureInboundResultCoverage?.(sessionId)) ?? []
304
- const result = await router.send({
305
- adapter: origin.adapter,
306
- workspace: origin.workspace,
307
- chat: origin.chat,
308
- thread: origin.thread,
309
- ...(text !== undefined ? { text } : {}),
310
- ...(params.link_previews !== undefined ? { link_previews: params.link_previews } : {}),
311
- ...(attachments !== undefined ? { attachments } : {}),
312
- })
307
+ const outboundOrigin = getOutboundOrigin?.()
308
+ const result = await router.send(
309
+ {
310
+ adapter: origin.adapter,
311
+ workspace: origin.workspace,
312
+ chat: origin.chat,
313
+ thread: origin.thread,
314
+ ...(text !== undefined ? { text } : {}),
315
+ ...(params.link_previews !== undefined ? { link_previews: params.link_previews } : {}),
316
+ ...(attachments !== undefined ? { attachments } : {}),
317
+ },
318
+ outboundOrigin ? { origin: outboundOrigin } : undefined,
319
+ )
313
320
 
314
321
  if (!result.ok) {
315
322
  logger.warn(
@@ -334,13 +341,13 @@ export function createChannelReplyTool({
334
341
  decision: 'left-open',
335
342
  })
336
343
  }
337
- // `more_work_this_turn` is read by the router's terminal hook (installChannelReplyTerminalHook),
344
+ // `continue_after_reply` is read by the router's terminal hook (installChannelReplyTerminalHook),
338
345
  // not by this tool — it suppresses the post-reply abort so a multi-step turn
339
346
  // keeps going. Success-only: a denied reply never ran, so there is no turn to keep.
340
347
  const details: {
341
348
  ok: boolean
342
349
  error?: string
343
- more_work_this_turn?: boolean
350
+ continue_after_reply?: boolean
344
351
  messageId?: string
345
352
  messageIds?: readonly string[]
346
353
  backgroundCoverage?: BackgroundObligationRef[]
@@ -350,7 +357,7 @@ export function createChannelReplyTool({
350
357
  ok: true,
351
358
  backgroundCoverage,
352
359
  inboundCoverage,
353
- ...(keepTurnAlive ? { more_work_this_turn: true } : {}),
360
+ ...(keepTurnAlive ? { continue_after_reply: true } : {}),
354
361
  ...(result.messageId !== undefined ? { messageId: result.messageId } : {}),
355
362
  ...(result.messageIds !== undefined ? { messageIds: result.messageIds } : {}),
356
363
  }
@@ -372,7 +379,7 @@ export function createChannelReplyTool({
372
379
  // answering its own echo and looping (PR #481). Denials carry no echoed
373
380
  // prose (just machine error text), so they keep the lighter prefix.
374
381
  if (result.ok) {
375
- const echo = renderOutboundEcho(text, attachments)
382
+ const echo = renderOutboundEcho(result.deliveredText ?? text, attachments)
376
383
  const receipt =
377
384
  `posted to ${origin.adapter}:${origin.workspace}/${origin.chat}: ${echo}` +
378
385
  (result.messageId !== undefined ? `\nmessage_id=${JSON.stringify(result.messageId)}` : '') +
@@ -419,13 +426,13 @@ function parseGithubPrNumber(chat: string): number {
419
426
  function missingReviewThreadResolveChoiceError(input: {
420
427
  origin: ChannelReplyOrigin
421
428
  text: string | undefined
422
- moreWorkThisTurn: boolean
429
+ continueAfterReply: boolean
423
430
  resolveReviewThread: boolean | undefined
424
431
  }): string {
425
432
  const isGithubPrReviewThread =
426
433
  input.origin.adapter === 'github' && /^pr:\d+$/.test(input.origin.chat) && input.origin.thread !== null
427
434
  const hasText = input.text !== undefined && input.text.trim() !== ''
428
- if (!isGithubPrReviewThread || !hasText || input.moreWorkThisTurn || input.resolveReviewThread !== undefined) {
435
+ if (!isGithubPrReviewThread || !hasText || input.continueAfterReply || input.resolveReviewThread !== undefined) {
429
436
  return ''
430
437
  }
431
438
  return (
@@ -15,6 +15,7 @@ import {
15
15
  } from '@/channels/router'
16
16
  import { ADAPTER_IDS, type AdapterId } from '@/channels/schema'
17
17
  import type { GithubReviewFollowupRound } from '@/channels/types'
18
+ import type { ChannelOutboundOrigin } from '@/plugin'
18
19
 
19
20
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
20
21
  import { renderOutboundEcho, TOOL_RESULT_PREFIX } from './channel-reply'
@@ -36,6 +37,7 @@ export type CreateChannelSendToolOptions = {
36
37
  // the model can self-correct on its next turn. Absent for sessions whose
37
38
  // origin isn't a channel (e.g. cron prompts that send to channels).
38
39
  origin?: ChannelSendOrigin
40
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined
39
41
  // Scopes the per-turn false-receipt ledger for github resolve close-outs.
40
42
  // Defaults to '' when absent (cron / non-channel sessions); the guard then
41
43
  // finds no recorded action and falls back to its safe default.
@@ -46,6 +48,7 @@ export type CreateChannelSendToolOptions = {
46
48
  export function createChannelSendTool({
47
49
  router,
48
50
  origin,
51
+ getOutboundOrigin,
49
52
  sessionId = '',
50
53
  logger = consoleChannelLogger,
51
54
  }: CreateChannelSendToolOptions) {
@@ -63,7 +66,8 @@ export function createChannelSendTool({
63
66
  'or use `channel_reply`. A returned id starts a thread only where the adapter accepts a message ' +
64
67
  'id as `thread` (e.g. a new top-level Slack post); other adapters use different thread ids. ' +
65
68
  'Some adapters do not report ids. ' +
66
- 'There is no auto-reply: the only way for an agent to post is via this tool.',
69
+ 'For work belonging to another conversation, use channel_session_search and channel_handoff so the owning ' +
70
+ 'session answers with current context. Use this tool for an explicit direct post, not to take over that work.',
67
71
  parameters: Type.Object({
68
72
  adapter: Type.Union(
69
73
  ADAPTER_IDS.map((a) => Type.Literal(a)),
@@ -220,7 +224,7 @@ export function createChannelSendTool({
220
224
  chat: params.chat,
221
225
  thread: params.thread ?? null,
222
226
  text: bodyText,
223
- moreWorkThisTurn: false,
227
+ continueAfterReply: false,
224
228
  resolveReviewThread: wantsResolve,
225
229
  })
226
230
  if (falseReceipt.kind === 'block') {
@@ -242,7 +246,7 @@ export function createChannelSendTool({
242
246
  thread: params.thread ?? null,
243
247
  text: bodyText,
244
248
  wantsResolve,
245
- moreWorkThisTurn: false,
249
+ continueAfterReply: false,
246
250
  getReviewState: (req) => router.getReviewState(req),
247
251
  ...(origin !== undefined &&
248
252
  origin.adapter === adapter &&
@@ -331,15 +335,19 @@ export function createChannelSendTool({
331
335
  ? ((await router.captureBackgroundResultCoverage?.(sessionId)) ?? [])
332
336
  : []
333
337
  const inboundCoverage = settlesOrigin ? ((await router.captureInboundResultCoverage?.(sessionId)) ?? []) : []
334
- const result = await router.send({
335
- adapter,
336
- workspace: params.workspace,
337
- chat: params.chat,
338
- ...(params.thread !== undefined ? { thread: params.thread } : {}),
339
- ...(bodyText !== undefined ? { text: bodyText } : {}),
340
- ...(params.link_previews !== undefined ? { link_previews: params.link_previews } : {}),
341
- ...(attachments !== undefined ? { attachments } : {}),
342
- })
338
+ const outboundOrigin = getOutboundOrigin?.()
339
+ const result = await router.send(
340
+ {
341
+ adapter,
342
+ workspace: params.workspace,
343
+ chat: params.chat,
344
+ ...(params.thread !== undefined ? { thread: params.thread } : {}),
345
+ ...(bodyText !== undefined ? { text: bodyText } : {}),
346
+ ...(params.link_previews !== undefined ? { link_previews: params.link_previews } : {}),
347
+ ...(attachments !== undefined ? { attachments } : {}),
348
+ },
349
+ outboundOrigin ? { origin: outboundOrigin } : undefined,
350
+ )
343
351
 
344
352
  if (!result.ok) {
345
353
  logger.warn(
@@ -386,7 +394,7 @@ export function createChannelSendTool({
386
394
  // denials keep the lighter prefix. See channel-reply.ts for the full
387
395
  // rationale (PR #481 self-reply loop).
388
396
  if (result.ok) {
389
- const echo = renderOutboundEcho(bodyText, attachments)
397
+ const echo = renderOutboundEcho(result.deliveredText ?? bodyText, attachments)
390
398
  const receipt =
391
399
  `posted to ${params.adapter}:${params.workspace}/${params.chat}: ${echo}` +
392
400
  (result.messageId !== undefined ? `\nmessage_id=${JSON.stringify(result.messageId)}` : '') +
@@ -0,0 +1,35 @@
1
+ import { Type } from '@earendil-works/pi-ai'
2
+ import { defineTool } from '@earendil-works/pi-coding-agent'
3
+
4
+ import type { ChannelRouter } from '@/channels/router'
5
+
6
+ export function createChannelSessionSearchTool(options: {
7
+ router: Pick<ChannelRouter, 'searchSessions'>
8
+ sessionId: string
9
+ }) {
10
+ return defineTool({
11
+ name: 'channel_session_search',
12
+ label: 'Channel Session Search',
13
+ description:
14
+ 'Find the session that owns another conversation across all adapters. Search conversation names, recent ' +
15
+ 'messages, or participants in any language. Returns up to 20 authorized, live handoff targets with short ' +
16
+ 'activity hints, newest first. For work belonging elsewhere, search here and pass a result target to ' +
17
+ 'channel_handoff instead of reading or posting there yourself. Identity comes from your authenticated ' +
18
+ 'requester, never from the query. No results means no eligible live session was found.',
19
+ parameters: Type.Object({
20
+ query: Type.String({ description: 'Conversation name, topic, message text, or participant.', minLength: 1 }),
21
+ }),
22
+ async execute(_toolCallId, params) {
23
+ const targets = options.router.searchSessions({ fromSessionId: options.sessionId, query: params.query })
24
+ return {
25
+ content: [
26
+ {
27
+ type: 'text' as const,
28
+ text: targets.length === 0 ? 'No eligible live sessions found.' : JSON.stringify(targets),
29
+ },
30
+ ],
31
+ details: { targets },
32
+ }
33
+ },
34
+ })
35
+ }
@@ -28,18 +28,21 @@ import { withToolOomPriorityArgv } from '@/container/tool-oom-priority'
28
28
  export const CURL_IMPERSONATE_BINARY = 'curl_chrome136'
29
29
  export const DEFAULT_TIMEOUT_SECONDS = 30
30
30
 
31
- let curlBinary: string = CURL_IMPERSONATE_BINARY
31
+ let binaryOverrideForTest: string | null = null
32
32
 
33
33
  // Test-only seam: lets *.test.ts point the spawn at a fake `curl_chrome136`
34
34
  // script in a tmpdir so we exercise the real Bun.spawn path without depending
35
35
  // on a curl-impersonate install on the test host. Production code never calls
36
36
  // this — the module-level default above is what production sees.
37
37
  export function _setCurlBinaryForTest(binary: string | null): void {
38
- curlBinary = binary ?? CURL_IMPERSONATE_BINARY
38
+ binaryOverrideForTest = binary
39
39
  }
40
40
 
41
41
  export type CurlImpersonateRequest = {
42
42
  url: string
43
+ // Wrapper to impersonate (e.g. `curl_firefox147`). Defaults to
44
+ // CURL_IMPERSONATE_BINARY. Only names shipped in the pinned tarball work.
45
+ binary?: string
43
46
  method?: 'GET' | 'POST'
44
47
  // Form-urlencoded body fields for POST. Each entry is passed as a separate
45
48
  // --data-urlencode argument so curl handles the encoding. Required if
@@ -131,7 +134,7 @@ export async function curlImpersonate(req: CurlImpersonateRequest): Promise<Curl
131
134
  const writeOutTemplate = `${sentinel}%{http_code}\n%{url_effective}\n%{content_type}\n%{size_download}\n%{header_json}\n`
132
135
 
133
136
  const cmd: string[] = [
134
- curlBinary,
137
+ binaryOverrideForTest ?? req.binary ?? CURL_IMPERSONATE_BINARY,
135
138
  // `--disable` (alias -q) MUST be the first argument to suppress reading
136
139
  // ~/.curlrc and /etc/curlrc. Without it, a user or attacker-controlled
137
140
  // curlrc could inject --proxy, --header, --resolve, --no-location, etc.,
@@ -334,7 +337,11 @@ let availabilityCache: boolean | undefined
334
337
  export async function isCurlImpersonateAvailable(): Promise<boolean> {
335
338
  if (availabilityCache !== undefined) return availabilityCache
336
339
  try {
337
- const proc = spawn({ cmd: [curlBinary, '--version'], stdout: 'ignore', stderr: 'ignore' })
340
+ const proc = spawn({
341
+ cmd: [binaryOverrideForTest ?? CURL_IMPERSONATE_BINARY, '--version'],
342
+ stdout: 'ignore',
343
+ stderr: 'ignore',
344
+ })
338
345
  const code = await proc.exited
339
346
  availabilityCache = code === 0
340
347
  } catch {