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
@@ -6,6 +6,32 @@
6
6
  // is a false receipt (see channel-reply.ts). State is per-session and reset at
7
7
  // turn start, so a claim must be backed by an action in the SAME turn.
8
8
 
9
+ import type { BackgroundObligationRef } from './background-obligations'
10
+ import type { InboundRef } from './inbound-journal'
11
+
12
+ export type ReviewResultCoverage = {
13
+ inboundCoverage?: InboundRef[]
14
+ backgroundCoverage?: BackgroundObligationRef[]
15
+ expectedAccountIdentity?: string
16
+ }
17
+
18
+ let reviewCoverageCapture: ((sessionId: string) => Promise<ReviewResultCoverage>) | null = null
19
+
20
+ export function setReviewCoverageCapture(capture: typeof reviewCoverageCapture): void {
21
+ reviewCoverageCapture = capture
22
+ }
23
+
24
+ export async function captureReviewResultCoverage(sessionId: string): Promise<ReviewResultCoverage> {
25
+ const coverage = await reviewCoverageCapture?.(sessionId)
26
+ return {
27
+ inboundCoverage: coverage?.inboundCoverage?.map((ref) => ({ ...ref })) ?? [],
28
+ backgroundCoverage: coverage?.backgroundCoverage?.map((ref) => ({ ...ref })) ?? [],
29
+ ...(coverage?.expectedAccountIdentity !== undefined
30
+ ? { expectedAccountIdentity: coverage.expectedAccountIdentity }
31
+ : {}),
32
+ }
33
+ }
34
+
9
35
  export type ReviewVerdict = 'APPROVE' | 'REQUEST_CHANGES'
10
36
  export type ReviewRoundOutcome = ReviewVerdict | 'DISMISSED'
11
37
 
@@ -14,6 +40,8 @@ export type ReviewObserver = (args: {
14
40
  workspace: string
15
41
  prNumber: number
16
42
  verdict: ReviewRoundOutcome
43
+ // The commit the landed review is attached to, when the publisher knows it.
44
+ commitSha?: string
17
45
  }) => void
18
46
 
19
47
  // A formal review LANDED this turn, of ANY state — the two decisive verdicts PLUS
