@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
|
@@ -7,8 +7,9 @@ import { readHandedRequestMeta } from "../mcp-call-meta.js";
|
|
|
7
7
|
import { ENGINE_ORIGIN } from "./kernel/index.js";
|
|
8
8
|
import { isPlainRecord } from "./kernel/receive.js";
|
|
9
9
|
import { NEXT_IN_FLIGHT } from "./kernel/site-rules.js";
|
|
10
|
-
import { classicEventBase, failedHandlerClause, judgedInputOf } from "./stations.js";
|
|
10
|
+
import { classicEventBase, failedHandlerClause, failedHandlerName, judgedInputOf } from "./stations.js";
|
|
11
11
|
import { runExtensionCall } from "./extension-call.js";
|
|
12
|
+
import { settleWithheldResult } from "../frame-settlement.js";
|
|
12
13
|
import { randomUUID } from "node:crypto";
|
|
13
14
|
const FORM = "tool.call takes next(e), { deny: <reason> } or { result } (a string, or a list of text blocks)";
|
|
14
15
|
const denyOf = (a) => isPlainRecord(a) && Object.keys(a).length === 1 && typeof a["deny"] === "string" && a["deny"] !== "" ? a["deny"] : undefined;
|
|
@@ -49,13 +50,18 @@ const RANKS = Object.freeze({ of: (a) => (denyOf(a) !== undefined ? 1 : 0), top:
|
|
|
49
50
|
export function createToolCallStation(input) {
|
|
50
51
|
if (!input.bus.hasHandlers("tool.call"))
|
|
51
52
|
return undefined;
|
|
52
|
-
const
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
input.occurrences.
|
|
53
|
+
const stationAnswer = (call, by, text) => {
|
|
54
|
+
const content = [{ type: "text", text: formatHookFeedback(text, input.reminderMark) }];
|
|
55
|
+
if (by !== undefined) {
|
|
56
|
+
if (input.occurrences.get(call.toolCallId) !== undefined) {
|
|
57
|
+
input.occurrences.refuse(call.toolCallId, "hook", by);
|
|
58
|
+
input.occurrences.answeredInPlace(call.toolCallId, by);
|
|
59
|
+
}
|
|
60
|
+
input.blockedToolCalls.add(call.toolCallId);
|
|
56
61
|
}
|
|
57
|
-
input.
|
|
58
|
-
|
|
62
|
+
else if (input.frameSettlement !== undefined)
|
|
63
|
+
settleWithheldResult(input.frameSettlement, call.toolCallId, content);
|
|
64
|
+
return { content, details: {}, isError: true };
|
|
59
65
|
};
|
|
60
66
|
return async (call, run, signal) => {
|
|
61
67
|
const e = { ...classicEventBase(input.identity), tool: call.toolName, tool_use_id: call.toolCallId, input: judgedInputOf(call.args) };
|
|
@@ -83,7 +89,7 @@ export function createToolCallStation(input) {
|
|
|
83
89
|
if (!denied && substituteOf(a) === undefined)
|
|
84
90
|
return FORM;
|
|
85
91
|
if (ran.bottomStarted)
|
|
86
|
-
return `a ${denied ? "deny" : "result"} after the tool started (once the tool runs,
|
|
92
|
+
return `a ${denied ? "deny" : "result"} after the tool started (once the tool runs, nothing answers in its place)`;
|
|
87
93
|
if (denied)
|
|
88
94
|
return below.some((b) => denyOf(b) === undefined) ? "a deny while its next(e) still runs or after it was answered (deny in place of next)" : undefined;
|
|
89
95
|
if (below.includes(NEXT_IN_FLIGHT))
|
|
@@ -97,7 +103,7 @@ export function createToolCallStation(input) {
|
|
|
97
103
|
catch (err) {
|
|
98
104
|
if (body !== undefined)
|
|
99
105
|
return body;
|
|
100
|
-
return
|
|
106
|
+
return stationAnswer(call, ENGINE_ORIGIN.plugin, `the tool.call station could not be raised (${describeThrown(err)}); this call to "${extensionWords(call.toolName, 80)}" was NOT executed (fail-closed)`);
|
|
101
107
|
}
|
|
102
108
|
if (outcome.kind === "aborted") {
|
|
103
109
|
if (body !== undefined)
|
|
@@ -105,7 +111,17 @@ export function createToolCallStation(input) {
|
|
|
105
111
|
return { content: [{ type: "text", text: "Operation aborted" }], details: {}, isError: true };
|
|
106
112
|
}
|
|
107
113
|
if (outcome.kind === "failed") {
|
|
108
|
-
|
|
114
|
+
if (outcome.bottomStarted === true && body !== undefined) {
|
|
115
|
+
try {
|
|
116
|
+
await body;
|
|
117
|
+
}
|
|
118
|
+
catch {
|
|
119
|
+
return body;
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
if (outcome.bottomStarted === true)
|
|
123
|
+
return stationAnswer(call, undefined, `a tool.call extension ${failedHandlerName(outcome)} after this call to "${extensionWords(call.toolName, 80)}" ran: a hook that checks this result could not hand back its answer, so the result is withheld — the call ran (fail-closed)`);
|
|
124
|
+
return stationAnswer(call, outcome.registration, `a tool.call extension ${failedHandlerClause(outcome)} before this call to "${extensionWords(call.toolName, 80)}" ran; the call was NOT executed (fail-closed)`);
|
|
109
125
|
}
|
|
110
126
|
const answer = outcome.answer;
|
|
111
127
|
const ran = typeof answer === "object" && answer !== null ? bodies.get(answer) : undefined;
|
|
@@ -114,10 +130,10 @@ export function createToolCallStation(input) {
|
|
|
114
130
|
const by = outcome.answeredBy ?? ENGINE_ORIGIN.plugin;
|
|
115
131
|
const reason = denyOf(answer);
|
|
116
132
|
if (reason !== undefined)
|
|
117
|
-
return
|
|
133
|
+
return stationAnswer(call, by, `extension "${extensionWords(by, 80)}" refused this call to "${extensionWords(call.toolName, 80)}" before it ran: ${extensionWords(reason, 300)}`);
|
|
118
134
|
const content = substituteOf(answer);
|
|
119
135
|
if (content === undefined)
|
|
120
|
-
return
|
|
136
|
+
return stationAnswer(call, by, `extension "${extensionWords(by, 80)}" answered this call in a form tool.call does not take; the call was NOT executed (fail-closed)`);
|
|
121
137
|
if (input.occurrences.get(call.toolCallId) !== undefined)
|
|
122
138
|
input.occurrences.answeredInPlace(call.toolCallId, by);
|
|
123
139
|
input.blockedToolCalls.add(call.toolCallId);
|
|
@@ -127,7 +143,7 @@ export function createToolCallStation(input) {
|
|
|
127
143
|
const AGENT_DOOR = "runs the Agent tool: that is $.agent.spawn";
|
|
128
144
|
const OTHER_DOOR = new Map([
|
|
129
145
|
[toolFace("ask-user-question").contract.contractId, "runs the AskUserQuestion tool, which puts a question to the person: an extension's call does not ask the person"],
|
|
130
|
-
[toolFace("workflow").contract.contractId, "runs the Workflow tool, whose agents run outside the
|
|
146
|
+
[toolFace("workflow").contract.contractId, "runs the Workflow tool, whose agents run outside the tree's bound on agents running at once (RunnerDeps.delegationEntryCaps.maxConcurrent): $.agent.spawn is the door"],
|
|
131
147
|
]);
|
|
132
148
|
export function createToolCallEntry(input) {
|
|
133
149
|
return async (args, ctx) => {
|
|
@@ -136,7 +152,7 @@ export function createToolCallEntry(input) {
|
|
|
136
152
|
if (typeof tool !== "string" || tool === "")
|
|
137
153
|
throw new TypeError(`${by}: $.tool.call takes the event's input: { tool, ...args }`);
|
|
138
154
|
const toolCallId = `ext-${randomUUID()}`;
|
|
139
|
-
return runExtensionCall(input.bus, toolCallId, ctx, async (call) => {
|
|
155
|
+
return runExtensionCall(input.bus, toolCallId, "tool.call", ctx, async (call) => {
|
|
140
156
|
const finalized = await input.harness.callTool({ type: "toolCall", id: toolCallId, name: tool, arguments: { ...callInput } }, ctx.signal, (t) => {
|
|
141
157
|
const contractId = input.faceOf(t.name)?.contractId;
|
|
142
158
|
const door = declaredDelegationNameOf(input.specOf(t.name)) !== undefined ? AGENT_DOOR : contractId !== undefined ? OTHER_DOOR.get(contractId) : undefined;
|
|
@@ -144,7 +160,7 @@ export function createToolCallEntry(input) {
|
|
|
144
160
|
throw new TypeError(`${by}: $.tool.call(${extensionWords(t.name, 80)}) ${door}`);
|
|
145
161
|
});
|
|
146
162
|
if (call.denied)
|
|
147
|
-
return Object.freeze({ deny:
|
|
163
|
+
return Object.freeze({ deny: resultText(finalized.result.content) });
|
|
148
164
|
return viewOf({ ...finalized.result, isError: finalized.isError });
|
|
149
165
|
});
|
|
150
166
|
};
|
|
@@ -158,4 +174,4 @@ export function extensionCallOverlap(input) {
|
|
|
158
174
|
const exclusive = others.find((o) => o.life === "released" && !input.batchSafe(o.wireName ?? o.spelledName, o.finalInput ?? o.args));
|
|
159
175
|
return exclusive === undefined ? undefined : `${name}: an extension's call cannot run beside "${extensionWords(exclusive.wireName ?? exclusive.spelledName, 80)}", which has the run to itself`;
|
|
160
176
|
}
|
|
161
|
-
const
|
|
177
|
+
export const resultText = (content) => (Array.isArray(content) ? content.map((b) => (isPlainRecord(b) && b["type"] === "text" && typeof b["text"] === "string" ? b["text"] : "")).join("") : "");
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
import type { McpServerSpec } from "./mcp-server-spec.js";
|
|
11
11
|
import type { ToolContentOrigin } from "./tool-spec.js";
|
|
12
12
|
import type { McpConnectionPool } from "./mcp-connection-pool.js";
|
|
13
|
+
import type { McpHostSeat } from "./mcp-host-seat.js";
|
|
13
14
|
import type { McpInstructionsEntry } from "./prompt-section-seat.js";
|
|
14
15
|
/** The two names a server's `allowTools` carries to let the cross-server resource readers reach its resources (a server whose allowlist omits one is left out of that reader). */
|
|
15
16
|
export declare const MCP_RESOURCE_LIST_ALLOW = "list_resources";
|
|
@@ -18,6 +19,7 @@ export declare const MCP_RESOURCE_READ_ALLOW = "read_resource";
|
|
|
18
19
|
export declare const LIST_MCP_RESOURCES = "ListMcpResourcesTool";
|
|
19
20
|
export declare const READ_MCP_RESOURCE = "ReadMcpResourceTool";
|
|
20
21
|
export declare const READ_MCP_RESOURCE_DIR = "ReadMcpResourceDirTool";
|
|
22
|
+
export declare const MCP_RESOURCE_FACES: readonly string[];
|
|
21
23
|
/** Does the valve (`leaves`: its one predicate) leave at least one of the cross-server resource tools? While it does, a connected server may contribute to them whatever it lists. */
|
|
22
24
|
export declare function resourceFacesLeft(leaves: (tool: {
|
|
23
25
|
readonly name: string;
|
|
@@ -76,6 +78,8 @@ export interface MountedMcp {
|
|
|
76
78
|
readonly aggregate: ReadonlyArray<string>;
|
|
77
79
|
/** The run tree's connection pool: a child that inherits the mount leases its connections from it. */
|
|
78
80
|
readonly pool?: McpConnectionPool;
|
|
81
|
+
/** The run's host seats by declaration name: a child declared a host-transport server (inherited or its definition's own) is handed that server's seat. */
|
|
82
|
+
readonly hostSeats?: ReadonlyMap<string, McpHostSeat>;
|
|
79
83
|
}
|
|
80
84
|
/** A roster entry as far as this reading goes. */
|
|
81
85
|
interface RosterEntry {
|
|
@@ -101,6 +105,7 @@ export declare function mountedMcpOf(input: {
|
|
|
101
105
|
readonly roster: ReadonlyArray<RosterEntry>;
|
|
102
106
|
readonly aggregateNames: ReadonlySet<string>;
|
|
103
107
|
readonly pool?: McpConnectionPool;
|
|
108
|
+
readonly hostSeats?: ReadonlyMap<string, McpHostSeat>;
|
|
104
109
|
}): MountedMcp;
|
|
105
110
|
/**
|
|
106
111
|
* The MCP tools of a mount as pool rows (name and the server's declared content class) — what the memory content-origin face adds to
|
package/dist/core/mounted-mcp.js
CHANGED
|
@@ -5,7 +5,7 @@ export const MCP_RESOURCE_READ_ALLOW = "read_resource";
|
|
|
5
5
|
export const LIST_MCP_RESOURCES = "ListMcpResourcesTool";
|
|
6
6
|
export const READ_MCP_RESOURCE = "ReadMcpResourceTool";
|
|
7
7
|
export const READ_MCP_RESOURCE_DIR = "ReadMcpResourceDirTool";
|
|
8
|
-
const MCP_RESOURCE_FACES = [LIST_MCP_RESOURCES, READ_MCP_RESOURCE, READ_MCP_RESOURCE_DIR];
|
|
8
|
+
export const MCP_RESOURCE_FACES = Object.freeze([LIST_MCP_RESOURCES, READ_MCP_RESOURCE, READ_MCP_RESOURCE_DIR]);
|
|
9
9
|
export function resourceFacesLeft(leaves) {
|
|
10
10
|
return MCP_RESOURCE_FACES.some((name) => leaves({ name }));
|
|
11
11
|
}
|
|
@@ -78,7 +78,7 @@ export function mountedMcpOf(input) {
|
|
|
78
78
|
return { server, tools };
|
|
79
79
|
});
|
|
80
80
|
const aggregate = input.roster.filter((t) => input.aggregateNames.has(t.name)).map((t) => t.name);
|
|
81
|
-
return { servers, aggregate, ...(input.pool !== undefined ? { pool: input.pool } : {}) };
|
|
81
|
+
return { servers, aggregate, ...(input.pool !== undefined ? { pool: input.pool } : {}), ...(input.hostSeats !== undefined ? { hostSeats: input.hostSeats } : {}) };
|
|
82
82
|
}
|
|
83
83
|
export function mountedMcpPoolRows(mounted) {
|
|
84
84
|
return [
|
|
@@ -30,6 +30,12 @@ export declare function wildcardMatch(pattern: string, value: string): boolean;
|
|
|
30
30
|
* that is no behavior word (an array index handed by `filter`, say) is refused loudly, never read as either list.
|
|
31
31
|
*/
|
|
32
32
|
export declare function isCoveringRuleName(name: string, behavior: RuleBehavior): boolean;
|
|
33
|
+
/**
|
|
34
|
+
* The part of {@link isCoveringRuleName} that is a fact about the NAME alone: the name reaches a SET of tool names whatever list it
|
|
35
|
+
* is written in (a `*` it reads, or a bare protocol peer). A stored rule names ONE tool, so its grammar asks only this — a tool name
|
|
36
|
+
* that a restricting list also reads as another server's spelling ({@link peerReadingsOf}) is still one tool's name there.
|
|
37
|
+
*/
|
|
38
|
+
export declare function namesASetOfTools(name: string, behavior: RuleBehavior): boolean;
|
|
33
39
|
/**
|
|
34
40
|
* Does a covering rule name ({@link isCoveringRuleName}) cover `toolName`? A name with a `*` is a glob over the WHOLE name
|
|
35
41
|
* ({@link wildcardMatch} — the reference's `p` matcher): `mcp__srv__get_*` reaches `mcp__srv__get_issue`, `mcp__*` every MCP tool,
|
|
@@ -46,4 +52,4 @@ export declare function ruleNameCovers(ruleName: string, toolName: string): bool
|
|
|
46
52
|
* minted under the peer is then matched by the glob up to its last `*`, which takes the rest; a glob that does not end in `*` leaves
|
|
47
53
|
* a tool name it does not match. The one reading of a name against a peer that the tool-name lists take.
|
|
48
54
|
*/
|
|
49
|
-
export declare function ruleNameReachIntoPeer(ruleName: string, ns: ProtocolNamespace, peer: string): "all" | "some" | "none";
|
|
55
|
+
export declare function ruleNameReachIntoPeer(ruleName: string, ns: ProtocolNamespace, peer: string, readsOtherServers?: boolean): "all" | "some" | "none";
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { grantWildcardRefusalOf, readsNameGlob, splitNamespacedName } from "./tool-name-aliases.js";
|
|
1
|
+
import { grantWildcardRefusalOf, peerReadingsOf, readsNameGlob, splitNamespacedName } from "./tool-name-aliases.js";
|
|
2
2
|
export function wildcardMatch(pattern, value) {
|
|
3
3
|
const first = pattern.indexOf("*");
|
|
4
4
|
if (first < 0)
|
|
@@ -28,6 +28,9 @@ function namespacedPeerOf(name) {
|
|
|
28
28
|
return split === undefined || split.peer === "" ? undefined : split;
|
|
29
29
|
}
|
|
30
30
|
export function isCoveringRuleName(name, behavior) {
|
|
31
|
+
return namesASetOfTools(name, behavior) || (readsNameGlob(behavior) && peerReadingsOf(name).length > 0);
|
|
32
|
+
}
|
|
33
|
+
export function namesASetOfTools(name, behavior) {
|
|
31
34
|
if (behavior !== "deny" && behavior !== "ask" && behavior !== "allow") {
|
|
32
35
|
throw new TypeError(`isCoveringRuleName: the list's behavior must be "deny", "ask" or "allow" (got ${typeof behavior === "string" ? JSON.stringify(behavior) : typeof behavior}) — a "*" in a name reads one way on a list that restricts and another on one that grants`);
|
|
33
36
|
}
|
|
@@ -39,19 +42,27 @@ export function isCoveringRuleName(name, behavior) {
|
|
|
39
42
|
export function ruleNameCovers(ruleName, toolName) {
|
|
40
43
|
if (ruleName.includes("*"))
|
|
41
44
|
return wildcardMatch(ruleName, toolName);
|
|
45
|
+
const readings = peerReadingsOf(ruleName);
|
|
46
|
+
if (readings.length > 0) {
|
|
47
|
+
const target = namespacedPeerOf(toolName);
|
|
48
|
+
return target !== undefined && readings.some((r) => r.ns.id === target.ns.id && r.peer === target.peer && (r.tool === undefined || r.tool === target.tool));
|
|
49
|
+
}
|
|
42
50
|
const rule = namespacedPeerOf(ruleName);
|
|
43
51
|
if (rule === undefined || rule.tool !== undefined)
|
|
44
52
|
return false;
|
|
45
53
|
const target = namespacedPeerOf(toolName);
|
|
46
54
|
return target !== undefined && target.ns.id === rule.ns.id && target.peer === rule.peer;
|
|
47
55
|
}
|
|
48
|
-
export function ruleNameReachIntoPeer(ruleName, ns, peer) {
|
|
56
|
+
export function ruleNameReachIntoPeer(ruleName, ns, peer, readsOtherServers = false) {
|
|
49
57
|
if (ruleName.includes("*")) {
|
|
50
58
|
if (ruleName.endsWith("*") && wildcardMatch(ruleName, `${ns.prefix}${peer}__`))
|
|
51
59
|
return "all";
|
|
52
60
|
const rule = namespacedPeerOf(ruleName);
|
|
53
61
|
return rule !== undefined && rule.ns.id === ns.id && rule.peer === peer ? "some" : "none";
|
|
54
62
|
}
|
|
63
|
+
const readings = readsOtherServers ? peerReadingsOf(ruleName).filter((r) => r.ns.id === ns.id && r.peer === peer) : [];
|
|
64
|
+
if (readings.length > 0)
|
|
65
|
+
return readings.some((r) => r.tool === undefined) ? "all" : "some";
|
|
55
66
|
const rule = namespacedPeerOf(ruleName);
|
|
56
67
|
if (rule === undefined || rule.ns.id !== ns.id || rule.peer !== peer)
|
|
57
68
|
return "none";
|
|
@@ -6,7 +6,7 @@ function probeCommand(canonOraclePath) {
|
|
|
6
6
|
return `touch -- ${q}/.oracle-isolation-probe 2>/dev/null`;
|
|
7
7
|
}
|
|
8
8
|
export async function assertOracleIsolation(workerEnv, grader, opts) {
|
|
9
|
-
const isolationClass = isIsolated(grader.env)
|
|
9
|
+
const isolationClass = isIsolated(grader.env) && isRemoteExecutionEnv(grader.env)
|
|
10
10
|
? "out_of_process"
|
|
11
11
|
: "in_process_probe_only";
|
|
12
12
|
if (grader.env === workerEnv) {
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
2
2
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
3
|
+
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
4
|
+
const OUTPUT_STYLE_KEYS = optionKeys()({ name: 0, turnReminder: 0 });
|
|
3
5
|
export const OUTPUT_STYLE_NAME_MAX = 256;
|
|
4
6
|
const OUTPUT_STYLE_DEFAULT_TURN_REMINDER = "Remember to follow the specific guidelines for this style.";
|
|
5
7
|
export function renderOutputStyle(name, turnReminder) {
|
|
@@ -15,10 +17,7 @@ export function resolveOutputStyleFrame(seat) {
|
|
|
15
17
|
};
|
|
16
18
|
if (seat === null || typeof seat !== "object" || Array.isArray(seat))
|
|
17
19
|
return refuse(`must be an object { name, turnReminder? } (got ${describeRejectedValue(seat)})`);
|
|
18
|
-
const
|
|
19
|
-
if (extra.length > 0)
|
|
20
|
-
return refuse(`carries ${extra.map((k) => JSON.stringify(k)).join(", ")}, which the seat does not read (members: "name", "turnReminder")`);
|
|
21
|
-
const { name, turnReminder } = seat;
|
|
20
|
+
const { name, turnReminder } = receiveMembers(seat, { subject: "TaskSpec.outputStyle", unit: "member", moment: "when the seat is read" }, OUTPUT_STYLE_KEYS, (_, extra) => refuse(`carries ${extra.map((k) => JSON.stringify(String(k))).join(", ")}, which the seat does not read (members: "name", "turnReminder")`));
|
|
22
21
|
if (typeof name !== "string" || name.trim() === "")
|
|
23
22
|
return refuse(`.name must be a non-empty string (got ${describeRejectedValue(name)})`);
|
|
24
23
|
if (name.length > OUTPUT_STYLE_NAME_MAX)
|
|
@@ -27,5 +27,67 @@ export declare const CONFIG_RECEIPT_MODE: ReceiptMode;
|
|
|
27
27
|
* itself, a container nested deeper — a shared one measured where it sits each time it is met), every copied container frozen.
|
|
28
28
|
*/
|
|
29
29
|
export declare const DECLARATION_RECEIPT_MODE: ReceiptMode;
|
|
30
|
+
/** Only {@link optionKeys} mints an {@link OptionKeys}: a hand-written list carries no brand. */
|
|
31
|
+
declare const OPTION_KEYS: unique symbol;
|
|
32
|
+
/**
|
|
33
|
+
* A constructor's options table: the keys of the options interface `T`, exactly. The brand is a function over `keyof T`
|
|
34
|
+
* in both positions, so a table for one interface is not a table for another (a narrower one, an `Omit` of it) in either
|
|
35
|
+
* direction, and a plain string list is not one at all.
|
|
36
|
+
*/
|
|
37
|
+
export type OptionKeys<T> = readonly string[] & {
|
|
38
|
+
readonly [OPTION_KEYS]: (key: keyof T) => keyof T;
|
|
39
|
+
};
|
|
40
|
+
/** The keys of `K` outside `T`, taken arm by arm when `K` is a union (each arm's own keys, not only the keys all arms share). */
|
|
41
|
+
type SurplusKeys<K, T> = K extends unknown ? Exclude<keyof K, keyof T> : never;
|
|
42
|
+
/** The minter {@link optionKeys} hands back: `never` — not callable — for an interface with an index signature, whose keys no
|
|
43
|
+
* table can name. */
|
|
44
|
+
type OptionKeysMinter<T> = string extends keyof T ? never : number extends keyof T ? never : <K extends Record<keyof T, 0>>(table: K & Record<SurplusKeys<K, T>, never>) => OptionKeys<T>;
|
|
45
|
+
/**
|
|
46
|
+
* Mint the options table of interface `T` from a literal naming each of its keys once (`{ fsync: 0, lockWaitMs: 0 }`).
|
|
47
|
+
* Curried so `T` is written and the literal inferred: a key of `T` the literal leaves out does not compile, and neither
|
|
48
|
+
* does a key `T` lacks — whether the literal is fresh, a variable, a spread, or a union whose arms each carry one — since
|
|
49
|
+
* every key outside `T` must be `never`. An interface with an index signature has no table (the minter is not callable).
|
|
50
|
+
*/
|
|
51
|
+
export declare function optionKeys<T extends object>(): OptionKeysMinter<T>;
|
|
52
|
+
/** The OPTIONS DOOR — a constructor's options bag received by the receipt law, absent ⇒ an empty one: every option the constructor reads
|
|
53
|
+
* is read off this frozen copy, once, and the caller's bag is never read again (a store keeps no hold of it). `owner` names the
|
|
54
|
+
* constructor; `keys` is the table of the options it takes ({@link optionKeys}), and an option outside it is refused by name
|
|
55
|
+
* ({@link receiveMembers}). */
|
|
56
|
+
export declare function receiveOptions<T extends object>(given: T | undefined, owner: string, keys: OptionKeys<T>): Readonly<T>;
|
|
30
57
|
/** Read `given` by the receipt law (module note): the plain copy, every own member taken once from its captured descriptor. */
|
|
31
58
|
export declare function receiveOwnProperties<T extends object>(given: T, words: OwnPropertyReceiptWords): T;
|
|
59
|
+
/** How a door whose family has its own code refuses its stray members: the one sentence, and the stray names it names
|
|
60
|
+
* (a symbol as itself), for a refusal that also carries them as data. */
|
|
61
|
+
export type StrayMembersRefusal = (message: string, stray: readonly (string | symbol)[]) => Error;
|
|
62
|
+
/** A record's members outside a door's table: their names (a symbol as itself) and the one sentence that names them. */
|
|
63
|
+
export interface StrayMembers {
|
|
64
|
+
readonly names: readonly (string | symbol)[];
|
|
65
|
+
readonly sentence: string;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* THE NAME JUDGMENT of a door (module note): every own member of `given` that `keys` does not name — a string key,
|
|
69
|
+
* enumerable or not, and a symbol key — with the one sentence that names them all (each with its nearest taken name within
|
|
70
|
+
* two edits, then the members taken); `undefined` when there is none. It reads names only: no getter runs and no value is
|
|
71
|
+
* looked at. On an admitted object (a plain record that is no Proxy, or a copy a receipt made) no caller code runs; a
|
|
72
|
+
* reader whose own law reads the caller's live object judges the names that object answers (a Proxy's own-keys answer
|
|
73
|
+
* included). A reader that answers a sentence instead of throwing takes this; a door that throws takes
|
|
74
|
+
* {@link refuseStrayMembers} or {@link receiveMembers}.
|
|
75
|
+
*/
|
|
76
|
+
export declare function strayMembersOf(given: object, words: OwnPropertyReceiptWords, keys: readonly string[]): StrayMembers | undefined;
|
|
77
|
+
/**
|
|
78
|
+
* THE NAME-ONLY DOOR — the receipt's admission (not a Proxy, a plain record), then {@link strayMembersOf}: every own member
|
|
79
|
+
* `keys` does not name is refused, all of them in one sentence, and no getter runs. For an object the door must judge but
|
|
80
|
+
* not copy (a face whose callbacks are later called with the object itself as `this`); a door that takes a copy takes
|
|
81
|
+
* {@link receiveMembers}, which is this judgment followed by the receipt.
|
|
82
|
+
*/
|
|
83
|
+
export declare function refuseStrayMembers(given: object, words: OwnPropertyReceiptWords, keys: readonly string[], refusal?: StrayMembersRefusal): void;
|
|
84
|
+
/**
|
|
85
|
+
* Read `given` by the receipt law and refuse every own member `keys` does not name (module note): the members a door
|
|
86
|
+
* takes, and nothing else, by one reading. The names are judged ({@link refuseStrayMembers}) before the receipt runs any
|
|
87
|
+
* getter, and nothing of the caller's runs between that judgment and the receipt's one capture, so the names judged are
|
|
88
|
+
* the names read. `refusal` codes the stray-member refusal for a door whose family has its own code (the receipt's own
|
|
89
|
+
* refusals keep `config.invalid_argument`). The copy handed back is frozen: what was judged is what is held, and a
|
|
90
|
+
* callback the door's owner later calls on it (its `this`) cannot change a member.
|
|
91
|
+
*/
|
|
92
|
+
export declare function receiveMembers<T extends object>(given: T, words: OwnPropertyReceiptWords, keys: readonly string[], refusal?: StrayMembersRefusal): Readonly<T>;
|
|
93
|
+
export {};
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import { types } from "node:util";
|
|
2
|
+
import { closestName } from "./closest-name.js";
|
|
3
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
2
4
|
import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
3
5
|
import { MODS_VALUE_DEPTH } from "./mods/kernel/site-rules.js";
|
|
4
6
|
export function receiptRefusal(message) {
|
|
@@ -12,11 +14,37 @@ export function refuseProxy(given, words) {
|
|
|
12
14
|
}
|
|
13
15
|
export const CONFIG_RECEIPT_MODE = Object.freeze({ accessors: "call-once", depth: 1, others: "as-is", isProxy: (v) => types.isProxy(v) });
|
|
14
16
|
export const DECLARATION_RECEIPT_MODE = Object.freeze({ accessors: "call-once", depth: MODS_VALUE_DEPTH + 1, others: "refuse", freeze: true, isProxy: (v) => types.isProxy(v) });
|
|
17
|
+
export function optionKeys() {
|
|
18
|
+
return ((table) => Object.freeze(Object.keys(table)));
|
|
19
|
+
}
|
|
20
|
+
export function receiveOptions(given, owner, keys) {
|
|
21
|
+
return given === undefined ? Object.freeze({}) : receiveMembers(given, { subject: `${owner} options`, unit: "option", moment: `at new ${owner}` }, keys);
|
|
22
|
+
}
|
|
15
23
|
export function receiveOwnProperties(given, words) {
|
|
24
|
+
admitPlainRecord(given, words);
|
|
25
|
+
return readCaptured(given, words);
|
|
26
|
+
}
|
|
27
|
+
export function strayMembersOf(given, words, keys) {
|
|
28
|
+
const names = Reflect.ownKeys(given).filter((k) => typeof k === "symbol" || !keys.includes(k));
|
|
29
|
+
return names.length === 0 ? undefined : Object.freeze({ names: Object.freeze(names), sentence: strayMembersSentence(words, names, keys) });
|
|
30
|
+
}
|
|
31
|
+
export function refuseStrayMembers(given, words, keys, refusal = receiptRefusal) {
|
|
32
|
+
admitPlainRecord(given, words);
|
|
33
|
+
const stray = strayMembersOf(given, words, keys);
|
|
34
|
+
if (stray !== undefined)
|
|
35
|
+
throw refusal(stray.sentence, stray.names);
|
|
36
|
+
}
|
|
37
|
+
export function receiveMembers(given, words, keys, refusal = receiptRefusal) {
|
|
38
|
+
refuseStrayMembers(given, words, keys, refusal);
|
|
39
|
+
return Object.freeze(readCaptured(given, words));
|
|
40
|
+
}
|
|
41
|
+
function admitPlainRecord(given, words) {
|
|
16
42
|
refuseProxy(given, words);
|
|
17
43
|
if (!isPlainRecord(given)) {
|
|
18
44
|
throw receiptRefusal(`${words.subject} must be a plain object (its prototype is neither Object.prototype nor null): every ${words.unit} is read once as an own property, and a ${words.unit} its prototype would supply is not read — refused rather than wired without it`);
|
|
19
45
|
}
|
|
46
|
+
}
|
|
47
|
+
function readCaptured(given, words) {
|
|
20
48
|
const received = receive(given, CONFIG_RECEIPT_MODE);
|
|
21
49
|
if (received.ok)
|
|
22
50
|
return received.value;
|
|
@@ -27,3 +55,18 @@ export function receiveOwnProperties(given, words) {
|
|
|
27
55
|
throw receiptRefusal(`${words.subject}'s prototype changed while its ${words.unit}s were read ${words.moment} — refused rather than wired from a moving object`);
|
|
28
56
|
throw receiptRefusal(`${words.subject} could not be read ${words.moment}: ${describeFault(received.fault)} — refused rather than wired without it`);
|
|
29
57
|
}
|
|
58
|
+
const STRAY_NAME_MAX = 80;
|
|
59
|
+
function strayMembersSentence(words, stray, keys) {
|
|
60
|
+
const named = stray.map((k) => {
|
|
61
|
+
if (typeof k === "symbol")
|
|
62
|
+
return `${inlineUntrusted(String(k), STRAY_NAME_MAX)} (a symbol-keyed member)`;
|
|
63
|
+
const shown = JSON.stringify(inlineUntrusted(k, STRAY_NAME_MAX));
|
|
64
|
+
const near = closestName(k, keys);
|
|
65
|
+
return near === undefined ? shown : `${shown} (did you mean ${JSON.stringify(near)}?)`;
|
|
66
|
+
});
|
|
67
|
+
const one = stray.length === 1;
|
|
68
|
+
const unit = words.unit;
|
|
69
|
+
const what = one ? `is not ${/^[aeiou]/i.test(unit) ? "an" : "a"} ${unit}` : `are not ${unit}s`;
|
|
70
|
+
const takes = keys.length === 0 ? `it takes no ${unit}s` : `the ${unit}s it takes are ${keys.map((k) => JSON.stringify(k)).join(", ")}`;
|
|
71
|
+
return `${words.subject}: ${named.join(", ")} ${what} it takes — ${takes}; refused ${words.moment} rather than read as absent (a misspelled ${unit} would leave its default in force and nothing would say so)`;
|
|
72
|
+
}
|
|
@@ -92,6 +92,7 @@ function syntheticCheckpoint(scope, fidelity) {
|
|
|
92
92
|
batchToolCallIds: [`${scope}:call`],
|
|
93
93
|
completedCallIds: [],
|
|
94
94
|
},
|
|
95
|
+
heldRows: [{ role: "user", content: [{ type: "text", text: "park wiring self-check held row" }], timestamp: 0, provenance: "engine-note", rewrittenBy: ["park-selfcheck"] }],
|
|
95
96
|
state: { activeTools: ["SelfCheck"], nestedStats: { tokens: 0, turns: 0, tasks: 0, costMicroUsd: 0, anyUnpriced: false } },
|
|
96
97
|
status: "pending",
|
|
97
98
|
createdAt: Date.now(),
|
|
@@ -99,7 +100,7 @@ function syntheticCheckpoint(scope, fidelity) {
|
|
|
99
100
|
suspendedAt: Date.now(),
|
|
100
101
|
resourceLedger: { spentMicroUsd: 0, spentTokens: 0, spentTurns: 0, sliceCount: 1 },
|
|
101
102
|
humanReview: { count: 1, totalWaitMs: 0, gates: [{ kind: "human", waitMs: 0, decision: "approve", toolName: "SelfCheck", toolCallId: `${scope}:selfcheck-call`, toolArg: "park self-check probe" }] },
|
|
102
|
-
|
|
103
|
+
sourceSessionId: `${scope}:session`,
|
|
103
104
|
principal: `${scope}:principal`,
|
|
104
105
|
durableApproval: { scope, ttlMs: PARK_SELFCHECK_ROW_TTL_MS },
|
|
105
106
|
deadline: Date.now() + PARK_SELFCHECK_ROW_TTL_MS,
|
|
@@ -112,6 +113,7 @@ function faithfulnessDelta(sent, got) {
|
|
|
112
113
|
scope: cp.scope,
|
|
113
114
|
sessionId: cp.sessionId,
|
|
114
115
|
leafId: cp.leafId,
|
|
116
|
+
heldRows: cp.heldRows,
|
|
115
117
|
gate: cp.gate,
|
|
116
118
|
pendingAction: cp.pendingAction,
|
|
117
119
|
state: cp.state,
|
|
@@ -124,7 +126,7 @@ function faithfulnessDelta(sent, got) {
|
|
|
124
126
|
suspendedAt: cp.suspendedAt,
|
|
125
127
|
resourceLedger: cp.resourceLedger,
|
|
126
128
|
humanReview: cp.humanReview,
|
|
127
|
-
|
|
129
|
+
sourceSessionId: cp.sourceSessionId,
|
|
128
130
|
principal: cp.principal,
|
|
129
131
|
durableApproval: cp.durableApproval,
|
|
130
132
|
});
|
|
@@ -219,10 +221,11 @@ export async function probeParkRoundTrip(deps, spec = {}) {
|
|
|
219
221
|
return await failed("row_not_faithful", delta);
|
|
220
222
|
if (status !== "pending")
|
|
221
223
|
return await failed("row_not_pending", `the filed row came back with status ${shown(status)} — a park in any other status is one nobody can resolve`);
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
224
|
+
{
|
|
225
|
+
const listByScope = store.listByScope;
|
|
226
|
+
if (typeof listByScope !== "function")
|
|
227
|
+
return await failed("row_not_enumerable", "the store implements no listByScope — an inbox enumerating this scope reads nothing");
|
|
228
|
+
const listed = await within(() => listByScope.call(store, scope), "listByScope");
|
|
226
229
|
if ("timedOut" in listed)
|
|
227
230
|
return await failed("row_not_enumerable", listed.timedOut);
|
|
228
231
|
if ("threw" in listed)
|
|
@@ -265,8 +268,7 @@ export async function probeParkRoundTrip(deps, spec = {}) {
|
|
|
265
268
|
: `expire lost an UNCONTENDED CAS and the row reads ${shown(afterStatus)} — the fence that keeps a checkpoint from being both reaped and resumed does not close here`);
|
|
266
269
|
}
|
|
267
270
|
}
|
|
268
|
-
const steps =
|
|
269
|
-
const notExercised = enumerable ? "" : " (this store implements no listByScope, so the inbox enumeration was NOT exercised)";
|
|
271
|
+
const steps = "filed, read back, enumerated and fenced";
|
|
270
272
|
const casNote = fenced ? "" : " (the expire CAS reported a loss while the row closed — consistent with store housekeeping, but a backend that mis-reports CAS wins is not distinguished here)";
|
|
271
273
|
return {
|
|
272
274
|
verdict: "round_trip_ok",
|
|
@@ -274,8 +276,8 @@ export async function probeParkRoundTrip(deps, spec = {}) {
|
|
|
274
276
|
...(fenced ? {} : { casLossObserved: true }),
|
|
275
277
|
scope,
|
|
276
278
|
summary: after === null
|
|
277
|
-
? `the park lane ${steps} a synthetic checkpoint
|
|
278
|
-
: `the park lane ${steps} a synthetic checkpoint
|
|
279
|
+
? `the park lane ${steps} a synthetic checkpoint — the row is no longer present (a deleting backend or its own housekeeping removed it), so nothing resumable remains${casNote}`
|
|
280
|
+
: `the park lane ${steps} a synthetic checkpoint — residual expired row in scope "${scope}"${casNote}`,
|
|
279
281
|
...gapCell,
|
|
280
282
|
};
|
|
281
283
|
}
|
|
@@ -22,5 +22,16 @@ export type ChainHopsReading = {
|
|
|
22
22
|
* cannot answer not vote ({@link chainHopsOrNone}), an allow admits nothing it could not see.
|
|
23
23
|
*/
|
|
24
24
|
export declare function symlinkChainHops(env: ExecutionEnv, path: string, signal: AbortSignal | undefined, family: PathFamily, baseCwd?: string): Promise<ChainHopsReading>;
|
|
25
|
+
/**
|
|
26
|
+
* Whether a target's leaf chain can hold a hop, once the environment said where the target lands: a link may be on the way
|
|
27
|
+
* when what was walked climbs a `..` (the lexical fold of `..` across a linked parent names another file than the one the
|
|
28
|
+
* filesystem walks to) or when the reader cannot say the target landed at its own lexical spelling (`landedElsewhere`: a
|
|
29
|
+
* link resolved elsewhere, or a resolution that rejoined a missing tail as spelled — the leaf may be a link whose target is
|
|
30
|
+
* not there yet). Where neither holds nothing on the way is a link, and the chain is not asked. The readers that skip the chain where no
|
|
31
|
+
* link can be on the way take this one gate before {@link symlinkChainHops}: a call's target views (`readPath`) and the shell read
|
|
32
|
+
* station's establishment. The write-protection table and the sensitive-path deny set do not: they read the chain whenever one of
|
|
33
|
+
* their rows can hear a hop.
|
|
34
|
+
*/
|
|
35
|
+
export declare function leafChainMayHold(walked: readonly (string | undefined)[], landedElsewhere: boolean, family: PathFamily): boolean;
|
|
25
36
|
/** A path guard's reading of a chain: the hops, or none — a view that cannot answer does not vote (its absence law). */
|
|
26
37
|
export declare function chainHopsOrNone(reading: ChainHopsReading): readonly string[];
|
|
@@ -13,6 +13,10 @@ export async function symlinkChainHops(env, path, signal, family, baseCwd) {
|
|
|
13
13
|
const chain = await env.canonicalChain(target, signal);
|
|
14
14
|
return chain.ok ? { ok: true, hops: chain.value.hops } : { ok: false, cause: chain.error.message, asked: true };
|
|
15
15
|
}
|
|
16
|
+
export function leafChainMayHold(walked, landedElsewhere, family) {
|
|
17
|
+
const climbs = family === "win" ? /(^|[\\/])\.\.([\\/]|$)/ : /(^|\/)\.\.(\/|$)/;
|
|
18
|
+
return landedElsewhere || walked.some((s) => s !== undefined && climbs.test(s));
|
|
19
|
+
}
|
|
16
20
|
export function chainHopsOrNone(reading) {
|
|
17
21
|
return reading.ok ? reading.hops : [];
|
|
18
22
|
}
|
|
@@ -35,7 +35,9 @@ export declare function bindPathRules<S extends PathRuleSpec>(specs: readonly S[
|
|
|
35
35
|
* alone. */
|
|
36
36
|
export declare function policyAnchors(declared: PathRuleBases, install: PathRuleBases | undefined): PathRuleBases;
|
|
37
37
|
/** A stored row's anchors: a PROJECT row's `/x` and relative words at the row's own scope root (the project it was written
|
|
38
|
-
* for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row.
|
|
38
|
+
* for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row. A row has no seat for a
|
|
39
|
+
* settings layer's own directory, so the settings import carries only the rules a row reads the way their layer does — a
|
|
40
|
+
* user layer's `/x`, read there at the configuration directory, stays in its file (`prepareCcImport`). */
|
|
39
41
|
export declare function persistedRowAnchors(scope: RuleScope, chainTop: PathRuleBases): PathRuleBases;
|
|
40
42
|
/** A leg's root as an identity for project coverage ({@link ScopeRootIdentity}): its canonical root, and each project
|
|
41
43
|
* row's scope root resolved through the leg's resolution (`leads`, each location once per leg) — so a row written under
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { parsePermissionRule } from "./permission-rule-syntax.js";
|
|
2
|
-
import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, ruleBasesNeeded } from "./permission-rule-model.js";
|
|
2
|
+
import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, pathRuleReachShapeOf, ruleBasesNeeded } from "./permission-rule-model.js";
|
|
3
3
|
import { pathFamilyOf, spellingOfIdentity } from "../tools/fs/safety.js";
|
|
4
4
|
import { absoluteTargetIdentityOf } from "./effective-path-target.js";
|
|
5
5
|
import { locationLeadsTo, ruleHeadParts } from "../tools/fs/read-deny.js";
|
|
@@ -12,6 +12,7 @@ export function bindPathRules(specs, anchors) {
|
|
|
12
12
|
const a = typeof anchors === "function" ? anchors(spec) : anchors;
|
|
13
13
|
const family = pathFamilyOf(a);
|
|
14
14
|
const head = pathRuleHeadOf(spec.parsed, a);
|
|
15
|
+
const shape = pathRuleReachShapeOf(spec.parsed, a);
|
|
15
16
|
const unanchored = ruleBasesNeeded(spec.parsed).filter((b) => !isUsablePathBase(b === "cwd" ? (a.cwd ?? a.root) : a[b], family));
|
|
16
17
|
const reach = (absolutePath) => {
|
|
17
18
|
const tree = a.root !== undefined || a.cwd !== undefined ? a : { root: absolutePath };
|
|
@@ -28,6 +29,7 @@ export function bindPathRules(specs, anchors) {
|
|
|
28
29
|
reach,
|
|
29
30
|
reaches: (absolutePath) => reach(absolutePath).reach !== "not_reached",
|
|
30
31
|
...(head !== undefined ? { head: spellingOfIdentity(head, family) } : {}),
|
|
32
|
+
...(shape !== undefined && (a.root !== undefined || a.cwd !== undefined) ? { reachShape: shape } : {}),
|
|
31
33
|
...(unanchored.length > 0 ? { unanchored } : {}),
|
|
32
34
|
};
|
|
33
35
|
});
|