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
@@ -51,11 +51,22 @@ export async function downloadSlackAttachment(options: {
51
51
  throw new Error(`Slack attachment download failed (${response.status})${snippet === '' ? '' : `: ${snippet}`}`)
52
52
  }
53
53
  const contentType = response.headers.get('content-type')?.toLocaleLowerCase() ?? ''
54
- if (contentType.includes('text/html') || contentType.includes('application/xhtml+xml')) {
54
+ const htmlResponse = contentType.includes('text/html') || contentType.includes('application/xhtml+xml')
55
+ const expectedHtml =
56
+ options.metadata.mimetype === 'text/html' || options.metadata.mimetype === 'application/xhtml+xml'
57
+ if (htmlResponse && !expectedHtml) {
55
58
  await discardAttachmentResponse(response)
56
- throw new Error('Slack attachment download returned an HTML login response')
59
+ throw new Error('Slack attachment download returned HTML instead of the declared file type')
57
60
  }
58
- return { buffer: await readAttachmentResponse(response, options.maxBytes), url }
61
+ const buffer = await readAttachmentResponse(response, options.maxBytes)
62
+ // HTML is a legitimate email/file type. Detect the authentication protocol,
63
+ // not human-language words (an email may itself discuss signing in).
64
+ if (
65
+ expectedHtml &&
66
+ /<form\b[^>]*\baction\s*=\s*["'][^"']*\/(?:signin|login)(?:[/?#"'])/i.test(buffer.toString('utf8'))
67
+ )
68
+ throw new Error('Slack attachment download returned an HTML login response')
69
+ return { buffer, url }
59
70
  }
60
71
  }
61
72
 
@@ -3,6 +3,7 @@ const DEFAULT_TTL_MS = 60 * 60 * 1000
3
3
 
4
4
  export type SlackAuthorResolverOptions = {
5
5
  token: string
6
+ fetchImpl?: typeof fetch
6
7
  now?: () => number
7
8
  ttlMs?: number
8
9
  }
@@ -39,7 +40,7 @@ export function createSlackAuthorResolver(options: SlackAuthorResolverOptions):
39
40
  const existing = inflight.get(userId)
40
41
  if (existing) return existing
41
42
 
