typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -0,0 +1,598 @@
1
+ import { randomUUID } from 'node:crypto'
2
+
3
+ import { canonicalGithubRepo } from './github-repo'
4
+
5
+ // Shows the agent's own PR review as a GitHub check on the reviewed commit:
6
+ // in progress while a reviewer subagent works, completed with the verdict once
7
+ // the review is verified on GitHub. The tracker is a process-wide singleton
8
+ // (like the verdict coordinator) because its producers live on both sides of
9
+ // the agent/channel boundary: `spawn_subagent` begins and settles reviewer work,
10
+ // while the github adapter attaches the publisher and reports verified reviews.
11
+ //
12
+ // A check left `in_progress` stays that way on GitHub indefinitely, so every
13
+ // path must end it without relying on the model: reviewer settlement, a review
14
+ // that never posts (deadline sweep), cancellation, and a restart (durable lease
15
+ // file reaped on the next attach). A decided outcome is persisted with its lease
16
+ // and retried until GitHub acknowledges it, so a transient publish failure or a
17
+ // detached adapter cannot strand the check either.
18
+
19
+ // Fallback check name; the adapter names the check after the agent's GitHub
20
+ // identity once known (see `reviewCheckName`).
21
+ export const REVIEW_CHECK_NAME = 'typeclaw/review'
22
+
23
+ // Backstop for the reviewing phase. The reviewer subagent's own ceiling
24
+ // (REVIEWER_SPAWN_TIMEOUT_MS, 30m) normally settles it first as a failure; this
25
+ // only fires when that settlement never arrives.
26
+ export const REVIEW_CHECK_REVIEWING_DEADLINE_MS = 35 * 60_000
27
+
28
+ // The reviewer finished, but the parent session still has to post. A parent
29
+ // that wedges or dies here would otherwise leave the check spinning.
30
+ export const REVIEW_CHECK_POSTING_DEADLINE_MS = 10 * 60_000
31
+
32
+ export const REVIEW_CHECK_SWEEP_INTERVAL_MS = 60_000
33
+
34
+ // A decided outcome GitHub keeps rejecting as transient is abandoned after this
35
+ // long so a permanently broken repo cannot grow the lease file forever.
36
+ export const REVIEW_CHECK_PUBLISH_GIVE_UP_MS = 24 * 60 * 60_000
37
+
38
+ export type ReviewCheckKey = { repo: string; pullRequest: number; headSha: string }
39
+
40
+ export type ReviewCheckRef = { mode: 'check-run'; checkRunId: number } | { mode: 'status'; context?: string }
41
+
42
+ export type ReviewCheckFinding = { path: string; line: number; side?: 'LEFT' | 'RIGHT'; title: string }
43
+
44
+ // Persisted with the outcome, so it stays small: `findings` is capped and
45
+ // `findingCount` keeps the real total.
46
+ export type ReviewCheckVerdictDetails = {
47
+ reviewId?: number
48
+ findings?: ReviewCheckFinding[]
49
+ findingCount?: number
50
+ }
51
+
52
+ export type ReviewCheckOutcome =
53
+ | { kind: 'verdict'; state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED'; details?: ReviewCheckVerdictDetails }
54
+ | { kind: 'failed'; reason: string }
55
+ | { kind: 'cancelled'; reason: string }
56
+
57
+ export type ReviewerSettlement =
58
+ | { kind: 'ok' }
59
+ | { kind: 'failed'; reason: string }
60
+ | { kind: 'cancelled'; reason: string }
61
+
62
+ // What a reviewer is doing, in plain categories: the check page never shows
63
+ // task ids, session ids, tool names, or model text.
64
+ export type ReviewerActivity = {
65
+ started: boolean
66
+ filesRead: number
67
+ commandsRun: number
68
+ current: 'reading' | 'commands' | 'writing' | null
69
+ lastActivityAt: number | null
70
+ }
71
+
72
+ export type ReviewCheckProgress = {
73
+ phase: 'reviewing' | 'posting'
74
+ startedAt: number
75
+ now: number
76
+ reviewKind?: 'review' | 're-review'
77
+ activity: ReviewerActivity | null
78
+ }
79
+
80
+ export type ReviewCheckTiming = { startedAt: number; decidedAt: number; tracked: boolean }
81
+
82
+ // 'published': GitHub has the outcome, or retrying cannot help (disabled, no
83
+ // permission). 'retry': a transient failure; the tracker keeps the outcome.
84
+ export type ReviewCheckPublishResult = 'published' | 'retry'
85
+
86
+ export type ReviewCheckPublisher = {
87
+ // The name a new check (or commit-status context) is created under now.
88
+ // Defaults to REVIEW_CHECK_NAME.
89
+ name?: () => string
90
+ // null: checks are disabled, not permitted, or the create failed — no check exists.
91
+ start: (key: ReviewCheckKey) => Promise<ReviewCheckRef | null>
92
+ // `ref: null` means no in-progress check exists; a publisher creates a
93
+ // completed check directly for a verdict and ignores other outcomes.
94
+ finish: (
95
+ key: ReviewCheckKey,
96
+ ref: ReviewCheckRef | null,
97
+ outcome: ReviewCheckOutcome,
98
+ timing?: ReviewCheckTiming,
99
+ ) => Promise<ReviewCheckPublishResult>
100
+ // Best effort: a lost progress update is replaced by the next one.
101
+ progress?: (key: ReviewCheckKey, ref: ReviewCheckRef, progress: ReviewCheckProgress) => Promise<void>
102
+ }
103
+
104
+ // `ref: null` is only persisted together with an outcome: a verdict whose
105
+ // completed check still has to be created.
106
+ export type PersistedReviewCheckLease = ReviewCheckKey & {
107
+ ref: ReviewCheckRef | null
108
+ startedAt: number
109
+ // Absent in records written before review durations were shown.
110
+ tracked?: boolean
111
+ outcome?: ReviewCheckOutcome
112
+ outcomeAt?: number
113
+ }
114
+
115
+ export type ReviewCheckLeaseStore = {
116
+ load: () => Promise<PersistedReviewCheckLease[]>
117
+ save: (leases: PersistedReviewCheckLease[]) => Promise<void>
118
+ }
119
+
120
+ export type ReviewCheckLogger = { info: (m: string) => void; warn: (m: string) => void }
121
+
122
+ type Lease = {
123
+ uid: string
124
+ seq: number
125
+ key: ReviewCheckKey
126
+ // Only a check written under the same name can replace this one on GitHub.
127
+ name: string
128
+ startedAt: number
129
+ owners: Set<string>
130
+ ownerSucceeded: boolean
131
+ phase: 'reviewing' | 'posting'
132
+ deadlineAt: number
133
+ // undefined while the start call is in flight.
134
+ ref: ReviewCheckRef | null | undefined
135
+ started: Promise<void>
136
+ // False for a lease created only to publish a verdict nobody was tracked
137
+ // reviewing; its duration means nothing.
138
+ tracked: boolean
139
+ reviewKind?: 'review' | 're-review'
140
+ activity: ReviewerActivity | null
141
+ outcome?: ReviewCheckOutcome
142
+ outcomeAt?: number
143
+ outcomeVersion: number
144
+ publishing: Promise<void> | null
145
+ }
146
+
147
+ type Attachment = { publisher: ReviewCheckPublisher; store: ReviewCheckLeaseStore; logger: ReviewCheckLogger }
148
+
149
+ const RESTARTED_OUTCOME: ReviewCheckOutcome = {
150
+ kind: 'failed',
151
+ reason: 'TypeClaw restarted before this review was posted',
152
+ }
153
+
154
+ export class GithubReviewCheckTracker {
155
+ private readonly leases = new Map<string, Lease>()
156
+ private readonly leaseByTask = new Map<string, string>()
157
+ private readonly publishLocks = new Map<string, Promise<void>>()
158
+ // Newest lease per commit that owns a check on GitHub. Outlives that lease so
159
+ // an older queued outcome stays superseded after the newer one publishes.
160
+ private readonly newestCheckSeq = new Map<string, number>()
161
+ private nextSeq = 0
162
+ private attachment: Attachment | null = null
163
+ // Kept across detach so a lease decided while no adapter is attached is still
164
+ // persisted and published on the next attach.
165
+ private store: { store: ReviewCheckLeaseStore; logger: ReviewCheckLogger } | null = null
166
+ private sweepTimer: ReturnType<typeof setInterval> | null = null
167
+ private persistChain: Promise<void> = Promise.resolve()
168
+
169
+ constructor(private readonly now: () => number = Date.now) {}
170
+
171
+ // Called on adapter start. A persisted lease this process does not hold was
172
+ // written by a previous process: its decided outcome is republished, and an
173
+ // undecided one died with that process's reviewer.
174
+ async attach(attachment: Attachment): Promise<void> {
175
+ this.attachment = attachment
176
+ this.store = { store: attachment.store, logger: attachment.logger }
177
+ if (this.sweepTimer === null) {
178
+ this.sweepTimer = setInterval(() => void this.sweep(), REVIEW_CHECK_SWEEP_INTERVAL_MS)
179
+ this.sweepTimer.unref?.()
180
+ }
181
+ let persisted: PersistedReviewCheckLease[] = []
182
+ try {
183
+ persisted = await attachment.store.load()
184
+ } catch (err) {
185
+ attachment.logger.warn(`[github] review check leases unreadable: ${describe(err)}`)
186
+ }
187
+ let restored = 0
188
+ for (const record of persisted) {
189
+ if (this.holds(record)) continue
190
+ const lease = this.createLease(normalizeKey(record), record.startedAt)
191
+ lease.ref = record.ref
192
+ if (record.ref?.mode === 'status') lease.name = record.ref.context ?? REVIEW_CHECK_NAME
193
+ lease.tracked = record.tracked === true
194
+ this.claimCheck(lease)
195
+ this.decide(lease, record.outcome ?? RESTARTED_OUTCOME, record.outcomeAt)
196
+ restored++
197
+ }
198
+ if (restored > 0) {
199
+ attachment.logger.info(`[github] closing ${restored} review check(s) left by a previous process`)
200
+ await this.persist()
201
+ }
202
+ await this.publishDecided()
203
+ }
204
+
205
+ detach(publisher: ReviewCheckPublisher): void {
206
+ if (this.attachment?.publisher !== publisher) return
207
+ this.attachment = null
208
+ if (this.sweepTimer !== null) {
209
+ clearInterval(this.sweepTimer)
210
+ this.sweepTimer = null
211
+ }
212
+ }
213
+
214
+ beginReview(
215
+ key: ReviewCheckKey,
216
+ taskId: string,
217
+ options: { reviewKind?: 'review' | 're-review' } = {},
218
+ ): Promise<void> {
219
+ const attachment = this.attachment
220
+ if (attachment === null) return Promise.resolve()
221
+ const normalized = normalizeKey(key)
222
+ const existing = this.openLease(normalized)
223
+ if (existing !== undefined) {
224
+ this.leaseByTask.set(taskId, existing.uid)
225
+ existing.owners.add(taskId)
226
+ existing.phase = 'reviewing'
227
+ existing.deadlineAt = this.now() + REVIEW_CHECK_REVIEWING_DEADLINE_MS
228
+ if (options.reviewKind !== undefined) existing.reviewKind = options.reviewKind
229
+ return existing.started
230
+ }
231
+ const lease = this.createLease(normalized, this.now())
232
+ lease.tracked = true
233
+ if (options.reviewKind !== undefined) lease.reviewKind = options.reviewKind
234
+ this.leaseByTask.set(taskId, lease.uid)
235
+ lease.owners.add(taskId)
236
+ lease.started = attachment.publisher
237
+ .start(normalized)
238
+ .then(
239
+ (ref) => {
240
+ lease.ref = ref
241
+ if (ref?.mode === 'status' && ref.context !== undefined) lease.name = ref.context
242
+ },
243
+ (err: unknown) => {
244
+ attachment.logger.warn(`[github] review check start failed for ${leaseId(normalized)}: ${describe(err)}`)
245
+ lease.ref = null
246
+ },
247
+ )
248
+ .then(() => this.afterStart(lease))
249
+ return lease.started
250
+ }
251
+
252
+ reviewerSettled(taskId: string, settlement: ReviewerSettlement): Promise<void> {
253
+ const uid = this.leaseByTask.get(taskId)
254
+ if (uid === undefined) return Promise.resolve()
255
+ this.leaseByTask.delete(taskId)
256
+ const lease = this.leases.get(uid)
257
+ if (lease === undefined || lease.outcome !== undefined || !lease.owners.delete(taskId)) return Promise.resolve()
258
+ if (settlement.kind === 'ok') lease.ownerSucceeded = true
259
+ // A sibling reviewer for the same commit is still working; its settlement decides.
260
+ if (lease.owners.size > 0) return Promise.resolve()
261
+ if (lease.ownerSucceeded) {
262
+ lease.phase = 'posting'
263
+ lease.deadlineAt = this.now() + REVIEW_CHECK_POSTING_DEADLINE_MS
264
+ return this.publishProgress(lease)
265
+ }
266
+ return this.finish(lease, settlement.kind === 'ok' ? { kind: 'failed', reason: 'reviewer failed' } : settlement)
267
+ }
268
+
269
+ // The latest snapshot wins; it is published on the next sweep tick, which
270
+ // bounds progress PATCHes to one per lease per sweep interval.
271
+ reportActivity(taskId: string, activity: ReviewerActivity): void {
272
+ const uid = this.leaseByTask.get(taskId)
273
+ const lease = uid === undefined ? undefined : this.leases.get(uid)
274
+ if (lease === undefined || lease.outcome !== undefined) return
275
+ lease.activity = activity
276
+ }
277
+
278
+ async reviewPosted(
279
+ key: ReviewCheckKey,
280
+ state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED',
281
+ details?: ReviewCheckVerdictDetails,
282
+ ): Promise<void> {
283
+ const normalized = normalizeKey(key)
284
+ const outcome: ReviewCheckOutcome = { kind: 'verdict', state, ...(details !== undefined ? { details } : {}) }
285
+ const open = this.openLease(normalized)
286
+ if (open !== undefined) return this.finish(open, outcome)
287
+ // A verdict that lands after a failure was decided but before GitHub has
288
+ // it supersedes that failure.
289
+ const pending = [...this.leases.values()].find(
290
+ (lease) => lease.outcome !== undefined && sameKey(lease.key, normalized) && lease.ref !== null,
291
+ )
292
+ if (pending !== undefined) return this.finish(pending, outcome, { supersede: true })
293
+ // A review posted without a tracked reviewer (or after its lease closed)
294
+ // still deserves its verdict on the commit.
295
+ if (this.attachment === null) return
296
+ const lease = this.createLease(normalized, this.now())
297
+ lease.ref = null
298
+ this.claimCheck(lease)
299
+ return this.finish(lease, outcome, { createIfMissing: true })
300
+ }
301
+
302
+ // For a verdict posted without the reviewed head: only reviews that already
303
+ // finished on this PR can be the ones it reports.
304
+ async completePostingReviews(
305
+ repo: string,
306
+ pullRequest: number,
307
+ state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED',
308
+ ): Promise<void> {
309
+ const canonical = canonicalGithubRepo(repo)
310
+ const matching = [...this.leases.values()].filter(
311
+ (lease) =>
312
+ lease.outcome === undefined &&
313
+ lease.phase === 'posting' &&
314
+ lease.key.repo === canonical &&
315
+ lease.key.pullRequest === pullRequest,
316
+ )
317
+ await Promise.all(matching.map((lease) => this.finish(lease, { kind: 'verdict', state })))
318
+ }
319
+
320
+ async cancelPullRequest(repo: string, pullRequest: number, reason: string): Promise<void> {
321
+ const canonical = canonicalGithubRepo(repo)
322
+ const matching = [...this.leases.values()].filter(
323
+ (lease) => lease.outcome === undefined && lease.key.repo === canonical && lease.key.pullRequest === pullRequest,
324
+ )
325
+ await Promise.all(matching.map((lease) => this.finish(lease, { kind: 'cancelled', reason })))
326
+ }
327
+
328
+ async sweep(): Promise<void> {
329
+ const now = this.now()
330
+ const expired = [...this.leases.values()].filter((lease) => lease.outcome === undefined && lease.deadlineAt <= now)
331
+ await Promise.all(
332
+ expired.map((lease) =>
333
+ this.finish(lease, {
334
+ kind: 'failed',
335
+ reason:
336
+ lease.phase === 'posting'
337
+ ? 'the review finished but was not posted in time'
338
+ : 'the reviewer did not finish in time',
339
+ }),
340
+ ),
341
+ )
342
+ await this.publishDecided()
343
+ const open = [...this.leases.values()].filter((lease) => lease.outcome === undefined)
344
+ await Promise.all(open.map((lease) => this.publishProgress(lease)))
345
+ }
346
+
347
+ private createLease(key: ReviewCheckKey, startedAt: number): Lease {
348
+ const lease: Lease = {
349
+ uid: randomUUID(),
350
+ seq: this.nextSeq++,
351
+ key,
352
+ name: this.attachment?.publisher.name?.() ?? REVIEW_CHECK_NAME,
353
+ startedAt,
354
+ owners: new Set(),
355
+ ownerSucceeded: false,
356
+ phase: 'reviewing',
357
+ deadlineAt: this.now() + REVIEW_CHECK_REVIEWING_DEADLINE_MS,
358
+ ref: undefined,
359
+ started: Promise.resolve(),
360
+ tracked: false,
361
+ activity: null,
362
+ outcomeVersion: 0,
363
+ publishing: null,
364
+ }
365
+ this.leases.set(lease.uid, lease)
366
+ return lease
367
+ }
368
+
369
+ private async afterStart(lease: Lease): Promise<void> {
370
+ if (lease.ref === null) {
371
+ // No check exists, so there is nothing to complete or recover.
372
+ if (lease.outcome !== undefined) this.drop(lease)
373
+ return
374
+ }
375
+ this.claimCheck(lease)
376
+ await this.persist()
377
+ if (lease.outcome !== undefined) await this.publish(lease)
378
+ }
379
+
380
+ private async finish(
381
+ lease: Lease,
382
+ outcome: ReviewCheckOutcome,
383
+ options: { supersede?: boolean; createIfMissing?: boolean } = {},
384
+ ): Promise<void> {
385
+ if (lease.outcome !== undefined && options.supersede !== true) return
386
+ this.decide(lease, outcome)
387
+ for (const owner of lease.owners) this.leaseByTask.delete(owner)
388
+ lease.owners.clear()
389
+ if (lease.ref === undefined) return lease.started
390
+ if (lease.ref === null && options.createIfMissing !== true) {
391
+ this.drop(lease)
392
+ return
393
+ }
394
+ await this.persist()
395
+ await this.publish(lease)
396
+ }
397
+
398
+ private decide(lease: Lease, outcome: ReviewCheckOutcome, at?: number): void {
399
+ lease.outcome = outcome
400
+ lease.outcomeAt = at ?? this.now()
401
+ lease.outcomeVersion += 1
402
+ }
403
+
404
+ private async publishDecided(): Promise<void> {
405
+ const decided = [...this.leases.values()].filter((lease) => lease.outcome !== undefined && lease.ref !== undefined)
406
+ await Promise.all(decided.map((lease) => this.publish(lease)))
407
+ }
408
+
409
+ // Publishes for one commit run one at a time: commit statuses (and a
410
+ // completed check created from no ref) share one name on the commit, so
411
+ // whichever lands last is what GitHub shows.
412
+ private publish(lease: Lease): Promise<void> {
413
+ if (lease.publishing !== null) return lease.publishing
414
+ lease.publishing = this.withPublishLock(lease.key, () => this.publishUntilCurrent(lease)).finally(() => {
415
+ lease.publishing = null
416
+ })
417
+ return lease.publishing
418
+ }
419
+
420
+ // Shares the completion's per-commit lock, and re-checks for an outcome once
421
+ // it holds it, so a progress update can never land after the completed check.
422
+ private publishProgress(lease: Lease): Promise<void> {
423
+ if (lease.ref?.mode !== 'check-run' || this.attachment?.publisher.progress === undefined) return Promise.resolve()
424
+ return this.withPublishLock(lease.key, async () => {
425
+ const attachment = this.attachment
426
+ const progress = attachment?.publisher.progress
427
+ const ref = lease.ref
428
+ if (progress === undefined || lease.outcome !== undefined || ref?.mode !== 'check-run') return
429
+ if (this.leases.get(lease.uid) !== lease) return
430
+ try {
431
+ await progress(lease.key, ref, {
432
+ phase: lease.phase,
433
+ startedAt: lease.startedAt,
434
+ now: this.now(),
435
+ ...(lease.reviewKind !== undefined ? { reviewKind: lease.reviewKind } : {}),
436
+ activity: lease.activity,
437
+ })
438
+ } catch (err) {
439
+ attachment?.logger.warn(`[github] review check progress failed for ${leaseId(lease.key)}: ${describe(err)}`)
440
+ }
441
+ }).catch(() => {})
442
+ }
443
+
444
+ private withPublishLock(key: ReviewCheckKey, fn: () => Promise<void>): Promise<void> {
445
+ const lockId = leaseId(key)
446
+ const run = (this.publishLocks.get(lockId) ?? Promise.resolve()).then(fn)
447
+ const tail = run.catch(() => {})
448
+ this.publishLocks.set(lockId, tail)
449
+ void tail.then(() => {
450
+ if (this.publishLocks.get(lockId) === tail) this.publishLocks.delete(lockId)
451
+ })
452
+ return run
453
+ }
454
+
455
+ private async publishUntilCurrent(lease: Lease): Promise<void> {
456
+ for (;;) {
457
+ const attachment = this.attachment
458
+ const outcome = lease.outcome
459
+ if (attachment === null || outcome === undefined || lease.ref === undefined) return
460
+ if (this.isSuperseded(lease)) {
461
+ this.drop(lease)
462
+ await this.persist()
463
+ return
464
+ }
465
+ const version = lease.outcomeVersion
466
+ let result: ReviewCheckPublishResult
467
+ try {
468
+ result = await attachment.publisher.finish(lease.key, lease.ref, outcome, {
469
+ startedAt: lease.startedAt,
470
+ decidedAt: lease.outcomeAt ?? this.now(),
471
+ tracked: lease.tracked,
472
+ })
473
+ } catch (err) {
474
+ attachment.logger.warn(`[github] review check finish failed for ${leaseId(lease.key)}: ${describe(err)}`)
475
+ result = 'retry'
476
+ }
477
+ if (result === 'retry') {
478
+ if (this.now() - (lease.outcomeAt ?? this.now()) >= REVIEW_CHECK_PUBLISH_GIVE_UP_MS) {
479
+ attachment.logger.warn(
480
+ `[github] giving up on review check ${leaseId(lease.key)}: GitHub kept rejecting its completion`,
481
+ )
482
+ this.drop(lease)
483
+ await this.persist()
484
+ }
485
+ return
486
+ }
487
+ if (version === lease.outcomeVersion) {
488
+ this.drop(lease)
489
+ await this.persist()
490
+ return
491
+ }
492
+ }
493
+ }
494
+
495
+ // A queued outcome that would write a shared commit-status context (or
496
+ // create a new check run) must not overwrite a newer review of the same
497
+ // commit under the same name. An App check run has its own id, and a check
498
+ // under another name is a separate check, so completing either stays safe.
499
+ private isSuperseded(lease: Lease): boolean {
500
+ if (lease.ref?.mode === 'check-run') return false
501
+ if ((this.newestCheckSeq.get(checkId(lease)) ?? -1) > lease.seq) return true
502
+ // A newer review whose check is still being created will overwrite it too.
503
+ return [...this.leases.values()].some(
504
+ (other) =>
505
+ other.seq > lease.seq && other.ref === undefined && sameKey(other.key, lease.key) && other.name === lease.name,
506
+ )
507
+ }
508
+
509
+ // Older decided outcomes this lease supersedes are retired right away, not at
510
+ // their next publish, so the persisted snapshot never holds one a restart
511
+ // could replay over the newer review.
512
+ private claimCheck(lease: Lease): void {
513
+ const id = checkId(lease)
514
+ this.newestCheckSeq.set(id, Math.max(this.newestCheckSeq.get(id) ?? -1, lease.seq))
515
+ for (const older of this.leases.values()) {
516
+ if (
517
+ older.seq < lease.seq &&
518
+ older.outcome !== undefined &&
519
+ older.ref !== undefined &&
520
+ older.ref?.mode !== 'check-run' &&
521
+ sameKey(older.key, lease.key) &&
522
+ older.name === lease.name
523
+ ) {
524
+ this.leases.delete(older.uid)
525
+ }
526
+ }
527
+ }
528
+
529
+ private drop(lease: Lease): void {
530
+ if (this.leases.get(lease.uid) === lease) this.leases.delete(lease.uid)
531
+ if (![...this.leases.values()].some((other) => sameKey(other.key, lease.key) && other.name === lease.name)) {
532
+ this.newestCheckSeq.delete(checkId(lease))
533
+ }
534
+ }
535
+
536
+ private openLease(key: ReviewCheckKey): Lease | undefined {
537
+ return [...this.leases.values()].find((lease) => lease.outcome === undefined && sameKey(lease.key, key))
538
+ }
539
+
540
+ private holds(record: PersistedReviewCheckLease): boolean {
541
+ const key = normalizeKey(record)
542
+ return [...this.leases.values()].some((lease) => sameKey(lease.key, key) && sameRef(lease.ref, record.ref))
543
+ }
544
+
545
+ private persist(): Promise<void> {
546
+ const target = this.store
547
+ if (target === null) return this.persistChain
548
+ const snapshot: PersistedReviewCheckLease[] = [...this.leases.values()].flatMap((lease) => {
549
+ if (lease.ref === undefined || (lease.ref === null && lease.outcome === undefined)) return []
550
+ return [
551
+ {
552
+ ...lease.key,
553
+ ref: lease.ref,
554
+ startedAt: lease.startedAt,
555
+ ...(lease.tracked ? { tracked: true } : {}),
556
+ ...(lease.outcome !== undefined ? { outcome: lease.outcome, outcomeAt: lease.outcomeAt } : {}),
557
+ },
558
+ ]
559
+ })
560
+ this.persistChain = this.persistChain
561
+ .then(() => target.store.save(snapshot))
562
+ .catch((err: unknown) => {
563
+ target.logger.warn(`[github] review check leases not persisted: ${describe(err)}`)
564
+ })
565
+ return this.persistChain
566
+ }
567
+ }
568
+
569
+ export const githubReviewChecks = new GithubReviewCheckTracker()
570
+
571
+ function normalizeKey(key: ReviewCheckKey): ReviewCheckKey {
572
+ return { repo: canonicalGithubRepo(key.repo), pullRequest: key.pullRequest, headSha: key.headSha.toLowerCase() }
573
+ }
574
+
575
+ function sameKey(a: ReviewCheckKey, b: ReviewCheckKey): boolean {
576
+ return a.repo === b.repo && a.pullRequest === b.pullRequest && a.headSha === b.headSha
577
+ }
578
+
579
+ function sameRef(a: ReviewCheckRef | null | undefined, b: ReviewCheckRef | null): boolean {
580
+ if (a === undefined || a === null || b === null) return a === b
581
+ if (a.mode === 'check-run' && b.mode === 'check-run') return a.checkRunId === b.checkRunId
582
+ if (a.mode === 'status' && b.mode === 'status') {
583
+ return (a.context ?? REVIEW_CHECK_NAME) === (b.context ?? REVIEW_CHECK_NAME)
584
+ }
585
+ return false
586
+ }
587
+
588
+ function checkId(lease: Lease): string {
589
+ return `${leaseId(lease.key)}:${lease.name}`
590
+ }
591
+
592
+ function leaseId(key: ReviewCheckKey): string {
593
+ return `${canonicalGithubRepo(key.repo)}#${key.pullRequest}@${key.headSha.toLowerCase()}`
594
+ }
595
+
596
+ function describe(err: unknown): string {
597
+ return err instanceof Error ? err.message : String(err)
598
+ }