@@ -24,12 +52,14 @@ export type ReviewObserver = (args: {
24
52
  // verdict-claim risk and must never satisfy `hasReview()`.
25
53
  export type ReviewOutputState = ReviewVerdict | 'COMMENT'
26
54
 
27
- export type ReviewOutputObserver = (args: {
28
- sessionId: string
29
- workspace: string
30
- prNumber: number
31
- state: ReviewOutputState
32
- }) => void
55
+ export type ReviewOutputObserver = (
56
+ args: {
57
+ sessionId: string
58
+ workspace: string
59
+ prNumber: number
60
+ state: ReviewOutputState
61
+ } & ReviewResultCoverage,
62
+ ) => void | Promise<void>
33
63
 
34
64
  type PrKey = string
35
65
  type ThreadKey = string
@@ -45,6 +75,21 @@ const resolvedThreads = new Set<ThreadKey>()
45
75
  // plugin/channels boundary, which is why it owns this hook.
46
76
  let reviewObserver: ReviewObserver | null = null
47
77
  let reviewOutputObserver: ReviewOutputObserver | null = null
78
+ export type VerifiedDismissal = {
79
+ sessionId: string
80
+ workspace: string
81
+ prNumber: number
82
+ commitSha?: string
83
+ startedAt?: number
84
+ }
85
+ const dismissalObservers = new Set<(dismissal: VerifiedDismissal) => Promise<void>>()
86
+
87
+ export function observeVerifiedDismissals(observer: (dismissal: VerifiedDismissal) => Promise<void>): () => void {
88
+ dismissalObservers.add(observer)
89
+ return () => {
90
+ dismissalObservers.delete(observer)
91
+ }
92
+ }
48
93
 
49
94
  export function setReviewObserver(observer: ReviewObserver | null): void {
50
95
  reviewObserver = observer
@@ -57,6 +102,8 @@ export function setReviewOutputObserver(observer: ReviewOutputObserver | null):
57
102
  export function __resetReviewObserverForTest(): void {
58
103
  reviewObserver = null
59
104
  reviewOutputObserver = null
105
+ reviewCoverageCapture = null
106
+ dismissalObservers.clear()
60
107
  }
61
108
 
62
109
  function prKey(sessionId: string, workspace: string, prNumber: number): PrKey {
@@ -76,12 +123,15 @@ export function resetReviewTurn(sessionId: string): void {
76
123
  }
77
124
  }
78
125
 
79
- export function recordReview(args: {
80
- sessionId: string
81
- workspace: string
82
- prNumber: number
83
- verdict: ReviewVerdict
84
- }): void {
126
+ export async function recordReview(
127
+ args: {
128
+ sessionId: string
129
+ workspace: string
130
+ prNumber: number
131
+ verdict: ReviewVerdict
132
+ commitSha?: string
133
+ } & ReviewResultCoverage,
134
+ ): Promise<void> {
85
135
  const key = prKey(args.sessionId, args.workspace, args.prNumber)
86
136
  const set = reviewsByPr.get(key) ?? new Set<ReviewVerdict>()
87
137
  set.add(args.verdict)
@@ -90,41 +140,65 @@ export function recordReview(args: {
90
140
  // ledger write — the false-receipt guard depends on this record being durable.
91
141
  if (reviewObserver !== null) {
92
142
  try {
93
- reviewObserver(args)
143
+ reviewObserver({
144
+ sessionId: args.sessionId,
145
+ workspace: args.workspace,
146
+ prNumber: args.prNumber,
147
+ verdict: args.verdict,
148
+ ...(args.commitSha !== undefined ? { commitSha: args.commitSha } : {}),
149
+ })
94
150
  } catch {
95
151
  // swallow: a broken broadcast must not break verdict bookkeeping
96
152
  }
97
153
  }
98
154
  // A decisive verdict IS review output too — fan it to the output observer so the
99
155
  // router's empty-turn guard sees it without a second detection path.
100
- recordReviewOutput({
156
+ await recordReviewOutput({
101
157
  sessionId: args.sessionId,
102
158
  workspace: args.workspace,
103
159
  prNumber: args.prNumber,
104
160
  state: args.verdict,
161
+ ...(args.inboundCoverage !== undefined ? { inboundCoverage: args.inboundCoverage } : {}),
162
+ ...(args.backgroundCoverage !== undefined ? { backgroundCoverage: args.backgroundCoverage } : {}),
105
163
  })
106
164
  }
107
165
 
108
- export function recordVerifiedDismissal(args: { sessionId: string; workspace: string; prNumber: number }): void {
109
- if (reviewObserver === null) return
110
- try {
111
- reviewObserver({ ...args, verdict: 'DISMISSED' })
112
- } catch {
113
- // A broken round wakeup must not turn a verified GitHub mutation into a tool failure.
166
+ export async function recordVerifiedDismissal(args: VerifiedDismissal): Promise<void> {
167
+ if (reviewObserver !== null) {
168
+ try {
169
+ reviewObserver({
170
+ sessionId: args.sessionId,
171
+ workspace: args.workspace,
172
+ prNumber: args.prNumber,
173
+ verdict: 'DISMISSED',
174
+ })
175
+ } catch {
176
+ // A broken round wakeup must not turn a verified GitHub mutation into a tool failure.
177
+ }
178
+ }
179
+ for (const observer of dismissalObservers) {
180
+ try {
181
+ await observer(args)
182
+ } catch (error) {
183
+ // Publication already succeeded; retain pending work for boot verification.
184
+ console.warn('[github] verified dismissal pending-review cleanup failed:', error)
185
+ }
114
186
  }
115
187
  }
116
188
 
117
- export function recordReviewOutput(args: {
118
- sessionId: string
119
- workspace: string
120
- prNumber: number
121
- state: ReviewOutputState
122
- }): void {
189
+ export async function recordReviewOutput(
190
+ args: {
191
+ sessionId: string
192
+ workspace: string
193
+ prNumber: number
194
+ state: ReviewOutputState
195
+ } & ReviewResultCoverage,
196
+ ): Promise<void> {
123
197
  if (reviewOutputObserver === null) return
124
198
  try {
125
- reviewOutputObserver(args)
199
+ await reviewOutputObserver(args)
126
200
  } catch {
127
- // swallow: a broken router notification must not break review bookkeeping
201
+ // The review already landed remotely. Settlement failure must not authorize a mutation retry.
128
202
  }
129
203
  }
130
204
 
@@ -51,6 +51,7 @@ export type ReviewVerdictGuard = {
51
51
  verdict: ReviewVerdict
52
52
  round?: GithubReviewFollowupRound
53
53
  thread?: string | null
54
+ reviewedHeadSha?: string
54
55
  retainDuplicateLease?: boolean
55
56
  }) => Promise<ApproveBlock | null>
56
57
  release: (args: { callId: string; outcome: ReviewOutputOutcome }) => Promise<void>
@@ -117,7 +118,8 @@ const PENDING_PUBLICATION_REASON =
117
118
 
118
119
  const ROUND_INELIGIBLE_REASON =
119
120
  'This review follow-up round assigned the formal verdict to another sibling thread session. ' +
120
- 'Do not submit a formal verdict from this session; wait for the designated sibling verdict activity, then close out only this thread.'
121
+ 'Do not submit a formal verdict from this session and do not reply now: call `skip_response`. Once the designated sibling verdict lands, ' +
122
+ 'close out only this thread with the technical outcome; never mention sessions, carriers, or review rounds on the PR.'
121
123
 
122
124
  const ROUND_HEAD_UNVERIFIED_REASON =
123
125
  "Could not verify this pull request's current head commit on GitHub, so the review round's verdict was not submitted. " +
@@ -129,6 +131,18 @@ const ROUND_HEAD_MOVED_REASON =
129
131
  'The pull request head moved past the commit this review round covers, so a verdict from this round would describe stale code. ' +
130
132
  'Do not submit it; the new push starts its own review round.'
131
133
 
134
+ function reviewedHeadRequiredReason(currentHead: string): string {
135
+ return (
136
+ `The pull request head moved to ${currentHead} after this review round opened. ` +
137
+ 'Submit the verdict with `post_github_review` and set `head_sha` to the full commit SHA your review covered. ' +
138
+ `If you did not review ${currentHead}, re-review that commit first.`
139
+ )
140
+ }
141
+
142
+ function sameSha(a: string | undefined, b: string): boolean {
143
+ return a !== undefined && a.toLocaleLowerCase() === b.toLocaleLowerCase()
144
+ }
145
+
132
146
  // The standing verdict a fresh attempt would duplicate. APPROVE duplicates a
133
147
  // standing APPROVED; REQUEST_CHANGES duplicates a standing CHANGES_REQUESTED.
134
148
  function duplicatesStanding(verdict: ReviewVerdict, effective: EffectiveVerdict): boolean {
@@ -410,15 +424,53 @@ export function canPromoteGithubReviewRoundTo(
410
424
  return current !== undefined && current.status !== 'completed' && !current.attemptedCarriers.has(thread)
411
425
  }
412
426
 
427
+ // `landedCommitSha` distinguishes the two callers. A restore (undefined) only
428
+ // asks whether the round still owns the PR. A completion passes the commit the
429
+ // landed verdict is attached to (null when the publisher cannot tell), because
430
+ // completing releases the carrier's thread close-outs: after an unobserved push
431
+ // the verdict must still describe the current head.
413
432
  export async function validateGithubReviewRound(
414
433
  round: GithubReviewFollowupRound,
415
434
  createdAt?: number,
416
435
  now: () => number = Date.now,
436
+ landedCommitSha?: string | null,
417
437
  ): Promise<boolean> {
418
438
  if (createdAt !== undefined && now() - createdAt >= reviewRoundTtlMs(round)) return false
419
439
  if (expiredReviewRoundKeys.has(githubReviewRoundKey(round))) return false
440
+ if (isGithubReviewRoundSuperseded(round, now)) return false
420
441
  const currentHead = await processHeadShaResolver({ workspace: round.workspace, prNumber: round.prNumber })
421
- return currentHead !== null && currentHead === round.headSha
442
+ if (currentHead === null || isGithubReviewRoundSuperseded(round, now)) return false
443
+ if (currentHead === round.headSha) return true
444
+ if (round.kind !== 'reply') return false
445
+ return landedCommitSha === undefined || sameSha(landedCommitSha ?? undefined, currentHead)
446
+ }
447
+
448
+ // Registering a round evicts every other round for the same PR, so a round that
449
+ // is no longer registered while a sibling round is has been replaced by a newer
450
+ // one (a later push, or a later reply generation). Re-registering it would evict
451
+ // that newer round in turn, so callers must check this BEFORE re-registration.
452
+ export function isGithubReviewRoundSuperseded(round: GithubReviewFollowupRound, now: () => number = Date.now): boolean {
453
+ const key = githubReviewRoundKey(round)
454
+ if (activeReviewRoundState(key, now) !== undefined) return false
455
+ expireReviewRounds(now)
456
+ return Array.from(reviewRounds.entries()).some(
457
+ ([candidateKey, state]) =>
458
+ candidateKey !== key && state.round.workspace === round.workspace && state.round.prNumber === round.prNumber,
459
+ )
460
+ }
461
+
462
+ function pendingPushRoundForPr(
463
+ target: { workspace: string; prNumber: number },
464
+ now: () => number = Date.now,
465
+ ): ReviewRoundState | undefined {
466
+ expireReviewRounds(now)
467
+ return Array.from(reviewRounds.values()).find(
468
+ (state) =>
469
+ state.status === 'pending' &&
470
+ state.round.kind === 'push' &&
471
+ state.round.workspace === target.workspace &&
472
+ state.round.prNumber === target.prNumber,
473
+ )
422
474
  }
423
475
 
424
476
  export async function guardGithubReviewRoundDismissal(args: {
@@ -773,19 +825,13 @@ async function evaluateRoundEligibility(
773
825
  prNumber: number
774
826
  round?: GithubReviewFollowupRound
775
827
  thread?: string | null
828
+ reviewedHeadSha?: string
776
829
  },
777
830
  resolveHeadSha: HeadShaResolver,
778
831
  now: () => number = Date.now,
779
832
  logger: ReviewVerdictCoordinatorLogger = processLogger,
780
833
  ): Promise<ApproveBlock | null> {
781
- expireReviewRounds(now)
782
- const pendingRoundForPr = Array.from(reviewRounds.values()).find(
783
- (state) =>
784
- state.status === 'pending' &&
785
- state.round.kind === 'push' &&
786
- state.round.workspace === args.workspace &&
787
- state.round.prNumber === args.prNumber,
788
- )
834
+ const pendingRoundForPr = pendingPushRoundForPr(args, now)
789
835
  // Pushes invalidate the whole PR's prior verdict, so their round legitimately
790
836
  // owns every verdict attempt until one sibling carries it. Reply rounds only
791
837
  // coordinate the stamped siblings answering one blocking review: their
@@ -820,12 +866,26 @@ async function evaluateRoundEligibility(
820
866
  )
821
867
  return { block: true, kind: 'round-ineligible', reason: ROUND_HEAD_UNVERIFIED_REASON }
822
868
  }
823
- if (currentRoundHead !== activeRound.headSha) {
869
+ // Re-read ownership after the await: a round registered meanwhile evicted this
870
+ // one, and the registration below would evict it right back.
871
+ const superseded = isGithubReviewRoundSuperseded(activeRound, now)
872
+ if (superseded || (currentRoundHead !== activeRound.headSha && activeRound.kind === 'push')) {
824
873
  logger.warn(
825
- `[github] review round head moved pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} round_head=${activeRound.headSha} current_head=${currentRoundHead}`,
874
+ `[github] review round head moved pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} round_head=${activeRound.headSha} current_head=${currentRoundHead}${superseded ? ' superseded=true' : ''}`,
826
875
  )
827
876
  return { block: true, kind: 'round-ineligible', reason: ROUND_HEAD_MOVED_REASON }
828
877
  }
878
+ // A reply round's head is only the webhook snapshot at reply time, and no push
879
+ // round replaces it unless the adapter receives the push (never when
880
+ // `pull_request.synchronize` is off the event allowlist). So a moved reply round
881
+ // follows the head, but only for a verdict bound to the commit it describes:
882
+ // the carrier must name the head it reviewed, and it must still be current.
883
+ if (currentRoundHead !== activeRound.headSha && !sameSha(args.reviewedHeadSha, currentRoundHead)) {
884
+ logger.warn(
885
+ `[github] review round head moved without a matching reviewed head pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} current_head=${currentRoundHead} reviewed_head=${args.reviewedHeadSha ?? 'none'}`,
886
+ )
887
+ return { block: true, kind: 'round-ineligible', reason: reviewedHeadRequiredReason(currentRoundHead) }
888
+ }
829
889
  registerGithubReviewRound(activeRound, now())
830
890
  return null
831
891
  }
@@ -4,7 +4,10 @@ import { describeError } from './describe-error'
4
4
  // singleton would leak resolver state across tests. One instance is created in
5
5
  // run/index.ts and threaded to both the plugin loader and the channel manager.
6
6
 
7
- export type GithubTokenResolveResult = { kind: 'token'; token: string } | { kind: 'unavailable'; reason: string }
7
+ export type GithubTokenCredential = { token: string; accountIdentity?: string }
8
+ export type GithubTokenResolveResult =
9
+ | ({ kind: 'token' } & GithubTokenCredential)
10
+ | { kind: 'unavailable'; reason: string }
8
11
 
9
12
  export type ResolveGithubTokenForRepo = (repoSlug: string) => Promise<GithubTokenResolveResult>
10
13
 
@@ -16,24 +19,51 @@ export type GithubTokenBridge = {
16
19
  // process-wide GH_TOKEN, so brokered gh paths cannot rely on its prefix.
17
20
  hasAppTokenResolver: () => boolean
18
21
  getAppSelfLogin: () => string | null
19
- registerResolver: (resolver: (repoSlug: string) => Promise<string>, selfLogin?: () => string | null) => () => void
22
+ // PAT-mode channel auth: the adapter lends its stored PAT for git push to a
23
+ // configured repo. Kept apart from the App minter so PAT presence never flips
24
+ // hasAppTokenResolver() and the App-only paths (sandboxed minting, push grants).
25
+ resolvePatForRepo: ResolveGithubTokenForRepo
26
+ registerPatResolver: (resolver: (repoSlug: string) => Promise<GithubTokenCredential>) => () => void
27
+ registerResolver: (
28
+ resolver: (repoSlug: string) => Promise<GithubTokenCredential>,
29
+ selfLogin?: () => string | null,
30
+ ) => () => void
20
31
  }
21
32
 
22
33
  const NO_RESOLVER_REASON =
23
34
  'GitHub App token unavailable; the GitHub channel adapter is not running or failed to start. ' +
24
35
  'Check `typeclaw logs` and `secrets.json#channels.github`.'
25
36
 
37
+ const NO_PAT_RESOLVER_REASON =
38
+ 'No GitHub channel PAT is available; the GitHub channel is not configured with PAT auth, or its adapter is not running.'
39
+
26
40
  export function createGithubTokenBridge(): GithubTokenBridge {
27
- let current: ((repoSlug: string) => Promise<string>) | null = null
41
+ let current: ((repoSlug: string) => Promise<GithubTokenCredential>) | null = null
28
42
  let currentSelfLogin: (() => string | null) | null = null
43
+ let currentPat: ((repoSlug: string) => Promise<GithubTokenCredential>) | null = null
29
44
 
30
45
  return {
46
+ resolvePatForRepo: async (repoSlug) => {
47
+ const resolver = currentPat
48
+ if (resolver === null) return { kind: 'unavailable', reason: NO_PAT_RESOLVER_REASON }
49
+ try {
50
+ return { kind: 'token', ...(await resolver(repoSlug)) }
51
+ } catch (err) {
52
+ return { kind: 'unavailable', reason: describeError(err) }
53
+ }
54
+ },
55
+ registerPatResolver: (resolver) => {
56
+ currentPat = resolver
57
+ return () => {
58
+ if (currentPat === resolver) currentPat = null
59
+ }
60
+ },
31
61
  resolveTokenForRepo: async (repoSlug) => {
32
62
  const resolver = current
33
63
  if (resolver === null) return { kind: 'unavailable', reason: NO_RESOLVER_REASON }
34
64
  try {
35
- const token = await resolver(repoSlug)
36
- return { kind: 'token', token }
65
+ const credential = await resolver(repoSlug)
66
+ return { kind: 'token', ...credential }
37
67
  } catch (err) {
38
68
  return { kind: 'unavailable', reason: describeError(err) }
39
69
  }