typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -1,6 +1,10 @@
1
+ import { readFile } from 'node:fs/promises'
2
+ import { basename } from 'node:path'
3
+
1
4
  import {
2
5
  DiscordClient,
3
6
  DiscordListener,
7
+ type DiscordFile,
4
8
  type DiscordGatewayMessageCreateEvent,
5
9
  type DiscordMessage,
6
10
  } from 'agent-messenger/discord'
@@ -18,6 +22,7 @@ import type { MembershipResolver, MembershipResolverResult } from '@/channels/me
18
22
  import { deriveMembershipFromHistory } from '@/channels/membership-from-history'
19
23
  import type { ChannelRouter } from '@/channels/router'
20
24
  import type { ChannelAdapterConfig } from '@/channels/schema'
25
+ import { fallbackChannelAccountIdentity } from '@/channels/types'
21
26
  import type {
22
27
  ChannelHistoryMessage,
23
28
  ChannelSelfIdentityResolver,
@@ -44,6 +49,8 @@ import {
44
49
  } from './discord-classify'
45
50
  import { createDiscordUserEditMessageCallback } from './discord-edit'
46
51
  import { createDiscordReactionCallback, createDiscordRemoveReactionCallback } from './discord-reactions'
52
+ import { createDiscordOwnReactionCallbacks } from './discord-reactions'
53
+ import { withOutboundAccount } from './outbound-account'
47
54
 
48
55
  export type DiscordAdapterLogger = {
49
56
  info: (msg: string) => void
@@ -57,6 +64,8 @@ const consoleLogger: DiscordAdapterLogger = {
57
64
  error: (m) => console.error(m),
58
65
  }
59
66
 
67
+ const DISCORD_API_BASE = 'https://discord.com/api/v10'
68
+
60
69
  export type DiscordCredentialStore = {
61
70
  getAccount(id?: string): Promise<DiscordAccountRecord | null>
62
71
  }
@@ -81,10 +90,15 @@ export type DiscordAdapter = {
81
90
  }
82
91
 
83
92
  export function createDiscordOutboundCallback(deps: {
84
- client: Pick<DiscordClient, 'sendMessage' | 'uploadFile'>
93
+ client: Pick<DiscordClient, 'sendMessage'>
85
94
  logger: DiscordAdapterLogger
86
95
  formatChannelTag: (chat: string) => Promise<string>
96
+ tokenRef: () => string | null
97
+ fetchImpl?: typeof fetch
98
+ sleep?: (ms: number) => Promise<void>
87
99
  }): OutboundCallback {
100
+ const fetchImpl = deps.fetchImpl ?? fetch
101
+ const sleep = deps.sleep ?? ((ms: number) => Bun.sleep(ms))
88
102
  return async (msg: OutboundMessage): Promise<SendResult> => {
89
103
  if (msg.adapter !== 'discord') return { ok: false, error: `unknown adapter: ${msg.adapter}` }
90
104
  const text = msg.text ?? ''
@@ -101,11 +115,20 @@ export function createDiscordOutboundCallback(deps: {
101
115
  const replyOption = (reference: string | undefined): { reply_to: string } | undefined =>
102
116
  reference !== undefined ? { reply_to: reference } : undefined
103
117
  try {
104
- // Attachments first, then text — Discord's upstream uploadFile takes no
105
- // content body, so a failed upload must not leave a text-only message
106
- // already posted (see OutboundMessage.attachments contract).
118
+ // Attachments first, then text, so a failed upload never leaves a
119
+ // text-only message already posted (see OutboundMessage.attachments).
107
120
  for (const [index, attachment] of attachments.entries()) {
108
- await deps.client.uploadFile(msg.chat, attachment.path, replyOption(index === 0 ? replyOnFirstFile : undefined))
121
+ const token = deps.tokenRef()
122
+ if (token === null) throw new Error('discord account is not logged in')
123
+ await uploadDiscordUserFile({
124
+ channelId: msg.chat,
125
+ path: attachment.path,
126
+ filename: attachment.filename ?? (basename(attachment.path) || 'file'),
127
+ replyToId: index === 0 ? replyOnFirstFile : undefined,
128
+ token,
129
+ fetchImpl,
130
+ sleep,
131
+ })
109
132
  }
110
133
  if (text !== '') {
111
134
  const chunks = chunkMarkdown(text, 2_000)
@@ -123,6 +146,69 @@ export function createDiscordOutboundCallback(deps: {
123
146
  }
124
147
  }
125
148
 
149
+ // Raw multipart create-message instead of the SDK's `uploadFile`. The SDK
150
+ // sends only a `files[0]` part and leaves Discord to recover the name from its
151
+ // Content-Disposition header; when Discord can't, the attachment is named by
152
+ // the part index and lands in chat as `0`, `1`, .... Declaring the filename in
153
+ // `payload_json.attachments` (Discord's documented upload shape) is
154
+ // unambiguous UTF-8 JSON, and is also what lets the OutboundAttachment
155
+ // `filename` override reach the chat.
156
+ //
157
+ // Bypassing the SDK also bypasses its per-bucket rate-limit pacing, so a 429
158
+ // is retried here after Discord's Retry-After delay instead of aborting the
159
+ // remaining attachments and text.
160
+ async function uploadDiscordUserFile(args: {
161
+ channelId: string
162
+ path: string
163
+ filename: string
164
+ replyToId: string | undefined
165
+ token: string
166
+ fetchImpl: typeof fetch
167
+ sleep: (ms: number) => Promise<void>
168
+ }): Promise<DiscordFile> {
169
+ const fileBuffer = await readFile(args.path)
170
+ const payload = {
171
+ attachments: [{ id: 0, filename: args.filename }],
172
+ ...(args.replyToId !== undefined ? { message_reference: { message_id: args.replyToId } } : {}),
173
+ }
174
+ for (let attempt = 1; ; attempt++) {
175
+ // FormData bodies are single-use streams, so rebuild per attempt.
176
+ const form = new FormData()
177
+ form.append('payload_json', JSON.stringify(payload))
178
+ form.append('files[0]', new Blob([new Uint8Array(fileBuffer)]), args.filename)
179
+ const response = await args.fetchImpl(`${DISCORD_API_BASE}/channels/${args.channelId}/messages`, {
180
+ method: 'POST',
181
+ headers: { Authorization: args.token },
182
+ body: form,
183
+ })
184
+ if (response.status === 429 && attempt < UPLOAD_MAX_ATTEMPTS) {
185
+ await args.sleep(retryAfterMs(response))
186
+ continue
187
+ }
188
+ if (!response.ok) {
189
+ const body = await response.text().catch(() => '')
190
+ throw new Error(`uploadFile failed: http ${response.status}${body ? `: ${body.slice(0, 200)}` : ''}`)
191
+ }
192
+ const message = (await response.json()) as { attachments?: DiscordFile[] }
193
+ const first = message.attachments?.[0]
194
+ if (first === undefined) throw new Error('uploadFile failed: upload succeeded but no attachments returned')
195
+ return first
196
+ }
197
+ }
198
+
199
+ const UPLOAD_MAX_ATTEMPTS = 3
200
+
201
+ function retryAfterMs(response: Response): number {
202
+ // Number(null) and Number('') are 0, so a missing header must be caught
203
+ // before conversion or it becomes a zero-delay retry.
204
+ const header = response.headers.get('retry-after')?.trim() ?? ''
205
+ const seconds = header === '' ? Number.NaN : Number(header)
206
+ if (!Number.isFinite(seconds) || seconds < 0) return 1_000
207
+ // Honor the full cooldown, as the SDK's own rate-limit handling does: a
208
+ // capped wait retries before the bucket resets and burns the attempts.
209
+ return seconds * 1_000
210
+ }
211
+
126
212
  export function createDiscordHistoryCallback(deps: {
127
213
  client: Pick<DiscordClient, 'getMessages'>
128
214
  logger: DiscordAdapterLogger
@@ -225,7 +311,16 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
225
311
  }
226
312
  const historyCallback = createDiscordHistoryCallback({ client, logger })
227
313
  const membershipResolver = createDiscordMembershipResolver({ historyCallback })
228
- const outboundCallback = createDiscordOutboundCallback({ client, logger, formatChannelTag })
314
+ const outboundCallback = withOutboundAccount(
315
+ createDiscordOutboundCallback({
316
+ client,
317
+ logger,
318
+ formatChannelTag,
319
+ tokenRef: () => token,
320
+ fetchImpl: options.fetchImpl,
321
+ }),
322
+ (workspace) => fallbackChannelAccountIdentity('discord', workspace, selfUserId),
323
+ )
229
324
  const fetchAttachmentCallback = createDiscordFetchAttachmentCallback({
230
325
  tokenRef: () => token,
231
326
  fetchImpl: options.fetchImpl,
@@ -233,13 +328,15 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
233
328
  })
234
329
  const reactionCallback = createDiscordReactionCallback({ client })
235
330
  const removeReactionCallback = createDiscordRemoveReactionCallback({ client })
331
+ const ownReaction = createDiscordOwnReactionCallbacks({ client, identity: async () => (await client.testAuth()).id })
236
332
  const editMessageCallback = createDiscordUserEditMessageCallback({ client })
237
333
 
238
334
  const handleMessage = async (event: DiscordGatewayMessageCreateEvent): Promise<void> => {
335
+ const inboundSelfId = selfUserId
239
336
  inflightInbounds++
240
337
  try {
241
338
  const verdict = classifyInbound(event, options.configRef(), {
242
- selfUserId,
339
+ selfUserId: inboundSelfId,
243
340
  selfAliases: options.selfAliasesRef?.() ?? [],
244
341
  })
245
342
  const tag =
@@ -266,7 +363,12 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
266
363
  ...(attachments.length > 0 ? { attachments } : {}),
267
364
  }
268
365
  logger.info(`[discord] routed id=${event.id} ${tag} mention=${payload.isBotMention}`)
269
- await options.router.route(payload)
366
+ await options.router.route({
367
+ ...payload,
368
+ accountIdentity: fallbackChannelAccountIdentity('discord', payload.workspace, inboundSelfId),
369
+ eventKind: 'message',
370
+ revision: 'original',
371
+ })
270
372
  } catch (err) {
271
373
  logger.error(`[discord] handleInbound failed: ${describeError(err)}`)
272
374
  } finally {
@@ -425,6 +527,8 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
425
527
  router.registerMembership('discord', membershipResolver)
426
528
  router.registerReaction('discord', reactionCallback)
427
529
  router.registerRemoveReaction('discord', removeReactionCallback)
530
+ router.registerPrepareOwnReaction('discord', ownReaction.prepare)
531
+ router.registerRemoveOwnReaction('discord', ownReaction.remove)
428
532
  router.registerEditMessage('discord', editMessageCallback)
429
533
  }
430
534
 
@@ -438,6 +542,8 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
438
542
  router.unregisterMembership('discord', membershipResolver)
439
543
  router.unregisterReaction('discord', reactionCallback)
440
544
  router.unregisterRemoveReaction('discord', removeReactionCallback)
545
+ router.unregisterPrepareOwnReaction('discord', ownReaction.prepare)
546
+ router.unregisterRemoveOwnReaction('discord', ownReaction.remove)
441
547
  router.unregisterEditMessage('discord', editMessageCallback)
442
548
  }
443
549
  }
@@ -1,8 +1,14 @@
1
1
  import { createHmac, randomUUID, timingSafeEqual } from 'node:crypto'
2
2
 
3
+ import { githubReviewChecks } from '@/channels/github-review-check'
3
4
  import { registerOrJoinReplyReviewRound } from '@/channels/github-review-verdict-coordinator'
4
5
  import type { GithubReviewOn } from '@/channels/schema'
5
- import type { GithubReviewFollowupRound, GithubReviewThreadCloseout, InboundMessage } from '@/channels/types'
6
+ import type {
7
+ GithubReviewFollowupRound,
8
+ GithubReviewThreadCloseout,
9
+ InboundMessage,
10
+ RouteReceipt,
11
+ } from '@/channels/types'
6
12
 
7
13
  import { describeError } from '../../describe-error'
8
14
  import type { GithubAuthContext } from './auth'
@@ -38,7 +44,7 @@ export type GithubWebhookHandlerOptions = {
38
44
  // eventAllowlist (the outer "process this webhook?" gate) — this is the inner
39
45
  // "does an admitted pull_request event become a review-trigger inbound?" gate.
40
46
  reviewOn?: () => GithubReviewOn
41
- route: (message: InboundMessage) => void
47
+ route: (message: InboundMessage) => Promise<RouteReceipt>
42
48
  logger: GithubInboundLogger
43
49
  // Optional: resolves whether the bot is a member of the given team. When
44
50
  // omitted, team-reviewer requests are silently dropped (the v1 fallback
@@ -63,6 +69,8 @@ export type GithubWebhookHandlerOptions = {
63
69
  | { kind: 'no-live-session' }
64
70
  >
65
71
  clearReconcileCooldown?: (workspace: string, prId: number) => Promise<'cleared' | 'not-initialized'>
72
+ clearPendingReview?: (workspace: string, prNumber: number) => Promise<void>
73
+ reviewSubmitted?: (review: { repo: string; prNumber: number; headSha: string; submittedAt: number }) => Promise<void>
66
74
  }
67
75
 
68
76
  export const GITHUB_REVIEW_STATE_UNKNOWN_TTL_MS = 2 * 60_000
@@ -107,6 +115,31 @@ export async function processVerifiedGithubDelivery(
107
115
  ): Promise<void> {
108
116
  const { event, delivery, payload } = input
109
117
  const action = readString(payload, 'action')
118
+ // Completion bookkeeping is independent of the conversational event allowlist.
119
+ // In particular, self-authored reviews are deliberately never routed.
120
+ const repository = readRepository(payload)
121
+ const pr = readRecord(payload.pull_request)
122
+ const prNumber = readNumber(pr, 'number')
123
+ if (repository !== null && prNumber !== null) {
124
+ const repo = `${repository.owner}/${repository.name}`
125
+ if (event === 'pull_request' && action === 'closed') {
126
+ await options.clearPendingReview?.(repo, prNumber)
127
+ }
128
+ if (event === 'pull_request_review' && action === 'submitted') {
129
+ const review = readRecord(payload.review)
130
+ const reviewer = readUser(review?.user)
131
+ const headSha = readString(review, 'commit_id')
132
+ const submittedAt = Date.parse(readString(review, 'submitted_at') ?? '')
133
+ if (
134
+ reviewer !== null &&
135
+ isSelfAuthor(reviewer, options.selfId(), options.selfLogin()) &&
136
+ headSha !== null &&
137
+ Number.isFinite(submittedAt)
138
+ ) {
139
+ await options.reviewSubmitted?.({ repo, prNumber, headSha, submittedAt })
140
+ }
141
+ }
142
+ }
110
143
  const eventAllowed = isGithubEventAllowed(options.allowlist(), event, action)
111
144
  let staleRecoveredDraft = false
112
145
  if (input.recovered === true && eventAllowed && event === 'pull_request' && action === 'converted_to_draft') {
@@ -153,7 +186,9 @@ export async function processVerifiedGithubDelivery(
153
186
  return
154
187
  }
155
188
  const workspace = `${repository.owner}/${repository.name}`
189
+ await options.clearPendingReview?.(workspace, prNumber)
156
190
  invalidateGithubReviewSubmission(workspace, prNumber)
191
+ void githubReviewChecks.cancelPullRequest(workspace, prNumber, 'the pull request was converted to draft')
157
192
  scheduleDraftAbort({ workspace, prNumber, prId: readNumber(pr, 'id'), options })
158
193
  return
159
194
  }
@@ -178,7 +213,7 @@ export async function processVerifiedGithubDelivery(
178
213
  // session when an obligation is outstanding. Returning here also keeps
179
214
  // synchronize out of the generic awareness-only fallthrough below.
180
215
  if (isSynchronize) {
181
- scheduleReviewFollowup({ payload, selfLogin, options })
216
+ scheduleReviewFollowup({ payload, selfId, selfLogin, options })
182
217
  return
183
218
  }
184
219
 
@@ -192,6 +227,12 @@ export async function processVerifiedGithubDelivery(
192
227
  ...(reviewCommentParent !== null ? { reviewCommentParent } : {}),
193
228
  })
194
229
  if (classified === null) return
230
+ if (event === 'pull_request' && action === 'review_request_removed') {
231
+ const prNumber = readNumber(readRecord(payload.pull_request), 'number')
232
+ if (prNumber !== null) {
233
+ void githubReviewChecks.cancelPullRequest(classified.workspace, prNumber, 'the review request was removed')
234
+ }
235
+ }
195
236
 
196
237
  const routed =
197
238
  replyReviewRound?.kind === 'round'
@@ -206,7 +247,23 @@ export async function processVerifiedGithubDelivery(
206
247
  }
207
248
  : classified
208
249
 
209
- options.route(withApprovalPolicy(routed, options.allowApprove?.() ?? true))
250
+ // GitHub transport acknowledgment is not a durable admission receipt.
251
+ void Promise.resolve()
252
+ .then(() =>
253
+ options.route(
254
+ withApprovalPolicy(
255
+ {
256
+ ...routed,
257
+ receiptId: delivery,
258
+ accountIdentity: selfId === null ? undefined : `github:${selfId}`,
259
+ },
260
+ options.allowApprove?.() ?? true,
261
+ ),
262
+ ),
263
+ )
264
+ .catch((error: unknown) => {
265
+ options.logger.error(`[github] route failed: ${describeError(error)}`)
266
+ })
210
267
  }
211
268
 
212
269
  export const PR_APPROVAL_DISABLED_NOTE =
@@ -433,10 +490,11 @@ function reviewFollowupDedup(options: GithubWebhookHandlerOptions): ReviewFollow
433
490
 
434
491
  function scheduleReviewFollowup(input: {
435
492
  payload: Record<string, unknown>
493
+ selfId: string | null
436
494
  selfLogin: string | null
437
495
  options: GithubWebhookHandlerOptions
438
496
  }): void {
439
- const { payload, selfLogin, options } = input
497
+ const { payload, selfId, selfLogin, options } = input
440
498
  if (selfLogin === null) return
441
499
  const authToken = options.authToken
442
500
  if (authToken === undefined) return
@@ -511,16 +569,18 @@ function scheduleReviewFollowup(input: {
511
569
  if (threads.threads.length === 0) {
512
570
  if (selfBlocking) {
513
571
  const round = buildReviewRound(repository, pullNumber, headSha, null, generateReviewRoundId)
514
- options.route(
572
+ await options.route(
515
573
  withApprovalPolicy(
516
574
  buildReviewFollowupInbound({
517
575
  repository,
518
576
  pullNumber,
519
577
  headSha,
578
+ prId: readNumber(pr, 'id') ?? pullNumber,
520
579
  thread: null,
521
580
  selfBlocking: true,
522
581
  round,
523
582
  title: readString(pr, 'title'),
583
+ accountIdentity: selfId === null ? undefined : `github:${selfId}`,
524
584
  }),
525
585
  options.allowApprove?.() ?? true,
526
586
  true,
@@ -545,16 +605,18 @@ function scheduleReviewFollowup(input: {
545
605
  // sibling PR session by injectPrVerdictActivity, while asking all of them
546
606
  // to submit it would recreate a cross-session verdict race.
547
607
  const carriesBlockingObligation = selfBlocking && index === 0
548
- options.route(
608
+ await options.route(
549
609
  withApprovalPolicy(
550
610
  buildReviewFollowupInbound({
551
611
  repository,
552
612
  pullNumber,
553
613
  headSha,
614
+ prId: readNumber(pr, 'id') ?? pullNumber,
554
615
  thread,
555
616
  selfBlocking: carriesBlockingObligation,
556
617
  ...(round !== undefined ? { round } : {}),
557
618
  title: readString(pr, 'title'),
619
+ accountIdentity: selfId === null ? undefined : `github:${selfId}`,
558
620
  }),
559
621
  options.allowApprove?.() ?? true,
560
622
  carriesBlockingObligation,
@@ -593,10 +655,12 @@ function buildReviewFollowupInbound(input: {
593
655
  repository: { owner: string; name: string }
594
656
  pullNumber: number
595
657
  headSha: string
658
+ prId: number
596
659
  thread: UnresolvedSelfReviewThread | null
597
660
  selfBlocking: boolean
598
661
  round?: GithubReviewFollowupRound
599
662
  title: string | null
663
+ accountIdentity?: string
600
664
  }): InboundMessage {
601
665
  const { repository, pullNumber, headSha, thread, selfBlocking, round, title } = input
602
666
  const titleSegment = title !== null && title.trim() !== '' ? `: "${title}"` : ''
@@ -610,8 +674,14 @@ function buildReviewFollowupInbound(input: {
610
674
  chat: `pr:${pullNumber}`,
611
675
  thread: thread === null ? null : String(thread.rootCommentId),
612
676
  ...(round !== undefined ? { githubReviewRound: round } : {}),
677
+ ...(selfBlocking ? { githubPendingReview: { prId: input.prId, headSha, kind: 'rereview' as const } } : {}),
613
678
  text,
614
679
  externalMessageId: `pr-${pullNumber}-recheck-${headSha}${thread === null ? '' : `-thread-${thread.rootCommentId}`}`,
680
+ eventKind: 'pull_request:synchronize:review-followup',
681
+ // Verdict coordination round IDs are attempt-local. Durable admission uses
682
+ // the platform head revision, stable across partial retries and redelivery.
683
+ revision: headSha,
684
+ accountIdentity: input.accountIdentity,
615
685
  authorId: 'github-system',
616
686
  authorName: 'github',
617
687
  authorIsBot: false,
@@ -641,7 +711,7 @@ function buildReviewRound(
641
711
  }
642
712
  }
643
713
 
644
- function followupInstruction(thread: UnresolvedSelfReviewThread | null, selfBlocking: boolean): string {
714
+ export function followupInstruction(thread: UnresolvedSelfReviewThread | null, selfBlocking: boolean): string {
645
715
  const threadPart =
646
716
  thread !== null
647
717
  ? `This session is scoped to one unresolved review thread you authored. Check whether the new commits ` +
@@ -679,6 +749,22 @@ export async function verifySignature(body: string, secret: string, sigHeader: s
679
749
  return timingSafeEqual(a, b)
680
750
  }
681
751
 
752
+ function githubEventRevision(payload: Record<string, unknown>): string {
753
+ const subject =
754
+ readRecord(payload.comment) ??
755
+ readRecord(payload.review) ??
756
+ readRecord(payload.pull_request) ??
757
+ readRecord(payload.issue) ??
758
+ readRecord(payload.discussion)
759
+ const head = readRecord(readRecord(payload.pull_request)?.head)
760
+ const reviewer = readRecord(payload.requested_reviewer) ?? readRecord(payload.requested_team)
761
+ return JSON.stringify([
762
+ readString(subject, 'updated_at') ?? readString(subject, 'submitted_at') ?? readString(subject, 'created_at'),
763
+ readString(head, 'sha'),
764
+ readNumber(reviewer, 'id'),
765
+ ])
766
+ }
767
+
682
768
  export function classifyGithubInbound(
683
769
  event: string,
684
770
  payload: Record<string, unknown>,
@@ -696,6 +782,8 @@ export function classifyGithubInbound(
696
782
  const base = {
697
783
  adapter: 'github' as const,
698
784
  workspace: `${repository.owner}/${repository.name}`,
785
+ eventKind: `${event}:${readString(payload, 'action') ?? 'event'}`,
786
+ revision: githubEventRevision(payload),
699
787
  isDm: false,
700
788
  mentionsOthers: false,
701
789
  replyToOtherMessageId: null,
@@ -1073,6 +1161,7 @@ function classifyReviewRequest(input: ReviewRequestInput): InboundMessage | null
1073
1161
  thread: null,
1074
1162
  text,
1075
1163
  externalMessageId,
1164
+ ...(action === 'review_requested' ? pendingReviewMetadata(pr, prId) : {}),
1076
1165
  authorId: String(sender.id),
1077
1166
  authorName: sender.login,
1078
1167
  authorIsBot: sender.type === 'Bot',
@@ -1120,6 +1209,7 @@ function classifyOpenedReviewTrigger(input: OpenedReviewTriggerInput): InboundMe
1120
1209
  thread: null,
1121
1210
  text,
1122
1211
  externalMessageId,
1212
+ ...pendingReviewMetadata(pr, prId),
1123
1213
  authorId: String(sender.id),
1124
1214
  authorName: sender.login,
1125
1215
  authorIsBot: sender.type === 'Bot',
@@ -1129,6 +1219,11 @@ function classifyOpenedReviewTrigger(input: OpenedReviewTriggerInput): InboundMe
1129
1219
  }
1130
1220
  }
1131
1221
 
1222
+ function pendingReviewMetadata(pr: Record<string, unknown>, prId: number): Pick<InboundMessage, 'githubPendingReview'> {
1223
+ const headSha = readString(readRecord(pr.head), 'sha')
1224
+ return headSha === null ? {} : { githubPendingReview: { prId, headSha, kind: 'review' } }
1225
+ }
1226
+
1132
1227
  export type GithubReviewerTeam = { slug: string; id: number; org: string | null }
1133
1228
 
1134
1229
  export function readReviewerTeam(value: unknown): GithubReviewerTeam | null {