typeclaw 0.49.0 → 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 (442) 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 +9 -2
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/require-parallel.ts +5 -32
  317. package/src/agent/guard-types.ts +3 -0
  318. package/src/agent/guards.ts +4 -0
  319. package/src/agent/idle-compaction.ts +174 -0
  320. package/src/agent/index.ts +74 -16
  321. package/src/agent/live-subagents.ts +19 -0
  322. package/src/agent/multimodal/look-at.ts +22 -9
  323. package/src/agent/plugin-tools.ts +13 -1
  324. package/src/agent/reviewer-bash-policy.ts +41 -1
  325. package/src/agent/session-origin.ts +26 -10
  326. package/src/agent/subagent-cache-keepalive.ts +198 -0
  327. package/src/agent/subagent-session.ts +6 -0
  328. package/src/agent/subagents.ts +46 -8
  329. package/src/agent/system-prompt.ts +1 -1
  330. package/src/agent/tool-file-safety.ts +6 -1
  331. package/src/agent/tools/channel-edit.ts +20 -10
  332. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  333. package/src/agent/tools/channel-handoff.ts +72 -0
  334. package/src/agent/tools/channel-read.ts +57 -10
  335. package/src/agent/tools/channel-reply.ts +33 -26
  336. package/src/agent/tools/channel-send.ts +21 -13
  337. package/src/agent/tools/channel-session-search.ts +35 -0
  338. package/src/agent/tools/curl-impersonate.ts +11 -4
  339. package/src/agent/tools/ddg.ts +13 -5
  340. package/src/agent/tools/spawn-subagent.ts +27 -11
  341. package/src/agent/tools/stream-snapshot.ts +15 -2
  342. package/src/agent/tools/subagent-access.ts +11 -4
  343. package/src/browser/bsk-shim.mjs +74 -0
  344. package/src/browser/dockerfile.ts +84 -0
  345. package/src/browser/egress.ts +104 -0
  346. package/src/browser/managed-browser.ts +205 -0
  347. package/src/browser/registry.ts +110 -0
  348. package/src/browser/relay.ts +231 -0
  349. package/src/browser/sandbox-entry.ts +167 -0
  350. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  351. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  352. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  353. package/src/bundled-plugins/doc-render/index.ts +0 -10
  354. package/src/bundled-plugins/doc-render/render.ts +83 -111
  355. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  356. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  357. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  358. package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
  359. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  360. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  361. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  362. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  363. package/src/bundled-plugins/operator/operator.ts +1 -1
  364. package/src/bundled-plugins/qa/index.ts +11 -0
  365. package/src/bundled-plugins/qa/qa.ts +160 -0
  366. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  367. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  368. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  369. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  370. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  371. package/src/bundled-plugins/security/index.ts +53 -34
  372. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  373. package/src/channels/adapter-namespace.ts +13 -0
  374. package/src/channels/adapters/discord-bot.ts +97 -5
  375. package/src/channels/adapters/github/index.ts +16 -0
  376. package/src/channels/adapters/github/last-alive.ts +4 -16
  377. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  378. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  379. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  380. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  381. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  382. package/src/channels/adapters/slack-bot.ts +299 -67
  383. package/src/channels/adapters/slack-classify.ts +1 -0
  384. package/src/channels/catch-up.ts +137 -0
  385. package/src/channels/continuation-willingness.ts +2 -2
  386. package/src/channels/continuity-types.ts +1 -0
  387. package/src/channels/engagement.ts +17 -1
  388. package/src/channels/github-false-receipt.ts +3 -3
  389. package/src/channels/github-rereview-guard.ts +9 -5
  390. package/src/channels/github-token-bridge.ts +24 -0
  391. package/src/channels/last-alive.ts +34 -0
  392. package/src/channels/manager.ts +8 -1
  393. package/src/channels/router.ts +427 -136
  394. package/src/channels/session-handoff.fixture.ts +144 -0
  395. package/src/channels/session-handoff.ts +175 -0
  396. package/src/channels/session-search.ts +71 -0
  397. package/src/channels/types.ts +12 -2
  398. package/src/cli/channel.ts +2 -3
  399. package/src/cli/init.ts +2 -3
  400. package/src/cli/model.ts +132 -3
  401. package/src/coding-agent/index.ts +7 -1
  402. package/src/coding-agent/omo-stream.ts +40 -0
  403. package/src/coding-agent/runner.ts +30 -8
  404. package/src/config/config.ts +111 -22
  405. package/src/config/model-overrides.ts +59 -0
  406. package/src/config/models-mutation.ts +185 -2
  407. package/src/config/providers-mutation.ts +12 -4
  408. package/src/config/providers.ts +59 -0
  409. package/src/container/start.ts +95 -4
  410. package/src/doctor/checks.ts +8 -6
  411. package/src/hostd/daemon.ts +13 -1
  412. package/src/init/auto-upgrade.ts +7 -1
  413. package/src/init/dockerfile.ts +57 -12
  414. package/src/init/index.ts +4 -3
  415. package/src/init/local-source-stamp.ts +68 -0
  416. package/src/init/models-dev.ts +4 -0
  417. package/src/init/validate-api-key.ts +3 -0
  418. package/src/permissions/builtins.ts +7 -0
  419. package/src/permissions/permissions.ts +18 -9
  420. package/src/permissions/resolve.ts +7 -1
  421. package/src/plugin/context.ts +2 -0
  422. package/src/plugin/hooks.ts +137 -0
  423. package/src/plugin/index.ts +6 -0
  424. package/src/plugin/manager.ts +4 -0
  425. package/src/plugin/types.ts +60 -0
  426. package/src/run/bundled-plugins.ts +6 -0
  427. package/src/run/index.ts +24 -14
  428. package/src/run/llm-fetch-observer.ts +12 -15
  429. package/src/sandbox/canonical-secrets.ts +4 -0
  430. package/src/sandbox/dev-source.ts +26 -0
  431. package/src/sandbox/hidden-paths.ts +16 -2
  432. package/src/secrets/storage.ts +13 -0
  433. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  434. package/src/skills/typeclaw-config/SKILL.md +39 -5
  435. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  436. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  437. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  438. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  439. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  440. package/typeclaw.schema.json +436 -5
  441. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  442. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -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 {
@@ -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,
@@ -182,17 +182,6 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
182
182
  )
