@sema-agent/core 7.60.0 → 7.61.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 +605 -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 +61 -10
- package/dist/agents/cascade.js +60 -20
- 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-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 +36 -7
- 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 +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- 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-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- 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 +49 -18
- 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 +2 -1
- 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 +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- 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 +2 -1
- 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 +220 -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.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/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/dollar.d.ts +62 -0
- 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 +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- 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/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -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 +141 -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 +38 -16
- package/dist/core/mods/stations.js +25 -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 +61 -2
- package/dist/core/own-property-receipt.js +42 -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/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- 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 +14 -2
- 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 +98 -26
- 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/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/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 +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- 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 +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- 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 +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- 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 +56 -28
- 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 +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- 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.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- 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 +40 -29
- 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 +9 -7
- 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 +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- 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/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 +8 -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-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 +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- 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 +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- package/dist/core/secret-env.js +8 -9
- 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 +2 -0
- package/dist/core/session-store.js +5 -7
- package/dist/core/session.d.ts +2 -1
- 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 +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -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/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 +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- 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 +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- 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 +10 -10
- 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 +30 -0
- 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 +2 -3
- 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 +108 -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-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -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 +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- 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 +41 -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/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- 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 +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- 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 +16 -3
- package/dist/stores/file/session-store.js +21 -20
- 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/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/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-establish.js +3 -1
- 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/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 +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -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,216 @@ 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
|
+
export async function openHostPipe(seat, server, stop) {
|
|
69
|
+
stop?.throwIfAborted();
|
|
70
|
+
let open;
|
|
71
|
+
try {
|
|
72
|
+
open = seat.open;
|
|
73
|
+
}
|
|
74
|
+
catch {
|
|
75
|
+
open = undefined;
|
|
76
|
+
}
|
|
77
|
+
if (typeof open !== "function")
|
|
78
|
+
throw refusal("the host seat has no open function, so no pipe was opened");
|
|
79
|
+
let opened;
|
|
80
|
+
try {
|
|
81
|
+
opened = Promise.resolve(Reflect.apply(open, seat, [Object.freeze({ server, signal: stop ?? new AbortController().signal })]));
|
|
82
|
+
}
|
|
83
|
+
catch (thrown) {
|
|
84
|
+
opened = Promise.reject(thrown);
|
|
85
|
+
}
|
|
86
|
+
const raced = stop !== undefined ? await raceSettlementAgainstSignal(opened, stop) : await opened.then((value) => ({ tag: "value", value }), (error) => ({ tag: "threw", error }));
|
|
87
|
+
if (raced.tag === "aborted") {
|
|
88
|
+
void opened.then((late) => dropLate(late, server), () => undefined);
|
|
89
|
+
throw stop.reason;
|
|
90
|
+
}
|
|
91
|
+
if (raced.tag === "threw") {
|
|
92
|
+
const said = hostSeatVerdictOf(raced.error);
|
|
93
|
+
throw said !== undefined ? new McpHostSeatFailure(said) : refusal("the host seat failed to open a pipe for this dial without saying why");
|
|
94
|
+
}
|
|
95
|
+
return take(raced.value, server);
|
|
96
|
+
}
|
|
97
|
+
function take(pipe, server) {
|
|
98
|
+
if ((typeof pipe !== "object" && typeof pipe !== "function") || pipe === null)
|
|
99
|
+
throw refusal("the host seat's open handed over something that is not an MCP transport");
|
|
100
|
+
const holder = TAKEN.get(pipe);
|
|
101
|
+
if (holder !== undefined)
|
|
102
|
+
throw refusal(`the host seat handed over a pipe the dial of MCP server "${inlineUntrusted(holder, 120)}" already took — a pipe serves one dial`);
|
|
103
|
+
TAKEN.set(pipe, server);
|
|
104
|
+
const parts = partsOf(pipe);
|
|
105
|
+
if (typeof parts !== "string")
|
|
106
|
+
return new TakenPipe(pipe, parts);
|
|
107
|
+
closeUnwaited(pipe);
|
|
108
|
+
throw refusal(parts);
|
|
28
109
|
}
|
|
29
|
-
|
|
110
|
+
const pipeFn = (v) => (typeof v === "function" ? v : undefined);
|
|
111
|
+
function partsOf(pipe) {
|
|
30
112
|
try {
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
113
|
+
const t = pipe;
|
|
114
|
+
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"]];
|
|
115
|
+
if (start === undefined || send === undefined || close === undefined)
|
|
116
|
+
return "the host seat's open handed over something that is not an MCP transport (it needs start, send and close functions)";
|
|
117
|
+
if (sessionId !== undefined)
|
|
118
|
+
return "the host seat's open handed over a pipe that already holds a session, so the server's handshake would be skipped";
|
|
119
|
+
return { start, send, close, setProtocolVersion: pipeFn(setProtocolVersion), setSupportedProtocolVersions: pipeFn(setSupportedProtocolVersions), hasPerRequestStream: hasPerRequestStream === true ? true : undefined };
|
|
120
|
+
}
|
|
121
|
+
catch {
|
|
122
|
+
return "the host seat's open handed over a pipe whose members cannot be read";
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
class TakenPipe {
|
|
126
|
+
onclose;
|
|
127
|
+
onerror;
|
|
128
|
+
onmessage;
|
|
129
|
+
hasPerRequestStream;
|
|
130
|
+
#pipe;
|
|
131
|
+
#parts;
|
|
132
|
+
#inFlight = new Map();
|
|
133
|
+
#ended = false;
|
|
134
|
+
#closing = false;
|
|
135
|
+
constructor(pipe, parts) {
|
|
136
|
+
this.#pipe = pipe;
|
|
137
|
+
this.#parts = parts;
|
|
138
|
+
this.hasPerRequestStream = parts.hasPerRequestStream;
|
|
139
|
+
}
|
|
140
|
+
async start() {
|
|
141
|
+
try {
|
|
142
|
+
const p = this.#pipe;
|
|
143
|
+
const [heard, ended, failed] = [p.onmessage, p.onclose, p.onerror];
|
|
144
|
+
p.onmessage = (message, extra) => {
|
|
145
|
+
heard?.(message, extra);
|
|
146
|
+
if ((isJSONRPCResultResponse(message) || isJSONRPCErrorResponse(message)) && this.#inFlight.has(message.id))
|
|
147
|
+
this.#inFlight.set(message.id, true);
|
|
148
|
+
this.onmessage?.(message, extra);
|
|
149
|
+
};
|
|
150
|
+
p.onclose = () => {
|
|
151
|
+
ended?.();
|
|
152
|
+
this.#end();
|
|
153
|
+
};
|
|
154
|
+
p.onerror = (error) => {
|
|
155
|
+
failed?.(error);
|
|
156
|
+
this.onerror?.(error);
|
|
157
|
+
};
|
|
35
158
|
}
|
|
159
|
+
catch {
|
|
160
|
+
throw refusal("the host's pipe would not take the engine's callbacks");
|
|
161
|
+
}
|
|
162
|
+
await Reflect.apply(this.#parts.start, this.#pipe, []);
|
|
163
|
+
}
|
|
164
|
+
async send(message, options) {
|
|
165
|
+
if (!isJSONRPCRequest(message))
|
|
166
|
+
return void (await Reflect.apply(this.#parts.send, this.#pipe, [message, options]));
|
|
167
|
+
const id = message.id;
|
|
168
|
+
this.#inFlight.set(id, false);
|
|
169
|
+
try {
|
|
170
|
+
await Reflect.apply(this.#parts.send, this.#pipe, [message, options]);
|
|
171
|
+
}
|
|
172
|
+
catch (err) {
|
|
173
|
+
if (this.#inFlight.get(id) !== true)
|
|
174
|
+
throw err;
|
|
175
|
+
}
|
|
176
|
+
finally {
|
|
177
|
+
this.#inFlight.delete(id);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
async close() {
|
|
181
|
+
if (!this.#closing) {
|
|
182
|
+
this.#closing = true;
|
|
183
|
+
closeUnwaited(this.#pipe, this.#parts.close);
|
|
184
|
+
}
|
|
185
|
+
this.#end();
|
|
186
|
+
}
|
|
187
|
+
setProtocolVersion(version) {
|
|
188
|
+
if (this.#parts.setProtocolVersion !== undefined)
|
|
189
|
+
Reflect.apply(this.#parts.setProtocolVersion, this.#pipe, [version]);
|
|
190
|
+
}
|
|
191
|
+
setSupportedProtocolVersions(versions) {
|
|
192
|
+
if (this.#parts.setSupportedProtocolVersions !== undefined)
|
|
193
|
+
Reflect.apply(this.#parts.setSupportedProtocolVersions, this.#pipe, [versions]);
|
|
194
|
+
}
|
|
195
|
+
#end() {
|
|
196
|
+
if (this.#ended)
|
|
197
|
+
return;
|
|
198
|
+
this.#ended = true;
|
|
199
|
+
this.onclose?.();
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
function dropLate(late, server) {
|
|
203
|
+
if ((typeof late !== "object" && typeof late !== "function") || late === null || TAKEN.has(late))
|
|
204
|
+
return;
|
|
205
|
+
TAKEN.set(late, server);
|
|
206
|
+
closeUnwaited(late);
|
|
207
|
+
}
|
|
208
|
+
function closeUnwaited(pipe, close) {
|
|
209
|
+
try {
|
|
210
|
+
const fn = close ?? pipeFn(pipe["close"]);
|
|
211
|
+
if (fn !== undefined)
|
|
212
|
+
void Promise.resolve(Reflect.apply(fn, pipe, [])).catch(() => undefined);
|
|
36
213
|
}
|
|
37
214
|
catch {
|
|
38
215
|
}
|
|
39
|
-
|
|
216
|
+
}
|
|
217
|
+
export function hostSeatOfRequests(seat) {
|
|
218
|
+
return { open: ({ server }) => new RequestSeatPipe(seat, server) };
|
|
219
|
+
}
|
|
220
|
+
function failureOfThrown(thrown) {
|
|
221
|
+
const said = hostSeatVerdictOf(thrown);
|
|
222
|
+
return new McpHostSeatFailure(said ?? { delivered: "unknown", condition: "the host seat failed without saying whether it handed the request on" });
|
|
40
223
|
}
|
|
41
224
|
function responseOf(id, raw) {
|
|
42
225
|
let answer;
|
|
@@ -51,17 +234,9 @@ function responseOf(id, raw) {
|
|
|
51
234
|
const candidate = result !== undefined ? { jsonrpc: "2.0", id, result } : { jsonrpc: "2.0", id, error: member("error") };
|
|
52
235
|
if (isJSONRPCResultResponse(candidate) || isJSONRPCErrorResponse(candidate))
|
|
53
236
|
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}`;
|
|
237
|
+
return new McpHostSeatFailure({ delivered: "unknown", condition: "the host seat answered something the protocol cannot carry as a result or an error" });
|
|
60
238
|
}
|
|
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 {
|
|
239
|
+
class RequestSeatPipe {
|
|
65
240
|
seat;
|
|
66
241
|
serverName;
|
|
67
242
|
onclose;
|
|
@@ -92,27 +267,27 @@ export class HostSeatTransport {
|
|
|
92
267
|
const params = (message.params ?? {});
|
|
93
268
|
if (method === "initialize") {
|
|
94
269
|
const protocolVersion = params["protocolVersion"];
|
|
95
|
-
return this.deliver(
|
|
270
|
+
return this.deliver({ jsonrpc: "2.0", id, result: { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: this.serverName, version: "" } } });
|
|
96
271
|
}
|
|
97
272
|
if (this.closed)
|
|
98
|
-
|
|
273
|
+
throw new McpHostSeatFailure({ delivered: "no", condition: "the host seat's connection to this leg is closed" });
|
|
99
274
|
if (method !== "tools/list" && method !== "tools/call")
|
|
100
|
-
|
|
275
|
+
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
276
|
const stop = new AbortController();
|
|
102
277
|
this.inFlight.set(id, stop);
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
278
|
+
let answered;
|
|
279
|
+
try {
|
|
280
|
+
answered = responseOf(id, await this.seat.request(method, params, stop.signal));
|
|
281
|
+
}
|
|
282
|
+
catch (thrown) {
|
|
283
|
+
answered = failureOfThrown(thrown);
|
|
284
|
+
}
|
|
285
|
+
if (this.inFlight.get(id) !== stop)
|
|
286
|
+
return;
|
|
287
|
+
this.inFlight.delete(id);
|
|
288
|
+
if (answered instanceof McpHostSeatFailure)
|
|
289
|
+
throw answered;
|
|
290
|
+
this.deliver(answered);
|
|
116
291
|
}
|
|
117
292
|
async close() {
|
|
118
293
|
if (this.closed)
|
|
@@ -124,8 +299,7 @@ export class HostSeatTransport {
|
|
|
124
299
|
stop.abort(new Error("the connection to the host seat closed"));
|
|
125
300
|
this.onclose?.();
|
|
126
301
|
}
|
|
127
|
-
deliver(
|
|
128
|
-
const message = VERDICTS.has(answered) ? { jsonrpc: "2.0", id, error: { code: ErrorCode.InternalError, message: answered.condition, data: answered } } : answered;
|
|
302
|
+
deliver(message) {
|
|
129
303
|
queueMicrotask(() => this.onmessage?.(message));
|
|
130
304
|
}
|
|
131
305
|
}
|
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,
|
|
@@ -22,7 +22,8 @@ export interface McpServerSpec {
|
|
|
22
22
|
* peer seat ({@link RunnerDeps.peerSeat}). A `credentials` reference with no seat wired refuses the entry
|
|
23
23
|
* (`config.peer_seat_missing`); a declaration carrying the retired value members `headers` / `env` is refused at every
|
|
24
24
|
* entrance (`config.credential_in_declaration`). `host`: the host supplies the pipe itself — the leg's host seat of this
|
|
25
|
-
* declaration's `name` (`RunInternals.mcpHostSeats`, mcp-host-seat.ts)
|
|
25
|
+
* declaration's `name` (`RunInternals.mcpHostSeats`, mcp-host-seat.ts) hands one MCP transport per dial, and the server behind
|
|
26
|
+
* it answers the whole protocol (its handshake, instructions and resources included); the transport has no member beyond
|
|
26
27
|
* its kind (a host seat carries its own pieces, so a reference or a principal header has nothing to ride), and a server mounted
|
|
27
28
|
* this way cannot opt in to {@link elicitation} — both refused at every entrance (`config.invalid_argument`). It never enters
|
|
28
29
|
* the run tree's connection pool: its pipe is the leg's own.
|
|
@@ -10,8 +10,7 @@
|
|
|
10
10
|
* knows the session (404), cannot be reached or does not answer within {@link MCP_SESSION_END_WAIT_MS} costs the close that long at most
|
|
11
11
|
* and nothing else — the close runs regardless and aborts a request still in the air.
|
|
12
12
|
*/
|
|
13
|
-
import type
|
|
14
|
-
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
|
|
13
|
+
import { StreamableHTTPClientTransport, type Client } from "@modelcontextprotocol/client";
|
|
15
14
|
import type { McpRequestSite } from "./mcp-failure.js";
|
|
16
15
|
/** The longest a close waits for the server to answer the request that ends its session. */
|
|
17
16
|
export declare const MCP_SESSION_END_WAIT_MS = 2000;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/
|
|
1
|
+
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
|
|
2
2
|
export const MCP_SESSION_END_WAIT_MS = 2_000;
|
|
3
3
|
export class SessionEndingTransport extends StreamableHTTPClientTransport {
|
|
4
4
|
closing;
|
package/dist/core/mcp.d.ts
CHANGED
|
@@ -81,7 +81,7 @@ export interface McpDroppedTool {
|
|
|
81
81
|
* ({@link walkMcpListPages}'s `budgetMs`) had too little left to fund another request
|
|
82
82
|
* ({@link MIN_MCP_PAGE_BUDGET_MS}), so none was sent. Distinct from `page_error` on purpose — the
|
|
83
83
|
* server neither failed nor was asked. Issuing that request anyway would hand the SDK a
|
|
84
|
-
* near-zero timeout, and its
|
|
84
|
+
* near-zero timeout, and its `RequestTimeout` would arrive here wearing the server's failure clothes.
|
|
85
85
|
* `error` is SERVER-authored text — neutralize it before it rides any model/operator face.
|
|
86
86
|
*/
|
|
87
87
|
export interface McpListingIncomplete {
|
|
@@ -403,7 +403,7 @@ export declare function structuredContentErrorLine(structuredContent: unknown, c
|
|
|
403
403
|
export declare function truncateMcpErrorText(s: string): string;
|
|
404
404
|
/**
|
|
405
405
|
* Default per-call MCP tool timeout. The SDK's own default (60s) silently kills any long-running MCP tool
|
|
406
|
-
* with a
|
|
406
|
+
* with a `RequestTimeout` and offers the deployment no knob; a very large default (matching the behavior of the
|
|
407
407
|
* reference agent client) lets the task-level budget/abort govern instead, while `MCP_TOOL_TIMEOUT` (ms)
|
|
408
408
|
* remains available to tighten it per deployment.
|
|
409
409
|
*/
|
|
@@ -432,11 +432,11 @@ export declare function mcpToolTimeoutMs(): number;
|
|
|
432
432
|
* per-call timeout). The SDK's `resetTimeoutOnProgress` only re-arms the SDK's OWN per-call timer
|
|
433
433
|
* (`mcpToolTimeoutMs()` above — a different mechanism from {@link armMcpIdleWatchdog}'s idle watchdog
|
|
434
434
|
* below, despite the name-adjacent terms; disambiguated here on purpose, see that function's docstring
|
|
435
|
-
* for why sema needs both). It enforces a total bound ONLY when `maxTotalTimeout` is provided (protocol
|
|
436
|
-
* `_resetTimeout`), so without this a
|
|
435
|
+
* for why sema needs both). It enforces a total bound ONLY when `maxTotalTimeout` is provided (the protocol
|
|
436
|
+
* layer's `_resetTimeout`), so without this a
|
|
437
437
|
* misbehaving/stuck server emitting periodic progress notifications could extend a call forever. Defaulting
|
|
438
438
|
* the ceiling to the per-call timeout means progress can keep an active call alive only within the same
|
|
439
|
-
* window the deployment already accepted; the resulting failure is the same
|
|
439
|
+
* window the deployment already accepted; the resulting failure is the same `RequestTimeout` frame. Env
|
|
440
440
|
* parsing follows the `MCP_TOOL_TIMEOUT` discipline (unset/unparseable/non-positive → default). Exported
|
|
441
441
|
* for tests.
|
|
442
442
|
*/
|
|
@@ -448,7 +448,7 @@ export declare function mcpToolTotalTimeoutMs(perCallMs: number): number;
|
|
|
448
448
|
* from its total ceiling (`j7u` @345484: stdio 30min / http-sse 5min).
|
|
449
449
|
*
|
|
450
450
|
* Narrower than the audit's original framing: a CLOSED transport is already handled correctly by the SDK
|
|
451
|
-
* itself — `Protocol._onclose`
|
|
451
|
+
* itself — `Protocol._onclose` rejects every in-flight response handler immediately
|
|
452
452
|
* with `ConnectionClosed` the moment `onclose` fires, so this watchdog exists for the SILENT-but-open case
|
|
453
453
|
* only, not as a substitute for connection-close handling.
|
|
454
454
|
*/
|
|
@@ -470,15 +470,6 @@ export declare function mcpStartupTimeoutMs(server?: Pick<McpServerSpec, "name"
|
|
|
470
470
|
/** The protocol-range condition name for a JSON-RPC error code, or `undefined` for every other code
|
|
471
471
|
* (see {@link MCP_SPEC_ERROR_CODE_NAMES}). */
|
|
472
472
|
export declare function describeMcpSpecErrorCode(code: unknown): string | undefined;
|
|
473
|
-
/**
|
|
474
|
-
* The SDK stamps `MCP error <code>: ` onto an McpError's message IN ITS CONSTRUCTOR, and it
|
|
475
|
-
* does so at BOTH ends of the wire: a server built on an MCP SDK throws an McpError, its already-stamped
|
|
476
|
-
* `.message` goes out as the JSON-RPC `error.message`, and the client constructs its own McpError over
|
|
477
|
-
* that string — so the failure reaches the model as `MCP error -32602: MCP error -32602: …`. Collapse a
|
|
478
|
-
* repeat of the SAME code (a leading stamp carrying a DIFFERENT code is server data, not a duplicate of
|
|
479
|
-
* ours, and is left alone). Exported for unit testing; not part of the package index.
|
|
480
|
-
*/
|
|
481
|
-
export declare function collapseMcpErrorPrefix(message: string): string;
|
|
482
473
|
export { normalizeNameSegment as normalizeMcpName, clampNameSegment } from "./protocol-naming.js";
|
|
483
474
|
export * from "./image-downsample.js";
|
|
484
475
|
/**
|
|
@@ -735,37 +726,3 @@ export declare function walkMcpListPages<T>(fetchPage: (cursor: string | undefin
|
|
|
735
726
|
items: T[];
|
|
736
727
|
incomplete?: McpListingIncomplete;
|
|
737
728
|
}>;
|
|
738
|
-
/**
|
|
739
|
-
* RB-408 G12 — `tools/call` result parse that accepts the MCP `2026-07-28` widening of
|
|
740
|
-
* `structuredContent` from "a JSON object" to ANY JSON value (the same revision that relaxes
|
|
741
|
-
* `inputSchema`/`outputSchema` to the full JSON Schema 2020-12 keyword set).
|
|
742
|
-
*
|
|
743
|
-
* SDK 1.30.0's `CallToolResultSchema` still types the field as a record, so a spec-legal array / string /
|
|
744
|
-
* number / boolean / null fails validation for the WHOLE result — and the failure takes the `content`
|
|
745
|
-
* blocks down with it: a server returning perfectly usable text plus a scalar `structuredContent`
|
|
746
|
-
* produced nothing but `Invalid tools/call result: expected record, received number`. That is a silent
|
|
747
|
-
* capability loss dressed as a protocol error, and it gets WORSE as servers adopt the revision.
|
|
748
|
-
*
|
|
749
|
-
* The widening is deliberately surgical: `structuredContent` is lifted out, the SDK's own strict schema
|
|
750
|
-
* runs over the remainder (so content-block validation, the `content` default and the loose passthrough
|
|
751
|
-
* of unknown top-level keys are byte-for-byte what they were), and the lifted value is re-attached
|
|
752
|
-
* VERBATIM — same reference, no rebuild. An object-valued `structuredContent` therefore behaves exactly
|
|
753
|
-
* as before, and a malformed `content` array is still rejected: this must not become a validation bypass.
|
|
754
|
-
* Same duck-typing posture as {@link LenientListToolsResultSchema} (no direct `zod` dependency — the SDK's
|
|
755
|
-
* `zod-compat` shim calls `.safeParse(data)` on any object lacking a Zod-4 `_zod` marker).
|
|
756
|
-
*
|
|
757
|
-
* RESIDUAL, SDK-side and deliberately not widened here: `Client.callTool` guards its `outputSchema`
|
|
758
|
-
* validation with a TRUTHINESS test on `result.structuredContent`, so a tool that declares an
|
|
759
|
-
* `outputSchema` and returns a falsy scalar (`0`, `""`, `false`, `null`) is still rejected by the SDK with
|
|
760
|
-
* "has an output schema but did not return structured content". That path is LOUD (never a silent drop),
|
|
761
|
-
* is bounded to outputSchema-declaring tools, and widening it means replacing `callTool` itself — which
|
|
762
|
-
* would mean re-implementing the two guards it exists for (the output validator and the
|
|
763
|
-
* `taskSupport:"required"` refusal, both keyed off SDK-private caches).
|
|
764
|
-
*/
|
|
765
|
-
export declare function parseCallToolResultLenient(data: unknown): {
|
|
766
|
-
success: true;
|
|
767
|
-
data: unknown;
|
|
768
|
-
} | {
|
|
769
|
-
success: false;
|
|
770
|
-
error: unknown;
|
|
771
|
-
};
|