@sema-agent/core 7.59.0 → 7.60.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 +564 -0
- 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 +2 -1
- package/dist/agents/agent-transcript-tool.js +3 -1
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/cumulative-stats.js +0 -1
- package/dist/agents/inherited-tool-pool.d.ts +26 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +13 -2
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +3 -1
- package/dist/agents/send-message-tool.d.ts +8 -19
- package/dist/agents/send-message-tool.js +11 -38
- package/dist/agents/subagent.d.ts +51 -17
- package/dist/agents/subagent.js +117 -78
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/degrading.js +3 -1
- 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/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/allow-entry.d.ts +2 -0
- package/dist/core/allow-entry.js +3 -1
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -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 +63 -12
- package/dist/core/background-agent-store.d.ts +10 -1
- package/dist/core/background-agent-store.js +3 -2
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-store.d.ts +8 -13
- package/dist/core/checkpoint-store.js +4 -3
- package/dist/core/compliance.d.ts +1 -1
- 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 +4 -5
- package/dist/core/engine-notice.d.ts +58 -15
- package/dist/core/frame-settlement.d.ts +5 -0
- package/dist/core/frame-settlement.js +4 -0
- package/dist/core/gate-fold.js +7 -5
- package/dist/core/gate-lanes.js +39 -8
- package/dist/core/governance-codes.d.ts +9 -1
- package/dist/core/governance-codes.js +12 -0
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +39 -56
- package/dist/core/hooks.js +123 -77
- package/dist/core/image-admission.d.ts +104 -51
- package/dist/core/image-admission.js +170 -46
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/locked-config.d.ts +54 -3
- package/dist/core/locked-config.js +81 -50
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-failure.d.ts +9 -3
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-seat.d.ts +92 -0
- package/dist/core/mcp-host-seat.js +131 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +7 -2
- package/dist/core/mcp-server-spec.d.ts +38 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp.d.ts +17 -6
- package/dist/core/mcp.js +67 -55
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- 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/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- 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 +45 -11
- package/dist/core/memory-engine/sync-client.js +82 -11
- package/dist/core/memory-engine/sync-report.d.ts +103 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +4 -2
- package/dist/core/mode-policy.d.ts +9 -1
- package/dist/core/mode-policy.js +11 -1
- 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 +65 -0
- package/dist/core/mods/agent-stations.js +105 -0
- package/dist/core/mods/kernel/dispatch.d.ts +5 -1
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +10 -4
- package/dist/core/mods/kernel/events.js +10 -6
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/stations.d.ts +51 -59
- package/dist/core/mods/stations.js +32 -42
- package/dist/core/mods/tool-call.d.ts +10 -4
- package/dist/core/mods/tool-call.js +28 -12
- 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/own-property-receipt.d.ts +3 -0
- package/dist/core/own-property-receipt.js +3 -0
- package/dist/core/park-selfcheck.js +8 -8
- package/dist/core/peer-seat.d.ts +63 -8
- package/dist/core/peer-seat.js +179 -34
- package/dist/core/permission-rule-consent.d.ts +0 -21
- package/dist/core/permission-rule-consent.js +1 -2
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +7 -6
- 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 +146 -98
- package/dist/core/remote-env.js +113 -14
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +6 -1
- 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/rule-owner.d.ts +3 -0
- package/dist/core/runner/assemble-result.d.ts +0 -5
- package/dist/core/runner/assemble-result.js +0 -1
- 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/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/construction-doors.js +5 -0
- package/dist/core/runner/contracts.d.ts +62 -41
- package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- 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/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 +3 -4
- 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/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/permission-rule-lanes.js +1 -1
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +3 -3
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +4 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +4 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +14 -9
- package/dist/core/runner/prepare-delegation-surface.d.ts +5 -3
- package/dist/core/runner/prepare-delegation-surface.js +4 -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 +4 -3
- package/dist/core/runner/prepare-gate-stations.js +4 -3
- package/dist/core/runner/prepare-hands-readface.d.ts +3 -1
- package/dist/core/runner/prepare-hands-readface.js +15 -7
- package/dist/core/runner/prepare-inherited-gate.d.ts +5 -4
- package/dist/core/runner/prepare-inherited-gate.js +9 -5
- 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 +3 -5
- package/dist/core/runner/prepare-park-ask.js +3 -8
- package/dist/core/runner/prepare-policy-chain.d.ts +5 -4
- package/dist/core/runner/prepare-policy-chain.js +120 -108
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -1
- package/dist/core/runner/prepare-prompt-inputs.js +3 -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-suspend-saga.d.ts +0 -2
- package/dist/core/runner/prepare-suspend-saga.js +5 -7
- package/dist/core/runner/prepare-task.js +41 -27
- 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 +4 -3
- package/dist/core/runner/prepare-wiring-manifest.js +32 -18
- package/dist/core/runner/prepare-workspace-restore.js +3 -3
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/retired-runner-deps.js +4 -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 +1 -1
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +3 -1
- package/dist/core/runner/run-identity-wiring.js +1 -1
- package/dist/core/runner/run-leg.js +26 -28
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +16 -10
- package/dist/core/runner/run-settle-and-teardown.js +5 -1
- 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-turn-boundary.js +12 -7
- package/dist/core/runner/runtask.d.ts +7 -4
- package/dist/core/runner/runtask.js +19 -11
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/tool-disclosure.js +0 -2
- 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-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/turn-attachments.d.ts +3 -5
- package/dist/core/runner/turn-attachments.js +3 -16
- package/dist/core/runner-deps.d.ts +31 -18
- package/dist/core/secret-env.d.ts +3 -2
- package/dist/core/session-policy-store.d.ts +9 -2
- package/dist/core/session-policy-store.js +16 -1
- package/dist/core/session-store.d.ts +3 -2
- package/dist/core/session-store.js +50 -11
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +37 -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 +18 -2
- package/dist/core/task-notification.d.ts +88 -5
- package/dist/core/task-notification.js +130 -7
- package/dist/core/task-registry-agent.d.ts +18 -12
- package/dist/core/task-registry-agent.js +18 -6
- package/dist/core/task-registry-monitor.d.ts +7 -0
- package/dist/core/task-registry-monitor.js +28 -1
- package/dist/core/task-registry-shared.d.ts +38 -3
- package/dist/core/task-registry-shared.js +21 -7
- package/dist/core/task-registry-workflow.js +1 -1
- package/dist/core/task-registry.d.ts +50 -35
- package/dist/core/task-registry.js +64 -23
- package/dist/core/task-result.d.ts +3 -12
- package/dist/core/task-spec.d.ts +3 -6
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/tool-catalog-entries.js +1 -1
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +4 -3
- package/dist/core/tool-name-aliases.d.ts +19 -0
- package/dist/core/tool-name-aliases.js +54 -2
- package/dist/core/tool-policy.d.ts +5 -4
- package/dist/core/tool-policy.js +1 -1
- 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 +88 -5
- package/dist/core/tool-result-store.js +51 -12
- package/dist/core/tool-spec.d.ts +20 -4
- package/dist/core/trace.d.ts +0 -1
- 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 +14 -6
- package/dist/engine/execution-env/node-execution-env.d.ts +7 -2
- package/dist/engine/execution-env/node-execution-env.js +12 -1
- package/dist/engine/harness/agent-harness.d.ts +1 -1
- package/dist/engine/harness/agent-harness.js +8 -4
- package/dist/engine/harness/types.d.ts +112 -29
- package/dist/engine/loop/agent-loop.d.ts +12 -12
- package/dist/engine/loop/agent-loop.js +153 -21
- package/dist/engine/loop/types.d.ts +9 -2
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/index.d.ts +22 -14
- package/dist/index.js +15 -10
- package/dist/internal/harness-types.d.ts +1 -1
- package/dist/orchestration/run-workflow-tool.d.ts +9 -3
- package/dist/orchestration/run-workflow-tool.js +59 -29
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +25 -4
- 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 +3 -1
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +19 -14
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +3 -1
- package/dist/stores/file/index.d.ts +4 -3
- package/dist/stores/file/index.js +17 -8
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +3 -1
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +3 -1
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +3 -1
- package/dist/stores/file/session-store.d.ts +1 -1
- package/dist/stores/file/session-store.js +3 -1
- 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 +20 -2
- package/dist/stores/file/tool-result-store.js +74 -6
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +3 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -11
- package/dist/stores/file/workflow-journal-store.js +3 -2
- package/dist/tools/fs/containment-face.d.ts +5 -0
- 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 +7 -0
- package/dist/tools/fs/fs-bash-background-text.js +1 -0
- package/dist/tools/fs/fs-bash.d.ts +8 -4
- package/dist/tools/fs/fs-bash.js +26 -35
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +26 -21
- 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 +11 -13
- package/dist/tools/fs/fs-shared.js +11 -7
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +14 -8
- package/dist/tools/fs/index.js +8 -4
- package/dist/tools/fs/read-floor.d.ts +44 -1
- package/dist/tools/fs/read-floor.js +35 -0
- 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 +3 -3
- package/dist/tools/fs/search.js +4 -4
- package/dist/tools/monitor.d.ts +5 -4
- package/dist/tools/monitor.js +15 -8
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/package.json +4 -2
- package/test/export-surface.snapshot.json +75 -21
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
package/dist/core/mcp-probe.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { type McpFailureKind } from "./mcp-failure.js";
|
|
2
|
-
import type
|
|
3
|
-
import type
|
|
2
|
+
import { type McpServerSpec, type OnElicit } from "./mcp-server-spec.js";
|
|
3
|
+
import { type PeerSeat } from "./peer-seat.js";
|
|
4
|
+
import { type HostFloorDeclaration } from "./host-floor.js";
|
|
4
5
|
import type { WiringManifestMcpEntry } from "./wiring-manifest.js";
|
|
5
6
|
/** One server's probe reading, beside its manifest row. `connectMs` is wall time this probe measured
|
|
6
7
|
* for THIS server's dial — the spawn/handshake, the initial `tools/list` walk and the intake, ending
|
|
@@ -60,6 +61,10 @@ export interface McpProbeOptions {
|
|
|
60
61
|
/** The peer seat a prepared leg dials with (`RunnerDeps.peerSeat`): what each request carries. Absent ⇒ nothing is carried, and a
|
|
61
62
|
* server whose declaration names `credentials` reads `failed` (`invalid_config`, `config.peer_seat_missing`). */
|
|
62
63
|
peerSeat?: PeerSeat;
|
|
64
|
+
/** The deployment's host floor, as `RunnerDeps.hostFloor` declares it: compiled by the one compile ({@link compileHostFloor} — a
|
|
65
|
+
* declaration that does not read is refused before anything is dialed) and judged at the one dial, so an http server whose
|
|
66
|
+
* endpoint a task's floor refuses is refused here too and never contacted. Absent ⇒ no floor, as a deployment that declares none. */
|
|
67
|
+
hostFloor?: HostFloorDeclaration;
|
|
63
68
|
/** Abort reading, stated once: the call rejects with the signal's own reason when that reason is an
|
|
64
69
|
* Error (a bare `abort()` supplies a DOMException named `AbortError`) and with this module's own
|
|
65
70
|
* `AbortError` otherwise — a face that throws a string is a face no `catch` can read. A condition
|
package/dist/core/mcp-probe.js
CHANGED
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
|
|
2
2
|
import { snapshotMcpEntries } from "./locked-config.js";
|
|
3
3
|
import { classifyMcpFailure, livenessOf } from "./mcp-failure.js";
|
|
4
|
+
import { transportKindOf } from "./mcp-server-spec.js";
|
|
5
|
+
import { receivePeerSeat } from "./peer-seat.js";
|
|
6
|
+
import { compileHostFloor } from "./host-floor.js";
|
|
4
7
|
import { MCP_ENV_MS_MAX, materializeMcpTools } from "./mcp.js";
|
|
5
8
|
import { refuseCollidingMcpServerNames } from "./mcp-name-judge.js";
|
|
6
9
|
import { mcpManifestEntries } from "./runner/prepare-wiring-manifest.js";
|
|
@@ -55,7 +58,7 @@ async function raceDial(dial, ms, signal) {
|
|
|
55
58
|
}
|
|
56
59
|
function stoppedWaitingStatus(entry, ms) {
|
|
57
60
|
const condition = new McpError(ErrorCode.RequestTimeout, `the probe stopped waiting for this server's connect and initial tool listing after ${ms} ms`);
|
|
58
|
-
const { kind, delivered } = classifyMcpFailure(condition, { phase: "connect", transport: entry
|
|
61
|
+
const { kind, delivered } = classifyMcpFailure(condition, { phase: "connect", transport: transportKindOf(entry) });
|
|
59
62
|
const liveness = livenessOf(kind, Date.now());
|
|
60
63
|
return { name: entry.name, status: "failed", errorCode: kind, delivered, error: condition.message, ...(liveness !== undefined ? { liveness } : {}) };
|
|
61
64
|
}
|
|
@@ -64,7 +67,9 @@ export async function probeMcpServers(specs, opts = {}) {
|
|
|
64
67
|
const timeoutMs = wholeInRange("timeoutMs", opts.timeoutMs, 1, MCP_ENV_MS_MAX);
|
|
65
68
|
const concurrency = wholeInRange("concurrency", opts.concurrency, 1, Number.MAX_SAFE_INTEGER) ?? 1;
|
|
66
69
|
const onElicit = opts.onElicit ?? DECLINE_EVERY_ELICITATION;
|
|
70
|
+
const hostFloor = compileHostFloor(opts.hostFloor);
|
|
67
71
|
const signal = opts.signal;
|
|
72
|
+
const peerSeat = receivePeerSeat(opts.peerSeat, "probeMcpServers peerSeat");
|
|
68
73
|
refuseCollidingMcpServerNames(declared.map((e) => e.name));
|
|
69
74
|
const statuses = [];
|
|
70
75
|
const servers = new Array(declared.length);
|
|
@@ -74,7 +79,7 @@ export async function probeMcpServers(specs, opts = {}) {
|
|
|
74
79
|
const entry = declared[i];
|
|
75
80
|
const started = performance.now();
|
|
76
81
|
const elapsed = () => Math.round(performance.now() - started);
|
|
77
|
-
const dial = materializeMcpTools([entry], opts.principal, onElicit, undefined, undefined, undefined, undefined, undefined, undefined, undefined,
|
|
82
|
+
const dial = materializeMcpTools([entry], opts.principal, onElicit, undefined, undefined, undefined, undefined, undefined, undefined, undefined, hostFloor, peerSeat);
|
|
78
83
|
const verdict = await raceDial(dial, timeoutMs, signal);
|
|
79
84
|
if (verdict.kind === "settled") {
|
|
80
85
|
const found = verdict.handle.statuses.find((s) => s.name === entry.name);
|
|
@@ -21,13 +21,19 @@ export interface McpServerSpec {
|
|
|
21
21
|
* carries — an http request's credential headers, a stdio child's environment — are answered per send by the deployment's
|
|
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
|
-
* entrance (`config.credential_in_declaration`).
|
|
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) carries every request; the transport has no member beyond
|
|
26
|
+
* 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
|
+
* this way cannot opt in to {@link elicitation} — both refused at every entrance (`config.invalid_argument`). It never enters
|
|
28
|
+
* the run tree's connection pool: its pipe is the leg's own.
|
|
25
29
|
*/
|
|
26
30
|
transport: {
|
|
27
31
|
kind: "stdio";
|
|
28
32
|
command: string;
|
|
29
33
|
args?: string[];
|
|
30
34
|
credentials?: CredentialRef;
|
|
35
|
+
} | {
|
|
36
|
+
kind: "host";
|
|
31
37
|
} | {
|
|
32
38
|
kind: "http";
|
|
33
39
|
url: string;
|
|
@@ -199,6 +205,12 @@ export interface McpServerSpec {
|
|
|
199
205
|
*/
|
|
200
206
|
sessionMetaKey?: string;
|
|
201
207
|
}
|
|
208
|
+
/** The transport kinds a declaration names, one list: the dial reads a kind against it, so a word outside it is no kind at all. */
|
|
209
|
+
export declare const MCP_TRANSPORT_KINDS: readonly ["stdio", "http", "host"];
|
|
210
|
+
export type McpTransportKind = McpServerSpec["transport"]["kind"];
|
|
211
|
+
/** The one reading of a declaration's transport kind: a word of {@link MCP_TRANSPORT_KINDS}, or `undefined` for anything else (no transport,
|
|
212
|
+
* not a record, a word outside the list, a member that throws) — total, so a reader never fails on a declaration the dial would refuse. */
|
|
213
|
+
export declare function transportKindOf(spec: McpServerSpec): McpTransportKind | undefined;
|
|
202
214
|
type ToolAxes = NonNullable<McpServerSpec["toolAxes"]>;
|
|
203
215
|
/**
|
|
204
216
|
* The surfaces that declare `toolAxes`, which {@link readToolAxes} names its reading by: an MCP server's keys are the server's
|
|
@@ -218,10 +230,23 @@ export type ToolAxesRead = {
|
|
|
218
230
|
ok: false;
|
|
219
231
|
problem: string;
|
|
220
232
|
};
|
|
221
|
-
/**
|
|
222
|
-
*
|
|
223
|
-
*
|
|
224
|
-
|
|
233
|
+
/**
|
|
234
|
+
* THE one shape text the caller wrote takes in a judge's sentence — a value, or a key the caller chose (a tool or skill name, the name of
|
|
235
|
+
* a member the declaration does not have, a `_meta` key): the redaction mark and its length, never the text. A caller's text can be
|
|
236
|
+
* anything a deployment put in the wrong field, a credential included, and the sentence travels to logs, panels and probes. A value that
|
|
237
|
+
* is no string is named by its kind ({@link dataKind}). Everything else a judge's sentence says is the engine's own: where (the
|
|
238
|
+
* declaration's member names, a list index), why (the closed vocabulary, a kind, a count and its bound) and whose (the declarer's name,
|
|
239
|
+
* the entry's published identity, which the engine already mints into every tool name it mounts).
|
|
240
|
+
*/
|
|
241
|
+
export declare function callerText(value: unknown): string;
|
|
242
|
+
/**
|
|
243
|
+
* Where in a declaration a sentence points, from `base`: a list index in brackets, a member name after a dot — the declaration's own
|
|
244
|
+
* member names (`words`, the engine's words) as written, any other key in the caller's-text shape ({@link callerText}). Bounded: no key is
|
|
245
|
+
* added once the path runs past 120 characters, and a path cut short ends in the truncation mark, so a deep declaration never makes a long
|
|
246
|
+
* sentence. Every judge of a declaration renders its paths here.
|
|
247
|
+
*/
|
|
248
|
+
export declare function declarationPath(path: readonly (string | number)[], words: ReadonlySet<string>, base?: string): string;
|
|
249
|
+
export declare const DECLARATION_ENTRY_WORDS: ReadonlySet<string>;
|
|
225
250
|
/** The kind of a value that is plain data, for a sentence that names what was declared without carrying it. */
|
|
226
251
|
export declare function dataKind(value: unknown): string;
|
|
227
252
|
/**
|
|
@@ -303,12 +328,16 @@ type PerToolDeclarationRead = {
|
|
|
303
328
|
};
|
|
304
329
|
/**
|
|
305
330
|
* A per-tool declaration's receipt: {@link receiveDeclaration} (plain data held to the engine's one depth, every own member read once,
|
|
306
|
-
* lists of names, no `__proto__`), then the copy must be a record of names. A refusal
|
|
307
|
-
* reading stopped
|
|
331
|
+
* lists of names, no `__proto__`), then the copy must be a record of names. A refusal points at the tool (or skill) and the member where
|
|
332
|
+
* reading stopped in the engine's words — the declaration's member names (`words`), a list index — and shows the caller's own keys and
|
|
333
|
+
* values in the one caller's-text shape ({@link callerText}). `unit` is what the keys are called (`tool` / `skill`).
|
|
308
334
|
*/
|
|
309
|
-
export declare function receivePerToolDeclaration(declared: unknown, field: PerToolDeclaration, unit: string): PerToolDeclarationRead;
|
|
310
|
-
/** The sentence for one tool's (or skill's) declaration that does not fit: `detail` says which member and why.
|
|
335
|
+
export declare function receivePerToolDeclaration(declared: unknown, field: PerToolDeclaration, unit: string, words: ReadonlySet<string>): PerToolDeclarationRead;
|
|
336
|
+
/** The sentence for one tool's (or skill's) declaration that does not fit: `detail` says which member and why. The tool's name is the
|
|
337
|
+
* caller's text ({@link callerText}). */
|
|
311
338
|
export declare function perToolEntryRefusal(field: PerToolDeclaration, unit: string, key: string, detail: string): string;
|
|
339
|
+
/** The member names of one tool's axes ({@link TOOL_AXIS_MEMBERS}): the words a `toolAxes` refusal's member path spells. */
|
|
340
|
+
export declare const TOOL_AXIS_WORDS: ReadonlySet<string>;
|
|
312
341
|
/** The sentence for a per-tool declaration that names a tool (or skill) with an empty name. */
|
|
313
342
|
export declare function perToolEmptyName(field: PerToolDeclaration, unit: string): string;
|
|
314
343
|
/**
|
|
@@ -1,8 +1,22 @@
|
|
|
1
1
|
import { SAFETY_AXIS_VOCABULARY } from "./safety-axis-vocab.js";
|
|
2
2
|
import { INLINE_TRUNCATION_MARK, inlineUntrusted } from "./untrusted-text.js";
|
|
3
|
+
import { REDACTION_MARK } from "./redaction-marks.js";
|
|
3
4
|
import { DECLARATION_RECEIPT_MODE } from "./own-property-receipt.js";
|
|
4
5
|
import { isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
5
6
|
import { MODS_VALUE_DEPTH } from "./mods/kernel/site-rules.js";
|
|
7
|
+
export const MCP_TRANSPORT_KINDS = Object.freeze(["stdio", "http", "host"]);
|
|
8
|
+
const transportKindsLockstep = true;
|
|
9
|
+
void transportKindsLockstep;
|
|
10
|
+
export function transportKindOf(spec) {
|
|
11
|
+
try {
|
|
12
|
+
const transport = spec.transport;
|
|
13
|
+
const kind = (typeof transport === "object" && transport !== null) || typeof transport === "function" ? Reflect.get(transport, "kind") : undefined;
|
|
14
|
+
return MCP_TRANSPORT_KINDS.find((known) => known === kind);
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
return undefined;
|
|
18
|
+
}
|
|
19
|
+
}
|
|
6
20
|
const TOOL_AXES_SURFACES = {
|
|
7
21
|
mcp: { key: "tool", declarer: "MCP server" },
|
|
8
22
|
a2a: { key: "skill", declarer: "A2A peer" },
|
|
@@ -27,25 +41,44 @@ const irreversibilityPolesLockstep = true;
|
|
|
27
41
|
void irreversibilityPolesLockstep;
|
|
28
42
|
const toolAxesDeclarationsAreOne = true;
|
|
29
43
|
void toolAxesDeclarationsAreOne;
|
|
30
|
-
export function
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
function memberNames(path) {
|
|
41
|
-
let rendered = "";
|
|
42
|
-
for (const [index, name] of path.entries()) {
|
|
43
|
-
if (rendered.length > 120)
|
|
44
|
+
export function callerText(value) {
|
|
45
|
+
if (typeof value !== "string")
|
|
46
|
+
return dataKind(value);
|
|
47
|
+
const length = [...value].length;
|
|
48
|
+
return `${REDACTION_MARK} (${length} character${length === 1 ? "" : "s"})`;
|
|
49
|
+
}
|
|
50
|
+
export function declarationPath(path, words, base = "") {
|
|
51
|
+
let rendered = base;
|
|
52
|
+
for (const key of path) {
|
|
53
|
+
if (rendered.length > 120 + base.length)
|
|
44
54
|
return `${rendered}${INLINE_TRUNCATION_MARK}`;
|
|
45
|
-
|
|
55
|
+
const name = typeof key === "number" ? `[${key}]` : words.has(key) ? key : callerText(key);
|
|
56
|
+
rendered += typeof key === "number" || rendered === "" ? name : `.${name}`;
|
|
46
57
|
}
|
|
47
58
|
return rendered;
|
|
48
59
|
}
|
|
60
|
+
const DECLARATION_ENTRY_MEMBERS = {
|
|
61
|
+
name: true,
|
|
62
|
+
source: true,
|
|
63
|
+
transport: true,
|
|
64
|
+
allowTools: true,
|
|
65
|
+
elicitation: true,
|
|
66
|
+
toolAxes: true,
|
|
67
|
+
toolFaces: true,
|
|
68
|
+
contentOrigin: true,
|
|
69
|
+
fingerprint: true,
|
|
70
|
+
startupTimeoutMs: true,
|
|
71
|
+
sessionMetaKey: true,
|
|
72
|
+
kind: true,
|
|
73
|
+
command: true,
|
|
74
|
+
args: true,
|
|
75
|
+
url: true,
|
|
76
|
+
credentials: true,
|
|
77
|
+
principalHeader: true,
|
|
78
|
+
cardUrl: true,
|
|
79
|
+
allowSkills: true,
|
|
80
|
+
};
|
|
81
|
+
export const DECLARATION_ENTRY_WORDS = new Set(Object.keys(DECLARATION_ENTRY_MEMBERS));
|
|
49
82
|
export function dataKind(value) {
|
|
50
83
|
return value === null ? "null" : value === undefined ? "undefined" : Array.isArray(value) ? "an array" : typeof value === "object" ? "a record" : `a ${typeof value}`;
|
|
51
84
|
}
|
|
@@ -162,12 +195,12 @@ function readToolAxisEntry(raw) {
|
|
|
162
195
|
const listed = Object.keys(raw);
|
|
163
196
|
const unknown = listed.find((member) => !TOOL_AXIS_MEMBER_NAMES.includes(member));
|
|
164
197
|
if (unknown !== undefined)
|
|
165
|
-
return `unknown member ${
|
|
198
|
+
return `an unknown member ${callerText(unknown)} (the members are ${TOOL_AXIS_MEMBER_NAMES.join(", ")})`;
|
|
166
199
|
const declared = Object.create(null);
|
|
167
200
|
for (const member of TOOL_AXIS_MEMBER_NAMES) {
|
|
168
201
|
const value = raw[member];
|
|
169
202
|
if (value !== undefined && !listed.includes(member))
|
|
170
|
-
return `member ${
|
|
203
|
+
return `member "${member}" is a hidden member: its name answers a value the declaration does not list as its own`;
|
|
171
204
|
declared[member] = value;
|
|
172
205
|
}
|
|
173
206
|
const { effect, egress, irreversibility, boundaryFlow } = declared;
|
|
@@ -192,13 +225,13 @@ const PER_TOOL_DECLARATIONS = {
|
|
|
192
225
|
toolAxes: { plural: "axes", singular: "axis" },
|
|
193
226
|
toolFaces: { plural: "faces", singular: "face" },
|
|
194
227
|
};
|
|
195
|
-
export function receivePerToolDeclaration(declared, field, unit) {
|
|
228
|
+
export function receivePerToolDeclaration(declared, field, unit, words) {
|
|
196
229
|
const received = receiveDeclaration(declared, NO_DECLARATION_PATH_RULES);
|
|
197
230
|
if (!received.ok) {
|
|
198
231
|
const [key, ...member] = received.fault.path;
|
|
199
232
|
if (key === undefined)
|
|
200
233
|
return { ok: false, problem: `${field} cannot be read: ${received.fault.problem}` };
|
|
201
|
-
const where = member.length > 0 ? `member ${
|
|
234
|
+
const where = member.length > 0 ? `member ${declarationPath(member, words)}: ` : "";
|
|
202
235
|
return { ok: false, problem: perToolEntryRefusal(field, unit, String(key), `${where}${received.fault.problem}`) };
|
|
203
236
|
}
|
|
204
237
|
const perTool = received.value;
|
|
@@ -207,8 +240,9 @@ export function receivePerToolDeclaration(declared, field, unit) {
|
|
|
207
240
|
return { ok: true, perTool };
|
|
208
241
|
}
|
|
209
242
|
export function perToolEntryRefusal(field, unit, key, detail) {
|
|
210
|
-
return `the ${PER_TOOL_DECLARATIONS[field].plural} declared for ${unit} ${
|
|
243
|
+
return `the ${PER_TOOL_DECLARATIONS[field].plural} declared for the ${unit} ${callerText(key)} do not fit: ${detail}`;
|
|
211
244
|
}
|
|
245
|
+
export const TOOL_AXIS_WORDS = new Set(TOOL_AXIS_MEMBER_NAMES);
|
|
212
246
|
export function perToolEmptyName(field, unit) {
|
|
213
247
|
return `${field} has an empty ${unit} name`;
|
|
214
248
|
}
|
|
@@ -216,7 +250,7 @@ export function readToolAxes(declared, at) {
|
|
|
216
250
|
const unit = toolAxesSurfaceOf(at).key;
|
|
217
251
|
if (declared === undefined)
|
|
218
252
|
return { ok: true };
|
|
219
|
-
const received = receivePerToolDeclaration(declared, "toolAxes", unit);
|
|
253
|
+
const received = receivePerToolDeclaration(declared, "toolAxes", unit, TOOL_AXIS_WORDS);
|
|
220
254
|
if (!received.ok)
|
|
221
255
|
return { ok: false, problem: received.problem };
|
|
222
256
|
const entries = [];
|
package/dist/core/mcp.d.ts
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
|
+
import { type CredentialEchoSite } from "./credential-echo.js";
|
|
1
2
|
import { type PeerSeat } from "./peer-seat.js";
|
|
2
3
|
import { type McpInstructionsEntry, type PromptSectionDisposer } from "./prompt-section-seat.js";
|
|
3
4
|
import { McpConnectionPool } from "./mcp-connection-pool.js";
|
|
4
5
|
import { type McpAuthorization, type McpDelivered, type McpFailureKind, type McpServerLiveness } from "./mcp-failure.js";
|
|
5
6
|
import type { AgentTool } from "../internal/harness-types.js";
|
|
6
7
|
import type { ImageContent, TextContent } from "../internal/llm.js";
|
|
7
|
-
import { type
|
|
8
|
+
import { type ImageDownsampler } from "./image-downsample.js";
|
|
8
9
|
import type { McpServerSpec, OnElicit, ToolEffect } from "./types.js";
|
|
9
|
-
import type
|
|
10
|
+
import { type McpRevocationLedger } from "./mcp-server-spec.js";
|
|
11
|
+
import { type McpHostSeat } from "./mcp-host-seat.js";
|
|
10
12
|
import { type HostFloor } from "./host-floor.js";
|
|
11
13
|
import { type ReminderDisclosureCounts } from "./reminder-disclosure.js";
|
|
12
14
|
import { type McpLegMetaReader } from "./mcp-call-meta.js";
|
|
@@ -503,7 +505,14 @@ interface McpContentItem {
|
|
|
503
505
|
blob?: string;
|
|
504
506
|
};
|
|
505
507
|
}
|
|
506
|
-
|
|
508
|
+
/**
|
|
509
|
+
* Exported for unit testing (not part of the public package index). ASYNC since design/116 W5: an oversized
|
|
510
|
+
* image and any audio/binary blob are now spilled to disk (see {@link blobToTextBlock} /
|
|
511
|
+
* {@link boundedImageBlock}) instead of being inlined or dropped. `serverName` (when known) attributes the
|
|
512
|
+
* spilled files + labels, mirroring CC's `transformResultContent(resultContent, serverName)`. `imageProcessor` is the run's
|
|
513
|
+
* one processor seat (`RunnerDeps.imageProcessor`), read through `resolveImageProcessor`.
|
|
514
|
+
*/
|
|
515
|
+
export declare function mapContent(content: Array<McpContentItem>, serverName?: string, imageProcessor?: ImageDownsampler | false): Promise<Array<TextContent | ImageContent>>;
|
|
507
516
|
/**
|
|
508
517
|
* Connect to each MCP server, list its tools, and wrap them as AgentTools.
|
|
509
518
|
* Tools are namespaced `mcp__<server>__<tool>` (CC parity) to avoid collisions. The model sees each
|
|
@@ -600,7 +609,7 @@ export declare function normalizeMcpToolSchema(schema: unknown): McpSchemaNormal
|
|
|
600
609
|
*/
|
|
601
610
|
export declare function mcpToolSchemaAdvisory(schema: unknown): string | undefined;
|
|
602
611
|
export declare function mcpToolSchemaProblem(schema: unknown): string | undefined;
|
|
603
|
-
export declare function materializeMcpTools(specs: McpServerSpec[], principal?: string, onElicit?: OnElicit,
|
|
612
|
+
export declare function materializeMcpTools(specs: McpServerSpec[], principal?: string, onElicit?: OnElicit, imageProcessor?: ImageDownsampler | false, // the one image processor seat (`RunnerDeps.imageProcessor`): a processor, `false` (none), absent = auto-detected sharp
|
|
604
613
|
reminderDisclosure?: {
|
|
605
614
|
reminderMark?: string;
|
|
606
615
|
counts?: ReminderDisclosureCounts;
|
|
@@ -610,10 +619,12 @@ reminderDisclosure?: {
|
|
|
610
619
|
pool: McpConnectionPool;
|
|
611
620
|
ownsPool?: boolean;
|
|
612
621
|
}, promptSections?: PromptSectionDisposer, dialable?: (spec: McpServerSpec) => boolean, signal?: AbortSignal, hostFloor?: HostFloor, peerSeat?: PeerSeat, // `RunnerDeps.peerSeat` (peer-seat.ts): what each request carries; absent ⇒ nothing, and a declared `credentials` refuses that dial
|
|
613
|
-
onAuthorizationRequired?: (server: string, authorization: McpAuthorization) => void
|
|
622
|
+
onAuthorizationRequired?: (server: string, authorization: McpAuthorization) => void, // once per server: what a refusal owes the user (the runner's notice)
|
|
623
|
+
hostSeats?: ReadonlyMap<string, McpHostSeat>, // the leg's host seats by declaration name (mcp-host-seat.ts): a `{ kind: "host" }` server dials through its seat; absent ⇒ such a server is refused at its dial
|
|
624
|
+
onCredentialEchoed?: (server: string, where: CredentialEchoSite) => void): Promise<MaterializedMcp>;
|
|
614
625
|
/** The runner's materialization of one leg (not index-exported): every minted tool's `tools/call` reads the leg's request-meta seat
|
|
615
626
|
* (`mcp-call-meta.ts`) — the request meta's only source, written only by the `tool.call` station with what its judge passed. */
|
|
616
|
-
export declare function materializeLegMcpTools(seat: McpLegMetaReader | undefined, ...[specs, principal, onElicit,
|
|
627
|
+
export declare function materializeLegMcpTools(seat: McpLegMetaReader | undefined, ...[specs, principal, onElicit, imageProcessor, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired, hostSeats, onCredentialEchoed]: Parameters<typeof materializeMcpTools>): Promise<MaterializedMcp>;
|
|
617
628
|
/**
|
|
618
629
|
* Fold the caller's AUTHORITATIVE per-tool override (design F: caller = trust root) over the server-hint axis.
|
|
619
630
|
* Unlike server hints, the caller may RAISE or LOWER any axis: `effect` sets the repeat-safety class (lower to
|