183
183
  }
184
184
  const subagentName = params.subagent_type
185
- const { background, overrideNote } = resolveSpawnMode({
186
- foreground: params.run_in_foreground,
187
- fromSubagent: origin?.kind === 'subagent',
188
- // Deep-profile spawns run for minutes; forcing them background from a
189
- // top-level session keeps a foreground run from freezing the message
190
- // loop. Per-spawn override wins over the declared profile.
191
- isDeepProfile: (params.profile ?? subagent.profile) === 'deep',
192
- canBackgroundFromSubagent: allowBackgroundFromSubagent === true,
193
- subagentName,
194
- })
195
-
196
185
  const taskId = generateTaskId()
197
186
  const payload: Record<string, unknown> = { requestId: taskId, prompt: params.prompt }
198
187
  if (params.description !== undefined) payload.description = params.description
@@ -213,6 +202,17 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
213
202
  params.review_identity === undefined
214
203
  ? undefined
215
204
  : githubReviewerWorkKey(params.review_identity.repo, params.review_identity.pull_request)
205
+ const { background, overrideNote } = resolveSpawnMode({
206
+ foreground: params.run_in_foreground,
207
+ fromSubagent: origin?.kind === 'subagent',
208
+ // Deep-profile spawns run for minutes; forcing them background from a
209
+ // top-level session keeps a foreground run from freezing the message
210
+ // loop. Judged on the profile the session will actually run, so an
211
+ // override the subagent's schema strips cannot unlock foreground.
212
+ isDeepProfile: effectiveSpawnProfile(subagent, payload) === 'deep',
213
+ canBackgroundFromSubagent: allowBackgroundFromSubagent === true,
214
+ subagentName,
215
+ })
216
216
 
