@sayknow-cli/coding-agent 0.3.16 → 0.4.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 (1474) hide show
  1. package/CHANGELOG.md +52 -0
  2. package/package.json +127 -110
  3. package/scripts/build-sdk-package-smoke.ts +132 -0
  4. package/scripts/capture-notifications-settings-showcase.ts +435 -0
  5. package/scripts/compile-args.ts +5 -2
  6. package/scripts/g005-daemon-smoke.ts +4 -5
  7. package/scripts/g011-daemon-path-smoke.ts +5 -5
  8. package/scripts/generate-hotkeys-docs.ts +74 -0
  9. package/scripts/generate-sdk-adapter-parity-manifest.ts +163 -0
  10. package/scripts/generate-sdk-operation-inventory.ts +914 -0
  11. package/scripts/generate-telegram-baseline-manifest.ts +128 -0
  12. package/scripts/manifest-schema.ts +124 -0
  13. package/scripts/run-test-manifest.ts +153 -0
  14. package/scripts/run-threat-model-check.ts +217 -0
  15. package/scripts/verify-skc-sdk-canonicalization.ts +3647 -0
  16. package/scripts/verify-skc-sdk-rename.ts +90 -0
  17. package/src/append-only-mode.ts +1 -1
  18. package/src/async/job-manager.ts +455 -69
  19. package/src/cli/args.ts +43 -12
  20. package/src/cli/auth-gateway-cli.ts +2 -2
  21. package/src/cli/config-cli.ts +77 -3
  22. package/src/cli/daemon-cli.ts +63 -14
  23. package/src/cli/launch-disposition.ts +42 -0
  24. package/src/cli/list-models.ts +1 -1
  25. package/src/cli/notify-cli.ts +373 -283
  26. package/src/cli/session-picker.ts +20 -3
  27. package/src/cli/setup-cli.ts +1 -1
  28. package/src/cli/worktree-cli.ts +9 -287
  29. package/src/cli.ts +31 -11
  30. package/src/commands/config.ts +1 -1
  31. package/src/commands/daemon.ts +50 -6
  32. package/src/commands/gc.ts +11 -1
  33. package/src/commands/harness.ts +127 -142
  34. package/src/commands/launch.ts +11 -6
  35. package/src/commands/mcp-serve.ts +97 -13
  36. package/src/commands/mcp.ts +2 -2
  37. package/src/commands/notify.ts +44 -7
  38. package/src/commands/sdk.ts +453 -0
  39. package/src/commands/ultragoal.ts +4 -1
  40. package/src/commands/worktree.ts +10 -53
  41. package/src/commit/agentic/agent.ts +1 -0
  42. package/src/config/atomic-yaml-patch.ts +490 -0
  43. package/src/config/file-lock.ts +105 -43
  44. package/src/config/keybindings.ts +64 -20
  45. package/src/config/model-auth.ts +9 -0
  46. package/src/config/model-bindings-applier.ts +139 -0
  47. package/src/config/model-discovery-manager.ts +224 -0
  48. package/src/config/model-equivalence.ts +66 -0
  49. package/src/config/model-profile-activation.ts +233 -86
  50. package/src/config/model-profiles.ts +52 -49
  51. package/src/config/model-registry.ts +5 -4
  52. package/src/config/model-resolver.ts +487 -410
  53. package/src/config/model-selector-value.ts +50 -0
  54. package/src/config/models-config-schema.ts +17 -23
  55. package/src/config/settings-schema.ts +372 -21
  56. package/src/config/settings.ts +1120 -182
  57. package/src/coordinator-mcp/model-preset.ts +74 -20
  58. package/src/coordinator-mcp/policy.ts +76 -11
  59. package/src/coordinator-mcp/question-gate-codec.ts +274 -0
  60. package/src/coordinator-mcp/question-state.ts +778 -0
  61. package/src/coordinator-mcp/server.ts +3120 -3111
  62. package/src/daemon/builtin.ts +8 -5
  63. package/src/daemon/control-types.ts +1 -1
  64. package/src/daemon/runtime.ts +2 -2
  65. package/src/debug/index.ts +1 -1
  66. package/src/defaults/skc/skills/team/SKILL.md +27 -13
  67. package/src/defaults/skc/skills/ultragoal/SKILL.md +0 -2
  68. package/src/discovery/helpers.ts +1 -50
  69. package/src/discovery/mcp-json.ts +327 -20
  70. package/src/edit/index.ts +64 -0
  71. package/src/eval/js/shared/runtime.ts +1 -1
  72. package/src/eval/py/env.ts +26 -0
  73. package/src/eval/py/index.ts +2 -2
  74. package/src/eval/py/kernel.ts +5 -3
  75. package/src/export/html/template.generated.ts +1 -1
  76. package/src/export/html/template.js +52 -18
  77. package/src/extensibility/custom-tools/types.ts +1 -1
  78. package/src/extensibility/extensions/compact-handler.ts +3 -3
  79. package/src/extensibility/extensions/get-commands-handler.ts +2 -2
  80. package/src/extensibility/extensions/loader.ts +77 -5
  81. package/src/extensibility/extensions/runner.ts +124 -7
  82. package/src/extensibility/extensions/types.ts +215 -18
  83. package/src/extensibility/hooks/runner.ts +2 -2
  84. package/src/extensibility/hooks/types.ts +1 -1
  85. package/src/extensibility/plugins/marketplace/manager.ts +94 -10
  86. package/src/extensibility/runtime-skill-discovery.ts +33 -13
  87. package/src/extensibility/shared-events.ts +2 -0
  88. package/src/extensibility/skc-plugins/installer.ts +16 -16
  89. package/src/extensibility/slash-commands.ts +3 -3
  90. package/src/goals/continuation-timeout-guard.ts +79 -0
  91. package/src/goals/runtime.ts +7 -5
  92. package/src/goals/state.ts +18 -0
  93. package/src/harness-control-plane/lifecycle-reconciliation.ts +64 -0
  94. package/src/harness-control-plane/operate.ts +9 -9
  95. package/src/harness-control-plane/owner.ts +341 -41
  96. package/src/harness-control-plane/phase-rollup.ts +4 -7
  97. package/src/harness-control-plane/receipt-ingest.ts +5 -0
  98. package/src/harness-control-plane/receipt-spool.ts +51 -7
  99. package/src/harness-control-plane/receipts.ts +0 -1
  100. package/src/harness-control-plane/sdk-transport.ts +395 -0
  101. package/src/harness-control-plane/session-lease.ts +12 -130
  102. package/src/harness-control-plane/session-transport.ts +94 -0
  103. package/src/harness-control-plane/types.ts +1 -1
  104. package/src/hindsight/backend.ts +26 -27
  105. package/src/hindsight/client.ts +65 -2
  106. package/src/hindsight/state.ts +101 -32
  107. package/src/hooks/skill-state.ts +17 -11
  108. package/src/i18n/messages/en.ts +1 -0
  109. package/src/internal-urls/agent-protocol.ts +76 -5
  110. package/src/internal-urls/docs-index.generated.ts +44 -37
  111. package/src/internal-urls/local-protocol.ts +420 -18
  112. package/src/lsp/client.ts +43 -7
  113. package/src/lsp/config.ts +145 -26
  114. package/src/lsp/index.ts +7 -91
  115. package/src/lsp/lspmux.ts +39 -10
  116. package/src/lsp/path-trust.ts +81 -0
  117. package/src/main.ts +451 -236
  118. package/src/memories/index.ts +1 -0
  119. package/src/memories/storage.ts +6 -2
  120. package/src/modes/DESIGN.md +258 -0
  121. package/src/modes/acp/acp-agent.ts +1236 -2612
  122. package/src/modes/acp/acp-client-bridge.ts +2 -20
  123. package/src/modes/acp/acp-event-mapper.ts +18 -2
  124. package/src/modes/acp/acp-mode.ts +8 -36
  125. package/src/modes/acp/permission-mode.ts +25 -0
  126. package/src/modes/acp/startup-options.ts +6 -0
  127. package/src/modes/action-registry.ts +165 -0
  128. package/src/modes/bridge/bridge-mode.ts +6 -4
  129. package/src/modes/components/agent-dashboard.ts +37 -17
  130. package/src/modes/components/ansi-display-validator.ts +54 -0
  131. package/src/modes/components/chrome.ts +40 -0
  132. package/src/modes/components/command-palette.ts +168 -0
  133. package/src/modes/components/custom-editor.ts +105 -33
  134. package/src/modes/components/custom-provider-wizard.ts +77 -15
  135. package/src/modes/components/index.ts +2 -1
  136. package/src/modes/components/model-selector.ts +93 -35
  137. package/src/modes/components/notifications-settings-editor.ts +1403 -0
  138. package/src/modes/components/pet-capability.ts +115 -0
  139. package/src/modes/components/pet-selector.ts +15 -23
  140. package/src/modes/components/plan-preview-overlay.ts +295 -0
  141. package/src/modes/components/queue-mode-selector.ts +10 -27
  142. package/src/modes/components/queue-pane.ts +79 -0
  143. package/src/modes/components/read-tool-group.ts +13 -0
  144. package/src/modes/components/sayknow-pet-widget.ts +169 -20
  145. package/src/modes/components/session-observer-overlay.ts +213 -775
  146. package/src/modes/components/sessions-dashboard.ts +181 -0
  147. package/src/modes/components/settings-selector.ts +89 -12
  148. package/src/modes/components/show-images-selector.ts +10 -24
  149. package/src/modes/components/status-line/types.ts +1 -1
  150. package/src/modes/components/status-line.ts +1 -969
  151. package/src/modes/components/tasks-pane.ts +73 -0
  152. package/src/modes/components/theme-selector.ts +11 -31
  153. package/src/modes/components/tool-execution.ts +22 -0
  154. package/src/modes/components/tool-status-header.ts +1056 -0
  155. package/src/modes/components/tool-transcript-format.ts +393 -0
  156. package/src/modes/components/transcript-viewer-overlay.ts +446 -0
  157. package/src/modes/components/welcome.ts +4 -4
  158. package/src/modes/controllers/btw-controller.ts +1 -0
  159. package/src/modes/controllers/command-controller.ts +25 -17
  160. package/src/modes/controllers/event-controller.ts +14 -18
  161. package/src/modes/controllers/extension-ui-controller.ts +441 -37
  162. package/src/modes/controllers/goal-mode-controller.ts +493 -0
  163. package/src/modes/controllers/input-controller.ts +889 -263
  164. package/src/modes/controllers/mode-gate.ts +24 -0
  165. package/src/modes/controllers/plan-mode-controller.ts +519 -0
  166. package/src/modes/controllers/runtime-mcp-command-controller.ts +3 -0
  167. package/src/modes/controllers/selector-controller.ts +957 -54
  168. package/src/modes/controllers/stt-controller.ts +125 -0
  169. package/src/modes/index.ts +0 -22
  170. package/src/modes/interactive-mode.ts +376 -1130
  171. package/src/modes/jobs-observer.ts +3 -0
  172. package/src/modes/prompt-action-autocomplete.ts +7 -0
  173. package/src/modes/rpc/rpc-mode.ts +3 -1
  174. package/src/modes/runtime-init.ts +320 -6
  175. package/src/modes/shared/agent-wire/approval-gate.ts +9 -11
  176. package/src/modes/shared/agent-wire/command-dispatch.ts +3 -1
  177. package/src/modes/shared/agent-wire/deep-interview-gate.ts +65 -111
  178. package/src/modes/shared/agent-wire/event-contract.ts +7 -8
  179. package/src/modes/shared/agent-wire/event-envelope.ts +9 -17
  180. package/src/modes/shared/agent-wire/event-observation.ts +16 -7
  181. package/src/modes/shared/agent-wire/workflow-gate-broker.ts +1331 -89
  182. package/src/modes/shared/agent-wire/workflow-gate-schema.ts +19 -17
  183. package/src/modes/shared/agent-wire/workflow-gate-types.ts +407 -0
  184. package/src/modes/tasks-aggregator.ts +199 -0
  185. package/src/modes/transcript-item-registry.ts +229 -0
  186. package/src/modes/types.ts +63 -21
  187. package/src/modes/utils/ui-helpers.ts +17 -9
  188. package/src/notifications/index.ts +8 -2
  189. package/src/plan-mode/approved-plan.ts +3 -1
  190. package/src/prompts/agent-fragments/ralplan-persistence.md +6 -0
  191. package/src/prompts/agent-fragments/restricted-bash.md +1 -0
  192. package/src/prompts/agents/architect.md +3 -8
  193. package/src/prompts/agents/critic.md +3 -8
  194. package/src/prompts/agents/executor.md +3 -0
  195. package/src/prompts/agents/planner.md +4 -12
  196. package/src/prompts/system/custom-system-prompt.md +2 -24
  197. package/src/prompts/system/plan-mode-approved.md +8 -0
  198. package/src/prompts/system/system-prompt.md +18 -94
  199. package/src/prompts/tools/bash.md +4 -4
  200. package/src/prompts/tools/browser.md +15 -52
  201. package/src/prompts/tools/find.md +2 -2
  202. package/src/prompts/tools/hashline.md +13 -55
  203. package/src/prompts/tools/lsp.md +3 -3
  204. package/src/prompts/tools/read.md +3 -6
  205. package/src/prompts/tools/search-tool-bm25.md +0 -2
  206. package/src/prompts/tools/search.md +2 -4
  207. package/src/prompts/tools/skill-discovery.md +1 -2
  208. package/src/prompts/tools/task.md +1 -1
  209. package/src/runtime-mcp/client.ts +94 -19
  210. package/src/runtime-mcp/config.ts +27 -15
  211. package/src/runtime-mcp/discoverable-tool-metadata.ts +16 -13
  212. package/src/runtime-mcp/manager.ts +359 -106
  213. package/src/runtime-mcp/oauth-discovery.ts +116 -26
  214. package/src/runtime-mcp/oauth-flow.ts +42 -12
  215. package/src/runtime-mcp/transports/http.ts +49 -19
  216. package/src/runtime-mcp/transports/stdio.ts +47 -28
  217. package/src/runtime-mcp/types.ts +10 -0
  218. package/src/sdk/acp/adapter.ts +418 -0
  219. package/src/sdk/acp/index.ts +2 -0
  220. package/src/sdk/broker/broker.ts +877 -0
  221. package/src/sdk/broker/discovery.ts +238 -0
  222. package/src/sdk/broker/ensure.ts +393 -0
  223. package/src/sdk/broker/identity.ts +42 -0
  224. package/src/sdk/broker/index.ts +8 -0
  225. package/src/sdk/broker/internal-source-marker-2178.txt +1 -0
  226. package/src/sdk/broker/internal-source.bunfig.toml +1 -0
  227. package/src/sdk/broker/internal.ts +10 -0
  228. package/src/sdk/broker/lifecycle-codec.ts +11 -0
  229. package/src/sdk/broker/lifecycle-ledger.ts +583 -0
  230. package/src/sdk/broker/lifecycle.ts +3413 -0
  231. package/src/sdk/broker/process-incarnation.ts +151 -0
  232. package/src/sdk/broker/runtime.ts +164 -0
  233. package/src/sdk/broker/session-index.ts +678 -0
  234. package/src/sdk/broker/state-version.ts +47 -0
  235. package/src/sdk/broker/transport.ts +125 -0
  236. package/src/sdk/bus/attachment-registry.ts +23 -0
  237. package/src/sdk/bus/chat-adapters.ts +147 -0
  238. package/src/sdk/bus/chat-command-policy.ts +107 -0
  239. package/src/sdk/bus/chat-daemon-cli.ts +278 -0
  240. package/src/sdk/bus/chat-daemon-control.ts +1101 -0
  241. package/src/sdk/bus/chat-daemon-runtime.ts +527 -0
  242. package/src/sdk/bus/chat-effect-journal.ts +363 -0
  243. package/src/sdk/bus/config-commands.ts +192 -0
  244. package/src/sdk/bus/config.ts +568 -0
  245. package/src/sdk/bus/conversation-store.ts +367 -0
  246. package/src/sdk/bus/daemon-paths.ts +34 -0
  247. package/src/sdk/bus/discord-conversation.ts +85 -0
  248. package/src/sdk/bus/discord-daemon.ts +2292 -0
  249. package/src/sdk/bus/discord-live-provider.ts +521 -0
  250. package/src/sdk/bus/discord-provider.ts +56 -0
  251. package/src/sdk/bus/engine.ts +100 -0
  252. package/src/sdk/bus/helpers.ts +135 -0
  253. package/src/sdk/bus/html-format.ts +518 -0
  254. package/src/sdk/bus/index.ts +4961 -0
  255. package/src/sdk/bus/lifecycle-commands.ts +291 -0
  256. package/src/sdk/bus/lifecycle-control-runtime.ts +1409 -0
  257. package/src/sdk/bus/lifecycle-orchestrator.ts +458 -0
  258. package/src/sdk/bus/managed-daemon.ts +163 -0
  259. package/src/sdk/bus/native-runtime-compatibility.ts +42 -0
  260. package/src/sdk/bus/natives-augment.d.ts +63 -0
  261. package/src/sdk/bus/notification-orchestration.ts +535 -0
  262. package/src/sdk/bus/notification-service.ts +1174 -0
  263. package/src/sdk/bus/operator-runtime.ts +171 -0
  264. package/src/sdk/bus/rate-limit-pool.ts +276 -0
  265. package/src/sdk/bus/recent-activity.ts +279 -0
  266. package/src/sdk/bus/reply-sent-store.ts +134 -0
  267. package/src/sdk/bus/rich-document.ts +258 -0
  268. package/src/sdk/bus/rich-draft.ts +107 -0
  269. package/src/sdk/bus/rich-render.ts +135 -0
  270. package/src/sdk/bus/session-control.ts +439 -0
  271. package/src/sdk/bus/slack-conversation.ts +74 -0
  272. package/src/sdk/bus/slack-daemon.ts +2144 -0
  273. package/src/sdk/bus/slack-live-provider.ts +380 -0
  274. package/src/sdk/bus/slack-provider.ts +76 -0
  275. package/src/sdk/bus/telegram-cli.ts +194 -0
  276. package/src/sdk/bus/telegram-daemon-cli.ts +292 -0
  277. package/src/sdk/bus/telegram-daemon-contract.ts +27 -0
  278. package/src/sdk/bus/telegram-daemon-control.ts +642 -0
  279. package/src/sdk/bus/telegram-daemon.ts +6675 -0
  280. package/src/sdk/bus/telegram-reference.ts +436 -0
  281. package/src/sdk/bus/telegram-setup.ts +663 -0
  282. package/src/sdk/bus/threaded-inbound.ts +141 -0
  283. package/src/sdk/bus/threaded-render.ts +294 -0
  284. package/src/sdk/bus/topic-registry.ts +364 -0
  285. package/src/sdk/cli/index.ts +1 -0
  286. package/src/sdk/cli/session-cli.ts +275 -0
  287. package/src/sdk/client/client.ts +1 -0
  288. package/src/sdk/client/discovery.ts +108 -0
  289. package/src/sdk/client/index.ts +2 -0
  290. package/src/sdk/host/control/dispatch.ts +388 -0
  291. package/src/sdk/host/control/index.ts +10 -0
  292. package/src/sdk/host/control/operations.ts +68 -0
  293. package/src/sdk/host/events.ts +91 -0
  294. package/src/sdk/host/host.ts +338 -0
  295. package/src/sdk/host/index.ts +4 -0
  296. package/src/sdk/host/query/cursor.ts +189 -0
  297. package/src/sdk/host/query/handlers.ts +531 -0
  298. package/src/sdk/host/query/index.ts +3 -0
  299. package/src/sdk/host/query/revision-store.ts +1149 -0
  300. package/src/sdk/host/reverse-leases.ts +325 -0
  301. package/src/sdk/host/types.ts +29 -0
  302. package/src/sdk/index.ts +14 -0
  303. package/src/sdk/lifecycle-session.ts +39 -0
  304. package/src/sdk/mcp/index.ts +1 -0
  305. package/src/sdk/mcp/server.ts +332 -0
  306. package/src/sdk/models.ts +168 -0
  307. package/src/sdk/protocol/adapter-validation.ts +48 -0
  308. package/src/sdk/protocol/operation-inventory.generated.json +4719 -0
  309. package/src/sdk/protocol/operation-registry.ts +312 -0
  310. package/src/sdk/session-directory.ts +141 -0
  311. package/src/sdk/session.ts +2869 -0
  312. package/src/sdk/startup-capability.ts +189 -0
  313. package/src/secrets/index.ts +53 -10
  314. package/src/secrets/obfuscator.ts +21 -18
  315. package/src/secrets/regex.ts +2 -0
  316. package/src/session/agent-session.ts +5602 -2138
  317. package/src/session/agent-storage.ts +18 -0
  318. package/src/session/artifacts.ts +188 -23
  319. package/src/session/cache-economics.ts +25 -8
  320. package/src/session/context-estimation.ts +7 -2
  321. package/src/session/default-model-selection.ts +93 -0
  322. package/src/session/fallback-chain-controller.ts +186 -0
  323. package/src/session/internal/managed-session-scope.ts +2402 -0
  324. package/src/session/internal/managed-session-storage.ts +1559 -0
  325. package/src/session/messages.ts +91 -2
  326. package/src/session/session-manager-internal.ts +33 -0
  327. package/src/session/session-manager.ts +2578 -392
  328. package/src/session/session-storage.ts +550 -40
  329. package/src/session/streaming-output.ts +6 -0
  330. package/src/session/volatile-context-pruning.ts +78 -0
  331. package/src/session/yield-queue.ts +20 -0
  332. package/src/setup/credential-auto-import.ts +291 -35
  333. package/src/setup/hermes/templates/operator-instructions.v1.md +4 -6
  334. package/src/setup/provider-onboarding.ts +36 -61
  335. package/src/setup/provider-presets.json +5 -0
  336. package/src/skc-runtime/deep-interview-recorder.ts +70 -3
  337. package/src/skc-runtime/deep-interview-state.ts +441 -5
  338. package/src/skc-runtime/gc-render.ts +19 -1
  339. package/src/skc-runtime/gc-runtime.ts +68 -3
  340. package/src/skc-runtime/goal-mode-request.ts +55 -8
  341. package/src/skc-runtime/launch-worktree.ts +5 -5
  342. package/src/skc-runtime/linux-proc.ts +71 -0
  343. package/src/skc-runtime/managed-owner-admission.ts +352 -0
  344. package/src/skc-runtime/managed-owner-supervisor.ts +162 -0
  345. package/src/skc-runtime/psmux-detect.ts +82 -4
  346. package/src/skc-runtime/ralplan-runtime.ts +74 -90
  347. package/src/skc-runtime/session-resolution.ts +18 -3
  348. package/src/skc-runtime/session-state-sidecar.ts +47 -138
  349. package/src/skc-runtime/state-argv.ts +292 -0
  350. package/src/skc-runtime/state-migrations.ts +1 -1
  351. package/src/skc-runtime/state-runtime.ts +387 -451
  352. package/src/skc-runtime/state-writer.ts +36 -40
  353. package/src/skc-runtime/team-launch.ts +319 -0
  354. package/src/skc-runtime/team-notify.ts +326 -0
  355. package/src/skc-runtime/team-runtime.ts +8 -2
  356. package/src/skc-runtime/team-store.ts +828 -0
  357. package/src/skc-runtime/team-workers.ts +962 -0
  358. package/src/skc-runtime/tmux-owner-isolation-cli.ts +55 -28
  359. package/src/skc-runtime/tmux-owner-isolation.ts +136 -11
  360. package/src/skc-runtime/tmux-sessions.ts +23 -34
  361. package/src/skc-runtime/ultragoal-change-set.ts +172 -0
  362. package/src/skc-runtime/ultragoal-evidence.ts +874 -0
  363. package/src/skc-runtime/ultragoal-guard.ts +136 -18
  364. package/src/skc-runtime/ultragoal-owner-loss-recovery.ts +328 -0
  365. package/src/skc-runtime/ultragoal-pipeline.ts +306 -0
  366. package/src/skc-runtime/ultragoal-receipt-freshness.ts +102 -1
  367. package/src/skc-runtime/ultragoal-runtime.ts +325 -1322
  368. package/src/skc-runtime/windows-powershell-command.ts +58 -0
  369. package/src/skc-runtime/workflow-cli-common.ts +30 -0
  370. package/src/skc-runtime/workflow-manifest.generated.json +58 -0
  371. package/src/skc-runtime/workflow-manifest.ts +18 -0
  372. package/src/skill-state/active-state.ts +3 -13
  373. package/src/skill-state/workflow-mutation-guard.ts +661 -0
  374. package/src/skill-state/workflow-state-contract.ts +6 -41
  375. package/src/slash-commands/builtin-registry.ts +115 -41
  376. package/src/system-prompt.ts +37 -44
  377. package/src/task/agents.ts +19 -1
  378. package/src/task/executor.ts +223 -45
  379. package/src/task/index.ts +124 -56
  380. package/src/thinking.ts +21 -6
  381. package/src/tool-discovery/tool-index.ts +20 -134
  382. package/src/tools/ask-answer-registry.ts +16 -2
  383. package/src/tools/ast-edit.ts +1 -1
  384. package/src/tools/bash-allowed-prefixes.ts +79 -29
  385. package/src/tools/bash-skill-urls.ts +14 -3
  386. package/src/tools/bash.ts +40 -2
  387. package/src/tools/browser/STEALTH-THIRD-PARTY-NOTICES.md +26 -0
  388. package/src/tools/browser/benchmark/detector-report.ts +157 -0
  389. package/src/tools/browser/benchmark/run-suite.ts +39 -0
  390. package/src/tools/browser/dead-tab-recovery.ts +78 -0
  391. package/src/tools/browser/launch.ts +127 -20
  392. package/src/tools/browser/profile-discovery.ts +63 -0
  393. package/src/tools/browser/profile-posture.ts +59 -0
  394. package/src/tools/browser/profile-reuse.ts +102 -0
  395. package/src/tools/browser/profile-warmup.ts +109 -0
  396. package/src/tools/browser/readable.ts +1 -1
  397. package/src/tools/browser/registry.ts +87 -11
  398. package/src/tools/browser/screenshot-format.ts +34 -0
  399. package/src/tools/browser/tab-protocol.ts +4 -0
  400. package/src/tools/browser/tab-supervisor.ts +392 -142
  401. package/src/tools/browser/tab-worker-entry.ts +33 -14
  402. package/src/tools/browser/tab-worker-path-resolver.ts +67 -0
  403. package/src/tools/browser/tab-worker-smoke.ts +87 -0
  404. package/src/tools/browser/tab-worker.ts +8 -6
  405. package/src/tools/browser.ts +6 -0
  406. package/src/tools/computer.ts +10 -3
  407. package/src/tools/cron.ts +30 -16
  408. package/src/tools/fetch.ts +11 -4
  409. package/src/tools/index.ts +88 -32
  410. package/src/tools/output-meta.ts +19 -7
  411. package/src/tools/path-utils.ts +42 -35
  412. package/src/tools/plan-mode-guard.ts +1 -0
  413. package/src/tools/puppeteer/14_stealth_permissions.txt +57 -0
  414. package/src/tools/puppeteer/15_stealth_webrtc.txt +60 -0
  415. package/src/tools/read.ts +226 -65
  416. package/src/tools/resource-gc.ts +125 -36
  417. package/src/tools/search-tool-bm25.ts +11 -74
  418. package/src/tools/sqlite-reader.ts +3 -2
  419. package/src/tools/subagent-render.ts +19 -8
  420. package/src/tools/subagent.ts +129 -34
  421. package/src/tools/telegram-send.ts +2 -2
  422. package/src/utils/event-bus.ts +9 -4
  423. package/src/utils/file-mentions.ts +4 -4
  424. package/src/utils/image-loading.ts +85 -34
  425. package/src/utils/image-resize.ts +16 -9
  426. package/src/utils/pasted-image-loading.ts +514 -0
  427. package/src/utils/pasted-image-path.ts +223 -98
  428. package/src/web/scrapers/html-to-markdown.ts +68 -0
  429. package/src/web/scrapers/readthedocs.ts +1 -1
  430. package/src/web/scrapers/types.ts +1 -68
  431. package/src/web/search/index.ts +3 -3
  432. package/src/web/search/providers/openai-compatible.ts +76 -23
  433. package/dist/types/append-only-mode.d.ts +0 -31
  434. package/dist/types/async/index.d.ts +0 -2
  435. package/dist/types/async/job-manager.d.ts +0 -328
  436. package/dist/types/async/support.d.ts +0 -2
  437. package/dist/types/autoresearch/dashboard.d.ts +0 -4
  438. package/dist/types/autoresearch/git.d.ts +0 -36
  439. package/dist/types/autoresearch/helpers.d.ts +0 -24
  440. package/dist/types/autoresearch/index.d.ts +0 -2
  441. package/dist/types/autoresearch/state.d.ts +0 -17
  442. package/dist/types/autoresearch/storage.d.ts +0 -142
  443. package/dist/types/autoresearch/tools/init-experiment.d.ts +0 -31
  444. package/dist/types/autoresearch/tools/log-experiment.d.ts +0 -23
  445. package/dist/types/autoresearch/tools/run-experiment.d.ts +0 -8
  446. package/dist/types/autoresearch/tools/update-notes.d.ts +0 -12
  447. package/dist/types/autoresearch/types.d.ts +0 -154
  448. package/dist/types/build-metadata.d.ts +0 -7
  449. package/dist/types/capability/context-file.d.ts +0 -17
  450. package/dist/types/capability/extension-module.d.ts +0 -15
  451. package/dist/types/capability/extension.d.ts +0 -28
  452. package/dist/types/capability/fs.d.ts +0 -20
  453. package/dist/types/capability/hook.d.ts +0 -19
  454. package/dist/types/capability/index.d.ts +0 -80
  455. package/dist/types/capability/instruction.d.ts +0 -17
  456. package/dist/types/capability/mcp.d.ts +0 -49
  457. package/dist/types/capability/prompt.d.ts +0 -15
  458. package/dist/types/capability/rule.d.ts +0 -69
  459. package/dist/types/capability/settings.d.ts +0 -15
  460. package/dist/types/capability/skill.d.ts +0 -36
  461. package/dist/types/capability/slash-command.d.ts +0 -17
  462. package/dist/types/capability/ssh.d.ts +0 -23
  463. package/dist/types/capability/system-prompt.d.ts +0 -15
  464. package/dist/types/capability/tool.d.ts +0 -19
  465. package/dist/types/capability/types.d.ts +0 -154
  466. package/dist/types/cli/agents-cli.d.ts +0 -12
  467. package/dist/types/cli/args.d.ts +0 -57
  468. package/dist/types/cli/auth-broker-cli.d.ts +0 -25
  469. package/dist/types/cli/auth-gateway-cli.d.ts +0 -18
  470. package/dist/types/cli/classify-install-target.d.ts +0 -8
  471. package/dist/types/cli/commands/init-xdg.d.ts +0 -1
  472. package/dist/types/cli/completion-cli.d.ts +0 -41
  473. package/dist/types/cli/config-cli.d.ts +0 -23
  474. package/dist/types/cli/daemon-cli.d.ts +0 -27
  475. package/dist/types/cli/fast-help.d.ts +0 -1
  476. package/dist/types/cli/file-processor.d.ts +0 -11
  477. package/dist/types/cli/fixture-report.d.ts +0 -20
  478. package/dist/types/cli/fixture-report.test.d.ts +0 -1
  479. package/dist/types/cli/grep-cli.d.ts +0 -17
  480. package/dist/types/cli/initial-message.d.ts +0 -17
  481. package/dist/types/cli/list-models.d.ts +0 -36
  482. package/dist/types/cli/local-provider-smoke.d.ts +0 -59
  483. package/dist/types/cli/malloc-env-guard.d.ts +0 -65
  484. package/dist/types/cli/malloc-env-guard.test.d.ts +0 -1
  485. package/dist/types/cli/mcp-cli.d.ts +0 -25
  486. package/dist/types/cli/migrate-cli.d.ts +0 -20
  487. package/dist/types/cli/nofile-limit.d.ts +0 -11
  488. package/dist/types/cli/notify-cli.d.ts +0 -39
  489. package/dist/types/cli/plugin-cli.d.ts +0 -34
  490. package/dist/types/cli/read-cli.d.ts +0 -4
  491. package/dist/types/cli/session-picker.d.ts +0 -4
  492. package/dist/types/cli/setup-cli.d.ts +0 -73
  493. package/dist/types/cli/shell-cli.d.ts +0 -8
  494. package/dist/types/cli/skills-cli.d.ts +0 -9
  495. package/dist/types/cli/ssh-cli.d.ts +0 -21
  496. package/dist/types/cli/stats-cli.d.ts +0 -17
  497. package/dist/types/cli/telegram-cli.d.ts +0 -13
  498. package/dist/types/cli/update-cli.d.ts +0 -108
  499. package/dist/types/cli/web-search-cli.d.ts +0 -32
  500. package/dist/types/cli/worktree-cli.d.ts +0 -26
  501. package/dist/types/cli.d.ts +0 -140
  502. package/dist/types/commands/acp.d.ts +0 -12
  503. package/dist/types/commands/agents.d.ts +0 -34
  504. package/dist/types/commands/auth-broker.d.ts +0 -54
  505. package/dist/types/commands/auth-gateway.d.ts +0 -32
  506. package/dist/types/commands/codex-native-hook.d.ts +0 -6
  507. package/dist/types/commands/commit.d.ts +0 -27
  508. package/dist/types/commands/completion.d.ts +0 -29
  509. package/dist/types/commands/config.d.ts +0 -33
  510. package/dist/types/commands/contribution-prep.d.ts +0 -18
  511. package/dist/types/commands/coordinator.d.ts +0 -19
  512. package/dist/types/commands/daemon.d.ts +0 -45
  513. package/dist/types/commands/deep-interview.d.ts +0 -54
  514. package/dist/types/commands/gc.d.ts +0 -26
  515. package/dist/types/commands/grep.d.ts +0 -42
  516. package/dist/types/commands/harness.d.ts +0 -43
  517. package/dist/types/commands/launch.d.ts +0 -131
  518. package/dist/types/commands/local-provider.d.ts +0 -34
  519. package/dist/types/commands/mcp-serve.d.ts +0 -24
  520. package/dist/types/commands/mcp.d.ts +0 -70
  521. package/dist/types/commands/migrate.d.ts +0 -33
  522. package/dist/types/commands/notify.d.ts +0 -47
  523. package/dist/types/commands/plugin.d.ts +0 -58
  524. package/dist/types/commands/ralplan.d.ts +0 -7
  525. package/dist/types/commands/read.d.ts +0 -15
  526. package/dist/types/commands/rlm.d.ts +0 -10
  527. package/dist/types/commands/session.d.ts +0 -30
  528. package/dist/types/commands/setup.d.ts +0 -105
  529. package/dist/types/commands/shell.d.ts +0 -21
  530. package/dist/types/commands/skills.d.ts +0 -26
  531. package/dist/types/commands/ssh.d.ts +0 -48
  532. package/dist/types/commands/state.d.ts +0 -7
  533. package/dist/types/commands/stats.d.ts +0 -25
  534. package/dist/types/commands/team.d.ts +0 -24
  535. package/dist/types/commands/telegram.d.ts +0 -22
  536. package/dist/types/commands/ultragoal.d.ts +0 -8
  537. package/dist/types/commands/update.d.ts +0 -20
  538. package/dist/types/commands/web-search.d.ts +0 -87
  539. package/dist/types/commands/worktree.d.ts +0 -34
  540. package/dist/types/commit/agentic/agent.d.ts +0 -31
  541. package/dist/types/commit/agentic/fallback.d.ts +0 -5
  542. package/dist/types/commit/agentic/index.d.ts +0 -2
  543. package/dist/types/commit/agentic/state.d.ts +0 -58
  544. package/dist/types/commit/agentic/tools/analyze-file.d.ts +0 -19
  545. package/dist/types/commit/agentic/tools/git-file-diff.d.ts +0 -10
  546. package/dist/types/commit/agentic/tools/git-hunk.d.ts +0 -9
  547. package/dist/types/commit/agentic/tools/git-overview.d.ts +0 -9
  548. package/dist/types/commit/agentic/tools/index.d.ts +0 -16
  549. package/dist/types/commit/agentic/tools/propose-changelog.d.ts +0 -28
  550. package/dist/types/commit/agentic/tools/propose-commit.d.ts +0 -36
  551. package/dist/types/commit/agentic/tools/recent-commits.d.ts +0 -7
  552. package/dist/types/commit/agentic/tools/schemas.d.ts +0 -27
  553. package/dist/types/commit/agentic/tools/split-commit.d.ts +0 -53
  554. package/dist/types/commit/agentic/topo-sort.d.ts +0 -4
  555. package/dist/types/commit/agentic/trivial.d.ts +0 -7
  556. package/dist/types/commit/agentic/validation.d.ts +0 -20
  557. package/dist/types/commit/analysis/conventional.d.ts +0 -22
  558. package/dist/types/commit/analysis/index.d.ts +0 -4
  559. package/dist/types/commit/analysis/scope.d.ts +0 -6
  560. package/dist/types/commit/analysis/summary.d.ts +0 -19
  561. package/dist/types/commit/analysis/validation.d.ts +0 -8
  562. package/dist/types/commit/changelog/detect.d.ts +0 -2
  563. package/dist/types/commit/changelog/generate.d.ts +0 -30
  564. package/dist/types/commit/changelog/index.d.ts +0 -30
  565. package/dist/types/commit/changelog/parse.d.ts +0 -2
  566. package/dist/types/commit/cli.d.ts +0 -3
  567. package/dist/types/commit/git/diff.d.ts +0 -5
  568. package/dist/types/commit/index.d.ts +0 -4
  569. package/dist/types/commit/map-reduce/index.d.ts +0 -28
  570. package/dist/types/commit/map-reduce/map-phase.d.ts +0 -17
  571. package/dist/types/commit/map-reduce/reduce-phase.d.ts +0 -13
  572. package/dist/types/commit/map-reduce/utils.d.ts +0 -2
  573. package/dist/types/commit/message.d.ts +0 -2
  574. package/dist/types/commit/model-selection.d.ts +0 -15
  575. package/dist/types/commit/pipeline.d.ts +0 -5
  576. package/dist/types/commit/shared-llm.d.ts +0 -54
  577. package/dist/types/commit/types.d.ts +0 -78
  578. package/dist/types/commit/utils/exclusions.d.ts +0 -4
  579. package/dist/types/commit/utils.d.ts +0 -20
  580. package/dist/types/config/config-file.d.ts +0 -58
  581. package/dist/types/config/file-lock-gc.d.ts +0 -5
  582. package/dist/types/config/file-lock.d.ts +0 -36
  583. package/dist/types/config/keybindings.d.ts +0 -364
  584. package/dist/types/config/model-equivalence.d.ts +0 -24
  585. package/dist/types/config/model-profile-activation.d.ts +0 -65
  586. package/dist/types/config/model-profiles.d.ts +0 -39
  587. package/dist/types/config/model-registry.d.ts +0 -473
  588. package/dist/types/config/model-resolver.d.ts +0 -217
  589. package/dist/types/config/models-config-schema.d.ts +0 -700
  590. package/dist/types/config/prompt-templates.d.ts +0 -32
  591. package/dist/types/config/resolve-config-value.d.ts +0 -17
  592. package/dist/types/config/settings-schema.d.ts +0 -4223
  593. package/dist/types/config/settings.d.ts +0 -158
  594. package/dist/types/config/skill-settings-defaults.d.ts +0 -14
  595. package/dist/types/config/telegram-autostart.d.ts +0 -14
  596. package/dist/types/config/telegram-env-bridge.d.ts +0 -18
  597. package/dist/types/config.d.ts +0 -66
  598. package/dist/types/coordinator/contract.d.ts +0 -4
  599. package/dist/types/coordinator-mcp/model-preset.d.ts +0 -45
  600. package/dist/types/coordinator-mcp/policy.d.ts +0 -27
  601. package/dist/types/coordinator-mcp/safety.d.ts +0 -26
  602. package/dist/types/coordinator-mcp/server.d.ts +0 -139
  603. package/dist/types/coordinator-mcp/session-reaper.d.ts +0 -53
  604. package/dist/types/cursor.d.ts +0 -24
  605. package/dist/types/daemon/builtin.d.ts +0 -20
  606. package/dist/types/daemon/control-types.d.ts +0 -67
  607. package/dist/types/daemon/operator-contract.d.ts +0 -47
  608. package/dist/types/daemon/runtime.d.ts +0 -25
  609. package/dist/types/dap/client.d.ts +0 -39
  610. package/dist/types/dap/config.d.ts +0 -6
  611. package/dist/types/dap/index.d.ts +0 -4
  612. package/dist/types/dap/session.d.ts +0 -108
  613. package/dist/types/dap/types.d.ts +0 -524
  614. package/dist/types/debug/crash-diagnostics.d.ts +0 -45
  615. package/dist/types/debug/index.d.ts +0 -15
  616. package/dist/types/debug/log-formatting.d.ts +0 -4
  617. package/dist/types/debug/log-viewer.d.ts +0 -68
  618. package/dist/types/debug/profiler.d.ts +0 -24
  619. package/dist/types/debug/raw-sse-buffer.d.ts +0 -44
  620. package/dist/types/debug/raw-sse.d.ts +0 -16
  621. package/dist/types/debug/report-bundle.d.ts +0 -55
  622. package/dist/types/debug/runtime-gauges.d.ts +0 -6
  623. package/dist/types/debug/system-info.d.ts +0 -26
  624. package/dist/types/deep-interview/plaintext-gate-guard.d.ts +0 -11
  625. package/dist/types/deep-interview/render-middleware.d.ts +0 -6
  626. package/dist/types/defaults/skc/extensions/grok-build/index.d.ts +0 -1
  627. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/index.d.ts +0 -1
  628. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/models/catalog.d.ts +0 -29
  629. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/payload/sanitize.d.ts +0 -27
  630. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/billing.d.ts +0 -8
  631. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/register.d.ts +0 -5
  632. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/stream.d.ts +0 -10
  633. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/usage.d.ts +0 -2
  634. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/shared/base-url.d.ts +0 -2
  635. package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/shared/errors.d.ts +0 -38
  636. package/dist/types/defaults/skc-defaults.d.ts +0 -64
  637. package/dist/types/defaults/skc-grok-cli.d.ts +0 -5
  638. package/dist/types/discovery/agents-md.d.ts +0 -1
  639. package/dist/types/discovery/agents.d.ts +0 -12
  640. package/dist/types/discovery/builtin.d.ts +0 -1
  641. package/dist/types/discovery/claude-plugins.d.ts +0 -1
  642. package/dist/types/discovery/claude.d.ts +0 -1
  643. package/dist/types/discovery/cline.d.ts +0 -1
  644. package/dist/types/discovery/codex.d.ts +0 -1
  645. package/dist/types/discovery/cursor.d.ts +0 -19
  646. package/dist/types/discovery/gemini.d.ts +0 -1
  647. package/dist/types/discovery/github.d.ts +0 -1
  648. package/dist/types/discovery/helpers.d.ts +0 -271
  649. package/dist/types/discovery/index.d.ts +0 -48
  650. package/dist/types/discovery/mcp-json.d.ts +0 -1
  651. package/dist/types/discovery/opencode.d.ts +0 -1
  652. package/dist/types/discovery/plugin-dir-roots.d.ts +0 -15
  653. package/dist/types/discovery/ssh.d.ts +0 -1
  654. package/dist/types/discovery/substitute-plugin-root.d.ts +0 -1
  655. package/dist/types/discovery/vscode.d.ts +0 -1
  656. package/dist/types/discovery/windsurf.d.ts +0 -15
  657. package/dist/types/edit/apply-patch/index.d.ts +0 -35
  658. package/dist/types/edit/apply-patch/parser.d.ts +0 -34
  659. package/dist/types/edit/diff.d.ts +0 -75
  660. package/dist/types/edit/file-read-cache.d.ts +0 -25
  661. package/dist/types/edit/index.d.ts +0 -58
  662. package/dist/types/edit/modes/apply-patch.d.ts +0 -24
  663. package/dist/types/edit/modes/patch.d.ts +0 -99
  664. package/dist/types/edit/modes/replace.d.ts +0 -149
  665. package/dist/types/edit/normalize.d.ts +0 -43
  666. package/dist/types/edit/notebook.d.ts +0 -26
  667. package/dist/types/edit/read-file.d.ts +0 -8
  668. package/dist/types/edit/renderer.d.ts +0 -110
  669. package/dist/types/edit/streaming.d.ts +0 -66
  670. package/dist/types/eval/backend.d.ts +0 -40
  671. package/dist/types/eval/index.d.ts +0 -4
  672. package/dist/types/eval/js/context-manager.d.ts +0 -27
  673. package/dist/types/eval/js/executor.d.ts +0 -29
  674. package/dist/types/eval/js/index.d.ts +0 -10
  675. package/dist/types/eval/js/shared/helpers.d.ts +0 -38
  676. package/dist/types/eval/js/shared/indirect-eval.d.ts +0 -14
  677. package/dist/types/eval/js/shared/prelude.d.ts +0 -1
  678. package/dist/types/eval/js/shared/rewrite-imports.d.ts +0 -6
  679. package/dist/types/eval/js/shared/runtime.d.ts +0 -47
  680. package/dist/types/eval/js/shared/types.d.ts +0 -24
  681. package/dist/types/eval/js/tool-bridge.d.ts +0 -18
  682. package/dist/types/eval/js/worker-core.d.ts +0 -5
  683. package/dist/types/eval/js/worker-entry.d.ts +0 -1
  684. package/dist/types/eval/js/worker-protocol.d.ts +0 -77
  685. package/dist/types/eval/py/display.d.ts +0 -25
  686. package/dist/types/eval/py/executor.d.ts +0 -88
  687. package/dist/types/eval/py/index.d.ts +0 -10
  688. package/dist/types/eval/py/kernel.d.ts +0 -65
  689. package/dist/types/eval/py/prelude.d.ts +0 -1
  690. package/dist/types/eval/py/runtime.d.ts +0 -29
  691. package/dist/types/eval/py/tool-bridge.d.ts +0 -20
  692. package/dist/types/eval/types.d.ts +0 -52
  693. package/dist/types/exa/factory.d.ts +0 -13
  694. package/dist/types/exa/index.d.ts +0 -20
  695. package/dist/types/exa/mcp-client.d.ts +0 -45
  696. package/dist/types/exa/render.d.ts +0 -19
  697. package/dist/types/exa/researcher.d.ts +0 -9
  698. package/dist/types/exa/search.d.ts +0 -9
  699. package/dist/types/exa/types.d.ts +0 -155
  700. package/dist/types/exa/websets.d.ts +0 -9
  701. package/dist/types/exec/bash-executor.d.ts +0 -64
  702. package/dist/types/exec/exec.d.ts +0 -25
  703. package/dist/types/exec/idle-timeout-watchdog.d.ts +0 -18
  704. package/dist/types/exec/non-interactive-env.d.ts +0 -1
  705. package/dist/types/export/custom-share.d.ts +0 -20
  706. package/dist/types/export/html/index.d.ts +0 -10
  707. package/dist/types/export/html/template.generated.d.ts +0 -1
  708. package/dist/types/export/html/template.macro.d.ts +0 -5
  709. package/dist/types/export/ttsr.d.ts +0 -55
  710. package/dist/types/extensibility/custom-commands/bundled/ci-green/index.d.ts +0 -9
  711. package/dist/types/extensibility/custom-commands/index.d.ts +0 -2
  712. package/dist/types/extensibility/custom-commands/loader.d.ts +0 -29
  713. package/dist/types/extensibility/custom-commands/types.d.ts +0 -106
  714. package/dist/types/extensibility/custom-tools/index.d.ts +0 -6
  715. package/dist/types/extensibility/custom-tools/loader.d.ts +0 -69
  716. package/dist/types/extensibility/custom-tools/types.d.ts +0 -229
  717. package/dist/types/extensibility/custom-tools/wrapper.d.ts +0 -24
  718. package/dist/types/extensibility/extensions/compact-handler.d.ts +0 -26
  719. package/dist/types/extensibility/extensions/get-commands-handler.d.ts +0 -29
  720. package/dist/types/extensibility/extensions/index.d.ts +0 -9
  721. package/dist/types/extensibility/extensions/loader.d.ts +0 -43
  722. package/dist/types/extensibility/extensions/prefix-command-bridge.d.ts +0 -35
  723. package/dist/types/extensibility/extensions/runner.d.ts +0 -135
  724. package/dist/types/extensibility/extensions/types.d.ts +0 -920
  725. package/dist/types/extensibility/extensions/wrapper.d.ts +0 -55
  726. package/dist/types/extensibility/hooks/index.d.ts +0 -5
  727. package/dist/types/extensibility/hooks/loader.d.ts +0 -89
  728. package/dist/types/extensibility/hooks/runner.d.ts +0 -126
  729. package/dist/types/extensibility/hooks/tool-wrapper.d.ts +0 -25
  730. package/dist/types/extensibility/hooks/types.d.ts +0 -431
  731. package/dist/types/extensibility/plugins/doctor.d.ts +0 -3
  732. package/dist/types/extensibility/plugins/git-url.d.ts +0 -34
  733. package/dist/types/extensibility/plugins/index.d.ts +0 -8
  734. package/dist/types/extensibility/plugins/installer.d.ts +0 -5
  735. package/dist/types/extensibility/plugins/legacy-pi-compat.d.ts +0 -2
  736. package/dist/types/extensibility/plugins/loader.d.ts +0 -31
  737. package/dist/types/extensibility/plugins/manager.d.ts +0 -65
  738. package/dist/types/extensibility/plugins/marketplace/cache.d.ts +0 -41
  739. package/dist/types/extensibility/plugins/marketplace/fetcher.d.ts +0 -48
  740. package/dist/types/extensibility/plugins/marketplace/index.d.ts +0 -6
  741. package/dist/types/extensibility/plugins/marketplace/manager.d.ts +0 -57
  742. package/dist/types/extensibility/plugins/marketplace/registry.d.ts +0 -34
  743. package/dist/types/extensibility/plugins/marketplace/source-resolver.d.ts +0 -28
  744. package/dist/types/extensibility/plugins/marketplace/types.d.ts +0 -130
  745. package/dist/types/extensibility/plugins/parser.d.ts +0 -52
  746. package/dist/types/extensibility/plugins/security-scanner.d.ts +0 -31
  747. package/dist/types/extensibility/plugins/types.d.ts +0 -149
  748. package/dist/types/extensibility/runtime-skill-discovery.d.ts +0 -20
  749. package/dist/types/extensibility/shared-events.d.ts +0 -281
  750. package/dist/types/extensibility/skc-plugins/activation.d.ts +0 -14
  751. package/dist/types/extensibility/skc-plugins/compiler.d.ts +0 -19
  752. package/dist/types/extensibility/skc-plugins/constrained-hooks.d.ts +0 -29
  753. package/dist/types/extensibility/skc-plugins/index.d.ts +0 -18
  754. package/dist/types/extensibility/skc-plugins/injection.d.ts +0 -40
  755. package/dist/types/extensibility/skc-plugins/installer.d.ts +0 -13
  756. package/dist/types/extensibility/skc-plugins/loader.d.ts +0 -3
  757. package/dist/types/extensibility/skc-plugins/mcp-policy.d.ts +0 -26
  758. package/dist/types/extensibility/skc-plugins/observability.d.ts +0 -27
  759. package/dist/types/extensibility/skc-plugins/paths.d.ts +0 -8
  760. package/dist/types/extensibility/skc-plugins/prompt-appendix.d.ts +0 -16
  761. package/dist/types/extensibility/skc-plugins/registry.d.ts +0 -32
  762. package/dist/types/extensibility/skc-plugins/runtime-adapters.d.ts +0 -64
  763. package/dist/types/extensibility/skc-plugins/schema.d.ts +0 -3
  764. package/dist/types/extensibility/skc-plugins/session-validation.d.ts +0 -42
  765. package/dist/types/extensibility/skc-plugins/state.d.ts +0 -9
  766. package/dist/types/extensibility/skc-plugins/tools.d.ts +0 -8
  767. package/dist/types/extensibility/skc-plugins/types.d.ts +0 -220
  768. package/dist/types/extensibility/skc-plugins/validation.d.ts +0 -11
  769. package/dist/types/extensibility/skills.d.ts +0 -82
  770. package/dist/types/extensibility/slash-commands.d.ts +0 -48
  771. package/dist/types/extensibility/tool-proxy.d.ts +0 -4
  772. package/dist/types/extensibility/typebox.d.ts +0 -155
  773. package/dist/types/extensibility/utils.d.ts +0 -12
  774. package/dist/types/goals/index.d.ts +0 -3
  775. package/dist/types/goals/runtime.d.ts +0 -63
  776. package/dist/types/goals/state.d.ts +0 -32
  777. package/dist/types/goals/tools/goal-tool.d.ts +0 -62
  778. package/dist/types/harness-control-plane/classifier.d.ts +0 -13
  779. package/dist/types/harness-control-plane/control-endpoint.d.ts +0 -31
  780. package/dist/types/harness-control-plane/finalize.d.ts +0 -60
  781. package/dist/types/harness-control-plane/gc-adapter.d.ts +0 -3
  782. package/dist/types/harness-control-plane/operate.d.ts +0 -35
  783. package/dist/types/harness-control-plane/owner.d.ts +0 -53
  784. package/dist/types/harness-control-plane/phase-rollup.d.ts +0 -23
  785. package/dist/types/harness-control-plane/preserve.d.ts +0 -19
  786. package/dist/types/harness-control-plane/receipt-ingest.d.ts +0 -19
  787. package/dist/types/harness-control-plane/receipt-spool.d.ts +0 -19
  788. package/dist/types/harness-control-plane/receipts.d.ts +0 -149
  789. package/dist/types/harness-control-plane/rpc-adapter.d.ts +0 -69
  790. package/dist/types/harness-control-plane/seams.d.ts +0 -21
  791. package/dist/types/harness-control-plane/session-lease.d.ts +0 -65
  792. package/dist/types/harness-control-plane/state-machine.d.ts +0 -24
  793. package/dist/types/harness-control-plane/storage.d.ts +0 -81
  794. package/dist/types/harness-control-plane/types.d.ts +0 -187
  795. package/dist/types/hashline/anchors.d.ts +0 -20
  796. package/dist/types/hashline/apply.d.ts +0 -14
  797. package/dist/types/hashline/constants.d.ts +0 -19
  798. package/dist/types/hashline/diff-preview.d.ts +0 -2
  799. package/dist/types/hashline/diff.d.ts +0 -17
  800. package/dist/types/hashline/execute.d.ts +0 -4
  801. package/dist/types/hashline/hash.d.ts +0 -123
  802. package/dist/types/hashline/index.d.ts +0 -13
  803. package/dist/types/hashline/input.d.ts +0 -11
  804. package/dist/types/hashline/parser.d.ts +0 -7
  805. package/dist/types/hashline/prefixes.d.ts +0 -7
  806. package/dist/types/hashline/recovery.d.ts +0 -27
  807. package/dist/types/hashline/stream.d.ts +0 -2
  808. package/dist/types/hashline/types.d.ts +0 -77
  809. package/dist/types/hindsight/backend.d.ts +0 -13
  810. package/dist/types/hindsight/bank.d.ts +0 -54
  811. package/dist/types/hindsight/client.d.ts +0 -224
  812. package/dist/types/hindsight/config.d.ts +0 -51
  813. package/dist/types/hindsight/content.d.ts +0 -70
  814. package/dist/types/hindsight/index.d.ts +0 -8
  815. package/dist/types/hindsight/mental-models.d.ts +0 -125
  816. package/dist/types/hindsight/state.d.ts +0 -99
  817. package/dist/types/hindsight/transcript.d.ts +0 -28
  818. package/dist/types/hooks/codex-native-hooks-config.d.ts +0 -29
  819. package/dist/types/hooks/native-skill-hook.d.ts +0 -28
  820. package/dist/types/hooks/skill-keywords.d.ts +0 -18
  821. package/dist/types/hooks/skill-state.d.ts +0 -93
  822. package/dist/types/i18n/index.d.ts +0 -38
  823. package/dist/types/i18n/messages/de.d.ts +0 -2
  824. package/dist/types/i18n/messages/de.messages.d.ts +0 -1
  825. package/dist/types/i18n/messages/de.settings.d.ts +0 -1
  826. package/dist/types/i18n/messages/en.d.ts +0 -81
  827. package/dist/types/i18n/messages/es.d.ts +0 -2
  828. package/dist/types/i18n/messages/es.messages.d.ts +0 -1
  829. package/dist/types/i18n/messages/es.settings.d.ts +0 -1
  830. package/dist/types/i18n/messages/fr.d.ts +0 -2
  831. package/dist/types/i18n/messages/fr.messages.d.ts +0 -1
  832. package/dist/types/i18n/messages/fr.settings.d.ts +0 -1
  833. package/dist/types/i18n/messages/ja.d.ts +0 -2
  834. package/dist/types/i18n/messages/ja.messages.d.ts +0 -1
  835. package/dist/types/i18n/messages/ja.settings.d.ts +0 -1
  836. package/dist/types/i18n/messages/ko.d.ts +0 -2
  837. package/dist/types/i18n/messages/ko.messages.d.ts +0 -1
  838. package/dist/types/i18n/messages/ko.settings.d.ts +0 -1
  839. package/dist/types/i18n/messages/zh.d.ts +0 -2
  840. package/dist/types/i18n/messages/zh.messages.d.ts +0 -1
  841. package/dist/types/i18n/messages/zh.settings.d.ts +0 -1
  842. package/dist/types/index.d.ts +0 -33
  843. package/dist/types/internal-urls/agent-protocol.d.ts +0 -12
  844. package/dist/types/internal-urls/artifact-protocol.d.ts +0 -6
  845. package/dist/types/internal-urls/docs-index.generated.d.ts +0 -2
  846. package/dist/types/internal-urls/index.d.ts +0 -20
  847. package/dist/types/internal-urls/issue-pr-protocol.d.ts +0 -17
  848. package/dist/types/internal-urls/json-query.d.ts +0 -30
  849. package/dist/types/internal-urls/local-protocol.d.ts +0 -43
  850. package/dist/types/internal-urls/mcp-protocol.d.ts +0 -12
  851. package/dist/types/internal-urls/memory-protocol.d.ts +0 -23
  852. package/dist/types/internal-urls/parse.d.ts +0 -19
  853. package/dist/types/internal-urls/registry-helpers.d.ts +0 -11
  854. package/dist/types/internal-urls/router.d.ts +0 -14
  855. package/dist/types/internal-urls/rule-protocol.d.ts +0 -6
  856. package/dist/types/internal-urls/skc-protocol.d.ts +0 -12
  857. package/dist/types/internal-urls/skill-protocol.d.ts +0 -13
  858. package/dist/types/internal-urls/types.d.ts +0 -109
  859. package/dist/types/lsp/client.d.ts +0 -66
  860. package/dist/types/lsp/clients/biome-client.d.ts +0 -16
  861. package/dist/types/lsp/clients/index.d.ts +0 -19
  862. package/dist/types/lsp/clients/lsp-linter-client.d.ts +0 -16
  863. package/dist/types/lsp/clients/swiftlint-client.d.ts +0 -20
  864. package/dist/types/lsp/config.d.ts +0 -65
  865. package/dist/types/lsp/edits.d.ts +0 -23
  866. package/dist/types/lsp/index.d.ts +0 -130
  867. package/dist/types/lsp/lspmux.d.ts +0 -58
  868. package/dist/types/lsp/render.d.ts +0 -32
  869. package/dist/types/lsp/startup-events.d.ts +0 -12
  870. package/dist/types/lsp/types.d.ts +0 -306
  871. package/dist/types/lsp/utils.d.ts +0 -108
  872. package/dist/types/main.d.ts +0 -139
  873. package/dist/types/memories/index.d.ts +0 -28
  874. package/dist/types/memories/storage.d.ts +0 -110
  875. package/dist/types/memory-backend/index.d.ts +0 -4
  876. package/dist/types/memory-backend/local-backend.d.ts +0 -9
  877. package/dist/types/memory-backend/off-backend.d.ts +0 -7
  878. package/dist/types/memory-backend/resolve.d.ts +0 -15
  879. package/dist/types/memory-backend/types.d.ts +0 -61
  880. package/dist/types/migrate/action-planner.d.ts +0 -11
  881. package/dist/types/migrate/adapters/claude-code.d.ts +0 -2
  882. package/dist/types/migrate/adapters/codex.d.ts +0 -5
  883. package/dist/types/migrate/adapters/index.d.ts +0 -45
  884. package/dist/types/migrate/adapters/opencode.d.ts +0 -2
  885. package/dist/types/migrate/executor.d.ts +0 -2
  886. package/dist/types/migrate/mcp-mapper.d.ts +0 -20
  887. package/dist/types/migrate/report.d.ts +0 -18
  888. package/dist/types/migrate/skill-normalizer.d.ts +0 -27
  889. package/dist/types/migrate/types.d.ts +0 -126
  890. package/dist/types/modes/acp/acp-agent.d.ts +0 -78
  891. package/dist/types/modes/acp/acp-client-bridge.d.ts +0 -9
  892. package/dist/types/modes/acp/acp-event-mapper.d.ts +0 -36
  893. package/dist/types/modes/acp/acp-mode.d.ts +0 -17
  894. package/dist/types/modes/acp/index.d.ts +0 -2
  895. package/dist/types/modes/acp/terminal-auth.d.ts +0 -6
  896. package/dist/types/modes/bridge/auth.d.ts +0 -12
  897. package/dist/types/modes/bridge/bridge-client-bridge.d.ts +0 -9
  898. package/dist/types/modes/bridge/bridge-mode.d.ts +0 -47
  899. package/dist/types/modes/bridge/bridge-ui-context.d.ts +0 -88
  900. package/dist/types/modes/bridge/event-stream.d.ts +0 -8
  901. package/dist/types/modes/components/agent-dashboard.d.ts +0 -21
  902. package/dist/types/modes/components/assistant-message.d.ts +0 -20
  903. package/dist/types/modes/components/bash-execution.d.ts +0 -29
  904. package/dist/types/modes/components/bordered-loader.d.ts +0 -11
  905. package/dist/types/modes/components/branch-summary-message.d.ts +0 -13
  906. package/dist/types/modes/components/btw-panel.d.ts +0 -16
  907. package/dist/types/modes/components/compaction-summary-message.d.ts +0 -13
  908. package/dist/types/modes/components/countdown-timer.d.ts +0 -14
  909. package/dist/types/modes/components/custom-editor.d.ts +0 -69
  910. package/dist/types/modes/components/custom-message.d.ts +0 -15
  911. package/dist/types/modes/components/custom-model-preset-wizard.d.ts +0 -12
  912. package/dist/types/modes/components/custom-provider-wizard.d.ts +0 -10
  913. package/dist/types/modes/components/diff.d.ts +0 -11
  914. package/dist/types/modes/components/dynamic-border.d.ts +0 -14
  915. package/dist/types/modes/components/eval-execution.d.ts +0 -23
  916. package/dist/types/modes/components/execution-shared.d.ts +0 -46
  917. package/dist/types/modes/components/extensions/extension-dashboard.d.ts +0 -26
  918. package/dist/types/modes/components/extensions/extension-list.d.ts +0 -39
  919. package/dist/types/modes/components/extensions/index.d.ts +0 -8
  920. package/dist/types/modes/components/extensions/inspector-panel.d.ts +0 -8
  921. package/dist/types/modes/components/extensions/state-manager.d.ts +0 -50
  922. package/dist/types/modes/components/extensions/types.d.ts +0 -151
  923. package/dist/types/modes/components/footer.d.ts +0 -30
  924. package/dist/types/modes/components/history-search.d.ts +0 -7
  925. package/dist/types/modes/components/hook-editor.d.ts +0 -18
  926. package/dist/types/modes/components/hook-input.d.ts +0 -15
  927. package/dist/types/modes/components/hook-message.d.ts +0 -15
  928. package/dist/types/modes/components/hook-selector.d.ts +0 -59
  929. package/dist/types/modes/components/index.d.ts +0 -35
  930. package/dist/types/modes/components/irc-sidebar.d.ts +0 -32
  931. package/dist/types/modes/components/jobs-overlay-model.d.ts +0 -31
  932. package/dist/types/modes/components/jobs-overlay.d.ts +0 -30
  933. package/dist/types/modes/components/keybinding-hints.d.ts +0 -40
  934. package/dist/types/modes/components/login-dialog.d.ts +0 -32
  935. package/dist/types/modes/components/message-frame.d.ts +0 -42
  936. package/dist/types/modes/components/model-selector.d.ts +0 -60
  937. package/dist/types/modes/components/oauth-selector.d.ts +0 -17
  938. package/dist/types/modes/components/pet-selector.d.ts +0 -11
  939. package/dist/types/modes/components/plugin-selector.d.ts +0 -26
  940. package/dist/types/modes/components/plugin-settings.d.ts +0 -66
  941. package/dist/types/modes/components/provider-onboarding-selector.d.ts +0 -7
  942. package/dist/types/modes/components/queue-mode-selector.d.ts +0 -9
  943. package/dist/types/modes/components/queued-message-selector.d.ts +0 -12
  944. package/dist/types/modes/components/read-tool-group.d.ts +0 -30
  945. package/dist/types/modes/components/runtime-mcp-add-wizard.d.ts +0 -26
  946. package/dist/types/modes/components/sayknow-pet-widget.d.ts +0 -59
  947. package/dist/types/modes/components/session-observer-overlay.d.ts +0 -11
  948. package/dist/types/modes/components/session-selector.d.ts +0 -43
  949. package/dist/types/modes/components/settings-defs.d.ts +0 -50
  950. package/dist/types/modes/components/settings-selector.d.ts +0 -64
  951. package/dist/types/modes/components/show-images-selector.d.ts +0 -9
  952. package/dist/types/modes/components/skill-hud/render.d.ts +0 -2
  953. package/dist/types/modes/components/skill-message.d.ts +0 -10
  954. package/dist/types/modes/components/status-line/context-thresholds.d.ts +0 -4
  955. package/dist/types/modes/components/status-line/git-utils.d.ts +0 -28
  956. package/dist/types/modes/components/status-line/index.d.ts +0 -4
  957. package/dist/types/modes/components/status-line/presets.d.ts +0 -3
  958. package/dist/types/modes/components/status-line/segments.d.ts +0 -5
  959. package/dist/types/modes/components/status-line/separators.d.ts +0 -3
  960. package/dist/types/modes/components/status-line/token-rate.d.ts +0 -10
  961. package/dist/types/modes/components/status-line/types.d.ts +0 -83
  962. package/dist/types/modes/components/status-line.d.ts +0 -94
  963. package/dist/types/modes/components/theme-selector.d.ts +0 -10
  964. package/dist/types/modes/components/thinking-selector.d.ts +0 -15
  965. package/dist/types/modes/components/todo-reminder.d.ts +0 -13
  966. package/dist/types/modes/components/tool-execution.d.ts +0 -55
  967. package/dist/types/modes/components/tree-selector.d.ts +0 -31
  968. package/dist/types/modes/components/ttsr-notification.d.ts +0 -13
  969. package/dist/types/modes/components/two-column-body.d.ts +0 -9
  970. package/dist/types/modes/components/user-message-selector.d.ts +0 -28
  971. package/dist/types/modes/components/user-message.d.ts +0 -8
  972. package/dist/types/modes/components/visual-truncate.d.ts +0 -19
  973. package/dist/types/modes/components/welcome.d.ts +0 -46
  974. package/dist/types/modes/controllers/btw-controller.d.ts +0 -10
  975. package/dist/types/modes/controllers/command-controller-shared.d.ts +0 -47
  976. package/dist/types/modes/controllers/command-controller.d.ts +0 -40
  977. package/dist/types/modes/controllers/event-controller.d.ts +0 -21
  978. package/dist/types/modes/controllers/extension-ui-controller.d.ts +0 -80
  979. package/dist/types/modes/controllers/input-controller.d.ts +0 -42
  980. package/dist/types/modes/controllers/runtime-mcp-command-controller.d.ts +0 -10
  981. package/dist/types/modes/controllers/selector-controller.d.ts +0 -68
  982. package/dist/types/modes/controllers/ssh-command-controller.d.ts +0 -10
  983. package/dist/types/modes/controllers/todo-command-controller.d.ts +0 -7
  984. package/dist/types/modes/emoji-autocomplete.d.ts +0 -16
  985. package/dist/types/modes/index.d.ts +0 -10
  986. package/dist/types/modes/interactive-mode.d.ts +0 -297
  987. package/dist/types/modes/irc-observation-ledger.d.ts +0 -22
  988. package/dist/types/modes/jobs-observer.d.ts +0 -57
  989. package/dist/types/modes/oauth-manual-input.d.ts +0 -8
  990. package/dist/types/modes/print-mode.d.ts +0 -44
  991. package/dist/types/modes/prompt-action-autocomplete.d.ts +0 -50
  992. package/dist/types/modes/rpc/host-tools.d.ts +0 -1
  993. package/dist/types/modes/rpc/host-uris.d.ts +0 -1
  994. package/dist/types/modes/rpc/rpc-client.d.ts +0 -299
  995. package/dist/types/modes/rpc/rpc-mode.d.ts +0 -86
  996. package/dist/types/modes/rpc/rpc-socket-security.d.ts +0 -10
  997. package/dist/types/modes/rpc/rpc-types.d.ts +0 -810
  998. package/dist/types/modes/runtime-init.d.ts +0 -21
  999. package/dist/types/modes/session-observer-registry.d.ts +0 -26
  1000. package/dist/types/modes/shared/agent-wire/approval-gate.d.ts +0 -57
  1001. package/dist/types/modes/shared/agent-wire/command-contract.d.ts +0 -18
  1002. package/dist/types/modes/shared/agent-wire/command-dispatch.d.ts +0 -37
  1003. package/dist/types/modes/shared/agent-wire/command-validation.d.ts +0 -2
  1004. package/dist/types/modes/shared/agent-wire/deep-interview-gate.d.ts +0 -102
  1005. package/dist/types/modes/shared/agent-wire/event-contract.d.ts +0 -103
  1006. package/dist/types/modes/shared/agent-wire/event-envelope.d.ts +0 -60
  1007. package/dist/types/modes/shared/agent-wire/event-observation.d.ts +0 -37
  1008. package/dist/types/modes/shared/agent-wire/handshake.d.ts +0 -56
  1009. package/dist/types/modes/shared/agent-wire/host-tool-bridge.d.ts +0 -16
  1010. package/dist/types/modes/shared/agent-wire/host-uri-bridge.d.ts +0 -17
  1011. package/dist/types/modes/shared/agent-wire/protocol.d.ts +0 -25
  1012. package/dist/types/modes/shared/agent-wire/responses.d.ts +0 -4
  1013. package/dist/types/modes/shared/agent-wire/scopes.d.ts +0 -18
  1014. package/dist/types/modes/shared/agent-wire/session-registry.d.ts +0 -25
  1015. package/dist/types/modes/shared/agent-wire/ui-request-broker.d.ts +0 -42
  1016. package/dist/types/modes/shared/agent-wire/ui-result.d.ts +0 -27
  1017. package/dist/types/modes/shared/agent-wire/unattended-action-policy.d.ts +0 -29
  1018. package/dist/types/modes/shared/agent-wire/unattended-audit.d.ts +0 -68
  1019. package/dist/types/modes/shared/agent-wire/unattended-run-controller.d.ts +0 -166
  1020. package/dist/types/modes/shared/agent-wire/unattended-session.d.ts +0 -127
  1021. package/dist/types/modes/shared/agent-wire/workflow-gate-broker.d.ts +0 -154
  1022. package/dist/types/modes/shared/agent-wire/workflow-gate-schema.d.ts +0 -39
  1023. package/dist/types/modes/shared.d.ts +0 -15
  1024. package/dist/types/modes/slash-command-visibility.d.ts +0 -1
  1025. package/dist/types/modes/theme/defaults/index.d.ts +0 -652
  1026. package/dist/types/modes/theme/mermaid-cache.d.ts +0 -9
  1027. package/dist/types/modes/theme/shimmer.d.ts +0 -38
  1028. package/dist/types/modes/theme/theme.d.ts +0 -275
  1029. package/dist/types/modes/tmux-scroll.d.ts +0 -18
  1030. package/dist/types/modes/types.d.ts +0 -318
  1031. package/dist/types/modes/utils/abort-message.d.ts +0 -4
  1032. package/dist/types/modes/utils/context-usage.d.ts +0 -36
  1033. package/dist/types/modes/utils/hotkeys-markdown.d.ts +0 -5
  1034. package/dist/types/modes/utils/injected-user-submission.d.ts +0 -52
  1035. package/dist/types/modes/utils/irc-message.d.ts +0 -38
  1036. package/dist/types/modes/utils/keybinding-matchers.d.ts +0 -10
  1037. package/dist/types/modes/utils/terminal-bell.d.ts +0 -3
  1038. package/dist/types/modes/utils/tools-markdown.d.ts +0 -5
  1039. package/dist/types/modes/utils/ui-helpers.d.ts +0 -75
  1040. package/dist/types/notifications/attachment-registry.d.ts +0 -17
  1041. package/dist/types/notifications/chat-adapters.d.ts +0 -9
  1042. package/dist/types/notifications/config-commands.d.ts +0 -64
  1043. package/dist/types/notifications/config.d.ts +0 -132
  1044. package/dist/types/notifications/daemon-paths.d.ts +0 -17
  1045. package/dist/types/notifications/engine.d.ts +0 -59
  1046. package/dist/types/notifications/helpers.d.ts +0 -55
  1047. package/dist/types/notifications/html-format.d.ts +0 -75
  1048. package/dist/types/notifications/index.d.ts +0 -219
  1049. package/dist/types/notifications/lifecycle-commands.d.ts +0 -69
  1050. package/dist/types/notifications/lifecycle-control-runtime.d.ts +0 -107
  1051. package/dist/types/notifications/lifecycle-orchestrator.d.ts +0 -144
  1052. package/dist/types/notifications/managed-daemon.d.ts +0 -48
  1053. package/dist/types/notifications/notification-service.d.ts +0 -144
  1054. package/dist/types/notifications/operator-runtime.d.ts +0 -52
  1055. package/dist/types/notifications/rate-limit-pool.d.ts +0 -113
  1056. package/dist/types/notifications/recent-activity.d.ts +0 -39
  1057. package/dist/types/notifications/reply-sent-store.d.ts +0 -53
  1058. package/dist/types/notifications/rich-draft.d.ts +0 -68
  1059. package/dist/types/notifications/rich-render.d.ts +0 -90
  1060. package/dist/types/notifications/telegram-cli.d.ts +0 -19
  1061. package/dist/types/notifications/telegram-daemon-cli.d.ts +0 -28
  1062. package/dist/types/notifications/telegram-daemon-control.d.ts +0 -70
  1063. package/dist/types/notifications/telegram-daemon.d.ts +0 -558
  1064. package/dist/types/notifications/telegram-reference.d.ts +0 -136
  1065. package/dist/types/notifications/threaded-inbound.d.ts +0 -77
  1066. package/dist/types/notifications/threaded-render.d.ts +0 -88
  1067. package/dist/types/notifications/topic-registry.d.ts +0 -89
  1068. package/dist/types/plan-mode/approved-plan.d.ts +0 -49
  1069. package/dist/types/plan-mode/state.d.ts +0 -6
  1070. package/dist/types/registry/agent-registry.d.ts +0 -64
  1071. package/dist/types/reminders/star-reminder.d.ts +0 -115
  1072. package/dist/types/research-plan/index.d.ts +0 -1
  1073. package/dist/types/research-plan/ledger.d.ts +0 -33
  1074. package/dist/types/rlm/artifacts.d.ts +0 -9
  1075. package/dist/types/rlm/complete-research-tool.d.ts +0 -35
  1076. package/dist/types/rlm/data-context.d.ts +0 -6
  1077. package/dist/types/rlm/index.d.ts +0 -47
  1078. package/dist/types/rlm/notebook.d.ts +0 -12
  1079. package/dist/types/rlm/preset.d.ts +0 -23
  1080. package/dist/types/rlm/python-tool.d.ts +0 -16
  1081. package/dist/types/rlm/report.d.ts +0 -14
  1082. package/dist/types/rlm/types.d.ts +0 -37
  1083. package/dist/types/runtime/process-lifecycle.d.ts +0 -108
  1084. package/dist/types/runtime-api-key.d.ts +0 -7
  1085. package/dist/types/runtime-credential-selector.d.ts +0 -7
  1086. package/dist/types/runtime-mcp/client.d.ts +0 -74
  1087. package/dist/types/runtime-mcp/config-writer.d.ts +0 -89
  1088. package/dist/types/runtime-mcp/config.d.ts +0 -77
  1089. package/dist/types/runtime-mcp/discoverable-tool-metadata.d.ts +0 -7
  1090. package/dist/types/runtime-mcp/index.d.ts +0 -18
  1091. package/dist/types/runtime-mcp/json-rpc.d.ts +0 -22
  1092. package/dist/types/runtime-mcp/loader.d.ts +0 -45
  1093. package/dist/types/runtime-mcp/manager.d.ts +0 -195
  1094. package/dist/types/runtime-mcp/oauth-discovery.d.ts +0 -40
  1095. package/dist/types/runtime-mcp/oauth-flow.d.ts +0 -59
  1096. package/dist/types/runtime-mcp/render.d.ts +0 -25
  1097. package/dist/types/runtime-mcp/smithery-auth.d.ts +0 -16
  1098. package/dist/types/runtime-mcp/smithery-connect.d.ts +0 -38
  1099. package/dist/types/runtime-mcp/smithery-registry.d.ts +0 -51
  1100. package/dist/types/runtime-mcp/tool-bridge.d.ts +0 -86
  1101. package/dist/types/runtime-mcp/tool-cache.d.ts +0 -8
  1102. package/dist/types/runtime-mcp/transports/http.d.ts +0 -36
  1103. package/dist/types/runtime-mcp/transports/index.d.ts +0 -5
  1104. package/dist/types/runtime-mcp/transports/stdio.d.ts +0 -29
  1105. package/dist/types/runtime-mcp/types.d.ts +0 -349
  1106. package/dist/types/sdk.d.ts +0 -256
  1107. package/dist/types/secrets/index.d.ts +0 -9
  1108. package/dist/types/secrets/obfuscator.d.ts +0 -23
  1109. package/dist/types/secrets/regex.d.ts +0 -2
  1110. package/dist/types/session/agent-session.d.ts +0 -1238
  1111. package/dist/types/session/agent-storage.d.ts +0 -101
  1112. package/dist/types/session/artifacts.d.ts +0 -64
  1113. package/dist/types/session/auth-broker-config.d.ts +0 -13
  1114. package/dist/types/session/auth-storage.d.ts +0 -6
  1115. package/dist/types/session/blob-store.d.ts +0 -160
  1116. package/dist/types/session/cache-economics.d.ts +0 -79
  1117. package/dist/types/session/client-bridge.d.ts +0 -88
  1118. package/dist/types/session/context-estimation.d.ts +0 -31
  1119. package/dist/types/session/contribution-prep.d.ts +0 -47
  1120. package/dist/types/session/file-mention-pruning.d.ts +0 -8
  1121. package/dist/types/session/history-storage.d.ts +0 -16
  1122. package/dist/types/session/messages.d.ts +0 -169
  1123. package/dist/types/session/provider-safety-stop.d.ts +0 -5
  1124. package/dist/types/session/session-dump-format.d.ts +0 -22
  1125. package/dist/types/session/session-manager.d.ts +0 -781
  1126. package/dist/types/session/session-storage.d.ts +0 -230
  1127. package/dist/types/session/streaming-output.d.ts +0 -209
  1128. package/dist/types/session/tool-choice-queue.d.ts +0 -84
  1129. package/dist/types/session/yield-queue.d.ts +0 -24
  1130. package/dist/types/setup/credential-auto-import.d.ts +0 -63
  1131. package/dist/types/setup/credential-import.d.ts +0 -82
  1132. package/dist/types/setup/hermes-setup.d.ts +0 -78
  1133. package/dist/types/setup/host-plugin-setup.d.ts +0 -39
  1134. package/dist/types/setup/model-onboarding-guidance.d.ts +0 -9
  1135. package/dist/types/setup/provider-onboarding.d.ts +0 -52
  1136. package/dist/types/skc-runtime/cli-write-receipt.d.ts +0 -24
  1137. package/dist/types/skc-runtime/deep-interview-ambiguity.d.ts +0 -39
  1138. package/dist/types/skc-runtime/deep-interview-recorder.d.ts +0 -114
  1139. package/dist/types/skc-runtime/deep-interview-runtime.d.ts +0 -36
  1140. package/dist/types/skc-runtime/deep-interview-state.d.ts +0 -127
  1141. package/dist/types/skc-runtime/gc-render.d.ts +0 -6
  1142. package/dist/types/skc-runtime/gc-runtime.d.ts +0 -134
  1143. package/dist/types/skc-runtime/goal-mode-request.d.ts +0 -53
  1144. package/dist/types/skc-runtime/launch-tmux.d.ts +0 -78
  1145. package/dist/types/skc-runtime/launch-worktree.d.ts +0 -46
  1146. package/dist/types/skc-runtime/ledger-event-renderer.d.ts +0 -68
  1147. package/dist/types/skc-runtime/psmux-detect.d.ts +0 -78
  1148. package/dist/types/skc-runtime/ralplan-runtime.d.ts +0 -26
  1149. package/dist/types/skc-runtime/restricted-role-agent-bash.d.ts +0 -3
  1150. package/dist/types/skc-runtime/session-layout.d.ts +0 -59
  1151. package/dist/types/skc-runtime/session-resolution.d.ts +0 -47
  1152. package/dist/types/skc-runtime/session-state-sidecar.d.ts +0 -70
  1153. package/dist/types/skc-runtime/state-graph.d.ts +0 -4
  1154. package/dist/types/skc-runtime/state-migrations.d.ts +0 -33
  1155. package/dist/types/skc-runtime/state-renderer.d.ts +0 -70
  1156. package/dist/types/skc-runtime/state-runtime.d.ts +0 -38
  1157. package/dist/types/skc-runtime/state-schema.d.ts +0 -319
  1158. package/dist/types/skc-runtime/state-validation.d.ts +0 -6
  1159. package/dist/types/skc-runtime/state-writer.d.ts +0 -244
  1160. package/dist/types/skc-runtime/team-gc.d.ts +0 -7
  1161. package/dist/types/skc-runtime/team-runtime.d.ts +0 -355
  1162. package/dist/types/skc-runtime/tmux-common.d.ts +0 -111
  1163. package/dist/types/skc-runtime/tmux-gc.d.ts +0 -7
  1164. package/dist/types/skc-runtime/tmux-owner-isolation-cli.d.ts +0 -5
  1165. package/dist/types/skc-runtime/tmux-owner-isolation.d.ts +0 -309
  1166. package/dist/types/skc-runtime/tmux-sessions.d.ts +0 -94
  1167. package/dist/types/skc-runtime/ultragoal-guard.d.ts +0 -93
  1168. package/dist/types/skc-runtime/ultragoal-receipt-freshness.d.ts +0 -42
  1169. package/dist/types/skc-runtime/ultragoal-runtime.d.ts +0 -410
  1170. package/dist/types/skc-runtime/workflow-command-ref.d.ts +0 -43
  1171. package/dist/types/skc-runtime/workflow-manifest.d.ts +0 -54
  1172. package/dist/types/skill-state/active-state.d.ts +0 -126
  1173. package/dist/types/skill-state/canonical-skills.d.ts +0 -3
  1174. package/dist/types/skill-state/deep-interview-mutation-guard.d.ts +0 -38
  1175. package/dist/types/skill-state/initial-phase.d.ts +0 -12
  1176. package/dist/types/skill-state/workflow-hud.d.ts +0 -83
  1177. package/dist/types/skill-state/workflow-state-contract.d.ts +0 -57
  1178. package/dist/types/skill-state/workflow-state-version.d.ts +0 -3
  1179. package/dist/types/slash-commands/acp-builtins.d.ts +0 -18
  1180. package/dist/types/slash-commands/builtin-registry.d.ts +0 -24
  1181. package/dist/types/slash-commands/helpers/context-report.d.ts +0 -7
  1182. package/dist/types/slash-commands/helpers/fast-status-report.d.ts +0 -82
  1183. package/dist/types/slash-commands/helpers/format.d.ts +0 -10
  1184. package/dist/types/slash-commands/helpers/mcp.d.ts +0 -3
  1185. package/dist/types/slash-commands/helpers/parse.d.ts +0 -33
  1186. package/dist/types/slash-commands/helpers/ssh.d.ts +0 -3
  1187. package/dist/types/slash-commands/helpers/todo.d.ts +0 -3
  1188. package/dist/types/slash-commands/helpers/usage-report.d.ts +0 -7
  1189. package/dist/types/slash-commands/types.d.ts +0 -120
  1190. package/dist/types/ssh/config-writer.d.ts +0 -49
  1191. package/dist/types/ssh/connection-manager.d.ts +0 -33
  1192. package/dist/types/ssh/ssh-executor.d.ts +0 -37
  1193. package/dist/types/ssh/sshfs-mount.d.ts +0 -6
  1194. package/dist/types/ssh/utils.d.ts +0 -2
  1195. package/dist/types/stt/downloader.d.ts +0 -9
  1196. package/dist/types/stt/index.d.ts +0 -3
  1197. package/dist/types/stt/recorder.d.ts +0 -13
  1198. package/dist/types/stt/setup.d.ts +0 -18
  1199. package/dist/types/stt/stt-controller.d.ts +0 -16
  1200. package/dist/types/stt/transcriber.d.ts +0 -16
  1201. package/dist/types/system-prompt.d.ts +0 -118
  1202. package/dist/types/task/agents.d.ts +0 -28
  1203. package/dist/types/task/commands.d.ts +0 -35
  1204. package/dist/types/task/discovery.d.ts +0 -19
  1205. package/dist/types/task/executor.d.ts +0 -127
  1206. package/dist/types/task/fork-context-advisory.d.ts +0 -13
  1207. package/dist/types/task/fork-context-budget.d.ts +0 -7
  1208. package/dist/types/task/id.d.ts +0 -7
  1209. package/dist/types/task/index.d.ts +0 -43
  1210. package/dist/types/task/name-generator.d.ts +0 -16
  1211. package/dist/types/task/output-manager.d.ts +0 -36
  1212. package/dist/types/task/parallel.d.ts +0 -34
  1213. package/dist/types/task/receipt.d.ts +0 -89
  1214. package/dist/types/task/render.d.ts +0 -28
  1215. package/dist/types/task/roi-reconciliation.d.ts +0 -27
  1216. package/dist/types/task/simple-mode.d.ts +0 -8
  1217. package/dist/types/task/skc-command.d.ts +0 -7
  1218. package/dist/types/task/spawn-gate.d.ts +0 -29
  1219. package/dist/types/task/subprocess-tool-registry.d.ts +0 -72
  1220. package/dist/types/task/token-log.d.ts +0 -30
  1221. package/dist/types/task/token-log.test.d.ts +0 -1
  1222. package/dist/types/task/types.d.ts +0 -516
  1223. package/dist/types/task/worktree.d.ts +0 -94
  1224. package/dist/types/thinking-metadata.d.ts +0 -16
  1225. package/dist/types/thinking.d.ts +0 -22
  1226. package/dist/types/tool-discovery/tool-index.d.ts +0 -112
  1227. package/dist/types/tools/archive-reader.d.ts +0 -40
  1228. package/dist/types/tools/ask-answer-registry.d.ts +0 -18
  1229. package/dist/types/tools/ask.d.ts +0 -123
  1230. package/dist/types/tools/ast-edit.d.ts +0 -77
  1231. package/dist/types/tools/ast-grep.d.ts +0 -69
  1232. package/dist/types/tools/auto-generated-guard.d.ts +0 -17
  1233. package/dist/types/tools/bash-allowed-prefixes.d.ts +0 -10
  1234. package/dist/types/tools/bash-command-fixup.d.ts +0 -11
  1235. package/dist/types/tools/bash-interactive.d.ts +0 -16
  1236. package/dist/types/tools/bash-interceptor.d.ts +0 -24
  1237. package/dist/types/tools/bash-pty-selection.d.ts +0 -7
  1238. package/dist/types/tools/bash-skill-urls.d.ts +0 -31
  1239. package/dist/types/tools/bash.d.ts +0 -157
  1240. package/dist/types/tools/bisect.d.ts +0 -81
  1241. package/dist/types/tools/browser/actions.d.ts +0 -54
  1242. package/dist/types/tools/browser/attach.d.ts +0 -50
  1243. package/dist/types/tools/browser/launch.d.ts +0 -62
  1244. package/dist/types/tools/browser/readable.d.ts +0 -17
  1245. package/dist/types/tools/browser/registry.d.ts +0 -57
  1246. package/dist/types/tools/browser/render.d.ts +0 -53
  1247. package/dist/types/tools/browser/tab-protocol.d.ts +0 -144
  1248. package/dist/types/tools/browser/tab-supervisor.d.ts +0 -109
  1249. package/dist/types/tools/browser/tab-worker-entry.d.ts +0 -1
  1250. package/dist/types/tools/browser/tab-worker.d.ts +0 -19
  1251. package/dist/types/tools/browser.d.ts +0 -211
  1252. package/dist/types/tools/calculator.d.ts +0 -76
  1253. package/dist/types/tools/checkpoint.d.ts +0 -63
  1254. package/dist/types/tools/composer-bash-policy.d.ts +0 -14
  1255. package/dist/types/tools/computer/render.d.ts +0 -17
  1256. package/dist/types/tools/computer-gc.d.ts +0 -23
  1257. package/dist/types/tools/computer.d.ts +0 -465
  1258. package/dist/types/tools/conflict-detect.d.ts +0 -205
  1259. package/dist/types/tools/context.d.ts +0 -19
  1260. package/dist/types/tools/cron.d.ts +0 -91
  1261. package/dist/types/tools/debug.d.ts +0 -209
  1262. package/dist/types/tools/eval.d.ts +0 -108
  1263. package/dist/types/tools/fetch.d.ts +0 -84
  1264. package/dist/types/tools/file-recorder.d.ts +0 -13
  1265. package/dist/types/tools/find.d.ts +0 -95
  1266. package/dist/types/tools/fs-cache-invalidation.d.ts +0 -15
  1267. package/dist/types/tools/gh-format.d.ts +0 -6
  1268. package/dist/types/tools/gh-renderer.d.ts +0 -25
  1269. package/dist/types/tools/gh.d.ts +0 -356
  1270. package/dist/types/tools/github-cache.d.ts +0 -103
  1271. package/dist/types/tools/grouped-file-output.d.ts +0 -36
  1272. package/dist/types/tools/hindsight-recall.d.ts +0 -21
  1273. package/dist/types/tools/hindsight-reflect.d.ts +0 -23
  1274. package/dist/types/tools/hindsight-retain.d.ts +0 -27
  1275. package/dist/types/tools/image-gen.d.ts +0 -79
  1276. package/dist/types/tools/index.d.ts +0 -371
  1277. package/dist/types/tools/irc.d.ts +0 -79
  1278. package/dist/types/tools/job.d.ts +0 -78
  1279. package/dist/types/tools/json-tree.d.ts +0 -23
  1280. package/dist/types/tools/jtd-to-json-schema.d.ts +0 -29
  1281. package/dist/types/tools/jtd-to-typescript.d.ts +0 -26
  1282. package/dist/types/tools/jtd-utils.d.ts +0 -42
  1283. package/dist/types/tools/list-limit.d.ts +0 -12
  1284. package/dist/types/tools/match-line-format.d.ts +0 -11
  1285. package/dist/types/tools/monitor.d.ts +0 -54
  1286. package/dist/types/tools/output-meta.d.ts +0 -204
  1287. package/dist/types/tools/path-utils.d.ts +0 -147
  1288. package/dist/types/tools/plan-mode-guard.d.ts +0 -18
  1289. package/dist/types/tools/read.d.ts +0 -85
  1290. package/dist/types/tools/recipe/index.d.ts +0 -45
  1291. package/dist/types/tools/recipe/render.d.ts +0 -36
  1292. package/dist/types/tools/recipe/runner.d.ts +0 -60
  1293. package/dist/types/tools/recipe/runners/cargo.d.ts +0 -16
  1294. package/dist/types/tools/recipe/runners/index.d.ts +0 -2
  1295. package/dist/types/tools/recipe/runners/just.d.ts +0 -2
  1296. package/dist/types/tools/recipe/runners/make.d.ts +0 -2
  1297. package/dist/types/tools/recipe/runners/pkg.d.ts +0 -2
  1298. package/dist/types/tools/recipe/runners/task.d.ts +0 -2
  1299. package/dist/types/tools/render-mermaid.d.ts +0 -37
  1300. package/dist/types/tools/render-utils.d.ts +0 -158
  1301. package/dist/types/tools/renderers.d.ts +0 -26
  1302. package/dist/types/tools/resolve.d.ts +0 -80
  1303. package/dist/types/tools/resource-gc.d.ts +0 -54
  1304. package/dist/types/tools/review.d.ts +0 -63
  1305. package/dist/types/tools/search-tool-bm25.d.ts +0 -65
  1306. package/dist/types/tools/search.d.ts +0 -93
  1307. package/dist/types/tools/skill-discovery.d.ts +0 -40
  1308. package/dist/types/tools/skill.d.ts +0 -48
  1309. package/dist/types/tools/sqlite-reader.d.ts +0 -94
  1310. package/dist/types/tools/ssh.d.ts +0 -67
  1311. package/dist/types/tools/subagent-render.d.ts +0 -31
  1312. package/dist/types/tools/subagent.d.ts +0 -117
  1313. package/dist/types/tools/telegram-send.d.ts +0 -39
  1314. package/dist/types/tools/todo-write.d.ts +0 -120
  1315. package/dist/types/tools/tool-errors.d.ts +0 -33
  1316. package/dist/types/tools/tool-result.d.ts +0 -30
  1317. package/dist/types/tools/tool-timeouts.d.ts +0 -56
  1318. package/dist/types/tools/ultragoal-ask-guard.d.ts +0 -12
  1319. package/dist/types/tools/vim.d.ts +0 -58
  1320. package/dist/types/tools/write.d.ts +0 -59
  1321. package/dist/types/tools/yield.d.ts +0 -25
  1322. package/dist/types/tui/code-cell.d.ts +0 -32
  1323. package/dist/types/tui/file-list.d.ts +0 -22
  1324. package/dist/types/tui/hyperlink.d.ts +0 -42
  1325. package/dist/types/tui/index.d.ts +0 -11
  1326. package/dist/types/tui/output-block.d.ts +0 -28
  1327. package/dist/types/tui/status-line.d.ts +0 -18
  1328. package/dist/types/tui/tree-list.d.ts +0 -19
  1329. package/dist/types/tui/types.d.ts +0 -13
  1330. package/dist/types/tui/utils.d.ts +0 -36
  1331. package/dist/types/utils/changelog.d.ts +0 -37
  1332. package/dist/types/utils/clipboard.d.ts +0 -22
  1333. package/dist/types/utils/cmux-workspace.d.ts +0 -52
  1334. package/dist/types/utils/command-args.d.ts +0 -9
  1335. package/dist/types/utils/commit-message-generator.d.ts +0 -7
  1336. package/dist/types/utils/edit-mode.d.ts +0 -13
  1337. package/dist/types/utils/event-bus.d.ts +0 -6
  1338. package/dist/types/utils/external-editor.d.ts +0 -19
  1339. package/dist/types/utils/file-display-mode.d.ts +0 -27
  1340. package/dist/types/utils/file-mentions.d.ts +0 -25
  1341. package/dist/types/utils/git.d.ts +0 -393
  1342. package/dist/types/utils/image-loading.d.ts +0 -26
  1343. package/dist/types/utils/image-resize.d.ts +0 -39
  1344. package/dist/types/utils/lang-from-path.d.ts +0 -8
  1345. package/dist/types/utils/linkedom.d.ts +0 -4
  1346. package/dist/types/utils/markit.d.ts +0 -7
  1347. package/dist/types/utils/open.d.ts +0 -2
  1348. package/dist/types/utils/pasted-image-path.d.ts +0 -32
  1349. package/dist/types/utils/session-color.d.ts +0 -10
  1350. package/dist/types/utils/shell-snapshot.d.ts +0 -5
  1351. package/dist/types/utils/sixel.d.ts +0 -21
  1352. package/dist/types/utils/title-generator.d.ts +0 -31
  1353. package/dist/types/utils/tool-choice.d.ts +0 -20
  1354. package/dist/types/utils/tools-manager.d.ts +0 -9
  1355. package/dist/types/vim/buffer.d.ts +0 -41
  1356. package/dist/types/vim/commands.d.ts +0 -6
  1357. package/dist/types/vim/engine.d.ts +0 -47
  1358. package/dist/types/vim/parser.d.ts +0 -3
  1359. package/dist/types/vim/render.d.ts +0 -25
  1360. package/dist/types/vim/types.d.ts +0 -182
  1361. package/dist/types/web/insane/bridge.d.ts +0 -103
  1362. package/dist/types/web/insane/url-guard.d.ts +0 -25
  1363. package/dist/types/web/kagi.d.ts +0 -23
  1364. package/dist/types/web/parallel.d.ts +0 -58
  1365. package/dist/types/web/scrapers/artifacthub.d.ts +0 -6
  1366. package/dist/types/web/scrapers/arxiv.d.ts +0 -5
  1367. package/dist/types/web/scrapers/aur.d.ts +0 -5
  1368. package/dist/types/web/scrapers/biorxiv.d.ts +0 -5
  1369. package/dist/types/web/scrapers/bluesky.d.ts +0 -5
  1370. package/dist/types/web/scrapers/brew.d.ts +0 -5
  1371. package/dist/types/web/scrapers/cheatsh.d.ts +0 -8
  1372. package/dist/types/web/scrapers/chocolatey.d.ts +0 -5
  1373. package/dist/types/web/scrapers/choosealicense.d.ts +0 -2
  1374. package/dist/types/web/scrapers/cisa-kev.d.ts +0 -5
  1375. package/dist/types/web/scrapers/clojars.d.ts +0 -5
  1376. package/dist/types/web/scrapers/coingecko.d.ts +0 -5
  1377. package/dist/types/web/scrapers/crates-io.d.ts +0 -5
  1378. package/dist/types/web/scrapers/crossref.d.ts +0 -2
  1379. package/dist/types/web/scrapers/devto.d.ts +0 -5
  1380. package/dist/types/web/scrapers/discogs.d.ts +0 -8
  1381. package/dist/types/web/scrapers/discourse.d.ts +0 -5
  1382. package/dist/types/web/scrapers/dockerhub.d.ts +0 -5
  1383. package/dist/types/web/scrapers/docs-rs.d.ts +0 -2
  1384. package/dist/types/web/scrapers/fdroid.d.ts +0 -5
  1385. package/dist/types/web/scrapers/firefox-addons.d.ts +0 -2
  1386. package/dist/types/web/scrapers/flathub.d.ts +0 -2
  1387. package/dist/types/web/scrapers/github-gist.d.ts +0 -5
  1388. package/dist/types/web/scrapers/github.d.ts +0 -12
  1389. package/dist/types/web/scrapers/gitlab.d.ts +0 -5
  1390. package/dist/types/web/scrapers/go-pkg.d.ts +0 -5
  1391. package/dist/types/web/scrapers/hackage.d.ts +0 -5
  1392. package/dist/types/web/scrapers/hackernews.d.ts +0 -2
  1393. package/dist/types/web/scrapers/hex.d.ts +0 -5
  1394. package/dist/types/web/scrapers/huggingface.d.ts +0 -2
  1395. package/dist/types/web/scrapers/iacr.d.ts +0 -5
  1396. package/dist/types/web/scrapers/index.d.ts +0 -84
  1397. package/dist/types/web/scrapers/jetbrains-marketplace.d.ts +0 -2
  1398. package/dist/types/web/scrapers/lemmy.d.ts +0 -2
  1399. package/dist/types/web/scrapers/lobsters.d.ts +0 -5
  1400. package/dist/types/web/scrapers/mastodon.d.ts +0 -5
  1401. package/dist/types/web/scrapers/maven.d.ts +0 -6
  1402. package/dist/types/web/scrapers/mdn.d.ts +0 -2
  1403. package/dist/types/web/scrapers/metacpan.d.ts +0 -5
  1404. package/dist/types/web/scrapers/musicbrainz.d.ts +0 -5
  1405. package/dist/types/web/scrapers/npm.d.ts +0 -5
  1406. package/dist/types/web/scrapers/nuget.d.ts +0 -5
  1407. package/dist/types/web/scrapers/nvd.d.ts +0 -5
  1408. package/dist/types/web/scrapers/ollama.d.ts +0 -2
  1409. package/dist/types/web/scrapers/open-vsx.d.ts +0 -5
  1410. package/dist/types/web/scrapers/opencorporates.d.ts +0 -5
  1411. package/dist/types/web/scrapers/openlibrary.d.ts +0 -5
  1412. package/dist/types/web/scrapers/orcid.d.ts +0 -5
  1413. package/dist/types/web/scrapers/osv.d.ts +0 -5
  1414. package/dist/types/web/scrapers/packagist.d.ts +0 -5
  1415. package/dist/types/web/scrapers/pub-dev.d.ts +0 -5
  1416. package/dist/types/web/scrapers/pubmed.d.ts +0 -5
  1417. package/dist/types/web/scrapers/pypi.d.ts +0 -5
  1418. package/dist/types/web/scrapers/rawg.d.ts +0 -2
  1419. package/dist/types/web/scrapers/readthedocs.d.ts +0 -2
  1420. package/dist/types/web/scrapers/reddit.d.ts +0 -5
  1421. package/dist/types/web/scrapers/repology.d.ts +0 -5
  1422. package/dist/types/web/scrapers/rfc.d.ts +0 -5
  1423. package/dist/types/web/scrapers/rubygems.d.ts +0 -5
  1424. package/dist/types/web/scrapers/searchcode.d.ts +0 -2
  1425. package/dist/types/web/scrapers/sec-edgar.d.ts +0 -5
  1426. package/dist/types/web/scrapers/semantic-scholar.d.ts +0 -2
  1427. package/dist/types/web/scrapers/snapcraft.d.ts +0 -2
  1428. package/dist/types/web/scrapers/sourcegraph.d.ts +0 -2
  1429. package/dist/types/web/scrapers/spdx.d.ts +0 -5
  1430. package/dist/types/web/scrapers/spotify.d.ts +0 -8
  1431. package/dist/types/web/scrapers/stackoverflow.d.ts +0 -6
  1432. package/dist/types/web/scrapers/terraform.d.ts +0 -5
  1433. package/dist/types/web/scrapers/tldr.d.ts +0 -7
  1434. package/dist/types/web/scrapers/twitter.d.ts +0 -5
  1435. package/dist/types/web/scrapers/types.d.ts +0 -83
  1436. package/dist/types/web/scrapers/utils.d.ts +0 -32
  1437. package/dist/types/web/scrapers/vimeo.d.ts +0 -5
  1438. package/dist/types/web/scrapers/vscode-marketplace.d.ts +0 -5
  1439. package/dist/types/web/scrapers/w3c.d.ts +0 -2
  1440. package/dist/types/web/scrapers/wikidata.d.ts +0 -5
  1441. package/dist/types/web/scrapers/wikipedia.d.ts +0 -5
  1442. package/dist/types/web/scrapers/youtube.d.ts +0 -13
  1443. package/dist/types/web/search/index.d.ts +0 -118
  1444. package/dist/types/web/search/provider.d.ts +0 -55
  1445. package/dist/types/web/search/providers/anthropic.d.ts +0 -32
  1446. package/dist/types/web/search/providers/base.d.ts +0 -90
  1447. package/dist/types/web/search/providers/brave.d.ts +0 -27
  1448. package/dist/types/web/search/providers/codex.d.ts +0 -35
  1449. package/dist/types/web/search/providers/duckduckgo.d.ts +0 -57
  1450. package/dist/types/web/search/providers/exa.d.ts +0 -52
  1451. package/dist/types/web/search/providers/gemini.d.ts +0 -57
  1452. package/dist/types/web/search/providers/insane.d.ts +0 -53
  1453. package/dist/types/web/search/providers/jina.d.ts +0 -26
  1454. package/dist/types/web/search/providers/kagi.d.ts +0 -24
  1455. package/dist/types/web/search/providers/kimi.d.ts +0 -27
  1456. package/dist/types/web/search/providers/openai-compatible.d.ts +0 -9
  1457. package/dist/types/web/search/providers/parallel.d.ts +0 -15
  1458. package/dist/types/web/search/providers/perplexity.d.ts +0 -38
  1459. package/dist/types/web/search/providers/searxng.d.ts +0 -44
  1460. package/dist/types/web/search/providers/synthetic.d.ts +0 -21
  1461. package/dist/types/web/search/providers/tavily.d.ts +0 -29
  1462. package/dist/types/web/search/providers/text-citations.d.ts +0 -23
  1463. package/dist/types/web/search/providers/utils.d.ts +0 -88
  1464. package/dist/types/web/search/providers/xai.d.ts +0 -64
  1465. package/dist/types/web/search/providers/zai.d.ts +0 -28
  1466. package/dist/types/web/search/render.d.ts +0 -36
  1467. package/dist/types/web/search/types.d.ts +0 -372
  1468. package/dist/types/web/search/utils.d.ts +0 -4
  1469. package/dist/types/workflow/workflow-intent-diff.d.ts +0 -25
  1470. package/dist/types/workflow/workflow-intent-report-consumer.d.ts +0 -50
  1471. package/dist/types/workflow/workflow-intent-report-schema.d.ts +0 -2
  1472. package/dist/types/workflow/workflow-intent-report.d.ts +0 -48
  1473. package/dist/types/workspace-tree.d.ts +0 -42
  1474. package/src/sdk.ts +0 -2623
