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,4 +1,5 @@
1
1
  import { readFile } from 'node:fs/promises'
2
+ import { basename } from 'node:path'
2
3
 
3
4
  import { DiscordBotClient, DiscordBotListener, type DiscordBotListenerOptions } from 'agent-messenger/discordbot'
4
5
  import {
@@ -14,6 +15,7 @@ import {
14
15
  enrichHistoricalProvenance,
15
16
  type HistoricalProvenanceResolver,
16
17
  } from '@/bundled-plugins/memory/provenance-index'
18
+ import { CATCH_UP_CONVERSATION_LIMIT, type ListMissedInbound, type MissedInbound } from '@/channels/catch-up'
17
19
  import {
18
20
  DEFAULT_ATTACHMENT_MAX_BYTES,
19
21
  readAttachmentErrorSnippet,
@@ -30,6 +32,7 @@ import type { ChannelRouter } from '@/channels/router'
30
32
  import type { ChannelAdapterConfig } from '@/channels/schema'
31
33
  import type {
32
34
  ChannelHistoryMessage,
35
+ ChannelKey,
33
36
  ChannelListEntry,
34
37
  ChannelSelfIdentityResolver,
35
38
  FetchAttachmentCallback,
@@ -65,6 +68,7 @@ import {
65
68
  createDiscordRemoveReactionCallback,
66
69
  encodeDiscordReactionRef,
67
70
  } from './discord-bot-reactions'
71
+ import { createDiscordOwnReactionCallbacks } from './discord-bot-reactions'
68
72
  import { enrichDiscordMessageReferences } from './discord-bot-reference'
69
73
  import {
70
74
  ackInteraction,
@@ -74,6 +78,8 @@ import {
74
78
  } from './discord-bot-slash-commands'
75
79
  import { createDiscordThreadRoomResolver } from './discord-bot-thread-room'
76
80
  import { addDiscordMentionHints, type DiscordMentionUser } from './mention-hints'
81
+ import { withOutboundAccount } from './outbound-account'
82
+ import { createBotRecoveryCallbacks, sendBotRecovery } from './recovery-correlation'
77
83
 
78
84
  // One declared slash command per logical agent gesture. /stop maps to the
79
85
  // existing channel-command of the same name in the router. Adding new
@@ -544,6 +550,8 @@ type DiscordRawHistoryMessage = {
544
550
  content: string
545
551
  timestamp: string
546
552
  mentions?: DiscordMentionUser[]
553
+ mention_everyone?: boolean
554
+ mention_roles?: string[]
547
555
  message_reference?: { message_id?: string; channel_id?: string }
548
556
  attachments?: DiscordFile[]
549
557
  embeds?: DiscordGatewayEmbed[]
@@ -578,10 +586,7 @@ export function createDiscordHistoryCallback(deps: {
578
586
  let raw: DiscordRawHistoryMessage[]
579
587
  let response: Response
580
588
  try {
581
- response = await fetchFn(`${DISCORD_API_BASE}/channels/${channelId}/messages?${params.toString()}`, {
582
- method: 'GET',
583
- headers: { Authorization: `Bot ${token}` },
584
- })
589
+ response = await fetchDiscordHistoryPage(token, fetchFn, channelId, params)
585
590
  } catch (err) {
586
591
  const message = describeError(err)
587
592
  logger.warn(`[discord-bot] history fetch failed: ${message}`)
@@ -613,6 +618,79 @@ export function createDiscordHistoryCallback(deps: {
613
618
  }
614
619
  }
615
620
 
621
+ function fetchDiscordHistoryPage(token: string, fetchFn: typeof fetch, channelId: string, params: URLSearchParams) {
622
+ return fetchFn(`${DISCORD_API_BASE}/channels/${channelId}/messages?${params.toString()}`, {
623
+ method: 'GET',
624
+ headers: { Authorization: `Bot ${token}` },
625
+ })
626
+ }
627
+
628
+ export function createDiscordMissedInboundCallback(deps: {
629
+ token: string
630
+ logger: DiscordBotAdapterLogger
631
+ configRef: () => ChannelAdapterConfig
632
+ botUserIdRef: () => string | null
633
+ targets: () => Promise<readonly ChannelKey[]>
634
+ room: (chat: string) => Promise<import('@/channels/types').InboundMessage['room']>
635
+ fetchImpl?: typeof fetch
636
+ }): ListMissedInbound {
637
+ const fetchFn = deps.fetchImpl ?? fetch
638
+ return async (since) => {
639
+ const botUserId = deps.botUserIdRef()
640
+ if (botUserId === null) return []
641
+ const result: MissedInbound[] = []
642
+ const targets = new Map((await deps.targets()).map((key) => [key.chat, key]))
643
+ // Only previously watched conversations: never enumerate every guild
644
+ // channel the token happens to be able to read. Threads are channels too.
645
+ for (const key of [...targets.values()].slice(0, CATCH_UP_CONVERSATION_LIMIT)) {
646
+ const response = await fetchDiscordHistoryPage(
647
+ deps.token,
648
+ fetchFn,
649
+ key.chat,
650
+ new URLSearchParams({ limit: '100' }),
651
+ )
652
+ if (!response.ok) {
653
+ deps.logger.warn(`[discord-bot] catch-up history ${key.chat} failed: http ${response.status}`)
654
+ if (response.status === 403 || response.status === 404) continue
655
+ throw new Error(`Discord catch-up history http ${response.status}`)
656
+ }
657
+ const rows = (await response.json()) as DiscordRawHistoryMessage[]
658
+ const latestTs = Math.max(0, ...rows.map((row) => Date.parse(row.timestamp)).filter(Number.isFinite))
659
+ const room = key.workspace === '@dm' ? undefined : await deps.room(key.chat)
660
+ for (const row of rows) {
661
+ if (Date.parse(row.timestamp) < since) continue
662
+ const verdict = classifyInbound(
663
+ {
664
+ ...row,
665
+ type: 'MESSAGE_CREATE',
666
+ ...(key.workspace === '@dm' ? {} : { guild_id: key.workspace }),
667
+ author: { ...row.author, username: row.author.username ?? row.author.id },
668
+ mentions: row.mentions?.map((user) => ({
669
+ id: user.id,
670
+ username: user.username ?? user.id,
671
+ global_name: user.global_name ?? undefined,
672
+ })),
673
+ },
674
+ deps.configRef(),
675
+ botUserId,
676
+ )
677
+ if (verdict.kind !== 'route') continue
678
+ result.push({
679
+ message: {
680
+ ...verdict.payload,
681
+ room,
682
+ accountIdentity: `discord-bot:${botUserId}`,
683
+ eventKind: 'message',
684
+ revision: 'original',
685
+ },
686
+ latestTs,
687
+ })
688
+ }
689
+ }
690
+ return result.sort((a, b) => a.message.ts - b.message.ts)
691
+ }
692
+ }
693
+
616
694
  // Fetch one message via GET /channels/{id}/messages/{message_id}. Reuses
617
695
  // mapDiscordMessage so a single message renders identically to a history entry.
618
696
  // A 404 from Discord (deleted/unknown id) maps to a soft not-found.
@@ -748,15 +826,22 @@ function clampLimit(requested: number, max: number): number {
748
826
  return Math.min(Math.floor(requested), max)
749
827
  }
750
828
 
751
- // Discord-side asymmetry: agent-messenger's upstream `uploadFile` posts the
752
- // file to `POST /channels/{id}/messages` as a multipart-only request. It does
753
- // not accept a `content` body or a `thread_id`. So when the agent wants to
754
- // send "text + file together in a thread", we cannot do it in one round-trip
755
- // the way Slack can. Compromise that preserves observable intent without
756
- // patching upstream:
757
- // 1. Upload each attachment individually via uploadFile(chat, path).
758
- // Files land in channel root even when the session is in a thread —
759
- // logged as a warning so it shows up in operator triage.
829
+ // Every file goes through a raw multipart create-message (uploadDiscordFile)
830
+ // rather than agent-messenger's `uploadFile`. The SDK sends only the
831
+ // `files[0]` part and relies on Discord parsing the filename out of the
832
+ // Content-Disposition header; Discord's attachment pipeline does not reliably
833
+ // recover non-ASCII filenames from that header and falls back to the part
834
+ // index, so files land as `0`, `1`, ... in the chat. Declaring the filename in
835
+ // `payload_json.attachments` (the documented shape, matching what discord.js
836
+ // sends) is unambiguous UTF-8 JSON. It is also the only way to honor the
837
+ // OutboundAttachment `filename` override and to attach a `message_reference`.
838
+ //
839
+ // Discord-side asymmetry: a file upload here does not accept a `thread_id`, so
840
+ // "text + file together in a thread" cannot happen in one round-trip the way
841
+ // Slack can. Compromise that preserves observable intent:
842
+ // 1. Upload each attachment individually. Files land in channel root even
843
+ // when the session is in a thread — logged as a warning so it shows up in
844
+ // operator triage.
760
845
  // 2. After uploads, if `text` was provided, send it via sendMessage with
761
846
  // thread_id when applicable. Text DOES get the thread, file does not.
762
847
  // Failure semantics: if any upload fails, we abort and return ok:false with
@@ -764,29 +849,29 @@ function clampLimit(requested: number, max: number): number {
764
849
  // part of the message). The text post is best-effort and only attempted
765
850
  // after every upload succeeds.
766
851
  //
767
- // Native reply on an attachment-only send: the SDK's `uploadFile` cannot carry
768
- // a `message_reference`, so a reply-arrow on a pure-attachment reply is
769
- // impossible through it. When `msg.replyTo` is set AND there is no text send to
770
- // carry the reference, the FIRST file upload goes through a raw multipart POST
771
- // with a `payload_json.message_reference` instead (uploadFirstFileWithReply) so
772
- // the file message itself is the native reply. Only the first file carries it —
773
- // otherwise Discord renders one reply-arrow per attachment. Remaining files, and
774
- // every upload on a send that also has text (the text send carries the
775
- // reference), stay on the SDK path.
852
+ // Native reply on an attachment-only send: when `msg.replyTo` is set AND there
853
+ // is no text send to carry the reference, the FIRST file upload carries
854
+ // `payload_json.message_reference` so the file message itself is the native
855
+ // reply. Only the first file carries it — otherwise Discord renders one
856
+ // reply-arrow per attachment. On a send that also has text, the text send
857
+ // carries the reference instead.
776
858
  export function createOutboundCallback(deps: {
777
- client: Pick<DiscordBotClient, 'sendMessage' | 'uploadFile'>
859
+ client: Pick<DiscordBotClient, 'sendMessage'>
778
860
  logger: DiscordBotAdapterLogger
779
861
  formatChannelTag: (workspace: string, chat: string) => Promise<string>
780
862
  token: string
781
863
  resolvePath?: (path: string) => string
782
864
  fetchImpl?: typeof fetch
865
+ sleep?: (ms: number) => Promise<void>
783
866
  }): OutboundCallback {
784
867
  const { client, logger, formatChannelTag, token, resolvePath } = deps
785
868
  const fetchImpl = deps.fetchImpl ?? fetch
869
+ const sleep = deps.sleep ?? ((ms: number) => Bun.sleep(ms))
786
870
  return async (msg: OutboundMessage): Promise<SendResult> => {
787
871
  if (msg.adapter !== 'discord-bot') {
788
872
  return { ok: false, error: `unknown adapter: ${msg.adapter}` }
789
873
  }
874
+ if (msg.sendOptions?.accounting === 'recovery') return sendBotRecovery('discord-bot', token, msg, fetchImpl)
790
875
  const text = convertDiscordTables(msg.text ?? '')
791
876
  const attachments = msg.attachments ?? []
792
877
  if (text === '' && attachments.length === 0) {
@@ -804,23 +889,22 @@ export function createOutboundCallback(deps: {
804
889
 
805
890
  for (const [index, attachment] of attachments.entries()) {
806
891
  const path = resolvePath ? resolvePath(attachment.path) : attachment.path
807
- const referenceThisFile = index === 0 ? replyOnFirstFile : undefined
892
+ const filename = attachment.filename ?? basenameOf(attachment.path)
808
893
  try {
809
- const file =
810
- referenceThisFile !== undefined
811
- ? await uploadFirstFileWithReply({
812
- channelId: msg.chat,
813
- path,
814
- replyToId: referenceThisFile,
815
- token,
816
- fetchImpl,
817
- })
818
- : await client.uploadFile(msg.chat, path)
894
+ const file = await uploadDiscordFile({
895
+ channelId: msg.chat,
896
+ path,
897
+ filename,
898
+ replyToId: index === 0 ? replyOnFirstFile : undefined,
899
+ token,
900
+ fetchImpl,
901
+ sleep,
902
+ })
819
903
  logger.info(`[discord-bot] uploaded id=${file.id} filename=${file.filename} size=${file.size} ${tag}`)
820
904
  if (msg.thread) {
821
905
  logger.warn(
822
906
  `[discord-bot] uploaded file landed in channel root, not thread ${msg.thread}: ` +
823
- 'agent-messenger uploadFile does not accept thread_id',
907
+ 'file uploads do not accept thread_id',
824
908
  )
825
909
  }
826
910
  } catch (err) {
@@ -862,41 +946,64 @@ type DiscordCreateMessageWithAttachments = {
862
946
  attachments?: DiscordFile[]
863
947
  }
864
948
 
865
- // Raw multipart create-message so a pure-attachment reply carries a native
866
- // `message_reference`. Mirrors the SDK's `uploadFile` wire shape (`files[0]`)
867
- // and adds a `payload_json` field — Discord merges JSON body fields from
868
- // `payload_json` with the multipart file parts, which is the only documented
869
- // way to attach `message_reference` to a file upload. Returns the created
870
- // message's first attachment as a `DiscordFile`, matching `client.uploadFile`
871
- // so the caller's logging/typing is identical on both paths.
872
- async function uploadFirstFileWithReply(args: {
949
+ const UPLOAD_MAX_ATTEMPTS = 3
950
+
951
+ function basenameOf(path: string): string {
952
+ return basename(path) || 'file'
953
+ }
954
+
955
+ async function uploadDiscordFile(args: {
873
956
  channelId: string
874
957
  path: string
875
- replyToId: string
958
+ filename: string
959
+ replyToId: string | undefined
876
960
  token: string
877
961
  fetchImpl: typeof fetch
962
+ sleep: (ms: number) => Promise<void>
878
963
  }): Promise<DiscordFile> {
879
964
  const fileBuffer = await readFile(args.path)
880
- const filename = args.path.split('/').pop() ?? 'file'
881
- const form = new FormData()
882
- form.append('payload_json', JSON.stringify({ message_reference: { message_id: args.replyToId } }))
883
- form.append('files[0]', new Blob([new Uint8Array(fileBuffer)]), filename)
884
-
885
- const response = await args.fetchImpl(`${DISCORD_API_BASE}/channels/${args.channelId}/messages`, {
886
- method: 'POST',
887
- headers: { Authorization: `Bot ${args.token}` },
888
- body: form,
889
- })
890
- if (!response.ok) {
891
- const body = await response.text().catch(() => '')
892
- throw new Error(`http ${response.status}${body ? `: ${body.slice(0, 200)}` : ''}`)
965
+ const payload = {
966
+ attachments: [{ id: 0, filename: args.filename }],
967
+ ...(args.replyToId !== undefined ? { message_reference: { message_id: args.replyToId } } : {}),
893
968
  }
894
- const message = (await response.json()) as DiscordCreateMessageWithAttachments
895
- const first = message.attachments?.[0]
896
- if (first === undefined) {
897
- throw new Error('upload succeeded but no attachments returned')
969
+ for (let attempt = 1; ; attempt++) {
970
+ // FormData bodies are single-use streams, so rebuild per attempt.
971
+ const form = new FormData()
972
+ form.append('payload_json', JSON.stringify(payload))
973
+ form.append('files[0]', new Blob([new Uint8Array(fileBuffer)]), args.filename)
974
+ const response = await args.fetchImpl(`${DISCORD_API_BASE}/channels/${args.channelId}/messages`, {
975
+ method: 'POST',
976
+ headers: { Authorization: `Bot ${args.token}` },
977
+ body: form,
978
+ })
979
+ // The SDK upload path this replaced retried rate limits; keep that so a
980
+ // burst of attachments doesn't fail the whole send on the first 429.
981
+ if (response.status === 429 && attempt < UPLOAD_MAX_ATTEMPTS) {
982
+ await args.sleep(retryAfterMs(response))
983
+ continue
984
+ }
985
+ if (!response.ok) {
986
+ const body = await response.text().catch(() => '')
987
+ throw new Error(`http ${response.status}${body ? `: ${body.slice(0, 200)}` : ''}`)
988
+ }
989
+ const message = (await response.json()) as DiscordCreateMessageWithAttachments
990
+ const first = message.attachments?.[0]
991
+ if (first === undefined) {
992
+ throw new Error('upload succeeded but no attachments returned')
993
+ }
994
+ return first
898
995
  }
899
- return first
996
+ }
997
+
998
+ function retryAfterMs(response: Response): number {
999
+ // Number(null) and Number('') are 0, so a missing header must be caught
1000
+ // before conversion or it becomes a zero-delay retry.
1001
+ const header = response.headers.get('retry-after')?.trim() ?? ''
1002
+ const seconds = header === '' ? Number.NaN : Number(header)
1003
+ if (!Number.isFinite(seconds) || seconds < 0) return 1_000
1004
+ // Honor the full cooldown, as the SDK's own rate-limit handling does: a
1005
+ // capped wait retries before the bucket resets and burns the attempts.
1006
+ return seconds * 1_000
900
1007
  }
901
1008
 
902
1009
  // Discord CDN URLs (`cdn.discordapp.com/attachments/...`) are signed and
@@ -1046,6 +1153,9 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1046
1153
  options.createListener ?? ((client, listenerOptions) => new DiscordBotListener(client, listenerOptions))
1047
1154
  const client = createClient()
1048
1155
  const fetchImpl = options.fetchImpl ?? fetch
1156
+ const recoveryCallbacks = createBotRecoveryCallbacks('discord-bot', options.token, fetchImpl, () =>
1157
+ botUserId !== null ? `discord-bot:${botUserId}` : undefined,
1158
+ )
1049
1159
  let listener: DiscordBotListener | null = null
1050
1160
  let botUserId: string | null = null
1051
1161
  let connected = false
@@ -1087,6 +1197,15 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1087
1197
  })
1088
1198
 
1089
1199
  const listCallback = createDiscordListCallback({ token: options.token, logger })
1200
+ const missedInbound = createDiscordMissedInboundCallback({
1201
+ token: options.token,
1202
+ logger,
1203
+ configRef: options.configRef,
1204
+ fetchImpl,
1205
+ botUserIdRef: () => botUserId,
1206
+ targets: () => options.router.catchUpTargets('discord-bot'),
1207
+ room: threadRoomResolver,
1208
+ })
1090
1209
 
1091
1210
  const membershipResolver = createDiscordMembershipResolver({
1092
1211
  token: options.token,
@@ -1094,18 +1213,22 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1094
1213
  historyCallback,
1095
1214
  })
1096
1215
 
1097
- const outboundCallback = createOutboundCallback({
1098
- client,
1099
- logger,
1100
- formatChannelTag,
1101
- token: options.token,
1102
- fetchImpl,
1103
- })
1216
+ const outboundCallback = withOutboundAccount(
1217
+ createOutboundCallback({
1218
+ client,
1219
+ logger,
1220
+ formatChannelTag,
1221
+ token: options.token,
1222
+ fetchImpl,
1223
+ }),
1224
+ (workspace) => recoveryCallbacks.cachedAccountIdentity?.(workspace),
1225
+ )
1104
1226
 
1105
1227
  const fetchAttachmentCallback = createFetchAttachmentCallback({ token: options.token, logger })
1106
1228
 
1107
1229
  const reactionCallback = createDiscordReactionCallback({ client })
1108
1230
  const removeReactionCallback = createDiscordRemoveReactionCallback({ client })
1231
+ const ownReaction = createDiscordOwnReactionCallbacks({ client, identity: async () => (await client.testAuth()).id })
1109
1232
  const editMessageCallback = createDiscordEditMessageCallback({ client })
1110
1233
 
1111
1234
  const interactionHandler = createInteractionHandler({
@@ -1131,6 +1254,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1131
1254
  }
1132
1255
 
1133
1256
  const handleMessageCreate = async (event: DiscordGatewayMessageCreateEvent): Promise<void> => {
1257
+ const inboundBotId = botUserId
1134
1258
  inflightInbounds++
1135
1259
  try {
1136
1260
  // One log line per gateway event is non-negotiable: it's the only way to
@@ -1142,7 +1266,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1142
1266
  `[discord-bot] inbound id=${event.id} author=${formatLabel(event.author.username, event.author.id)} ${inboundTag} content_len=${event.content.length}`,
1143
1267
  )
1144
1268
 
1145
- const verdict = classifyInbound(event, options.configRef(), botUserId)
1269
+ const verdict = classifyInbound(event, options.configRef(), inboundBotId)
1146
1270
  if (verdict.kind === 'drop') {
1147
1271
  logger.info(`[discord-bot] dropped id=${event.id} reason=${verdict.reason}${dropHint(verdict.reason)}`)
1148
1272
  return
@@ -1189,7 +1313,12 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1189
1313
  logger.info(
1190
1314
  `[discord-bot] routed id=${event.id} ${routedTag} mention=${payload.isBotMention} reply=${payload.replyToBotMessageId !== null}`,
1191
1315
  )
1192
- await options.router.route(payload)
1316
+ await options.router.route({
1317
+ ...payload,
1318
+ accountIdentity: inboundBotId === null ? undefined : `discord-bot:${inboundBotId}`,
1319
+ eventKind: 'message',
1320
+ revision: 'original',
1321
+ })
1193
1322
  } catch (err) {
1194
1323
  logger.error(`[discord-bot] handleInbound failed: ${describeError(err)}`)
1195
1324
  } finally {
@@ -1218,6 +1347,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1218
1347
  listener.on('connected', (info) => {
1219
1348
  connected = true
1220
1349
  botUserId = info.user.id
1350
+ if (started) void options.router.catchUp('discord-bot')
1221
1351
  logger.info(`[discord-bot] connected as ${info.user.username} (${info.user.id})`)
1222
1352
  // For bots, the gateway's user.id IS the application id — the same
1223
1353
  // value is required for both /me lookups and /applications/{id}/
@@ -1249,6 +1379,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1249
1379
  })
1250
1380
  listener.on('disconnected', () => {
1251
1381
  connected = false
1382
+ options.router.disconnectCatchUp('discord-bot')
1252
1383
  logger.warn('[discord-bot] disconnected; SDK will reconnect with backoff')
1253
1384
  })
1254
1385
  listener.on('error', (err) => {
@@ -1256,7 +1387,10 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1256
1387
  // when a terminal Gateway close stops the listener. Match that
1257
1388
  // distinct SDK error contract without treating transient transport
1258
1389
  // errors as disconnects.
1259
- if (isTerminalGatewayClose(err)) connected = false
1390
+ if (isTerminalGatewayClose(err)) {
1391
+ connected = false
1392
+ options.router.disconnectCatchUp('discord-bot')
1393
+ }
1260
1394
  logger.error(`[discord-bot] gateway error: ${describeError(err)}`)
1261
1395
  })
1262
1396
  listener.on('message_create', (event) => {
@@ -1267,13 +1401,17 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1267
1401
  })
1268
1402
 
1269
1403
  options.router.registerOutbound('discord-bot', outboundCallback)
1404
+ options.router.registerRecoveryAdapter('discord-bot', recoveryCallbacks)
1270
1405
  options.router.registerReaction('discord-bot', reactionCallback)
1271
1406
  options.router.registerRemoveReaction('discord-bot', removeReactionCallback)
1407
+ options.router.registerPrepareOwnReaction('discord-bot', ownReaction.prepare)
1408
+ options.router.registerRemoveOwnReaction('discord-bot', ownReaction.remove)
1272
1409
  options.router.registerTyping('discord-bot', typingCallback)
1273
1410
  options.router.setTypingCapability('discord-bot', true)
1274
1411
  options.router.registerChannelNameResolver('discord-bot', channelResolver)
1275
1412
  options.router.registerSelfIdentity('discord-bot', selfIdentityResolver)
1276
1413
  options.router.registerHistory('discord-bot', historyCallback)
1414
+ options.router.registerMissedInbound('discord-bot', missedInbound)
1277
1415
  options.router.registerMessageGet('discord-bot', messageGetCallback)
1278
1416
  options.router.registerList('discord-bot', listCallback)
1279
1417
  options.router.registerEditMessage('discord-bot', editMessageCallback)
@@ -1288,13 +1426,17 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1288
1426
  // !started and would otherwise skip cleanup), mirroring the github
1289
1427
  // adapter's rollback path.
1290
1428
  options.router.unregisterOutbound('discord-bot', outboundCallback)
1429
+ options.router.unregisterRecoveryAdapter('discord-bot', recoveryCallbacks)
1291
1430
  options.router.unregisterReaction('discord-bot', reactionCallback)
1292
1431
  options.router.unregisterRemoveReaction('discord-bot', removeReactionCallback)
1432
+ options.router.unregisterPrepareOwnReaction('discord-bot', ownReaction.prepare)
1433
+ options.router.unregisterRemoveOwnReaction('discord-bot', ownReaction.remove)
1293
1434
  options.router.unregisterTyping('discord-bot', typingCallback)
1294
1435
  options.router.setTypingCapability('discord-bot', false)
1295
1436
  options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
1296
1437
  options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
1297
1438
  options.router.unregisterHistory('discord-bot', historyCallback)
1439
+ options.router.unregisterMissedInbound('discord-bot', missedInbound)
1298
1440
  options.router.unregisterMessageGet('discord-bot', messageGetCallback)
1299
1441
  options.router.unregisterList('discord-bot', listCallback)
1300
1442
  options.router.unregisterEditMessage('discord-bot', editMessageCallback)
@@ -1353,14 +1495,19 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1353
1495
  async stop(): Promise<void> {
1354
1496
  if (!started) return
1355
1497
  started = false
1498
+ options.router.disconnectCatchUp('discord-bot')
1356
1499
  options.router.unregisterOutbound('discord-bot', outboundCallback)
1357
1500
  options.router.unregisterReaction('discord-bot', reactionCallback)
1358
1501
  options.router.unregisterRemoveReaction('discord-bot', removeReactionCallback)
1502
+ options.router.unregisterPrepareOwnReaction('discord-bot', ownReaction.prepare)
1503
+ options.router.unregisterRemoveOwnReaction('discord-bot', ownReaction.remove)
1359
1504
  options.router.unregisterTyping('discord-bot', typingCallback)
1360
1505
  options.router.setTypingCapability('discord-bot', false)
1361
1506
  options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
1362
1507
  options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
1363
1508
  options.router.unregisterHistory('discord-bot', historyCallback)
1509
+ options.router.unregisterMissedInbound('discord-bot', missedInbound)
1510
+ options.router.unregisterRecoveryAdapter('discord-bot', recoveryCallbacks)
1364
1511
  options.router.unregisterMessageGet('discord-bot', messageGetCallback)
1365
1512
  options.router.unregisterList('discord-bot', listCallback)
1366
1513
  options.router.unregisterEditMessage('discord-bot', editMessageCallback)
@@ -9,6 +9,7 @@ import type {
9
9
  } from '@/channels/types'
10
10
 
11
11
  import { describeError } from '../describe-error'
12
+ import { createOwnReactionCallbacks } from './own-reactions'
12
13
 
13
14
  export type DiscordReactionTarget = { channel: string; message: string }
14
15
  export type DiscordReactionRemovalTarget = { channel: string; message: string; emoji: string }
@@ -62,6 +63,7 @@ const EMOJI_UNICODE: Record<string, string> = {
62
63
  raised_hands: '🙌',
63
64
  zipper_mouth_face: '🤐',
64
65
  hourglass_flowing_sand: '⏳',
66
+ warning: '⚠️',
65
67
  }
66
68
 
67
69
  function resolveEmoji(emoji: string): string | null {
@@ -135,3 +137,19 @@ function parseRecord(value: string): Record<string, unknown> | null {
135
137
  ? (parsed as Record<string, unknown>)
136
138
  : null
137
139
  }
140
+
141
+ export function createDiscordOwnReactionCallbacks(deps: {
142
+ client: Pick<DiscordClient, 'removeReaction'>
143
+ identity: () => string | null | Promise<string | null>
144
+ }) {
145
+ return createOwnReactionCallbacks({
146
+ adapter: 'discord',
147
+ identity: deps.identity,
148
+ decode: decodeDiscordReactionRef,
149
+ encode: encodeDiscordReactionRef,
150
+ emoji: (emoji) => resolveEmoji(emoji) ?? (Object.values(EMOJI_UNICODE).includes(emoji) ? emoji : null),
151
+ remove: (target, emoji) => deps.client.removeReaction(target.channel, target.message, emoji),
152
+ classify: classifyDiscordError,
153
+ absent: (error) => classifyDiscordError(error) === 'not-found',
154
+ })
155
+ }