42
- const promise = fetchUserName(userId, options.token)
43
+ const promise = fetchUserName(userId, options.token, options.fetchImpl ?? fetch)
43
44
  .then((name) => {
44
45
  if (name !== userId) {
45
46
  cache.set(userId, { name, expiresAt: now() + ttlMs })
@@ -57,9 +58,9 @@ export function createSlackAuthorResolver(options: SlackAuthorResolverOptions):
57
58
  return { resolve }
58
59
  }
59
60
 
60
- async function fetchUserName(userId: string, token: string): Promise<string> {
61
+ async function fetchUserName(userId: string, token: string, fetchImpl: typeof fetch): Promise<string> {
61
62
  try {
62
- const response = await fetch(`${SLACK_API_BASE}/users.info?user=${encodeURIComponent(userId)}`, {
63
+ const response = await fetchImpl(`${SLACK_API_BASE}/users.info?user=${encodeURIComponent(userId)}`, {
63
64
  headers: { Authorization: `Bearer ${token}` },
64
65
  })
65
66
  if (!response.ok) return userId
@@ -5,6 +5,7 @@ const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000
5
5
 
6
6
  export type SlackChannelResolverOptions = {
7
7
  token: string
8
+ fetchImpl?: typeof fetch
8
9
  now?: () => number
9
10
  ttlMs?: number
10
11
  }
@@ -44,8 +45,10 @@ export function createSlackChannelResolver(options: SlackChannelResolverOptions)
44
45
  if (key.workspace === '@dm') return {}
45
46
 
46
47
  const [chatName, workspaceName] = await Promise.all([
47
- fetchCached(chatCache, key.chat, () => fetchChannelName(key.chat, options.token)),
48
- fetchCached(teamCache, key.workspace, () => fetchTeamName(key.workspace, options.token)),
48
+ fetchCached(chatCache, key.chat, () => fetchChannelName(key.chat, options.token, options.fetchImpl ?? fetch)),
49
+ fetchCached(teamCache, key.workspace, () =>
50
+ fetchTeamName(key.workspace, options.token, options.fetchImpl ?? fetch),
51
+ ),
49
52
  ])
50
53
 
51
54
  const result: ResolvedChannelNames = {}
@@ -55,9 +58,9 @@ export function createSlackChannelResolver(options: SlackChannelResolverOptions)
55
58
  }
56
59
  }
57
60
 
58
- async function fetchChannelName(channelId: string, token: string): Promise<string | null> {
61
+ async function fetchChannelName(channelId: string, token: string, fetchImpl: typeof fetch): Promise<string | null> {
59
62
  try {
60
- const response = await fetch(`${SLACK_API_BASE}/conversations.info?channel=${encodeURIComponent(channelId)}`, {
63
+ const response = await fetchImpl(`${SLACK_API_BASE}/conversations.info?channel=${encodeURIComponent(channelId)}`, {
61
64
  headers: { Authorization: `Bearer ${token}` },
62
65
  })
63
66
  if (!response.ok) return null
@@ -69,9 +72,9 @@ async function fetchChannelName(channelId: string, token: string): Promise<strin
69
72
  }
70
73
  }
71
74
 
72
- async function fetchTeamName(teamId: string, token: string): Promise<string | null> {
75
+ async function fetchTeamName(teamId: string, token: string, fetchImpl: typeof fetch): Promise<string | null> {
73
76
  try {
74
- const response = await fetch(`${SLACK_API_BASE}/team.info?team=${encodeURIComponent(teamId)}`, {
77
+ const response = await fetchImpl(`${SLACK_API_BASE}/team.info?team=${encodeURIComponent(teamId)}`, {
75
78
  headers: { Authorization: `Bearer ${token}` },
76
79
  })
77
80
  if (!response.ok) return null
@@ -7,16 +7,20 @@ import type { InboundAttachment, InboundMessage } from '@/channels/types'
7
7
  import { encodeSlackReactionRef } from './slack-bot-reactions'
8
8
  import { hasSlackMessageShareAttachments } from './slack-bot-reference'
9
9
  import { slackTsToMillis } from './slack-bot-time'
10
+ import { addressesSlackSelf, admitSlackInbound, type SlackInboundSource } from './slack-inbound-revision'
10
11
 
11
12
  export type SlackInboundMessageEvent = SlackSocketModeMessageEvent
12
13
  export type SlackInboundAppMentionEvent = SlackSocketModeAppMentionEvent
13
14
 
14
15
  export type InboundDropReason =
15
16
  | 'self_author' // event.user === botUserId; we never route our own messages back to ourselves
16
- | 'no_user' // event has no `user` field (e.g. system messages: channel_join, message_changed)
17
+ | 'no_user' // event has no `user` field (e.g. system messages: channel_join)
17
18
  | 'slack_system_message' // non-replyable Slack message subtype events (e.g. channel_topic)
18
19
  | 'empty_text' // event has neither text nor files — nothing for the agent to act on
19
20
  | 'pre_connect' // bot identity is not known yet, so mention/self/reply classification cannot be trusted
21
+ | 'unverified_edit' // edit without provable previous body / valid edit marker, or a flattened edited copy
22
+ | 'edit_without_new_mention' // edit that does not newly address the bot (typo fix, unchanged/removed mention)
23
+ | 'edited_control' // edit-derived command or claim code; edits are never control traffic
20
24
 
21
25
  export type InboundClassification =
22
26
  | { kind: 'drop'; reason: InboundDropReason }
@@ -34,6 +38,9 @@ export type SlackInboundContext = {
34
38
  // alias-driven thread anchoring". The router's `computeSelfAliases`
35
39
  // is the source of truth; the adapter just forwards it.
36
40
  selfAliases?: readonly string[]
41
+ // Listener that delivered the event. Only an `app_mention` delivery may use
42
+ // its `edited` marker as a first-engagement fallback; omitted means 'message'.
43
+ source?: SlackInboundSource
37
44
  }
38
45
 
39
46
  // All decision logic for "should this Socket Mode message event be routed to
@@ -47,6 +54,10 @@ export function classifyInbound(
47
54
  _config: ChannelAdapterConfig,
48
55
  context: SlackInboundContext,
49
56
  ): InboundClassification {
57
+ // Edits are gated on the raw envelope before normalization drops its subtype.
58
+ const admission = admitSlackInbound(event, context.botUserId, context.source)
59
+ if (admission.kind === 'drop') return { kind: 'drop', reason: admission.reason }
60
+ event = admission.event
50
61
  // Self-drop is the hard floor: never route our own messages back to
51
62
  // ourselves. The check requires `botUserId` (post-auth.test); before that,
52
63
  // fail closed below because mention, reply, and self classification all
@@ -55,7 +66,7 @@ export function classifyInbound(
55
66
  return { kind: 'drop', reason: 'self_author' }
56
67
  }
57
68
  if (event.user === undefined || event.user === '') {
58
- // System events (channel_join, message_changed, …) have no `user`;
69
+ // System events (channel_join, …) have no `user`;
59
70
  // they were also the ONLY way previously to flag bot_message subtype
60
71
  // events with no user. Now that we accept peer bots, a `bot_message`
61
72
  // subtype WITH a user (rare, but happens for legacy integrations) is
@@ -89,8 +100,7 @@ export function classifyInbound(
89
100
  // both are an invitation to participate. Treating them identically also
90
101
  // means the existing 'mention' trigger in typeclaw.json catches both
91
102
  // without any new config surface.
92
- const hasGroupMention = GROUP_MENTION_PATTERN.test(rawText)
93
- const isBotMention = hasGroupMention || rawText.includes(`<@${context.botUserId}>`)
103
+ const isBotMention = addressesSlackSelf(rawText, context.botUserId)
94
104
  // Top-level alias addressing (e.g. "Momo!" / "@Momo" by name) is engagement-equivalent
95
105
  // to a `<@bot>` mention (see engagement.ts: alias is unconditional and
96
106
  // ranks alongside explicit triggers). Anchor `thread` on the inbound
@@ -148,6 +158,10 @@ export function classifyInbound(
148
158
  text,
149
159
  ...(attachments.length > 0 ? { attachments } : {}),
150
160
  externalMessageId: event.ts,
161
+ accountIdentity: `slack-bot:${context.teamId}:${context.botUserId}`,
162
+ eventKind: 'message',
163
+ // One engagement per Slack message: edits never mint a new revision.
164
+ revision: 'original',
151
165
  reactionRef: encodeSlackReactionRef({ channel: event.channel, ts: event.ts }),
152
166
  authorId: event.user,
153
167
  authorName: event.user,
@@ -172,13 +186,6 @@ export function isRouteableSlackMessageSubtype(subtype: string | undefined): boo
172
186
  // can do a clean `includes()` check against the bot's own id.
173
187
  const MENTION_PATTERN = /<@([UW][A-Z0-9]+)(?:\|[^>]*)?>/g
174
188
 
175
- // Slack's group mention markup uses `!` (not `@`) and may carry an optional
176
- // `|label` suffix, same as user mentions. We deliberately exclude the
177
- // `<!subteam^ID>` form — engaging on every user-group ping would require
178
- // knowing which subteams the bot is a member of, which is outside what
179
- // Socket Mode events surface to us.
180
- const GROUP_MENTION_PATTERN = /<!(?:here|channel|everyone)(?:\|[^>]*)?>/
181
-
182
189
  function extractMentionedUserIds(text: string): string[] {
183
190
  const seen = new Set<string>()
184
191
  for (const match of text.matchAll(MENTION_PATTERN)) {
@@ -214,6 +221,7 @@ export function describeSlackFile(file: SlackFile, id: number): InboundAttachmen
214
221
 
215
222
  export function renderPlaceholder(attachment: InboundAttachment): string {
216
223
  const parts: string[] = [`Slack attachment #${attachment.id}: ${attachment.kind}`]
224
+ parts.push(`file_id=${attachment.ref}`)
217
225
  if (attachment.mimetype !== undefined) parts.push(attachment.mimetype)
218
226
  if (attachment.filename !== undefined) parts.push(`name=${attachment.filename}`)
219
227
  return `[${parts.join(' ')}]`
@@ -4,48 +4,131 @@ export const SLACK_DEDUPE_CAPACITY = 256
4
4
 
5
5
  export type SlackDedupeMatch = 'client_msg_id' | 'channel_ts'
6
6
 
7
- export type SlackDedupeKeys = {
8
- channelTs: string
9
- clientMsgId: string | null
7
+ type DedupeEvent = Pick<SlackInboundMessageEvent, 'channel' | 'ts' | 'client_msg_id' | 'text'>
8
+ type DeliveryState = { text: string | undefined; mentioned: boolean }
9
+ type Delivery = DeliveryState & {
10
+ committed?: DeliveryState
11
+ pending: Set<DeliveryState>
12
+ mergedInto?: Delivery
10
13
  }
11
14
 
15
+ export type SlackDedupeReservation = { commit: () => void; rollback: () => void }
16
+
12
17
  export type SlackDedupe = {
13
- check: (event: Pick<SlackInboundMessageEvent, 'channel' | 'ts' | 'client_msg_id'>) => SlackDedupeMatch | null
14
- mark: (event: Pick<SlackInboundMessageEvent, 'channel' | 'ts' | 'client_msg_id'>) => void
18
+ // A suppressed delivery still associates its retry identities synchronously.
19
+ check: (event: DedupeEvent, isBotMention?: boolean) => SlackDedupeMatch | null
20
+ mark: (event: DedupeEvent, isBotMention?: boolean) => void
21
+ // Reserve before asynchronous enrichment; roll back if durable admission fails.
22
+ reserve: (event: DedupeEvent, isBotMention?: boolean) => SlackDedupeReservation
15
23
  }
16
24
 
17
- // Two parallel insertion-ordered Sets. `client_msg_id` is the primary key
18
- // because it is stable across Slack-side resends of the same user gesture
19
- // (observed in the wild: a single Slack mention surfaced as two `message`
20
- // events ~21s apart with different `ts` values, identical text, and — per
21
- // Slack's API contract — identical `client_msg_id`). `channel:ts` is the
22
- // fallback because it is the only key available for events Slack does not
23
- // stamp with `client_msg_id` (bot messages, system messages, and historically
24
- // `app_mention` envelopes).
25
+ // Keep both retry identities: client_msg_id survives Slack resends with a fresh
26
+ // ts, while channel:ts also covers app_mention envelopes without client_msg_id.
27
+ // An identity may promote from observation to mention only on changed raw text.
28
+ // Once mentioned, further edits cannot re-engage it while either ring retains it.
25
29
  export function createSlackDedupe(capacity: number = SLACK_DEDUPE_CAPACITY): SlackDedupe {
26
- const tsRing = new Set<string>()
27
- const clientMsgIdRing = new Set<string>()
30
+ const tsRing = new Map<string, Delivery>()
31
+ const clientMsgIdRing = new Map<string, Delivery>()
32
+
33
+ const canonical = (delivery: Delivery): Delivery => {
34
+ while (delivery.mergedInto !== undefined) delivery = delivery.mergedInto
35
+ return delivery
36
+ }
37
+ const combine = (previous: DeliveryState | undefined, next: DeliveryState): DeliveryState =>
38
+ previous === undefined || (next.mentioned && !previous.mentioned) ? { ...next } : previous
39
+ const refresh = (delivery: Delivery): void => {
40
+ let state = delivery.committed
41
+ for (const pending of delivery.pending) state = combine(state, pending)
42
+ if (state !== undefined) {
43
+ delivery.text = state.text
44
+ delivery.mentioned = state.mentioned
45
+ }
46
+ }
28
47
 
29
- const remember = (ring: Set<string>, key: string): void => {
30
- if (ring.has(key)) return
31
- if (ring.size >= capacity) {
32
- const oldest = ring.values().next().value
48
+ const remember = (ring: Map<string, Delivery>, key: string, delivery: Delivery): void => {
49
+ if (!ring.has(key) && ring.size >= capacity) {
50
+ const oldest = ring.keys().next().value
33
51
  if (oldest !== undefined) ring.delete(oldest)
34
52
  }
35
- ring.add(key)
53
+ ring.set(key, delivery)
54
+ }
55
+ const isDuplicate = (previous: Delivery | undefined, event: DedupeEvent, mentioned: boolean): boolean =>
56
+ previous !== undefined &&
57
+ !(
58
+ mentioned &&
59
+ !previous.mentioned &&
60
+ previous.text !== undefined &&
61
+ event.text !== undefined &&
62
+ previous.text !== event.text
63
+ )
64
+
65
+ const associate = (event: DedupeEvent): Delivery => {
66
+ const key = `${event.channel}:${event.ts}`
67
+ const cmid = event.client_msg_id
68
+ const byTs = tsRing.get(key)
69
+ const byClient = cmid ? clientMsgIdRing.get(cmid) : undefined
70
+ const delivery: Delivery = byClient ??
71
+ byTs ?? { text: event.text, mentioned: false, pending: new Set<DeliveryState>() }
72
+ if (byTs !== undefined && byTs !== delivery) {
73
+ if (byTs.committed !== undefined) delivery.committed = combine(delivery.committed, byTs.committed)
74
+ for (const pending of byTs.pending) delivery.pending.add(pending)
75
+ byTs.mergedInto = delivery
76
+ refresh(delivery)
77
+ // Earlier resends can leave several timestamp aliases. Reconcile all of
78
+ // them, not only the two keys on this envelope. Scans are bounded by the
79
+ // ring capacities and needed only when two distinct records converge.
80
+ for (const [alias, previous] of tsRing) {
81
+ if (previous === byTs) tsRing.set(alias, delivery)
82
+ }
83
+ for (const [alias, previous] of clientMsgIdRing) {
84
+ if (previous === byTs) clientMsgIdRing.set(alias, delivery)
85
+ }
86
+ }
87
+ remember(tsRing, key, delivery)
88
+ if (cmid) remember(clientMsgIdRing, cmid, delivery)
89
+ return delivery
36
90
  }
37
91
 
38
92
  return {
39
- check: (event) => {
93
+ check: (event, mentioned = false) => {
40
94
  const cmid = event.client_msg_id
41
- if (cmid !== undefined && cmid !== '' && clientMsgIdRing.has(cmid)) return 'client_msg_id'
42
- if (tsRing.has(`${event.channel}:${event.ts}`)) return 'channel_ts'
43
- return null
95
+ const match =
96
+ cmid && isDuplicate(clientMsgIdRing.get(cmid), event, mentioned)
97
+ ? 'client_msg_id'
98
+ : isDuplicate(tsRing.get(`${event.channel}:${event.ts}`), event, mentioned)
99
+ ? 'channel_ts'
100
+ : null
101
+ if (match !== null) associate(event)
102
+ return match
44
103
  },
45
- mark: (event) => {
46
- remember(tsRing, `${event.channel}:${event.ts}`)
47
- const cmid = event.client_msg_id
48
- if (cmid !== undefined && cmid !== '') remember(clientMsgIdRing, cmid)
104
+ mark: (event, mentioned = false) => {
105
+ const delivery = associate(event)
106
+ delivery.committed = combine(delivery.committed, { text: event.text, mentioned })
107
+ refresh(delivery)
108
+ },
109
+ reserve: (event, mentioned = false) => {
110
+ const original = associate(event)
111
+ const pending = { text: event.text, mentioned }
112
+ original.pending.add(pending)
113
+ refresh(original)
114
+ let settled = false
115
+ const finish = (commit: boolean): void => {
116
+ if (settled) return
117
+ settled = true
118
+ const delivery = canonical(original)
119
+ delivery.pending.delete(pending)
120
+ if (commit) delivery.committed = combine(delivery.committed, pending)
121
+ refresh(delivery)
122
+ if (delivery.committed !== undefined || delivery.pending.size > 0) return
123
+ // Suppressed retries can have acquired additional aliases while pending.
124
+ for (const [key, value] of tsRing) {
125
+ if (value === delivery) tsRing.delete(key)
126
+ }
127
+ for (const [key, value] of clientMsgIdRing) {
128
+ if (value === delivery) clientMsgIdRing.delete(key)
129
+ }
130
+ }
131
+ return { commit: () => finish(true), rollback: () => finish(false) }
49
132
  },
50
133
  }
51
134
  }
@@ -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
  // The reactable target on Slack: a message is addressed by its channel id plus
14
15
  // the message `ts`. The classifier stamps this because `ts` is the inbound's
@@ -146,6 +147,7 @@ function classifySlackError(code: string | null): ReactionErrorCode {
146
147
  return 'not-found'
147
148
  case 'ratelimited':
148
149
  case 'rate_limited':
150
+ case 'slack_webapi_rate_limited_error':
149
151
  return 'rate-limited'
150
152
  default:
151
153
  return 'transient'
@@ -163,3 +165,19 @@ function parseRecord(value: string): Record<string, unknown> | null {
163
165
  ? (parsed as Record<string, unknown>)
164
166
  : null
165
167
  }
168
+
169
+ export function createSlackOwnReactionCallbacks(deps: {
170
+ client: Pick<SlackBotClient, 'removeReaction'>
171
+ identity: () => string | null | Promise<string | null>
172
+ }) {
173
+ return createOwnReactionCallbacks({
174
+ adapter: 'slack-bot',
175
+ identity: deps.identity,
176
+ decode: decodeSlackReactionRef,
177
+ encode: encodeSlackReactionRef,
178
+ emoji: normalizeEmoji,
179
+ remove: (target, emoji) => deps.client.removeReaction(target.channel, target.ts, emoji),
180
+ classify: (error) => classifySlackError(slackErrorCode(error)),
181
+ absent: (error) => slackErrorCode(error) === 'no_reaction',
182
+ })
183
+ }
@@ -154,6 +154,8 @@ export function commandResultReply(result: ExecuteCommandResult): string {
154
154
  // visible only to the invoker (vs. 'in_channel' which posts to everyone).
155
155
  // Control gestures should stay ephemeral — same rationale as Discord's
156
156
  // EPHEMERAL flag on interaction callbacks.
157
- export function buildSlashAckPayload(text: string): { response_type: 'ephemeral'; text: string } {
157
+ export type SlashAckPayload = { response_type: 'ephemeral'; text: string }
158
+
159
+ export function buildSlashAckPayload(text: string): SlashAckPayload {
158
160
  return { response_type: 'ephemeral', text }
159
161
  }