typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -1,7 +1,13 @@
1
1
  import { Type } from '@earendil-works/pi-ai'
2
2
  import { defineTool } from '@earendil-works/pi-coding-agent'
3
3
 
4
- import { recordReview, recordReviewOutput, type ReviewVerdict } from '@/channels/github-review-turn-ledger'
4
+ import { githubReviewChecks } from '@/channels/github-review-check'
5
+ import {
6
+ recordReview,
7
+ recordReviewOutput,
8
+ type ReviewResultCoverage,
9
+ type ReviewVerdict,
10
+ } from '@/channels/github-review-turn-ledger'
5
11
  import { createSharedReviewVerdictGuard, type ReviewVerdictGuard } from '@/channels/github-review-verdict-coordinator'
6
12
  import type { ChannelRouter } from '@/channels/router'
7
13
  import type { ReviewFinding, SubmitReviewRequest } from '@/channels/types'
@@ -53,6 +59,13 @@ export function createPostGithubReviewTool(options: {
53
59
  { minItems: 1 },
54
60
  ),
55
61
  ),
62
+ head_sha: Type.Optional(
63
+ Type.String({
64
+ pattern: '^[0-9a-fA-F]{40}$',
65
+ description:
66
+ 'Full SHA of the commit your review covers. When set, the review is only posted if the PR head is still this commit.',
67
+ }),
68
+ ),
56
69
  }),
