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,34 @@
1
+ import type { ChannelParticipant } from "../agent/session-origin.js";
2
+ import { type MembershipCount } from "./membership.js";
3
+ import type { EngagementConfig } from "./schema.js";
4
+ import type { InboundMessage } from "./types.js";
5
+ export type EngagementDecision = 'engage' | 'observe';
6
+ export type StickyCredit = {
7
+ authorId: string;
8
+ expiresAt: number;
9
+ };
10
+ export declare class StickyLedger {
11
+ private byKey;
12
+ grant(key: string, authorId: string, expiresAt: number): void;
13
+ consume(key: string, authorId: string, now: number, windowMs: number): boolean;
14
+ has(key: string, authorId: string, now: number): boolean;
15
+ clear(key: string): number;
16
+ }
17
+ export type EngagementInput = {
18
+ message: InboundMessage;
19
+ config: EngagementConfig;
20
+ key: string;
21
+ ledger: StickyLedger;
22
+ now: number;
23
+ participants: readonly ChannelParticipant[];
24
+ membership: MembershipCount | null;
25
+ selfAliases: readonly string[];
26
+ botInThread: boolean;
27
+ };
28
+ export declare function decideEngagement(input: EngagementInput): EngagementDecision;
29
+ export declare function countEngagementHumans(message: InboundMessage, participants: readonly ChannelParticipant[], membership: MembershipCount | null, now: number, botInThread: boolean): number;
30
+ export declare function countEffectiveHumans(participants: readonly ChannelParticipant[], membership: MembershipCount | null, now: number): number;
31
+ export declare function isMultiHumanGroup(isDm: boolean, effectiveHumans: number): boolean;
32
+ export declare function resolveEffectiveHumans(persistedHumans: number, membership: MembershipCount | null, now: number): number;
33
+ export declare function grantStickyForReplyTargets(ledger: StickyLedger, key: string, authorIds: readonly string[], config: EngagementConfig, now: number): void;
34
+ export declare function matchesAnyAlias(text: string, lowercasedAliases: readonly string[]): boolean;
@@ -0,0 +1,20 @@
1
+ export type FalseReceiptDecision = {
2
+ kind: 'allow';
3
+ } | {
4
+ kind: 'block';
5
+ reason: string;
6
+ } | {
7
+ kind: 'warn';
8
+ notice: string;
9
+ };
10
+ export type FalseReceiptInput = {
11
+ sessionId: string;
12
+ adapter: string;
13
+ workspace: string;
14
+ chat: string;
15
+ thread: string | null;
16
+ text: string | undefined;
17
+ continueAfterReply: boolean;
18
+ resolveReviewThread: boolean;
19
+ };
20
+ export declare function checkFalseReceipt(input: FalseReceiptInput): FalseReceiptDecision;
@@ -0,0 +1,2 @@
1
+ export declare function canonicalGithubRepo(repo: string): string;
2
+ export declare function githubReviewerWorkKey(repo: string, prNumber: number): string;
@@ -0,0 +1,24 @@
1
+ import type { GithubReviewFollowupRound } from "./types.js";
2
+ import type { ReviewStateResult } from "./types.js";
3
+ export type RereviewGuardInput = {
4
+ adapter: string;
5
+ chat: string;
6
+ thread: string | null;
7
+ text: string | undefined;
8
+ wantsResolve: boolean;
9
+ continueAfterReply: boolean;
10
+ getReviewState: (req: {
11
+ adapter: 'github';
12
+ workspace: string;
13
+ chat: string;
14
+ }) => Promise<ReviewStateResult>;
15
+ workspace: string;
16
+ round?: GithubReviewFollowupRound;
17
+ };
18
+ export type RereviewGuardDecision = {
19
+ block: false;
20
+ } | {
21
+ block: true;
22
+ reason: string;
23
+ };
24
+ export declare function evaluateRereviewGuard(input: RereviewGuardInput): Promise<RereviewGuardDecision>;
@@ -0,0 +1,135 @@
1
+ export declare const REVIEW_CHECK_NAME = "typeclaw/review";
2
+ export declare const REVIEW_CHECK_REVIEWING_DEADLINE_MS: number;
3
+ export declare const REVIEW_CHECK_POSTING_DEADLINE_MS: number;
4
+ export declare const REVIEW_CHECK_SWEEP_INTERVAL_MS = 60000;
5
+ export declare const REVIEW_CHECK_PUBLISH_GIVE_UP_MS: number;
6
+ export type ReviewCheckKey = {
7
+ repo: string;
8
+ pullRequest: number;
9
+ headSha: string;
10
+ };
11
+ export type ReviewCheckRef = {
12
+ mode: 'check-run';
13
+ checkRunId: number;
14
+ } | {
15
+ mode: 'status';
16
+ context?: string;
17
+ };
18
+ export type ReviewCheckFinding = {
19
+ path: string;
20
+ line: number;
21
+ side?: 'LEFT' | 'RIGHT';
22
+ title: string;
23
+ };
24
+ export type ReviewCheckVerdictDetails = {
25
+ reviewId?: number;
26
+ findings?: ReviewCheckFinding[];
27
+ findingCount?: number;
28
+ };
29
+ export type ReviewCheckOutcome = {
30
+ kind: 'verdict';
31
+ state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED';
32
+ details?: ReviewCheckVerdictDetails;
33
+ } | {
34
+ kind: 'failed';
35
+ reason: string;
36
+ } | {
37
+ kind: 'cancelled';
38
+ reason: string;
39
+ };
40
+ export type ReviewerSettlement = {
41
+ kind: 'ok';
42
+ } | {
43
+ kind: 'failed';
44
+ reason: string;
45
+ } | {
46
+ kind: 'cancelled';
47
+ reason: string;
48
+ };
49
+ export type ReviewerActivity = {
50
+ started: boolean;
51
+ filesRead: number;
52
+ commandsRun: number;
53
+ current: 'reading' | 'commands' | 'writing' | null;
54
+ lastActivityAt: number | null;
55
+ };
56
+ export type ReviewCheckProgress = {
57
+ phase: 'reviewing' | 'posting';
58
+ startedAt: number;
59
+ now: number;
60
+ reviewKind?: 'review' | 're-review';
61
+ activity: ReviewerActivity | null;
62
+ };
63
+ export type ReviewCheckTiming = {
64
+ startedAt: number;
65
+ decidedAt: number;
66
+ tracked: boolean;
67
+ };
68
+ export type ReviewCheckPublishResult = 'published' | 'retry';
69
+ export type ReviewCheckPublisher = {
70
+ name?: () => string;
71
+ start: (key: ReviewCheckKey) => Promise<ReviewCheckRef | null>;
72
+ finish: (key: ReviewCheckKey, ref: ReviewCheckRef | null, outcome: ReviewCheckOutcome, timing?: ReviewCheckTiming) => Promise<ReviewCheckPublishResult>;
73
+ progress?: (key: ReviewCheckKey, ref: ReviewCheckRef, progress: ReviewCheckProgress) => Promise<void>;
74
+ };
75
+ export type PersistedReviewCheckLease = ReviewCheckKey & {
76
+ ref: ReviewCheckRef | null;
77
+ startedAt: number;
78
+ tracked?: boolean;
79
+ outcome?: ReviewCheckOutcome;
80
+ outcomeAt?: number;
81
+ };
82
+ export type ReviewCheckLeaseStore = {
83
+ load: () => Promise<PersistedReviewCheckLease[]>;
84
+ save: (leases: PersistedReviewCheckLease[]) => Promise<void>;
85
+ };
86
+ export type ReviewCheckLogger = {
87
+ info: (m: string) => void;
88
+ warn: (m: string) => void;
89
+ };
90
+ type Attachment = {
91
+ publisher: ReviewCheckPublisher;
92
+ store: ReviewCheckLeaseStore;
93
+ logger: ReviewCheckLogger;
94
+ };
95
+ export declare class GithubReviewCheckTracker {
96
+ private readonly now;
97
+ private readonly leases;
98
+ private readonly leaseByTask;
99
+ private readonly publishLocks;
100
+ private readonly newestCheckSeq;
101
+ private nextSeq;
102
+ private attachment;
103
+ private store;
104
+ private sweepTimer;
105
+ private persistChain;
106
+ constructor(now?: () => number);
107
+ attach(attachment: Attachment): Promise<void>;
108
+ detach(publisher: ReviewCheckPublisher): void;
109
+ beginReview(key: ReviewCheckKey, taskId: string, options?: {
110
+ reviewKind?: 'review' | 're-review';
111
+ }): Promise<void>;
112
+ reviewerSettled(taskId: string, settlement: ReviewerSettlement): Promise<void>;
113
+ reportActivity(taskId: string, activity: ReviewerActivity): void;
114
+ reviewPosted(key: ReviewCheckKey, state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED', details?: ReviewCheckVerdictDetails): Promise<void>;
115
+ completePostingReviews(repo: string, pullRequest: number, state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED'): Promise<void>;
116
+ cancelPullRequest(repo: string, pullRequest: number, reason: string): Promise<void>;
117
+ sweep(): Promise<void>;
118
+ private createLease;
119
+ private afterStart;
120
+ private finish;
121
+ private decide;
122
+ private publishDecided;
123
+ private publish;
124
+ private publishProgress;
125
+ private withPublishLock;
126
+ private publishUntilCurrent;
127
+ private isSuperseded;
128
+ private claimCheck;
129
+ private drop;
130
+ private openLease;
131
+ private holds;
132
+ private persist;
133
+ }
134
+ export declare const githubReviewChecks: GithubReviewCheckTracker;
135
+ export {};
@@ -0,0 +1,3 @@
1
+ export type ReviewClaim = 'block-approve' | 'block-request-changes' | 'block-resolve' | 'warn' | 'ignore';
2
+ export declare function classifyReviewClaim(rawText: string): ReviewClaim;
3
+ export declare function isPositiveWarnCloseout(rawText: string): boolean;
@@ -0,0 +1,71 @@
1
+ import type { BackgroundObligationRef } from "./background-obligations.js";
2
+ import type { InboundRef } from "./inbound-journal.js";
3
+ export type ReviewResultCoverage = {
4
+ inboundCoverage?: InboundRef[];
5
+ backgroundCoverage?: BackgroundObligationRef[];
6
+ expectedAccountIdentity?: string;
7
+ };
8
+ declare let reviewCoverageCapture: ((sessionId: string) => Promise<ReviewResultCoverage>) | null;
9
+ export declare function setReviewCoverageCapture(capture: typeof reviewCoverageCapture): void;
10
+ export declare function captureReviewResultCoverage(sessionId: string): Promise<ReviewResultCoverage>;
11
+ export type ReviewVerdict = 'APPROVE' | 'REQUEST_CHANGES';
12
+ export type ReviewRoundOutcome = ReviewVerdict | 'DISMISSED';
13
+ export type ReviewObserver = (args: {
14
+ sessionId: string;
15
+ workspace: string;
16
+ prNumber: number;
17
+ verdict: ReviewRoundOutcome;
18
+ commitSha?: string;
19
+ }) => void;
20
+ export type ReviewOutputState = ReviewVerdict | 'COMMENT';
21
+ export type ReviewOutputObserver = (args: {
22
+ sessionId: string;
23
+ workspace: string;
24
+ prNumber: number;
25
+ state: ReviewOutputState;
26
+ } & ReviewResultCoverage) => void | Promise<void>;
27
+ export type VerifiedDismissal = {
28
+ sessionId: string;
29
+ workspace: string;
30
+ prNumber: number;
31
+ commitSha?: string;
32
+ startedAt?: number;
33
+ };
34
+ export declare function observeVerifiedDismissals(observer: (dismissal: VerifiedDismissal) => Promise<void>): () => void;
35
+ export declare function setReviewObserver(observer: ReviewObserver | null): void;
36
+ export declare function setReviewOutputObserver(observer: ReviewOutputObserver | null): void;
37
+ export declare function __resetReviewObserverForTest(): void;
38
+ export declare function resetReviewTurn(sessionId: string): void;
39
+ export declare function recordReview(args: {
40
+ sessionId: string;
41
+ workspace: string;
42
+ prNumber: number;
43
+ verdict: ReviewVerdict;
44
+ commitSha?: string;
45
+ } & ReviewResultCoverage): Promise<void>;
46
+ export declare function recordVerifiedDismissal(args: VerifiedDismissal): Promise<void>;
47
+ export declare function recordReviewOutput(args: {
48
+ sessionId: string;
49
+ workspace: string;
50
+ prNumber: number;
51
+ state: ReviewOutputState;
52
+ } & ReviewResultCoverage): Promise<void>;
53
+ export declare function hasReview(args: {
54
+ sessionId: string;
55
+ workspace: string;
56
+ prNumber: number;
57
+ verdict: ReviewVerdict;
58
+ }): boolean;
59
+ export declare function recordResolvedThread(args: {
60
+ sessionId: string;
61
+ workspace: string;
62
+ prNumber: number;
63
+ rootCommentId: string;
64
+ }): void;
65
+ export declare function hasResolvedThread(args: {
66
+ sessionId: string;
67
+ workspace: string;
68
+ prNumber: number;
69
+ rootCommentId: string;
70
+ }): boolean;
71
+ export {};
@@ -0,0 +1,117 @@
1
+ import type { ReviewVerdict } from "./github-review-turn-ledger.js";
2
+ import type { GithubReviewFollowupRound } from "./types.js";
3
+ export type EffectiveVerdict = 'APPROVED' | 'CHANGES_REQUESTED' | 'DISMISSED' | 'NONE';
4
+ export type EffectiveApprovalResolver = (target: {
5
+ workspace: string;
6
+ prNumber: number;
7
+ }) => Promise<{
8
+ ok: true;
9
+ effective: EffectiveVerdict;
10
+ } | {
11
+ ok: false;
12
+ }>;
13
+ export type HeadShaResolver = (target: {
14
+ workspace: string;
15
+ prNumber: number;
16
+ }) => Promise<string | null>;
17
+ type ReviewVerdictCoordinatorLogger = {
18
+ warn: (message: string) => void;
19
+ };
20
+ export type ApproveBlock = {
21
+ block: true;
22
+ kind: 'concurrent' | 'duplicate' | 'round-ineligible';
23
+ reason: string;
24
+ duplicateSource?: 'standing' | 'recent';
25
+ leaseRetained?: boolean;
26
+ };
27
+ export type ReviewOutputOutcome = 'failed' | 'formal-landed' | 'fallback-landed';
28
+ export type ReviewVerdictGuard = {
29
+ guard: (args: {
30
+ callId: string;
31
+ workspace: string;
32
+ prNumber: number;
33
+ verdict: ReviewVerdict;
34
+ round?: GithubReviewFollowupRound;
35
+ thread?: string | null;
36
+ reviewedHeadSha?: string;
37
+ retainDuplicateLease?: boolean;
38
+ }) => Promise<ApproveBlock | null>;
39
+ release: (args: {
40
+ callId: string;
41
+ outcome: ReviewOutputOutcome;
42
+ }) => Promise<void>;
43
+ noteLandedReview: (args: {
44
+ workspace: string;
45
+ prNumber: number;
46
+ verdict: ReviewVerdict;
47
+ }) => Promise<void>;
48
+ };
49
+ export type ApproveIdempotencyGuard = ReviewVerdictGuard;
50
+ export declare function configureReviewVerdictCoordinator(deps: {
51
+ resolveEffectiveApproval: EffectiveApprovalResolver;
52
+ resolveHeadSha: HeadShaResolver;
53
+ logger?: ReviewVerdictCoordinatorLogger;
54
+ }): void;
55
+ export declare function createSharedReviewVerdictGuard(): ReviewVerdictGuard;
56
+ export declare const REVIEW_ROUND_TTL_MS: number;
57
+ export declare const REPLY_REVIEW_ROUND_TTL_MS: number;
58
+ export declare const RECENT_LANDED_TTL_MS: number;
59
+ type ReviewRoundState = {
60
+ round: GithubReviewFollowupRound;
61
+ status: 'pending' | 'completed';
62
+ createdAt: number;
63
+ attemptedCarriers: Set<string | null>;
64
+ dismissalAttempted: boolean;
65
+ requestChangesAttempted: boolean;
66
+ };
67
+ export declare function githubReviewRoundKey(round: GithubReviewFollowupRound): string;
68
+ export declare function registerOrJoinReplyReviewRound(input: {
69
+ workspace: string;
70
+ prNumber: number;
71
+ headSha: string;
72
+ blockingReviewId: number;
73
+ thread: string;
74
+ now?: () => number;
75
+ generateRoundId?: () => string;
76
+ }): GithubReviewFollowupRound;
77
+ export declare function registerGithubReviewRound(round: GithubReviewFollowupRound, createdAt?: number, now?: () => number): GithubReviewFollowupRound | null;
78
+ export declare function restoreGithubReviewRound(round: GithubReviewFollowupRound, status: ReviewRoundState['status'], attemptedCarriers?: readonly (string | null)[], dismissalAttempted?: boolean, requestChangesAttempted?: boolean, createdAt?: number, now?: () => number): GithubReviewFollowupRound | null;
79
+ export declare function githubReviewRoundPersistence(round: GithubReviewFollowupRound, now?: () => number): {
80
+ status: ReviewRoundState['status'];
81
+ createdAt: number;
82
+ attemptedCarriers: (string | null)[];
83
+ dismissalAttempted?: true;
84
+ requestChangesAttempted?: true;
85
+ } | null;
86
+ export declare function forgetGithubReviewRound(round: GithubReviewFollowupRound): void;
87
+ export declare function completeGithubReviewRound(round: GithubReviewFollowupRound, now?: () => number): void;
88
+ export declare function isGithubReviewRoundComplete(round: GithubReviewFollowupRound, now?: () => number): boolean;
89
+ export declare function isGithubReviewRoundPending(round: GithubReviewFollowupRound, now?: () => number): boolean;
90
+ export declare function promoteGithubReviewRound(round: GithubReviewFollowupRound, carrierThread: string | null, now?: () => number): GithubReviewFollowupRound | null;
91
+ export declare function canPromoteGithubReviewRoundTo(round: GithubReviewFollowupRound, thread: string | null, now?: () => number): boolean;
92
+ export declare function validateGithubReviewRound(round: GithubReviewFollowupRound, createdAt?: number, now?: () => number, landedCommitSha?: string | null): Promise<boolean>;
93
+ export declare function isGithubReviewRoundSuperseded(round: GithubReviewFollowupRound, now?: () => number): boolean;
94
+ export declare function guardGithubReviewRoundDismissal(args: {
95
+ callId: string;
96
+ workspace: string;
97
+ prNumber: number;
98
+ round?: GithubReviewFollowupRound;
99
+ thread?: string | null;
100
+ }): Promise<ApproveBlock | null>;
101
+ export declare function releaseGithubReviewRoundDismissal(callId: string, attempted?: boolean): void;
102
+ export declare function hasGithubReviewRoundDismissalAttempt(round: GithubReviewFollowupRound, now?: () => number): boolean;
103
+ export declare function resetGithubReviewRoundCompletion(round: GithubReviewFollowupRound, now?: () => number): void;
104
+ export declare function resetGithubReviewRoundCompletionForPr(workspace: string, prNumber: number, now?: () => number): GithubReviewFollowupRound | null;
105
+ export declare function abortGithubReviewStateForPr(workspace: string, prNumber: number, now?: () => number): {
106
+ releasedReservations: number;
107
+ deletedRounds: number;
108
+ };
109
+ export declare function createApproveIdempotencyGuard(deps: {
110
+ resolveEffectiveApproval: EffectiveApprovalResolver;
111
+ resolveHeadSha?: HeadShaResolver;
112
+ now?: () => number;
113
+ logger?: ReviewVerdictCoordinatorLogger;
114
+ }): ReviewVerdictGuard;
115
+ export declare function __recentLandedRecordCountForTest(): number;
116
+ export declare function __resetReviewVerdictGuardForTest(): void;
117
+ export {};
@@ -0,0 +1,20 @@
1
+ export type GithubTokenCredential = {
2
+ token: string;
3
+ accountIdentity?: string;
4
+ };
5
+ export type GithubTokenResolveResult = ({
6
+ kind: 'token';
7
+ } & GithubTokenCredential) | {
8
+ kind: 'unavailable';
9
+ reason: string;
10
+ };
11
+ export type ResolveGithubTokenForRepo = (repoSlug: string) => Promise<GithubTokenResolveResult>;
12
+ export type GithubTokenBridge = {
13
+ resolveTokenForRepo: ResolveGithubTokenForRepo;
14
+ hasAppTokenResolver: () => boolean;
15
+ getAppSelfLogin: () => string | null;
16
+ resolvePatForRepo: ResolveGithubTokenForRepo;
17
+ registerPatResolver: (resolver: (repoSlug: string) => Promise<GithubTokenCredential>) => () => void;
18
+ registerResolver: (resolver: (repoSlug: string) => Promise<GithubTokenCredential>, selfLogin?: () => string | null) => () => void;
19
+ };
20
+ export declare function createGithubTokenBridge(): GithubTokenBridge;
@@ -0,0 +1,12 @@
1
+ import type { ReviewRoundOutcome } from "./github-review-turn-ledger.js";
2
+ export type PrVerdictActivityPayload = {
3
+ workspace: string;
4
+ prNumber: number;
5
+ verdict: ReviewRoundOutcome;
6
+ sessionId: string;
7
+ };
8
+ export declare function parsePrVerdictActivityPayload(payload: unknown): PrVerdictActivityPayload | null;
9
+ export declare function renderPrVerdictStandDownReminder(args: {
10
+ prNumber: number;
11
+ verdict: ReviewRoundOutcome;
12
+ }): string;