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
@@ -1,9 +1,11 @@
1
1
  import { Type } from '@earendil-works/pi-ai'
2
2
  import { defineTool } from '@earendil-works/pi-coding-agent'
3
3
 
4
+ import type { BackgroundObligationRef } from '@/channels/background-obligations'
4
5
  import { checkCompletionClaim } from '@/channels/completion-claim'
5
6
  import { checkFalseReceipt } from '@/channels/github-false-receipt'
6
7
  import { evaluateRereviewGuard } from '@/channels/github-rereview-guard'
8
+ import type { InboundRef } from '@/channels/inbound-journal'
7
9
  import {
8
10
  containsKimiToolDelimiter,
9
11
  isNoReplySignal,
@@ -13,6 +15,7 @@ import {
13
15
  } from '@/channels/router'
14
16
  import type { AdapterId } from '@/channels/schema'
15
17
  import type { GithubReviewFollowupRound } from '@/channels/types'
18
+ import type { ChannelOutboundOrigin } from '@/plugin'
16
19
 
17
20
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
18
21
  import { fenceRuntimeNotice, fenceToolResult } from './runtime-notice'
@@ -28,6 +31,7 @@ export type ChannelReplyOrigin = {
28
31
  export type CreateChannelReplyToolOptions = {
29
32
  router: ChannelRouter
30
33
  origin: ChannelReplyOrigin
34
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined
31
35
  // Scopes the per-turn false-receipt ledger. Defaults to '' when a caller (e.g.
32
36
  // a focused test) has no session; the guard then simply finds no recorded
33
37
  // action and falls back to its safe default.
@@ -47,6 +51,7 @@ export type CreateChannelReplyToolOptions = {
47
51
  export function createChannelReplyTool({
48
52
  router,
49
53
  origin,
54
+ getOutboundOrigin,
50
55
  sessionId = '',
51
56
  logger = consoleChannelLogger,
52
57
  }: CreateChannelReplyToolOptions) {
@@ -56,12 +61,12 @@ export function createChannelReplyTool({
56
61
  description:
57
62
  'Reply in the current conversation. This is your default way to respond to a channel session — ' +
58
63
  'addressing fields (adapter, workspace, chat, thread) are filled in from the session origin, so ' +
59
- 'you only supply the text. To post somewhere else (different chat, break out of the current ' +
60
- 'thread, etc.), use `channel_send` instead. ' +
61
- 'On success the result carries `messageId` (the posted message id) and `messageIds` (every id when ' +
62
- 'the text was split into multiple posts) when the platform reports them; pass `messageId` as a ' +
63
- '`channel_send` `thread` to post follow-ups into the same thread. Some adapters do not report an id, ' +
64
- 'in which case both are absent.',
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. ' +
66
+ 'On success the result carries adapter-reported posted-message ids (`messageId` and `messageIds` ' +
67
+ 'in send order) when available. For follow-ups, reuse `channel_reply` or the existing ' +
68
+ '`channel_send` thread/root coordinates; a returned id starts a thread only where the adapter ' +
69
+ 'accepts a message id as `thread` (e.g. a new top-level Slack post).',
65
70
  parameters: Type.Object({
66
71
  text: Type.Optional(
67
72
  Type.String({
@@ -70,6 +75,12 @@ export function createChannelReplyTool({
70
75
  minLength: 1,
71
76
  }),
72
77
  ),
78
+ link_previews: Type.Optional(
79
+ Type.Boolean({
80
+ description:
81
+ 'Set false to suppress link/media previews on Slack bot and Telegram bot text replies. True or omitted preserves platform defaults. Ignored on other adapters. Slack file-upload captions are not covered.',
82
+ }),
83
+ ),
73
84
  attachments: Type.Optional(
74
85
  Type.Array(
75
86
  Type.Object({
@@ -86,17 +97,17 @@ export function createChannelReplyTool({
86
97
  },
87
98
  ),
88
99
  ),
89
- more_work_this_turn: Type.Boolean({
100
+ continue_after_reply: Type.Boolean({
90
101
  description:
91
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. ' +
92
103
  'Set `false` when this reply is your final message for the turn (the common case). ' +
93
- '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. ' +
94
105
  'Do not set `true` just to seem responsive; only when genuine multi-step work follows in the same turn.',
95
106
  }),
96
107
  resolve_review_thread: Type.Optional(
97
108
  Type.Boolean({
98
109
  description:
99
- '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.) ' +
100
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. ' +
101
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.",
102
113
  }),
@@ -106,7 +117,7 @@ export function createChannelReplyTool({
106
117
  async execute(_toolCallId, params) {
107
118
  let text = params.text
108
119
  const attachments = params.attachments
109
- const keepTurnAlive = params.more_work_this_turn === true
120
+ const keepTurnAlive = params.continue_after_reply === true
110
121
  if ((text === undefined || text === '') && (attachments === undefined || attachments.length === 0)) {
111
122
  logger.warn(formatChannelToolFailure('channel_reply', 'missing text and attachments'))
112
123
  return {
@@ -160,7 +171,7 @@ export function createChannelReplyTool({
160
171
  if (keepTurnAlive && params.resolve_review_thread !== undefined) {
161
172
  const error =
162
173
  '`resolve_review_thread` is a terminal close-out decision and cannot be combined with ' +
163
- '`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.'
164
175
  logger.warn(formatChannelToolFailure('channel_reply', error))
165
176
  return {
166
177
  content: [{ type: 'text' as const, text: `channel_reply denied: ${error}` }],
@@ -178,7 +189,7 @@ export function createChannelReplyTool({
178
189
  const missingResolveChoice = missingReviewThreadResolveChoiceError({
179
190
  origin,
180
191
  text,
181
- moreWorkThisTurn: keepTurnAlive,
192
+ continueAfterReply: keepTurnAlive,
182
193
  resolveReviewThread: params.resolve_review_thread,
183
194
  })
184
195
  if (missingResolveChoice) {
@@ -199,7 +210,7 @@ export function createChannelReplyTool({
199
210
  chat: origin.chat,
200
211
  thread: origin.thread,
201
212
  text,
202
- moreWorkThisTurn: keepTurnAlive,
213
+ continueAfterReply: keepTurnAlive,
203
214
  resolveReviewThread: params.resolve_review_thread === true,
204
215
  })
205
216
  if (falseReceipt.kind === 'block') {
@@ -235,7 +246,7 @@ export function createChannelReplyTool({
235
246
  thread: origin.thread,
236
247
  text,
237
248
  wantsResolve: params.resolve_review_thread === true,
238
- moreWorkThisTurn: keepTurnAlive,
249
+ continueAfterReply: keepTurnAlive,
239
250
  getReviewState: (req) => router.getReviewState(req),
240
251
  ...(origin.githubReviewRound !== undefined ? { round: origin.githubReviewRound } : {}),
241
252
  })
@@ -272,7 +283,7 @@ export function createChannelReplyTool({
272
283
  })
273
284
  return {
274
285
  content: [{ type: 'text' as const, text: alreadyResolvedHint(origin.thread) }],
275
- details: { ok: true, ...(keepTurnAlive ? { more_work_this_turn: true } : {}) },
286
+ details: { ok: true, ...(keepTurnAlive ? { continue_after_reply: true } : {}) },
276
287
  }
277
288
  }
278
289
  // `no-match` stays non-blocking (the thread may be genuinely gone) but
@@ -291,14 +302,21 @@ export function createChannelReplyTool({
291
302
  }
292
303
  }
293
304
 
294
- const result = await router.send({
295
- adapter: origin.adapter,
296
- workspace: origin.workspace,
297
- chat: origin.chat,
298
- thread: origin.thread,
299
- ...(text !== undefined ? { text } : {}),
300
- ...(attachments !== undefined ? { attachments } : {}),
301
- })
305
+ const backgroundCoverage = (await router.captureBackgroundResultCoverage?.(sessionId)) ?? []
306
+ const inboundCoverage = (await router.captureInboundResultCoverage?.(sessionId)) ?? []
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
+ )
302
320
 
303
321
  if (!result.ok) {
304
322
  logger.warn(
@@ -323,19 +341,23 @@ export function createChannelReplyTool({
323
341
  decision: 'left-open',
324
342
  })
325
343
  }
326
- // `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),
327
345
  // not by this tool — it suppresses the post-reply abort so a multi-step turn
328
346
  // keeps going. Success-only: a denied reply never ran, so there is no turn to keep.
329
347
  const details: {
330
348
  ok: boolean
331
349
  error?: string
332
- more_work_this_turn?: boolean
350
+ continue_after_reply?: boolean
333
351
  messageId?: string
334
352
  messageIds?: readonly string[]
353
+ backgroundCoverage?: BackgroundObligationRef[]
354
+ inboundCoverage?: InboundRef[]
335
355
  } = result.ok
336
356
  ? {
337
357
  ok: true,
338
- ...(keepTurnAlive ? { more_work_this_turn: true } : {}),
358
+ backgroundCoverage,
359
+ inboundCoverage,
360
+ ...(keepTurnAlive ? { continue_after_reply: true } : {}),
339
361
  ...(result.messageId !== undefined ? { messageId: result.messageId } : {}),
340
362
  ...(result.messageIds !== undefined ? { messageIds: result.messageIds } : {}),
341
363
  }
@@ -357,8 +379,11 @@ export function createChannelReplyTool({
357
379
  // answering its own echo and looping (PR #481). Denials carry no echoed
358
380
  // prose (just machine error text), so they keep the lighter prefix.
359
381
  if (result.ok) {
360
- const echo = renderOutboundEcho(text, attachments)
361
- const receipt = `posted to ${origin.adapter}:${origin.workspace}/${origin.chat}: ${echo}`
382
+ const echo = renderOutboundEcho(result.deliveredText ?? text, attachments)
383
+ const receipt =
384
+ `posted to ${origin.adapter}:${origin.workspace}/${origin.chat}: ${echo}` +
385
+ (result.messageId !== undefined ? `\nmessage_id=${JSON.stringify(result.messageId)}` : '') +
386
+ (result.messageIds !== undefined ? `\nmessage_ids=${JSON.stringify(result.messageIds)}` : '')
362
387
  const hint = consecutiveSendHint(
363
388
  router.getConsecutiveSendCount({
364
389
  adapter: origin.adapter,
@@ -401,13 +426,13 @@ function parseGithubPrNumber(chat: string): number {
401
426
  function missingReviewThreadResolveChoiceError(input: {
402
427
  origin: ChannelReplyOrigin
403
428
  text: string | undefined
404
- moreWorkThisTurn: boolean
429
+ continueAfterReply: boolean
405
430
  resolveReviewThread: boolean | undefined
406
431
  }): string {
407
432
  const isGithubPrReviewThread =
408
433
  input.origin.adapter === 'github' && /^pr:\d+$/.test(input.origin.chat) && input.origin.thread !== null
409
434
  const hasText = input.text !== undefined && input.text.trim() !== ''
410
- if (!isGithubPrReviewThread || !hasText || input.moreWorkThisTurn || input.resolveReviewThread !== undefined) {
435
+ if (!isGithubPrReviewThread || !hasText || input.continueAfterReply || input.resolveReviewThread !== undefined) {
411
436
  return ''
412
437
  }
413
438
  return (
@@ -1,9 +1,11 @@
1
1
  import { Type } from '@earendil-works/pi-ai'
2
2
  import { defineTool } from '@earendil-works/pi-coding-agent'
3
3
 
4
+ import type { BackgroundObligationRef } from '@/channels/background-obligations'
4
5
  import { checkFalseReceipt } from '@/channels/github-false-receipt'
5
6
  import { evaluateRereviewGuard } from '@/channels/github-rereview-guard'
6
7
  import { recordResolvedThread } from '@/channels/github-review-turn-ledger'
8
+ import type { InboundRef } from '@/channels/inbound-journal'
7
9
  import {
8
10
  containsKimiToolDelimiter,
9
11
  isNoReplySignal,
@@ -13,6 +15,7 @@ import {
13
15
  } from '@/channels/router'
14
16
  import { ADAPTER_IDS, type AdapterId } from '@/channels/schema'
15
17
  import type { GithubReviewFollowupRound } from '@/channels/types'
18
+ import type { ChannelOutboundOrigin } from '@/plugin'
16
19
 
17
20
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
18
21
  import { renderOutboundEcho, TOOL_RESULT_PREFIX } from './channel-reply'
@@ -34,6 +37,7 @@ export type CreateChannelSendToolOptions = {
34
37
  // the model can self-correct on its next turn. Absent for sessions whose
35
38
  // origin isn't a channel (e.g. cron prompts that send to channels).
36
39
  origin?: ChannelSendOrigin
40
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined
37
41
  // Scopes the per-turn false-receipt ledger for github resolve close-outs.
38
42
  // Defaults to '' when absent (cron / non-channel sessions); the guard then
39
43
  // finds no recorded action and falls back to its safe default.
@@ -44,6 +48,7 @@ export type CreateChannelSendToolOptions = {
44
48
  export function createChannelSendTool({
45
49
  router,
46
50
  origin,
51
+ getOutboundOrigin,
47
52
  sessionId = '',
48
53
  logger = consoleChannelLogger,
49
54
  }: CreateChannelSendToolOptions) {
@@ -55,12 +60,14 @@ export function createChannelSendTool({
55
60
  'For Discord guild channels, workspace is the guild id; for Slack team channels, workspace is ' +
56
61
  'the team id (e.g. "T0ACME"). For DMs on either platform, workspace is the literal "@dm". ' +
57
62
  'On failure (no adapter registered, or the adapter-level send failed), the call returns ' +
58
- '{ ok: false, error }. On success it returns { ok: true } and, when the platform reports it, ' +
59
- '`messageId` (the posted message id, e.g. a Slack thread ts or Discord/Telegram message id) plus ' +
60
- '`messageIds` (every id in send order when the post was split into multiple messages; `messageId` is ' +
61
- 'the reply anchor — usually the first message). Pass `messageId` back as `thread` on a later send to ' +
62
- 'post follow-ups into the same thread. Some adapters do not report an id, in which case both are absent. ' +
63
- 'There is no auto-reply: the only way for an agent to post is via this tool.',
63
+ '{ ok: false, error }. On success it returns { ok: true } and, when reported, `messageId` ' +
64
+ '(an adapter-reported id of a posted message) and `messageIds` (reported posted-message ids in ' +
65
+ 'send order). To continue the same conversation, reuse its existing `thread`/root coordinates ' +
66
+ 'or use `channel_reply`. A returned id starts a thread only where the adapter accepts a message ' +
67
+ 'id as `thread` (e.g. a new top-level Slack post); other adapters use different thread ids. ' +
68
+ 'Some adapters do not report ids. ' +
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.',
64
71
  parameters: Type.Object({
65
72
  adapter: Type.Union(
66
73
  ADAPTER_IDS.map((a) => Type.Literal(a)),
@@ -90,6 +97,12 @@ export function createChannelSendTool({
90
97
  minLength: 1,
91
98
  }),
92
99
  ),
100
+ link_previews: Type.Optional(
101
+ Type.Boolean({
102
+ description:
103
+ 'Set false to suppress link/media previews on Slack bot and Telegram bot text posts. True or omitted preserves platform defaults. Ignored on other adapters. Slack file-upload captions are not covered.',
104
+ }),
105
+ ),
93
106
  attachments: Type.Optional(
94
107
  Type.Array(
95
108
  Type.Object({
@@ -211,7 +224,7 @@ export function createChannelSendTool({
211
224
  chat: params.chat,
212
225
  thread: params.thread ?? null,
213
226
  text: bodyText,
214
- moreWorkThisTurn: false,
227
+ continueAfterReply: false,
215
228
  resolveReviewThread: wantsResolve,
216
229
  })
217
230
  if (falseReceipt.kind === 'block') {
@@ -233,7 +246,7 @@ export function createChannelSendTool({
233
246
  thread: params.thread ?? null,
234
247
  text: bodyText,
235
248
  wantsResolve,
236
- moreWorkThisTurn: false,
249
+ continueAfterReply: false,
237
250
  getReviewState: (req) => router.getReviewState(req),
238
251
  ...(origin !== undefined &&
239
252
  origin.adapter === adapter &&
@@ -304,14 +317,37 @@ export function createChannelSendTool({
304
317
  }
305
318
  }
306
319
 
307
- const result = await router.send({
308
- adapter,
309
- workspace: params.workspace,
310
- chat: params.chat,
311
- ...(params.thread !== undefined ? { thread: params.thread } : {}),
312
- ...(bodyText !== undefined ? { text: bodyText } : {}),
313
- ...(attachments !== undefined ? { attachments } : {}),
314
- })
320
+ // An answer posted to this session's exact origin conversation fulfills the
321
+ // same debt channel_reply would, so capture the invoking session's owned
322
+ // coverage before the send (mirrors channel_reply). Any other destination —
323
+ // a different thread, the root instead of the origin thread, another chat,
324
+ // workspace or adapter — and sessions without a channel origin capture
325
+ // nothing: posting elsewhere must never settle, or borrow, an inbound's debt.
326
+ const thread = params.thread ?? null
327
+ const settlesOrigin =
328
+ origin !== undefined &&
329
+ sessionId !== '' &&
330
+ origin.adapter === adapter &&
331
+ origin.workspace === params.workspace &&
332
+ origin.chat === params.chat &&
333
+ origin.thread === thread
334
+ const backgroundCoverage = settlesOrigin
335
+ ? ((await router.captureBackgroundResultCoverage?.(sessionId)) ?? [])
336
+ : []
337
+ const inboundCoverage = settlesOrigin ? ((await router.captureInboundResultCoverage?.(sessionId)) ?? []) : []
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
+ )
315
351
 
316
352
  if (!result.ok) {
317
353
  logger.warn(
@@ -336,9 +372,20 @@ export function createChannelSendTool({
336
372
  decision: 'left-open',
337
373
  })
338
374
  }
339
- const details: { ok: boolean; error?: string; messageId?: string; messageIds?: readonly string[] } = result.ok
375
+ // Captured refs travel only with an actual landed send; the router's
376
+ // after-tool hook settles exactly these generations. A status/progress body
377
+ // is still returned here and left owed by that hook.
378
+ const details: {
379
+ ok: boolean
380
+ error?: string
381
+ messageId?: string
382
+ messageIds?: readonly string[]
383
+ backgroundCoverage?: BackgroundObligationRef[]
384
+ inboundCoverage?: InboundRef[]
385
+ } = result.ok
340
386
  ? {
341
387
  ok: true,
388
+ ...(settlesOrigin ? { backgroundCoverage, inboundCoverage } : {}),
342
389
  ...(result.messageId !== undefined ? { messageId: result.messageId } : {}),
343
390
  ...(result.messageIds !== undefined ? { messageIds: result.messageIds } : {}),
344
391
  }
@@ -347,8 +394,11 @@ export function createChannelSendTool({
347
394
  // denials keep the lighter prefix. See channel-reply.ts for the full
348
395
  // rationale (PR #481 self-reply loop).
349
396
  if (result.ok) {
350
- const echo = renderOutboundEcho(bodyText, attachments)
351
- const receipt = `posted to ${params.adapter}:${params.workspace}/${params.chat}: ${echo}`
397
+ const echo = renderOutboundEcho(result.deliveredText ?? bodyText, attachments)
398
+ const receipt =
399
+ `posted to ${params.adapter}:${params.workspace}/${params.chat}: ${echo}` +
400
+ (result.messageId !== undefined ? `\nmessage_id=${JSON.stringify(result.messageId)}` : '') +
401
+ (result.messageIds !== undefined ? `\nmessage_ids=${JSON.stringify(result.messageIds)}` : '')
352
402
  const hints: string[] = []
353
403
  const consecutive = consecutiveSendHint(
354
404
  router.getConsecutiveSendCount({
@@ -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
+ }
@@ -22,21 +22,27 @@ import { randomBytes } from 'node:crypto'
22
22
 
23
23
  import { spawn } from 'bun'
24
24
 
25
+ import { readOomEvents, toolOomNote } from '@/container/oom-events'
26
+ import { withToolOomPriorityArgv } from '@/container/tool-oom-priority'
27
+
25
28
  export const CURL_IMPERSONATE_BINARY = 'curl_chrome136'
26
29
  export const DEFAULT_TIMEOUT_SECONDS = 30
27
30
 
28
- let curlBinary: string = CURL_IMPERSONATE_BINARY
31
+ let binaryOverrideForTest: string | null = null
29
32
 
30
33
  // Test-only seam: lets *.test.ts point the spawn at a fake `curl_chrome136`
31
34
  // script in a tmpdir so we exercise the real Bun.spawn path without depending
32
35
  // on a curl-impersonate install on the test host. Production code never calls
33
36
  // this — the module-level default above is what production sees.
34
37
  export function _setCurlBinaryForTest(binary: string | null): void {
35
- curlBinary = binary ?? CURL_IMPERSONATE_BINARY
38
+ binaryOverrideForTest = binary
36
39
  }
37
40
 
38
41
  export type CurlImpersonateRequest = {
39
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
40
46
  method?: 'GET' | 'POST'
41
47
  // Form-urlencoded body fields for POST. Each entry is passed as a separate
42
48
  // --data-urlencode argument so curl handles the encoding. Required if
@@ -128,7 +134,7 @@ export async function curlImpersonate(req: CurlImpersonateRequest): Promise<Curl
128
134
  const writeOutTemplate = `${sentinel}%{http_code}\n%{url_effective}\n%{content_type}\n%{size_download}\n%{header_json}\n`
129
135
 
130
136
  const cmd: string[] = [
131
- curlBinary,
137
+ binaryOverrideForTest ?? req.binary ?? CURL_IMPERSONATE_BINARY,
132
138
  // `--disable` (alias -q) MUST be the first argument to suppress reading
133
139
  // ~/.curlrc and /etc/curlrc. Without it, a user or attacker-controlled
134
140
  // curlrc could inject --proxy, --header, --resolve, --no-location, etc.,
@@ -192,8 +198,9 @@ export async function curlImpersonate(req: CurlImpersonateRequest): Promise<Curl
192
198
  // a 30s hang. process.kill(-pid) addresses the negative PID, which signals
193
199
  // the entire process group, killing both atomically. detached: true makes
194
200
  // the child the pgid leader so -pid is well-defined.
201
+ const oomBefore = readOomEvents()
195
202
  const proc = spawn({
196
- cmd,
203
+ cmd: withToolOomPriorityArgv(cmd),
197
204
  stdout: 'pipe',
198
205
  stderr: 'pipe',
199
206
  detached: true,
@@ -219,9 +226,14 @@ export async function curlImpersonate(req: CurlImpersonateRequest): Promise<Curl
219
226
  throw new CurlImpersonateError('aborted', exitCode, stderr)
220
227
  }
221
228
 
229
+ const oomNote = toolOomNote(oomBefore, exitCode, 'web search', { log: (line) => console.warn(line) })
222
230
  if (exitCode !== 0) {
223
231
  const detail = stderr.trim() || 'no stderr'
224
- throw new CurlImpersonateError(`curl-impersonate exited ${exitCode}: ${detail}`, exitCode, stderr)
232
+ throw new CurlImpersonateError(
233
+ `curl-impersonate exited ${exitCode}: ${detail}${oomNote === null ? '' : `\n${oomNote}`}`,
234
+ exitCode,
235
+ stderr,
236
+ )
225
237
  }
226
238
 
227
239
  return parseCurlOutput(stdoutBuf, sentinel, stderr)
@@ -325,7 +337,11 @@ let availabilityCache: boolean | undefined
325
337
  export async function isCurlImpersonateAvailable(): Promise<boolean> {
326
338
  if (availabilityCache !== undefined) return availabilityCache
327
339
  try {
328
- 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
+ })
329
345
  const code = await proc.exited
330
346
  availabilityCache = code === 0
331
347
  } catch {
@@ -20,6 +20,13 @@ export { _setCurlBinaryForTest } from './curl-impersonate'
20
20
 
21
21
  const DDG_LITE_URL = 'https://lite.duckduckgo.com/lite/'
22
22
 
23
+ // As of 2026-10 DDG-lite answers every desktop Chrome fingerprint (124-146,
24
+ // including the curl_chrome136 default) with a 202 challenge page from IPs
25
+ // where Firefox and Safari fingerprints still get a normal SERP. Try them in
26
+ // order and only treat the request as CAPTCHA'd when every profile is
27
+ // challenged. Both wrappers ship in the pinned curl-impersonate tarball.
28
+ export const DDG_PROFILES = ['curl_firefox147', 'curl_safari184'] as const
29
+
23
30
  // Empirically derived: a clean source IP serves DDG-lite at concurrency ~4 but
24
31
  // trips a sticky multi-minute CAPTCHA at 5-6 (see keyed-semaphore.ts header).
25
32
  // The whole agent egresses from one IP and the scout subagent fans out parallel
@@ -55,11 +62,11 @@ export async function ddgSearch(query: string, limit: number, signal?: AbortSign
55
62
  () =>
56
63
  withSearchRetry(
57
64
  async () => {
58
- const html = await fetchDdgHtml(query, signal)
59
- if (isCaptcha(html)) {
60
- throw new DdgCaptchaError()
65
+ for (const binary of DDG_PROFILES) {
66
+ const html = await fetchDdgHtml(query, signal, binary)
67
+ if (!isCaptcha(html)) return parseDdgHtml(html).slice(0, limit)
61
68
  }
62
- return parseDdgHtml(html).slice(0, limit)
69
+ throw new DdgCaptchaError()
63
70
  },
64
71
  { ...retryOverride, shouldRetry: isTransientSearchError, signal },
65
72
  ),
@@ -88,9 +95,10 @@ export class DdgCaptchaError extends Error {
88
95
  }
89
96
  }
90
97
 
91
- export async function fetchDdgHtml(query: string, signal?: AbortSignal): Promise<string> {
98
+ export async function fetchDdgHtml(query: string, signal?: AbortSignal, binary?: string): Promise<string> {
92
99
  const response = await curlImpersonate({
93
100
  url: DDG_LITE_URL,
101
+ binary,
94
102
  method: 'POST',
95
103
  formFields: [{ name: 'q', value: query }],
96
104
  signal,