57
70
  async execute(toolCallId, params) {
58
71
  if (origin.adapter !== 'github') return denied(logger, 'post_github_review is only supported on github sessions.')
@@ -68,6 +81,7 @@ export function createPostGithubReviewTool(options: {
68
81
  verdict,
69
82
  ...(origin.githubReviewRound !== undefined ? { round: origin.githubReviewRound } : {}),
70
83
  thread: origin.thread,
84
+ ...(params.head_sha !== undefined ? { reviewedHeadSha: params.head_sha } : {}),
71
85
  retainDuplicateLease: params.event === 'REQUEST_CHANGES',
72
86
  })
73
87
  if (blocked !== null) {
@@ -86,6 +100,7 @@ export function createPostGithubReviewTool(options: {
86
100
  body: params.body,
87
101
  comments: (params.comments ?? []).map(toReviewFinding),
88
102
  logger,
103
+ ...(params.head_sha !== undefined ? { reviewedHeadSha: params.head_sha } : {}),
89
104
  })
90
105
  fallbackLanded = fallback.landed
91
106
  return fallback.result
@@ -112,10 +127,18 @@ export function createPostGithubReviewTool(options: {
112
127
  event: params.event,
113
128
  body: params.body,
114
129
  comments: (params.comments ?? []).map(toReviewFinding),
130
+ ...(params.head_sha !== undefined ? { expectedHeadSha: params.head_sha } : {}),
115
131
  }
116
132
  let releaseAsLanded = false
117
133
  try {
118
- const result = await router.submitReview(request)
134
+ const coverage = await captureCoverage(router, sessionId)
135
+ const result = await router.submitReview({
136
+ ...request,
137
+ sourceSessionId: sessionId,
138
+ ...(coverage.expectedAccountIdentity !== undefined
139
+ ? { expectedAccountIdentity: coverage.expectedAccountIdentity }
140
+ : {}),
141
+ })
119
142
  if (!result.ok) {
120
143
  // A POST whose verification failed may already have landed. Keep the
121
144
  // short conservative shield, but never credit an unverified ledger.
@@ -127,7 +150,14 @@ export function createPostGithubReviewTool(options: {
127
150
  if (effective === null)
128
151
  return denied(logger, `GitHub returned an unknown verified review state: ${result.state}`)
129
152
  releaseAsLanded = verdict !== null && effective === verdict
130
- creditVerifiedReview({ sessionId, workspace: origin.workspace, prNumber, effective })
153
+ await creditVerifiedReview({
154
+ sessionId,
155
+ workspace: origin.workspace,
156
+ prNumber,
157
+ effective,
158
+ ...coverage,
159
+ ...(result.commitSha !== undefined ? { commitSha: result.commitSha } : {}),
160
+ })
131
161
 
132
162
  const receipt = renderReceipt(
133
163
  result.reviewId,
@@ -163,7 +193,9 @@ async function postDuplicateRequestChangesComment(args: {
163
193
  body: string
164
194
  comments: readonly ReviewFinding[]
165
195
  logger: ChannelToolLogger
196
+ reviewedHeadSha?: string
166
197
  }) {
198
+ const coverage = await captureCoverage(args.router, args.sessionId)
167
199
  const result = await args.router.send(
168
200
  {
169
201
  adapter: 'github',
@@ -172,16 +204,30 @@ async function postDuplicateRequestChangesComment(args: {
172
204
  thread: null,
173
205
  text: renderFallbackComment(args.body, args.comments),
174
206
  },
175
- { accountingTarget: args.origin },
207
+ {
208
+ accountingTarget: args.origin,
209
+ ...(coverage.expectedAccountIdentity !== undefined
210
+ ? { expectedAccountIdentity: coverage.expectedAccountIdentity }
211
+ : {}),
212
+ },
176
213
  )
177
214
  if (!result.ok) return { landed: false, result: denied(args.logger, result.error, result.code) }
178
215
 
179
- recordReviewOutput({
216
+ await recordReviewOutput({
180
217
  sessionId: args.sessionId,
181
218
  workspace: args.origin.workspace,
182
219
  prNumber: args.prNumber,
183
220
  state: 'COMMENT',
221
+ ...coverage,
184
222
  })
223
+ // The comment republishes a verdict GitHub already holds as a standing
224
+ // CHANGES_REQUESTED, so the review check completes with that verdict.
225
+ void (args.reviewedHeadSha !== undefined
226
+ ? githubReviewChecks.reviewPosted(
227
+ { repo: args.origin.workspace, pullRequest: args.prNumber, headSha: args.reviewedHeadSha },
228
+ 'CHANGES_REQUESTED',
229
+ )
230
+ : githubReviewChecks.completePostingReviews(args.origin.workspace, args.prNumber, 'CHANGES_REQUESTED'))
185
231
 
186
232
  const details: PostGithubReviewDetails = {
187
233
  ok: true,
@@ -249,31 +295,47 @@ function effectiveReviewState(state: string): ReviewVerdict | 'COMMENT' | null {
249
295
  return null
250
296
  }
251
297
 
252
- function creditVerifiedReview(args: {
253
- sessionId: string
254
- workspace: string
255
- prNumber: number
256
- effective: ReviewVerdict | 'COMMENT'
257
- }): void {
298
+ async function creditVerifiedReview(
299
+ args: {
300
+ sessionId: string
301
+ workspace: string
302
+ prNumber: number
303
+ effective: ReviewVerdict | 'COMMENT'
304
+ commitSha?: string
305
+ } & ReviewResultCoverage,
306
+ ): Promise<void> {
258
307
  if (args.effective === 'COMMENT') {
259
- recordReviewOutput({
308
+ await recordReviewOutput({
260
309
  sessionId: args.sessionId,
261
310
  workspace: args.workspace,
262
311
  prNumber: args.prNumber,
263
312
  state: 'COMMENT',
313
+ ...(args.inboundCoverage !== undefined ? { inboundCoverage: args.inboundCoverage } : {}),
314
+ ...(args.backgroundCoverage !== undefined ? { backgroundCoverage: args.backgroundCoverage } : {}),
264
315
  })
265
316
  return
266
317
  }
267
- // recordReview also emits the review-output observer signal for decisive
268
- // states, keeping verdict and output credit atomic.
269
- recordReview({
318
+ // recordReview retains the verdict before awaiting the output owner's settlement.
319
+ await recordReview({
270
320
  sessionId: args.sessionId,
271
321
  workspace: args.workspace,
272
322
  prNumber: args.prNumber,
273
323
  verdict: args.effective,
324
+ ...(args.inboundCoverage !== undefined ? { inboundCoverage: args.inboundCoverage } : {}),
325
+ ...(args.backgroundCoverage !== undefined ? { backgroundCoverage: args.backgroundCoverage } : {}),
326
+ ...(args.commitSha !== undefined ? { commitSha: args.commitSha } : {}),
274
327
  })
275
328
  }
276
329
 
330
+ async function captureCoverage(router: ChannelRouter, sessionId: string): Promise<ReviewResultCoverage> {
331
+ const expectedAccountIdentity = await router.captureTurnAccountIdentity?.(sessionId, 'github')
332
+ return {
333
+ inboundCoverage: (await router.captureInboundResultCoverage?.(sessionId)) ?? [],
334
+ backgroundCoverage: (await router.captureBackgroundResultCoverage?.(sessionId)) ?? [],
335
+ ...(expectedAccountIdentity !== undefined ? { expectedAccountIdentity } : {}),
336
+ }
337
+ }
338
+
277
339
  function denied(logger: ChannelToolLogger, error: string, code?: string) {
278
340
  logger.warn(formatChannelToolFailure('post_github_review', error))
279
341
  const details: PostGithubReviewDetails = { ok: false, error, ...(code !== undefined ? { code } : {}) }
@@ -6,7 +6,7 @@ import type { ChannelRouter } from '@/channels/router'
6
6
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
7
7
 
8
8
  export type CreateSkipResponseToolOptions = {
9
- router: ChannelRouter
9
+ router: Pick<ChannelRouter, 'markTurnSkipped'>
10
10
  // The channel session's id, used to locate the right LiveSession in the
11
11
  // router and stamp the skip flag with its current turnSeq. Mirrors how
12
12
  // `injectSubagentCompletionReminder` addresses live sessions by their
@@ -89,7 +89,7 @@ export function createSkipResponseTool({
89
89
  }
90
90
  }
91
91
 
92
- const result = router.markTurnSkipped({ parentSessionId: sessionId, reason })
92
+ const result = await router.markTurnSkipped({ parentSessionId: sessionId, reason })
93
93
  if (result.kind === 'recorded-after-send') {
94
94
  // Reply-first skip: an ack already landed; this just ends the turn
95
95
  // quietly. Not suppressed (the reply stands) and not an error (erroring
@@ -4,10 +4,13 @@ import { Type } from '@earendil-works/pi-ai'
4
4
  import { defineTool } from '@earendil-works/pi-coding-agent'
5
5
 
6
6
  import { githubReviewerWorkKey } from '@/channels/github-repo'
7
+ import { githubReviewChecks, type ReviewerSettlement } from '@/channels/github-review-check'
8
+ import type { ChannelRouter } from '@/channels/router'
7
9
  import type { PermissionService } from '@/permissions'
8
10
  import type { Stream } from '@/stream'
9
11
 
10
12
  import { type LiveSubagentRegistry, type SubagentCompletion } from '../live-subagents'
13
+ import { attachReviewerActivityCapture } from '../reviewer-activity'
11
14
  import { MAX_SUBAGENT_DEPTH, type SessionOrigin, subagentDepth } from '../session-origin'
12
15
  import {
13
16
  type CreateSessionForSubagent,
@@ -53,6 +56,12 @@ export type CreateSpawnSubagentToolOptions = {
53
56
  agentDir: string
54
57
  parentSessionId: string
55
58
  getOrigin: () => SessionOrigin | undefined
59
+ getSessionFile?: () => string | undefined
60
+ router?: Pick<ChannelRouter, 'acceptBackgroundResponse' | 'suppressUnstartedBackgroundResponse'>
61
+ getAccountIdentity?: (
62
+ adapter: NonNullable<Extract<SessionOrigin, { kind: 'channel' }>['adapter']>,
63
+ workspace?: string,
64
+ ) => Promise<string | undefined>
56
65
  permissions?: PermissionService
57
66
  stream?: Stream
58
67
  generateTaskId?: () => string
@@ -138,7 +147,7 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
138
147
  ),
139
148
  }),
140
149
 
141
- async execute(_toolCallId, params): Promise<ToolReturn> {
150
+ async execute(_toolCallId, params, signal): Promise<ToolReturn> {
142
151
  const origin = getOrigin()
143
152
  const subagent = lookupPublicSubagent(registry, params.subagent_type)
144
153
  if (subagent === null) {
@@ -159,7 +168,7 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
159
168
  origin.thread !== origin.githubReviewRound.carrierThread
160
169
  ) {
161
170
  return errorResult(
162
- "reviewer spawn denied: another session of this PR is the designated carrier for this review round and will post the review; close out only this session's thread.",
171
+ "reviewer spawn denied: another session of this PR is the designated carrier for this review round and will post the review. Do not reply now: call `skip_response`. Once the verdict lands, close out only this session's thread with the technical outcome; never mention sessions, carriers, or review rounds on the PR.",
163
172
  )
164
173
  }
165
174
  // Fail closed past the chain-length ceiling. The tool is present on
@@ -173,17 +182,6 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
173
182
  )
174
183
  }
175
184
  const subagentName = params.subagent_type
176
- const { background, overrideNote } = resolveSpawnMode({
177
- foreground: params.run_in_foreground,
178
- fromSubagent: origin?.kind === 'subagent',
179
- // Deep-profile spawns run for minutes; forcing them background from a
180
- // top-level session keeps a foreground run from freezing the message
181
- // loop. Per-spawn override wins over the declared profile.
182
- isDeepProfile: (params.profile ?? subagent.profile) === 'deep',
183
- canBackgroundFromSubagent: allowBackgroundFromSubagent === true,
184
- subagentName,
185
- })
186
-
187
185
  const taskId = generateTaskId()
188
186
  const payload: Record<string, unknown> = { requestId: taskId, prompt: params.prompt }
189
187
  if (params.description !== undefined) payload.description = params.description
@@ -204,6 +202,17 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
204
202
  params.review_identity === undefined
205
203
  ? undefined
206
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
+ })
207
216
 
208
217
  const coalesceKey = subagentCoalesceKey({
209
218
  parentSessionId,
@@ -227,6 +236,70 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
227
236
  const startedAt = now()
228
237
  const spawnedByRole = permissions?.resolveRole(origin)
229
238
  let capturedFinalMessage: string | undefined
239
+ const channelKey =
240
+ origin?.kind === 'channel'
241
+ ? { adapter: origin.adapter, workspace: origin.workspace, chat: origin.chat, thread: origin.thread }
242
+ : undefined
243
+ let backgroundResponse: { obligationId: string; generation: number } | undefined
244
+ if (background && origin?.kind === 'channel') {
245
+ if (options.router === undefined) {
246
+ if (pendingWorkKeyRegistration !== undefined) {
247
+ liveRegistry.abandonWorkKeyRegistration(pendingWorkKeyRegistration)
248
+ }
249
+ releaseCoalesceKey()
250
+ return errorResult('failed to persist background response: channel router unavailable')
251
+ }
252
+ try {
253
+ const { parentChat, lastInboundAuthorId } = origin
254
+ let parentSessionFile: string | undefined
255
+ try {
256
+ parentSessionFile = options.getSessionFile?.()
257
+ } catch {
258
+ // Recovery notices do not need the parent transcript to launch work.
259
+ }
260
+ let accountIdentity: string | undefined
261
+ try {
262
+ accountIdentity = await options.getAccountIdentity?.(origin.adapter, origin.workspace)
263
+ } catch {
264
+ // Recovery identity must not add a prerequisite to healthy launches.
265
+ }
266
+ backgroundResponse = await options.router.acceptBackgroundResponse({
267
+ parentSessionId,
268
+ parentSessionFile,
269
+ key: channelKey!,
270
+ taskId,
271
+ subagentName,
272
+ startedAt,
273
+ accountIdentity: accountIdentity ?? 'unbound-legacy',
274
+ ...(parentChat !== undefined ? { parentChat } : {}),
275
+ ...(lastInboundAuthorId !== undefined ? { triggeringAuthorId: lastInboundAuthorId } : {}),
276
+ })
277
+ } catch (error) {
278
+ if (pendingWorkKeyRegistration !== undefined) {
279
+ liveRegistry.abandonWorkKeyRegistration(pendingWorkKeyRegistration)
280
+ }
281
+ releaseCoalesceKey()
282
+ return errorResult(
283
+ `failed to persist background response: ${error instanceof Error ? error.message : String(error)}`,
284
+ )
285
+ }
286
+ // An aborted parent must not launch work after the durability await.
287
+ if (signal?.aborted) {
288
+ try {
289
+ await options.router.suppressUnstartedBackgroundResponse(
290
+ backgroundResponse,
291
+ 'background launch cancelled before execution',
292
+ )
293
+ } finally {
294
+ if (pendingWorkKeyRegistration !== undefined) {
295
+ liveRegistry.abandonWorkKeyRegistration(pendingWorkKeyRegistration)
296
+ }
297
+ releaseCoalesceKey()
298
+ }
299
+ return errorResult('background launch cancelled before execution')
300
+ }
301
+ }
302
+ let detachReviewerActivity: (() => void) | undefined
230
303
  const { handle, completion } = startSubagent(subagentName, {
231
304
  registry,
232
305
  createSessionForSubagent,
@@ -241,6 +314,15 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
241
314
  capturedFinalMessage = message
242
315
  liveRegistry.recordCapturedFinalMessageIfRunning(taskId, message)
243
316
  },
317
+ ...(params.review_identity !== undefined
318
+ ? {
319
+ onSession: ({ session }) => {
320
+ detachReviewerActivity = attachReviewerActivityCapture(session, (activity) =>
321
+ githubReviewChecks.reportActivity(taskId, activity),
322
+ )
323
+ },
324
+ }
325
+ : {}),
244
326
  })
245
327
 
246
328
  let resolvedHandle: { taskId: string; sessionId: string | undefined; abort: () => Promise<void> } | undefined
@@ -255,6 +337,8 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
255
337
  return errorResult(`failed to spawn ${subagentName}: ${message}`)
256
338
  }
257
339
 
340
+ // The latest abort attempt, resolving to whether the abort was accepted.
341
+ let abortAttempt: Promise<boolean> | undefined
258
342
  const live = {
259
343
  taskId,
260
344
  sessionId: resolvedHandle.sessionId ?? '<pending>',
@@ -268,13 +352,42 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
268
352
  ...(workKey !== undefined ? { workKey } : {}),
269
353
  startedAt,
270
354
  status: 'running' as const,
271
- abort: resolvedHandle.abort,
355
+ // Every cancel path (subagent_cancel, draft/work-key cancellation) goes
356
+ // through this handle, which is how the review check tells an accepted
357
+ // cancellation apart from a reviewer failure. An accepted abort settles
358
+ // the check at once: the reviewer's completion may stay wedged after it.
359
+ abort: async () => {
360
+ const attempt = resolvedHandle.abort()
361
+ abortAttempt = attempt.then(
362
+ () => true,
363
+ () => false,
364
+ )
365
+ await attempt
366
+ void githubReviewChecks.reviewerSettled(taskId, REVIEW_CANCELLED)
367
+ },
272
368
  releaseCoalesceKey,
273
369
  }
274
- const registered =
275
- pendingWorkKeyRegistration === undefined
276
- ? (liveRegistry.register(live), true)
277
- : liveRegistry.registerIfWorkKeyActive(live, pendingWorkKeyRegistration)
370
+ let registered: boolean
371
+ try {
372
+ registered =
373
+ pendingWorkKeyRegistration === undefined
374
+ ? (liveRegistry.register(live), true)
375
+ : liveRegistry.registerIfWorkKeyActive(live, pendingWorkKeyRegistration)
376
+ } catch (error) {
377
+ if (pendingWorkKeyRegistration !== undefined) {
378
+ liveRegistry.abandonWorkKeyRegistration(pendingWorkKeyRegistration)
379
+ }
380
+ try {
381
+ await resolvedHandle.abort()
382
+ } catch {
383
+ // Execution may already have started. Its response remains owed.
384
+ }
385
+ void completion.then(releaseCoalesceKey)
386
+ releaseCoalesceKey()
387
+ return errorResult(
388
+ `failed to register ${subagentName}: ${error instanceof Error ? error.message : String(error)}`,
389
+ )
390
+ }
278
391
  let delayedCancellationError: string | undefined
279
392
  if (!registered) {
280
393
  void completion.then(releaseCoalesceKey)
@@ -284,7 +397,14 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
284
397
  const message = err instanceof Error ? err.message : String(err)
285
398
  // The child is still live. Register it so later cancellation, status
286
399
  // inspection, and completion settlement can still reach it.
287
- liveRegistry.register(live)
400
+ try {
401
+ liveRegistry.register(live)
402
+ } catch (registrationError) {
403
+ releaseCoalesceKey()
404
+ return errorResult(
405
+ `failed to register ${subagentName} after cancellation failed: ${registrationError instanceof Error ? registrationError.message : String(registrationError)}`,
406
+ )
407
+ }
288
408
  delayedCancellationError = `reviewer cancellation failed before registration: ${message}`
289
409
  }
290
410
  if (delayedCancellationError === undefined) {
@@ -296,12 +416,17 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
296
416
  liveRegistry.recordCapturedFinalMessageIfRunning(taskId, capturedFinalMessage)
297
417
  }
298
418
 
299
- const channelKey =
300
- origin?.kind === 'channel'
301
- ? { adapter: origin.adapter, workspace: origin.workspace, chat: origin.chat, thread: origin.thread }
302
- : undefined
419
+ const reviewIdentity = delayedCancellationError === undefined ? params.review_identity : undefined
420
+ if (reviewIdentity !== undefined) {
421
+ void githubReviewChecks.beginReview(
422
+ { repo: reviewIdentity.repo, pullRequest: reviewIdentity.pull_request, headSha: reviewIdentity.head_sha },
423
+ taskId,
424
+ { reviewKind: reviewIdentity.review_kind },
425
+ )
426
+ }
303
427
 
304
428
  void completion.then((c) => {
429
+ detachReviewerActivity?.()
305
430
  releaseCoalesceKey()
306
431
  const durationMs = now() - startedAt
307
432
  // First-writer-wins: if the parent drain already settled this child by
@@ -309,6 +434,17 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
309
434
  // broadcast so exactly one canonical completed-event is emitted (the
310
435
  // winner's).
311
436
  const won = liveRegistry.recordCompletionIfRunning(taskId, completionToFinalShape(c, durationMs))
437
+ if (reviewIdentity !== undefined) {
438
+ // Classify only once an in-flight abort's result is known: aborting
439
+ // can resolve the completion before the abort itself settles.
440
+ void (async () => {
441
+ const cancelAccepted = abortAttempt !== undefined && (await abortAttempt)
442
+ await githubReviewChecks.reviewerSettled(
443
+ taskId,
444
+ reviewerSettlement(c, won, cancelAccepted, liveRegistry, taskId),
445
+ )
446
+ })()
447
+ }
312
448
  if (!won || !stream || !background) return
313
449
  const hasRecoverableOutput = !c.ok && c.finalMessage !== undefined
314
450
  stream.publish({
@@ -490,6 +626,21 @@ function completionToFinalShape(
490
626
  }
491
627
  }
492
628
 
629
+ const REVIEW_CANCELLED: ReviewerSettlement = { kind: 'cancelled', reason: 'the review was cancelled' }
630
+
631
+ function reviewerSettlement(
632
+ c: { ok: true } | { ok: false; error: string },
633
+ won: boolean,
634
+ cancelAccepted: boolean,
635
+ liveRegistry: LiveSubagentRegistry,
636
+ taskId: string,
637
+ ): ReviewerSettlement {
638
+ if (cancelAccepted) return REVIEW_CANCELLED
639
+ const recordedError = liveRegistry.get(taskId)?.completion?.error
640
+ if (won && c.ok) return { kind: 'ok' }
641
+ return { kind: 'failed', reason: c.ok ? 'the reviewer did not finish in time' : (recordedError ?? c.error) }
642
+ }
643
+
493
644
  type ToolReturn = {
494
645
  content: { type: 'text'; text: string }[]
495
646
  details: SpawnSubagentToolDetails
@@ -508,6 +659,22 @@ export type SpawnModeResolution = {
508
659
  overrideNote: string | undefined
509
660
  }
510
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
+
511
678
  // Resolve foreground vs background for a spawn, with the runtime free to
512
679
  // override the caller's request and report why. Two axes decide it: whether the
513
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
 
@@ -1,6 +1,7 @@
1
1
  import { Type } from '@earendil-works/pi-ai'
2
2
  import { defineTool } from '@earendil-works/pi-coding-agent'
3
3
 
4
+ import type { ChannelRouter } from '@/channels/router'
4
5
  import type { PermissionService } from '@/permissions'
5
6
 
6
7
  import type { LiveSubagentRegistry, StatusSnapshot, SubagentProgressEvent } from '../live-subagents'
@@ -49,6 +50,7 @@ export type CreateSubagentOutputToolOptions = {
49
50
  getOrigin: () => SessionOrigin | undefined
50
51
  permissions?: PermissionService
51
52
  callerSessionId?: string
53
+ router?: Pick<ChannelRouter, 'attachBackgroundResultCoverage'>
52
54
  now?: () => number
53
55
  }
54
56
 
@@ -91,6 +93,12 @@ export function createSubagentOutputTool(options: CreateSubagentOutputToolOption
91
93
  if (snap === undefined) {
92
94
  return errorResult(`Unknown task_id: ${params.task_id}.`)
93
95
  }
96
+ if (snap.status !== 'running' && callerSessionId !== undefined) {
97
+ await options.router?.attachBackgroundResultCoverage({
98
+ parentSessionId: callerSessionId,
99
+ taskId: snap.taskId,
100
+ })
101
+ }
94
102
  return renderSnapshot(snap)
95
103
  },
96
104
  })