217
217
  const coalesceKey = subagentCoalesceKey({
218
218
  parentSessionId,
@@ -659,6 +659,22 @@ export type SpawnModeResolution = {
659
659
  overrideNote: string | undefined
660
660
  }
661
661
 
662
+ // The profile the spawned session will actually run. A payload schema may strip
663
+ // a per-spawn `profile` (scout/explorer/browser pin their tier), so read it from
664
+ // the validated payload; an invalid payload fails at invocation, so judge it on
665
+ // the raw override until then.
666
+ export function effectiveSpawnProfile(
667
+ subagent: Pick<Subagent<any>, 'profile' | 'payloadSchema'>,
668
+ payload: Record<string, unknown>,
669
+ ): string | undefined {
670
+ const raw = typeof payload.profile === 'string' ? payload.profile : undefined
671
+ if (subagent.payloadSchema === undefined) return raw ?? subagent.profile
672
+ const parsed = subagent.payloadSchema.safeParse(payload)
673
+ if (!parsed.success) return raw ?? subagent.profile
674
+ const kept = (parsed.data as { profile?: unknown } | null | undefined)?.profile
675
+ return typeof kept === 'string' && kept !== '' ? kept : subagent.profile
676
+ }
677
+
662
678
  // Resolve foreground vs background for a spawn, with the runtime free to
663
679
  // override the caller's request and report why. Two axes decide it: whether the
664
680
  // caller is a top-level session (its turn services the live message loop) or a
@@ -108,7 +108,7 @@ function formatResult(
108
108
  id: e.id,
109
109
  ts: e.ts,
110
110
  target: e.target,
111
- payload: e.payload,
111
+ payload: snapshotPayload(e.payload),
112
112
  ...(e.replyTo !== undefined ? { replyTo: e.replyTo } : {}),
113
113
  ...(e.meta !== undefined ? { meta: e.meta } : {}),
114
114
  })),