@@ -0,0 +1,2144 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { SdkClientError } from "../client/client";
3
+ import { readSdkSessionEndpoint, type SdkSessionEndpoint } from "../client/discovery";
4
+ import type { ChatDeliveryError } from "./chat-daemon-runtime";
5
+ import { ConversationStore } from "./conversation-store";
6
+ import {
7
+ acceptsSlackInbound,
8
+ normalizeSlackConversation,
9
+ type SlackConversation,
10
+ type SlackInboundDispatchReceipt,
11
+ slackConversationKey,
12
+ } from "./slack-conversation";
13
+
14
+ export class SlackEndpointBindingError extends Error {
15
+ constructor(message = "Slack session endpoint changed before dispatch.") {
16
+ super(message);
17
+ this.name = "SlackEndpointBindingError";
18
+ }
19
+ }
20
+
21
+ class SlackStaleEffectError extends Error {
22
+ constructor() {
23
+ super("Slack effect is no longer current");
24
+ }
25
+ }
26
+
27
+ class SlackReconciledAbsentEffectError extends Error {
28
+ constructor() {
29
+ super("Slack effect was not found during reconciliation");
30
+ }
31
+ }
32
+
33
+ import { type ChatEffect, ChatEffectJournal, type ChatEffectLease } from "./chat-effect-journal";
34
+ import { SlackProviderError } from "./slack-live-provider";
35
+ import type { SlackPostedMessage, SlackProvider, SlackSocketEnvelope } from "./slack-provider";
36
+
37
+ // Durable filesystem publication leases must outlast one event-loop and persistence turn.
38
+ const MIN_PUBLICATION_LEASE_MS = 100;
39
+
40
+ export interface SlackEndpoint extends SdkSessionEndpoint {
41
+ generation: number;
42
+ }
43
+
44
+ export interface SlackSdkClient {
45
+ send(frame: Record<string, unknown>): void;
46
+ }
47
+
48
+ export interface SlackNotificationDaemonOptions {
49
+ agentDir: string;
50
+ repo: string;
51
+ teamId: string;
52
+ channelId: string;
53
+ provider: SlackProvider;
54
+ botUserId?: string;
55
+ /** Fail-closed authorization for the paired Slack principal. */
56
+ authorizeActor?: (actorId: string) => boolean | Promise<boolean>;
57
+ store?: ConversationStore<SlackConversation>;
58
+ now?: () => number;
59
+ randomId?: () => string;
60
+ /** Stable identity for the process attempting durable provider publication. */
61
+ publicationOwnerId?: string;
62
+ publicationLeaseMs?: number;
63
+
64
+ resolveEndpoint?: (sessionId: string) => Promise<SlackEndpoint | null>;
65
+ createClient: (endpoint: SlackEndpoint) => SlackSdkClient;
66
+ onCommand?: (
67
+ sessionId: string,
68
+ content: string,
69
+ endpoint: SlackEndpoint,
70
+ idempotencyKey: string,
71
+ ) => Promise<boolean>;
72
+ }
73
+
74
+ type SlackEvent = {
75
+ type?: unknown;
76
+ channel?: unknown;
77
+ ts?: unknown;
78
+ thread_ts?: unknown;
79
+ user?: unknown;
80
+ bot_id?: unknown;
81
+ subtype?: unknown;
82
+ text?: unknown;
83
+ client_msg_id?: unknown;
84
+ };
85
+
86
+ type EventsPayload = {
87
+ type?: unknown;
88
+ event_id?: unknown;
89
+ team_id?: unknown;
90
+ event_context?: unknown;
91
+ event?: SlackEvent;
92
+ };
93
+ type SlackInboundRouting = {
94
+ teamId: string;
95
+ channelId: string;
96
+ rootTs: string;
97
+ actorId: string;
98
+ eventId: string;
99
+ interactionId: string;
100
+ retryKey: string;
101
+ eventContext?: string;
102
+ kind: "action" | "command";
103
+ actionId?: string;
104
+ };
105
+
106
+ type SlackInboundEffectPayload =
107
+ | { type: "reply"; id: string; answer: string; idempotencyKey: string; routing: SlackInboundRouting }
108
+ | { type: "command"; content: string; idempotencyKey: string; routing: SlackInboundRouting };
109
+
110
+ type SlackRootPublication = {
111
+ conversation: SlackConversation;
112
+ created: boolean;
113
+ };
114
+
115
+ function text(value: unknown): string | undefined {
116
+ return typeof value === "string" && value.length > 0 ? value : undefined;
117
+ }
118
+
119
+ function messageFromEnvelope(
120
+ payload: unknown,
121
+ ):
122
+ | { eventId: string; eventContext?: string; teamId: string; channelId: string; rootTs: string; event: SlackEvent }
123
+ | undefined {
124
+ if (!payload || typeof payload !== "object") return undefined;
125
+ const eventPayload = payload as EventsPayload;
126
+ if (eventPayload.type !== "events_api" || !eventPayload.event || eventPayload.event.type !== "message")
127
+ return undefined;
128
+ const eventId = text(eventPayload.event_id);
129
+ const teamId = text(eventPayload.team_id);
130
+ const channelId = text(eventPayload.event.channel);
131
+ const ts = text(eventPayload.event.ts);
132
+ const rootTs = text(eventPayload.event.thread_ts) ?? ts;
133
+ if (!eventId || !teamId || !channelId || !rootTs) return undefined;
134
+ return {
135
+ eventId,
136
+ eventContext: text(eventPayload.event_context),
137
+ teamId,
138
+ channelId,
139
+ rootTs,
140
+ event: eventPayload.event,
141
+ };
142
+ }
143
+
144
+ function nextRecord(record: SlackConversation, update: Partial<SlackConversation>): SlackConversation {
145
+ return normalizeSlackConversation({ ...record, ...update, generation: record.generation + 1 });
146
+ }
147
+
148
+ /**
149
+ * Slack Socket Mode notification daemon. Accepted inbound SDK effects are
150
+ * persisted before acknowledgement, including their replay payload and captured
151
+ * endpoint generation; endpoint credentials and Socket Mode cursors are never
152
+ * written to disk.
153
+ */
154
+
155
+ export class SlackNotificationDaemon {
156
+ readonly store: ConversationStore<SlackConversation>;
157
+ readonly #now: () => number;
158
+ readonly #randomId: () => string;
159
+ readonly #resolveEndpoint: (sessionId: string) => Promise<SlackEndpoint | null>;
160
+ readonly #publicationOwnerId: string;
161
+ readonly #publicationLeaseMs: number;
162
+ readonly #journal: ChatEffectJournal;
163
+
164
+ readonly #inflightInbound = new Set<string>();
165
+ readonly #activeWork = new Set<Promise<unknown>>();
166
+ readonly #rollovers = new Map<string, Promise<SlackRootPublication>>();
167
+ #lifecycleTail: Promise<void> = Promise.resolve();
168
+ #lifecycleGeneration = 0;
169
+ #startedGeneration: number | undefined;
170
+ #startOperation: Promise<void> | undefined;
171
+ #startOperationGeneration: number | undefined;
172
+ #stopOperation: Promise<void> | undefined;
173
+ #started = false;
174
+ #providerStarting = false;
175
+ #providerRunning = false;
176
+ #providerStopRequestedGeneration: number | undefined;
177
+ #leaseRecoveryTimer: ReturnType<typeof setTimeout> | undefined;
178
+ #leaseRecoveryAt: number | undefined;
179
+ #leaseRecoveryFailures = 0;
180
+ #leaseRecoveryTimerGeneration = 0;
181
+ #leaseRecoveryScheduling: Promise<void> = Promise.resolve();
182
+ #recoveringLeasedEffects = false;
183
+
184
+ constructor(private readonly options: SlackNotificationDaemonOptions) {
185
+ this.store =
186
+ options.store ?? new ConversationStore<SlackConversation>({ agentDir: options.agentDir, kind: "slack" });
187
+ this.#now = options.now ?? Date.now;
188
+ this.#randomId = options.randomId ?? randomUUID;
189
+ this.#publicationOwnerId = options.publicationOwnerId ?? randomUUID();
190
+ this.#publicationLeaseMs = Math.max(options.publicationLeaseMs ?? 30_000, MIN_PUBLICATION_LEASE_MS);
191
+ this.#journal = new ChatEffectJournal({ agentDir: options.agentDir, transport: "slack", now: this.#now });
192
+ this.#resolveEndpoint =
193
+ options.resolveEndpoint ??
194
+ (async sessionId => {
195
+ const endpoint = await readSdkSessionEndpoint(options.repo, sessionId);
196
+ return endpoint ? { ...endpoint, generation: 1 } : null;
197
+ });
198
+ }
199
+
200
+ async start(): Promise<void> {
201
+ const lifecycleGeneration = this.#lifecycleGeneration;
202
+ if (this.#started && this.#startedGeneration === lifecycleGeneration) return;
203
+ if (this.#startOperation && this.#startOperationGeneration === lifecycleGeneration)
204
+ return await this.#startOperation;
205
+ const operation = this.#enqueueLifecycle(async () => {
206
+ if (lifecycleGeneration !== this.#lifecycleGeneration || this.#started) return;
207
+ this.#started = true;
208
+ this.#startedGeneration = lifecycleGeneration;
209
+ try {
210
+ // Recovery is a barrier: Socket Mode must not ACK an envelope before the
211
+ // mapping authority represented by durable effects has been restored.
212
+ await this.#reconcileTerminalProviderReceipts();
213
+ await this.#reconcileTerminalInboundReceipts();
214
+ const providerRecoveryFailed = await this.#drainProviderEffects();
215
+ await this.#drainPendingDispatches();
216
+ await this.#scheduleLeaseRecovery(providerRecoveryFailed);
217
+ // stop() invalidates this generation synchronously before it joins the
218
+ // lifecycle queue, so no stale recovery can open Socket Mode.
219
+ if (
220
+ lifecycleGeneration !== this.#lifecycleGeneration ||
221
+ !this.#started ||
222
+ this.#startedGeneration !== lifecycleGeneration
223
+ ) {
224
+ this.#started = false;
225
+ this.#startedGeneration = undefined;
226
+ this.#clearLeaseRecoveryTimer();
227
+ return;
228
+ }
229
+ this.#providerStarting = true;
230
+ try {
231
+ await this.options.provider.start(async envelope => {
232
+ await this.#track(this.handleEnvelope(envelope));
233
+ });
234
+ this.#providerRunning = true;
235
+ } finally {
236
+ this.#providerStarting = false;
237
+ }
238
+ if (lifecycleGeneration !== this.#lifecycleGeneration || this.#startedGeneration !== lifecycleGeneration) {
239
+ this.#started = false;
240
+ this.#startedGeneration = undefined;
241
+ this.#providerRunning = false;
242
+ this.#clearLeaseRecoveryTimer();
243
+ if (this.#providerStopRequestedGeneration !== lifecycleGeneration) await this.options.provider.stop();
244
+ }
245
+ } catch (error) {
246
+ if (this.#startedGeneration === lifecycleGeneration) {
247
+ this.#started = false;
248
+ this.#startedGeneration = undefined;
249
+ this.#clearLeaseRecoveryTimer();
250
+ }
251
+ throw error;
252
+ }
253
+ });
254
+ this.#startOperation = operation;
255
+ this.#startOperationGeneration = lifecycleGeneration;
256
+ try {
257
+ await operation;
258
+ } finally {
259
+ if (this.#startOperation === operation) {
260
+ this.#startOperation = undefined;
261
+ this.#startOperationGeneration = undefined;
262
+ }
263
+ }
264
+ }
265
+
266
+ async stop(): Promise<void> {
267
+ if (this.#stopOperation) return await this.#stopOperation;
268
+ const lifecycleGeneration = this.#lifecycleGeneration++;
269
+ const stopProvider = this.#providerStarting || this.#providerRunning;
270
+ this.#started = false;
271
+ this.#startedGeneration = undefined;
272
+ this.#providerRunning = false;
273
+ this.#clearLeaseRecoveryTimer();
274
+ if (stopProvider) this.#providerStopRequestedGeneration = lifecycleGeneration;
275
+ const providerStop = stopProvider ? this.options.provider.stop() : undefined;
276
+ const operation = this.#enqueueLifecycle(async () => {
277
+ // Calling provider.stop() before joining the lifecycle queue lets a provider
278
+ // cancel an open that resolves only after its socket is stopped.
279
+ if (providerStop) await providerStop;
280
+ // Drain until quiescent: a tracked task can schedule further tracked work
281
+ // (recovery/reconciliation) while we await, and any that outlives stop() would
282
+ // bleed timing pressure into the next daemon/test. #started is already false,
283
+ // so no new lease-recovery timers can be armed and the loop terminates.
284
+ while (this.#activeWork.size > 0) await Promise.all([...this.#activeWork]);
285
+ });
286
+ this.#stopOperation = operation;
287
+ try {
288
+ await operation;
289
+ } finally {
290
+ if (this.#stopOperation === operation) this.#stopOperation = undefined;
291
+ }
292
+ }
293
+
294
+ /** Accepted inbound effects are durably claimed before their Socket Mode ACK. */
295
+ async handleEnvelope(envelope: SlackSocketEnvelope): Promise<boolean> {
296
+ if (!text(envelope.envelope_id)) return false;
297
+ const inbound = messageFromEnvelope(envelope.payload);
298
+ if (!inbound || inbound.teamId !== this.options.teamId || inbound.channelId !== this.options.channelId) {
299
+ await this.options.provider.ack(envelope.envelope_id);
300
+ return false;
301
+ }
302
+ const actorId = text(inbound.event.user);
303
+ if (
304
+ inbound.event.bot_id ||
305
+ inbound.event.subtype === "bot_message" ||
306
+ actorId === this.options.botUserId ||
307
+ !actorId ||
308
+ !(await this.#actorAuthorized(actorId))
309
+ ) {
310
+ await this.options.provider.ack(envelope.envelope_id);
311
+ return false;
312
+ }
313
+ const claim = await this.#claimInbound(inbound, actorId);
314
+ if (!claim) {
315
+ await this.options.provider.ack(envelope.envelope_id);
316
+ return false;
317
+ }
318
+ const inflightKey = `${claim.key}\u0000${claim.receipt.key}`;
319
+ if (this.#inflightInbound.has(inflightKey)) {
320
+ await this.options.provider.ack(envelope.envelope_id);
321
+ return false;
322
+ }
323
+ this.#inflightInbound.add(inflightKey);
324
+ try {
325
+ await this.options.provider.ack(envelope.envelope_id);
326
+ return await this.#dispatchInbound(claim);
327
+ } finally {
328
+ this.#inflightInbound.delete(inflightKey);
329
+ await this.#scheduleLeaseRecovery();
330
+ }
331
+ }
332
+
333
+ #track<T>(work: Promise<T>): Promise<T> {
334
+ this.#activeWork.add(work);
335
+ return work.finally(() => this.#activeWork.delete(work));
336
+ }
337
+
338
+ #enqueueLifecycle<T>(operation: () => Promise<T>): Promise<T> {
339
+ const scheduled = this.#lifecycleTail.then(operation, operation);
340
+ this.#lifecycleTail = scheduled.then(
341
+ () => undefined,
342
+ () => undefined,
343
+ );
344
+ return scheduled;
345
+ }
346
+
347
+ async postRoot(sessionId: string, body: string, endpointGeneration?: number): Promise<SlackConversation> {
348
+ return (await this.#postRoot(sessionId, body, endpointGeneration)).conversation;
349
+ }
350
+
351
+ async #postRoot(sessionId: string, body: string, endpointGeneration?: number): Promise<SlackRootPublication> {
352
+ const endpoint = await this.#resolveEndpoint(sessionId);
353
+ if (!endpoint || (endpointGeneration !== undefined && endpoint.generation !== endpointGeneration))
354
+ throw new SlackEndpointBindingError("Slack root publication requires the current session endpoint.");
355
+ const generation = endpoint.generation;
356
+ const pendingKey = this.#intentKey(sessionId);
357
+ let claimed = false;
358
+ const pending = await this.store.transact(pendingKey, current => {
359
+ if (current?.state === "active") return current;
360
+ const now = this.#now();
361
+ if (
362
+ current?.rootPublicationOwner !== undefined &&
363
+ current.rootPublicationOwner !== this.#publicationOwnerId &&
364
+ !this.#leaseExpired(current.rootPublicationLeaseExpiresAt, now)
365
+ )
366
+ return current;
367
+ if (current?.state === "posting_root") {
368
+ if (current.rootPublicationOwner === this.#publicationOwnerId) return current;
369
+ claimed = true;
370
+ return nextRecord(current, {
371
+ rootPublicationOwner: this.#publicationOwnerId,
372
+ rootPublicationLeaseExpiresAt: now + this.#publicationLeaseMs,
373
+ rootPublicationFence: (current.rootPublicationFence ?? 0) + 1,
374
+ updatedAt: now,
375
+ });
376
+ }
377
+ claimed = true;
378
+ return {
379
+ generation: (current?.generation ?? 0) + 1,
380
+ state: "posting_root",
381
+ teamId: this.options.teamId,
382
+ channelId: this.options.channelId,
383
+ sessionId,
384
+ clientMsgId: this.#randomId(),
385
+ rootPublicationOwner: this.#publicationOwnerId,
386
+ rootPublicationLeaseExpiresAt: now + this.#publicationLeaseMs,
387
+ rootPublicationFence: (current?.rootPublicationFence ?? 0) + 1,
388
+ endpointGeneration: generation,
389
+ updatedAt: now,
390
+ seenEventIds: current?.seenEventIds ?? [],
391
+ seenContextIds: current?.seenContextIds ?? [],
392
+ seenRetryKeys: current?.seenRetryKeys ?? [],
393
+ seenInteractionIds: current?.seenInteractionIds ?? [],
394
+ inboundDispatches: current?.inboundDispatches ?? [],
395
+ };
396
+ });
397
+ if (!pending?.clientMsgId) throw new Error("Unable to persist Slack root post intent");
398
+ if (pending.state === "active") {
399
+ if (pending.endpointGeneration !== generation) throw new SlackEndpointBindingError();
400
+ return { conversation: pending, created: false };
401
+ }
402
+ if (!claimed)
403
+ return { conversation: await this.#waitForRoot(pendingKey, sessionId, body, generation), created: false };
404
+ if (pending.endpointGeneration !== generation) throw new SlackEndpointBindingError();
405
+ const clientMsgId = pending.clientMsgId;
406
+ const fence = pending.rootPublicationFence;
407
+ if (fence === undefined) throw new Error("Unable to fence Slack root post intent");
408
+ let posted: SlackPostedMessage | null = null;
409
+ let createdRootEffect = false;
410
+ try {
411
+ await this.#withRootLease(pendingKey, clientMsgId, fence, async () => {
412
+ const effectId = `root:${sessionId}:${clientMsgId}`;
413
+ const durable = await this.#providerEffectPayload(effectId, sessionId, generation, {
414
+ channel: this.options.channelId,
415
+ text: body,
416
+ clientMsgId,
417
+ });
418
+ createdRootEffect = !durable.existed;
419
+ posted = await this.#postDurable(effectId, sessionId, generation, durable.payload);
420
+ });
421
+ } catch (error) {
422
+ if (this.#isUncertainPostFailure(error)) {
423
+ // The journal retains the stable root effect for fenced reconciliation.
424
+ }
425
+ if (!posted) {
426
+ if (!this.#isUncertainPostFailure(error)) {
427
+ await this.store.transact(pendingKey, current =>
428
+ current?.clientMsgId === clientMsgId &&
429
+ current.rootPublicationOwner === this.#publicationOwnerId &&
430
+ current.rootPublicationFence === fence
431
+ ? nextRecord(current, {
432
+ state: "error",
433
+ rootPublicationOwner: undefined,
434
+ rootPublicationLeaseExpiresAt: undefined,
435
+ updatedAt: this.#now(),
436
+ lastError: "provider_failure",
437
+ })
438
+ : current,
439
+ );
440
+ }
441
+ throw error;
442
+ }
443
+ }
444
+ if (!posted) throw new Error("Slack root post was not confirmed");
445
+ const confirmedPosted = posted as SlackPostedMessage;
446
+ // A confirmed receipt remains authoritative even if the endpoint rolled after
447
+ // dispatch; resume performs any required replacement after reconciliation.
448
+ const active = await this.store.transact(pendingKey, current => {
449
+ if (
450
+ !current ||
451
+ current.clientMsgId !== clientMsgId ||
452
+ current.rootPublicationOwner !== this.#publicationOwnerId ||
453
+ current.rootPublicationFence !== fence
454
+ )
455
+ return current;
456
+ return nextRecord(current, {
457
+ state: "active",
458
+ rootTs: confirmedPosted.ts,
459
+ endpointGeneration: generation,
460
+ updatedAt: this.#now(),
461
+ lastError: undefined,
462
+ rootPublicationOwner: undefined,
463
+ rootPublicationLeaseExpiresAt: undefined,
464
+ });
465
+ });
466
+ if (!active) throw new Error("Slack root mapping disappeared");
467
+ if (active.state !== "active")
468
+ return { conversation: await this.#waitForRoot(pendingKey, sessionId, body, generation), created: false };
469
+ return { conversation: active, created: createdRootEffect };
470
+ }
471
+
472
+ /** Deliver a notification into the mapped root thread, creating that root once. */
473
+ async notify(
474
+ sessionId: string,
475
+ body: string,
476
+ actionId?: string,
477
+ endpointGeneration?: number,
478
+ ): Promise<SlackConversation> {
479
+ const endpoint = await this.#resolveEndpoint(sessionId);
480
+ if (!endpoint || (endpointGeneration !== undefined && endpoint.generation !== endpointGeneration))
481
+ throw new SlackEndpointBindingError("Slack notification requires the current session endpoint.");
482
+ const generation = endpoint.generation;
483
+ const existing = await this.findSession(sessionId, false);
484
+ const usedExistingRoot =
485
+ existing?.record.state === "active" &&
486
+ !!existing.record.rootTs &&
487
+ existing.record.endpointGeneration === generation;
488
+ let conversation: SlackConversation;
489
+ let bodyWasUsedAsRoot = false;
490
+ if (usedExistingRoot) {
491
+ conversation = existing.record;
492
+ } else {
493
+ const publication =
494
+ existing?.record.state === "active"
495
+ ? await this.#resumeWithRootPublication(sessionId, body, generation)
496
+ : await this.#postRoot(sessionId, body, generation);
497
+ conversation = publication.conversation;
498
+ bodyWasUsedAsRoot = publication.created;
499
+ }
500
+ if (!conversation.rootTs) return conversation;
501
+ const key = this.#intentKey(sessionId);
502
+ const conversationGeneration = this.#requireEndpointGeneration(conversation);
503
+ if (conversationGeneration !== generation) throw new SlackEndpointBindingError();
504
+ if (bodyWasUsedAsRoot) {
505
+ if (!actionId) return conversation;
506
+ const active = await this.store.transact(key, current =>
507
+ current && acceptsSlackInbound(current, conversation.rootTs!, conversationGeneration)
508
+ ? nextRecord(current, { pendingActionId: actionId, updatedAt: this.#now() })
509
+ : current,
510
+ );
511
+ if (!active) throw new Error("Slack root disappeared while activating action authority");
512
+ return active;
513
+ }
514
+ if (!actionId) {
515
+ await this.#postDurable(`notification:${sessionId}:${this.#randomId()}`, sessionId, conversationGeneration, {
516
+ channel: conversation.channelId,
517
+ threadTs: conversation.rootTs,
518
+ text: body,
519
+ clientMsgId: this.#randomId(),
520
+ });
521
+ return conversation;
522
+ }
523
+ let actionClaimed = false;
524
+ const intent = await this.store.transact(key, current => {
525
+ if (!current || !acceptsSlackInbound(current, conversation.rootTs!, conversationGeneration)) return current;
526
+ const now = this.#now();
527
+ if (current.outboundActionId && current.outboundActionId !== actionId) return current;
528
+ if (current.outboundActionId === actionId) {
529
+ if (
530
+ current.outboundActionOwner === this.#publicationOwnerId ||
531
+ !this.#leaseExpired(current.outboundActionLeaseExpiresAt, now)
532
+ )
533
+ return current;
534
+ actionClaimed = true;
535
+ return nextRecord(current, {
536
+ outboundActionOwner: this.#publicationOwnerId,
537
+ outboundActionLeaseExpiresAt: now + this.#publicationLeaseMs,
538
+ outboundActionFence: (current.outboundActionFence ?? 0) + 1,
539
+ updatedAt: now,
540
+ });
541
+ }
542
+ actionClaimed = true;
543
+ return nextRecord(current, {
544
+ outboundActionId: actionId,
545
+ outboundActionClientMsgId: this.#randomId(),
546
+ outboundActionOwner: this.#publicationOwnerId,
547
+ outboundActionLeaseExpiresAt: now + this.#publicationLeaseMs,
548
+ outboundActionFence: (current.outboundActionFence ?? 0) + 1,
549
+ updatedAt: now,
550
+ });
551
+ });
552
+ if (!intent || intent.outboundActionId !== actionId || !intent.outboundActionClientMsgId) {
553
+ throw new Error("Another Slack action publication is pending");
554
+ }
555
+ if (!actionClaimed) return await this.#waitForAction(key, sessionId, body, actionId);
556
+ const clientMsgId = intent.outboundActionClientMsgId;
557
+ const fence = intent.outboundActionFence;
558
+ if (fence === undefined) throw new Error("Unable to fence Slack action post intent");
559
+ let published: SlackPostedMessage | null = null;
560
+ try {
561
+ await this.#withActionLease(key, clientMsgId, fence, async () => {
562
+ const effectId = `action:${sessionId}:${actionId}:${clientMsgId}`;
563
+ const durable = await this.#providerEffectPayload(effectId, sessionId, conversationGeneration, {
564
+ channel: conversation.channelId,
565
+ threadTs: conversation.rootTs,
566
+ text: body,
567
+ clientMsgId,
568
+ });
569
+ published = await this.#postDurable(effectId, sessionId, conversationGeneration, durable.payload);
570
+ });
571
+ } catch (error) {
572
+ if (this.#isUncertainPostFailure(error)) {
573
+ // The journal retains the stable action effect for fenced reconciliation.
574
+ }
575
+ if (!published) {
576
+ if (!this.#isUncertainPostFailure(error)) {
577
+ await this.store.transact(key, current =>
578
+ current?.outboundActionClientMsgId === clientMsgId &&
579
+ current.outboundActionOwner === this.#publicationOwnerId &&
580
+ current.outboundActionFence === fence
581
+ ? nextRecord(current, {
582
+ outboundActionId: undefined,
583
+ outboundActionClientMsgId: undefined,
584
+ outboundActionOwner: undefined,
585
+ outboundActionLeaseExpiresAt: undefined,
586
+ updatedAt: this.#now(),
587
+ })
588
+ : current,
589
+ );
590
+ }
591
+ throw error;
592
+ }
593
+ }
594
+ const active = await this.store.transact(key, current =>
595
+ current?.outboundActionClientMsgId === clientMsgId &&
596
+ current.outboundActionOwner === this.#publicationOwnerId &&
597
+ current.outboundActionFence === fence
598
+ ? nextRecord(current, {
599
+ pendingActionId: actionId,
600
+ outboundActionId: undefined,
601
+ outboundActionClientMsgId: undefined,
602
+ outboundActionOwner: undefined,
603
+ outboundActionLeaseExpiresAt: undefined,
604
+ updatedAt: this.#now(),
605
+ })
606
+ : current,
607
+ );
608
+ if (!active) throw new Error("Slack conversation disappeared while activating action authority");
609
+ return active;
610
+ }
611
+
612
+ /** Posts a safe command outcome to the active mapped root thread. */
613
+ async postCommandResult(sessionId: string, content: string): Promise<boolean> {
614
+ const found = await this.findSession(sessionId, false);
615
+ if (found?.record.state !== "active" || !found.record.rootTs) return false;
616
+ const generation = this.#requireEndpointGeneration(found.record);
617
+ await this.#postDurable(`command-result:${sessionId}:${this.#randomId()}`, sessionId, generation, {
618
+ channel: found.record.channelId,
619
+ threadTs: found.record.rootTs,
620
+ text: content,
621
+ clientMsgId: this.#randomId(),
622
+ });
623
+ return true;
624
+ }
625
+
626
+ async resolveAction(sessionId: string, actionId: string): Promise<void> {
627
+ const found = await this.findSession(sessionId, true);
628
+ if (!found) return;
629
+ await this.store.transact(found.key, current =>
630
+ current?.pendingActionId === actionId
631
+ ? nextRecord(current, { pendingActionId: undefined, updatedAt: this.#now() })
632
+ : current,
633
+ );
634
+ }
635
+
636
+ async close(sessionId: string, marker = "Session closed."): Promise<boolean> {
637
+ const found = await this.findSession(sessionId, true);
638
+ if (!found?.record.rootTs || found.record.state !== "active") return false;
639
+ const effectId = `close-marker:${sessionId}:${found.record.clientMsgId ?? found.record.rootTs}`;
640
+ const existing = await this.#journal.read<{
641
+ channel: string;
642
+ text: string;
643
+ threadTs?: string;
644
+ clientMsgId: string;
645
+ }>(effectId);
646
+ const durable = await this.#providerEffectPayload(
647
+ effectId,
648
+ sessionId,
649
+ this.#requireEndpointGeneration(found.record),
650
+ {
651
+ channel: found.record.channelId,
652
+ threadTs: found.record.rootTs,
653
+ text: marker,
654
+ clientMsgId: existing?.payload.clientMsgId ?? this.#randomId(),
655
+ },
656
+ );
657
+ await this.#postDurable(effectId, sessionId, this.#requireEndpointGeneration(found.record), durable.payload);
658
+ await this.store.transact(found.key, current =>
659
+ current
660
+ ? nextRecord(current, { state: "closed_marker", pendingActionId: undefined, updatedAt: this.#now() })
661
+ : current,
662
+ );
663
+
664
+ return true;
665
+ }
666
+
667
+ async resume(sessionId: string, body: string, endpointGeneration?: number): Promise<SlackConversation> {
668
+ return (await this.#resumeWithRootPublication(sessionId, body, endpointGeneration)).conversation;
669
+ }
670
+
671
+ async #resumeWithRootPublication(
672
+ sessionId: string,
673
+ body: string,
674
+ endpointGeneration?: number,
675
+ ): Promise<SlackRootPublication> {
676
+ const inFlight = this.#rollovers.get(sessionId);
677
+ if (inFlight) {
678
+ const publication = await inFlight;
679
+ const activeGeneration = this.#requireEndpointGeneration(publication.conversation);
680
+ if (endpointGeneration === undefined || endpointGeneration === activeGeneration)
681
+ return { conversation: publication.conversation, created: false };
682
+ if (endpointGeneration < activeGeneration)
683
+ throw new SlackEndpointBindingError("Slack root belongs to a newer endpoint generation.");
684
+ return await this.#resumeWithRootPublication(sessionId, body, endpointGeneration);
685
+ }
686
+ const rollover = this.#resumeRoot(sessionId, body, endpointGeneration);
687
+ this.#rollovers.set(sessionId, rollover);
688
+ try {
689
+ return await rollover;
690
+ } finally {
691
+ if (this.#rollovers.get(sessionId) === rollover) this.#rollovers.delete(sessionId);
692
+ }
693
+ }
694
+
695
+ async #resumeRoot(sessionId: string, body: string, endpointGeneration?: number): Promise<SlackRootPublication> {
696
+ const endpoint = await this.#resolveEndpoint(sessionId);
697
+ if (!endpoint || (endpointGeneration !== undefined && endpoint.generation !== endpointGeneration))
698
+ throw new SlackEndpointBindingError("Slack root rollover requires the current session endpoint.");
699
+ const generation = endpoint.generation;
700
+ const forced = endpointGeneration === undefined;
701
+ let waitedForRollover = false;
702
+ for (let attempt = 0; attempt < 100; attempt++) {
703
+ let previous = await this.findSession(sessionId, true);
704
+ while (previous?.record.state === "posting_root") {
705
+ const reconciled = await this.#waitForRootReconciliation(previous.key, previous.record);
706
+ if (!reconciled) throw new Error("Slack root mapping disappeared during reconciliation.");
707
+ previous = { key: previous.key, record: reconciled };
708
+ waitedForRollover = true;
709
+ }
710
+ if (!previous) return await this.#postRoot(sessionId, body, generation);
711
+ if (previous.record.state !== "active") {
712
+ if (
713
+ previous.record.rootPublicationOwner !== this.#publicationOwnerId &&
714
+ !this.#leaseExpired(previous.record.rootPublicationLeaseExpiresAt, this.#now())
715
+ ) {
716
+ waitedForRollover = true;
717
+ await Bun.sleep(10);
718
+ continue;
719
+ }
720
+ return await this.#postRoot(sessionId, body, generation);
721
+ }
722
+ const previousGeneration = this.#requireEndpointGeneration(previous.record);
723
+ if (previousGeneration > generation)
724
+ throw new SlackEndpointBindingError("Slack root belongs to a newer endpoint generation.");
725
+ if (previousGeneration === generation && (!forced || waitedForRollover))
726
+ return { conversation: previous.record, created: false };
727
+
728
+ let claimed = false;
729
+ let fence: number | undefined;
730
+ const locked = await this.store.transact(previous.key, current => {
731
+ if (
732
+ current?.state !== "active" ||
733
+ current.rootTs !== previous!.record.rootTs ||
734
+ current.endpointGeneration !== previousGeneration
735
+ )
736
+ return current;
737
+ const now = this.#now();
738
+ if (
739
+ current.rootPublicationOwner === this.#publicationOwnerId ||
740
+ !this.#leaseExpired(current.rootPublicationLeaseExpiresAt, now)
741
+ )
742
+ return current;
743
+ claimed = true;
744
+ fence = (current.rootPublicationFence ?? 0) + 1;
745
+ return nextRecord(current, {
746
+ rootPublicationOwner: this.#publicationOwnerId,
747
+ rootPublicationLeaseExpiresAt: now + this.#publicationLeaseMs,
748
+ rootPublicationFence: fence,
749
+ updatedAt: now,
750
+ });
751
+ });
752
+ if (!locked) throw new Error("Slack root mapping disappeared during rollover.");
753
+ if (!claimed || fence === undefined) {
754
+ waitedForRollover = true;
755
+ await Bun.sleep(10);
756
+ continue;
757
+ }
758
+ let closed = false;
759
+ try {
760
+ closed = await this.close(sessionId);
761
+ } catch (error) {
762
+ if (!(error instanceof SlackStaleEffectError)) throw error;
763
+ // The old-generation close marker was deliberately suppressed after
764
+ // reconciliation; this fenced rollover still owns the state transition.
765
+ closed = true;
766
+ }
767
+ const resumed = await this.store.transact(previous.key, current =>
768
+ closed &&
769
+ current &&
770
+ (current.state === "closed_marker" || current.state === "active") &&
771
+ current.rootPublicationOwner === this.#publicationOwnerId &&
772
+ current.rootPublicationFence === fence
773
+ ? nextRecord(current, { state: "resumed_root", pendingActionId: undefined, updatedAt: this.#now() })
774
+ : current,
775
+ );
776
+ if (
777
+ resumed?.state === "resumed_root" &&
778
+ resumed.rootPublicationOwner === this.#publicationOwnerId &&
779
+ resumed.rootPublicationFence === fence
780
+ )
781
+ return await this.#postRoot(sessionId, body, generation);
782
+ waitedForRollover = true;
783
+ await Bun.sleep(10);
784
+ }
785
+ throw new Error("Slack root rollover is still pending");
786
+ }
787
+
788
+ async #claimInbound(
789
+ inbound: {
790
+ eventId: string;
791
+ eventContext?: string;
792
+ teamId: string;
793
+ channelId: string;
794
+ rootTs: string;
795
+ event: SlackEvent;
796
+ },
797
+ actorId: string,
798
+ ): Promise<
799
+ { key: string; endpoint: SlackEndpoint; sessionId: string; receipt: SlackInboundDispatchReceipt } | undefined
800
+ > {
801
+ const document = await this.store.load();
802
+ const matched = Object.entries(document.conversations)
803
+ .map(([mappingKey, candidate]) => ({ mappingKey, candidate }))
804
+ .filter(
805
+ ({ candidate }) =>
806
+ candidate.teamId === inbound.teamId &&
807
+ candidate.channelId === inbound.channelId &&
808
+ candidate.rootTs === inbound.rootTs,
809
+ )
810
+ .sort(
811
+ (left, right) =>
812
+ (right.candidate.endpointGeneration ?? -1) - (left.candidate.endpointGeneration ?? -1) ||
813
+ right.candidate.generation - left.candidate.generation ||
814
+ right.candidate.updatedAt - left.candidate.updatedAt,
815
+ )[0];
816
+ if (!matched) return undefined;
817
+ const { mappingKey: key, candidate: record } = matched;
818
+ if (
819
+ !record.sessionId ||
820
+ !record.endpointGeneration ||
821
+ !acceptsSlackInbound(record, inbound.rootTs, record.endpointGeneration)
822
+ )
823
+ return undefined;
824
+ const endpoint = await this.#resolveEndpoint(record.sessionId);
825
+ if (!endpoint || endpoint.generation !== record.endpointGeneration) return undefined;
826
+ const interactionId = text(inbound.event.client_msg_id) ?? inbound.eventId;
827
+ const retryKey = `${inbound.eventId}:${interactionId}`;
828
+ const inboundText = text(inbound.event.text);
829
+ const command = inboundText?.startsWith("/sdk ") ?? false;
830
+
831
+ const idempotencyKey = `slack:${inbound.teamId}:${inbound.channelId}:${inbound.rootTs}:${actorId}:${inbound.eventId}:${interactionId}`;
832
+ const effectId = `inbound:${inbound.teamId}:${inbound.channelId}:${inbound.rootTs}:${actorId}:${inbound.eventId}:${interactionId}`;
833
+ const routing: SlackInboundRouting = {
834
+ teamId: inbound.teamId,
835
+ channelId: inbound.channelId,
836
+ rootTs: inbound.rootTs,
837
+ eventId: inbound.eventId,
838
+ interactionId,
839
+ actorId,
840
+ retryKey,
841
+ eventContext: inbound.eventContext,
842
+ kind: command ? "command" : "action",
843
+ ...(command ? {} : record.pendingActionId ? { actionId: record.pendingActionId } : {}),
844
+ };
845
+ const initialPayload: SlackInboundEffectPayload | undefined = command
846
+ ? { type: "command", content: inboundText!, idempotencyKey, routing }
847
+ : record.pendingActionId
848
+ ? { type: "reply", id: record.pendingActionId, answer: inboundText ?? "", idempotencyKey, routing }
849
+ : undefined;
850
+ const existingEffect = await this.#journal.read<SlackInboundEffectPayload>(effectId);
851
+ const payload = existingEffect?.payload ?? initialPayload;
852
+ if (!payload) return undefined;
853
+ await this.#rescheduleAfterEffectTransition(
854
+ this.#journal.enqueue({
855
+ id: effectId,
856
+ kind: command ? "sdk.inbound.command" : "sdk.inbound.reply",
857
+ transport: "slack",
858
+ sessionId: record.sessionId,
859
+ endpointGeneration: endpoint.generation,
860
+ payload,
861
+ }),
862
+ );
863
+ let sessionId: string | undefined;
864
+ let receipt: SlackInboundDispatchReceipt | undefined;
865
+ await this.store.transact(key, current => {
866
+ if (!current?.sessionId || !acceptsSlackInbound(current, inbound.rootTs, endpoint.generation)) return current;
867
+ const existing = (current.inboundDispatches ?? []).find(
868
+ candidate =>
869
+ candidate.eventId === inbound.eventId ||
870
+ candidate.interactionId === interactionId ||
871
+ candidate.retryKey === retryKey ||
872
+ (inbound.eventContext !== undefined && candidate.eventContext === inbound.eventContext),
873
+ );
874
+ if (existing) {
875
+ sessionId = current.sessionId;
876
+ receipt = existing;
877
+ return current;
878
+ }
879
+ if (
880
+ current.seenEventIds.includes(inbound.eventId) ||
881
+ current.seenInteractionIds.includes(interactionId) ||
882
+ current.seenRetryKeys.includes(retryKey) ||
883
+ (inbound.eventContext !== undefined && current.seenContextIds.includes(inbound.eventContext)) ||
884
+ (!command && !current.pendingActionId)
885
+ )
886
+ return current;
887
+ sessionId = current.sessionId;
888
+ receipt = {
889
+ key: `${inbound.eventId}:${interactionId}`,
890
+ eventId: inbound.eventId,
891
+ interactionId,
892
+ retryKey,
893
+ eventContext: inbound.eventContext,
894
+ kind: command ? "command" : "action",
895
+ ...(command ? {} : { actionId: current.pendingActionId }),
896
+ endpointGeneration: endpoint.generation,
897
+ effectId,
898
+ idempotencyKey,
899
+ };
900
+ return nextRecord(current, {
901
+ inboundDispatches: [...(current.inboundDispatches ?? []), receipt],
902
+ updatedAt: this.#now(),
903
+ });
904
+ });
905
+ return sessionId && receipt ? { key, endpoint, sessionId, receipt } : undefined;
906
+ }
907
+
908
+ async #dispatchInbound(claim: {
909
+ key: string;
910
+ endpoint: SlackEndpoint;
911
+ sessionId: string;
912
+ receipt: SlackInboundDispatchReceipt;
913
+ }): Promise<boolean> {
914
+ const current = await this.store.read(claim.key);
915
+ const effect = await this.#journal.read<SlackInboundEffectPayload>(claim.receipt.effectId);
916
+ if (effect?.state === "terminal") {
917
+ await this.#finalizeTerminalInboundDispatch(claim.key, claim.receipt);
918
+ return false;
919
+ }
920
+ if (
921
+ !current ||
922
+ !this.#mappedInboundDispatchable(current, claim.receipt, effect) ||
923
+ claim.receipt.endpointGeneration !== claim.endpoint.generation
924
+ ) {
925
+ await this.#terminalizeStaleInboundDispatch(claim.key, claim.receipt, "stale_mapping");
926
+ return false;
927
+ }
928
+ return await this.#dispatchEffect(claim, claim.receipt.effectId);
929
+ }
930
+
931
+ async #dispatchEffect(
932
+ claim: { key: string; endpoint: SlackEndpoint; sessionId: string; receipt: SlackInboundDispatchReceipt },
933
+ effectId: string,
934
+ ): Promise<boolean> {
935
+ const effect = await this.#rescheduleAfterEffectTransition(
936
+ this.#journal.claim<SlackInboundEffectPayload>(
937
+ effectId,
938
+ this.#publicationOwnerId,
939
+ Math.max(this.#publicationLeaseMs, 100),
940
+ ),
941
+ );
942
+ if (!effect) return false;
943
+ if (!this.#matchesInboundEffect(effect, claim.receipt)) {
944
+ await this.#terminalizeStaleInboundDispatch(claim.key, claim.receipt, "stale_mapping");
945
+ return false;
946
+ }
947
+ const lease: ChatEffectLease = { owner: this.#publicationOwnerId, epoch: effect.epoch };
948
+ try {
949
+ if (effect.payload.type === "command") {
950
+ const payload = effect.payload;
951
+ const accepted = await this.#withEffectLease(effect.id, lease, async () => {
952
+ if (!(await this.#inboundEffectCurrent(claim, effect.id))) throw new SlackStaleEffectError();
953
+ return await (this.options.onCommand?.(
954
+ claim.sessionId,
955
+ payload.content,
956
+ claim.endpoint,
957
+ payload.idempotencyKey,
958
+ ) ?? Promise.resolve(false));
959
+ });
960
+ if (!(await this.#inboundEffectCurrent(claim, effect.id))) {
961
+ await this.#terminalizeStaleInboundDispatch(claim.key, claim.receipt, "stale_binding");
962
+ return false;
963
+ }
964
+ const recorded = await this.#journal.record(effect.id, lease, "terminal", {
965
+ status: accepted ? "accepted" : "rejected",
966
+ });
967
+ if (recorded) await this.#finishDispatch(claim, "terminal");
968
+ return accepted && !!recorded;
969
+ }
970
+ await this.#withEffectLease(effect.id, lease, async () => {
971
+ if (!(await this.#inboundEffectCurrent(claim, effect.id))) throw new SlackStaleEffectError();
972
+ this.options.createClient(claim.endpoint).send(effect.payload);
973
+ });
974
+ if (!(await this.#inboundEffectCurrent(claim, effect.id))) {
975
+ await this.#terminalizeStaleInboundDispatch(claim.key, claim.receipt, "stale_binding");
976
+ return false;
977
+ }
978
+ const recorded = await this.#journal.record(effect.id, lease, "terminal", { status: "sent" });
979
+ if (recorded) await this.#finishDispatch(claim, "terminal");
980
+ return !!recorded;
981
+ } catch (error) {
982
+ if (error instanceof SlackStaleEffectError) {
983
+ await this.#terminalizeStaleInboundDispatch(claim.key, claim.receipt, "stale_binding");
984
+ return false;
985
+ }
986
+ const state = this.#isDefiniteSdkPreSendFailure(error) ? "accepted" : "uncertain";
987
+
988
+ const recorded = await this.#rescheduleAfterEffectTransition(
989
+ this.#journal.record(effect.id, lease, state, { status: state }),
990
+ );
991
+ if (recorded && state === "accepted") await this.#releaseDispatch(claim);
992
+ else if (recorded) await this.#finishDispatch(claim, "uncertain");
993
+ return false;
994
+ }
995
+ }
996
+
997
+ async #inboundEffectCurrent(
998
+ claim: { key: string; endpoint: SlackEndpoint; sessionId: string; receipt: SlackInboundDispatchReceipt },
999
+ effectId: string,
1000
+ ): Promise<boolean> {
1001
+ const endpoint = await this.#resolveEndpoint(claim.sessionId);
1002
+ if (!endpoint || endpoint.generation !== claim.endpoint.generation) return false;
1003
+ const [current, effect] = await Promise.all([
1004
+ this.store.read(claim.key),
1005
+ this.#journal.read<SlackInboundEffectPayload>(effectId),
1006
+ ]);
1007
+ return (
1008
+ !!current &&
1009
+ !!effect &&
1010
+ current.sessionId === claim.sessionId &&
1011
+ acceptsSlackInbound(current, current.rootTs ?? "", claim.endpoint.generation) &&
1012
+ claim.receipt.endpointGeneration === claim.endpoint.generation &&
1013
+ this.#matchesInboundEffect(effect, claim.receipt) &&
1014
+ (await this.#actorAuthorized(effect.payload.routing.actorId)) &&
1015
+ (current.inboundDispatches ?? []).some(receipt => this.#sameInboundReceipt(receipt, claim.receipt))
1016
+ );
1017
+ }
1018
+
1019
+ async #withEffectLease<T>(id: string, lease: ChatEffectLease, operation: () => Promise<T>): Promise<T> {
1020
+ // The effect was just claimed, so its lease is current. The periodic renewal
1021
+ // still protects the external operation without another durable write first.
1022
+ return await this.#withRenewal(
1023
+ operation,
1024
+ async () => {
1025
+ if (
1026
+ !(await this.#rescheduleAfterEffectTransition(
1027
+ this.#journal.renew(id, lease, Math.max(this.#publicationLeaseMs, 100)),
1028
+ ))
1029
+ )
1030
+ throw new Error("Slack effect lease renewal failed");
1031
+ },
1032
+ false,
1033
+ );
1034
+ }
1035
+
1036
+ async #drainPendingDispatches(): Promise<void> {
1037
+ await this.#reconcileTerminalInboundReceipts();
1038
+ const document = await this.store.load();
1039
+ const dispatchableEffectIds = new Set<string>();
1040
+ for (const [key, record] of Object.entries(document.conversations)) {
1041
+ for (const receipt of record.inboundDispatches ?? []) {
1042
+ const effect = await this.#journal.read<SlackInboundEffectPayload>(receipt.effectId);
1043
+ if (effect?.state === "terminal") {
1044
+ await this.#finalizeTerminalInboundDispatch(key, receipt);
1045
+ continue;
1046
+ }
1047
+ if (!this.#mappedInboundDispatchable(record, receipt, effect)) {
1048
+ await this.#terminalizeStaleInboundDispatch(key, receipt, "stale_mapping");
1049
+ continue;
1050
+ }
1051
+ const endpoint = await this.#resolveEndpoint(record.sessionId!);
1052
+ if (!endpoint || endpoint.generation !== receipt.endpointGeneration) {
1053
+ await this.#terminalizeStaleInboundDispatch(key, receipt, "stale_binding");
1054
+ continue;
1055
+ }
1056
+ if (
1057
+ effect.state === "uncertain" ||
1058
+ (effect.state === "leased" && (effect.leaseExpiresAt ?? 0) > this.#now())
1059
+ )
1060
+ continue;
1061
+ dispatchableEffectIds.add(receipt.effectId);
1062
+ const inflightKey = `${key}\u0000${receipt.key}`;
1063
+ if (this.#inflightInbound.has(inflightKey)) continue;
1064
+ this.#inflightInbound.add(inflightKey);
1065
+ try {
1066
+ await this.#dispatchInbound({ key, endpoint, sessionId: record.sessionId!, receipt });
1067
+ } finally {
1068
+ this.#inflightInbound.delete(inflightKey);
1069
+ }
1070
+ }
1071
+ }
1072
+ for (const effect of await this.#journal.list()) {
1073
+ if (
1074
+ dispatchableEffectIds.has(effect.id) ||
1075
+ effect.transport !== "slack" ||
1076
+ effect.state === "terminal" ||
1077
+ !effect.sessionId ||
1078
+ (effect.kind !== "sdk.inbound.command" && effect.kind !== "sdk.inbound.reply")
1079
+ )
1080
+ continue;
1081
+ const adopted = await this.#adoptOrphanInbound(effect as ChatEffect<SlackInboundEffectPayload>);
1082
+ if (!adopted) continue;
1083
+ const endpoint = await this.#resolveEndpoint(adopted.sessionId);
1084
+ if (
1085
+ !endpoint ||
1086
+ endpoint.generation !== adopted.receipt.endpointGeneration ||
1087
+ !(await this.#inboundEffectCurrent(
1088
+ { key: adopted.key, endpoint, sessionId: adopted.sessionId, receipt: adopted.receipt },
1089
+ effect.id,
1090
+ ))
1091
+ ) {
1092
+ await this.#terminalizeStaleInboundDispatch(adopted.key, adopted.receipt, "stale_binding");
1093
+ continue;
1094
+ }
1095
+ if (effect.state === "uncertain" || (effect.state === "leased" && (effect.leaseExpiresAt ?? 0) > this.#now()))
1096
+ continue;
1097
+ await this.#dispatchInbound({
1098
+ key: adopted.key,
1099
+ endpoint,
1100
+ sessionId: adopted.sessionId,
1101
+ receipt: adopted.receipt,
1102
+ });
1103
+ }
1104
+ }
1105
+
1106
+ async #actorAuthorized(actorId: string): Promise<boolean> {
1107
+ const authorizeActor = this.options.authorizeActor;
1108
+ if (!authorizeActor || !text(actorId)) return false;
1109
+ try {
1110
+ return await authorizeActor(actorId);
1111
+ } catch {
1112
+ return false;
1113
+ }
1114
+ }
1115
+ #validInboundRouting(routing: SlackInboundRouting): boolean {
1116
+ return (
1117
+ routing.teamId === this.options.teamId &&
1118
+ routing.channelId === this.options.channelId &&
1119
+ text(routing.rootTs) !== undefined &&
1120
+ text(routing.actorId) !== undefined &&
1121
+ text(routing.eventId) !== undefined &&
1122
+ text(routing.interactionId) !== undefined &&
1123
+ routing.retryKey === `${routing.eventId}:${routing.interactionId}` &&
1124
+ (routing.eventContext === undefined || text(routing.eventContext) !== undefined) &&
1125
+ (routing.kind === "command" || (routing.kind === "action" && text(routing.actionId) !== undefined))
1126
+ );
1127
+ }
1128
+ #matchesInboundEffect(effect: ChatEffect<SlackInboundEffectPayload>, receipt: SlackInboundDispatchReceipt): boolean {
1129
+ const payload = effect.payload;
1130
+ const routing = payload?.routing;
1131
+ if (
1132
+ !routing ||
1133
+ !this.#validInboundRouting(routing) ||
1134
+ !effect.sessionId ||
1135
+ !Number.isSafeInteger(effect.endpointGeneration) ||
1136
+ effect.endpointGeneration <= 0
1137
+ )
1138
+ return false;
1139
+ const effectId = `inbound:${routing.teamId}:${routing.channelId}:${routing.rootTs}:${routing.actorId}:${routing.eventId}:${routing.interactionId}`;
1140
+ const idempotencyKey = `slack:${routing.teamId}:${routing.channelId}:${routing.rootTs}:${routing.actorId}:${routing.eventId}:${routing.interactionId}`;
1141
+ return (
1142
+ effect.id === effectId &&
1143
+ payload.idempotencyKey === idempotencyKey &&
1144
+ receipt.key === `${routing.eventId}:${routing.interactionId}` &&
1145
+ receipt.eventId === routing.eventId &&
1146
+ receipt.interactionId === routing.interactionId &&
1147
+ receipt.retryKey === routing.retryKey &&
1148
+ receipt.eventContext === routing.eventContext &&
1149
+ receipt.kind === routing.kind &&
1150
+ receipt.actionId === routing.actionId &&
1151
+ receipt.endpointGeneration === effect.endpointGeneration &&
1152
+ receipt.effectId === effect.id &&
1153
+ receipt.idempotencyKey === payload.idempotencyKey &&
1154
+ ((payload.type === "command" && routing.kind === "command" && effect.kind === "sdk.inbound.command") ||
1155
+ (payload.type === "reply" &&
1156
+ routing.kind === "action" &&
1157
+ effect.kind === "sdk.inbound.reply" &&
1158
+ payload.id === routing.actionId))
1159
+ );
1160
+ }
1161
+ #sameInboundReceipt(left: SlackInboundDispatchReceipt, right: SlackInboundDispatchReceipt): boolean {
1162
+ return (
1163
+ left.key === right.key &&
1164
+ left.eventId === right.eventId &&
1165
+ left.interactionId === right.interactionId &&
1166
+ left.retryKey === right.retryKey &&
1167
+ left.eventContext === right.eventContext &&
1168
+ left.kind === right.kind &&
1169
+ left.actionId === right.actionId &&
1170
+ left.endpointGeneration === right.endpointGeneration &&
1171
+ left.effectId === right.effectId &&
1172
+ left.idempotencyKey === right.idempotencyKey
1173
+ );
1174
+ }
1175
+ #mappedInboundDispatchable(
1176
+ record: SlackConversation,
1177
+ receipt: SlackInboundDispatchReceipt,
1178
+ effect: ChatEffect<SlackInboundEffectPayload> | undefined,
1179
+ ): effect is ChatEffect<SlackInboundEffectPayload> {
1180
+ return (
1181
+ !!effect &&
1182
+ record.state === "active" &&
1183
+ !!record.sessionId &&
1184
+ !!record.rootTs &&
1185
+ acceptsSlackInbound(record, record.rootTs, receipt.endpointGeneration) &&
1186
+ record.sessionId === effect.sessionId &&
1187
+ this.#matchesInboundEffect(effect, receipt)
1188
+ );
1189
+ }
1190
+ async #reconcileTerminalInboundReceipts(): Promise<void> {
1191
+ for (const effect of await this.#journal.list()) {
1192
+ if (
1193
+ effect.transport !== "slack" ||
1194
+ effect.state !== "terminal" ||
1195
+ (effect.kind !== "sdk.inbound.command" && effect.kind !== "sdk.inbound.reply")
1196
+ )
1197
+ continue;
1198
+ const payload = effect.payload as SlackInboundEffectPayload;
1199
+ if (!payload?.routing || !this.#validInboundRouting(payload.routing)) continue;
1200
+ const key = slackConversationKey({
1201
+ teamId: payload.routing.teamId,
1202
+ channelId: payload.routing.channelId,
1203
+ rootTs: payload.routing.rootTs,
1204
+ });
1205
+ const current = await this.store.read(key);
1206
+ let receipt: SlackInboundDispatchReceipt | undefined;
1207
+ if (current && current.sessionId === effect.sessionId) {
1208
+ receipt = current.inboundDispatches?.find(candidate =>
1209
+ this.#matchesInboundEffect(effect as ChatEffect<SlackInboundEffectPayload>, candidate),
1210
+ );
1211
+ }
1212
+ if (receipt) await this.#finalizeTerminalInboundDispatch(key, receipt);
1213
+ }
1214
+ }
1215
+ async #terminalizeStaleInboundDispatch(
1216
+ key: string,
1217
+ receipt: SlackInboundDispatchReceipt,
1218
+ status: "stale_binding" | "stale_mapping",
1219
+ ): Promise<void> {
1220
+ await this.#journal.terminalize(receipt.effectId, { status });
1221
+ await this.#finalizeTerminalInboundDispatch(key, receipt);
1222
+ }
1223
+ async #finalizeTerminalInboundDispatch(key: string, receipt: SlackInboundDispatchReceipt): Promise<void> {
1224
+ await this.store.transact(key, current => {
1225
+ const found = current?.inboundDispatches?.find(candidate => this.#sameInboundReceipt(candidate, receipt));
1226
+ return !current || !found ? current : this.#completeInboundDispatch(current, found, true);
1227
+ });
1228
+ }
1229
+ #completeInboundDispatch(
1230
+ current: SlackConversation,
1231
+ receipt: SlackInboundDispatchReceipt,
1232
+ terminal: boolean,
1233
+ ): SlackConversation {
1234
+ return nextRecord(current, {
1235
+ pendingActionId:
1236
+ receipt.kind === "action" && current.pendingActionId === receipt.actionId
1237
+ ? undefined
1238
+ : current.pendingActionId,
1239
+ seenEventIds: [...current.seenEventIds, receipt.eventId],
1240
+ seenInteractionIds: [...current.seenInteractionIds, receipt.interactionId],
1241
+ seenRetryKeys: [...current.seenRetryKeys, receipt.retryKey],
1242
+ seenContextIds:
1243
+ receipt.eventContext === undefined
1244
+ ? current.seenContextIds
1245
+ : [...current.seenContextIds, receipt.eventContext],
1246
+ inboundDispatches: terminal
1247
+ ? (current.inboundDispatches ?? []).filter(candidate => !this.#sameInboundReceipt(candidate, receipt))
1248
+ : current.inboundDispatches,
1249
+ updatedAt: this.#now(),
1250
+ });
1251
+ }
1252
+ async #adoptOrphanInbound(
1253
+ effect: ChatEffect<SlackInboundEffectPayload>,
1254
+ ): Promise<{ key: string; sessionId: string; receipt: SlackInboundDispatchReceipt } | undefined> {
1255
+ const payload = effect.payload;
1256
+ const routing = payload?.routing;
1257
+ if (!routing || !this.#validInboundRouting(routing) || !(await this.#actorAuthorized(routing.actorId))) {
1258
+ await this.#terminalizeRejectedInbound(effect.id);
1259
+ return undefined;
1260
+ }
1261
+ const matches = Object.entries((await this.store.load()).conversations).filter(
1262
+ ([, record]) =>
1263
+ record.teamId === routing.teamId &&
1264
+ record.channelId === routing.channelId &&
1265
+ record.rootTs === routing.rootTs,
1266
+ );
1267
+ if (matches.length !== 1) {
1268
+ await this.#terminalizeRejectedInbound(effect.id);
1269
+ return undefined;
1270
+ }
1271
+ const key = matches[0]![0];
1272
+ const expectedEffectId = `inbound:${routing.teamId}:${routing.channelId}:${routing.rootTs}:${routing.actorId}:${routing.eventId}:${routing.interactionId}`;
1273
+ const expectedIdempotencyKey = `slack:${routing.teamId}:${routing.channelId}:${routing.rootTs}:${routing.actorId}:${routing.eventId}:${routing.interactionId}`;
1274
+ const validPayload =
1275
+ effect.transport === "slack" &&
1276
+ !!effect.sessionId &&
1277
+ Number.isSafeInteger(effect.endpointGeneration) &&
1278
+ effect.endpointGeneration > 0 &&
1279
+ effect.id === expectedEffectId &&
1280
+ payload.idempotencyKey === expectedIdempotencyKey &&
1281
+ ((payload.type === "command" && routing.kind === "command" && effect.kind === "sdk.inbound.command") ||
1282
+ (payload.type === "reply" &&
1283
+ routing.kind === "action" &&
1284
+ effect.kind === "sdk.inbound.reply" &&
1285
+ payload.id === routing.actionId));
1286
+ let receipt: SlackInboundDispatchReceipt | undefined;
1287
+ await this.store.transact(key, current => {
1288
+ if (
1289
+ !validPayload ||
1290
+ !current ||
1291
+ !effect.sessionId ||
1292
+ current.sessionId !== effect.sessionId ||
1293
+ !acceptsSlackInbound(current, routing.rootTs, effect.endpointGeneration)
1294
+ )
1295
+ return current;
1296
+ const existing = (current.inboundDispatches ?? []).find(
1297
+ candidate =>
1298
+ candidate.eventId === routing.eventId ||
1299
+ candidate.interactionId === routing.interactionId ||
1300
+ candidate.retryKey === routing.retryKey ||
1301
+ (routing.eventContext !== undefined && candidate.eventContext === routing.eventContext),
1302
+ );
1303
+ if (existing) {
1304
+ if (this.#matchesInboundEffect(effect, existing)) receipt = existing;
1305
+ return current;
1306
+ }
1307
+ if (
1308
+ current.seenEventIds.includes(routing.eventId) ||
1309
+ current.seenInteractionIds.includes(routing.interactionId) ||
1310
+ current.seenRetryKeys.includes(routing.retryKey) ||
1311
+ (routing.eventContext !== undefined && current.seenContextIds.includes(routing.eventContext)) ||
1312
+ (routing.kind === "action" && current.pendingActionId !== routing.actionId)
1313
+ )
1314
+ return current;
1315
+ receipt = {
1316
+ key: `${routing.eventId}:${routing.interactionId}`,
1317
+ eventId: routing.eventId,
1318
+ interactionId: routing.interactionId,
1319
+ retryKey: routing.retryKey,
1320
+ eventContext: routing.eventContext,
1321
+ kind: routing.kind,
1322
+ ...(routing.kind === "action" ? { actionId: routing.actionId } : {}),
1323
+ endpointGeneration: effect.endpointGeneration,
1324
+ effectId: effect.id,
1325
+ idempotencyKey: payload.idempotencyKey,
1326
+ };
1327
+ return nextRecord(current, {
1328
+ inboundDispatches: [...(current.inboundDispatches ?? []), receipt],
1329
+ updatedAt: this.#now(),
1330
+ });
1331
+ });
1332
+ if (receipt && effect.sessionId) return { key, sessionId: effect.sessionId, receipt };
1333
+ await this.#terminalizeRejectedInbound(effect.id);
1334
+ return undefined;
1335
+ }
1336
+
1337
+ async #terminalizeRejectedInbound(effectId: string): Promise<void> {
1338
+ await this.#journal.terminalize(effectId, { status: "rejected" });
1339
+ }
1340
+
1341
+ async #finishDispatch(
1342
+ claim: { key: string; endpoint: SlackEndpoint; receipt: SlackInboundDispatchReceipt },
1343
+ state: "terminal" | "uncertain",
1344
+ ): Promise<void> {
1345
+ await this.store.transact(claim.key, current => {
1346
+ if (!current || !acceptsSlackInbound(current, current.rootTs ?? "", claim.endpoint.generation)) return current;
1347
+ const found = (current.inboundDispatches ?? []).find(receipt =>
1348
+ this.#sameInboundReceipt(receipt, claim.receipt),
1349
+ );
1350
+ return found ? this.#completeInboundDispatch(current, found, state === "terminal") : current;
1351
+ });
1352
+ }
1353
+
1354
+ async #releaseDispatch(claim: {
1355
+ key: string;
1356
+ endpoint: SlackEndpoint;
1357
+ receipt: SlackInboundDispatchReceipt;
1358
+ }): Promise<void> {
1359
+ await this.store.transact(claim.key, current => {
1360
+ if (!current || !acceptsSlackInbound(current, current.rootTs ?? "", claim.endpoint.generation)) return current;
1361
+ const found = (current.inboundDispatches ?? []).find(receipt =>
1362
+ this.#sameInboundReceipt(receipt, claim.receipt),
1363
+ );
1364
+ return found
1365
+ ? nextRecord(current, {
1366
+ inboundDispatches: (current.inboundDispatches ?? []).filter(
1367
+ candidate => !this.#sameInboundReceipt(candidate, found),
1368
+ ),
1369
+ updatedAt: this.#now(),
1370
+ })
1371
+ : current;
1372
+ });
1373
+ }
1374
+
1375
+ async #reconcileTerminalProviderReceipts(): Promise<void> {
1376
+ for (const effect of await this.#journal.list()) {
1377
+ try {
1378
+ if (effect.kind !== "provider-post" || effect.transport !== "slack" || effect.state !== "terminal")
1379
+ continue;
1380
+ const payload = effect.payload as { channel?: unknown; threadTs?: unknown; clientMsgId?: unknown };
1381
+ const receipt = effect.receipt;
1382
+ if (
1383
+ receipt?.provider !== "slack" ||
1384
+ typeof payload.clientMsgId !== "string" ||
1385
+ (receipt.status !== "posted" && receipt.status !== "not_found") ||
1386
+ (receipt.status === "posted" && typeof receipt.timestamp !== "string")
1387
+ )
1388
+ continue;
1389
+ const normalized = {
1390
+ channel: payload.channel,
1391
+ threadTs: payload.threadTs,
1392
+ clientMsgId: payload.clientMsgId,
1393
+ };
1394
+ if (typeof normalized.threadTs === "string") {
1395
+ if (receipt.status === "posted") await this.#activateReconciledAction(effect, normalized);
1396
+ else await this.#releaseUnreconciledAction(effect, normalized);
1397
+ } else if (receipt.status === "posted") {
1398
+ await this.#activateReconciledRoot(effect, normalized, receipt.timestamp!);
1399
+ } else {
1400
+ await this.#releaseUnreconciledRoot(effect, normalized);
1401
+ }
1402
+ } catch {
1403
+ await this.#recordRecoveryFailure(effect);
1404
+ }
1405
+ }
1406
+ }
1407
+
1408
+ async #activateReconciledRoot(
1409
+ effect: ChatEffect,
1410
+ payload: { channel?: unknown; clientMsgId: string },
1411
+ rootTs: string,
1412
+ ): Promise<void> {
1413
+ if (
1414
+ !effect.sessionId ||
1415
+ typeof payload.channel !== "string" ||
1416
+ payload.channel !== this.options.channelId ||
1417
+ !Number.isSafeInteger(effect.endpointGeneration) ||
1418
+ effect.endpointGeneration <= 0
1419
+ )
1420
+ return;
1421
+ // Receipt recovery must retain the original mapping through an endpoint roll;
1422
+ // inbound routing still fences it against the now-current endpoint generation.
1423
+ await this.store.transact(this.#intentKey(effect.sessionId), current =>
1424
+ current &&
1425
+ current.state === "posting_root" &&
1426
+ current.sessionId === effect.sessionId &&
1427
+ current.teamId === this.options.teamId &&
1428
+ current.channelId === payload.channel &&
1429
+ current.clientMsgId === payload.clientMsgId &&
1430
+ current.endpointGeneration === effect.endpointGeneration
1431
+ ? nextRecord(current, {
1432
+ state: "active",
1433
+ rootTs,
1434
+ endpointGeneration: effect.endpointGeneration,
1435
+ rootPublicationOwner: undefined,
1436
+ rootPublicationLeaseExpiresAt: undefined,
1437
+ lastError: undefined,
1438
+ updatedAt: this.#now(),
1439
+ })
1440
+ : current,
1441
+ );
1442
+ }
1443
+
1444
+ async #activateReconciledAction(
1445
+ effect: ChatEffect,
1446
+ payload: { channel?: unknown; threadTs?: unknown; clientMsgId: string },
1447
+ ): Promise<void> {
1448
+ if (
1449
+ !effect.sessionId ||
1450
+ typeof payload.channel !== "string" ||
1451
+ typeof payload.threadTs !== "string" ||
1452
+ !Number.isSafeInteger(effect.endpointGeneration) ||
1453
+ effect.endpointGeneration <= 0
1454
+ )
1455
+ return;
1456
+ const threadTs = payload.threadTs;
1457
+ const document = await this.store.load();
1458
+ const found = Object.entries(document.conversations)
1459
+ .map(([key, record]) => ({ key, record }))
1460
+ .filter(
1461
+ ({ record }) =>
1462
+ record.state === "active" &&
1463
+ record.sessionId === effect.sessionId &&
1464
+ record.teamId === this.options.teamId &&
1465
+ record.channelId === payload.channel &&
1466
+ record.rootTs === threadTs &&
1467
+ record.endpointGeneration === effect.endpointGeneration &&
1468
+ record.outboundActionClientMsgId === payload.clientMsgId &&
1469
+ typeof record.outboundActionId === "string",
1470
+ )[0];
1471
+ if (!found) return;
1472
+ await this.store.transact(found.key, current =>
1473
+ current &&
1474
+ acceptsSlackInbound(current, threadTs, effect.endpointGeneration) &&
1475
+ current.outboundActionClientMsgId === payload.clientMsgId &&
1476
+ current.outboundActionId === found.record.outboundActionId
1477
+ ? nextRecord(current, {
1478
+ pendingActionId: current.outboundActionId,
1479
+ outboundActionId: undefined,
1480
+ outboundActionClientMsgId: undefined,
1481
+ outboundActionOwner: undefined,
1482
+ outboundActionLeaseExpiresAt: undefined,
1483
+ updatedAt: this.#now(),
1484
+ })
1485
+ : current,
1486
+ );
1487
+ }
1488
+ async #releaseUnreconciledRoot(
1489
+ effect: ChatEffect,
1490
+ payload: { channel?: unknown; clientMsgId: string },
1491
+ ): Promise<void> {
1492
+ if (
1493
+ !effect.sessionId ||
1494
+ typeof payload.channel !== "string" ||
1495
+ payload.channel !== this.options.channelId ||
1496
+ !Number.isSafeInteger(effect.endpointGeneration) ||
1497
+ effect.endpointGeneration <= 0
1498
+ )
1499
+ return;
1500
+ await this.store.transact(this.#intentKey(effect.sessionId), current =>
1501
+ current &&
1502
+ current.state === "posting_root" &&
1503
+ current.sessionId === effect.sessionId &&
1504
+ current.teamId === this.options.teamId &&
1505
+ current.channelId === payload.channel &&
1506
+ current.clientMsgId === payload.clientMsgId &&
1507
+ current.endpointGeneration === effect.endpointGeneration
1508
+ ? nextRecord(current, {
1509
+ state: "error",
1510
+ rootPublicationOwner: undefined,
1511
+ rootPublicationLeaseExpiresAt: undefined,
1512
+ lastError: "provider_not_found",
1513
+ updatedAt: this.#now(),
1514
+ })
1515
+ : current,
1516
+ );
1517
+ }
1518
+ async #releaseUnreconciledAction(
1519
+ effect: ChatEffect,
1520
+ payload: { channel?: unknown; threadTs?: unknown; clientMsgId: string },
1521
+ ): Promise<void> {
1522
+ if (
1523
+ !effect.sessionId ||
1524
+ typeof payload.channel !== "string" ||
1525
+ typeof payload.threadTs !== "string" ||
1526
+ !Number.isSafeInteger(effect.endpointGeneration) ||
1527
+ effect.endpointGeneration <= 0
1528
+ )
1529
+ return;
1530
+ const threadTs = payload.threadTs;
1531
+ const document = await this.store.load();
1532
+ const found = Object.entries(document.conversations).find(
1533
+ ([, record]) =>
1534
+ record.state === "active" &&
1535
+ record.sessionId === effect.sessionId &&
1536
+ record.teamId === this.options.teamId &&
1537
+ record.channelId === payload.channel &&
1538
+ record.rootTs === threadTs &&
1539
+ record.endpointGeneration === effect.endpointGeneration &&
1540
+ record.outboundActionClientMsgId === payload.clientMsgId,
1541
+ );
1542
+ if (!found) return;
1543
+ await this.store.transact(found[0], current =>
1544
+ current &&
1545
+ acceptsSlackInbound(current, threadTs, effect.endpointGeneration) &&
1546
+ current.outboundActionClientMsgId === payload.clientMsgId
1547
+ ? nextRecord(current, {
1548
+ outboundActionId: undefined,
1549
+ outboundActionClientMsgId: undefined,
1550
+ outboundActionOwner: undefined,
1551
+ outboundActionLeaseExpiresAt: undefined,
1552
+ updatedAt: this.#now(),
1553
+ })
1554
+ : current,
1555
+ );
1556
+ }
1557
+ async #recordRecoveryFailure(effect: ChatEffect): Promise<void> {
1558
+ try {
1559
+ if (!effect.sessionId) return;
1560
+ const found = await this.findSession(effect.sessionId, true);
1561
+ if (!found) return;
1562
+ await this.store.transact(found.key, current => {
1563
+ if (!current || current.sessionId !== effect.sessionId) return current;
1564
+ return nextRecord(current, { lastError: "recovery_failure", updatedAt: this.#now() });
1565
+ });
1566
+ } catch {
1567
+ // Diagnostics must never remove the durable recovery trigger.
1568
+ }
1569
+ }
1570
+
1571
+ async #drainProviderEffects(): Promise<boolean> {
1572
+ let failed = false;
1573
+ for (const effect of await this.#journal.list()) {
1574
+ try {
1575
+ if (effect.kind !== "provider-post" || effect.state === "terminal") continue;
1576
+ const current = !!effect.sessionId && (await this.#providerEffectCurrent(effect));
1577
+ if (!current && effect.state !== "uncertain" && effect.state !== "leased") {
1578
+ await this.#journal.terminalize(effect.id, { provider: "slack", status: "stale_noop" });
1579
+ continue;
1580
+ }
1581
+ if (!effect.sessionId) continue;
1582
+ const payload = effect.payload as {
1583
+ channel?: unknown;
1584
+ text?: unknown;
1585
+ threadTs?: unknown;
1586
+ clientMsgId?: unknown;
1587
+ };
1588
+ if (
1589
+ typeof payload.channel !== "string" ||
1590
+ typeof payload.text !== "string" ||
1591
+ typeof payload.clientMsgId !== "string" ||
1592
+ (payload.threadTs !== undefined && typeof payload.threadTs !== "string")
1593
+ )
1594
+ continue;
1595
+ await this.#postDurable(effect.id, effect.sessionId, effect.endpointGeneration, {
1596
+ channel: payload.channel,
1597
+ text: payload.text,
1598
+ ...(typeof payload.threadTs === "string" ? { threadTs: payload.threadTs } : {}),
1599
+ clientMsgId: payload.clientMsgId,
1600
+ });
1601
+ } catch {
1602
+ failed = true;
1603
+ await this.#recordRecoveryFailure(effect);
1604
+ }
1605
+ }
1606
+ await this.#reconcileTerminalProviderReceipts();
1607
+ return failed;
1608
+ }
1609
+ async #rescheduleAfterEffectTransition<T extends ChatEffect | undefined>(transition: Promise<T>): Promise<T> {
1610
+ const effect = await transition;
1611
+ if (effect?.state !== "terminal") await this.#scheduleLeaseRecovery();
1612
+ return effect;
1613
+ }
1614
+ async #scheduleLeaseRecovery(recoveryFailed = false): Promise<void> {
1615
+ const scheduled = this.#leaseRecoveryScheduling.then(async () => {
1616
+ await this.#scheduleLeaseRecoveryNow(recoveryFailed);
1617
+ });
1618
+ this.#leaseRecoveryScheduling = scheduled.catch(() => undefined);
1619
+ return await scheduled;
1620
+ }
1621
+ async #scheduleLeaseRecoveryNow(recoveryFailed: boolean): Promise<void> {
1622
+ if (!this.#started) return;
1623
+ const now = this.#now();
1624
+ const recoveryAt = (await this.#journal.list())
1625
+ .filter(effect => effect.transport === "slack")
1626
+ .reduce<number | undefined>(
1627
+ (earliest, effect) => {
1628
+ const claimAt =
1629
+ effect.state === "leased" && Number.isFinite(effect.leaseExpiresAt)
1630
+ ? effect.leaseExpiresAt
1631
+ : effect.state === "pending" ||
1632
+ effect.state === "accepted" ||
1633
+ (effect.state === "uncertain" && !effect.kind.includes(".inbound."))
1634
+ ? now
1635
+ : undefined;
1636
+ return claimAt === undefined || (earliest !== undefined && earliest <= claimAt) ? earliest : claimAt;
1637
+ },
1638
+ recoveryFailed ? now : undefined,
1639
+ );
1640
+ if (!this.#started) return;
1641
+ if (recoveryAt === undefined) {
1642
+ this.#clearLeaseRecoveryTimer();
1643
+ this.#leaseRecoveryFailures = 0;
1644
+ return;
1645
+ }
1646
+ if (this.#leaseRecoveryAt !== undefined && this.#leaseRecoveryAt <= recoveryAt) return;
1647
+ this.#clearLeaseRecoveryTimer();
1648
+ this.#leaseRecoveryAt = recoveryAt;
1649
+ const delay =
1650
+ recoveryAt <= now
1651
+ ? Math.min(1_000, 25 * 2 ** Math.min(this.#leaseRecoveryFailures, 5))
1652
+ : Math.min(recoveryAt - now, 2_147_483_647);
1653
+ const timerGeneration = this.#leaseRecoveryTimerGeneration;
1654
+ this.#leaseRecoveryTimer = setTimeout(() => {
1655
+ if (!this.#started || timerGeneration !== this.#leaseRecoveryTimerGeneration) return;
1656
+ this.#leaseRecoveryTimer = undefined;
1657
+ this.#leaseRecoveryAt = undefined;
1658
+ void this.#track(this.#recoverLeasedEffects());
1659
+ }, delay);
1660
+ }
1661
+ #clearLeaseRecoveryTimer(): void {
1662
+ this.#leaseRecoveryTimerGeneration++;
1663
+ if (this.#leaseRecoveryTimer) clearTimeout(this.#leaseRecoveryTimer);
1664
+ this.#leaseRecoveryTimer = undefined;
1665
+ this.#leaseRecoveryAt = undefined;
1666
+ }
1667
+ async #recoverLeasedEffects(): Promise<void> {
1668
+ if (!this.#started || this.#recoveringLeasedEffects) return;
1669
+ this.#recoveringLeasedEffects = true;
1670
+ let failed = false;
1671
+ try {
1672
+ try {
1673
+ await this.#reconcileTerminalProviderReceipts();
1674
+ } catch {
1675
+ failed = true;
1676
+ }
1677
+ try {
1678
+ failed ||= await this.#drainProviderEffects();
1679
+ } catch {
1680
+ failed = true;
1681
+ }
1682
+ try {
1683
+ await this.#reconcileTerminalProviderReceipts();
1684
+ } catch {
1685
+ failed = true;
1686
+ }
1687
+ try {
1688
+ await this.#drainPendingDispatches();
1689
+ } catch {
1690
+ failed = true;
1691
+ }
1692
+ } finally {
1693
+ if (failed) this.#leaseRecoveryFailures = Math.min(this.#leaseRecoveryFailures + 1, 5);
1694
+ else this.#leaseRecoveryFailures = 0;
1695
+ try {
1696
+ await this.#scheduleLeaseRecovery(failed);
1697
+ } catch {
1698
+ /* retained effects are retried by the next trigger */
1699
+ } finally {
1700
+ this.#recoveringLeasedEffects = false;
1701
+ }
1702
+ }
1703
+ }
1704
+
1705
+ async #providerEffectCurrent(effect: ChatEffect): Promise<boolean> {
1706
+ if (!effect.sessionId || !Number.isSafeInteger(effect.endpointGeneration) || effect.endpointGeneration <= 0)
1707
+ return false;
1708
+ const endpoint = await this.#resolveEndpoint(effect.sessionId);
1709
+ if (!endpoint || endpoint.generation !== effect.endpointGeneration) return false;
1710
+ const payload = effect.payload as { threadTs?: unknown };
1711
+ const threadTs = payload.threadTs;
1712
+ const records = Object.values((await this.store.load()).conversations);
1713
+ if (typeof threadTs === "string") {
1714
+ return records.some(
1715
+ record =>
1716
+ record.sessionId === effect.sessionId &&
1717
+ acceptsSlackInbound(record, threadTs, effect.endpointGeneration),
1718
+ );
1719
+ }
1720
+ return records.some(
1721
+ record =>
1722
+ record.sessionId === effect.sessionId &&
1723
+ record.endpointGeneration === effect.endpointGeneration &&
1724
+ record.state === "posting_root",
1725
+ );
1726
+ }
1727
+
1728
+ async #providerEffectPayload(
1729
+ id: string,
1730
+ sessionId: string,
1731
+ endpointGeneration: number,
1732
+ expected: { channel: string; text: string; threadTs?: string; clientMsgId: string },
1733
+ ): Promise<{ payload: typeof expected; existed: boolean }> {
1734
+ const existing = await this.#journal.read<typeof expected>(id);
1735
+ if (!existing) return { payload: expected, existed: false };
1736
+ const payload = existing.payload;
1737
+ if (
1738
+ existing.kind !== "provider-post" ||
1739
+ existing.transport !== "slack" ||
1740
+ existing.sessionId !== sessionId ||
1741
+ existing.endpointGeneration !== endpointGeneration ||
1742
+ typeof payload.channel !== "string" ||
1743
+ typeof payload.text !== "string" ||
1744
+ typeof payload.clientMsgId !== "string" ||
1745
+ (payload.threadTs !== undefined && typeof payload.threadTs !== "string") ||
1746
+ payload.channel !== expected.channel ||
1747
+ payload.threadTs !== expected.threadTs ||
1748
+ payload.clientMsgId !== expected.clientMsgId
1749
+ ) {
1750
+ throw new SlackEndpointBindingError("Slack provider effect identity does not match the durable occurrence.");
1751
+ }
1752
+ return { payload, existed: true };
1753
+ }
1754
+
1755
+ async #postDurable(
1756
+ id: string,
1757
+ sessionId: string,
1758
+ endpointGeneration: number,
1759
+ payload: { channel: string; text: string; threadTs?: string; clientMsgId: string },
1760
+ ): Promise<SlackPostedMessage> {
1761
+ if (!Number.isSafeInteger(endpointGeneration) || endpointGeneration <= 0)
1762
+ throw new SlackEndpointBindingError("Slack provider effects require a positive endpoint generation.");
1763
+ const initial = await this.#rescheduleAfterEffectTransition(
1764
+ this.#journal.enqueue({
1765
+ id,
1766
+ kind: "provider-post",
1767
+ transport: "slack",
1768
+ sessionId,
1769
+ endpointGeneration,
1770
+ payload,
1771
+ }),
1772
+ );
1773
+ const fromReceipt = (effect: typeof initial): SlackPostedMessage | undefined => {
1774
+ if (
1775
+ effect.state !== "terminal" ||
1776
+ effect.receipt?.status !== "posted" ||
1777
+ !effect.receipt.channelId ||
1778
+ !effect.receipt.timestamp
1779
+ )
1780
+ return undefined;
1781
+ return {
1782
+ channel: effect.receipt.channelId,
1783
+ ts: effect.receipt.timestamp,
1784
+ client_msg_id: effect.receipt.messageId,
1785
+ };
1786
+ };
1787
+ const completed = fromReceipt(initial);
1788
+ if (completed) return completed;
1789
+ if (initial.state === "terminal") throw new Error("Slack provider effect previously failed");
1790
+ let effect: ChatEffect<typeof payload> | undefined;
1791
+ for (let attempt = 0; attempt < 100 && !effect; attempt++) {
1792
+ effect = await this.#rescheduleAfterEffectTransition(
1793
+ this.#journal.claim<typeof payload>(id, this.#publicationOwnerId, Math.max(this.#publicationLeaseMs, 100)),
1794
+ );
1795
+ if (effect) break;
1796
+ const current = await this.#journal.read<typeof payload>(id);
1797
+ if (current) {
1798
+ const posted = fromReceipt(current);
1799
+ if (posted) return posted;
1800
+ if (current.state === "terminal") throw new Error("Slack provider effect previously failed");
1801
+ }
1802
+ await Bun.sleep(1);
1803
+ }
1804
+ if (!effect) throw new Error("Slack provider effect is owned by another worker");
1805
+ const lease: ChatEffectLease = { owner: this.#publicationOwnerId, epoch: effect.epoch };
1806
+ // A recovered lease may have crossed the provider boundary before its owner
1807
+ // died, and a fresh post may have reached Slack at a now-superseded generation.
1808
+ // Reconcile first in all cases. Only an effect that may have crossed the
1809
+ // provider boundary is terminalized after an absent reconciliation; a stale
1810
+ // pending effect remains nonterminal for recovery.
1811
+ const requiresReconciliation =
1812
+ initial.state === "accepted" || initial.state === "uncertain" || initial.state === "leased";
1813
+ try {
1814
+ const posted = await this.#withEffectLease(id, lease, async () => {
1815
+ const found = await this.options.provider.findMessageByClientMsgId({
1816
+ channel: effect!.payload.channel,
1817
+ threadTs: effect!.payload.threadTs,
1818
+ clientMsgId: effect!.payload.clientMsgId,
1819
+ });
1820
+ if (found) return found;
1821
+ if (!(await this.#providerEffectCurrent(effect!))) {
1822
+ if (requiresReconciliation) throw new SlackReconciledAbsentEffectError();
1823
+ throw new SlackStaleEffectError();
1824
+ }
1825
+ return await this.options.provider.postMessage(effect!.payload);
1826
+ });
1827
+
1828
+ if (
1829
+ !(await this.#journal.record(id, lease, "terminal", {
1830
+ provider: "slack",
1831
+ channelId: posted.channel,
1832
+ timestamp: posted.ts,
1833
+ messageId: posted.client_msg_id ?? posted.ts,
1834
+ status: "posted",
1835
+ }))
1836
+ )
1837
+ throw new Error("Slack provider effect lease expired before commit");
1838
+
1839
+ return posted;
1840
+ } catch (error) {
1841
+ if (error instanceof SlackReconciledAbsentEffectError) {
1842
+ await this.#rescheduleAfterEffectTransition(
1843
+ this.#journal.record(id, lease, "terminal", { provider: "slack", status: "not_found" }),
1844
+ );
1845
+ throw new SlackStaleEffectError();
1846
+ }
1847
+ if (error instanceof SlackStaleEffectError) throw error;
1848
+ if (this.#isUncertainPostFailure(error)) {
1849
+ try {
1850
+ const reconciled = await this.#withEffectLease(
1851
+ id,
1852
+ lease,
1853
+ async () =>
1854
+ await this.options.provider.findMessageByClientMsgId({
1855
+ channel: effect!.payload.channel,
1856
+ threadTs: effect!.payload.threadTs,
1857
+ clientMsgId: effect!.payload.clientMsgId,
1858
+ }),
1859
+ );
1860
+ if (reconciled) {
1861
+ if (
1862
+ !(await this.#journal.record(id, lease, "terminal", {
1863
+ provider: "slack",
1864
+ channelId: reconciled.channel,
1865
+ timestamp: reconciled.ts,
1866
+ messageId: reconciled.client_msg_id ?? reconciled.ts,
1867
+ status: "posted",
1868
+ }))
1869
+ )
1870
+ throw new Error("Slack provider effect lease expired before commit");
1871
+ return reconciled;
1872
+ }
1873
+ } catch {
1874
+ // Preserve the uncertain effect for a later reconciliation attempt.
1875
+ }
1876
+ }
1877
+ const uncertain = this.#isUncertainPostFailure(error);
1878
+ await this.#rescheduleAfterEffectTransition(
1879
+ this.#journal.record(id, lease, uncertain ? "uncertain" : "terminal", {
1880
+ provider: "slack",
1881
+ status: uncertain ? "uncertain" : "failed",
1882
+ }),
1883
+ );
1884
+ throw error;
1885
+ }
1886
+ }
1887
+
1888
+ async #withRootLease<T>(key: string, clientMsgId: string, fence: number, operation: () => Promise<T>): Promise<T> {
1889
+ return await this.#withPublicationLease(operation, async () => {
1890
+ let renewed = false;
1891
+ await this.store.transact(key, current => {
1892
+ if (
1893
+ !current ||
1894
+ current.clientMsgId !== clientMsgId ||
1895
+ current.rootPublicationOwner !== this.#publicationOwnerId ||
1896
+ current.rootPublicationFence !== fence
1897
+ )
1898
+ return current;
1899
+ renewed = true;
1900
+ return nextRecord(current, {
1901
+ rootPublicationLeaseExpiresAt: this.#now() + this.#publicationLeaseMs,
1902
+ updatedAt: this.#now(),
1903
+ });
1904
+ });
1905
+ if (!renewed) throw new Error("Slack root publication lease renewal failed");
1906
+ });
1907
+ }
1908
+
1909
+ async #withActionLease<T>(key: string, clientMsgId: string, fence: number, operation: () => Promise<T>): Promise<T> {
1910
+ return await this.#withPublicationLease(operation, async () => {
1911
+ let renewed = false;
1912
+ await this.store.transact(key, current => {
1913
+ if (
1914
+ !current ||
1915
+ current.outboundActionClientMsgId !== clientMsgId ||
1916
+ current.outboundActionOwner !== this.#publicationOwnerId ||
1917
+ current.outboundActionFence !== fence
1918
+ )
1919
+ return current;
1920
+ renewed = true;
1921
+ return nextRecord(current, {
1922
+ outboundActionLeaseExpiresAt: this.#now() + this.#publicationLeaseMs,
1923
+ updatedAt: this.#now(),
1924
+ });
1925
+ });
1926
+ if (!renewed) throw new Error("Slack action publication lease renewal failed");
1927
+ });
1928
+ }
1929
+
1930
+ async #withPublicationLease<T>(operation: () => Promise<T>, renew: () => Promise<void>): Promise<T> {
1931
+ return await this.#withRenewal(operation, renew);
1932
+ }
1933
+
1934
+ async #withRenewal<T>(
1935
+ operation: () => Promise<T>,
1936
+ renew: () => Promise<void>,
1937
+ renewBeforeOperation = true,
1938
+ ): Promise<T> {
1939
+ if (renewBeforeOperation) await renew();
1940
+ let failure: unknown;
1941
+ let renewing = Promise.resolve();
1942
+ let renewalPending = false;
1943
+ const renewLease = async () => {
1944
+ try {
1945
+ await renew();
1946
+ } catch (error) {
1947
+ failure ??= error;
1948
+ }
1949
+ };
1950
+ const timer = setInterval(
1951
+ () => {
1952
+ if (renewalPending || failure) return;
1953
+ renewalPending = true;
1954
+ renewing = renewing.then(renewLease).finally(() => {
1955
+ renewalPending = false;
1956
+ });
1957
+ },
1958
+ Math.max(1, Math.floor(this.#publicationLeaseMs / 4)),
1959
+ );
1960
+ try {
1961
+ const result = await operation();
1962
+ await renewing;
1963
+ if (failure) throw failure;
1964
+ return result;
1965
+ } finally {
1966
+ clearInterval(timer);
1967
+ await renewing;
1968
+ }
1969
+ }
1970
+
1971
+ async #waitForRootReconciliation(key: string, initial: SlackConversation): Promise<SlackConversation | undefined> {
1972
+ const clientMsgId = initial.clientMsgId;
1973
+ const endpointGeneration = initial.endpointGeneration;
1974
+ if (
1975
+ typeof clientMsgId !== "string" ||
1976
+ typeof endpointGeneration !== "number" ||
1977
+ !Number.isSafeInteger(endpointGeneration) ||
1978
+ endpointGeneration <= 0
1979
+ )
1980
+ throw new SlackEndpointBindingError("Slack root publication has no stable reconciliation identity.");
1981
+ for (let attempt = 0; attempt < 100; attempt++) {
1982
+ const current = await this.store.read(key);
1983
+ if (
1984
+ current?.state !== "posting_root" ||
1985
+ current.clientMsgId !== clientMsgId ||
1986
+ current.endpointGeneration !== endpointGeneration
1987
+ )
1988
+ return current;
1989
+ const effect:
1990
+ | ChatEffect<{
1991
+ channel?: unknown;
1992
+ text?: unknown;
1993
+ threadTs?: unknown;
1994
+ clientMsgId?: unknown;
1995
+ }>
1996
+ | undefined = await this.#journal.read(`root:${current.sessionId}:${clientMsgId}`);
1997
+ if (effect?.state === "terminal") {
1998
+ await this.#reconcileTerminalProviderReceipts();
1999
+ await Bun.sleep(10);
2000
+ continue;
2001
+ }
2002
+ const payload: { channel?: unknown; text?: unknown; threadTs?: unknown; clientMsgId?: unknown } | undefined =
2003
+ effect?.payload;
2004
+ if (
2005
+ effect?.kind === "provider-post" &&
2006
+ effect.transport === "slack" &&
2007
+ effect.sessionId === current.sessionId &&
2008
+ typeof current.sessionId === "string" &&
2009
+ effect.endpointGeneration === endpointGeneration &&
2010
+ (effect.state === "pending" ||
2011
+ effect.state === "accepted" ||
2012
+ effect.state === "uncertain" ||
2013
+ (effect.state === "leased" && this.#leaseExpired(effect.leaseExpiresAt, this.#now()))) &&
2014
+ payload &&
2015
+ typeof payload.channel === "string" &&
2016
+ payload.channel === current.channelId &&
2017
+ typeof payload.text === "string" &&
2018
+ payload.threadTs === undefined &&
2019
+ payload.clientMsgId === clientMsgId
2020
+ ) {
2021
+ try {
2022
+ await this.#postDurable(effect.id, current.sessionId, endpointGeneration, {
2023
+ channel: payload.channel,
2024
+ text: payload.text,
2025
+ clientMsgId,
2026
+ });
2027
+ } catch (error) {
2028
+ if (!(error instanceof SlackStaleEffectError)) throw error;
2029
+ }
2030
+ await this.#reconcileTerminalProviderReceipts();
2031
+ continue;
2032
+ }
2033
+ await Bun.sleep(10);
2034
+ }
2035
+ throw new Error("Slack root post reconciliation is still pending");
2036
+ }
2037
+
2038
+ async #waitForRoot(
2039
+ key: string,
2040
+ sessionId: string,
2041
+ body: string,
2042
+ endpointGeneration: number,
2043
+ ): Promise<SlackConversation> {
2044
+ for (let attempt = 0; attempt < 100; attempt++) {
2045
+ await Bun.sleep(10);
2046
+ const current = await this.store.read(key);
2047
+ if (current?.state === "active") {
2048
+ const currentGeneration = this.#requireEndpointGeneration(current);
2049
+ if (currentGeneration === endpointGeneration) return current;
2050
+ if (currentGeneration > endpointGeneration)
2051
+ throw new SlackEndpointBindingError("Slack root belongs to a newer endpoint generation.");
2052
+ return await this.resume(sessionId, body, endpointGeneration);
2053
+ }
2054
+ if (
2055
+ current?.state === "error" ||
2056
+ (current?.state === "posting_root" &&
2057
+ this.#leaseExpired(current.rootPublicationLeaseExpiresAt, this.#now())) ||
2058
+ (current !== undefined &&
2059
+ current.rootPublicationOwner !== undefined &&
2060
+ this.#leaseExpired(current.rootPublicationLeaseExpiresAt, this.#now()))
2061
+ ) {
2062
+ return await this.postRoot(sessionId, body, endpointGeneration);
2063
+ }
2064
+ }
2065
+ throw new Error("Slack root post is still pending");
2066
+ }
2067
+
2068
+ async #waitForAction(key: string, sessionId: string, body: string, actionId: string): Promise<SlackConversation> {
2069
+ for (let attempt = 0; attempt < 100; attempt++) {
2070
+ await Bun.sleep(10);
2071
+ const current = await this.store.read(key);
2072
+ if (current?.pendingActionId === actionId && !current.outboundActionId) return current;
2073
+ if (
2074
+ current?.outboundActionId === actionId &&
2075
+ this.#leaseExpired(current.outboundActionLeaseExpiresAt, this.#now())
2076
+ ) {
2077
+ return await this.notify(sessionId, body, actionId);
2078
+ }
2079
+ }
2080
+ throw new Error("Slack action publication is still pending");
2081
+ }
2082
+
2083
+ async findSession(
2084
+ sessionId: string,
2085
+ includeInactive: boolean,
2086
+ ): Promise<
2087
+ | {
2088
+ key: string;
2089
+ record: SlackConversation;
2090
+ }
2091
+ | undefined
2092
+ > {
2093
+ const document = await this.store.load();
2094
+ return Object.entries(document.conversations)
2095
+ .map(([key, record]) => ({ key, record }))
2096
+ .filter(
2097
+ entry =>
2098
+ entry.record.sessionId === sessionId &&
2099
+ (includeInactive ||
2100
+ entry.record.state === "active" ||
2101
+ entry.record.state === "posting_root" ||
2102
+ entry.record.state === "error"),
2103
+ )
2104
+ .sort(
2105
+ (left, right) =>
2106
+ (right.record.endpointGeneration ?? -1) - (left.record.endpointGeneration ?? -1) ||
2107
+ right.record.generation - left.record.generation ||
2108
+ right.record.updatedAt - left.record.updatedAt,
2109
+ )[0];
2110
+ }
2111
+ #intentKey(sessionId: string): string {
2112
+ return slackConversationKey({
2113
+ teamId: this.options.teamId,
2114
+ channelId: this.options.channelId,
2115
+ rootTs: `intent:${sessionId}`,
2116
+ });
2117
+ }
2118
+ #requireEndpointGeneration(record: SlackConversation): number {
2119
+ const generation = record.endpointGeneration;
2120
+ if (typeof generation !== "number" || !Number.isSafeInteger(generation) || generation <= 0)
2121
+ throw new SlackEndpointBindingError("Slack conversation has no current endpoint generation.");
2122
+ return generation;
2123
+ }
2124
+ #leaseExpired(expiresAt: number | undefined, now: number): boolean {
2125
+ return expiresAt === undefined || expiresAt <= now;
2126
+ }
2127
+
2128
+ #isUncertainPostFailure(error: unknown): boolean {
2129
+ return (
2130
+ error instanceof SlackProviderError &&
2131
+ error.operation === "chat.postMessage" &&
2132
+ (error.code === "connection" || error.mayHaveBeenAccepted)
2133
+ );
2134
+ }
2135
+ #isDefiniteSdkPreSendFailure(error: unknown): boolean {
2136
+ if (error instanceof SlackEndpointBindingError) return true;
2137
+ if (error instanceof SdkClientError) return error.code === "connection_closed";
2138
+ return (
2139
+ error instanceof Error &&
2140
+ error.name === "ChatDeliveryError" &&
2141
+ (error as ChatDeliveryError).phase === "pre_send"
2142
+ );
2143
+ }
2144
+ }