@sema-agent/core 7.60.0 → 7.62.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 +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +138 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +11 -11
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { receiveRetentionPolicy } from "./retention-policy.js";
|
|
3
|
+
import { readMemberGroup } from "./member-group.js";
|
|
2
4
|
export const MAILBOX_DECISIONS = Object.freeze(["held", "approved", "delivered", "denied", "expired", "refused", "dropped"]);
|
|
3
5
|
export function readStoredMailboxDecision(raw) {
|
|
4
6
|
if (raw === undefined)
|
|
@@ -154,6 +156,18 @@ export const MAILBOX_INVALID_RECORD_ID_CODE = "mailbox.invalid_record_id";
|
|
|
154
156
|
export const MAILBOX_DUPLICATE_RECORD_ID_CODE = "mailbox.duplicate_record_id";
|
|
155
157
|
export const MAILBOX_RECORD_ID_MAX_CHARS = 1024;
|
|
156
158
|
export const MAILBOX_REPLAY_FACETS = Object.freeze(["from", "content", "hopChain", "peerMeta"]);
|
|
159
|
+
export const MAILBOX_CONSUMED_ID_WINDOW = 256;
|
|
160
|
+
export function mailboxReplayDigests(record) {
|
|
161
|
+
const out = {};
|
|
162
|
+
for (const f of MAILBOX_REPLAY_FACETS)
|
|
163
|
+
out[f] = createHash("sha256").update(facetSpelling(record[f])).digest("hex");
|
|
164
|
+
return out;
|
|
165
|
+
}
|
|
166
|
+
export function foldMailboxConsumed(window, removed) {
|
|
167
|
+
const entered = removed.flatMap((m) => (m.id !== undefined ? [{ id: m.id, seq: m.seq, digests: mailboxReplayDigests(m) }] : []));
|
|
168
|
+
const next = [...window, ...entered].sort((a, b) => a.seq - b.seq);
|
|
169
|
+
return next.length > MAILBOX_CONSUMED_ID_WINDOW ? next.slice(next.length - MAILBOX_CONSUMED_ID_WINDOW) : next;
|
|
170
|
+
}
|
|
157
171
|
export function readMailboxRecordId(raw) {
|
|
158
172
|
if (raw === undefined)
|
|
159
173
|
return undefined;
|
|
@@ -187,16 +201,21 @@ function facetSpelling(v) {
|
|
|
187
201
|
return `[${Array.from(v, facetSpelling).join(",")}]`;
|
|
188
202
|
return `{${Object.keys(v).filter((k) => v[k] !== undefined).sort().map((k) => `${JSON.stringify(k)}:${facetSpelling(v[k])}`).join(",")}}`;
|
|
189
203
|
}
|
|
190
|
-
export function judgeMailboxAppendById(
|
|
204
|
+
export function judgeMailboxAppendById(box, msg) {
|
|
191
205
|
if (msg.id === undefined)
|
|
192
206
|
return undefined;
|
|
193
|
-
const
|
|
207
|
+
const holding = box.held.find((m) => m.id === msg.id);
|
|
208
|
+
const prior = holding !== undefined ? { seq: holding.seq, digests: mailboxReplayDigests(holding) } : box.consumed.find((c) => c.id === msg.id);
|
|
194
209
|
if (prior === undefined)
|
|
195
210
|
return undefined;
|
|
196
|
-
const
|
|
211
|
+
const asked = mailboxReplayDigests(msg);
|
|
212
|
+
const differs = MAILBOX_REPLAY_FACETS.filter((f) => prior.digests[f] !== asked[f]);
|
|
197
213
|
if (differs.length === 0)
|
|
198
214
|
return prior.seq;
|
|
199
|
-
throw new MailboxStoreError(MAILBOX_DUPLICATE_RECORD_ID_CODE, `MailboxStore.append: the box already holds a different record under this id (it differs in: ${differs.join(", ")}) — a new message takes a new id; an identical repeat would have been a replay`);
|
|
215
|
+
throw new MailboxStoreError(MAILBOX_DUPLICATE_RECORD_ID_CODE, `MailboxStore.append: the box already ${holding !== undefined ? "holds" : "received"} a different record under this id (it differs in: ${differs.join(", ")}) — a new message takes a new id; an identical repeat would have been a replay`);
|
|
216
|
+
}
|
|
217
|
+
export function mailboxRecipientLifecycleOf(store) {
|
|
218
|
+
return readMemberGroup("MailboxStore", store, ["retireRecipient", "listRetiredRecipients"]);
|
|
200
219
|
}
|
|
201
220
|
export function mailboxCrossProcessMountVerdict(store) {
|
|
202
221
|
const declared = store.crossProcessSafe;
|
|
@@ -226,6 +245,7 @@ export function detachMailboxMessage(m) {
|
|
|
226
245
|
...(m.peerMeta !== undefined ? { peerMeta: cloneMailboxPeerMeta(m.peerMeta) } : {}),
|
|
227
246
|
};
|
|
228
247
|
}
|
|
248
|
+
export const MAILBOX_REAP_KNOBS = Object.freeze(["maxAgeMs"]);
|
|
229
249
|
export class InMemoryMailboxStore {
|
|
230
250
|
crossProcessSafe = false;
|
|
231
251
|
boxes = new Map();
|
|
@@ -239,7 +259,7 @@ export class InMemoryMailboxStore {
|
|
|
239
259
|
const k = this.key(scope, handle);
|
|
240
260
|
let b = this.boxes.get(k);
|
|
241
261
|
if (!b) {
|
|
242
|
-
b = { scope, messages: [], nextSeq: 1 };
|
|
262
|
+
b = { scope, messages: [], nextSeq: 1, consumed: [] };
|
|
243
263
|
this.boxes.set(k, b);
|
|
244
264
|
}
|
|
245
265
|
return b;
|
|
@@ -249,7 +269,7 @@ export class InMemoryMailboxStore {
|
|
|
249
269
|
throw new Error("MailboxStore.append: refusing a message without a scope");
|
|
250
270
|
const record = readMailboxAppend(msg);
|
|
251
271
|
const b = this.box(scope, handle);
|
|
252
|
-
const held = judgeMailboxAppendById(b.messages, record);
|
|
272
|
+
const held = judgeMailboxAppendById({ held: b.messages, consumed: b.consumed }, record);
|
|
253
273
|
if (held !== undefined)
|
|
254
274
|
return held;
|
|
255
275
|
const seq = b.nextSeq++;
|
|
@@ -272,6 +292,7 @@ export class InMemoryMailboxStore {
|
|
|
272
292
|
return { acked: false };
|
|
273
293
|
if (b.lease === undefined || b.lease.owner !== owner)
|
|
274
294
|
return { acked: false };
|
|
295
|
+
b.consumed = foldMailboxConsumed(b.consumed, b.messages.filter((m) => m.seq <= upToSeq));
|
|
275
296
|
b.messages = b.messages.filter((m) => m.seq > upToSeq);
|
|
276
297
|
if (b.lease.maxSeq <= upToSeq)
|
|
277
298
|
b.lease = undefined;
|
|
@@ -299,15 +320,15 @@ export class InMemoryMailboxStore {
|
|
|
299
320
|
this.boxes.delete(this.key(scope, handle));
|
|
300
321
|
}
|
|
301
322
|
async reap(scope, now, opts) {
|
|
302
|
-
|
|
303
|
-
if (
|
|
323
|
+
const policy = receiveRetentionPolicy("MailboxStore.reap", opts, MAILBOX_REAP_KNOBS);
|
|
324
|
+
if (policy.maxAgeMs === undefined)
|
|
304
325
|
return 0;
|
|
305
326
|
let dropped = 0;
|
|
306
327
|
for (const b of this.boxes.values()) {
|
|
307
328
|
if (b.scope !== scope)
|
|
308
329
|
continue;
|
|
309
330
|
const newest = newestSentAt(b.messages);
|
|
310
|
-
if (newest !== undefined && newest < now -
|
|
331
|
+
if (newest !== undefined && newest < now - policy.maxAgeMs) {
|
|
311
332
|
b.messages = [];
|
|
312
333
|
b.lease = undefined;
|
|
313
334
|
dropped++;
|
|
@@ -19,32 +19,18 @@
|
|
|
19
19
|
* peer seat's, asked under this same identity, so every holder of a connection sends what the one seat answers for it. A server that opted in to elicitation never enters the pool — the
|
|
20
20
|
* answer to its questions belongs to the leg that is waiting on it.
|
|
21
21
|
*/
|
|
22
|
-
import type { Client } from "@modelcontextprotocol/
|
|
22
|
+
import type { Client } from "@modelcontextprotocol/client";
|
|
23
23
|
import { ConnectionListing, type LenientListedTool } from "./mcp-server-link.js";
|
|
24
24
|
import type { McpServerSpec } from "./mcp-server-spec.js";
|
|
25
|
-
/** The
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
readonly outputSchema?: unknown;
|
|
29
|
-
readonly execution?: unknown;
|
|
30
|
-
}
|
|
31
|
-
/** Records one `tools/list` result on a pooled connection (see {@link McpLease.openListing}): the tools the leg mounted from it, of which
|
|
32
|
-
* `retained` names the ones the listing did not return (an incomplete walk keeps them mounted) — those join the membership only. */
|
|
33
|
-
export type McpListingWriter = (tools: ReadonlyArray<McpToolMeta>, apply: (all: McpToolMeta[]) => void, retained?: ReadonlySet<string>) => void;
|
|
25
|
+
/** The engine's own dial of `client` under `key` (the key {@link McpConnectionPool.keyOf} gives its declaration): the one connection a pool
|
|
26
|
+
* entry for that key may take. */
|
|
27
|
+
export declare function recordEngineDial(client: Client, key: string): void;
|
|
34
28
|
/** One leg's hold on a pooled connection. */
|
|
35
29
|
export interface McpLease {
|
|
36
30
|
readonly client: Client;
|
|
37
|
-
/** The connection's listing, one record shared by every holder (mcp-server-link.ts `ConnectionListing`)
|
|
31
|
+
/** The connection's listing, one record shared by every holder (mcp-server-link.ts `ConnectionListing`): what every holder's tools are
|
|
32
|
+
* checked against and what their calls hand the SDK as the tool's definition, each through its own leg's intake. */
|
|
38
33
|
readonly listing: ConnectionListing<LenientListedTool>;
|
|
39
|
-
/**
|
|
40
|
-
* Open a `tools/list` round trip on the connection — call it BEFORE the request. The returned writer records the result twice over:
|
|
41
|
-
* as the connection's metadata for each listed tool, at this listing's version (its place in the order listings were opened on the
|
|
42
|
-
* connection: a listing opened earlier never overwrites what a later one wrote, whichever answer arrives first; an entry the listing
|
|
43
|
-
* did not return — `retained` — writes no record), and as THIS leg's membership (the names it mounted). It then rewrites the client's per-connection tool cache with the current metadata of every name
|
|
44
|
-
* some holder mounted: the SDK clears and refills that cache on each write, so a leg that mounted a subset must not erase what its
|
|
45
|
-
* siblings' tools need. A release changes the membership only and rewrites the cache from the same metadata.
|
|
46
|
-
*/
|
|
47
|
-
openListing(): McpListingWriter;
|
|
48
34
|
/** Run `fn` when the connection closes under the lease (the server died, the transport dropped). Never called for this lease's own release. */
|
|
49
35
|
onClose(fn: () => void): void;
|
|
50
36
|
/** Give the hold back; the last holder's release closes the connection. Idempotent. */
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
import { canonicalize } from "./canonical-json.js";
|
|
2
2
|
import { ConnectionListing } from "./mcp-server-link.js";
|
|
3
3
|
import { carrierOf } from "./peer-seat.js";
|
|
4
|
+
const ENGINE_DIALS = new WeakMap();
|
|
5
|
+
export function recordEngineDial(client, key) {
|
|
6
|
+
ENGINE_DIALS.set(client, { key, entered: false });
|
|
7
|
+
}
|
|
4
8
|
export class McpConnectionPool {
|
|
5
9
|
entries = new Map();
|
|
6
10
|
dialing = new Map();
|
|
@@ -105,7 +109,12 @@ export class McpConnectionPool {
|
|
|
105
109
|
}
|
|
106
110
|
async dialNew(key, generation, dial) {
|
|
107
111
|
const client = await dial();
|
|
108
|
-
const
|
|
112
|
+
const dialled = ENGINE_DIALS.get(client);
|
|
113
|
+
if (dialled === undefined || dialled.key !== key || dialled.entered) {
|
|
114
|
+
throw Object.assign(new Error("McpConnectionPool: the dial answered a connection the engine did not dial for this declaration (a client built elsewhere, dialled for another declaration or principal, or already held by a pool entry) — refused, the pool keeps nothing of it; the pool holds only connections the engine dials itself"), { code: "config.mcp_pool_foreign_connection" });
|
|
115
|
+
}
|
|
116
|
+
dialled.entered = true;
|
|
117
|
+
const entry = { client, listing: new ConnectionListing(), refs: 0, listeners: new Set(), current: true, closed: false };
|
|
109
118
|
client.onclose = () => {
|
|
110
119
|
entry.closed = true;
|
|
111
120
|
if (this.entries.get(key) === entry)
|
|
@@ -128,10 +137,6 @@ export class McpConnectionPool {
|
|
|
128
137
|
entry.refs++;
|
|
129
138
|
const mine = new Set();
|
|
130
139
|
let released = false;
|
|
131
|
-
const cached = () => {
|
|
132
|
-
const held = new Set([...entry.holders.values()].flat());
|
|
133
|
-
return [...entry.meta].filter(([name]) => held.has(name)).map(([, r]) => r.tool);
|
|
134
|
-
};
|
|
135
140
|
const lease = {
|
|
136
141
|
client: entry.client,
|
|
137
142
|
listing: entry.listing,
|
|
@@ -139,27 +144,6 @@ export class McpConnectionPool {
|
|
|
139
144
|
mine.add(fn);
|
|
140
145
|
entry.listeners.add(fn);
|
|
141
146
|
},
|
|
142
|
-
openListing: () => {
|
|
143
|
-
const version = entry.nextVersion++;
|
|
144
|
-
return (tools, apply, retained) => {
|
|
145
|
-
for (const tool of tools) {
|
|
146
|
-
const prior = entry.meta.get(tool.name);
|
|
147
|
-
if (retained?.has(tool.name) === true) {
|
|
148
|
-
if (prior === undefined)
|
|
149
|
-
entry.meta.set(tool.name, { tool, version: -1 });
|
|
150
|
-
continue;
|
|
151
|
-
}
|
|
152
|
-
if (prior !== undefined && prior.version > version)
|
|
153
|
-
continue;
|
|
154
|
-
entry.meta.delete(tool.name);
|
|
155
|
-
entry.meta.set(tool.name, { tool, version });
|
|
156
|
-
}
|
|
157
|
-
if (!released)
|
|
158
|
-
entry.holders.set(lease, tools.map((t) => t.name));
|
|
159
|
-
entry.apply = apply;
|
|
160
|
-
apply(cached());
|
|
161
|
-
};
|
|
162
|
-
},
|
|
163
147
|
release: async () => {
|
|
164
148
|
if (released)
|
|
165
149
|
return;
|
|
@@ -167,8 +151,6 @@ export class McpConnectionPool {
|
|
|
167
151
|
for (const fn of mine)
|
|
168
152
|
entry.listeners.delete(fn);
|
|
169
153
|
entry.refs--;
|
|
170
|
-
if (entry.holders.delete(lease) && entry.refs > 0)
|
|
171
|
-
entry.apply?.(cached());
|
|
172
154
|
if (entry.refs > 0)
|
|
173
155
|
return;
|
|
174
156
|
entry.current = false;
|
|
@@ -8,7 +8,7 @@ import type { McpTransportKind } from "./mcp-server-spec.js";
|
|
|
8
8
|
* request: the request provably never left;
|
|
9
9
|
* · `connection_failed` — any other errno / undici code on the cause chain (a reset or a timeout
|
|
10
10
|
* mid-exchange): the request may have run;
|
|
11
|
-
* · `connection_closed` — the SDK reported the transport closed (`
|
|
11
|
+
* · `connection_closed` — the SDK reported the transport closed (`SdkError` `ConnectionClosed`): in
|
|
12
12
|
* flight the fate is unknowable, and for a server already known dead the
|
|
13
13
|
* request was never attempted — the two are told apart by `delivered`;
|
|
14
14
|
* · `unauthorized` — the principal must authorize this server before it serves them: the endpoint
|
|
@@ -31,9 +31,11 @@ import type { McpTransportKind } from "./mcp-server-spec.js";
|
|
|
31
31
|
* answer in time, or answered something the engine cannot carry): that request
|
|
32
32
|
* was not sent — a fault for the deployment to fix, not an outage of the server;
|
|
33
33
|
* · `host_refused` — the host seat of a host-supplied transport (mcp-host-seat.ts) did not hand the request to the
|
|
34
|
-
* remote
|
|
34
|
+
* remote, or handed its dial no pipe the engine could take (it said so, or what it handed is no
|
|
35
|
+
* transport or was already taken): nothing ran, and nothing is said about whether the remote can be
|
|
36
|
+
* reached;
|
|
35
37
|
* · `unknown` — the thrown value carried no structure this table reads, or the host seat took the request
|
|
36
|
-
* and cannot tell how it ended.
|
|
38
|
+
* and cannot tell how it ended (said at the dial, nothing of the caller's was sent either way).
|
|
37
39
|
*/
|
|
38
40
|
export declare const MCP_FAILURE_KINDS: readonly ["connect_refused", "connection_failed", "connection_closed", "unauthorized", "http_status", "not_mcp_response", "spawn_failed", "timeout", "protocol", "invalid_config", "credential_unavailable", "host_refused", "unknown"];
|
|
39
41
|
export type McpFailureKind = (typeof MCP_FAILURE_KINDS)[number];
|
|
@@ -240,16 +242,74 @@ export declare function failureFields(of: McpFailure | Partial<McpFailureFields>
|
|
|
240
242
|
*/
|
|
241
243
|
export declare function networkErrorCode(err: unknown, depth?: number): string | undefined;
|
|
242
244
|
/** What a row reads OFF the thrown value: the failure's class, the status the `http_status` class carries, the authorization fact
|
|
243
|
-
* the `unauthorized` class carries, and `unsent` — the thrown value is
|
|
244
|
-
* furnish the request: {@link PeerSeatFailure}
|
|
245
|
-
*
|
|
246
|
-
* ({@link DELIVERED_BY_KIND} + {@link classifyMcpFailure}),
|
|
245
|
+
* the `unauthorized` class carries, and `unsent` — the thrown value is a refusal on THIS side to send (the peer seat did not
|
|
246
|
+
* furnish the request: {@link PeerSeatFailure}; the SDK refused it before anything reached the transport: {@link SDK_ERROR_READINGS}),
|
|
247
|
+
* a structural fact about our side of the exchange that makes the verdict `"no"` whatever the class. A row does NOT write the delivery
|
|
248
|
+
* verdict — that follows from the kind, `unsent` and the SITE, in one place ({@link DELIVERED_BY_KIND} + {@link classifyMcpFailure}),
|
|
249
|
+
* so a row cannot spell it wrong. */
|
|
247
250
|
export type McpFailureClass = {
|
|
248
251
|
kind: McpFailureKind;
|
|
249
252
|
httpStatus?: number;
|
|
250
253
|
authorization?: McpAuthorization;
|
|
251
254
|
unsent?: true;
|
|
252
255
|
};
|
|
256
|
+
export declare const SDK_ERROR_READINGS: {
|
|
257
|
+
readonly NOT_CONNECTED: {
|
|
258
|
+
readonly kind: "connection_closed";
|
|
259
|
+
readonly unsent: true;
|
|
260
|
+
};
|
|
261
|
+
readonly ALREADY_CONNECTED: {
|
|
262
|
+
readonly kind: "unknown";
|
|
263
|
+
};
|
|
264
|
+
readonly NOT_INITIALIZED: {
|
|
265
|
+
readonly kind: "unknown";
|
|
266
|
+
};
|
|
267
|
+
readonly CAPABILITY_NOT_SUPPORTED: {
|
|
268
|
+
readonly kind: "unknown";
|
|
269
|
+
};
|
|
270
|
+
readonly REQUEST_TIMEOUT: {
|
|
271
|
+
readonly kind: "timeout";
|
|
272
|
+
};
|
|
273
|
+
readonly CONNECTION_CLOSED: {
|
|
274
|
+
readonly kind: "connection_closed";
|
|
275
|
+
};
|
|
276
|
+
readonly SEND_FAILED: {
|
|
277
|
+
readonly kind: "unknown";
|
|
278
|
+
};
|
|
279
|
+
readonly INVALID_RESULT: {
|
|
280
|
+
readonly kind: "protocol";
|
|
281
|
+
};
|
|
282
|
+
readonly UNSUPPORTED_RESULT_TYPE: {
|
|
283
|
+
readonly kind: "protocol";
|
|
284
|
+
};
|
|
285
|
+
readonly INPUT_REQUIRED_ROUNDS_EXCEEDED: {
|
|
286
|
+
readonly kind: "protocol";
|
|
287
|
+
};
|
|
288
|
+
readonly LIST_PAGINATION_EXCEEDED: {
|
|
289
|
+
readonly kind: "protocol";
|
|
290
|
+
};
|
|
291
|
+
readonly METHOD_NOT_SUPPORTED_BY_PROTOCOL_VERSION: {
|
|
292
|
+
readonly kind: "protocol";
|
|
293
|
+
readonly unsent: true;
|
|
294
|
+
};
|
|
295
|
+
readonly ERA_NEGOTIATION_FAILED: {
|
|
296
|
+
readonly kind: "unknown";
|
|
297
|
+
};
|
|
298
|
+
readonly CLIENT_HTTP_NOT_IMPLEMENTED: "status";
|
|
299
|
+
readonly CLIENT_HTTP_AUTHENTICATION: {
|
|
300
|
+
readonly kind: "unauthorized";
|
|
301
|
+
readonly reason: "rejected";
|
|
302
|
+
};
|
|
303
|
+
readonly CLIENT_HTTP_FORBIDDEN: {
|
|
304
|
+
readonly kind: "unauthorized";
|
|
305
|
+
readonly reason: "scope";
|
|
306
|
+
};
|
|
307
|
+
readonly CLIENT_HTTP_UNEXPECTED_CONTENT: {
|
|
308
|
+
readonly kind: "not_mcp_response";
|
|
309
|
+
};
|
|
310
|
+
readonly CLIENT_HTTP_FAILED_TO_OPEN_STREAM: "status";
|
|
311
|
+
readonly CLIENT_HTTP_FAILED_TO_TERMINATE_SESSION: "status";
|
|
312
|
+
};
|
|
253
313
|
/** One row of the classifier: `when` reads structure only; `reads` names the class it saw. */
|
|
254
314
|
export interface McpFailureRule {
|
|
255
315
|
/** The row's name, for the discrimination pins (one pin per row) and for a reader of a verdict. */
|
|
@@ -259,10 +319,11 @@ export interface McpFailureRule {
|
|
|
259
319
|
}
|
|
260
320
|
/**
|
|
261
321
|
* The ORDERED classifier. First match wins; the final row matches everything. The order is part of
|
|
262
|
-
* the contract —
|
|
263
|
-
*
|
|
264
|
-
*
|
|
265
|
-
* (a
|
|
322
|
+
* the contract — this side's own refusals first (the peer seat's; the request fetch's reading of a
|
|
323
|
+
* refused authorization), then the SDK's typed errors, because they say where the failure arose (a
|
|
324
|
+
* `ProtocolError` is never a transport failure, whatever its text says; an `SdkError` reads by its code),
|
|
325
|
+
* then the cause-chain codes from most specific (a configuration fault, a spawn) to least (a
|
|
326
|
+
* connect-phase errno, any other network code).
|
|
266
327
|
*/
|
|
267
328
|
export declare const FAILURE_CLASSIFIER: ReadonlyArray<McpFailureRule>;
|
|
268
329
|
/**
|
|
@@ -291,21 +352,21 @@ export declare function readMcpFailure(err: unknown, at: McpFailureSite): {
|
|
|
291
352
|
export interface McpUnavailableEntry extends AnnouncedMcpFailure {
|
|
292
353
|
authorization?: McpAuthorization;
|
|
293
354
|
}
|
|
294
|
-
/** Where the user authorizes, as every model-facing line names it: the seat's URL
|
|
355
|
+
/** Where the user authorizes, as every model-facing line names it: the seat's URL when the seat gave one, else only that none was given. */
|
|
295
356
|
export declare function whereToAuthorize(authorizeUrl: string | undefined): string;
|
|
296
357
|
/**
|
|
297
358
|
* The `mcp_unavailable` frame's needs-authorization arm — the servers among `entries` whose failure record carries `authorization`, or
|
|
298
359
|
* `undefined` when there are none. CC 2.1.309's arm, minted as `needsAuthMcpServers` (cli309.js:265582), read back as `needsAuthMcpServers` (cli309.js:267398),
|
|
299
360
|
* worded (cli309.js:267399) "The following MCP servers require authentication before their tools can be used" — ahead of the
|
|
300
361
|
* failed-to-connect arm; this engine never runs an authorization flow itself, so it is always the reference's cannot-start-the-flow form.
|
|
301
|
-
* `<where>` is the deployment seat's `authorizeUrl` when it gave one (listed beside the server), else the
|
|
362
|
+
* `<where>` is the deployment seat's `authorizeUrl` when it gave one (listed beside the server), else only the fact that none was given; no error
|
|
302
363
|
* text rides it (the fact is the record's). At most `max` servers are named, the rest counted.
|
|
303
364
|
*/
|
|
304
365
|
export declare function needsAuthorizationArm(entries: readonly McpUnavailableEntry[], max: number): string | undefined;
|
|
305
366
|
/**
|
|
306
367
|
* The model's line for a request refused as `unauthorized` — the call-time twin of the needs-authorization arm the `mcp_unavailable`
|
|
307
368
|
* frame carries for a server that could not mount (turn-attachments.ts): who must act (the user), where ({@link whereToAuthorize}: the
|
|
308
|
-
* seat's URL
|
|
369
|
+
* seat's URL, or that none was given), what not to ask for, and the delivery tail (`writeTail`, the caller's write-class sentence) the verdict owes. A 401
|
|
309
370
|
* after which the deployment answered another credential that no request has carried yet (`renewed`: the first attempt, not sent again)
|
|
310
371
|
* may pass on a new call: the line says so, and that only a refusal of that call too is the user's — a seat that answers a fresh
|
|
311
372
|
* credential every time still reaches the user. A re-send refused again is the plain line.
|
|
@@ -314,7 +375,7 @@ export declare function unauthorizedLine(what: string, serverLabel: string, a: M
|
|
|
314
375
|
/**
|
|
315
376
|
* What a transport-level HTTP failure can be said to be, in words for a model-facing line: the
|
|
316
377
|
* condition to name, and the delivery verdict. `undefined` for every failure that is NOT of the HTTP
|
|
317
|
-
* transport family (
|
|
378
|
+
* transport family (a ProtocolError is an answer FROM the server; a bare error with no structure is
|
|
318
379
|
* `unknown` and gets no transport story). Shared with the A2A client leg, which faces the SAME `fetch`
|
|
319
380
|
* layer and owes the same outcome contract — one classifier, so the two protocols cannot drift on what
|
|
320
381
|
* "the request never reached them" means.
|
package/dist/core/mcp-failure.js
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
|
|
1
|
+
import { ProtocolError, SdkError, SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
|
|
3
2
|
import { proxyTunnelRefusedSentence, readConnectFailure } from "../brain/errors.js";
|
|
4
3
|
import { PeerAuthorizationRefused, PeerSeatFailure } from "./peer-seat.js";
|
|
5
4
|
import { hostSeatVerdictOf } from "./mcp-host-seat.js";
|
|
@@ -84,7 +83,7 @@ const NETWORK_CODES_NEVER_DELIVERED = new Set([
|
|
|
84
83
|
export function networkErrorCode(err, depth = 0) {
|
|
85
84
|
if (depth > 5 || !(err instanceof Error))
|
|
86
85
|
return undefined;
|
|
87
|
-
const code = err.code;
|
|
86
|
+
const code = err instanceof SdkError ? undefined : err.code;
|
|
88
87
|
if (typeof code === "string" && /^(?:E[A-Z_]+|UND_ERR_[A-Z_]+)$/.test(code))
|
|
89
88
|
return code;
|
|
90
89
|
if (err instanceof AggregateError) {
|
|
@@ -98,6 +97,43 @@ export function networkErrorCode(err, depth = 0) {
|
|
|
98
97
|
}
|
|
99
98
|
const isNodeErrCode = (code) => code.startsWith("ERR_");
|
|
100
99
|
const isDeclarationFault = (code) => code === "ERR_INVALID_URL" || (typeof code === "string" && code.startsWith("config."));
|
|
100
|
+
export const SDK_ERROR_READINGS = {
|
|
101
|
+
[SdkErrorCode.NotConnected]: { kind: "connection_closed", unsent: true },
|
|
102
|
+
[SdkErrorCode.AlreadyConnected]: { kind: "unknown" },
|
|
103
|
+
[SdkErrorCode.NotInitialized]: { kind: "unknown" },
|
|
104
|
+
[SdkErrorCode.CapabilityNotSupported]: { kind: "unknown" },
|
|
105
|
+
[SdkErrorCode.RequestTimeout]: { kind: "timeout" },
|
|
106
|
+
[SdkErrorCode.ConnectionClosed]: { kind: "connection_closed" },
|
|
107
|
+
[SdkErrorCode.SendFailed]: { kind: "unknown" },
|
|
108
|
+
[SdkErrorCode.InvalidResult]: { kind: "protocol" },
|
|
109
|
+
[SdkErrorCode.UnsupportedResultType]: { kind: "protocol" },
|
|
110
|
+
[SdkErrorCode.InputRequiredRoundsExceeded]: { kind: "protocol" },
|
|
111
|
+
[SdkErrorCode.ListPaginationExceeded]: { kind: "protocol" },
|
|
112
|
+
[SdkErrorCode.MethodNotSupportedByProtocolVersion]: { kind: "protocol", unsent: true },
|
|
113
|
+
[SdkErrorCode.EraNegotiationFailed]: { kind: "unknown" },
|
|
114
|
+
[SdkErrorCode.ClientHttpNotImplemented]: "status",
|
|
115
|
+
[SdkErrorCode.ClientHttpAuthentication]: { kind: "unauthorized", reason: "rejected" },
|
|
116
|
+
[SdkErrorCode.ClientHttpForbidden]: { kind: "unauthorized", reason: "scope" },
|
|
117
|
+
[SdkErrorCode.ClientHttpUnexpectedContent]: { kind: "not_mcp_response" },
|
|
118
|
+
[SdkErrorCode.ClientHttpFailedToOpenStream]: "status",
|
|
119
|
+
[SdkErrorCode.ClientHttpFailedToTerminateSession]: "status",
|
|
120
|
+
};
|
|
121
|
+
function httpStatusClass(err) {
|
|
122
|
+
const status = err instanceof SdkHttpError ? err.status : undefined;
|
|
123
|
+
if (status === 401)
|
|
124
|
+
return { kind: "unauthorized", authorization: { reason: "rejected" } };
|
|
125
|
+
return typeof status === "number" && Number.isInteger(status) && status > 0 ? { kind: "http_status", httpStatus: status } : { kind: "not_mcp_response" };
|
|
126
|
+
}
|
|
127
|
+
function sdkErrorClass(err) {
|
|
128
|
+
const reading = SDK_ERROR_READINGS[err.code];
|
|
129
|
+
if (reading === undefined)
|
|
130
|
+
return { kind: "unknown" };
|
|
131
|
+
if (reading === "status")
|
|
132
|
+
return httpStatusClass(err);
|
|
133
|
+
if (reading.kind === "unauthorized")
|
|
134
|
+
return { kind: "unauthorized", authorization: { reason: reading.reason } };
|
|
135
|
+
return { kind: reading.kind, ...(reading.unsent === true ? { unsent: true } : {}) };
|
|
136
|
+
}
|
|
101
137
|
export const FAILURE_CLASSIFIER = [
|
|
102
138
|
{
|
|
103
139
|
name: "peer seat answered the principal is not authorized",
|
|
@@ -110,42 +146,28 @@ export const FAILURE_CLASSIFIER = [
|
|
|
110
146
|
reads: () => ({ kind: "credential_unavailable", unsent: true }),
|
|
111
147
|
},
|
|
112
148
|
{
|
|
113
|
-
name: "
|
|
114
|
-
when: (err) =>
|
|
115
|
-
reads: (err) =>
|
|
149
|
+
name: "http endpoint refused the authorization",
|
|
150
|
+
when: (err) => err instanceof PeerAuthorizationRefused,
|
|
151
|
+
reads: (err) => {
|
|
152
|
+
const refused = err;
|
|
153
|
+
return { kind: "unauthorized", authorization: authorizationOf(refused.reason, refused.authorizeUrl, refused.resourceMetadataUrl) };
|
|
154
|
+
},
|
|
116
155
|
},
|
|
117
156
|
{
|
|
118
|
-
name: "
|
|
119
|
-
when: (err) => err
|
|
120
|
-
reads: () => ({ kind: "
|
|
157
|
+
name: "host seat did not carry the request",
|
|
158
|
+
when: (err) => hostSeatVerdictOf(err) !== undefined,
|
|
159
|
+
reads: (err) => ({ kind: hostSeatVerdictOf(err)?.delivered === "no" ? "host_refused" : "unknown" }),
|
|
121
160
|
},
|
|
122
161
|
{
|
|
123
|
-
name: "sdk
|
|
124
|
-
when: (err) => err instanceof
|
|
125
|
-
reads: () => (
|
|
162
|
+
name: "sdk error read by its code",
|
|
163
|
+
when: (err) => err instanceof SdkError,
|
|
164
|
+
reads: (err) => sdkErrorClass(err),
|
|
126
165
|
},
|
|
127
166
|
{
|
|
128
167
|
name: "server answered with a protocol error",
|
|
129
|
-
when: (err) => err instanceof
|
|
168
|
+
when: (err) => err instanceof ProtocolError,
|
|
130
169
|
reads: () => ({ kind: "protocol" }),
|
|
131
170
|
},
|
|
132
|
-
{
|
|
133
|
-
name: "http endpoint refused the authorization",
|
|
134
|
-
when: (err) => err instanceof StreamableHTTPError && (err.code === 401 || err instanceof PeerAuthorizationRefused),
|
|
135
|
-
reads: (err) => err instanceof PeerAuthorizationRefused
|
|
136
|
-
? { kind: "unauthorized", authorization: authorizationOf(err.reason, err.authorizeUrl, err.resourceMetadataUrl) }
|
|
137
|
-
: { kind: "unauthorized", authorization: { reason: "rejected" } },
|
|
138
|
-
},
|
|
139
|
-
{
|
|
140
|
-
name: "http endpoint answered a status",
|
|
141
|
-
when: (err) => err instanceof StreamableHTTPError && typeof err.code === "number" && err.code > 0,
|
|
142
|
-
reads: (err) => ({ kind: "http_status", httpStatus: err.code }),
|
|
143
|
-
},
|
|
144
|
-
{
|
|
145
|
-
name: "http endpoint answered a non-mcp payload",
|
|
146
|
-
when: (err) => err instanceof StreamableHTTPError,
|
|
147
|
-
reads: () => ({ kind: "not_mcp_response" }),
|
|
148
|
-
},
|
|
149
171
|
{
|
|
150
172
|
name: "malformed declaration",
|
|
151
173
|
when: (err, at) => at.phase === "connect" && err instanceof Error && isDeclarationFault(err.code),
|
|
@@ -199,19 +221,24 @@ export function readMcpFailure(err, at) {
|
|
|
199
221
|
function authorizationOf(reason, authorizeUrl, resourceMetadataUrl) {
|
|
200
222
|
return { reason, ...(authorizeUrl !== undefined ? { authorizeUrl } : {}), ...(resourceMetadataUrl !== undefined ? { resourceMetadataUrl } : {}) };
|
|
201
223
|
}
|
|
224
|
+
const NO_AUTHORIZATION_ADDRESS = "no authorization address was given";
|
|
202
225
|
export function whereToAuthorize(authorizeUrl) {
|
|
203
|
-
return authorizeUrl !== undefined ? `at ${authorizeUrl}` :
|
|
226
|
+
return authorizeUrl !== undefined ? `at ${authorizeUrl}` : `(${NO_AUTHORIZATION_ADDRESS})`;
|
|
204
227
|
}
|
|
205
228
|
export function needsAuthorizationArm(entries, max) {
|
|
206
229
|
const named = entries.filter((f) => f.authorization !== undefined);
|
|
207
230
|
if (named.length === 0)
|
|
208
231
|
return undefined;
|
|
209
232
|
const withUrl = named.filter((f) => f.authorization?.authorizeUrl !== undefined).length;
|
|
210
|
-
const where = withUrl === named.length
|
|
233
|
+
const where = withUrl === named.length
|
|
234
|
+
? "— at the address listed beside it —"
|
|
235
|
+
: withUrl === 0
|
|
236
|
+
? whereToAuthorize(undefined)
|
|
237
|
+
: "— at the address listed beside it (a server listed without one was given no authorization address) —";
|
|
211
238
|
const lines = named.slice(0, max).map((f) => `${f.name}${f.authorization?.authorizeUrl !== undefined ? ` — authorize ${whereToAuthorize(f.authorization.authorizeUrl)}` : ""}`);
|
|
212
239
|
return (`The following MCP servers require authentication before their tools can be used:\n${lines.join("\n")}${named.length > max ? `\n…and ${named.length - max} more` : ""}\n\n` +
|
|
213
240
|
`You cannot start the authorization flow yourself. If the user's request depends on one of these servers (even if they didn't name it explicitly), ` +
|
|
214
|
-
`or they ask about it, tell them that it needs to be authorized
|
|
241
|
+
`or they ask about it, tell them that it needs to be authorized ${where} and that the capability is unavailable until they do. ` +
|
|
215
242
|
`Otherwise carry on with the request and do not mention these servers. Do not ask the user for authorization codes, tokens, or callback URLs.`);
|
|
216
243
|
}
|
|
217
244
|
export function unauthorizedLine(what, serverLabel, a, renewed, writeTail) {
|