@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.
- package/CHANGELOG.md +52 -0
- package/package.json +127 -110
- package/scripts/build-sdk-package-smoke.ts +132 -0
- package/scripts/capture-notifications-settings-showcase.ts +435 -0
- package/scripts/compile-args.ts +5 -2
- package/scripts/g005-daemon-smoke.ts +4 -5
- package/scripts/g011-daemon-path-smoke.ts +5 -5
- package/scripts/generate-hotkeys-docs.ts +74 -0
- package/scripts/generate-sdk-adapter-parity-manifest.ts +163 -0
- package/scripts/generate-sdk-operation-inventory.ts +914 -0
- package/scripts/generate-telegram-baseline-manifest.ts +128 -0
- package/scripts/manifest-schema.ts +124 -0
- package/scripts/run-test-manifest.ts +153 -0
- package/scripts/run-threat-model-check.ts +217 -0
- package/scripts/verify-skc-sdk-canonicalization.ts +3647 -0
- package/scripts/verify-skc-sdk-rename.ts +90 -0
- package/src/append-only-mode.ts +1 -1
- package/src/async/job-manager.ts +455 -69
- package/src/cli/args.ts +43 -12
- package/src/cli/auth-gateway-cli.ts +2 -2
- package/src/cli/config-cli.ts +77 -3
- package/src/cli/daemon-cli.ts +63 -14
- package/src/cli/launch-disposition.ts +42 -0
- package/src/cli/list-models.ts +1 -1
- package/src/cli/notify-cli.ts +373 -283
- package/src/cli/session-picker.ts +20 -3
- package/src/cli/setup-cli.ts +1 -1
- package/src/cli/worktree-cli.ts +9 -287
- package/src/cli.ts +31 -11
- package/src/commands/config.ts +1 -1
- package/src/commands/daemon.ts +50 -6
- package/src/commands/gc.ts +11 -1
- package/src/commands/harness.ts +127 -142
- package/src/commands/launch.ts +11 -6
- package/src/commands/mcp-serve.ts +97 -13
- package/src/commands/mcp.ts +2 -2
- package/src/commands/notify.ts +44 -7
- package/src/commands/sdk.ts +453 -0
- package/src/commands/ultragoal.ts +4 -1
- package/src/commands/worktree.ts +10 -53
- package/src/commit/agentic/agent.ts +1 -0
- package/src/config/atomic-yaml-patch.ts +490 -0
- package/src/config/file-lock.ts +105 -43
- package/src/config/keybindings.ts +64 -20
- package/src/config/model-auth.ts +9 -0
- package/src/config/model-bindings-applier.ts +139 -0
- package/src/config/model-discovery-manager.ts +224 -0
- package/src/config/model-equivalence.ts +66 -0
- package/src/config/model-profile-activation.ts +233 -86
- package/src/config/model-profiles.ts +52 -49
- package/src/config/model-registry.ts +5 -4
- package/src/config/model-resolver.ts +487 -410
- package/src/config/model-selector-value.ts +50 -0
- package/src/config/models-config-schema.ts +17 -23
- package/src/config/settings-schema.ts +372 -21
- package/src/config/settings.ts +1120 -182
- package/src/coordinator-mcp/model-preset.ts +74 -20
- package/src/coordinator-mcp/policy.ts +76 -11
- package/src/coordinator-mcp/question-gate-codec.ts +274 -0
- package/src/coordinator-mcp/question-state.ts +778 -0
- package/src/coordinator-mcp/server.ts +3120 -3111
- package/src/daemon/builtin.ts +8 -5
- package/src/daemon/control-types.ts +1 -1
- package/src/daemon/runtime.ts +2 -2
- package/src/debug/index.ts +1 -1
- package/src/defaults/skc/skills/team/SKILL.md +27 -13
- package/src/defaults/skc/skills/ultragoal/SKILL.md +0 -2
- package/src/discovery/helpers.ts +1 -50
- package/src/discovery/mcp-json.ts +327 -20
- package/src/edit/index.ts +64 -0
- package/src/eval/js/shared/runtime.ts +1 -1
- package/src/eval/py/env.ts +26 -0
- package/src/eval/py/index.ts +2 -2
- package/src/eval/py/kernel.ts +5 -3
- package/src/export/html/template.generated.ts +1 -1
- package/src/export/html/template.js +52 -18
- package/src/extensibility/custom-tools/types.ts +1 -1
- package/src/extensibility/extensions/compact-handler.ts +3 -3
- package/src/extensibility/extensions/get-commands-handler.ts +2 -2
- package/src/extensibility/extensions/loader.ts +77 -5
- package/src/extensibility/extensions/runner.ts +124 -7
- package/src/extensibility/extensions/types.ts +215 -18
- package/src/extensibility/hooks/runner.ts +2 -2
- package/src/extensibility/hooks/types.ts +1 -1
- package/src/extensibility/plugins/marketplace/manager.ts +94 -10
- package/src/extensibility/runtime-skill-discovery.ts +33 -13
- package/src/extensibility/shared-events.ts +2 -0
- package/src/extensibility/skc-plugins/installer.ts +16 -16
- package/src/extensibility/slash-commands.ts +3 -3
- package/src/goals/continuation-timeout-guard.ts +79 -0
- package/src/goals/runtime.ts +7 -5
- package/src/goals/state.ts +18 -0
- package/src/harness-control-plane/lifecycle-reconciliation.ts +64 -0
- package/src/harness-control-plane/operate.ts +9 -9
- package/src/harness-control-plane/owner.ts +341 -41
- package/src/harness-control-plane/phase-rollup.ts +4 -7
- package/src/harness-control-plane/receipt-ingest.ts +5 -0
- package/src/harness-control-plane/receipt-spool.ts +51 -7
- package/src/harness-control-plane/receipts.ts +0 -1
- package/src/harness-control-plane/sdk-transport.ts +395 -0
- package/src/harness-control-plane/session-lease.ts +12 -130
- package/src/harness-control-plane/session-transport.ts +94 -0
- package/src/harness-control-plane/types.ts +1 -1
- package/src/hindsight/backend.ts +26 -27
- package/src/hindsight/client.ts +65 -2
- package/src/hindsight/state.ts +101 -32
- package/src/hooks/skill-state.ts +17 -11
- package/src/i18n/messages/en.ts +1 -0
- package/src/internal-urls/agent-protocol.ts +76 -5
- package/src/internal-urls/docs-index.generated.ts +44 -37
- package/src/internal-urls/local-protocol.ts +420 -18
- package/src/lsp/client.ts +43 -7
- package/src/lsp/config.ts +145 -26
- package/src/lsp/index.ts +7 -91
- package/src/lsp/lspmux.ts +39 -10
- package/src/lsp/path-trust.ts +81 -0
- package/src/main.ts +451 -236
- package/src/memories/index.ts +1 -0
- package/src/memories/storage.ts +6 -2
- package/src/modes/DESIGN.md +258 -0
- package/src/modes/acp/acp-agent.ts +1236 -2612
- package/src/modes/acp/acp-client-bridge.ts +2 -20
- package/src/modes/acp/acp-event-mapper.ts +18 -2
- package/src/modes/acp/acp-mode.ts +8 -36
- package/src/modes/acp/permission-mode.ts +25 -0
- package/src/modes/acp/startup-options.ts +6 -0
- package/src/modes/action-registry.ts +165 -0
- package/src/modes/bridge/bridge-mode.ts +6 -4
- package/src/modes/components/agent-dashboard.ts +37 -17
- package/src/modes/components/ansi-display-validator.ts +54 -0
- package/src/modes/components/chrome.ts +40 -0
- package/src/modes/components/command-palette.ts +168 -0
- package/src/modes/components/custom-editor.ts +105 -33
- package/src/modes/components/custom-provider-wizard.ts +77 -15
- package/src/modes/components/index.ts +2 -1
- package/src/modes/components/model-selector.ts +93 -35
- package/src/modes/components/notifications-settings-editor.ts +1403 -0
- package/src/modes/components/pet-capability.ts +115 -0
- package/src/modes/components/pet-selector.ts +15 -23
- package/src/modes/components/plan-preview-overlay.ts +295 -0
- package/src/modes/components/queue-mode-selector.ts +10 -27
- package/src/modes/components/queue-pane.ts +79 -0
- package/src/modes/components/read-tool-group.ts +13 -0
- package/src/modes/components/sayknow-pet-widget.ts +169 -20
- package/src/modes/components/session-observer-overlay.ts +213 -775
- package/src/modes/components/sessions-dashboard.ts +181 -0
- package/src/modes/components/settings-selector.ts +89 -12
- package/src/modes/components/show-images-selector.ts +10 -24
- package/src/modes/components/status-line/types.ts +1 -1
- package/src/modes/components/status-line.ts +1 -969
- package/src/modes/components/tasks-pane.ts +73 -0
- package/src/modes/components/theme-selector.ts +11 -31
- package/src/modes/components/tool-execution.ts +22 -0
- package/src/modes/components/tool-status-header.ts +1056 -0
- package/src/modes/components/tool-transcript-format.ts +393 -0
- package/src/modes/components/transcript-viewer-overlay.ts +446 -0
- package/src/modes/components/welcome.ts +4 -4
- package/src/modes/controllers/btw-controller.ts +1 -0
- package/src/modes/controllers/command-controller.ts +25 -17
- package/src/modes/controllers/event-controller.ts +14 -18
- package/src/modes/controllers/extension-ui-controller.ts +441 -37
- package/src/modes/controllers/goal-mode-controller.ts +493 -0
- package/src/modes/controllers/input-controller.ts +889 -263
- package/src/modes/controllers/mode-gate.ts +24 -0
- package/src/modes/controllers/plan-mode-controller.ts +519 -0
- package/src/modes/controllers/runtime-mcp-command-controller.ts +3 -0
- package/src/modes/controllers/selector-controller.ts +957 -54
- package/src/modes/controllers/stt-controller.ts +125 -0
- package/src/modes/index.ts +0 -22
- package/src/modes/interactive-mode.ts +376 -1130
- package/src/modes/jobs-observer.ts +3 -0
- package/src/modes/prompt-action-autocomplete.ts +7 -0
- package/src/modes/rpc/rpc-mode.ts +3 -1
- package/src/modes/runtime-init.ts +320 -6
- package/src/modes/shared/agent-wire/approval-gate.ts +9 -11
- package/src/modes/shared/agent-wire/command-dispatch.ts +3 -1
- package/src/modes/shared/agent-wire/deep-interview-gate.ts +65 -111
- package/src/modes/shared/agent-wire/event-contract.ts +7 -8
- package/src/modes/shared/agent-wire/event-envelope.ts +9 -17
- package/src/modes/shared/agent-wire/event-observation.ts +16 -7
- package/src/modes/shared/agent-wire/workflow-gate-broker.ts +1331 -89
- package/src/modes/shared/agent-wire/workflow-gate-schema.ts +19 -17
- package/src/modes/shared/agent-wire/workflow-gate-types.ts +407 -0
- package/src/modes/tasks-aggregator.ts +199 -0
- package/src/modes/transcript-item-registry.ts +229 -0
- package/src/modes/types.ts +63 -21
- package/src/modes/utils/ui-helpers.ts +17 -9
- package/src/notifications/index.ts +8 -2
- package/src/plan-mode/approved-plan.ts +3 -1
- package/src/prompts/agent-fragments/ralplan-persistence.md +6 -0
- package/src/prompts/agent-fragments/restricted-bash.md +1 -0
- package/src/prompts/agents/architect.md +3 -8
- package/src/prompts/agents/critic.md +3 -8
- package/src/prompts/agents/executor.md +3 -0
- package/src/prompts/agents/planner.md +4 -12
- package/src/prompts/system/custom-system-prompt.md +2 -24
- package/src/prompts/system/plan-mode-approved.md +8 -0
- package/src/prompts/system/system-prompt.md +18 -94
- package/src/prompts/tools/bash.md +4 -4
- package/src/prompts/tools/browser.md +15 -52
- package/src/prompts/tools/find.md +2 -2
- package/src/prompts/tools/hashline.md +13 -55
- package/src/prompts/tools/lsp.md +3 -3
- package/src/prompts/tools/read.md +3 -6
- package/src/prompts/tools/search-tool-bm25.md +0 -2
- package/src/prompts/tools/search.md +2 -4
- package/src/prompts/tools/skill-discovery.md +1 -2
- package/src/prompts/tools/task.md +1 -1
- package/src/runtime-mcp/client.ts +94 -19
- package/src/runtime-mcp/config.ts +27 -15
- package/src/runtime-mcp/discoverable-tool-metadata.ts +16 -13
- package/src/runtime-mcp/manager.ts +359 -106
- package/src/runtime-mcp/oauth-discovery.ts +116 -26
- package/src/runtime-mcp/oauth-flow.ts +42 -12
- package/src/runtime-mcp/transports/http.ts +49 -19
- package/src/runtime-mcp/transports/stdio.ts +47 -28
- package/src/runtime-mcp/types.ts +10 -0
- package/src/sdk/acp/adapter.ts +418 -0
- package/src/sdk/acp/index.ts +2 -0
- package/src/sdk/broker/broker.ts +877 -0
- package/src/sdk/broker/discovery.ts +238 -0
- package/src/sdk/broker/ensure.ts +393 -0
- package/src/sdk/broker/identity.ts +42 -0
- package/src/sdk/broker/index.ts +8 -0
- package/src/sdk/broker/internal-source-marker-2178.txt +1 -0
- package/src/sdk/broker/internal-source.bunfig.toml +1 -0
- package/src/sdk/broker/internal.ts +10 -0
- package/src/sdk/broker/lifecycle-codec.ts +11 -0
- package/src/sdk/broker/lifecycle-ledger.ts +583 -0
- package/src/sdk/broker/lifecycle.ts +3413 -0
- package/src/sdk/broker/process-incarnation.ts +151 -0
- package/src/sdk/broker/runtime.ts +164 -0
- package/src/sdk/broker/session-index.ts +678 -0
- package/src/sdk/broker/state-version.ts +47 -0
- package/src/sdk/broker/transport.ts +125 -0
- package/src/sdk/bus/attachment-registry.ts +23 -0
- package/src/sdk/bus/chat-adapters.ts +147 -0
- package/src/sdk/bus/chat-command-policy.ts +107 -0
- package/src/sdk/bus/chat-daemon-cli.ts +278 -0
- package/src/sdk/bus/chat-daemon-control.ts +1101 -0
- package/src/sdk/bus/chat-daemon-runtime.ts +527 -0
- package/src/sdk/bus/chat-effect-journal.ts +363 -0
- package/src/sdk/bus/config-commands.ts +192 -0
- package/src/sdk/bus/config.ts +568 -0
- package/src/sdk/bus/conversation-store.ts +367 -0
- package/src/sdk/bus/daemon-paths.ts +34 -0
- package/src/sdk/bus/discord-conversation.ts +85 -0
- package/src/sdk/bus/discord-daemon.ts +2292 -0
- package/src/sdk/bus/discord-live-provider.ts +521 -0
- package/src/sdk/bus/discord-provider.ts +56 -0
- package/src/sdk/bus/engine.ts +100 -0
- package/src/sdk/bus/helpers.ts +135 -0
- package/src/sdk/bus/html-format.ts +518 -0
- package/src/sdk/bus/index.ts +4961 -0
- package/src/sdk/bus/lifecycle-commands.ts +291 -0
- package/src/sdk/bus/lifecycle-control-runtime.ts +1409 -0
- package/src/sdk/bus/lifecycle-orchestrator.ts +458 -0
- package/src/sdk/bus/managed-daemon.ts +163 -0
- package/src/sdk/bus/native-runtime-compatibility.ts +42 -0
- package/src/sdk/bus/natives-augment.d.ts +63 -0
- package/src/sdk/bus/notification-orchestration.ts +535 -0
- package/src/sdk/bus/notification-service.ts +1174 -0
- package/src/sdk/bus/operator-runtime.ts +171 -0
- package/src/sdk/bus/rate-limit-pool.ts +276 -0
- package/src/sdk/bus/recent-activity.ts +279 -0
- package/src/sdk/bus/reply-sent-store.ts +134 -0
- package/src/sdk/bus/rich-document.ts +258 -0
- package/src/sdk/bus/rich-draft.ts +107 -0
- package/src/sdk/bus/rich-render.ts +135 -0
- package/src/sdk/bus/session-control.ts +439 -0
- package/src/sdk/bus/slack-conversation.ts +74 -0
- package/src/sdk/bus/slack-daemon.ts +2144 -0
- package/src/sdk/bus/slack-live-provider.ts +380 -0
- package/src/sdk/bus/slack-provider.ts +76 -0
- package/src/sdk/bus/telegram-cli.ts +194 -0
- package/src/sdk/bus/telegram-daemon-cli.ts +292 -0
- package/src/sdk/bus/telegram-daemon-contract.ts +27 -0
- package/src/sdk/bus/telegram-daemon-control.ts +642 -0
- package/src/sdk/bus/telegram-daemon.ts +6675 -0
- package/src/sdk/bus/telegram-reference.ts +436 -0
- package/src/sdk/bus/telegram-setup.ts +663 -0
- package/src/sdk/bus/threaded-inbound.ts +141 -0
- package/src/sdk/bus/threaded-render.ts +294 -0
- package/src/sdk/bus/topic-registry.ts +364 -0
- package/src/sdk/cli/index.ts +1 -0
- package/src/sdk/cli/session-cli.ts +275 -0
- package/src/sdk/client/client.ts +1 -0
- package/src/sdk/client/discovery.ts +108 -0
- package/src/sdk/client/index.ts +2 -0
- package/src/sdk/host/control/dispatch.ts +388 -0
- package/src/sdk/host/control/index.ts +10 -0
- package/src/sdk/host/control/operations.ts +68 -0
- package/src/sdk/host/events.ts +91 -0
- package/src/sdk/host/host.ts +338 -0
- package/src/sdk/host/index.ts +4 -0
- package/src/sdk/host/query/cursor.ts +189 -0
- package/src/sdk/host/query/handlers.ts +531 -0
- package/src/sdk/host/query/index.ts +3 -0
- package/src/sdk/host/query/revision-store.ts +1149 -0
- package/src/sdk/host/reverse-leases.ts +325 -0
- package/src/sdk/host/types.ts +29 -0
- package/src/sdk/index.ts +14 -0
- package/src/sdk/lifecycle-session.ts +39 -0
- package/src/sdk/mcp/index.ts +1 -0
- package/src/sdk/mcp/server.ts +332 -0
- package/src/sdk/models.ts +168 -0
- package/src/sdk/protocol/adapter-validation.ts +48 -0
- package/src/sdk/protocol/operation-inventory.generated.json +4719 -0
- package/src/sdk/protocol/operation-registry.ts +312 -0
- package/src/sdk/session-directory.ts +141 -0
- package/src/sdk/session.ts +2869 -0
- package/src/sdk/startup-capability.ts +189 -0
- package/src/secrets/index.ts +53 -10
- package/src/secrets/obfuscator.ts +21 -18
- package/src/secrets/regex.ts +2 -0
- package/src/session/agent-session.ts +5602 -2138
- package/src/session/agent-storage.ts +18 -0
- package/src/session/artifacts.ts +188 -23
- package/src/session/cache-economics.ts +25 -8
- package/src/session/context-estimation.ts +7 -2
- package/src/session/default-model-selection.ts +93 -0
- package/src/session/fallback-chain-controller.ts +186 -0
- package/src/session/internal/managed-session-scope.ts +2402 -0
- package/src/session/internal/managed-session-storage.ts +1559 -0
- package/src/session/messages.ts +91 -2
- package/src/session/session-manager-internal.ts +33 -0
- package/src/session/session-manager.ts +2578 -392
- package/src/session/session-storage.ts +550 -40
- package/src/session/streaming-output.ts +6 -0
- package/src/session/volatile-context-pruning.ts +78 -0
- package/src/session/yield-queue.ts +20 -0
- package/src/setup/credential-auto-import.ts +291 -35
- package/src/setup/hermes/templates/operator-instructions.v1.md +4 -6
- package/src/setup/provider-onboarding.ts +36 -61
- package/src/setup/provider-presets.json +5 -0
- package/src/skc-runtime/deep-interview-recorder.ts +70 -3
- package/src/skc-runtime/deep-interview-state.ts +441 -5
- package/src/skc-runtime/gc-render.ts +19 -1
- package/src/skc-runtime/gc-runtime.ts +68 -3
- package/src/skc-runtime/goal-mode-request.ts +55 -8
- package/src/skc-runtime/launch-worktree.ts +5 -5
- package/src/skc-runtime/linux-proc.ts +71 -0
- package/src/skc-runtime/managed-owner-admission.ts +352 -0
- package/src/skc-runtime/managed-owner-supervisor.ts +162 -0
- package/src/skc-runtime/psmux-detect.ts +82 -4
- package/src/skc-runtime/ralplan-runtime.ts +74 -90
- package/src/skc-runtime/session-resolution.ts +18 -3
- package/src/skc-runtime/session-state-sidecar.ts +47 -138
- package/src/skc-runtime/state-argv.ts +292 -0
- package/src/skc-runtime/state-migrations.ts +1 -1
- package/src/skc-runtime/state-runtime.ts +387 -451
- package/src/skc-runtime/state-writer.ts +36 -40
- package/src/skc-runtime/team-launch.ts +319 -0
- package/src/skc-runtime/team-notify.ts +326 -0
- package/src/skc-runtime/team-runtime.ts +8 -2
- package/src/skc-runtime/team-store.ts +828 -0
- package/src/skc-runtime/team-workers.ts +962 -0
- package/src/skc-runtime/tmux-owner-isolation-cli.ts +55 -28
- package/src/skc-runtime/tmux-owner-isolation.ts +136 -11
- package/src/skc-runtime/tmux-sessions.ts +23 -34
- package/src/skc-runtime/ultragoal-change-set.ts +172 -0
- package/src/skc-runtime/ultragoal-evidence.ts +874 -0
- package/src/skc-runtime/ultragoal-guard.ts +136 -18
- package/src/skc-runtime/ultragoal-owner-loss-recovery.ts +328 -0
- package/src/skc-runtime/ultragoal-pipeline.ts +306 -0
- package/src/skc-runtime/ultragoal-receipt-freshness.ts +102 -1
- package/src/skc-runtime/ultragoal-runtime.ts +325 -1322
- package/src/skc-runtime/windows-powershell-command.ts +58 -0
- package/src/skc-runtime/workflow-cli-common.ts +30 -0
- package/src/skc-runtime/workflow-manifest.generated.json +58 -0
- package/src/skc-runtime/workflow-manifest.ts +18 -0
- package/src/skill-state/active-state.ts +3 -13
- package/src/skill-state/workflow-mutation-guard.ts +661 -0
- package/src/skill-state/workflow-state-contract.ts +6 -41
- package/src/slash-commands/builtin-registry.ts +115 -41
- package/src/system-prompt.ts +37 -44
- package/src/task/agents.ts +19 -1
- package/src/task/executor.ts +223 -45
- package/src/task/index.ts +124 -56
- package/src/thinking.ts +21 -6
- package/src/tool-discovery/tool-index.ts +20 -134
- package/src/tools/ask-answer-registry.ts +16 -2
- package/src/tools/ast-edit.ts +1 -1
- package/src/tools/bash-allowed-prefixes.ts +79 -29
- package/src/tools/bash-skill-urls.ts +14 -3
- package/src/tools/bash.ts +40 -2
- package/src/tools/browser/STEALTH-THIRD-PARTY-NOTICES.md +26 -0
- package/src/tools/browser/benchmark/detector-report.ts +157 -0
- package/src/tools/browser/benchmark/run-suite.ts +39 -0
- package/src/tools/browser/dead-tab-recovery.ts +78 -0
- package/src/tools/browser/launch.ts +127 -20
- package/src/tools/browser/profile-discovery.ts +63 -0
- package/src/tools/browser/profile-posture.ts +59 -0
- package/src/tools/browser/profile-reuse.ts +102 -0
- package/src/tools/browser/profile-warmup.ts +109 -0
- package/src/tools/browser/readable.ts +1 -1
- package/src/tools/browser/registry.ts +87 -11
- package/src/tools/browser/screenshot-format.ts +34 -0
- package/src/tools/browser/tab-protocol.ts +4 -0
- package/src/tools/browser/tab-supervisor.ts +392 -142
- package/src/tools/browser/tab-worker-entry.ts +33 -14
- package/src/tools/browser/tab-worker-path-resolver.ts +67 -0
- package/src/tools/browser/tab-worker-smoke.ts +87 -0
- package/src/tools/browser/tab-worker.ts +8 -6
- package/src/tools/browser.ts +6 -0
- package/src/tools/computer.ts +10 -3
- package/src/tools/cron.ts +30 -16
- package/src/tools/fetch.ts +11 -4
- package/src/tools/index.ts +88 -32
- package/src/tools/output-meta.ts +19 -7
- package/src/tools/path-utils.ts +42 -35
- package/src/tools/plan-mode-guard.ts +1 -0
- package/src/tools/puppeteer/14_stealth_permissions.txt +57 -0
- package/src/tools/puppeteer/15_stealth_webrtc.txt +60 -0
- package/src/tools/read.ts +226 -65
- package/src/tools/resource-gc.ts +125 -36
- package/src/tools/search-tool-bm25.ts +11 -74
- package/src/tools/sqlite-reader.ts +3 -2
- package/src/tools/subagent-render.ts +19 -8
- package/src/tools/subagent.ts +129 -34
- package/src/tools/telegram-send.ts +2 -2
- package/src/utils/event-bus.ts +9 -4
- package/src/utils/file-mentions.ts +4 -4
- package/src/utils/image-loading.ts +85 -34
- package/src/utils/image-resize.ts +16 -9
- package/src/utils/pasted-image-loading.ts +514 -0
- package/src/utils/pasted-image-path.ts +223 -98
- package/src/web/scrapers/html-to-markdown.ts +68 -0
- package/src/web/scrapers/readthedocs.ts +1 -1
- package/src/web/scrapers/types.ts +1 -68
- package/src/web/search/index.ts +3 -3
- package/src/web/search/providers/openai-compatible.ts +76 -23
- package/dist/types/append-only-mode.d.ts +0 -31
- package/dist/types/async/index.d.ts +0 -2
- package/dist/types/async/job-manager.d.ts +0 -328
- package/dist/types/async/support.d.ts +0 -2
- package/dist/types/autoresearch/dashboard.d.ts +0 -4
- package/dist/types/autoresearch/git.d.ts +0 -36
- package/dist/types/autoresearch/helpers.d.ts +0 -24
- package/dist/types/autoresearch/index.d.ts +0 -2
- package/dist/types/autoresearch/state.d.ts +0 -17
- package/dist/types/autoresearch/storage.d.ts +0 -142
- package/dist/types/autoresearch/tools/init-experiment.d.ts +0 -31
- package/dist/types/autoresearch/tools/log-experiment.d.ts +0 -23
- package/dist/types/autoresearch/tools/run-experiment.d.ts +0 -8
- package/dist/types/autoresearch/tools/update-notes.d.ts +0 -12
- package/dist/types/autoresearch/types.d.ts +0 -154
- package/dist/types/build-metadata.d.ts +0 -7
- package/dist/types/capability/context-file.d.ts +0 -17
- package/dist/types/capability/extension-module.d.ts +0 -15
- package/dist/types/capability/extension.d.ts +0 -28
- package/dist/types/capability/fs.d.ts +0 -20
- package/dist/types/capability/hook.d.ts +0 -19
- package/dist/types/capability/index.d.ts +0 -80
- package/dist/types/capability/instruction.d.ts +0 -17
- package/dist/types/capability/mcp.d.ts +0 -49
- package/dist/types/capability/prompt.d.ts +0 -15
- package/dist/types/capability/rule.d.ts +0 -69
- package/dist/types/capability/settings.d.ts +0 -15
- package/dist/types/capability/skill.d.ts +0 -36
- package/dist/types/capability/slash-command.d.ts +0 -17
- package/dist/types/capability/ssh.d.ts +0 -23
- package/dist/types/capability/system-prompt.d.ts +0 -15
- package/dist/types/capability/tool.d.ts +0 -19
- package/dist/types/capability/types.d.ts +0 -154
- package/dist/types/cli/agents-cli.d.ts +0 -12
- package/dist/types/cli/args.d.ts +0 -57
- package/dist/types/cli/auth-broker-cli.d.ts +0 -25
- package/dist/types/cli/auth-gateway-cli.d.ts +0 -18
- package/dist/types/cli/classify-install-target.d.ts +0 -8
- package/dist/types/cli/commands/init-xdg.d.ts +0 -1
- package/dist/types/cli/completion-cli.d.ts +0 -41
- package/dist/types/cli/config-cli.d.ts +0 -23
- package/dist/types/cli/daemon-cli.d.ts +0 -27
- package/dist/types/cli/fast-help.d.ts +0 -1
- package/dist/types/cli/file-processor.d.ts +0 -11
- package/dist/types/cli/fixture-report.d.ts +0 -20
- package/dist/types/cli/fixture-report.test.d.ts +0 -1
- package/dist/types/cli/grep-cli.d.ts +0 -17
- package/dist/types/cli/initial-message.d.ts +0 -17
- package/dist/types/cli/list-models.d.ts +0 -36
- package/dist/types/cli/local-provider-smoke.d.ts +0 -59
- package/dist/types/cli/malloc-env-guard.d.ts +0 -65
- package/dist/types/cli/malloc-env-guard.test.d.ts +0 -1
- package/dist/types/cli/mcp-cli.d.ts +0 -25
- package/dist/types/cli/migrate-cli.d.ts +0 -20
- package/dist/types/cli/nofile-limit.d.ts +0 -11
- package/dist/types/cli/notify-cli.d.ts +0 -39
- package/dist/types/cli/plugin-cli.d.ts +0 -34
- package/dist/types/cli/read-cli.d.ts +0 -4
- package/dist/types/cli/session-picker.d.ts +0 -4
- package/dist/types/cli/setup-cli.d.ts +0 -73
- package/dist/types/cli/shell-cli.d.ts +0 -8
- package/dist/types/cli/skills-cli.d.ts +0 -9
- package/dist/types/cli/ssh-cli.d.ts +0 -21
- package/dist/types/cli/stats-cli.d.ts +0 -17
- package/dist/types/cli/telegram-cli.d.ts +0 -13
- package/dist/types/cli/update-cli.d.ts +0 -108
- package/dist/types/cli/web-search-cli.d.ts +0 -32
- package/dist/types/cli/worktree-cli.d.ts +0 -26
- package/dist/types/cli.d.ts +0 -140
- package/dist/types/commands/acp.d.ts +0 -12
- package/dist/types/commands/agents.d.ts +0 -34
- package/dist/types/commands/auth-broker.d.ts +0 -54
- package/dist/types/commands/auth-gateway.d.ts +0 -32
- package/dist/types/commands/codex-native-hook.d.ts +0 -6
- package/dist/types/commands/commit.d.ts +0 -27
- package/dist/types/commands/completion.d.ts +0 -29
- package/dist/types/commands/config.d.ts +0 -33
- package/dist/types/commands/contribution-prep.d.ts +0 -18
- package/dist/types/commands/coordinator.d.ts +0 -19
- package/dist/types/commands/daemon.d.ts +0 -45
- package/dist/types/commands/deep-interview.d.ts +0 -54
- package/dist/types/commands/gc.d.ts +0 -26
- package/dist/types/commands/grep.d.ts +0 -42
- package/dist/types/commands/harness.d.ts +0 -43
- package/dist/types/commands/launch.d.ts +0 -131
- package/dist/types/commands/local-provider.d.ts +0 -34
- package/dist/types/commands/mcp-serve.d.ts +0 -24
- package/dist/types/commands/mcp.d.ts +0 -70
- package/dist/types/commands/migrate.d.ts +0 -33
- package/dist/types/commands/notify.d.ts +0 -47
- package/dist/types/commands/plugin.d.ts +0 -58
- package/dist/types/commands/ralplan.d.ts +0 -7
- package/dist/types/commands/read.d.ts +0 -15
- package/dist/types/commands/rlm.d.ts +0 -10
- package/dist/types/commands/session.d.ts +0 -30
- package/dist/types/commands/setup.d.ts +0 -105
- package/dist/types/commands/shell.d.ts +0 -21
- package/dist/types/commands/skills.d.ts +0 -26
- package/dist/types/commands/ssh.d.ts +0 -48
- package/dist/types/commands/state.d.ts +0 -7
- package/dist/types/commands/stats.d.ts +0 -25
- package/dist/types/commands/team.d.ts +0 -24
- package/dist/types/commands/telegram.d.ts +0 -22
- package/dist/types/commands/ultragoal.d.ts +0 -8
- package/dist/types/commands/update.d.ts +0 -20
- package/dist/types/commands/web-search.d.ts +0 -87
- package/dist/types/commands/worktree.d.ts +0 -34
- package/dist/types/commit/agentic/agent.d.ts +0 -31
- package/dist/types/commit/agentic/fallback.d.ts +0 -5
- package/dist/types/commit/agentic/index.d.ts +0 -2
- package/dist/types/commit/agentic/state.d.ts +0 -58
- package/dist/types/commit/agentic/tools/analyze-file.d.ts +0 -19
- package/dist/types/commit/agentic/tools/git-file-diff.d.ts +0 -10
- package/dist/types/commit/agentic/tools/git-hunk.d.ts +0 -9
- package/dist/types/commit/agentic/tools/git-overview.d.ts +0 -9
- package/dist/types/commit/agentic/tools/index.d.ts +0 -16
- package/dist/types/commit/agentic/tools/propose-changelog.d.ts +0 -28
- package/dist/types/commit/agentic/tools/propose-commit.d.ts +0 -36
- package/dist/types/commit/agentic/tools/recent-commits.d.ts +0 -7
- package/dist/types/commit/agentic/tools/schemas.d.ts +0 -27
- package/dist/types/commit/agentic/tools/split-commit.d.ts +0 -53
- package/dist/types/commit/agentic/topo-sort.d.ts +0 -4
- package/dist/types/commit/agentic/trivial.d.ts +0 -7
- package/dist/types/commit/agentic/validation.d.ts +0 -20
- package/dist/types/commit/analysis/conventional.d.ts +0 -22
- package/dist/types/commit/analysis/index.d.ts +0 -4
- package/dist/types/commit/analysis/scope.d.ts +0 -6
- package/dist/types/commit/analysis/summary.d.ts +0 -19
- package/dist/types/commit/analysis/validation.d.ts +0 -8
- package/dist/types/commit/changelog/detect.d.ts +0 -2
- package/dist/types/commit/changelog/generate.d.ts +0 -30
- package/dist/types/commit/changelog/index.d.ts +0 -30
- package/dist/types/commit/changelog/parse.d.ts +0 -2
- package/dist/types/commit/cli.d.ts +0 -3
- package/dist/types/commit/git/diff.d.ts +0 -5
- package/dist/types/commit/index.d.ts +0 -4
- package/dist/types/commit/map-reduce/index.d.ts +0 -28
- package/dist/types/commit/map-reduce/map-phase.d.ts +0 -17
- package/dist/types/commit/map-reduce/reduce-phase.d.ts +0 -13
- package/dist/types/commit/map-reduce/utils.d.ts +0 -2
- package/dist/types/commit/message.d.ts +0 -2
- package/dist/types/commit/model-selection.d.ts +0 -15
- package/dist/types/commit/pipeline.d.ts +0 -5
- package/dist/types/commit/shared-llm.d.ts +0 -54
- package/dist/types/commit/types.d.ts +0 -78
- package/dist/types/commit/utils/exclusions.d.ts +0 -4
- package/dist/types/commit/utils.d.ts +0 -20
- package/dist/types/config/config-file.d.ts +0 -58
- package/dist/types/config/file-lock-gc.d.ts +0 -5
- package/dist/types/config/file-lock.d.ts +0 -36
- package/dist/types/config/keybindings.d.ts +0 -364
- package/dist/types/config/model-equivalence.d.ts +0 -24
- package/dist/types/config/model-profile-activation.d.ts +0 -65
- package/dist/types/config/model-profiles.d.ts +0 -39
- package/dist/types/config/model-registry.d.ts +0 -473
- package/dist/types/config/model-resolver.d.ts +0 -217
- package/dist/types/config/models-config-schema.d.ts +0 -700
- package/dist/types/config/prompt-templates.d.ts +0 -32
- package/dist/types/config/resolve-config-value.d.ts +0 -17
- package/dist/types/config/settings-schema.d.ts +0 -4223
- package/dist/types/config/settings.d.ts +0 -158
- package/dist/types/config/skill-settings-defaults.d.ts +0 -14
- package/dist/types/config/telegram-autostart.d.ts +0 -14
- package/dist/types/config/telegram-env-bridge.d.ts +0 -18
- package/dist/types/config.d.ts +0 -66
- package/dist/types/coordinator/contract.d.ts +0 -4
- package/dist/types/coordinator-mcp/model-preset.d.ts +0 -45
- package/dist/types/coordinator-mcp/policy.d.ts +0 -27
- package/dist/types/coordinator-mcp/safety.d.ts +0 -26
- package/dist/types/coordinator-mcp/server.d.ts +0 -139
- package/dist/types/coordinator-mcp/session-reaper.d.ts +0 -53
- package/dist/types/cursor.d.ts +0 -24
- package/dist/types/daemon/builtin.d.ts +0 -20
- package/dist/types/daemon/control-types.d.ts +0 -67
- package/dist/types/daemon/operator-contract.d.ts +0 -47
- package/dist/types/daemon/runtime.d.ts +0 -25
- package/dist/types/dap/client.d.ts +0 -39
- package/dist/types/dap/config.d.ts +0 -6
- package/dist/types/dap/index.d.ts +0 -4
- package/dist/types/dap/session.d.ts +0 -108
- package/dist/types/dap/types.d.ts +0 -524
- package/dist/types/debug/crash-diagnostics.d.ts +0 -45
- package/dist/types/debug/index.d.ts +0 -15
- package/dist/types/debug/log-formatting.d.ts +0 -4
- package/dist/types/debug/log-viewer.d.ts +0 -68
- package/dist/types/debug/profiler.d.ts +0 -24
- package/dist/types/debug/raw-sse-buffer.d.ts +0 -44
- package/dist/types/debug/raw-sse.d.ts +0 -16
- package/dist/types/debug/report-bundle.d.ts +0 -55
- package/dist/types/debug/runtime-gauges.d.ts +0 -6
- package/dist/types/debug/system-info.d.ts +0 -26
- package/dist/types/deep-interview/plaintext-gate-guard.d.ts +0 -11
- package/dist/types/deep-interview/render-middleware.d.ts +0 -6
- package/dist/types/defaults/skc/extensions/grok-build/index.d.ts +0 -1
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/index.d.ts +0 -1
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/models/catalog.d.ts +0 -29
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/payload/sanitize.d.ts +0 -27
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/billing.d.ts +0 -8
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/register.d.ts +0 -5
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/stream.d.ts +0 -10
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/usage.d.ts +0 -2
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/shared/base-url.d.ts +0 -2
- package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/shared/errors.d.ts +0 -38
- package/dist/types/defaults/skc-defaults.d.ts +0 -64
- package/dist/types/defaults/skc-grok-cli.d.ts +0 -5
- package/dist/types/discovery/agents-md.d.ts +0 -1
- package/dist/types/discovery/agents.d.ts +0 -12
- package/dist/types/discovery/builtin.d.ts +0 -1
- package/dist/types/discovery/claude-plugins.d.ts +0 -1
- package/dist/types/discovery/claude.d.ts +0 -1
- package/dist/types/discovery/cline.d.ts +0 -1
- package/dist/types/discovery/codex.d.ts +0 -1
- package/dist/types/discovery/cursor.d.ts +0 -19
- package/dist/types/discovery/gemini.d.ts +0 -1
- package/dist/types/discovery/github.d.ts +0 -1
- package/dist/types/discovery/helpers.d.ts +0 -271
- package/dist/types/discovery/index.d.ts +0 -48
- package/dist/types/discovery/mcp-json.d.ts +0 -1
- package/dist/types/discovery/opencode.d.ts +0 -1
- package/dist/types/discovery/plugin-dir-roots.d.ts +0 -15
- package/dist/types/discovery/ssh.d.ts +0 -1
- package/dist/types/discovery/substitute-plugin-root.d.ts +0 -1
- package/dist/types/discovery/vscode.d.ts +0 -1
- package/dist/types/discovery/windsurf.d.ts +0 -15
- package/dist/types/edit/apply-patch/index.d.ts +0 -35
- package/dist/types/edit/apply-patch/parser.d.ts +0 -34
- package/dist/types/edit/diff.d.ts +0 -75
- package/dist/types/edit/file-read-cache.d.ts +0 -25
- package/dist/types/edit/index.d.ts +0 -58
- package/dist/types/edit/modes/apply-patch.d.ts +0 -24
- package/dist/types/edit/modes/patch.d.ts +0 -99
- package/dist/types/edit/modes/replace.d.ts +0 -149
- package/dist/types/edit/normalize.d.ts +0 -43
- package/dist/types/edit/notebook.d.ts +0 -26
- package/dist/types/edit/read-file.d.ts +0 -8
- package/dist/types/edit/renderer.d.ts +0 -110
- package/dist/types/edit/streaming.d.ts +0 -66
- package/dist/types/eval/backend.d.ts +0 -40
- package/dist/types/eval/index.d.ts +0 -4
- package/dist/types/eval/js/context-manager.d.ts +0 -27
- package/dist/types/eval/js/executor.d.ts +0 -29
- package/dist/types/eval/js/index.d.ts +0 -10
- package/dist/types/eval/js/shared/helpers.d.ts +0 -38
- package/dist/types/eval/js/shared/indirect-eval.d.ts +0 -14
- package/dist/types/eval/js/shared/prelude.d.ts +0 -1
- package/dist/types/eval/js/shared/rewrite-imports.d.ts +0 -6
- package/dist/types/eval/js/shared/runtime.d.ts +0 -47
- package/dist/types/eval/js/shared/types.d.ts +0 -24
- package/dist/types/eval/js/tool-bridge.d.ts +0 -18
- package/dist/types/eval/js/worker-core.d.ts +0 -5
- package/dist/types/eval/js/worker-entry.d.ts +0 -1
- package/dist/types/eval/js/worker-protocol.d.ts +0 -77
- package/dist/types/eval/py/display.d.ts +0 -25
- package/dist/types/eval/py/executor.d.ts +0 -88
- package/dist/types/eval/py/index.d.ts +0 -10
- package/dist/types/eval/py/kernel.d.ts +0 -65
- package/dist/types/eval/py/prelude.d.ts +0 -1
- package/dist/types/eval/py/runtime.d.ts +0 -29
- package/dist/types/eval/py/tool-bridge.d.ts +0 -20
- package/dist/types/eval/types.d.ts +0 -52
- package/dist/types/exa/factory.d.ts +0 -13
- package/dist/types/exa/index.d.ts +0 -20
- package/dist/types/exa/mcp-client.d.ts +0 -45
- package/dist/types/exa/render.d.ts +0 -19
- package/dist/types/exa/researcher.d.ts +0 -9
- package/dist/types/exa/search.d.ts +0 -9
- package/dist/types/exa/types.d.ts +0 -155
- package/dist/types/exa/websets.d.ts +0 -9
- package/dist/types/exec/bash-executor.d.ts +0 -64
- package/dist/types/exec/exec.d.ts +0 -25
- package/dist/types/exec/idle-timeout-watchdog.d.ts +0 -18
- package/dist/types/exec/non-interactive-env.d.ts +0 -1
- package/dist/types/export/custom-share.d.ts +0 -20
- package/dist/types/export/html/index.d.ts +0 -10
- package/dist/types/export/html/template.generated.d.ts +0 -1
- package/dist/types/export/html/template.macro.d.ts +0 -5
- package/dist/types/export/ttsr.d.ts +0 -55
- package/dist/types/extensibility/custom-commands/bundled/ci-green/index.d.ts +0 -9
- package/dist/types/extensibility/custom-commands/index.d.ts +0 -2
- package/dist/types/extensibility/custom-commands/loader.d.ts +0 -29
- package/dist/types/extensibility/custom-commands/types.d.ts +0 -106
- package/dist/types/extensibility/custom-tools/index.d.ts +0 -6
- package/dist/types/extensibility/custom-tools/loader.d.ts +0 -69
- package/dist/types/extensibility/custom-tools/types.d.ts +0 -229
- package/dist/types/extensibility/custom-tools/wrapper.d.ts +0 -24
- package/dist/types/extensibility/extensions/compact-handler.d.ts +0 -26
- package/dist/types/extensibility/extensions/get-commands-handler.d.ts +0 -29
- package/dist/types/extensibility/extensions/index.d.ts +0 -9
- package/dist/types/extensibility/extensions/loader.d.ts +0 -43
- package/dist/types/extensibility/extensions/prefix-command-bridge.d.ts +0 -35
- package/dist/types/extensibility/extensions/runner.d.ts +0 -135
- package/dist/types/extensibility/extensions/types.d.ts +0 -920
- package/dist/types/extensibility/extensions/wrapper.d.ts +0 -55
- package/dist/types/extensibility/hooks/index.d.ts +0 -5
- package/dist/types/extensibility/hooks/loader.d.ts +0 -89
- package/dist/types/extensibility/hooks/runner.d.ts +0 -126
- package/dist/types/extensibility/hooks/tool-wrapper.d.ts +0 -25
- package/dist/types/extensibility/hooks/types.d.ts +0 -431
- package/dist/types/extensibility/plugins/doctor.d.ts +0 -3
- package/dist/types/extensibility/plugins/git-url.d.ts +0 -34
- package/dist/types/extensibility/plugins/index.d.ts +0 -8
- package/dist/types/extensibility/plugins/installer.d.ts +0 -5
- package/dist/types/extensibility/plugins/legacy-pi-compat.d.ts +0 -2
- package/dist/types/extensibility/plugins/loader.d.ts +0 -31
- package/dist/types/extensibility/plugins/manager.d.ts +0 -65
- package/dist/types/extensibility/plugins/marketplace/cache.d.ts +0 -41
- package/dist/types/extensibility/plugins/marketplace/fetcher.d.ts +0 -48
- package/dist/types/extensibility/plugins/marketplace/index.d.ts +0 -6
- package/dist/types/extensibility/plugins/marketplace/manager.d.ts +0 -57
- package/dist/types/extensibility/plugins/marketplace/registry.d.ts +0 -34
- package/dist/types/extensibility/plugins/marketplace/source-resolver.d.ts +0 -28
- package/dist/types/extensibility/plugins/marketplace/types.d.ts +0 -130
- package/dist/types/extensibility/plugins/parser.d.ts +0 -52
- package/dist/types/extensibility/plugins/security-scanner.d.ts +0 -31
- package/dist/types/extensibility/plugins/types.d.ts +0 -149
- package/dist/types/extensibility/runtime-skill-discovery.d.ts +0 -20
- package/dist/types/extensibility/shared-events.d.ts +0 -281
- package/dist/types/extensibility/skc-plugins/activation.d.ts +0 -14
- package/dist/types/extensibility/skc-plugins/compiler.d.ts +0 -19
- package/dist/types/extensibility/skc-plugins/constrained-hooks.d.ts +0 -29
- package/dist/types/extensibility/skc-plugins/index.d.ts +0 -18
- package/dist/types/extensibility/skc-plugins/injection.d.ts +0 -40
- package/dist/types/extensibility/skc-plugins/installer.d.ts +0 -13
- package/dist/types/extensibility/skc-plugins/loader.d.ts +0 -3
- package/dist/types/extensibility/skc-plugins/mcp-policy.d.ts +0 -26
- package/dist/types/extensibility/skc-plugins/observability.d.ts +0 -27
- package/dist/types/extensibility/skc-plugins/paths.d.ts +0 -8
- package/dist/types/extensibility/skc-plugins/prompt-appendix.d.ts +0 -16
- package/dist/types/extensibility/skc-plugins/registry.d.ts +0 -32
- package/dist/types/extensibility/skc-plugins/runtime-adapters.d.ts +0 -64
- package/dist/types/extensibility/skc-plugins/schema.d.ts +0 -3
- package/dist/types/extensibility/skc-plugins/session-validation.d.ts +0 -42
- package/dist/types/extensibility/skc-plugins/state.d.ts +0 -9
- package/dist/types/extensibility/skc-plugins/tools.d.ts +0 -8
- package/dist/types/extensibility/skc-plugins/types.d.ts +0 -220
- package/dist/types/extensibility/skc-plugins/validation.d.ts +0 -11
- package/dist/types/extensibility/skills.d.ts +0 -82
- package/dist/types/extensibility/slash-commands.d.ts +0 -48
- package/dist/types/extensibility/tool-proxy.d.ts +0 -4
- package/dist/types/extensibility/typebox.d.ts +0 -155
- package/dist/types/extensibility/utils.d.ts +0 -12
- package/dist/types/goals/index.d.ts +0 -3
- package/dist/types/goals/runtime.d.ts +0 -63
- package/dist/types/goals/state.d.ts +0 -32
- package/dist/types/goals/tools/goal-tool.d.ts +0 -62
- package/dist/types/harness-control-plane/classifier.d.ts +0 -13
- package/dist/types/harness-control-plane/control-endpoint.d.ts +0 -31
- package/dist/types/harness-control-plane/finalize.d.ts +0 -60
- package/dist/types/harness-control-plane/gc-adapter.d.ts +0 -3
- package/dist/types/harness-control-plane/operate.d.ts +0 -35
- package/dist/types/harness-control-plane/owner.d.ts +0 -53
- package/dist/types/harness-control-plane/phase-rollup.d.ts +0 -23
- package/dist/types/harness-control-plane/preserve.d.ts +0 -19
- package/dist/types/harness-control-plane/receipt-ingest.d.ts +0 -19
- package/dist/types/harness-control-plane/receipt-spool.d.ts +0 -19
- package/dist/types/harness-control-plane/receipts.d.ts +0 -149
- package/dist/types/harness-control-plane/rpc-adapter.d.ts +0 -69
- package/dist/types/harness-control-plane/seams.d.ts +0 -21
- package/dist/types/harness-control-plane/session-lease.d.ts +0 -65
- package/dist/types/harness-control-plane/state-machine.d.ts +0 -24
- package/dist/types/harness-control-plane/storage.d.ts +0 -81
- package/dist/types/harness-control-plane/types.d.ts +0 -187
- package/dist/types/hashline/anchors.d.ts +0 -20
- package/dist/types/hashline/apply.d.ts +0 -14
- package/dist/types/hashline/constants.d.ts +0 -19
- package/dist/types/hashline/diff-preview.d.ts +0 -2
- package/dist/types/hashline/diff.d.ts +0 -17
- package/dist/types/hashline/execute.d.ts +0 -4
- package/dist/types/hashline/hash.d.ts +0 -123
- package/dist/types/hashline/index.d.ts +0 -13
- package/dist/types/hashline/input.d.ts +0 -11
- package/dist/types/hashline/parser.d.ts +0 -7
- package/dist/types/hashline/prefixes.d.ts +0 -7
- package/dist/types/hashline/recovery.d.ts +0 -27
- package/dist/types/hashline/stream.d.ts +0 -2
- package/dist/types/hashline/types.d.ts +0 -77
- package/dist/types/hindsight/backend.d.ts +0 -13
- package/dist/types/hindsight/bank.d.ts +0 -54
- package/dist/types/hindsight/client.d.ts +0 -224
- package/dist/types/hindsight/config.d.ts +0 -51
- package/dist/types/hindsight/content.d.ts +0 -70
- package/dist/types/hindsight/index.d.ts +0 -8
- package/dist/types/hindsight/mental-models.d.ts +0 -125
- package/dist/types/hindsight/state.d.ts +0 -99
- package/dist/types/hindsight/transcript.d.ts +0 -28
- package/dist/types/hooks/codex-native-hooks-config.d.ts +0 -29
- package/dist/types/hooks/native-skill-hook.d.ts +0 -28
- package/dist/types/hooks/skill-keywords.d.ts +0 -18
- package/dist/types/hooks/skill-state.d.ts +0 -93
- package/dist/types/i18n/index.d.ts +0 -38
- package/dist/types/i18n/messages/de.d.ts +0 -2
- package/dist/types/i18n/messages/de.messages.d.ts +0 -1
- package/dist/types/i18n/messages/de.settings.d.ts +0 -1
- package/dist/types/i18n/messages/en.d.ts +0 -81
- package/dist/types/i18n/messages/es.d.ts +0 -2
- package/dist/types/i18n/messages/es.messages.d.ts +0 -1
- package/dist/types/i18n/messages/es.settings.d.ts +0 -1
- package/dist/types/i18n/messages/fr.d.ts +0 -2
- package/dist/types/i18n/messages/fr.messages.d.ts +0 -1
- package/dist/types/i18n/messages/fr.settings.d.ts +0 -1
- package/dist/types/i18n/messages/ja.d.ts +0 -2
- package/dist/types/i18n/messages/ja.messages.d.ts +0 -1
- package/dist/types/i18n/messages/ja.settings.d.ts +0 -1
- package/dist/types/i18n/messages/ko.d.ts +0 -2
- package/dist/types/i18n/messages/ko.messages.d.ts +0 -1
- package/dist/types/i18n/messages/ko.settings.d.ts +0 -1
- package/dist/types/i18n/messages/zh.d.ts +0 -2
- package/dist/types/i18n/messages/zh.messages.d.ts +0 -1
- package/dist/types/i18n/messages/zh.settings.d.ts +0 -1
- package/dist/types/index.d.ts +0 -33
- package/dist/types/internal-urls/agent-protocol.d.ts +0 -12
- package/dist/types/internal-urls/artifact-protocol.d.ts +0 -6
- package/dist/types/internal-urls/docs-index.generated.d.ts +0 -2
- package/dist/types/internal-urls/index.d.ts +0 -20
- package/dist/types/internal-urls/issue-pr-protocol.d.ts +0 -17
- package/dist/types/internal-urls/json-query.d.ts +0 -30
- package/dist/types/internal-urls/local-protocol.d.ts +0 -43
- package/dist/types/internal-urls/mcp-protocol.d.ts +0 -12
- package/dist/types/internal-urls/memory-protocol.d.ts +0 -23
- package/dist/types/internal-urls/parse.d.ts +0 -19
- package/dist/types/internal-urls/registry-helpers.d.ts +0 -11
- package/dist/types/internal-urls/router.d.ts +0 -14
- package/dist/types/internal-urls/rule-protocol.d.ts +0 -6
- package/dist/types/internal-urls/skc-protocol.d.ts +0 -12
- package/dist/types/internal-urls/skill-protocol.d.ts +0 -13
- package/dist/types/internal-urls/types.d.ts +0 -109
- package/dist/types/lsp/client.d.ts +0 -66
- package/dist/types/lsp/clients/biome-client.d.ts +0 -16
- package/dist/types/lsp/clients/index.d.ts +0 -19
- package/dist/types/lsp/clients/lsp-linter-client.d.ts +0 -16
- package/dist/types/lsp/clients/swiftlint-client.d.ts +0 -20
- package/dist/types/lsp/config.d.ts +0 -65
- package/dist/types/lsp/edits.d.ts +0 -23
- package/dist/types/lsp/index.d.ts +0 -130
- package/dist/types/lsp/lspmux.d.ts +0 -58
- package/dist/types/lsp/render.d.ts +0 -32
- package/dist/types/lsp/startup-events.d.ts +0 -12
- package/dist/types/lsp/types.d.ts +0 -306
- package/dist/types/lsp/utils.d.ts +0 -108
- package/dist/types/main.d.ts +0 -139
- package/dist/types/memories/index.d.ts +0 -28
- package/dist/types/memories/storage.d.ts +0 -110
- package/dist/types/memory-backend/index.d.ts +0 -4
- package/dist/types/memory-backend/local-backend.d.ts +0 -9
- package/dist/types/memory-backend/off-backend.d.ts +0 -7
- package/dist/types/memory-backend/resolve.d.ts +0 -15
- package/dist/types/memory-backend/types.d.ts +0 -61
- package/dist/types/migrate/action-planner.d.ts +0 -11
- package/dist/types/migrate/adapters/claude-code.d.ts +0 -2
- package/dist/types/migrate/adapters/codex.d.ts +0 -5
- package/dist/types/migrate/adapters/index.d.ts +0 -45
- package/dist/types/migrate/adapters/opencode.d.ts +0 -2
- package/dist/types/migrate/executor.d.ts +0 -2
- package/dist/types/migrate/mcp-mapper.d.ts +0 -20
- package/dist/types/migrate/report.d.ts +0 -18
- package/dist/types/migrate/skill-normalizer.d.ts +0 -27
- package/dist/types/migrate/types.d.ts +0 -126
- package/dist/types/modes/acp/acp-agent.d.ts +0 -78
- package/dist/types/modes/acp/acp-client-bridge.d.ts +0 -9
- package/dist/types/modes/acp/acp-event-mapper.d.ts +0 -36
- package/dist/types/modes/acp/acp-mode.d.ts +0 -17
- package/dist/types/modes/acp/index.d.ts +0 -2
- package/dist/types/modes/acp/terminal-auth.d.ts +0 -6
- package/dist/types/modes/bridge/auth.d.ts +0 -12
- package/dist/types/modes/bridge/bridge-client-bridge.d.ts +0 -9
- package/dist/types/modes/bridge/bridge-mode.d.ts +0 -47
- package/dist/types/modes/bridge/bridge-ui-context.d.ts +0 -88
- package/dist/types/modes/bridge/event-stream.d.ts +0 -8
- package/dist/types/modes/components/agent-dashboard.d.ts +0 -21
- package/dist/types/modes/components/assistant-message.d.ts +0 -20
- package/dist/types/modes/components/bash-execution.d.ts +0 -29
- package/dist/types/modes/components/bordered-loader.d.ts +0 -11
- package/dist/types/modes/components/branch-summary-message.d.ts +0 -13
- package/dist/types/modes/components/btw-panel.d.ts +0 -16
- package/dist/types/modes/components/compaction-summary-message.d.ts +0 -13
- package/dist/types/modes/components/countdown-timer.d.ts +0 -14
- package/dist/types/modes/components/custom-editor.d.ts +0 -69
- package/dist/types/modes/components/custom-message.d.ts +0 -15
- package/dist/types/modes/components/custom-model-preset-wizard.d.ts +0 -12
- package/dist/types/modes/components/custom-provider-wizard.d.ts +0 -10
- package/dist/types/modes/components/diff.d.ts +0 -11
- package/dist/types/modes/components/dynamic-border.d.ts +0 -14
- package/dist/types/modes/components/eval-execution.d.ts +0 -23
- package/dist/types/modes/components/execution-shared.d.ts +0 -46
- package/dist/types/modes/components/extensions/extension-dashboard.d.ts +0 -26
- package/dist/types/modes/components/extensions/extension-list.d.ts +0 -39
- package/dist/types/modes/components/extensions/index.d.ts +0 -8
- package/dist/types/modes/components/extensions/inspector-panel.d.ts +0 -8
- package/dist/types/modes/components/extensions/state-manager.d.ts +0 -50
- package/dist/types/modes/components/extensions/types.d.ts +0 -151
- package/dist/types/modes/components/footer.d.ts +0 -30
- package/dist/types/modes/components/history-search.d.ts +0 -7
- package/dist/types/modes/components/hook-editor.d.ts +0 -18
- package/dist/types/modes/components/hook-input.d.ts +0 -15
- package/dist/types/modes/components/hook-message.d.ts +0 -15
- package/dist/types/modes/components/hook-selector.d.ts +0 -59
- package/dist/types/modes/components/index.d.ts +0 -35
- package/dist/types/modes/components/irc-sidebar.d.ts +0 -32
- package/dist/types/modes/components/jobs-overlay-model.d.ts +0 -31
- package/dist/types/modes/components/jobs-overlay.d.ts +0 -30
- package/dist/types/modes/components/keybinding-hints.d.ts +0 -40
- package/dist/types/modes/components/login-dialog.d.ts +0 -32
- package/dist/types/modes/components/message-frame.d.ts +0 -42
- package/dist/types/modes/components/model-selector.d.ts +0 -60
- package/dist/types/modes/components/oauth-selector.d.ts +0 -17
- package/dist/types/modes/components/pet-selector.d.ts +0 -11
- package/dist/types/modes/components/plugin-selector.d.ts +0 -26
- package/dist/types/modes/components/plugin-settings.d.ts +0 -66
- package/dist/types/modes/components/provider-onboarding-selector.d.ts +0 -7
- package/dist/types/modes/components/queue-mode-selector.d.ts +0 -9
- package/dist/types/modes/components/queued-message-selector.d.ts +0 -12
- package/dist/types/modes/components/read-tool-group.d.ts +0 -30
- package/dist/types/modes/components/runtime-mcp-add-wizard.d.ts +0 -26
- package/dist/types/modes/components/sayknow-pet-widget.d.ts +0 -59
- package/dist/types/modes/components/session-observer-overlay.d.ts +0 -11
- package/dist/types/modes/components/session-selector.d.ts +0 -43
- package/dist/types/modes/components/settings-defs.d.ts +0 -50
- package/dist/types/modes/components/settings-selector.d.ts +0 -64
- package/dist/types/modes/components/show-images-selector.d.ts +0 -9
- package/dist/types/modes/components/skill-hud/render.d.ts +0 -2
- package/dist/types/modes/components/skill-message.d.ts +0 -10
- package/dist/types/modes/components/status-line/context-thresholds.d.ts +0 -4
- package/dist/types/modes/components/status-line/git-utils.d.ts +0 -28
- package/dist/types/modes/components/status-line/index.d.ts +0 -4
- package/dist/types/modes/components/status-line/presets.d.ts +0 -3
- package/dist/types/modes/components/status-line/segments.d.ts +0 -5
- package/dist/types/modes/components/status-line/separators.d.ts +0 -3
- package/dist/types/modes/components/status-line/token-rate.d.ts +0 -10
- package/dist/types/modes/components/status-line/types.d.ts +0 -83
- package/dist/types/modes/components/status-line.d.ts +0 -94
- package/dist/types/modes/components/theme-selector.d.ts +0 -10
- package/dist/types/modes/components/thinking-selector.d.ts +0 -15
- package/dist/types/modes/components/todo-reminder.d.ts +0 -13
- package/dist/types/modes/components/tool-execution.d.ts +0 -55
- package/dist/types/modes/components/tree-selector.d.ts +0 -31
- package/dist/types/modes/components/ttsr-notification.d.ts +0 -13
- package/dist/types/modes/components/two-column-body.d.ts +0 -9
- package/dist/types/modes/components/user-message-selector.d.ts +0 -28
- package/dist/types/modes/components/user-message.d.ts +0 -8
- package/dist/types/modes/components/visual-truncate.d.ts +0 -19
- package/dist/types/modes/components/welcome.d.ts +0 -46
- package/dist/types/modes/controllers/btw-controller.d.ts +0 -10
- package/dist/types/modes/controllers/command-controller-shared.d.ts +0 -47
- package/dist/types/modes/controllers/command-controller.d.ts +0 -40
- package/dist/types/modes/controllers/event-controller.d.ts +0 -21
- package/dist/types/modes/controllers/extension-ui-controller.d.ts +0 -80
- package/dist/types/modes/controllers/input-controller.d.ts +0 -42
- package/dist/types/modes/controllers/runtime-mcp-command-controller.d.ts +0 -10
- package/dist/types/modes/controllers/selector-controller.d.ts +0 -68
- package/dist/types/modes/controllers/ssh-command-controller.d.ts +0 -10
- package/dist/types/modes/controllers/todo-command-controller.d.ts +0 -7
- package/dist/types/modes/emoji-autocomplete.d.ts +0 -16
- package/dist/types/modes/index.d.ts +0 -10
- package/dist/types/modes/interactive-mode.d.ts +0 -297
- package/dist/types/modes/irc-observation-ledger.d.ts +0 -22
- package/dist/types/modes/jobs-observer.d.ts +0 -57
- package/dist/types/modes/oauth-manual-input.d.ts +0 -8
- package/dist/types/modes/print-mode.d.ts +0 -44
- package/dist/types/modes/prompt-action-autocomplete.d.ts +0 -50
- package/dist/types/modes/rpc/host-tools.d.ts +0 -1
- package/dist/types/modes/rpc/host-uris.d.ts +0 -1
- package/dist/types/modes/rpc/rpc-client.d.ts +0 -299
- package/dist/types/modes/rpc/rpc-mode.d.ts +0 -86
- package/dist/types/modes/rpc/rpc-socket-security.d.ts +0 -10
- package/dist/types/modes/rpc/rpc-types.d.ts +0 -810
- package/dist/types/modes/runtime-init.d.ts +0 -21
- package/dist/types/modes/session-observer-registry.d.ts +0 -26
- package/dist/types/modes/shared/agent-wire/approval-gate.d.ts +0 -57
- package/dist/types/modes/shared/agent-wire/command-contract.d.ts +0 -18
- package/dist/types/modes/shared/agent-wire/command-dispatch.d.ts +0 -37
- package/dist/types/modes/shared/agent-wire/command-validation.d.ts +0 -2
- package/dist/types/modes/shared/agent-wire/deep-interview-gate.d.ts +0 -102
- package/dist/types/modes/shared/agent-wire/event-contract.d.ts +0 -103
- package/dist/types/modes/shared/agent-wire/event-envelope.d.ts +0 -60
- package/dist/types/modes/shared/agent-wire/event-observation.d.ts +0 -37
- package/dist/types/modes/shared/agent-wire/handshake.d.ts +0 -56
- package/dist/types/modes/shared/agent-wire/host-tool-bridge.d.ts +0 -16
- package/dist/types/modes/shared/agent-wire/host-uri-bridge.d.ts +0 -17
- package/dist/types/modes/shared/agent-wire/protocol.d.ts +0 -25
- package/dist/types/modes/shared/agent-wire/responses.d.ts +0 -4
- package/dist/types/modes/shared/agent-wire/scopes.d.ts +0 -18
- package/dist/types/modes/shared/agent-wire/session-registry.d.ts +0 -25
- package/dist/types/modes/shared/agent-wire/ui-request-broker.d.ts +0 -42
- package/dist/types/modes/shared/agent-wire/ui-result.d.ts +0 -27
- package/dist/types/modes/shared/agent-wire/unattended-action-policy.d.ts +0 -29
- package/dist/types/modes/shared/agent-wire/unattended-audit.d.ts +0 -68
- package/dist/types/modes/shared/agent-wire/unattended-run-controller.d.ts +0 -166
- package/dist/types/modes/shared/agent-wire/unattended-session.d.ts +0 -127
- package/dist/types/modes/shared/agent-wire/workflow-gate-broker.d.ts +0 -154
- package/dist/types/modes/shared/agent-wire/workflow-gate-schema.d.ts +0 -39
- package/dist/types/modes/shared.d.ts +0 -15
- package/dist/types/modes/slash-command-visibility.d.ts +0 -1
- package/dist/types/modes/theme/defaults/index.d.ts +0 -652
- package/dist/types/modes/theme/mermaid-cache.d.ts +0 -9
- package/dist/types/modes/theme/shimmer.d.ts +0 -38
- package/dist/types/modes/theme/theme.d.ts +0 -275
- package/dist/types/modes/tmux-scroll.d.ts +0 -18
- package/dist/types/modes/types.d.ts +0 -318
- package/dist/types/modes/utils/abort-message.d.ts +0 -4
- package/dist/types/modes/utils/context-usage.d.ts +0 -36
- package/dist/types/modes/utils/hotkeys-markdown.d.ts +0 -5
- package/dist/types/modes/utils/injected-user-submission.d.ts +0 -52
- package/dist/types/modes/utils/irc-message.d.ts +0 -38
- package/dist/types/modes/utils/keybinding-matchers.d.ts +0 -10
- package/dist/types/modes/utils/terminal-bell.d.ts +0 -3
- package/dist/types/modes/utils/tools-markdown.d.ts +0 -5
- package/dist/types/modes/utils/ui-helpers.d.ts +0 -75
- package/dist/types/notifications/attachment-registry.d.ts +0 -17
- package/dist/types/notifications/chat-adapters.d.ts +0 -9
- package/dist/types/notifications/config-commands.d.ts +0 -64
- package/dist/types/notifications/config.d.ts +0 -132
- package/dist/types/notifications/daemon-paths.d.ts +0 -17
- package/dist/types/notifications/engine.d.ts +0 -59
- package/dist/types/notifications/helpers.d.ts +0 -55
- package/dist/types/notifications/html-format.d.ts +0 -75
- package/dist/types/notifications/index.d.ts +0 -219
- package/dist/types/notifications/lifecycle-commands.d.ts +0 -69
- package/dist/types/notifications/lifecycle-control-runtime.d.ts +0 -107
- package/dist/types/notifications/lifecycle-orchestrator.d.ts +0 -144
- package/dist/types/notifications/managed-daemon.d.ts +0 -48
- package/dist/types/notifications/notification-service.d.ts +0 -144
- package/dist/types/notifications/operator-runtime.d.ts +0 -52
- package/dist/types/notifications/rate-limit-pool.d.ts +0 -113
- package/dist/types/notifications/recent-activity.d.ts +0 -39
- package/dist/types/notifications/reply-sent-store.d.ts +0 -53
- package/dist/types/notifications/rich-draft.d.ts +0 -68
- package/dist/types/notifications/rich-render.d.ts +0 -90
- package/dist/types/notifications/telegram-cli.d.ts +0 -19
- package/dist/types/notifications/telegram-daemon-cli.d.ts +0 -28
- package/dist/types/notifications/telegram-daemon-control.d.ts +0 -70
- package/dist/types/notifications/telegram-daemon.d.ts +0 -558
- package/dist/types/notifications/telegram-reference.d.ts +0 -136
- package/dist/types/notifications/threaded-inbound.d.ts +0 -77
- package/dist/types/notifications/threaded-render.d.ts +0 -88
- package/dist/types/notifications/topic-registry.d.ts +0 -89
- package/dist/types/plan-mode/approved-plan.d.ts +0 -49
- package/dist/types/plan-mode/state.d.ts +0 -6
- package/dist/types/registry/agent-registry.d.ts +0 -64
- package/dist/types/reminders/star-reminder.d.ts +0 -115
- package/dist/types/research-plan/index.d.ts +0 -1
- package/dist/types/research-plan/ledger.d.ts +0 -33
- package/dist/types/rlm/artifacts.d.ts +0 -9
- package/dist/types/rlm/complete-research-tool.d.ts +0 -35
- package/dist/types/rlm/data-context.d.ts +0 -6
- package/dist/types/rlm/index.d.ts +0 -47
- package/dist/types/rlm/notebook.d.ts +0 -12
- package/dist/types/rlm/preset.d.ts +0 -23
- package/dist/types/rlm/python-tool.d.ts +0 -16
- package/dist/types/rlm/report.d.ts +0 -14
- package/dist/types/rlm/types.d.ts +0 -37
- package/dist/types/runtime/process-lifecycle.d.ts +0 -108
- package/dist/types/runtime-api-key.d.ts +0 -7
- package/dist/types/runtime-credential-selector.d.ts +0 -7
- package/dist/types/runtime-mcp/client.d.ts +0 -74
- package/dist/types/runtime-mcp/config-writer.d.ts +0 -89
- package/dist/types/runtime-mcp/config.d.ts +0 -77
- package/dist/types/runtime-mcp/discoverable-tool-metadata.d.ts +0 -7
- package/dist/types/runtime-mcp/index.d.ts +0 -18
- package/dist/types/runtime-mcp/json-rpc.d.ts +0 -22
- package/dist/types/runtime-mcp/loader.d.ts +0 -45
- package/dist/types/runtime-mcp/manager.d.ts +0 -195
- package/dist/types/runtime-mcp/oauth-discovery.d.ts +0 -40
- package/dist/types/runtime-mcp/oauth-flow.d.ts +0 -59
- package/dist/types/runtime-mcp/render.d.ts +0 -25
- package/dist/types/runtime-mcp/smithery-auth.d.ts +0 -16
- package/dist/types/runtime-mcp/smithery-connect.d.ts +0 -38
- package/dist/types/runtime-mcp/smithery-registry.d.ts +0 -51
- package/dist/types/runtime-mcp/tool-bridge.d.ts +0 -86
- package/dist/types/runtime-mcp/tool-cache.d.ts +0 -8
- package/dist/types/runtime-mcp/transports/http.d.ts +0 -36
- package/dist/types/runtime-mcp/transports/index.d.ts +0 -5
- package/dist/types/runtime-mcp/transports/stdio.d.ts +0 -29
- package/dist/types/runtime-mcp/types.d.ts +0 -349
- package/dist/types/sdk.d.ts +0 -256
- package/dist/types/secrets/index.d.ts +0 -9
- package/dist/types/secrets/obfuscator.d.ts +0 -23
- package/dist/types/secrets/regex.d.ts +0 -2
- package/dist/types/session/agent-session.d.ts +0 -1238
- package/dist/types/session/agent-storage.d.ts +0 -101
- package/dist/types/session/artifacts.d.ts +0 -64
- package/dist/types/session/auth-broker-config.d.ts +0 -13
- package/dist/types/session/auth-storage.d.ts +0 -6
- package/dist/types/session/blob-store.d.ts +0 -160
- package/dist/types/session/cache-economics.d.ts +0 -79
- package/dist/types/session/client-bridge.d.ts +0 -88
- package/dist/types/session/context-estimation.d.ts +0 -31
- package/dist/types/session/contribution-prep.d.ts +0 -47
- package/dist/types/session/file-mention-pruning.d.ts +0 -8
- package/dist/types/session/history-storage.d.ts +0 -16
- package/dist/types/session/messages.d.ts +0 -169
- package/dist/types/session/provider-safety-stop.d.ts +0 -5
- package/dist/types/session/session-dump-format.d.ts +0 -22
- package/dist/types/session/session-manager.d.ts +0 -781
- package/dist/types/session/session-storage.d.ts +0 -230
- package/dist/types/session/streaming-output.d.ts +0 -209
- package/dist/types/session/tool-choice-queue.d.ts +0 -84
- package/dist/types/session/yield-queue.d.ts +0 -24
- package/dist/types/setup/credential-auto-import.d.ts +0 -63
- package/dist/types/setup/credential-import.d.ts +0 -82
- package/dist/types/setup/hermes-setup.d.ts +0 -78
- package/dist/types/setup/host-plugin-setup.d.ts +0 -39
- package/dist/types/setup/model-onboarding-guidance.d.ts +0 -9
- package/dist/types/setup/provider-onboarding.d.ts +0 -52
- package/dist/types/skc-runtime/cli-write-receipt.d.ts +0 -24
- package/dist/types/skc-runtime/deep-interview-ambiguity.d.ts +0 -39
- package/dist/types/skc-runtime/deep-interview-recorder.d.ts +0 -114
- package/dist/types/skc-runtime/deep-interview-runtime.d.ts +0 -36
- package/dist/types/skc-runtime/deep-interview-state.d.ts +0 -127
- package/dist/types/skc-runtime/gc-render.d.ts +0 -6
- package/dist/types/skc-runtime/gc-runtime.d.ts +0 -134
- package/dist/types/skc-runtime/goal-mode-request.d.ts +0 -53
- package/dist/types/skc-runtime/launch-tmux.d.ts +0 -78
- package/dist/types/skc-runtime/launch-worktree.d.ts +0 -46
- package/dist/types/skc-runtime/ledger-event-renderer.d.ts +0 -68
- package/dist/types/skc-runtime/psmux-detect.d.ts +0 -78
- package/dist/types/skc-runtime/ralplan-runtime.d.ts +0 -26
- package/dist/types/skc-runtime/restricted-role-agent-bash.d.ts +0 -3
- package/dist/types/skc-runtime/session-layout.d.ts +0 -59
- package/dist/types/skc-runtime/session-resolution.d.ts +0 -47
- package/dist/types/skc-runtime/session-state-sidecar.d.ts +0 -70
- package/dist/types/skc-runtime/state-graph.d.ts +0 -4
- package/dist/types/skc-runtime/state-migrations.d.ts +0 -33
- package/dist/types/skc-runtime/state-renderer.d.ts +0 -70
- package/dist/types/skc-runtime/state-runtime.d.ts +0 -38
- package/dist/types/skc-runtime/state-schema.d.ts +0 -319
- package/dist/types/skc-runtime/state-validation.d.ts +0 -6
- package/dist/types/skc-runtime/state-writer.d.ts +0 -244
- package/dist/types/skc-runtime/team-gc.d.ts +0 -7
- package/dist/types/skc-runtime/team-runtime.d.ts +0 -355
- package/dist/types/skc-runtime/tmux-common.d.ts +0 -111
- package/dist/types/skc-runtime/tmux-gc.d.ts +0 -7
- package/dist/types/skc-runtime/tmux-owner-isolation-cli.d.ts +0 -5
- package/dist/types/skc-runtime/tmux-owner-isolation.d.ts +0 -309
- package/dist/types/skc-runtime/tmux-sessions.d.ts +0 -94
- package/dist/types/skc-runtime/ultragoal-guard.d.ts +0 -93
- package/dist/types/skc-runtime/ultragoal-receipt-freshness.d.ts +0 -42
- package/dist/types/skc-runtime/ultragoal-runtime.d.ts +0 -410
- package/dist/types/skc-runtime/workflow-command-ref.d.ts +0 -43
- package/dist/types/skc-runtime/workflow-manifest.d.ts +0 -54
- package/dist/types/skill-state/active-state.d.ts +0 -126
- package/dist/types/skill-state/canonical-skills.d.ts +0 -3
- package/dist/types/skill-state/deep-interview-mutation-guard.d.ts +0 -38
- package/dist/types/skill-state/initial-phase.d.ts +0 -12
- package/dist/types/skill-state/workflow-hud.d.ts +0 -83
- package/dist/types/skill-state/workflow-state-contract.d.ts +0 -57
- package/dist/types/skill-state/workflow-state-version.d.ts +0 -3
- package/dist/types/slash-commands/acp-builtins.d.ts +0 -18
- package/dist/types/slash-commands/builtin-registry.d.ts +0 -24
- package/dist/types/slash-commands/helpers/context-report.d.ts +0 -7
- package/dist/types/slash-commands/helpers/fast-status-report.d.ts +0 -82
- package/dist/types/slash-commands/helpers/format.d.ts +0 -10
- package/dist/types/slash-commands/helpers/mcp.d.ts +0 -3
- package/dist/types/slash-commands/helpers/parse.d.ts +0 -33
- package/dist/types/slash-commands/helpers/ssh.d.ts +0 -3
- package/dist/types/slash-commands/helpers/todo.d.ts +0 -3
- package/dist/types/slash-commands/helpers/usage-report.d.ts +0 -7
- package/dist/types/slash-commands/types.d.ts +0 -120
- package/dist/types/ssh/config-writer.d.ts +0 -49
- package/dist/types/ssh/connection-manager.d.ts +0 -33
- package/dist/types/ssh/ssh-executor.d.ts +0 -37
- package/dist/types/ssh/sshfs-mount.d.ts +0 -6
- package/dist/types/ssh/utils.d.ts +0 -2
- package/dist/types/stt/downloader.d.ts +0 -9
- package/dist/types/stt/index.d.ts +0 -3
- package/dist/types/stt/recorder.d.ts +0 -13
- package/dist/types/stt/setup.d.ts +0 -18
- package/dist/types/stt/stt-controller.d.ts +0 -16
- package/dist/types/stt/transcriber.d.ts +0 -16
- package/dist/types/system-prompt.d.ts +0 -118
- package/dist/types/task/agents.d.ts +0 -28
- package/dist/types/task/commands.d.ts +0 -35
- package/dist/types/task/discovery.d.ts +0 -19
- package/dist/types/task/executor.d.ts +0 -127
- package/dist/types/task/fork-context-advisory.d.ts +0 -13
- package/dist/types/task/fork-context-budget.d.ts +0 -7
- package/dist/types/task/id.d.ts +0 -7
- package/dist/types/task/index.d.ts +0 -43
- package/dist/types/task/name-generator.d.ts +0 -16
- package/dist/types/task/output-manager.d.ts +0 -36
- package/dist/types/task/parallel.d.ts +0 -34
- package/dist/types/task/receipt.d.ts +0 -89
- package/dist/types/task/render.d.ts +0 -28
- package/dist/types/task/roi-reconciliation.d.ts +0 -27
- package/dist/types/task/simple-mode.d.ts +0 -8
- package/dist/types/task/skc-command.d.ts +0 -7
- package/dist/types/task/spawn-gate.d.ts +0 -29
- package/dist/types/task/subprocess-tool-registry.d.ts +0 -72
- package/dist/types/task/token-log.d.ts +0 -30
- package/dist/types/task/token-log.test.d.ts +0 -1
- package/dist/types/task/types.d.ts +0 -516
- package/dist/types/task/worktree.d.ts +0 -94
- package/dist/types/thinking-metadata.d.ts +0 -16
- package/dist/types/thinking.d.ts +0 -22
- package/dist/types/tool-discovery/tool-index.d.ts +0 -112
- package/dist/types/tools/archive-reader.d.ts +0 -40
- package/dist/types/tools/ask-answer-registry.d.ts +0 -18
- package/dist/types/tools/ask.d.ts +0 -123
- package/dist/types/tools/ast-edit.d.ts +0 -77
- package/dist/types/tools/ast-grep.d.ts +0 -69
- package/dist/types/tools/auto-generated-guard.d.ts +0 -17
- package/dist/types/tools/bash-allowed-prefixes.d.ts +0 -10
- package/dist/types/tools/bash-command-fixup.d.ts +0 -11
- package/dist/types/tools/bash-interactive.d.ts +0 -16
- package/dist/types/tools/bash-interceptor.d.ts +0 -24
- package/dist/types/tools/bash-pty-selection.d.ts +0 -7
- package/dist/types/tools/bash-skill-urls.d.ts +0 -31
- package/dist/types/tools/bash.d.ts +0 -157
- package/dist/types/tools/bisect.d.ts +0 -81
- package/dist/types/tools/browser/actions.d.ts +0 -54
- package/dist/types/tools/browser/attach.d.ts +0 -50
- package/dist/types/tools/browser/launch.d.ts +0 -62
- package/dist/types/tools/browser/readable.d.ts +0 -17
- package/dist/types/tools/browser/registry.d.ts +0 -57
- package/dist/types/tools/browser/render.d.ts +0 -53
- package/dist/types/tools/browser/tab-protocol.d.ts +0 -144
- package/dist/types/tools/browser/tab-supervisor.d.ts +0 -109
- package/dist/types/tools/browser/tab-worker-entry.d.ts +0 -1
- package/dist/types/tools/browser/tab-worker.d.ts +0 -19
- package/dist/types/tools/browser.d.ts +0 -211
- package/dist/types/tools/calculator.d.ts +0 -76
- package/dist/types/tools/checkpoint.d.ts +0 -63
- package/dist/types/tools/composer-bash-policy.d.ts +0 -14
- package/dist/types/tools/computer/render.d.ts +0 -17
- package/dist/types/tools/computer-gc.d.ts +0 -23
- package/dist/types/tools/computer.d.ts +0 -465
- package/dist/types/tools/conflict-detect.d.ts +0 -205
- package/dist/types/tools/context.d.ts +0 -19
- package/dist/types/tools/cron.d.ts +0 -91
- package/dist/types/tools/debug.d.ts +0 -209
- package/dist/types/tools/eval.d.ts +0 -108
- package/dist/types/tools/fetch.d.ts +0 -84
- package/dist/types/tools/file-recorder.d.ts +0 -13
- package/dist/types/tools/find.d.ts +0 -95
- package/dist/types/tools/fs-cache-invalidation.d.ts +0 -15
- package/dist/types/tools/gh-format.d.ts +0 -6
- package/dist/types/tools/gh-renderer.d.ts +0 -25
- package/dist/types/tools/gh.d.ts +0 -356
- package/dist/types/tools/github-cache.d.ts +0 -103
- package/dist/types/tools/grouped-file-output.d.ts +0 -36
- package/dist/types/tools/hindsight-recall.d.ts +0 -21
- package/dist/types/tools/hindsight-reflect.d.ts +0 -23
- package/dist/types/tools/hindsight-retain.d.ts +0 -27
- package/dist/types/tools/image-gen.d.ts +0 -79
- package/dist/types/tools/index.d.ts +0 -371
- package/dist/types/tools/irc.d.ts +0 -79
- package/dist/types/tools/job.d.ts +0 -78
- package/dist/types/tools/json-tree.d.ts +0 -23
- package/dist/types/tools/jtd-to-json-schema.d.ts +0 -29
- package/dist/types/tools/jtd-to-typescript.d.ts +0 -26
- package/dist/types/tools/jtd-utils.d.ts +0 -42
- package/dist/types/tools/list-limit.d.ts +0 -12
- package/dist/types/tools/match-line-format.d.ts +0 -11
- package/dist/types/tools/monitor.d.ts +0 -54
- package/dist/types/tools/output-meta.d.ts +0 -204
- package/dist/types/tools/path-utils.d.ts +0 -147
- package/dist/types/tools/plan-mode-guard.d.ts +0 -18
- package/dist/types/tools/read.d.ts +0 -85
- package/dist/types/tools/recipe/index.d.ts +0 -45
- package/dist/types/tools/recipe/render.d.ts +0 -36
- package/dist/types/tools/recipe/runner.d.ts +0 -60
- package/dist/types/tools/recipe/runners/cargo.d.ts +0 -16
- package/dist/types/tools/recipe/runners/index.d.ts +0 -2
- package/dist/types/tools/recipe/runners/just.d.ts +0 -2
- package/dist/types/tools/recipe/runners/make.d.ts +0 -2
- package/dist/types/tools/recipe/runners/pkg.d.ts +0 -2
- package/dist/types/tools/recipe/runners/task.d.ts +0 -2
- package/dist/types/tools/render-mermaid.d.ts +0 -37
- package/dist/types/tools/render-utils.d.ts +0 -158
- package/dist/types/tools/renderers.d.ts +0 -26
- package/dist/types/tools/resolve.d.ts +0 -80
- package/dist/types/tools/resource-gc.d.ts +0 -54
- package/dist/types/tools/review.d.ts +0 -63
- package/dist/types/tools/search-tool-bm25.d.ts +0 -65
- package/dist/types/tools/search.d.ts +0 -93
- package/dist/types/tools/skill-discovery.d.ts +0 -40
- package/dist/types/tools/skill.d.ts +0 -48
- package/dist/types/tools/sqlite-reader.d.ts +0 -94
- package/dist/types/tools/ssh.d.ts +0 -67
- package/dist/types/tools/subagent-render.d.ts +0 -31
- package/dist/types/tools/subagent.d.ts +0 -117
- package/dist/types/tools/telegram-send.d.ts +0 -39
- package/dist/types/tools/todo-write.d.ts +0 -120
- package/dist/types/tools/tool-errors.d.ts +0 -33
- package/dist/types/tools/tool-result.d.ts +0 -30
- package/dist/types/tools/tool-timeouts.d.ts +0 -56
- package/dist/types/tools/ultragoal-ask-guard.d.ts +0 -12
- package/dist/types/tools/vim.d.ts +0 -58
- package/dist/types/tools/write.d.ts +0 -59
- package/dist/types/tools/yield.d.ts +0 -25
- package/dist/types/tui/code-cell.d.ts +0 -32
- package/dist/types/tui/file-list.d.ts +0 -22
- package/dist/types/tui/hyperlink.d.ts +0 -42
- package/dist/types/tui/index.d.ts +0 -11
- package/dist/types/tui/output-block.d.ts +0 -28
- package/dist/types/tui/status-line.d.ts +0 -18
- package/dist/types/tui/tree-list.d.ts +0 -19
- package/dist/types/tui/types.d.ts +0 -13
- package/dist/types/tui/utils.d.ts +0 -36
- package/dist/types/utils/changelog.d.ts +0 -37
- package/dist/types/utils/clipboard.d.ts +0 -22
- package/dist/types/utils/cmux-workspace.d.ts +0 -52
- package/dist/types/utils/command-args.d.ts +0 -9
- package/dist/types/utils/commit-message-generator.d.ts +0 -7
- package/dist/types/utils/edit-mode.d.ts +0 -13
- package/dist/types/utils/event-bus.d.ts +0 -6
- package/dist/types/utils/external-editor.d.ts +0 -19
- package/dist/types/utils/file-display-mode.d.ts +0 -27
- package/dist/types/utils/file-mentions.d.ts +0 -25
- package/dist/types/utils/git.d.ts +0 -393
- package/dist/types/utils/image-loading.d.ts +0 -26
- package/dist/types/utils/image-resize.d.ts +0 -39
- package/dist/types/utils/lang-from-path.d.ts +0 -8
- package/dist/types/utils/linkedom.d.ts +0 -4
- package/dist/types/utils/markit.d.ts +0 -7
- package/dist/types/utils/open.d.ts +0 -2
- package/dist/types/utils/pasted-image-path.d.ts +0 -32
- package/dist/types/utils/session-color.d.ts +0 -10
- package/dist/types/utils/shell-snapshot.d.ts +0 -5
- package/dist/types/utils/sixel.d.ts +0 -21
- package/dist/types/utils/title-generator.d.ts +0 -31
- package/dist/types/utils/tool-choice.d.ts +0 -20
- package/dist/types/utils/tools-manager.d.ts +0 -9
- package/dist/types/vim/buffer.d.ts +0 -41
- package/dist/types/vim/commands.d.ts +0 -6
- package/dist/types/vim/engine.d.ts +0 -47
- package/dist/types/vim/parser.d.ts +0 -3
- package/dist/types/vim/render.d.ts +0 -25
- package/dist/types/vim/types.d.ts +0 -182
- package/dist/types/web/insane/bridge.d.ts +0 -103
- package/dist/types/web/insane/url-guard.d.ts +0 -25
- package/dist/types/web/kagi.d.ts +0 -23
- package/dist/types/web/parallel.d.ts +0 -58
- package/dist/types/web/scrapers/artifacthub.d.ts +0 -6
- package/dist/types/web/scrapers/arxiv.d.ts +0 -5
- package/dist/types/web/scrapers/aur.d.ts +0 -5
- package/dist/types/web/scrapers/biorxiv.d.ts +0 -5
- package/dist/types/web/scrapers/bluesky.d.ts +0 -5
- package/dist/types/web/scrapers/brew.d.ts +0 -5
- package/dist/types/web/scrapers/cheatsh.d.ts +0 -8
- package/dist/types/web/scrapers/chocolatey.d.ts +0 -5
- package/dist/types/web/scrapers/choosealicense.d.ts +0 -2
- package/dist/types/web/scrapers/cisa-kev.d.ts +0 -5
- package/dist/types/web/scrapers/clojars.d.ts +0 -5
- package/dist/types/web/scrapers/coingecko.d.ts +0 -5
- package/dist/types/web/scrapers/crates-io.d.ts +0 -5
- package/dist/types/web/scrapers/crossref.d.ts +0 -2
- package/dist/types/web/scrapers/devto.d.ts +0 -5
- package/dist/types/web/scrapers/discogs.d.ts +0 -8
- package/dist/types/web/scrapers/discourse.d.ts +0 -5
- package/dist/types/web/scrapers/dockerhub.d.ts +0 -5
- package/dist/types/web/scrapers/docs-rs.d.ts +0 -2
- package/dist/types/web/scrapers/fdroid.d.ts +0 -5
- package/dist/types/web/scrapers/firefox-addons.d.ts +0 -2
- package/dist/types/web/scrapers/flathub.d.ts +0 -2
- package/dist/types/web/scrapers/github-gist.d.ts +0 -5
- package/dist/types/web/scrapers/github.d.ts +0 -12
- package/dist/types/web/scrapers/gitlab.d.ts +0 -5
- package/dist/types/web/scrapers/go-pkg.d.ts +0 -5
- package/dist/types/web/scrapers/hackage.d.ts +0 -5
- package/dist/types/web/scrapers/hackernews.d.ts +0 -2
- package/dist/types/web/scrapers/hex.d.ts +0 -5
- package/dist/types/web/scrapers/huggingface.d.ts +0 -2
- package/dist/types/web/scrapers/iacr.d.ts +0 -5
- package/dist/types/web/scrapers/index.d.ts +0 -84
- package/dist/types/web/scrapers/jetbrains-marketplace.d.ts +0 -2
- package/dist/types/web/scrapers/lemmy.d.ts +0 -2
- package/dist/types/web/scrapers/lobsters.d.ts +0 -5
- package/dist/types/web/scrapers/mastodon.d.ts +0 -5
- package/dist/types/web/scrapers/maven.d.ts +0 -6
- package/dist/types/web/scrapers/mdn.d.ts +0 -2
- package/dist/types/web/scrapers/metacpan.d.ts +0 -5
- package/dist/types/web/scrapers/musicbrainz.d.ts +0 -5
- package/dist/types/web/scrapers/npm.d.ts +0 -5
- package/dist/types/web/scrapers/nuget.d.ts +0 -5
- package/dist/types/web/scrapers/nvd.d.ts +0 -5
- package/dist/types/web/scrapers/ollama.d.ts +0 -2
- package/dist/types/web/scrapers/open-vsx.d.ts +0 -5
- package/dist/types/web/scrapers/opencorporates.d.ts +0 -5
- package/dist/types/web/scrapers/openlibrary.d.ts +0 -5
- package/dist/types/web/scrapers/orcid.d.ts +0 -5
- package/dist/types/web/scrapers/osv.d.ts +0 -5
- package/dist/types/web/scrapers/packagist.d.ts +0 -5
- package/dist/types/web/scrapers/pub-dev.d.ts +0 -5
- package/dist/types/web/scrapers/pubmed.d.ts +0 -5
- package/dist/types/web/scrapers/pypi.d.ts +0 -5
- package/dist/types/web/scrapers/rawg.d.ts +0 -2
- package/dist/types/web/scrapers/readthedocs.d.ts +0 -2
- package/dist/types/web/scrapers/reddit.d.ts +0 -5
- package/dist/types/web/scrapers/repology.d.ts +0 -5
- package/dist/types/web/scrapers/rfc.d.ts +0 -5
- package/dist/types/web/scrapers/rubygems.d.ts +0 -5
- package/dist/types/web/scrapers/searchcode.d.ts +0 -2
- package/dist/types/web/scrapers/sec-edgar.d.ts +0 -5
- package/dist/types/web/scrapers/semantic-scholar.d.ts +0 -2
- package/dist/types/web/scrapers/snapcraft.d.ts +0 -2
- package/dist/types/web/scrapers/sourcegraph.d.ts +0 -2
- package/dist/types/web/scrapers/spdx.d.ts +0 -5
- package/dist/types/web/scrapers/spotify.d.ts +0 -8
- package/dist/types/web/scrapers/stackoverflow.d.ts +0 -6
- package/dist/types/web/scrapers/terraform.d.ts +0 -5
- package/dist/types/web/scrapers/tldr.d.ts +0 -7
- package/dist/types/web/scrapers/twitter.d.ts +0 -5
- package/dist/types/web/scrapers/types.d.ts +0 -83
- package/dist/types/web/scrapers/utils.d.ts +0 -32
- package/dist/types/web/scrapers/vimeo.d.ts +0 -5
- package/dist/types/web/scrapers/vscode-marketplace.d.ts +0 -5
- package/dist/types/web/scrapers/w3c.d.ts +0 -2
- package/dist/types/web/scrapers/wikidata.d.ts +0 -5
- package/dist/types/web/scrapers/wikipedia.d.ts +0 -5
- package/dist/types/web/scrapers/youtube.d.ts +0 -13
- package/dist/types/web/search/index.d.ts +0 -118
- package/dist/types/web/search/provider.d.ts +0 -55
- package/dist/types/web/search/providers/anthropic.d.ts +0 -32
- package/dist/types/web/search/providers/base.d.ts +0 -90
- package/dist/types/web/search/providers/brave.d.ts +0 -27
- package/dist/types/web/search/providers/codex.d.ts +0 -35
- package/dist/types/web/search/providers/duckduckgo.d.ts +0 -57
- package/dist/types/web/search/providers/exa.d.ts +0 -52
- package/dist/types/web/search/providers/gemini.d.ts +0 -57
- package/dist/types/web/search/providers/insane.d.ts +0 -53
- package/dist/types/web/search/providers/jina.d.ts +0 -26
- package/dist/types/web/search/providers/kagi.d.ts +0 -24
- package/dist/types/web/search/providers/kimi.d.ts +0 -27
- package/dist/types/web/search/providers/openai-compatible.d.ts +0 -9
- package/dist/types/web/search/providers/parallel.d.ts +0 -15
- package/dist/types/web/search/providers/perplexity.d.ts +0 -38
- package/dist/types/web/search/providers/searxng.d.ts +0 -44
- package/dist/types/web/search/providers/synthetic.d.ts +0 -21
- package/dist/types/web/search/providers/tavily.d.ts +0 -29
- package/dist/types/web/search/providers/text-citations.d.ts +0 -23
- package/dist/types/web/search/providers/utils.d.ts +0 -88
- package/dist/types/web/search/providers/xai.d.ts +0 -64
- package/dist/types/web/search/providers/zai.d.ts +0 -28
- package/dist/types/web/search/render.d.ts +0 -36
- package/dist/types/web/search/types.d.ts +0 -372
- package/dist/types/web/search/utils.d.ts +0 -4
- package/dist/types/workflow/workflow-intent-diff.d.ts +0 -25
- package/dist/types/workflow/workflow-intent-report-consumer.d.ts +0 -50
- package/dist/types/workflow/workflow-intent-report-schema.d.ts +0 -2
- package/dist/types/workflow/workflow-intent-report.d.ts +0 -48
- package/dist/types/workspace-tree.d.ts +0 -42
- 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
|
+
}
|