@@ -123,7 +123,7 @@ function formatResult(
123
123
 
124
124
  const header = `${events.length} stream event(s) matching ${filterDesc} (oldest → newest):`
125
125
  const lines = [header, '']
126
- for (const event of events) {
126
+ for (const event of details.events) {
127
127
  lines.push(formatEventLine(event))
128
128
  }
129
129
  return {
@@ -132,6 +132,19 @@ function formatResult(
132
132
  }
133
133
  }
134
134
 
135
+ // Stream payloads are runtime objects: a handler cron job contains a function.
136
+ // Tool details enter the transcript, which pi structuredClones before the next
137
+ // provider request. Project only this diagnostic view to its persisted JSON
138
+ // shape; never strip callbacks from the broker's live dispatch payload.
139
+ function snapshotPayload(payload: unknown): unknown {
140
+ try {
141
+ const json = JSON.stringify(payload)
142
+ return json === undefined ? '<unserializable>' : JSON.parse(json)
143
+ } catch {
144
+ return '<unserializable>'
145
+ }
146
+ }
147
+
135
148
  function describeFilter(params: {
136
149
  target_kind?: TargetKind
137
150
  target_id?: string
@@ -16,7 +16,8 @@ export type AuthorizeLiveSubagentAccessArgs = {
16
16
  // The caller's own session id. When the caller is itself a subagent, access
17
17
  // is scoped to subagents IT spawned (live.parentSessionId === callerSessionId)
18
18
  // so a nested subagent cannot read or cancel siblings or parent-branch runs.
19
- // Omitted by main-session callers, which keep the role-severity cap only.
19
+ // For main-session callers it identifies the spawning session: that session
20
+ // may always access its own runs; other sessions' runs stay role-capped.
20
21
  callerSessionId?: string
21
22
  }
22
23
 
@@ -25,8 +26,9 @@ export type AuthorizeLiveSubagentAccessArgs = {
25
26
  // modes, both requiring the base permission first:
26
27
  // - SUBAGENT caller: scoped to runs it spawned (live.parentSessionId ===
27
28
  // callerSessionId). Ownership is the authorization; the role cap is skipped.
28
- // - MAIN-SESSION caller: capped to the requester's role — must resolve to a
29
- // role at least as high as the role that spawned the subagent.
29
+ // - MAIN-SESSION caller: the spawning session may always access its own run;
30
+ // any other session is capped to the requester's role — it must resolve to
31
+ // a role at least as high as the role that spawned the subagent.
30
32
  //
31
33
  // The ordering closes an existence oracle: the task-independent base-permission
32
34
  // check runs BEFORE any registry lookup, and for non-owner callers an absent
@@ -84,7 +86,12 @@ export function authorizeLiveSubagentAccess(args: AuthorizeLiveSubagentAccessArg
84
86
  if (live === undefined) {
85
87
  return { ok: false, message: accessAll ? `Unknown task_id: ${taskId}.` : opaqueDenial }
86
88
  }
87
- if (accessAll) {
89
+ // The session that spawned the run may always read/cancel it. In a shared
90
+ // channel session the origin follows the latest speaker, so a lower-role
91
+ // message (or the completion wake that follows it) would otherwise lock the
92
+ // agent out of its own subagent's result. The cap still stops a lower-role
93
+ // session from reaching a run spawned by a different session.
94
+ if (accessAll || (callerSessionId !== undefined && live.parentSessionId === callerSessionId)) {
88
95
  return { ok: true, live }
89
96
  }
90
97
 
@@ -0,0 +1,74 @@
1
+ // Installed as /usr/local/bin/bsk. The BrowserSkill daemon socket is
2
+ // runtime-private; this gives the real CLI a per-call BSK_HOME whose socket is
3
+ // bridged to TypeClaw's token-gated relay, so only sessions handed the token
4
+ // (roles with browser.shared) can drive the shared browser through bsk.
5
+ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
6
+ import { connect, createServer } from 'node:net'
7
+ import { tmpdir } from 'node:os'
8
+ import { join } from 'node:path'
9
+
10
+ const relay = process.env.TYPECLAW_BSK_RELAY
11
+ const token = process.env.TYPECLAW_BSK_TOKEN
12
+ if (!relay || !token) {
13
+ console.error(
14
+ 'bsk: the shared browser is unavailable in this session (it needs the browser.shared permission, or the browser failed to start; the operator log says which).',
15
+ )
16
+ process.exit(2)
17
+ }
18
+ const separator = relay.lastIndexOf(':')
19
+ const host = relay.slice(0, separator)
20
+ const port = Number(relay.slice(separator + 1))
21
+
22
+ const home = mkdtempSync(join(tmpdir(), 'typeclaw-bsk-'))
23
+ mkdirSync(join(home, 'run'), { mode: 0o700 })
24
+ const server = createServer((inbound) => {
25
+ const outbound = connect(port, host, () => {
26
+ outbound.write(token + '\n')
27
+ inbound.pipe(outbound)
28
+ outbound.pipe(inbound)
29
+ })
30
+ const close = () => {
31
+ inbound.destroy()
32
+ outbound.destroy()
33
+ }
34
+ inbound.on('error', close)
35
+ outbound.on('error', close)
36
+ inbound.on('close', close)
37
+ outbound.on('close', close)
38
+ })
39
+ const sockPath = join(home, 'run', 'daemon.sock')
40
+ await new Promise((resolve) => server.listen(sockPath, resolve))
41
+ // The CLI locates its daemon through daemon.json and cross-checks its pid
42
+ // against the daemon, so mirror the real file and point only sock_path here.
43
+ const daemon = await describeDaemon().then(JSON.parse, () => {
44
+ console.error(
45
+ 'bsk: the shared browser refused this session or its BrowserSkill daemon is not running; the operator log says which.',
46
+ )
47
+ rmSync(home, { recursive: true, force: true })
48
+ process.exit(2)
49
+ })
50
+ writeFileSync(join(home, 'daemon.json'), JSON.stringify({ ...daemon, sock_path: sockPath }))
51
+
52
+ function describeDaemon() {
53
+ return new Promise((resolve, reject) => {
54
+ const socket = connect(port, host, () => socket.write(token + ' describe\n'))
55
+ let text = ''
56
+ socket.on('data', (chunk) => {
57
+ text += chunk
58
+ })
59
+ socket.on('end', () => (text === '' ? reject(new Error('daemon not available')) : resolve(text)))
60
+ socket.on('error', reject)
61
+ })
62
+ }
63
+
64
+ const child = Bun.spawn(
65
+ [process.env.TYPECLAW_BSK_BIN ?? '/usr/local/lib/typeclaw-browser/bsk/bsk', ...process.argv.slice(2)],
66
+ {
67
+ env: { ...process.env, BSK_HOME: home, BSK_AUTO_START: '0' },
68
+ stdio: ['inherit', 'inherit', 'inherit'],
69
+ },
70
+ )
71
+ const code = await child.exited
72
+ server.close()
73
+ rmSync(home, { recursive: true, force: true })
74
+ process.exit(code)