@sema-agent/core 7.59.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 +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- 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 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- 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.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- 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 +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- 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/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- 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-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- 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/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- 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 +106 -32
- 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 +15 -0
- package/dist/core/frame-settlement.js +10 -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 +9 -6
- package/dist/core/gate-lanes.js +46 -12
- 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 +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -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 +55 -3
- package/dist/core/locked-config.js +84 -51
- 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-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -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 +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- 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 +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- 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 +23 -55
- package/dist/core/mcp.js +172 -156
- 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-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- 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/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- 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/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- 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 +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- 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 +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- 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 +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- 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 +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- 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/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- 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/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -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 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- 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/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- 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 +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- 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/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- 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/memory-consolidation-driver.js +4 -4
- 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 +29 -10
- 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 +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- 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 +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- 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-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -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 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- 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-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- 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-checkpoint-screen.js +4 -4
- 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 +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- 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 +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- 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/skills-seat.js +2 -2
- 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/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- 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 -4
- 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.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- 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-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- 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 +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- 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 +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- 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 +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- 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.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- 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 +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- 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 +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- 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 +3 -6
- 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.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- 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 +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- 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 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- 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 +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- 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 +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- 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 +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- 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.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- 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.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -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/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- 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 +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- 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 +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -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
package/dist/core/peer-seat.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { SdkHttpError } from "@modelcontextprotocol/client";
|
|
2
2
|
import { type CredentialRef } from "@sema-agent/primitives";
|
|
3
|
-
import type
|
|
3
|
+
import { type McpServerSpec, type McpTransportKind } from "./mcp-server-spec.js";
|
|
4
4
|
import type { ProtocolId } from "./protocol-table.js";
|
|
5
5
|
/** Why the seat is asked: the first send of a connection, any later send, or the send after a 401. */
|
|
6
6
|
export type PeerAskCause = "connect" | "request" | "rejected";
|
|
@@ -40,7 +40,7 @@ export interface PeerQuestion {
|
|
|
40
40
|
}
|
|
41
41
|
/**
|
|
42
42
|
* The seat's answer: the pieces to carry (`headers` for an http request and an A2A send, `env` for a stdio child — the member of the
|
|
43
|
-
* other lane is refused; `expiresAt`, epoch
|
|
43
|
+
* other lane is refused; `expiresAt`, a non-negative epoch-millisecond number, is read by a stdio child only; a header value is held to the HTTP request grammar and an env value to what a spawn hands the child unchanged), or that the principal is not authorized here.
|
|
44
44
|
*/
|
|
45
45
|
export type PeerAnswer = {
|
|
46
46
|
readonly kind: "carry";
|
|
@@ -52,10 +52,26 @@ export type PeerAnswer = {
|
|
|
52
52
|
readonly authorizeUrl?: string;
|
|
53
53
|
};
|
|
54
54
|
/**
|
|
55
|
-
* The deployment's peer seat (`RunnerDeps.peerSeat`, TRUSTED)
|
|
56
|
-
*
|
|
55
|
+
* The deployment's peer seat (`RunnerDeps.peerSeat`, TRUSTED): one object, three members, all required.
|
|
56
|
+
* · `answer` — what one send carries. It owes the binding the engine cannot judge: answer only for the reference, principal,
|
|
57
|
+
* protocol and destination (or start command) it was asked about — never one token for every peer.
|
|
58
|
+
* · `hold` / `release` — an engine object started / stopped keeping a declaration that names `ref` (see the module note): called
|
|
59
|
+
* once each per keeper and distinct reference, `release` only for a `hold` that succeeded (it returned, or the promise it returned
|
|
60
|
+
* fulfilled — a release due before then is sent then); the reference is a frozen copy, never a value, never a session. A seat that
|
|
61
|
+
* keeps no state per reference makes both no-ops. A throw or a rejection is reported (`onError`, phase `config`) and changes
|
|
62
|
+
* nothing else: a `hold` that failed is not held and gets no `release`.
|
|
57
63
|
*/
|
|
58
|
-
export
|
|
64
|
+
export interface PeerSeat {
|
|
65
|
+
answer(question: PeerQuestion, signal: AbortSignal): Promise<PeerAnswer>;
|
|
66
|
+
hold(ref: CredentialRef): void;
|
|
67
|
+
release(ref: CredentialRef): void;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* The one reader of a peer seat handed to the engine (`new Runner`, the three library entrances): absent ⇒ `undefined`; else an
|
|
71
|
+
* object whose three members are functions, each read once and kept bound to that object in a frozen copy — or refused
|
|
72
|
+
* (`config.invalid_argument`) naming what does not fit. A function is the form before 7.60.0: refused with the form that replaced it.
|
|
73
|
+
*/
|
|
74
|
+
export declare function receivePeerSeat(raw: unknown, subject: string): PeerSeat | undefined;
|
|
59
75
|
/** Which answer member each transport carries. */
|
|
60
76
|
export declare const PEER_ANSWER_LANES: Readonly<{
|
|
61
77
|
readonly http: "headers";
|
|
@@ -105,7 +121,7 @@ export declare class PeerSeatFailure extends Error {
|
|
|
105
121
|
/**
|
|
106
122
|
* An MCP HTTP request the endpoint refused for its authorization — a 401, or a 403 whose Bearer challenge says `insufficient_scope`
|
|
107
123
|
* (RFC 6750 §3.1) — raised by the one fetch ({@link peerFetch}) in place of the SDK's status error, which keeps no header. It IS the
|
|
108
|
-
* SDK's status error (same class, same `
|
|
124
|
+
* SDK's status error (same class, same `status`), so every structural reader of a status reads it unchanged; it adds what the response
|
|
109
125
|
* said and what the re-ask after a 401 answered:
|
|
110
126
|
* · `reason` — `rejected` (401) or `scope` (403);
|
|
111
127
|
* · `resourceMetadataUrl` — the Bearer challenge's `resource_metadata` ({@link bearerChallengeParams}), the REMOTE's claim, read by
|
|
@@ -117,7 +133,7 @@ export declare class PeerSeatFailure extends Error {
|
|
|
117
133
|
* The text is the engine's sentence followed by the response body as the SDK's own error would have carried it (bounded to
|
|
118
134
|
* {@link REFUSAL_BODY_MAX} characters) — REMOTE text, read by every face through the one remote-words reading like any status body.
|
|
119
135
|
*/
|
|
120
|
-
export declare class PeerAuthorizationRefused extends
|
|
136
|
+
export declare class PeerAuthorizationRefused extends SdkHttpError {
|
|
121
137
|
readonly reason: "rejected" | "scope";
|
|
122
138
|
readonly resourceMetadataUrl: string | undefined;
|
|
123
139
|
readonly authorizeUrl: string | undefined;
|
|
@@ -140,7 +156,9 @@ export interface CarriedPieces {
|
|
|
140
156
|
readonly expiresAt?: number;
|
|
141
157
|
readonly digest: string;
|
|
142
158
|
}
|
|
143
|
-
/** The seat's answer for `lane`, read once: the pieces, the `unauthorized` answer, or the problem (which member did not fit).
|
|
159
|
+
/** The seat's answer for `lane`, read once: the pieces, the `unauthorized` answer, or the problem (which member did not fit). The
|
|
160
|
+
* answer's members are its OWN members (a member its prototype would supply is not read), and each value is judged by the grammar of
|
|
161
|
+
* the send that will carry it ({@link VALUE_LAW}). */
|
|
144
162
|
export declare function readPeerAnswer(raw: unknown, lane: PeerLane): {
|
|
145
163
|
readonly carry: CarriedPieces;
|
|
146
164
|
} | {
|
|
@@ -150,6 +168,24 @@ export declare function readPeerAnswer(raw: unknown, lane: PeerLane): {
|
|
|
150
168
|
} | {
|
|
151
169
|
readonly problem: string;
|
|
152
170
|
};
|
|
171
|
+
/** Declarations as a keeper holds them: a spec's (or a spec snapshot's) `mcp` and `a2a` lists, read as given. */
|
|
172
|
+
export interface PeerDeclarations {
|
|
173
|
+
readonly mcp?: unknown;
|
|
174
|
+
readonly a2a?: unknown;
|
|
175
|
+
}
|
|
176
|
+
/** One keeper's hold on the references its declarations name (see the module note), taken when it is made. */
|
|
177
|
+
export interface PeerDeclarationHold {
|
|
178
|
+
/** Release every reference this keeper holds, each once. A second call does nothing. */
|
|
179
|
+
release(): void;
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* A keeper's hold: `seat.hold` once for each distinct reference (by its canonical form) `declared` names, now, and one `seat.release`
|
|
183
|
+
* for each hold that succeeded, at `release`. A hold succeeds when it returns — or, when it returns a promise, when that promise
|
|
184
|
+
* fulfils (a release asked for before then is sent then). No seat ⇒ nothing is held (a declared reference is refused at the door). A
|
|
185
|
+
* seat member that throws or whose promise rejects reaches `onFault` as the engine's own sentence (the seat's error is not repeated:
|
|
186
|
+
* deployment code may put a value in it); a hold that failed is not held and gets no release.
|
|
187
|
+
*/
|
|
188
|
+
export declare function holdPeerDeclarations(seat: PeerSeat | undefined, declared: PeerDeclarations, onFault: (err: Error) => void): PeerDeclarationHold;
|
|
153
189
|
/** What the re-ask after a 401 said: whether it answered other pieces than the refused send carried, and the seat's `authorizeUrl` when it answered `unauthorized`. */
|
|
154
190
|
export interface PeerReask {
|
|
155
191
|
readonly renewed: boolean;
|
|
@@ -167,13 +203,17 @@ export declare class PeerCarrier {
|
|
|
167
203
|
private readonly principal;
|
|
168
204
|
private readonly lane;
|
|
169
205
|
readonly sent: string[];
|
|
206
|
+
/** Every credential value the seat's answers handed this connection, accepted or refused ({@link answeredCredentialValues}), that the
|
|
207
|
+
* withheld table holds (one that names a secret, `namesASecret`: never a blank one, a placeholder or a short dev key) — the needle a
|
|
208
|
+
* remote's account of itself is read without. */
|
|
209
|
+
readonly credentials: string[];
|
|
170
210
|
/** When the pieces a stdio child was started with stop being good; `undefined` when the answer said nothing. */
|
|
171
211
|
expiresAt: number | undefined;
|
|
172
212
|
renewed: boolean;
|
|
173
213
|
private asked;
|
|
174
214
|
private waiting;
|
|
175
215
|
private rejection;
|
|
176
|
-
constructor(seat: PeerSeat | undefined, identity:
|
|
216
|
+
constructor(seat: PeerSeat | undefined, identity: PeerCarrierIdentity, principal: string | undefined, lane: PeerLane, principalSent: boolean);
|
|
177
217
|
/** The peer as the refusal sentences name it. */
|
|
178
218
|
get label(): string;
|
|
179
219
|
/** The pieces the next send carries (see the class note). A seat failure throws {@link PeerSeatFailure}. */
|
|
@@ -188,6 +228,14 @@ export declare class PeerCarrier {
|
|
|
188
228
|
/** Whether the pieces a stdio child was started with have stopped being good. */
|
|
189
229
|
expired(now?: number): boolean;
|
|
190
230
|
private ask;
|
|
231
|
+
/**
|
|
232
|
+
* THE one intake of a seat's answer: every credential value it hands ({@link answeredCredentialValues}) is a value the engine now
|
|
233
|
+
* holds — no child spawned on this host inherits a variable holding it — and a credential of this connection's sends
|
|
234
|
+
* ({@link PeerCarrier.credentials}). Asked of the answer as given, before it is judged, and of the judge's copy of an accepted answer
|
|
235
|
+
* (the pieces that are sent). Each value is held on its own, so one that cannot be withheld (the value of a variable every child is
|
|
236
|
+
* handed) does not keep the others out; the answer is then refused, after the rest were held.
|
|
237
|
+
*/
|
|
238
|
+
private holdAnswered;
|
|
191
239
|
private remember;
|
|
192
240
|
}
|
|
193
241
|
/**
|
|
@@ -226,8 +274,15 @@ export declare function declaredCredentials(copy: object, at: keyof typeof CREDE
|
|
|
226
274
|
export declare function peerSeatMissing(subject: string, credentials: CredentialRef | undefined, seat: PeerSeat | undefined): (Error & {
|
|
227
275
|
code: string;
|
|
228
276
|
}) | undefined;
|
|
277
|
+
/** A carrier's identity: the peer the seat is asked about, or a server on a host-supplied transport — whose host seat carries its own
|
|
278
|
+
* pieces, so the peer seat is never asked about it (its carrier carries nothing). */
|
|
279
|
+
export type PeerCarrierIdentity = PeerSeatTarget | {
|
|
280
|
+
readonly protocol: "mcp";
|
|
281
|
+
readonly server: string;
|
|
282
|
+
readonly transport: "host";
|
|
283
|
+
};
|
|
229
284
|
/** Who an MCP server is, as the seat is asked about it: its name, the whole start command or endpoint, its reference, its mount identity. */
|
|
230
|
-
export declare function mcpPeerTarget(spec: McpServerSpec, kind:
|
|
285
|
+
export declare function mcpPeerTarget(spec: McpServerSpec, kind: McpTransportKind | undefined): PeerCarrierIdentity;
|
|
231
286
|
/** Whether a failure is the HTTP endpoint answering 401 (the SDK's status error, on the thrown value or its cause chain). Structure only. */
|
|
232
287
|
export declare function answeredUnauthorized(err: unknown): boolean;
|
|
233
288
|
/** A call answered 401 after which the seat's re-ask answered other pieces: its failure as it would have been thrown then. */
|
package/dist/core/peer-seat.js
CHANGED
|
@@ -1,10 +1,42 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
-
import {
|
|
2
|
+
import { types } from "node:util";
|
|
3
|
+
import { SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
|
|
4
|
+
import { canonicalize } from "./canonical-json.js";
|
|
3
5
|
import { readCredentialRef } from "@sema-agent/primitives";
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
6
|
+
import { callerText } from "./mcp-server-spec.js";
|
|
7
|
+
import { optionKeys, strayMembersOf } from "./own-property-receipt.js";
|
|
8
|
+
import { readMember, readOwnMembers } from "./thrown-value.js";
|
|
9
|
+
import { httpTrimmed, resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
|
|
10
|
+
import { credentialHeaderValues, holdOwnCredentialValues, isSecretEnvKey, namesASecret } from "./secret-env.js";
|
|
7
11
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
12
|
+
const PEER_SEAT_MEMBERS = Object.freeze(["answer", "hold", "release"]);
|
|
13
|
+
export function receivePeerSeat(raw, subject) {
|
|
14
|
+
if (raw === undefined)
|
|
15
|
+
return undefined;
|
|
16
|
+
const refuse = (problem) => Object.assign(new Error(`${subject} ${problem} — the peer seat is an object { answer(question, signal), hold(ref), release(ref) }`), { code: "config.invalid_argument" });
|
|
17
|
+
if (typeof raw === "function")
|
|
18
|
+
throw refuse("is a function (the answer alone): put it under `answer` and add `hold` / `release`");
|
|
19
|
+
if (typeof raw !== "object" || raw === null || types.isProxy(raw))
|
|
20
|
+
throw refuse(raw === null ? "is null" : typeof raw !== "object" ? `is a ${typeof raw}` : "is a Proxy");
|
|
21
|
+
const read = Object.create(null);
|
|
22
|
+
for (const name of PEER_SEAT_MEMBERS) {
|
|
23
|
+
let member;
|
|
24
|
+
try {
|
|
25
|
+
member = Reflect.get(raw, name);
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
throw refuse(`threw while its \`${name}\` was read`);
|
|
29
|
+
}
|
|
30
|
+
if (typeof member !== "function")
|
|
31
|
+
throw refuse(`has no \`${name}\` function`);
|
|
32
|
+
read[name] = member;
|
|
33
|
+
}
|
|
34
|
+
return Object.freeze({
|
|
35
|
+
answer: (question, signal) => Reflect.apply(read.answer, raw, [question, signal]),
|
|
36
|
+
hold: (ref) => Reflect.apply(read.hold, raw, [ref]),
|
|
37
|
+
release: (ref) => Reflect.apply(read.release, raw, [ref]),
|
|
38
|
+
});
|
|
39
|
+
}
|
|
8
40
|
export const PEER_ANSWER_LANES = Object.freeze({ http: "headers", a2a: "headers", stdio: "env" });
|
|
9
41
|
export const PEER_SEAT_WAIT_MS = 30_000;
|
|
10
42
|
export const AUTHORIZATION_URL_MAX = 2048;
|
|
@@ -110,14 +142,15 @@ export class PeerSeatFailure extends Error {
|
|
|
110
142
|
this.code = extra?.code ?? (reason === "answer_invalid" ? "config.peer_answer_invalid" : undefined);
|
|
111
143
|
}
|
|
112
144
|
}
|
|
113
|
-
export class PeerAuthorizationRefused extends
|
|
145
|
+
export class PeerAuthorizationRefused extends SdkHttpError {
|
|
114
146
|
reason;
|
|
115
147
|
resourceMetadataUrl;
|
|
116
148
|
authorizeUrl;
|
|
117
149
|
renewed;
|
|
118
150
|
constructor(reason, facts) {
|
|
119
151
|
const lead = reason === "rejected" ? "the endpoint refused the request's authorization (HTTP 401)" : "the endpoint refused the request for insufficient scope (HTTP 403)";
|
|
120
|
-
|
|
152
|
+
const text = facts.body !== undefined && facts.body !== "" ? `${lead}: ${facts.body}` : lead;
|
|
153
|
+
super(reason === "rejected" ? SdkErrorCode.ClientHttpAuthentication : SdkErrorCode.ClientHttpForbidden, text, { status: reason === "rejected" ? 401 : 403 });
|
|
121
154
|
this.name = "PeerAuthorizationRefused";
|
|
122
155
|
this.reason = reason;
|
|
123
156
|
this.resourceMetadataUrl = facts.resourceMetadataUrl;
|
|
@@ -137,26 +170,33 @@ export function refusedThenRenewed(err) {
|
|
|
137
170
|
}
|
|
138
171
|
const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
|
|
139
172
|
const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
140
|
-
const
|
|
141
|
-
|
|
173
|
+
const VALUE_LAW = Object.freeze({
|
|
174
|
+
headers: Object.freeze({ refuses: /[^\t\x20-\x7e\x80-\xff]/, holds: "a character an HTTP header value cannot carry" }),
|
|
175
|
+
env: Object.freeze({ refuses: /[\r\n\0]|\p{Surrogate}/u, holds: "a line break, a NUL or a lone surrogate" }),
|
|
176
|
+
});
|
|
177
|
+
const ANSWER_MEMBERS = Object.freeze({
|
|
178
|
+
carry: optionKeys()({ kind: 0, headers: 0, env: 0, expiresAt: 0 }),
|
|
179
|
+
unauthorized: optionKeys()({ kind: 0, authorizeUrl: 0 }),
|
|
180
|
+
});
|
|
142
181
|
const digestOf = (pieces) => {
|
|
143
182
|
const rows = (m) => Object.entries(m ?? {}).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
|
|
144
183
|
return createHash("sha256").update(JSON.stringify([rows(pieces.headers), rows(pieces.env)])).digest("hex");
|
|
145
184
|
};
|
|
146
185
|
const NO_PIECES = Object.freeze({ digest: digestOf({}) });
|
|
147
186
|
function nameValues(raw, member) {
|
|
148
|
-
|
|
187
|
+
const members = readOwnMembers(raw);
|
|
188
|
+
if (members === undefined)
|
|
149
189
|
return `its ${member} is not a record of names to strings`;
|
|
150
190
|
const out = Object.create(null);
|
|
151
191
|
const folded = new Set();
|
|
152
|
-
for (const name of Object.keys(
|
|
153
|
-
const value =
|
|
192
|
+
for (const name of Object.keys(members)) {
|
|
193
|
+
const value = members[name];
|
|
154
194
|
if (typeof value !== "string")
|
|
155
195
|
return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} is not a string`;
|
|
156
196
|
if (!(member === "headers" ? HEADER_NAME : ENV_NAME).test(name))
|
|
157
197
|
return `its ${member} name ${inlineUntrusted(JSON.stringify(name), 80)} is not a ${member === "headers" ? "header" : "variable"} name`;
|
|
158
|
-
if (
|
|
159
|
-
return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} holds
|
|
198
|
+
if (VALUE_LAW[member].refuses.test(value))
|
|
199
|
+
return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} holds ${VALUE_LAW[member].holds}`;
|
|
160
200
|
if (member === "headers") {
|
|
161
201
|
if (folded.has(name.toLowerCase()))
|
|
162
202
|
return `its headers name ${inlineUntrusted(JSON.stringify(name), 80)} twice (header names are case-insensitive)`;
|
|
@@ -171,30 +211,31 @@ export function readPeerAnswer(raw, lane) {
|
|
|
171
211
|
if (typeof raw !== "object" || raw === null || Array.isArray(raw))
|
|
172
212
|
return { problem: "answered something that is not an answer record" };
|
|
173
213
|
const record = raw;
|
|
174
|
-
const
|
|
214
|
+
const memberOf = (name) => (Object.hasOwn(record, name) ? record[name] : undefined);
|
|
215
|
+
const kind = memberOf("kind");
|
|
175
216
|
if (kind !== "carry" && kind !== "unauthorized")
|
|
176
217
|
return { problem: `answered the kind ${inlineUntrusted(JSON.stringify(kind) ?? String(kind), 80)}, which is neither "carry" nor "unauthorized"` };
|
|
177
|
-
const extra =
|
|
218
|
+
const extra = strayMembersOf(record, { subject: "the peer seat's answer", unit: "member", moment: "when the answer is read" }, ANSWER_MEMBERS[kind])?.names[0];
|
|
178
219
|
if (extra !== undefined)
|
|
179
|
-
return { problem: `answered the member ${inlineUntrusted(JSON.stringify(extra), 80)}, which a "${kind}" answer does not have` };
|
|
220
|
+
return { problem: `answered the member ${inlineUntrusted(JSON.stringify(String(extra)), 80)}, which a "${kind}" answer does not have` };
|
|
180
221
|
if (kind === "unauthorized") {
|
|
181
|
-
const
|
|
182
|
-
if (
|
|
222
|
+
const given = memberOf("authorizeUrl");
|
|
223
|
+
if (given === undefined)
|
|
183
224
|
return { unauthorized: {} };
|
|
184
|
-
const url = authorizationUrlOf(
|
|
225
|
+
const url = authorizationUrlOf(given);
|
|
185
226
|
if (url === undefined)
|
|
186
227
|
return { problem: `answered an authorizeUrl that is not an absolute http(s) URL without user-info, of at most ${AUTHORIZATION_URL_MAX} characters, without control characters` };
|
|
187
228
|
return { unauthorized: { authorizeUrl: url } };
|
|
188
229
|
}
|
|
189
230
|
const own = PEER_ANSWER_LANES[lane];
|
|
190
231
|
const other = own === "headers" ? "env" : "headers";
|
|
191
|
-
if (
|
|
232
|
+
if (memberOf(other) !== undefined)
|
|
192
233
|
return { problem: `answered ${other} for a ${lane} peer, which carries ${own} only` };
|
|
193
|
-
const expiresAt =
|
|
194
|
-
if (expiresAt !== undefined && (typeof expiresAt !== "number" || !Number.isFinite(expiresAt)))
|
|
195
|
-
return { problem: "answered an expiresAt that is not a finite epoch-millisecond number" };
|
|
196
|
-
const
|
|
197
|
-
const values =
|
|
234
|
+
const expiresAt = memberOf("expiresAt");
|
|
235
|
+
if (expiresAt !== undefined && (typeof expiresAt !== "number" || !Number.isFinite(expiresAt) || expiresAt < 0))
|
|
236
|
+
return { problem: "answered an expiresAt that is not a finite, non-negative epoch-millisecond number" };
|
|
237
|
+
const carried = memberOf(own);
|
|
238
|
+
const values = carried === undefined ? undefined : nameValues(carried, own);
|
|
198
239
|
if (typeof values === "string")
|
|
199
240
|
return { problem: `answered ${values}` };
|
|
200
241
|
const lanePieces = values === undefined ? {} : { [own]: values };
|
|
@@ -204,6 +245,86 @@ export function readPeerAnswer(raw, lane) {
|
|
|
204
245
|
return { problem: "answered a record whose members could not be read" };
|
|
205
246
|
}
|
|
206
247
|
}
|
|
248
|
+
function dataMember(holder, key) {
|
|
249
|
+
if (typeof holder !== "object" || holder === null || types.isProxy(holder))
|
|
250
|
+
return undefined;
|
|
251
|
+
const descriptor = Object.getOwnPropertyDescriptor(holder, key);
|
|
252
|
+
return descriptor !== undefined && Object.hasOwn(descriptor, "value") ? descriptor.value : undefined;
|
|
253
|
+
}
|
|
254
|
+
function declaredReferences(declared) {
|
|
255
|
+
const refs = [];
|
|
256
|
+
for (const [list, path] of [[dataMember(declared, "mcp"), CREDENTIALS_MEMBER.mcp], [dataMember(declared, "a2a"), CREDENTIALS_MEMBER.a2a]]) {
|
|
257
|
+
if (!Array.isArray(list) || types.isProxy(list))
|
|
258
|
+
continue;
|
|
259
|
+
const length = dataMember(list, "length");
|
|
260
|
+
for (let index = 0; typeof length === "number" && index < length; index++) {
|
|
261
|
+
let at = dataMember(list, String(index));
|
|
262
|
+
for (const key of path)
|
|
263
|
+
at = dataMember(at, key);
|
|
264
|
+
if (at === undefined || (typeof at === "object" && at !== null && types.isProxy(at)))
|
|
265
|
+
continue;
|
|
266
|
+
const read = readCredentialRef(at);
|
|
267
|
+
if (read.ok)
|
|
268
|
+
refs.push(read.ref);
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
return refs;
|
|
272
|
+
}
|
|
273
|
+
export function holdPeerDeclarations(seat, declared, onFault) {
|
|
274
|
+
let released = false;
|
|
275
|
+
const holds = [];
|
|
276
|
+
const fault = (member, ref) => onFault(new Error(`the deployment's peer seat threw from \`${member}\` for a "${ref.kind}" reference${member === "hold" ? " — the reference is not held" : ""}`));
|
|
277
|
+
const call = (member, ref) => {
|
|
278
|
+
let returned;
|
|
279
|
+
try {
|
|
280
|
+
returned = seat[member](ref);
|
|
281
|
+
}
|
|
282
|
+
catch {
|
|
283
|
+
fault(member, ref);
|
|
284
|
+
return false;
|
|
285
|
+
}
|
|
286
|
+
if (typeof returned?.then !== "function")
|
|
287
|
+
return true;
|
|
288
|
+
return Promise.resolve(returned).then(() => true, () => (fault(member, ref), false));
|
|
289
|
+
};
|
|
290
|
+
if (seat !== undefined) {
|
|
291
|
+
const seen = new Set();
|
|
292
|
+
for (const ref of declaredReferences(declared)) {
|
|
293
|
+
const key = canonicalize(ref);
|
|
294
|
+
if (seen.has(key))
|
|
295
|
+
continue;
|
|
296
|
+
seen.add(key);
|
|
297
|
+
const outcome = call("hold", ref);
|
|
298
|
+
if (outcome === false)
|
|
299
|
+
continue;
|
|
300
|
+
if (outcome === true) {
|
|
301
|
+
holds.push(() => void call("release", ref));
|
|
302
|
+
continue;
|
|
303
|
+
}
|
|
304
|
+
let releaseAsked = false;
|
|
305
|
+
let fulfilled = false;
|
|
306
|
+
void outcome.then((ok) => {
|
|
307
|
+
fulfilled = ok;
|
|
308
|
+
if (ok && releaseAsked)
|
|
309
|
+
void call("release", ref);
|
|
310
|
+
});
|
|
311
|
+
holds.push(() => {
|
|
312
|
+
releaseAsked = true;
|
|
313
|
+
if (fulfilled)
|
|
314
|
+
void call("release", ref);
|
|
315
|
+
});
|
|
316
|
+
}
|
|
317
|
+
}
|
|
318
|
+
return {
|
|
319
|
+
release() {
|
|
320
|
+
if (released)
|
|
321
|
+
return;
|
|
322
|
+
released = true;
|
|
323
|
+
for (const releaseOne of holds.splice(0))
|
|
324
|
+
releaseOne();
|
|
325
|
+
},
|
|
326
|
+
};
|
|
327
|
+
}
|
|
207
328
|
async function askBounded(seat, question, signal) {
|
|
208
329
|
signal?.throwIfAborted();
|
|
209
330
|
const wait = new AbortController();
|
|
@@ -213,7 +334,7 @@ async function askBounded(seat, question, signal) {
|
|
|
213
334
|
try {
|
|
214
335
|
const stopped = new Promise((_, reject) => stop.addEventListener("abort", () => reject(stop.reason), { once: true }));
|
|
215
336
|
stopped.catch(() => undefined);
|
|
216
|
-
return { answer: await Promise.race([seat(question, stop), stopped]) };
|
|
337
|
+
return { answer: await Promise.race([seat.answer(question, stop), stopped]) };
|
|
217
338
|
}
|
|
218
339
|
catch (err) {
|
|
219
340
|
if (signal?.aborted === true)
|
|
@@ -230,6 +351,7 @@ export class PeerCarrier {
|
|
|
230
351
|
principal;
|
|
231
352
|
lane;
|
|
232
353
|
sent = [];
|
|
354
|
+
credentials = [];
|
|
233
355
|
expiresAt;
|
|
234
356
|
renewed = false;
|
|
235
357
|
asked = false;
|
|
@@ -278,40 +400,66 @@ export class PeerCarrier {
|
|
|
278
400
|
return this.expiresAt !== undefined && now >= this.expiresAt;
|
|
279
401
|
}
|
|
280
402
|
async ask(cause, signal, destination) {
|
|
281
|
-
|
|
403
|
+
const identity = this.identity;
|
|
404
|
+
if (this.seat === undefined || (identity.protocol === "mcp" && identity.transport === "host"))
|
|
282
405
|
return NO_PIECES;
|
|
283
|
-
const peer =
|
|
406
|
+
const peer = identity.protocol === "a2a" && destination !== undefined ? { ...identity, destination } : identity;
|
|
284
407
|
const asked = await askBounded(this.seat, { peer, ...(this.principal !== undefined ? { principal: this.principal } : {}), cause }, signal);
|
|
285
408
|
if ("failed" in asked)
|
|
286
409
|
throw new PeerSeatFailure(asked.failed, this.label, asked.failed === "timed_out" ? `did not answer within ${PEER_SEAT_WAIT_MS} ms` : "threw");
|
|
410
|
+
this.holdAnswered(asked.answer);
|
|
287
411
|
const read = readPeerAnswer(asked.answer, this.lane);
|
|
288
412
|
if ("problem" in read)
|
|
289
413
|
throw new PeerSeatFailure("answer_invalid", this.label, read.problem);
|
|
290
414
|
if ("unauthorized" in read)
|
|
291
415
|
throw new PeerSeatFailure("unauthorized", this.label, "answered that this principal is not authorized", read.unauthorized.authorizeUrl === undefined ? undefined : { authorizeUrl: read.unauthorized.authorizeUrl });
|
|
292
416
|
const pieces = read.carry;
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
holdOwnCredentialValues(held);
|
|
297
|
-
}
|
|
298
|
-
catch {
|
|
299
|
-
throw new PeerSeatFailure("answer_invalid", this.label, "answered an environment value that is the value of a variable every child on this host is handed");
|
|
300
|
-
}
|
|
301
|
-
for (const value of held)
|
|
417
|
+
this.holdAnswered(pieces);
|
|
418
|
+
for (const [name, value] of Object.entries(pieces.env ?? {}))
|
|
419
|
+
if (isSecretEnvKey(name, value))
|
|
302
420
|
this.remember(value);
|
|
303
|
-
}
|
|
304
421
|
if (this.lane === "stdio")
|
|
305
422
|
this.expiresAt = pieces.expiresAt;
|
|
306
423
|
for (const value of Object.values(pieces.headers ?? {}))
|
|
307
424
|
this.remember(value);
|
|
308
425
|
return pieces;
|
|
309
426
|
}
|
|
427
|
+
holdAnswered(answer) {
|
|
428
|
+
let refused;
|
|
429
|
+
for (const value of answeredCredentialValues(answer)) {
|
|
430
|
+
try {
|
|
431
|
+
holdOwnCredentialValues([value]);
|
|
432
|
+
}
|
|
433
|
+
catch (err) {
|
|
434
|
+
refused ??= err instanceof Error ? err.message : "the value of a variable every child on this host is handed";
|
|
435
|
+
}
|
|
436
|
+
if (namesASecret(value) && !this.credentials.includes(value))
|
|
437
|
+
this.credentials.push(value);
|
|
438
|
+
}
|
|
439
|
+
if (refused !== undefined)
|
|
440
|
+
throw new PeerSeatFailure("answer_invalid", this.label, `answered a credential value the engine cannot withhold (${inlineUntrusted(refused, 240)})`);
|
|
441
|
+
}
|
|
310
442
|
remember(value) {
|
|
311
443
|
if (value !== "" && !this.sent.includes(value))
|
|
312
444
|
this.sent.push(value);
|
|
313
445
|
}
|
|
314
446
|
}
|
|
447
|
+
function answeredCredentialValues(answer) {
|
|
448
|
+
const found = new Set();
|
|
449
|
+
const members = readOwnMembers(answer) ?? {};
|
|
450
|
+
for (const [name, value] of stringMembers(members["headers"])) {
|
|
451
|
+
for (const sent of new Set([value, httpTrimmed(value)]))
|
|
452
|
+
for (const credential of credentialHeaderValues({ [name]: sent }))
|
|
453
|
+
found.add(credential);
|
|
454
|
+
}
|
|
455
|
+
for (const [name, value] of stringMembers(members["env"]))
|
|
456
|
+
if (isSecretEnvKey(name, value))
|
|
457
|
+
found.add(value);
|
|
458
|
+
return [...found];
|
|
459
|
+
}
|
|
460
|
+
function stringMembers(record) {
|
|
461
|
+
return Object.entries(readOwnMembers(record) ?? {}).filter((entry) => typeof entry[1] === "string");
|
|
462
|
+
}
|
|
315
463
|
export function carriedHttpHeaders(protocol, carrier, pieces, principalHeader, principal) {
|
|
316
464
|
try {
|
|
317
465
|
return resolveProtocolHttpHeaders(protocol, { ...(pieces.headers !== undefined ? { headers: { ...pieces.headers } } : {}), ...(principalHeader !== undefined ? { principalHeader } : {}) }, principal);
|
|
@@ -337,7 +485,7 @@ export function peerFetch(carrier, principalHeader, principal) {
|
|
|
337
485
|
return res;
|
|
338
486
|
const challenge = bearerChallengeParams(res.headers.get("www-authenticate"));
|
|
339
487
|
if (res.status === 403 && challenge?.get("error") !== "insufficient_scope")
|
|
340
|
-
return res;
|
|
488
|
+
return unchallenged(res);
|
|
341
489
|
const resourceMetadataUrl = authorizationUrlOf(challenge?.get("resource_metadata"));
|
|
342
490
|
const body = init?.method === "POST" ? await bodyHead(res, REFUSAL_BODY_MAX) : void (await res.body?.cancel().catch(() => undefined));
|
|
343
491
|
const reask = res.status === 401 ? await carrier.rejected(pieces, signal) : undefined;
|
|
@@ -349,6 +497,13 @@ export function peerFetch(carrier, principalHeader, principal) {
|
|
|
349
497
|
});
|
|
350
498
|
};
|
|
351
499
|
}
|
|
500
|
+
function unchallenged(res) {
|
|
501
|
+
if (!res.headers.has("www-authenticate"))
|
|
502
|
+
return res;
|
|
503
|
+
const headers = new Headers(res.headers);
|
|
504
|
+
headers.delete("www-authenticate");
|
|
505
|
+
return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
|
|
506
|
+
}
|
|
352
507
|
export const RETIRED_VALUE_MEMBERS = Object.freeze({ mcp: Object.freeze([Object.freeze(["transport", "headers"]), Object.freeze(["transport", "env"])]), a2a: Object.freeze([Object.freeze(["headers"])]) });
|
|
353
508
|
export function retiredValueMember(copy, at) {
|
|
354
509
|
for (const path of RETIRED_VALUE_MEMBERS[at]) {
|
|
@@ -372,7 +527,7 @@ export function declaredCredentials(copy, at) {
|
|
|
372
527
|
if (read.ok)
|
|
373
528
|
return { ref: read.ref };
|
|
374
529
|
const p = read.problem;
|
|
375
|
-
return { problem: `${p.reason}${"kind" in p && p.kind !== undefined ? ` (kind ${
|
|
530
|
+
return { problem: `${p.reason}${"kind" in p && p.kind !== undefined ? ` (kind ${callerText(p.kind)})` : ""}${"field" in p ? ` at ${JSON.stringify(p.field)}` : ""}` };
|
|
376
531
|
}
|
|
377
532
|
export function peerSeatMissing(subject, credentials, seat) {
|
|
378
533
|
if (credentials === undefined || seat !== undefined)
|
|
@@ -381,8 +536,10 @@ export function peerSeatMissing(subject, credentials, seat) {
|
|
|
381
536
|
}
|
|
382
537
|
export function mcpPeerTarget(spec, kind) {
|
|
383
538
|
const t = spec.transport;
|
|
539
|
+
if (kind === "host")
|
|
540
|
+
return { protocol: "mcp", server: spec.name, transport: "host" };
|
|
384
541
|
const fingerprint = typeof spec.fingerprint === "string" ? { fingerprint: spec.fingerprint } : {};
|
|
385
|
-
const credentials = t.credentials !== undefined ? { credentials: t.credentials } : {};
|
|
542
|
+
const credentials = "credentials" in t && t.credentials !== undefined ? { credentials: t.credentials } : {};
|
|
386
543
|
if (kind === "stdio" && "command" in t)
|
|
387
544
|
return { protocol: "mcp", server: spec.name, transport: "stdio", command: t.command, args: [...(t.args ?? [])], ...credentials, ...fingerprint };
|
|
388
545
|
return { protocol: "mcp", server: spec.name, transport: "http", url: "url" in t ? t.url : "", ...credentials, ...fingerprint };
|
|
@@ -390,7 +547,7 @@ export function mcpPeerTarget(spec, kind) {
|
|
|
390
547
|
export function answeredUnauthorized(err) {
|
|
391
548
|
let at = err;
|
|
392
549
|
for (let depth = 0; depth < 6 && at instanceof Error; depth++) {
|
|
393
|
-
if (at instanceof
|
|
550
|
+
if (at instanceof SdkHttpError && at.status === 401)
|
|
394
551
|
return true;
|
|
395
552
|
at = at.cause;
|
|
396
553
|
}
|
|
@@ -546,14 +546,22 @@ export declare function redeemRuleTicket(opts: {
|
|
|
546
546
|
export declare const IMPORTED_SETTINGS_LAYERS: readonly ["userSettings", "projectSettings", "localSettings"];
|
|
547
547
|
/** The three user-editable settings layers this version reads. */
|
|
548
548
|
export type ImportedSettingsLayer = (typeof IMPORTED_SETTINGS_LAYERS)[number];
|
|
549
|
-
/** One layer to read
|
|
550
|
-
*
|
|
551
|
-
|
|
552
|
-
|
|
549
|
+
/** One layer to read — a union by `layer`, so a member is present exactly where it is read. A project or local layer
|
|
550
|
+
* carries `root`: the canonical directory its rules are scoped to, taken from where the FILE actually lives, since the
|
|
551
|
+
* local layer is not always at a repository root. The user layer carries none — a root handed for it does not compile:
|
|
552
|
+
* its rules import as global rules, which read `/x` at each task's project root, so nothing here reads that layer's own
|
|
553
|
+
* directory, and an entry written against it stays in the settings file ({@link prepareCcImport}). */
|
|
554
|
+
export type CcImportLayer = {
|
|
555
|
+
layer: "userSettings";
|
|
556
|
+
path: string;
|
|
557
|
+
root?: never;
|
|
558
|
+
readFile: (path: string) => Promise<string | undefined>;
|
|
559
|
+
} | {
|
|
560
|
+
layer: Exclude<ImportedSettingsLayer, "userSettings">;
|
|
553
561
|
path: string;
|
|
554
562
|
root: string;
|
|
555
563
|
readFile: (path: string) => Promise<string | undefined>;
|
|
556
|
-
}
|
|
564
|
+
};
|
|
557
565
|
/**
|
|
558
566
|
* What the import WOULD do, shown before anyone confirms.
|
|
559
567
|
*
|
|
@@ -567,27 +575,6 @@ export interface ImportPreview {
|
|
|
567
575
|
rule: string;
|
|
568
576
|
reason: string;
|
|
569
577
|
}>;
|
|
570
|
-
/**
|
|
571
|
-
* ALWAYS EMPTY in this version — a compatibility seat (RL-1336-import-translated), kept on the wire shape so an existing reader
|
|
572
|
-
* keeps finding the key (removing a wire field would break readers for no gain).
|
|
573
|
-
*
|
|
574
|
-
* The seat once carried the entries whose MATCH FORM was rewritten on the way in (the space-star
|
|
575
|
-
* suggestion form of the other product translated to this lane's colon-star form, one row per
|
|
576
|
-
* translated candidate with its `scope`). That translation is retired: the space-star wildcard is
|
|
577
|
-
* now a first-class match form of this lane's own grammar, so an entry's match form imports as the
|
|
578
|
-
* file states it — `Bash(npm run *)` lands as `Bash(npm run *)`, never as a colon-star — and nothing
|
|
579
|
-
* is ever pushed here. What `candidates` carries is the grammar's CANONICAL re-projection of each
|
|
580
|
-
* entry (the parser folds spacing: `Bash(npm<TAB>run *)` lands as `Bash(npm run *)`); that is the
|
|
581
|
-
* ordinary normalization every rule text in this lane undergoes, the same one the store applies,
|
|
582
|
-
* and not a translation this seat reports. An entry whose star placement has no rule form is
|
|
583
|
-
* refused into `skipped` under `unsupported.wildcard`, named as the file writes it. A reader
|
|
584
|
-
* rendering a "rewritten spellings" column from this seat renders an empty column, correctly.
|
|
585
|
-
*/
|
|
586
|
-
translated: Array<{
|
|
587
|
-
from: string;
|
|
588
|
-
to: string;
|
|
589
|
-
scope: RuleScope;
|
|
590
|
-
}>;
|
|
591
578
|
layers: Array<{
|
|
592
579
|
path: string;
|
|
593
580
|
layer: ImportedSettingsLayer;
|
|
@@ -648,6 +635,14 @@ export type RedeemedBatchMember = {
|
|
|
648
635
|
* being escorted by a shell into a bare tool-name ask that widens `Bash(rm -r:*)` into "every Bash call
|
|
649
636
|
* asks". An entry that does not import (a spelling with no rule form, a tool the lane does not speak
|
|
650
637
|
* for, a non-string) is DISCLOSED in `skipped` with its reason and stays in the settings file.
|
|
638
|
+
*
|
|
639
|
+
* Only a rule the store reads the way its layer does is carried. A bare tool name is not (`unsupported.form`), and
|
|
640
|
+
* neither is a user-layer path pattern written from `/` (`unsupported.layer_root`, every behavior): the user layer reads
|
|
641
|
+
* it at its own directory (the configuration directory), a stored global rule reads `/x` at each task's project root, and
|
|
642
|
+
* no stored row has a seat for the layer's directory. `//abs`, `~/`, relative and non-path entries of the user layer carry
|
|
643
|
+
* as global rules; a project or local layer's `/x` carries, scoped to that layer's `root` (a project row reads `/x` there).
|
|
644
|
+
* A user layer handed a `root` refuses the whole call before any layer is read (`config.invalid_argument`, `detail.field`
|
|
645
|
+
* `layers[<i>].root`; the value is not echoed).
|
|
651
646
|
*/
|
|
652
647
|
export declare function prepareCcImport(opts: {
|
|
653
648
|
layers: CcImportLayer[];
|