typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -0,0 +1,68 @@
1
+ import type { ReviewerActivity } from '@/channels/github-review-check'
2
+
3
+ import type { AgentSession } from './index'
4
+
5
+ const READING_TOOLS = new Set(['read', 'grep', 'find', 'ls'])
6
+ const COMMAND_TOOLS = new Set(['bash'])
7
+
8
+ type SessionEvent = { type: string; toolName?: unknown; args?: unknown; message?: unknown }
9
+
10
+ // Folds a reviewer session's events into the plain categories the review check
11
+ // shows. Only counts and categories leave this function: file paths, commands,
12
+ // and model text never reach the check page.
13
+ export function attachReviewerActivityCapture(
14
+ session: Pick<AgentSession, 'subscribe'>,
15
+ report: (activity: ReviewerActivity) => void,
16
+ now: () => number = Date.now,
17
+ ): () => void {
18
+ const files = new Set<string>()
19
+ const activity: ReviewerActivity = {
20
+ started: false,
21
+ filesRead: 0,
22
+ commandsRun: 0,
23
+ current: null,
24
+ lastActivityAt: null,
25
+ }
26
+ const unsubscribe = session.subscribe((raw: unknown) => {
27
+ const event = raw as SessionEvent
28
+ if (event.type === 'tool_execution_start' && typeof event.toolName === 'string') {
29
+ activity.started = true
30
+ if (READING_TOOLS.has(event.toolName)) {
31
+ activity.current = 'reading'
32
+ const path = (event.args as { path?: unknown } | undefined)?.path
33
+ if (event.toolName === 'read' && typeof path === 'string') files.add(path)
34
+ activity.filesRead = files.size
35
+ } else if (COMMAND_TOOLS.has(event.toolName)) {
36
+ activity.current = 'commands'
37
+ activity.commandsRun += 1
38
+ }
39
+ } else if (event.type === 'message_end' && hasText(event.message)) {
40
+ activity.current = 'writing'
41
+ } else if (event.type !== 'tool_execution_end') {
42
+ return
43
+ }
44
+ activity.lastActivityAt = now()
45
+ report({ ...activity })
46
+ })
47
+ return () => {
48
+ if (typeof unsubscribe === 'function') unsubscribe()
49
+ }
50
+ }
51
+
52
+ function hasText(message: unknown): boolean {
53
+ if (typeof message !== 'object' || message === null) return false
54
+ const { role, content } = message as { role?: unknown; content?: unknown }
55
+ if (role !== undefined && role !== 'assistant') return false
56
+ if (typeof content === 'string') return content.trim() !== ''
57
+ return (
58
+ Array.isArray(content) &&
59
+ content.some(
60
+ (part: unknown) =>
61
+ typeof part === 'object' &&
62
+ part !== null &&
63
+ (part as { type?: unknown }).type === 'text' &&
64
+ typeof (part as { text?: unknown }).text === 'string' &&
65
+ (part as { text: string }).text.trim() !== '',
66
+ )
67
+ )
68
+ }
@@ -599,8 +599,12 @@ function classifySegment(segment: Segment): void {
599
599
 
600
600
  export function enforceReviewerReadonlyBashPolicy(command: string): void {
601
601
  if (typeof command !== 'string' || command.trim().length === 0) return
602
+ // Single-quoted text is literal to bash, so backticks or `$(` inside a quoted
603
+ // jq filter or markdown review body are not substitutions. Double quotes stay
604
+ // in the scan because bash still substitutes inside them.
605
+ const scanned = stripSingleQuotedText(command)
602
606
  for (const { pattern, reason } of FAIL_CLOSED_CONSTRUCTS) {
603
- if (pattern.test(command)) {
607
+ if (pattern.test(scanned)) {
604
608
  throw new SubagentBashPolicyError(`command uses ${reason}, which the reviewer policy cannot analyze safely.`)
605
609
  }
606
610
  }
@@ -608,6 +612,42 @@ export function enforceReviewerReadonlyBashPolicy(command: string): void {
608
612
  for (const segment of segments) classifySegment(segment)
609
613
  }
610
614
 
615
+ // A `'` inside double quotes or after a backslash does not open a quote, so a
616
+ // plain regex would let `"it's `id`" 'x'` hide a live substitution.
617
+ function stripSingleQuotedText(command: string): string {
618
+ let out = ''
619
+ let inDouble = false
620
+ for (let i = 0; i < command.length; i++) {
621
+ const ch = command[i] as string
622
+ if (ch === '\\') {
623
+ out += command.slice(i, i + 2)
624
+ i++
625
+ continue
626
+ }
627
+ if (ch === '"') inDouble = !inDouble
628
+ // Bash ignores an unquoted `#` comment through the newline, so quotes inside
629
+ // it would mis-pair here and in splitIntoSegments and hide the next line.
630
+ if (ch === '#' && !inDouble && (i === 0 || /[\s;&|()]/.test(command[i - 1] as string))) {
631
+ const newline = command.indexOf('\n', i)
632
+ const comment = command.slice(i, newline === -1 ? undefined : newline)
633
+ if (/['"]/.test(comment)) {
634
+ throw new SubagentBashPolicyError(
635
+ 'a shell comment containing quotes cannot be analyzed safely; drop the comment.',
636
+ )
637
+ }
638
+ }
639
+ if (ch === "'" && !inDouble) {
640
+ const end = command.indexOf("'", i + 1)
641
+ if (end === -1) return command
642
+ out += "''"
643
+ i = end
644
+ continue
645
+ }
646
+ out += ch
647
+ }
648
+ return out
649
+ }
650
+
611
651
  export function enforceSubagentBashPolicy(policy: SubagentBashPolicy, command: string): void {
612
652
  if (policy.kind === 'readonly-reviewer') enforceReviewerReadonlyBashPolicy(command)
613
653
  }
@@ -43,6 +43,9 @@ export type SessionOrigin =
43
43
  parentChat?: string
44
44
  parentChatName?: string
45
45
  lastInboundAuthorId?: string
46
+ // Runtime-authenticated source of a delegated author, never model input.
47
+ // Foreign namespaces may match authorless rules, not local author IDs.
48
+ lastInboundAuthorAdapter?: AdapterId
46
49
  reactionRef?: ReactionRef
47
50
  participants?: readonly ChannelParticipant[]
48
51
  membership?: MembershipCount
@@ -276,6 +279,40 @@ export function renderSessionOrigin(
276
279
  }
277
280
  }
278
281
 
282
+ // Optional context for interactive sessions (TUI, channel, and origin-less
283
+ // sessions), appended by `composeSystemPrompt` in full mode only. It holds how
284
+ // to stay responsive and delegate — never permission, honesty, or filesystem
285
+ // rules, which live once in the shared policy every standard session gets.
286
+ // Deliberately separate from `renderSessionOrigin`: override loaders render
287
+ // origins too and must not inherit this context. The `spawn_subagent`
288
+ // parameter descriptions point at this heading and the
289
+ // [CONTEXT]/[GOAL]/[REQUEST] structure.
290
+ export function renderInteractiveSessionContext(subagentRoster: string): string {
291
+ return [
292
+ '## Subagent orchestration',
293
+ '',
294
+ 'Keep the conversation responsive. Answer quick, single-shot requests inline. Delegate heavy, side-effectful, long-running, or multi-step work — installs, builds, `docker`, long test runs, refactors, a bug that resisted a quick fix — to a subagent (usually `operator`) instead of grinding through it here; use `tmux` only for long work that belongs in this session.',
295
+ '',
296
+ `Delegate with \`spawn_subagent\`, \`subagent_output\`, and \`subagent_cancel\`; each subagent has its own context and tools, and the tool description has the mechanics. Briefly: ${subagentRoster}.`,
297
+ '',
298
+ '- Spawns run in the background by default: a `<system-reminder>` arrives when the subagent completes — do not poll `subagent_output`. Pass `run_in_foreground: true` for a quick result you need this turn; deep-profile subagents always run in the background from here. In channel sessions a completion reminder is not a user message: surface the result via `channel_reply`/`channel_send`.',
299
+ '- Broad search: spawn 2-5 `explorer`/`scout` workers in parallel, end your response, then collect each completion once. Use `scout` for narrow lookups and `researcher` for decomposed, multi-source, cross-validated synthesis. When the user *explicitly* asks to research or investigate, you MUST spawn `researcher`: answering from training memory or one inline `web_search` does not satisfy the request, and `scout`/`explorer` fan-out does not replace `researcher`.',
300
+ '- Delegate-and-converse: for side-effectful or noisy work over ~30s, spawn one background subagent and stay responsive — `operator` for side effects, `scout` for a quick lookup, `researcher` for deep investigation, `planner` for risk-aware sequencing, `qa` to prove a PR, repo, or deployed product actually works by running it. Pass `profile: "deep"` only when the work needs stronger reasoning than the default tier.',
301
+ '- Web browsing: never drive a browser yourself. Any task that needs a real browser — navigating, clicking, forms, logins, screenshots, JS-rendered pages — goes to `browser`. Plain lookups stay with `scout`/`web_fetch`.',
302
+ '- Troubleshooting: after ~3 non-converging attempts at the same failure, stop and hand the loop to `operator` (background; `profile: "deep"` when genuinely hard) with the symptom, attempts, and success condition. Read `typeclaw-troubleshooting` before spawning.',
303
+ "- Status: when asked about a running subagent, call `subagent_output({ task_id })` and report its `status_summary` — don't guess.",
304
+ "- Don't fire more than 5 subagents per turn, spawn for known answers or single-file lookups, poll output in a loop, or ask research subagents to decide: they report; you decide. Most subagents are leaves; only `operator` and `reviewer` may delegate one level deeper.",
305
+ '',
306
+ 'Spawn prompt structure (mandatory — the subagent does not see this conversation):',
307
+ '',
308
+ '```',
309
+ "[CONTEXT]: What I'm working on, which files/modules are involved, what approach.",
310
+ '[GOAL]: The specific decision or output I need to unlock.',
311
+ '[REQUEST]: Concrete instructions — what to find/do/produce, what format, what to SKIP.',
312
+ '```',
313
+ ].join('\n')
314
+ }
315
+
279
316
  function withRoleContext(block: string, ctx: SessionRoleContext | undefined, kind: SessionOrigin['kind']): string {
280
317
  if (ctx === undefined) return block
281
318
  const roleBlock = kind === 'channel' ? renderChannelRolePolicy() : renderRoleContext(ctx)
@@ -443,6 +480,14 @@ function renderChannelOrigin(
443
480
  'One verdict, one surface. After submitting the review, use',
444
481
  '`skip_response({ reason: "verdict posted as review" })`.',
445
482
  '',
483
+ '**A direct (re-)review request always gets an answer.** If someone asks',
484
+ 'you to review again but your standing verdict already covers the',
485
+ 'current head, do not `skip_response`; silence reads as broken. Reply in',
486
+ 'one line that your earlier verdict on `<short sha>` stands and what would',
487
+ 'change it. Phrase it as past ("I approved ... earlier"), e.g. "I approved',
488
+ '`abc1234` earlier and it is still the head, so that verdict stands. Push',
489
+ 'new commits or point me at something specific to re-check."',
490
+ '',
446
491
  '**Never post your own coordination state.** Write only what a PR',
447
492
  'participant needs. Do not narrate carriers, review rounds, sessions,',
448
493
  'a verdict not yet being registered, or sticky review state.',
@@ -590,16 +635,16 @@ function renderChannelOrigin(
590
635
  ...(origin.adapter === 'github'
591
636
  ? [
592
637
  'tool call, keep working and post the answer with a single final',
593
- '`channel_reply({ text, more_work_this_turn: false })`.',
638
+ '`channel_reply({ text, continue_after_reply: false })`.',
594
639
  'Do not post an "On it" ack comment first — the runtime',
595
640
  'already added an :eyes: reaction; use `channel_react` for explicit ack.',
596
641
  ]
597
642
  : [
598
643
  'tool call, send a one-line ack first via `channel_reply({ text: "On it.",',
599
- 'more_work_this_turn: true })`, keep working, then send the answer with a',
600
- 'final `channel_reply({ text, more_work_this_turn: false })`.',
644
+ 'continue_after_reply: true })`, keep working, then send the answer with a',
645
+ 'final `channel_reply({ text, continue_after_reply: false })`.',
601
646
  'The ack is not your reply; the answer is. Once the answer lands, end your turn.',
602
- '`more_work_this_turn: true` is mandatory on the ack or the turn ends there',
647
+ '`continue_after_reply: true` is mandatory on the ack or the turn ends there',
603
648
  'and drops the fetch/subagent/actual answer.',
604
649
  ]),
605
650
  '',
@@ -614,7 +659,7 @@ function renderChannelOrigin(
614
659
  '',
615
660
  'Do not send a second reply just to rephrase, restate, or "confirm" what you already said.',
616
661
  '',
617
- 'To reply here, call `channel_reply({ text, more_work_this_turn })`. Addressing (including the',
662
+ 'To reply here, call `channel_reply({ text, continue_after_reply })`. Addressing (including the',
618
663
  `thread${origin.thread !== null ? '' : ' — none here, this is a channel-root session'}) is filled in; you don't need`,
619
664
  'to copy these fields:',
620
665
  '',
@@ -627,8 +672,12 @@ function renderChannelOrigin(
627
672
  '}',
628
673
  '```',
629
674
  '',
630
- 'To post somewhere else (different chat, leaving the thread, DM, etc.), use',
631
- '`channel_send` with explicit addressing. `allow` rules still apply (`{ ok: false }`).',
675
+ 'When work belongs to ANOTHER conversation, first use `channel_session_search` to find its owning session,',
676
+ 'then pass that target to `channel_handoff`. Search by conversation name, topic, or participant, across adapters.',
677
+ "The owning session reads its current context and answers through its own account; don't read or post there",
678
+ 'directly from this session. This applies to channels, threads, groups, and DMs regardless of where you started.',
679
+ '`channel_send` is for an explicit direct post, not a substitute for handing ongoing work to its owner.',
680
+ 'If `channel_read` reports an access error with a handoff target, use it rather than asking the user to fix permissions.',
632
681
  '',
633
682
  ...renderResearchReportDeliveryGuidance(platformInfo),
634
683
  ...renderMentionGuidance(platformInfo, origin.participants ?? [], now, origin.self),
@@ -680,13 +729,13 @@ function renderResearchReportDeliveryGuidance(platformInfo: PlatformInfo): strin
680
729
  `**Ship explicit deliverables as PDFs.** ${platformInfo.displayName} accepts file`,
681
730
  'attachments. When the user clearly asks for a PDF/file/export/attachment, a standalone',
682
731
  'document/brief, or when a `researcher` subagent returns `research-<slug>.md` in',
683
- '`<report>`, render the markdown with `typeclaw-render-pdf` and deliver via',
732
+ '`<report>`, design it as a PDF with `typeclaw-render-pdf` and deliver via',
684
733
  '`channel_send({ ..., attachments: [{ path, filename }] })` plus a 1–2 line',
685
734
  'summary. Do not treat the bare word "report" as enough: routine daily stats,',
686
735
  'user trends, status reports, and other operational updates should stay inline',
687
736
  'unless the user asks for a downloadable/exported artifact. A `researcher`',
688
737
  '`<summary>` is a teaser, NOT the deliverable. Never use an ad-hoc library',
689
- '(jsPDF, pdfkit, raw-text dump); it breaks markdown/CJK.',
738
+ '(jsPDF, pdfkit, raw-text dump); it produces unstyled text and breaks CJK.',
690
739
  "For Korean/Japanese/Chinese, follow the skill's CJK guidance and never ship",
691
740
  'tofu boxes. Do not paste the full markdown into chat; do not attach the raw `.md`',
692
741
  'unless explicitly asked; inline text is right for routine updates.',
@@ -0,0 +1,198 @@
1
+ import type { StreamFn } from '@earendil-works/pi-agent-core'
2
+
3
+ import type { LiveSubagentRegistry } from './live-subagents'
4
+
5
+ const TTL_MS = 5 * 60_000
6
+ const INTERVAL_MS = TTL_MS * 0.9
7
+ export const MAX_SUBAGENT_CACHE_PINGS = 6
8
+
9
+ type Request = {
10
+ readonly model: Parameters<StreamFn>[0]
11
+ readonly context: Parameters<StreamFn>[1]
12
+ readonly options: NonNullable<Parameters<StreamFn>[2]>
13
+ readonly payload: Record<string, unknown>
14
+ }
15
+
16
+ function isRecord(value: unknown): value is Record<string, unknown> {
17
+ return typeof value === 'object' && value !== null && !Array.isArray(value)
18
+ }
19
+
20
+ // Inspect the actual cache markers, including hook overrides and env-derived
21
+ // retention. Never turn a no-cache or one-hour request into a five-minute one.
22
+ function hasShortCache(value: unknown): boolean {
23
+ if (Array.isArray(value)) return value.some(hasShortCache)
24
+ if (!isRecord(value)) return false
25
+ if (isRecord(value.cache_control) && value.cache_control.type === 'ephemeral') {
26
+ return value.cache_control.ttl === undefined || value.cache_control.ttl === '5m'
27
+ }
28
+ return Object.values(value).some(hasShortCache)
29
+ }
30
+
31
+ export class SubagentCacheKeepalive {
32
+ private request: Request | undefined
33
+ private refreshedAt = 0
34
+ private idle = false
35
+ private closed = false
36
+ private pings = 0
37
+ private cancelTimer: (() => void) | undefined
38
+ private controller: AbortController | undefined
39
+ private readonly unsubscribe: () => void
40
+
41
+ constructor(
42
+ private readonly sessionId: string,
43
+ private readonly registry: LiveSubagentRegistry,
44
+ private readonly stream: StreamFn,
45
+ private readonly clock = {
46
+ now: () => Date.now(),
47
+ schedule: (callback: () => void, delay: number): (() => void) => {
48
+ const timer = setTimeout(callback, delay)
49
+ timer.unref()
50
+ return () => clearTimeout(timer)
51
+ },
52
+ },
53
+ private readonly log: (line: string) => void = console.debug,
54
+ ) {
55
+ this.unsubscribe = registry.subscribe((parent) => {
56
+ if (parent === sessionId) this.reconcile()
57
+ })
58
+ }
59
+
60
+ capture(model: Request['model'], context: Request['context'], options: Request['options'], payload: unknown): void {
61
+ this.request = undefined
62
+ if (
63
+ this.closed ||
64
+ model.api !== 'anthropic-messages' ||
65
+ options.cacheRetention === 'none' ||
66
+ !isRecord(payload) ||
67
+ !hasShortCache(payload)
68
+ ) {
69
+ return
70
+ }
71
+ // Snapshot after all payload hooks and prompt-cache-key handling. Rebuilding
72
+ // from session state can reorder tools or include new messages/system text.
73
+ this.request = {
74
+ model: structuredClone(model),
75
+ context: structuredClone(context),
76
+ options: { ...options },
77
+ payload: structuredClone(payload),
78
+ }
79
+ this.refreshedAt = this.clock.now()
80
+ }
81
+
82
+ invalidate(): void {
83
+ this.request = undefined
84
+ this.stop()
85
+ }
86
+
87
+ startTurn(): void {
88
+ this.idle = false
89
+ this.pings = 0
90
+ this.stop()
91
+ }
92
+
93
+ settle(): void {
94
+ if (this.closed) return
95
+ this.idle = true
96
+ this.reconcile()
97
+ }
98
+
99
+ close(): void {
100
+ this.closed = true
101
+ this.request = undefined
102
+ this.stop()
103
+ this.unsubscribe()
104
+ }
105
+
106
+ private running(): boolean {
107
+ return this.registry
108
+ .list({ parentSessionId: this.sessionId })
109
+ .some((child) => child.background === true && child.status === 'running')
110
+ }
111
+
112
+ private stop(): void {
113
+ this.cancelTimer?.()
114
+ this.cancelTimer = undefined
115
+ this.controller?.abort()
116
+ this.controller = undefined
117
+ }
118
+
119
+ private reconcile(): void {
120
+ if (this.closed || !this.idle || !this.running()) {
121
+ this.stop()
122
+ return
123
+ }
124
+ if (!this.request || this.pings >= MAX_SUBAGENT_CACHE_PINGS || this.cancelTimer || this.controller) return
125
+ // A late callback or a long real turn must not buy a cold cache write.
126
+ const age = this.clock.now() - this.refreshedAt
127
+ if (age > INTERVAL_MS + (TTL_MS - INTERVAL_MS) / 2) return
128
+ this.cancelTimer = this.clock.schedule(
129
+ () => {
130
+ this.cancelTimer = undefined
131
+ void this.ping()
132
+ },
133
+ Math.max(0, INTERVAL_MS - age),
134
+ )
135
+ }
136
+
137
+ private async ping(): Promise<void> {
138
+ const request = this.request
139
+ if (
140
+ !request ||
141
+ !this.idle ||
142
+ this.closed ||
143
+ !this.running() ||
144
+ this.clock.now() - this.refreshedAt > INTERVAL_MS + (TTL_MS - INTERVAL_MS) / 2
145
+ ) {
146
+ return
147
+ }
148
+ const controller = new AbortController()
149
+ this.controller = controller
150
+ this.pings += 1
151
+ const startedAt = this.clock.now()
152
+ // Legacy thinking requires max_tokens > budget_tokens. Preserve that budget:
153
+ // changing thinking settings invalidates the very cache we want to refresh.
154
+ const thinking = request.payload.thinking
155
+ const maxTokens =
156
+ isRecord(thinking) && thinking.type === 'enabled' && typeof thinking.budget_tokens === 'number'
157
+ ? thinking.budget_tokens + 1
158
+ : 1
159
+ let prefilled = false
160
+ this.log(`[agent] subagent cache keepalive ${this.pings}/${MAX_SUBAGENT_CACHE_PINGS}`)
161
+ try {
162
+ const events = await this.stream(request.model, request.context, {
163
+ ...request.options,
164
+ signal: controller.signal,
165
+ maxTokens,
166
+ maxRetries: 0,
167
+ timeoutMs: 15_000,
168
+ onPayload: () => ({ ...structuredClone(request.payload), max_tokens: maxTokens }),
169
+ onResponse: undefined,
170
+ // message_start follows prefill, unlike the SDK's synthetic start event.
171
+ // Stop here even for legacy thinking, without generating its full budget.
172
+ onProviderStreamEvent: (event) => {
173
+ if (isRecord(event) && event.type === 'message_start') {
174
+ prefilled = true
175
+ controller.abort()
176
+ }
177
+ },
178
+ })
179
+ const result = await events.result()
180
+ if (result.stopReason === 'error') {
181
+ this.log(`[agent] subagent cache keepalive failed: ${result.errorMessage ?? 'provider error'}`)
182
+ }
183
+ } catch (error) {
184
+ this.log(`[agent] subagent cache keepalive failed: ${error instanceof Error ? error.message : String(error)}`)
185
+ } finally {
186
+ // A new turn/completion/close may already have cancelled this ping.
187
+ if (this.controller === controller) {
188
+ this.controller = undefined
189
+ if (prefilled) {
190
+ this.refreshedAt = startedAt
191
+ this.reconcile()
192
+ } else if (this.request === request) {
193
+ this.request = undefined
194
+ }
195
+ }
196
+ }
197
+ }
198
+ }
@@ -0,0 +1,6 @@
1
+ import { SessionManager } from '@earendil-works/pi-coding-agent'
2
+
3
+ /** Plugin-owned privacy choice; model payloads cannot enable or disable persistence. */
4
+ export function createSubagentSessionManager(cwd: string, sessionDir: string, ephemeral = false): SessionManager {
5
+ return ephemeral ? SessionManager.inMemory(cwd) : SessionManager.create(cwd, sessionDir)
6
+ }
@@ -1,7 +1,8 @@
1
1
  import type { ToolDefinition } from '@earendil-works/pi-coding-agent'
2
2
  import type { z } from 'zod'
3
3
 
4
- import { getConfig, resolveModel } from '@/config'
4
+ import { getConfig, resolveModel, type ThinkingLevel } from '@/config'
5
+ import { effectiveModels } from '@/config/model-overrides'
5
6
  import type { PermissionService } from '@/permissions'
6
7
  import type { HookBus } from '@/plugin'
7
8
  import type { Stream, Unsubscribe } from '@/stream'
@@ -32,7 +33,13 @@ export type SubagentContext<P = unknown> = {
32
33
  payload: P
33
34
  }
34
35
 
35
- export type RunSession = (override?: { userPrompt?: string }) => Promise<void>
36
+ // onFinalMessage receives the terminal assistant message's text after the
37
+ // completed run (or null for an empty terminal message/provider failure).
38
+ // Unlike orchestration output, it never projects <review>/<report> blocks.
39
+ export type RunSession = (override?: {
40
+ userPrompt?: string
41
+ onFinalMessage?: (message: string | null) => void
42
+ }) => Promise<void>
36
43
 
37
44
  // Fields shared verbatim between the plugin-author-facing `Subagent` in
38
45
  // `@/plugin/types` and the runtime-internal `Subagent` below. Every consumer
@@ -58,6 +65,11 @@ export type SubagentShared<P = unknown> = {
58
65
  // session construction. Unknown profile names fall back to `default` with
59
66
  // a warning. See `Subagent` in `@/plugin/types` for the full contract.
60
67
  profile?: string
68
+ // Thinking level for this subagent's session, overriding the profile's own
69
+ // level. Applies only when `profile` is configured: when it falls back to
70
+ // `default`, the session keeps `default`'s level, so e.g. `deep` + `low` means
71
+ // "the deep model at low effort if one exists, else the plain default".
72
+ thinkingLevel?: ThinkingLevel
61
73
  payloadSchema?: z.ZodType<P>
62
74
  handler?: (ctx: SubagentContext<P>, runSession: RunSession) => Promise<void>
63
75
  toolResultBudget?: ToolResultBudget
@@ -216,6 +228,7 @@ export const defaultCreateSessionForSubagent: CreateSessionForSubagent = (subage
216
228
  ...(resolveSubagentProfile(subagent, options) !== undefined
217
229
  ? { profile: resolveSubagentProfile(subagent, options) }
218
230
  : {}),
231
+ ...(subagent.thinkingLevel !== undefined ? { thinkingLevel: subagent.thinkingLevel } : {}),
219
232
  ...(subagent.toolResultBudget !== undefined ? { toolResultBudget: subagent.toolResultBudget } : {}),
220
233
  ...(subagent.bashPolicy !== undefined ? { bashPolicy: subagent.bashPolicy } : {}),
221
234
  })
@@ -303,7 +316,10 @@ export async function invokeSubagent(name: string, options: InvokeSubagentOption
303
316
  const { session, dispose, hooks, sessionId, agentDir, origin, getTranscriptPath, backgroundDrain } =
304
317
  normalizeSubagentSession(await createSessionForSubagent(subagent, sessionOptions))
305
318
  let aborted = false
306
- let activeModelRef = resolveFallbackChain(getConfig().models, resolveSubagentProfile(subagent, sessionOptions))[0]!
319
+ let activeModelRef = resolveFallbackChain(
320
+ effectiveModels(getConfig(), sessionOptions.spawnedByOrigin),
321
+ resolveSubagentProfile(subagent, sessionOptions),
322
+ )[0]!
307
323
  // Latency tolerance is decided ONCE here, from the REQUESTED profile — not the
308
324
  // one resolveProfile() landed on. A `deep` subagent whose operator never
309
325
  // configured `models.deep` still runs on a background path nobody is watching
@@ -374,7 +390,10 @@ export async function invokeSubagent(name: string, options: InvokeSubagentOption
374
390
  allowEscalation: false,
375
391
  })
376
392
  const result = await promptPersistentTurnWithFallback({
377
- refs: resolveFallbackChain(getConfig().models, resolveSubagentProfile(subagent, sessionOptions)),
393
+ refs: resolveFallbackChain(
394
+ effectiveModels(getConfig(), sessionOptions.spawnedByOrigin),
395
+ resolveSubagentProfile(subagent, sessionOptions),
396
+ ),
378
397
  currentModelRef: activeModelRef,
379
398
  profile: resolveSubagentProfile(subagent, sessionOptions),
380
399
  retryPolicy,
@@ -480,6 +499,7 @@ export async function invokeSubagent(name: string, options: InvokeSubagentOption
480
499
  ...(origin !== undefined ? { origin } : {}),
481
500
  })
482
501
  }
502
+ override?.onFinalMessage?.(latestTurnFailure === undefined ? capture.getTerminalAssistantText() : null)
483
503
  } finally {
484
504
  unsubProviderErrors?.()
485
505
  if (hooks && sessionId !== undefined) {
@@ -674,7 +694,7 @@ function raceSubagentCompletion(
674
694
  // The tags a subagent can use to wrap its structured result: the reviewer's
675
695
  // `<review>`, the researcher's `<report>`. Fixed literals — never user input —
676
696
  // so the per-tag patterns below are injection-safe.
677
- type FinalBlockTag = 'review' | 'report'
697
+ type FinalBlockTag = 'review' | 'report' | 'qa'
678
698
 
679
699
  // A complete <TAG>...</TAG> block. The block IS the result: same-message
680
700
  // preamble/trailing chatter or a later summary turn must not become the captured
@@ -685,6 +705,7 @@ type FinalBlockTag = 'review' | 'report'
685
705
  const FINAL_BLOCK_RE: Readonly<Record<FinalBlockTag, RegExp>> = {
686
706
  review: /<review>[\s\S]*?<\/review>/g,
687
707
  report: /<report>[\s\S]*?<\/report>/g,
708
+ qa: /<qa>[\s\S]*?<\/qa>/g,
688
709
  }
689
710
 
690
711
  function lastTaggedBlock(text: string, tag: FinalBlockTag): string | null {
@@ -711,7 +732,11 @@ function lastTaggedBlock(text: string, tag: FinalBlockTag): string | null {
711
732
  // only catches children that declare none.
712
733
  const DRAIN_MAX_CHILD_WAIT_MS = 600_000
713
734
 
714
- const REQUIRED_FINAL_BLOCK: Readonly<Record<string, FinalBlockTag>> = { researcher: 'report', reviewer: 'review' }
735
+ const REQUIRED_FINAL_BLOCK: Readonly<Record<string, FinalBlockTag>> = {
736
+ researcher: 'report',
737
+ reviewer: 'review',
738
+ qa: 'qa',
739
+ }
715
740
 
716
741
  // Bounded re-prompt budget for the required-block guard, mirroring the channel
717
742
  // empty-response guard's MAX_EMPTY_TURN_RETRIES. A subagent that owes a result
@@ -725,9 +750,11 @@ const MAX_REQUIRED_BLOCK_RETRIES = 2
725
750
  // The tail is tag-specific: each block has different mandatory child fields.
726
751
  function renderRequiredBlockRetryNudge(tag: FinalBlockTag): string {
727
752
  const tail =
728
- tag === 'report'
729
- ? 'in particular do NOT call write_report. Do NOT continue researching or spawn more subagents.\n\nIf the report file was not successfully written, still emit the block: set <report_file>none</report_file>, <confidence>low</confidence> (explain the report artifact was not completed), and note in <open_questions> that the run should be retried.'
730
- : `Do NOT re-run gh, diff reads, or spawn more subagents.\n\nEmit the block from the analysis you have already done: include your <summary>, whatever <finding> items you can support with evidence, and a <verdict> (approve | request-changes | comment). Only use a real verdict if you actually reached one. If you could NOT analyze enough to decide, do NOT invent a verdict — set <verdict>${INCOMPLETE_REVIEW_VERDICT}</verdict> exactly (this signals an incomplete review; the parent will not treat it as approve/request-changes/comment, even on a re-review).`
753
+ tag === 'qa'
754
+ ? `Do NOT run more commands or start more processes.\n\nEmit the block from the scenarios you have already executed: <summary>, <target>, every <scenario> with the verdict you actually observed (mark unexecuted ones not-run), <findings>, <coverage_gaps>, and a <verdict>. If required scenarios never ran, the verdict is inconclusive, never pass.`
755
+ : tag === 'report'
756
+ ? 'in particular do NOT call write_report. Do NOT continue researching or spawn more subagents.\n\nIf the report file was not successfully written, still emit the block: set <report_file>none</report_file>, <confidence>low</confidence> (explain the report artifact was not completed), and note in <open_questions> that the run should be retried.'
757
+ : `Do NOT re-run gh, diff reads, or spawn more subagents.\n\nEmit the block from the analysis you have already done: include your <summary>, whatever <finding> items you can support with evidence, and a <verdict> (approve | request-changes | comment). Only use a real verdict if you actually reached one. If you could NOT analyze enough to decide, do NOT invent a verdict — set <verdict>${INCOMPLETE_REVIEW_VERDICT}</verdict> exactly (this signals an incomplete review; the parent will not treat it as approve/request-changes/comment, even on a re-review).`
731
758
  return `---
732
759
  **[SYSTEM MESSAGE — not from a human]**
733
760
 
@@ -793,6 +820,24 @@ ${headline}. The ${name} subagent could not complete a review in this run: ${cau
793
820
  </findings>
794
821
  <verdict>${INCOMPLETE_REVIEW_VERDICT}</verdict>
795
822
  </review>`
823
+ }
824
+ if (tag === 'qa') {
825
+ return `<qa>
826
+ <summary>
827
+ The ${name} subagent could not complete a QA run: ${cause}. No scenario results are reliable — do not treat any earlier text as a pass. Rerun QA${providerFailed ? ' once the provider recovers' : ''}.
828
+ </summary>
829
+ <target>
830
+ unknown
831
+ </target>
832
+ <scenarios>
833
+ </scenarios>
834
+ <findings>
835
+ </findings>
836
+ <coverage_gaps>
837
+ The entire QA request remains untested.
838
+ </coverage_gaps>
839
+ <verdict>inconclusive</verdict>
840
+ </qa>`
796
841
  }
797
842
  return `<${tag}>\nThe ${name} subagent could not produce the required <${tag}> block (${cause}) and could not recover; rerun it or inspect the transcript.\n</${tag}>`
798
843
  }
@@ -801,6 +846,8 @@ type SubagentCapture = {
801
846
  // True once a required-block subagent (researcher) has emitted its `<report>`
802
847
  // block; always false for subagents without a required block.
803
848
  hasRequiredBlock: () => boolean
849
+ // Raw terminal assistant text, independent of the orchestrator's block projection.
850
+ getTerminalAssistantText: () => string | null
804
851
  // Install a captured final message directly — used by the required-block guard
805
852
  // to set an honest fallback when the block was never emitted, so the parent
806
853
  // gets a structured result rather than stale preamble.
@@ -812,6 +859,7 @@ function attachFinalMessageCapture(
812
859
  requiredBlockTag: FinalBlockTag | undefined,
813
860
  onFinalMessage: (msg: string) => void,
814
861
  ): SubagentCapture {
862
+ let terminalAssistantText: string | null = null
815
863
  let lastAssistant: string | null = null
816
864
  let lastReview: string | null = null
817
865
  let lastRequired: string | null = null
@@ -824,6 +872,7 @@ function attachFinalMessageCapture(
824
872
  const role = ev.message?.role
825
873
  if (role !== undefined && role !== 'assistant') return
826
874
  const text = extractFinalMessageText(ev.message?.content)
875
+ terminalAssistantText = text
827
876
  if (text === null) return
828
877
  lastAssistant = text
829
878
 
@@ -851,6 +900,7 @@ function attachFinalMessageCapture(
851
900
  // doubles that don't implement it.
852
901
  }
853
902
  return {
903
+ getTerminalAssistantText: () => terminalAssistantText,
854
904
  hasRequiredBlock: () => lastRequired !== null,
855
905
  setSyntheticFinalMessage: (msg) => {
856
906
  lastRequired = msg