@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,29 +1,55 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The host seat:
|
|
3
|
-
* ({@link import("./mcp-server-spec.js").McpServerSpec}). The
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
* trusted channel only (`RunInternals.mcpHostSeats`, keyed by the declaration's `name`), never a spec, a checkpoint or a
|
|
7
|
-
* retained child's snapshot.
|
|
2
|
+
* The host seat: the source of the MCP pipe the HOST supplies for one leg, mounted by a declaration whose transport is `{ kind: "host" }`
|
|
3
|
+
* ({@link import("./mcp-server-spec.js").McpServerSpec}). The declaration is data (it rides `TaskSpec.mcp`, the wiring manifest and a
|
|
4
|
+
* resume config like any other entry); the seat is a live object and rides the trusted channel only (`RunInternals.mcpHostSeats`, keyed
|
|
5
|
+
* by the declaration's `name`), never a spec, a checkpoint or a retained child's snapshot.
|
|
8
6
|
*
|
|
9
|
-
* A
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
* ·
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
7
|
+
* A seat hands one MCP SDK `Transport` per dial ({@link McpHostSeat.open}); the server behind it answers the whole protocol itself — its
|
|
8
|
+
* handshake, its instructions, its resources — and goes through the one MCP pipeline every server does (the dial, the listing intake,
|
|
9
|
+
* the call lane, the failure record), so its tool names, its listed `_meta` and its call `_meta` are what a stdio or http server's would
|
|
10
|
+
* be. Its server is the host's own code: it is not confined by the engine's sandbox, and what it reaches is not judged by the engine's
|
|
11
|
+
* host floor (that floor judges an http declaration's URL).
|
|
12
|
+
*
|
|
13
|
+
* THE PIPE'S OWNERSHIP — one rule, four checkpoints, all at the dial ({@link openHostPipe}, {@link hostMount}):
|
|
14
|
+
* · one open per dial: every dial (the first, a re-dial, a child's, a resumed leg's) asks the seat once; no pipe is kept across dials;
|
|
15
|
+
* · one deadline over the whole mount — the open, the pipe's `start`, the handshake, the first listing — raced against the dial's stop:
|
|
16
|
+
* the host's pipe can hold any of those steps, where the SDK's own timer covers the requests only. At the deadline the dial fails
|
|
17
|
+
* `timeout`, and the engine closes the pipe (one that arrives later too) without waiting on the host;
|
|
18
|
+
* · a pipe is taken once, at its arrival: one handed again — to another dial, or to this one after it stopped waiting — is refused
|
|
19
|
+
* and left alone (it is its first taker's); a late pipe nobody took is taken and closed;
|
|
20
|
+
* · a pipe is a transport: `start` / `send` / `close` functions, and no `sessionId` (the SDK skips the handshake on a pipe that holds one,
|
|
21
|
+
* and the server's capabilities and instructions would never be read).
|
|
22
|
+
* A pipe taken is the dial's: the engine connects it and the engine closes it — at once, for the engine: the connection reads closed when
|
|
23
|
+
* the engine closes it, and the host's own close runs on the host's time, never waited on, its failure nobody's (`TakenPipe`). A refusal is
|
|
24
|
+
* `host_refused` (nothing was sent), in the engine's own words.
|
|
25
|
+
*
|
|
26
|
+
* WHAT THE HOST CAN SAY — one class, {@link McpHostSeatFailure}, read by one classifier row wherever it surfaces: thrown by `open` (the
|
|
27
|
+
* dial fails, nothing was sent), or the rejection of the pipe's `send` of a request (that request fails). A request settles ONCE, by
|
|
28
|
+
* whichever comes first: the server's answer, its send's rejection, the engine's cancel (its abort, its timer, the idle watchdog), the
|
|
29
|
+
* pipe's close — a host that closes the pipe and then rejects a send reads as the closed connection. A cancellation the pipe fails to
|
|
30
|
+
* send is no request's ending (the cancelled request already ended as cancelled): cancelling a call on the host's server is best effort.
|
|
31
|
+
*
|
|
32
|
+
* A host that serves requests rather than messages hands {@link hostSeatOfRequests} of its {@link McpHostRequestSeat}: the one adapter
|
|
33
|
+
* answers the handshake itself, carries `tools/list` and `tools/call` only, and hands back the seat's failures through the same `send`
|
|
34
|
+
* rejection (see {@link hostSeatOfRequests}).
|
|
21
35
|
*/
|
|
22
|
-
import { type
|
|
23
|
-
|
|
24
|
-
|
|
36
|
+
import { type Transport } from "@modelcontextprotocol/client";
|
|
37
|
+
/**
|
|
38
|
+
* The host's pipe source for one leg (`RunInternals.mcpHostSeats`, TRUSTED, by declaration name). `open` is asked once per dial of that
|
|
39
|
+
* declaration and hands one transport (or a promise of one); `server` is the declaration's name, `signal` aborts when the engine stops
|
|
40
|
+
* waiting for this mount (the run's abort, the mount's deadline). What `open` hands is the dial's from its arrival (see the module note):
|
|
41
|
+
* a transport handed a second time is refused. `open` throws {@link McpHostSeatFailure} to say why there is no pipe; anything else it
|
|
42
|
+
* throws refuses the dial in the engine's words. The engine never disposes a seat: the host releases it when its leg ends.
|
|
43
|
+
*/
|
|
44
|
+
export interface McpHostSeat {
|
|
45
|
+
open(at: {
|
|
46
|
+
readonly server: string;
|
|
47
|
+
readonly signal: AbortSignal;
|
|
48
|
+
}): Transport | Promise<Transport>;
|
|
49
|
+
}
|
|
50
|
+
/** The requests a request-level host seat answers: a listing and a call. */
|
|
25
51
|
export type McpHostSeatMethod = "tools/list" | "tools/call";
|
|
26
|
-
/** A host seat's answer to one request: the JSON-RPC result, or the JSON-RPC error the remote answered with. */
|
|
52
|
+
/** A request-level host seat's answer to one request: the JSON-RPC result, or the JSON-RPC error the remote answered with. */
|
|
27
53
|
export type McpHostSeatAnswer = {
|
|
28
54
|
readonly result: unknown;
|
|
29
55
|
} | {
|
|
@@ -34,20 +60,20 @@ export type McpHostSeatAnswer = {
|
|
|
34
60
|
};
|
|
35
61
|
};
|
|
36
62
|
/**
|
|
37
|
-
*
|
|
38
|
-
* request's own cancellation. A request the host could not hand to the remote, or whose ending it
|
|
39
|
-
* throwing {@link McpHostSeatFailure}.
|
|
63
|
+
* A host's seat that answers requests rather than messages — handed to the engine as {@link hostSeatOfRequests}`(seat)`. `request`
|
|
64
|
+
* answers one request; `signal` is that request's own cancellation. A request the host could not hand to the remote, or whose ending it
|
|
65
|
+
* cannot tell, is answered by throwing {@link McpHostSeatFailure}.
|
|
40
66
|
*/
|
|
41
|
-
export interface
|
|
67
|
+
export interface McpHostRequestSeat {
|
|
42
68
|
request(method: McpHostSeatMethod, params: Readonly<Record<string, unknown>>, signal: AbortSignal): Promise<McpHostSeatAnswer>;
|
|
43
69
|
}
|
|
44
70
|
/**
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
* ended (the failure word is `unknown
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
*
|
|
71
|
+
* What a host says it could not carry, in the one fact the host knows: `delivered: "no"` — nothing was handed to the remote (no pipe was
|
|
72
|
+
* handed over, or the request was not sent; the failure word is `host_refused`); `delivered: "unknown"` — the request was handed on and
|
|
73
|
+
* the host cannot tell how it ended (the failure word is `unknown`; at the dial, nothing of the caller's was sent either way).
|
|
74
|
+
* `condition` is the host's own sentence about why, read as untrusted text and bounded here; the engine adds what the verdict owes the
|
|
75
|
+
* model (retry safety, the verify-first warning of a write-capable tool) itself, so the condition carries none of it. A value of this
|
|
76
|
+
* class whose two facts do not read as they were built is no verdict: it reads as any other thrown value does.
|
|
51
77
|
*/
|
|
52
78
|
export declare class McpHostSeatFailure extends Error {
|
|
53
79
|
readonly delivered: "no" | "unknown";
|
|
@@ -57,36 +83,49 @@ export declare class McpHostSeatFailure extends Error {
|
|
|
57
83
|
condition: string;
|
|
58
84
|
});
|
|
59
85
|
}
|
|
60
|
-
/**
|
|
86
|
+
/** The host's verdict a failure states: the delivery fact and the sentence a failure renders. */
|
|
61
87
|
export interface HostSeatVerdict {
|
|
62
88
|
readonly delivered: "no" | "unknown";
|
|
63
89
|
readonly condition: string;
|
|
64
90
|
}
|
|
65
|
-
/** The host
|
|
91
|
+
/** The host's verdict a thrown value states — a {@link McpHostSeatFailure} whose two facts read as they were built, read once into the
|
|
92
|
+
* engine's own copy (the condition bounded again: re-bounding a bounded sentence leaves it as it is) — else `undefined`, also for a value
|
|
93
|
+
* whose inspection throws. Structure only: a remote's JSON cannot build one, and its shape is no verdict. */
|
|
66
94
|
export declare function hostSeatVerdictOf(err: unknown): HostSeatVerdict | undefined;
|
|
67
|
-
/** The sentence a host
|
|
95
|
+
/** The sentence a host's verdict becomes on the call lane: who failed and why, then the tail the delivery fact owes. */
|
|
68
96
|
export declare function hostSeatLine(what: string, serverLabel: string, seat: HostSeatVerdict, writeTail: string): string;
|
|
69
97
|
/** A host-seat declaration whose leg holds no seat of its name: refused at its dial (`config.mcp_host_seat_missing`), nothing sent. */
|
|
70
98
|
export declare function hostSeatMissing(server: string): Error & {
|
|
71
99
|
code: string;
|
|
72
100
|
};
|
|
73
101
|
/**
|
|
74
|
-
*
|
|
75
|
-
* request
|
|
102
|
+
* One host row's mount under ONE deadline (the module note): `signal` aborts when `ms` (the row's startup bound; absent, the SDK's own
|
|
103
|
+
* request default) has passed since the mount began — a `RequestTimeout`, which the dial reads as `timeout` — or when `run` (the run's
|
|
104
|
+
* abort) fires, with its reason. `end` stands both down once the first listing is in, or the dial failed.
|
|
76
105
|
*/
|
|
77
|
-
export declare
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
106
|
+
export declare function hostMount(ms: number | undefined, run: AbortSignal | undefined): {
|
|
107
|
+
readonly signal: AbortSignal;
|
|
108
|
+
end(): void;
|
|
109
|
+
};
|
|
110
|
+
/** `work`, unless `stop` fires first: then the stop's reason, at once — whatever `work` does later is dropped (never an unhandled
|
|
111
|
+
* rejection). Without a stop, `work` itself. A mount step on a host's pipe waits through here (the module note). */
|
|
112
|
+
export declare function settledBefore<T>(work: Promise<T>, stop: AbortSignal | undefined): Promise<T>;
|
|
113
|
+
/**
|
|
114
|
+
* The dial's pipe from the leg's seat (the module note's four checkpoints): `open` asked once, raced against `stop` (the mount's signal);
|
|
115
|
+
* what arrives is taken, then judged a transport. Throws the stop's reason when the dial stopped waiting (a pipe that arrives later is
|
|
116
|
+
* taken and closed, unless another dial took it), the host's own {@link McpHostSeatFailure} when `open` threw one, and the engine's
|
|
117
|
+
* refusal for everything else (an `open` that threw anything else or is not a function, a value that is no transport, a pipe already taken).
|
|
118
|
+
*/
|
|
119
|
+
export declare function openHostPipe(seat: McpHostSeat, server: string, stop: AbortSignal | undefined): Promise<Transport>;
|
|
120
|
+
/**
|
|
121
|
+
* The one adapter from a request-level seat to a pipe source: each `open` hands a fresh pipe over `seat`. What the pipe does itself:
|
|
122
|
+
* · answers `initialize` locally — the server's name is the dial's declaration name, its version the empty string (a host-seat declaration
|
|
123
|
+
* states no version), its capabilities `tools` only, no instructions — and swallows `notifications/initialized`;
|
|
124
|
+
* · hands `tools/list` and `tools/call` to the seat, one {@link McpHostRequestSeat.request} each, with a signal of the request's own —
|
|
125
|
+
* aborted when the engine cancels that request (its abort, its timeout, the idle watchdog) and when the pipe closes;
|
|
126
|
+
* · refuses every other method locally (the request is not handed on), and drops an answer that arrives after its request was cancelled.
|
|
127
|
+
* The seat's answer reaches the SDK as the JSON-RPC response it is; the seat's failure — its {@link McpHostSeatFailure}, anything else it
|
|
128
|
+
* throws (read as `unknown`, in the engine's words, never the thrown text), an answer the protocol cannot carry — as the rejection of that
|
|
129
|
+
* request's `send`, which the SDK hands to the waiting request as it is, clearing its handlers.
|
|
130
|
+
*/
|
|
131
|
+
export declare function hostSeatOfRequests(seat: McpHostRequestSeat): McpHostSeat;
|
|
@@ -1,5 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { DEFAULT_REQUEST_TIMEOUT_MSEC, SdkError, SdkErrorCode, isJSONRPCErrorResponse, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/client";
|
|
2
|
+
import { raceSettlementAgainstSignal } from "./runner/abort-race.js";
|
|
2
3
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
4
|
+
const CONDITION_MAX = 400;
|
|
3
5
|
export class McpHostSeatFailure extends Error {
|
|
4
6
|
delivered;
|
|
5
7
|
condition;
|
|
@@ -8,35 +10,221 @@ export class McpHostSeatFailure extends Error {
|
|
|
8
10
|
throw new TypeError(`McpHostSeatFailure: delivered must be "no" or "unknown"`);
|
|
9
11
|
if (typeof o.condition !== "string")
|
|
10
12
|
throw new TypeError("McpHostSeatFailure: condition must be a string");
|
|
11
|
-
|
|
13
|
+
const condition = inlineUntrusted(o.condition, CONDITION_MAX);
|
|
14
|
+
super(condition);
|
|
12
15
|
this.name = "McpHostSeatFailure";
|
|
13
16
|
this.delivered = o.delivered;
|
|
14
|
-
this.condition =
|
|
17
|
+
this.condition = condition;
|
|
15
18
|
}
|
|
16
19
|
}
|
|
17
|
-
const VERDICTS = new WeakSet();
|
|
18
|
-
function verdict(delivered, condition) {
|
|
19
|
-
const minted = Object.freeze({ delivered, condition: inlineUntrusted(condition, 400) });
|
|
20
|
-
VERDICTS.add(minted);
|
|
21
|
-
return minted;
|
|
22
|
-
}
|
|
23
20
|
export function hostSeatVerdictOf(err) {
|
|
24
|
-
|
|
21
|
+
try {
|
|
22
|
+
if (!(err instanceof McpHostSeatFailure))
|
|
23
|
+
return undefined;
|
|
24
|
+
const { delivered, condition } = err;
|
|
25
|
+
return (delivered === "no" || delivered === "unknown") && typeof condition === "string" ? Object.freeze({ delivered, condition: inlineUntrusted(condition, CONDITION_MAX) }) : undefined;
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
25
28
|
return undefined;
|
|
26
|
-
|
|
27
|
-
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
export function hostSeatLine(what, serverLabel, seat, writeTail) {
|
|
32
|
+
return seat.delivered === "no"
|
|
33
|
+
? `${what} was not sent to MCP server "${serverLabel}": ${seat.condition}. The host did not hand the request on, so the server did not execute it; sending it again is safe.`
|
|
34
|
+
: `${what} on MCP server "${serverLabel}" ended without an outcome the host could report: ${seat.condition}. The request may or may not have executed on the server — the outcome is unknown.${writeTail}`;
|
|
35
|
+
}
|
|
36
|
+
export function hostSeatMissing(server) {
|
|
37
|
+
return Object.assign(new Error(`MCP server "${inlineUntrusted(server, 120)}" is declared with a host-supplied transport, and this leg holds no host seat of that name (RunInternals.mcpHostSeats) — not dialed`), { code: "config.mcp_host_seat_missing" });
|
|
38
|
+
}
|
|
39
|
+
export function hostMount(ms, run) {
|
|
40
|
+
const bound = ms ?? DEFAULT_REQUEST_TIMEOUT_MSEC;
|
|
41
|
+
const mount = new AbortController();
|
|
42
|
+
const follow = () => mount.abort(run?.reason);
|
|
43
|
+
const timer = setTimeout(() => mount.abort(new SdkError(SdkErrorCode.RequestTimeout, `the host's pipe did not finish mounting within ${bound} ms`, { timeout: bound })), bound);
|
|
44
|
+
if (run?.aborted === true)
|
|
45
|
+
follow();
|
|
46
|
+
else
|
|
47
|
+
run?.addEventListener("abort", follow, { once: true });
|
|
48
|
+
return {
|
|
49
|
+
signal: mount.signal,
|
|
50
|
+
end: () => {
|
|
51
|
+
clearTimeout(timer);
|
|
52
|
+
run?.removeEventListener("abort", follow);
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
export async function settledBefore(work, stop) {
|
|
57
|
+
if (stop === undefined)
|
|
58
|
+
return work;
|
|
59
|
+
const raced = await raceSettlementAgainstSignal(work, stop);
|
|
60
|
+
if (raced.tag === "aborted")
|
|
61
|
+
throw stop.reason;
|
|
62
|
+
if (raced.tag === "threw")
|
|
63
|
+
throw raced.error;
|
|
64
|
+
return raced.value;
|
|
65
|
+
}
|
|
66
|
+
const TAKEN = new WeakMap();
|
|
67
|
+
const refusal = (condition) => new McpHostSeatFailure({ delivered: "no", condition });
|
|
68
|
+
const connectionClosed = () => refusal("the host seat's connection to this leg is closed");
|
|
69
|
+
export async function openHostPipe(seat, server, stop) {
|
|
70
|
+
stop?.throwIfAborted();
|
|
71
|
+
let open;
|
|
72
|
+
try {
|
|
73
|
+
open = seat.open;
|
|
74
|
+
}
|
|
75
|
+
catch {
|
|
76
|
+
open = undefined;
|
|
77
|
+
}
|
|
78
|
+
if (typeof open !== "function")
|
|
79
|
+
throw refusal("the host seat has no open function, so no pipe was opened");
|
|
80
|
+
let opened;
|
|
81
|
+
try {
|
|
82
|
+
opened = Promise.resolve(Reflect.apply(open, seat, [Object.freeze({ server, signal: stop ?? new AbortController().signal })]));
|
|
83
|
+
}
|
|
84
|
+
catch (thrown) {
|
|
85
|
+
opened = Promise.reject(thrown);
|
|
86
|
+
}
|
|
87
|
+
const raced = stop !== undefined ? await raceSettlementAgainstSignal(opened, stop) : await opened.then((value) => ({ tag: "value", value }), (error) => ({ tag: "threw", error }));
|
|
88
|
+
if (raced.tag === "aborted") {
|
|
89
|
+
void opened.then((late) => dropLate(late, server), () => undefined);
|
|
90
|
+
throw stop.reason;
|
|
91
|
+
}
|
|
92
|
+
if (raced.tag === "threw") {
|
|
93
|
+
const said = hostSeatVerdictOf(raced.error);
|
|
94
|
+
throw said !== undefined ? new McpHostSeatFailure(said) : refusal("the host seat failed to open a pipe for this dial without saying why");
|
|
95
|
+
}
|
|
96
|
+
return take(raced.value, server);
|
|
97
|
+
}
|
|
98
|
+
function take(pipe, server) {
|
|
99
|
+
if ((typeof pipe !== "object" && typeof pipe !== "function") || pipe === null)
|
|
100
|
+
throw refusal("the host seat's open handed over something that is not an MCP transport");
|
|
101
|
+
const holder = TAKEN.get(pipe);
|
|
102
|
+
if (holder !== undefined)
|
|
103
|
+
throw refusal(`the host seat handed over a pipe the dial of MCP server "${inlineUntrusted(holder, 120)}" already took — a pipe serves one dial`);
|
|
104
|
+
TAKEN.set(pipe, server);
|
|
105
|
+
const parts = partsOf(pipe);
|
|
106
|
+
if (typeof parts !== "string")
|
|
107
|
+
return new TakenPipe(pipe, parts);
|
|
108
|
+
closeUnwaited(pipe);
|
|
109
|
+
throw refusal(parts);
|
|
28
110
|
}
|
|
29
|
-
|
|
111
|
+
const pipeFn = (v) => (typeof v === "function" ? v : undefined);
|
|
112
|
+
function partsOf(pipe) {
|
|
30
113
|
try {
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
114
|
+
const t = pipe;
|
|
115
|
+
const [start, send, close, sessionId, setProtocolVersion, setSupportedProtocolVersions, hasPerRequestStream] = [pipeFn(t["start"]), pipeFn(t["send"]), pipeFn(t["close"]), t["sessionId"], t["setProtocolVersion"], t["setSupportedProtocolVersions"], t["hasPerRequestStream"]];
|
|
116
|
+
if (start === undefined || send === undefined || close === undefined)
|
|
117
|
+
return "the host seat's open handed over something that is not an MCP transport (it needs start, send and close functions)";
|
|
118
|
+
if (sessionId !== undefined)
|
|
119
|
+
return "the host seat's open handed over a pipe that already holds a session, so the server's handshake would be skipped";
|
|
120
|
+
return { start, send, close, setProtocolVersion: pipeFn(setProtocolVersion), setSupportedProtocolVersions: pipeFn(setSupportedProtocolVersions), hasPerRequestStream: hasPerRequestStream === true ? true : undefined };
|
|
121
|
+
}
|
|
122
|
+
catch {
|
|
123
|
+
return "the host seat's open handed over a pipe whose members cannot be read";
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
class TakenPipe {
|
|
127
|
+
onclose;
|
|
128
|
+
onerror;
|
|
129
|
+
onmessage;
|
|
130
|
+
hasPerRequestStream;
|
|
131
|
+
#pipe;
|
|
132
|
+
#parts;
|
|
133
|
+
#inFlight = new Map();
|
|
134
|
+
#ended = false;
|
|
135
|
+
#closing = false;
|
|
136
|
+
constructor(pipe, parts) {
|
|
137
|
+
this.#pipe = pipe;
|
|
138
|
+
this.#parts = parts;
|
|
139
|
+
this.hasPerRequestStream = parts.hasPerRequestStream;
|
|
140
|
+
}
|
|
141
|
+
async start() {
|
|
142
|
+
try {
|
|
143
|
+
const p = this.#pipe;
|
|
144
|
+
const [heard, ended, failed] = [p.onmessage, p.onclose, p.onerror];
|
|
145
|
+
p.onmessage = (message, extra) => {
|
|
146
|
+
heard?.(message, extra);
|
|
147
|
+
if (this.#ended)
|
|
148
|
+
return;
|
|
149
|
+
if ((isJSONRPCResultResponse(message) || isJSONRPCErrorResponse(message)) && this.#inFlight.has(message.id))
|
|
150
|
+
this.#inFlight.set(message.id, true);
|
|
151
|
+
this.onmessage?.(message, extra);
|
|
152
|
+
};
|
|
153
|
+
p.onclose = () => {
|
|
154
|
+
ended?.();
|
|
155
|
+
this.#end();
|
|
156
|
+
};
|
|
157
|
+
p.onerror = (error) => {
|
|
158
|
+
failed?.(error);
|
|
159
|
+
this.onerror?.(error);
|
|
160
|
+
};
|
|
35
161
|
}
|
|
162
|
+
catch {
|
|
163
|
+
throw refusal("the host's pipe would not take the engine's callbacks");
|
|
164
|
+
}
|
|
165
|
+
await Reflect.apply(this.#parts.start, this.#pipe, []);
|
|
166
|
+
}
|
|
167
|
+
async send(message, options) {
|
|
168
|
+
if (this.#ended)
|
|
169
|
+
throw connectionClosed();
|
|
170
|
+
if (!isJSONRPCRequest(message))
|
|
171
|
+
return void (await Reflect.apply(this.#parts.send, this.#pipe, [message, options]));
|
|
172
|
+
const id = message.id;
|
|
173
|
+
this.#inFlight.set(id, false);
|
|
174
|
+
try {
|
|
175
|
+
await Reflect.apply(this.#parts.send, this.#pipe, [message, options]);
|
|
176
|
+
}
|
|
177
|
+
catch (err) {
|
|
178
|
+
if (this.#inFlight.get(id) !== true)
|
|
179
|
+
throw err;
|
|
180
|
+
}
|
|
181
|
+
finally {
|
|
182
|
+
this.#inFlight.delete(id);
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
async close() {
|
|
186
|
+
if (!this.#closing) {
|
|
187
|
+
this.#closing = true;
|
|
188
|
+
closeUnwaited(this.#pipe, this.#parts.close);
|
|
189
|
+
}
|
|
190
|
+
this.#end();
|
|
191
|
+
}
|
|
192
|
+
setProtocolVersion(version) {
|
|
193
|
+
if (this.#parts.setProtocolVersion !== undefined)
|
|
194
|
+
Reflect.apply(this.#parts.setProtocolVersion, this.#pipe, [version]);
|
|
195
|
+
}
|
|
196
|
+
setSupportedProtocolVersions(versions) {
|
|
197
|
+
if (this.#parts.setSupportedProtocolVersions !== undefined)
|
|
198
|
+
Reflect.apply(this.#parts.setSupportedProtocolVersions, this.#pipe, [versions]);
|
|
199
|
+
}
|
|
200
|
+
#end() {
|
|
201
|
+
if (this.#ended)
|
|
202
|
+
return;
|
|
203
|
+
this.#ended = true;
|
|
204
|
+
this.onclose?.();
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
function dropLate(late, server) {
|
|
208
|
+
if ((typeof late !== "object" && typeof late !== "function") || late === null || TAKEN.has(late))
|
|
209
|
+
return;
|
|
210
|
+
TAKEN.set(late, server);
|
|
211
|
+
closeUnwaited(late);
|
|
212
|
+
}
|
|
213
|
+
function closeUnwaited(pipe, close) {
|
|
214
|
+
try {
|
|
215
|
+
const fn = close ?? pipeFn(pipe["close"]);
|
|
216
|
+
if (fn !== undefined)
|
|
217
|
+
void Promise.resolve(Reflect.apply(fn, pipe, [])).catch(() => undefined);
|
|
36
218
|
}
|
|
37
219
|
catch {
|
|
38
220
|
}
|
|
39
|
-
|
|
221
|
+
}
|
|
222
|
+
export function hostSeatOfRequests(seat) {
|
|
223
|
+
return { open: ({ server }) => new RequestSeatPipe(seat, server) };
|
|
224
|
+
}
|
|
225
|
+
function failureOfThrown(thrown) {
|
|
226
|
+
const said = hostSeatVerdictOf(thrown);
|
|
227
|
+
return new McpHostSeatFailure(said ?? { delivered: "unknown", condition: "the host seat failed without saying whether it handed the request on" });
|
|
40
228
|
}
|
|
41
229
|
function responseOf(id, raw) {
|
|
42
230
|
let answer;
|
|
@@ -51,17 +239,9 @@ function responseOf(id, raw) {
|
|
|
51
239
|
const candidate = result !== undefined ? { jsonrpc: "2.0", id, result } : { jsonrpc: "2.0", id, error: member("error") };
|
|
52
240
|
if (isJSONRPCResultResponse(candidate) || isJSONRPCErrorResponse(candidate))
|
|
53
241
|
return candidate;
|
|
54
|
-
return
|
|
55
|
-
}
|
|
56
|
-
export function hostSeatLine(what, serverLabel, seat, writeTail) {
|
|
57
|
-
return seat.delivered === "no"
|
|
58
|
-
? `${what} was not sent to MCP server "${serverLabel}": ${seat.condition}. The host did not hand the request on, so the server did not execute it; sending it again is safe.`
|
|
59
|
-
: `${what} on MCP server "${serverLabel}" ended without an outcome the host could report: ${seat.condition}. The request may or may not have executed on the server — the outcome is unknown.${writeTail}`;
|
|
242
|
+
return new McpHostSeatFailure({ delivered: "unknown", condition: "the host seat answered something the protocol cannot carry as a result or an error" });
|
|
60
243
|
}
|
|
61
|
-
|
|
62
|
-
return Object.assign(new Error(`MCP server "${inlineUntrusted(server, 120)}" is declared with a host-supplied transport, and this leg holds no host seat of that name (RunInternals.mcpHostSeats) — not dialed`), { code: "config.mcp_host_seat_missing" });
|
|
63
|
-
}
|
|
64
|
-
export class HostSeatTransport {
|
|
244
|
+
class RequestSeatPipe {
|
|
65
245
|
seat;
|
|
66
246
|
serverName;
|
|
67
247
|
onclose;
|
|
@@ -92,27 +272,27 @@ export class HostSeatTransport {
|
|
|
92
272
|
const params = (message.params ?? {});
|
|
93
273
|
if (method === "initialize") {
|
|
94
274
|
const protocolVersion = params["protocolVersion"];
|
|
95
|
-
return this.deliver(
|
|
275
|
+
return this.deliver({ jsonrpc: "2.0", id, result: { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: this.serverName, version: "" } } });
|
|
96
276
|
}
|
|
97
277
|
if (this.closed)
|
|
98
|
-
|
|
278
|
+
throw connectionClosed();
|
|
99
279
|
if (method !== "tools/list" && method !== "tools/call")
|
|
100
|
-
|
|
280
|
+
throw new McpHostSeatFailure({ delivered: "no", condition: `the host seat carries tools/list and tools/call only, and ${inlineUntrusted(method, 80)} was not handed on` });
|
|
101
281
|
const stop = new AbortController();
|
|
102
282
|
this.inFlight.set(id, stop);
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
283
|
+
let answered;
|
|
284
|
+
try {
|
|
285
|
+
answered = responseOf(id, await this.seat.request(method, params, stop.signal));
|
|
286
|
+
}
|
|
287
|
+
catch (thrown) {
|
|
288
|
+
answered = failureOfThrown(thrown);
|
|
289
|
+
}
|
|
290
|
+
if (this.inFlight.get(id) !== stop)
|
|
291
|
+
return;
|
|
292
|
+
this.inFlight.delete(id);
|
|
293
|
+
if (answered instanceof McpHostSeatFailure)
|
|
294
|
+
throw answered;
|
|
295
|
+
this.deliver(answered);
|
|
116
296
|
}
|
|
117
297
|
async close() {
|
|
118
298
|
if (this.closed)
|
|
@@ -124,8 +304,7 @@ export class HostSeatTransport {
|
|
|
124
304
|
stop.abort(new Error("the connection to the host seat closed"));
|
|
125
305
|
this.onclose?.();
|
|
126
306
|
}
|
|
127
|
-
deliver(
|
|
128
|
-
const message = VERDICTS.has(answered) ? { jsonrpc: "2.0", id, error: { code: ErrorCode.InternalError, message: answered.condition, data: answered } } : answered;
|
|
307
|
+
deliver(message) {
|
|
129
308
|
queueMicrotask(() => this.onmessage?.(message));
|
|
130
309
|
}
|
|
131
310
|
}
|
package/dist/core/mcp-probe.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { SdkError, SdkErrorCode } from "@modelcontextprotocol/client";
|
|
2
2
|
import { snapshotMcpEntries } from "./locked-config.js";
|
|
3
3
|
import { classifyMcpFailure, livenessOf } from "./mcp-failure.js";
|
|
4
4
|
import { transportKindOf } from "./mcp-server-spec.js";
|
|
@@ -57,7 +57,7 @@ async function raceDial(dial, ms, signal) {
|
|
|
57
57
|
}
|
|
58
58
|
}
|
|
59
59
|
function stoppedWaitingStatus(entry, ms) {
|
|
60
|
-
const condition = new
|
|
60
|
+
const condition = new SdkError(SdkErrorCode.RequestTimeout, `the probe stopped waiting for this server's connect and initial tool listing after ${ms} ms`);
|
|
61
61
|
const { kind, delivered } = classifyMcpFailure(condition, { phase: "connect", transport: transportKindOf(entry) });
|
|
62
62
|
const liveness = livenessOf(kind, Date.now());
|
|
63
63
|
return { name: entry.name, status: "failed", errorCode: kind, delivered, error: condition.message, ...(liveness !== undefined ? { liveness } : {}) };
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
* session while that connection is still the live one — a call that lost its session on a connection already replaced is sent on the
|
|
13
13
|
* replacement, so a late 404 never closes a connection other calls have moved to.
|
|
14
14
|
*/
|
|
15
|
-
import type { Client } from "@modelcontextprotocol/
|
|
15
|
+
import type { Client, Tool } from "@modelcontextprotocol/client";
|
|
16
16
|
import { type McpAuthorization, type McpExchangeOutcome, type McpFailure, type McpFailureSite } from "./mcp-failure.js";
|
|
17
17
|
/**
|
|
18
18
|
* One request failure, read once and told to the server's two writers: its reach ({@link ServerHealth.observe}) always, and — when
|
|
@@ -90,12 +90,19 @@ export interface LenientListedTool {
|
|
|
90
90
|
inputSchema?: unknown;
|
|
91
91
|
annotations?: unknown;
|
|
92
92
|
_meta?: unknown;
|
|
93
|
-
/**
|
|
94
|
-
*
|
|
95
|
-
* free. Not fed through core's own gate — see that function's docstring for why. */
|
|
93
|
+
/** Carried through UNVALIDATED (same posture as inputSchema): the tool's definition rides every call to it (mcp.ts
|
|
94
|
+
* `toolDefinitionOf`), and the SDK validates a structured result against it; whether this client can compile it is judged at intake. */
|
|
96
95
|
outputSchema?: unknown;
|
|
97
96
|
execution?: unknown;
|
|
98
97
|
}
|
|
98
|
+
/** A mounted tool as its calls hand it to the SDK (`callTool`'s `toolDefinition`), from the connection's latest listing through the
|
|
99
|
+
* leg's own intake: the definition the server listed, and whether this client's schema validator cannot compile its `outputSchema`
|
|
100
|
+
* (`outputSchemaUncompilable`) — {@link reach} then refuses the call before it is sent, rather than leaving it to the SDK's refusal in
|
|
101
|
+
* words a reader would take for the server's answer. The compiler's own message is not kept: it quotes the server's schema. */
|
|
102
|
+
export interface McpToolDefinition {
|
|
103
|
+
readonly tool: Tool;
|
|
104
|
+
readonly outputSchemaUncompilable?: true;
|
|
105
|
+
}
|
|
99
106
|
/**
|
|
100
107
|
* The server's listing as one connection knows it, from whichever of its holders listed last (each leg of a pooled run lists on the
|
|
101
108
|
* shared connection) — what every holder's mounted tools are checked against, each through its own leg's intake, and what a leg mounts.
|
|
@@ -139,6 +146,9 @@ export interface McpLiveConnection {
|
|
|
139
146
|
readonly health: ServerHealth;
|
|
140
147
|
/** Minted tool name → the gate the connection's latest listing ({@link ConnectionListing}) mints it, through this leg's intake. */
|
|
141
148
|
gates(): ReadonlyMap<string, string>;
|
|
149
|
+
/** Minted tool name → its definition from that same listing through that same intake ({@link McpToolDefinition}): what a call to it
|
|
150
|
+
* hands the SDK. One reading with {@link gates}, so a call is never validated against a listing other than the one that let it go. */
|
|
151
|
+
definitions(): ReadonlyMap<string, McpToolDefinition>;
|
|
142
152
|
}
|
|
143
153
|
export interface McpServerLink {
|
|
144
154
|
/** The connection the materialization holds for the server now; `undefined` while it holds none (a re-dial's old one is gone and the new one has not landed, or the last dial failed). */
|
|
@@ -149,8 +159,10 @@ export interface McpServerLink {
|
|
|
149
159
|
* connection is replaced once for all its holders). */
|
|
150
160
|
recover(lost: McpLiveConnection, cause?: "session" | "expired"): Promise<unknown>;
|
|
151
161
|
}
|
|
152
|
-
/** Why a tool may not be sent on a live connection: its listing mints the tool another gate or none (`changed`),
|
|
153
|
-
|
|
162
|
+
/** Why a tool may not be sent on a live connection: its listing mints the tool another gate or none (`changed`), no listing of the connection has reached it (`unreached`), or that
|
|
163
|
+
* listing gives it an output schema this connection's validator cannot compile (`output_schema`: the SDK would refuse the call unsent itself, in words a reader takes for the
|
|
164
|
+
* server's answer). */
|
|
165
|
+
export type McpListingRefusal = "changed" | "unreached" | "output_schema";
|
|
154
166
|
/** Where the tool `name` minted with `gate` may be sent now: the live connection, `"gone"` when there is none (or it closed), or why its listing does not vouch for the tool ({@link McpListingRefusal}). */
|
|
155
167
|
export declare function reach(link: McpServerLink, name: string, gate: string): McpLiveConnection | "gone" | McpListingRefusal;
|
|
156
168
|
/** An attempt whose session was found gone: the connection it was sent on, and its failure as it would have been thrown then. */
|
|
@@ -75,7 +75,9 @@ export function reach(link, name, gate) {
|
|
|
75
75
|
const listed = live.gates().get(name);
|
|
76
76
|
if (listed === UNPROVEN_GATE)
|
|
77
77
|
return "unreached";
|
|
78
|
-
|
|
78
|
+
if (listed !== gate)
|
|
79
|
+
return "changed";
|
|
80
|
+
return live.definitions().get(name)?.outputSchemaUncompilable === true ? "output_schema" : live;
|
|
79
81
|
}
|
|
80
82
|
export class Resendable {
|
|
81
83
|
on;
|
|
@@ -113,11 +115,24 @@ export function refusalScope(judge) {
|
|
|
113
115
|
const j = REFUSAL_JUDGES[judge];
|
|
114
116
|
return `${j.standing}This refusal is for this call only: ${j.rule}.`;
|
|
115
117
|
}
|
|
118
|
+
const LISTING_REFUSAL_CODES = {
|
|
119
|
+
changed: "mcp.tool_declaration_changed",
|
|
120
|
+
unreached: "mcp.tool_listing_unreached",
|
|
121
|
+
output_schema: "mcp.tool_output_schema_invalid",
|
|
122
|
+
};
|
|
116
123
|
export function listingRefusal(refusal, remoteName, server) {
|
|
117
|
-
const
|
|
118
|
-
const code = changed ? "mcp.tool_declaration_changed" : "mcp.tool_listing_unreached";
|
|
124
|
+
const code = LISTING_REFUSAL_CODES[refusal];
|
|
119
125
|
return {
|
|
120
|
-
content: [
|
|
126
|
+
content: [
|
|
127
|
+
{
|
|
128
|
+
type: "text",
|
|
129
|
+
text: `The call to tool ${inlineUntrusted(remoteName)} was refused before it was sent: MCP server "${inlineUntrusted(server)}" ${refusal === "changed"
|
|
130
|
+
? "no longer declares this tool the way it was mounted (its safety declaration changed, or a complete listing no longer lists it)"
|
|
131
|
+
: refusal === "unreached"
|
|
132
|
+
? "has not listed this tool since it was reconnected (the re-listing stopped before it reached the tool), so whether the server still declares it the way it was mounted is unknown"
|
|
133
|
+
: "lists this tool with an output schema this client cannot compile, so its structured result could not be checked"}. The server did not execute it. ${refusalScope("listing")}`,
|
|
134
|
+
},
|
|
135
|
+
],
|
|
121
136
|
details: { error: code, code, delivered: "no", server },
|
|
122
137
|
terminate: false,
|
|
123
138
|
isError: true,
|