@sema-agent/core 7.58.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 +1340 -0
- package/README.md +6 -4
- 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/cc-peer-directory.js +8 -8
- package/dist/agents/child-model-seat.d.ts +4 -2
- package/dist/agents/child-model-seat.js +9 -4
- 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/peer-directory.d.ts +9 -0
- package/dist/agents/peer-directory.js +6 -2
- 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 +32 -50
- package/dist/agents/subagent.d.ts +51 -17
- package/dist/agents/subagent.js +150 -112
- 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/anthropic.js +161 -45
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +9 -3
- package/dist/brain/errors.js +7 -1
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +3 -3
- package/dist/brain/openai.js +103 -53
- package/dist/brain/provider-dialect.d.ts +11 -0
- package/dist/brain/provider-dialect.js +5 -2
- package/dist/brain/reasoning-request.js +5 -4
- package/dist/brain/reasoning.d.ts +19 -0
- package/dist/brain/reasoning.js +17 -2
- package/dist/brain/request-route.d.ts +4 -1
- package/dist/brain/request-route.js +4 -1
- package/dist/brain/route-adjudicator.d.ts +84 -18
- package/dist/brain/route-adjudicator.js +90 -22
- package/dist/brain/route-conformance.js +1 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.js +84 -49
- package/dist/brain/stream-shared.d.ts +30 -0
- package/dist/brain/stream-shared.js +34 -1
- package/dist/brain/timeout.d.ts +65 -6
- package/dist/brain/timeout.js +111 -11
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/account-row.d.ts +61 -0
- package/dist/core/account-row.js +51 -0
- package/dist/core/advisor-verdict.d.ts +2 -1
- package/dist/core/advisor-verdict.js +1 -1
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/allow-entry.d.ts +20 -6
- package/dist/core/allow-entry.js +17 -7
- package/dist/core/approval-object.d.ts +29 -15
- package/dist/core/approval-object.js +47 -19
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/auto-compaction.js +1 -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 +26 -4
- 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-requirements.d.ts +13 -1
- package/dist/core/checkpoint-requirements.js +3 -1
- package/dist/core/checkpoint-store.d.ts +66 -25
- package/dist/core/checkpoint-store.js +22 -9
- package/dist/core/child-clamp-seats.d.ts +29 -0
- package/dist/core/child-clamp-seats.js +56 -1
- package/dist/core/compliance.d.ts +3 -3
- package/dist/core/compliance.js +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/effective-path-target.d.ts +8 -2
- package/dist/core/effective-path-target.js +8 -3
- package/dist/core/engine-notice.d.ts +156 -23
- package/dist/core/engine-notice.js +19 -5
- package/dist/core/frame-settlement.d.ts +5 -0
- package/dist/core/frame-settlement.js +4 -0
- package/dist/core/gate-fold.js +8 -6
- package/dist/core/gate-lanes.js +47 -12
- package/dist/core/gate-outcome.d.ts +32 -3
- package/dist/core/gate-outcome.js +19 -1
- package/dist/core/governance-codes.d.ts +17 -1
- package/dist/core/governance-codes.js +25 -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 +70 -59
- package/dist/core/hooks.js +125 -80
- package/dist/core/image-admission.d.ts +106 -52
- package/dist/core/image-admission.js +184 -56
- 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 +59 -5
- package/dist/core/locked-config.js +82 -50
- package/dist/core/mailbox-store.d.ts +45 -1
- package/dist/core/mailbox-store.js +53 -9
- 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 +122 -20
- package/dist/core/mcp-failure.js +73 -5
- 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-link.d.ts +22 -1
- package/dist/core/mcp-server-link.js +25 -1
- 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 +27 -12
- package/dist/core/mcp.js +105 -76
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
- package/dist/core/memory-engine/consolidation-driver.js +3 -3
- package/dist/core/memory-engine/consolidation.d.ts +4 -0
- package/dist/core/memory-engine/consolidation.js +1 -0
- 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/delegation-settlement.js +5 -12
- package/dist/core/memory-engine/distiller.js +2 -2
- package/dist/core/memory-engine/dual-root.d.ts +50 -1
- package/dist/core/memory-engine/dual-root.js +44 -1
- package/dist/core/memory-engine/engine.d.ts +67 -14
- package/dist/core/memory-engine/engine.js +384 -212
- package/dist/core/memory-engine/export-bundle.d.ts +23 -0
- package/dist/core/memory-engine/export-bundle.js +23 -4
- package/dist/core/memory-engine/file-backend.d.ts +128 -55
- package/dist/core/memory-engine/file-backend.js +290 -117
- package/dist/core/memory-engine/index.d.ts +3 -2
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +59 -11
- package/dist/core/memory-engine/layout.js +190 -40
- package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
- package/dist/core/memory-engine/memory-backend-contract.js +39 -2
- 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 +51 -9
- package/dist/core/memory-engine/sync-client.js +107 -13
- 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 +8 -1
- package/dist/core/memory-engine/types.d.ts +6 -0
- 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/classic-events.d.ts +5 -1
- package/dist/core/mods/kernel/dispatch.d.ts +5 -1
- package/dist/core/mods/kernel/dispatch.js +6 -5
- package/dist/core/mods/kernel/events.d.ts +11 -4
- package/dist/core/mods/kernel/events.js +11 -7
- 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 +4 -0
- package/dist/core/mods/kernel/registration.js +3 -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 +73 -60
- package/dist/core/mods/stations.js +64 -40
- 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/parent-spec-seat.d.ts +8 -3
- package/dist/core/parent-spec-seat.js +2 -0
- package/dist/core/park-selfcheck.js +14 -8
- package/dist/core/peer-seat.d.ts +133 -16
- package/dist/core/peer-seat.js +319 -42
- package/dist/core/permission-rule-consent.d.ts +0 -21
- package/dist/core/permission-rule-consent.js +11 -6
- package/dist/core/permission-rule-model.d.ts +20 -2
- package/dist/core/permission-rule-model.js +8 -7
- package/dist/core/present-plan-tool.d.ts +11 -3
- package/dist/core/present-plan-tool.js +2 -2
- 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/resume-startup-cause.js +1 -0
- 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 +13 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +69 -3
- package/dist/core/roles.js +167 -80
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/announce-once-ledger.d.ts +5 -4
- package/dist/core/runner/announce-once-ledger.js +4 -2
- 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 +23 -12
- 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 +82 -57
- package/dist/core/runner/credential-origin-seat.js +4 -3
- 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/cwd-alignment-probe.d.ts +20 -0
- package/dist/core/runner/cwd-alignment-probe.js +21 -0
- package/dist/core/runner/decide-continuation.d.ts +2 -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 +87 -11
- package/dist/core/runner/gate-exit.js +30 -8
- 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-removed-seat.d.ts +12 -0
- package/dist/core/runner/image-removed-seat.js +19 -0
- 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 +5 -5
- package/dist/core/runner/park-commit.d.ts +1 -1
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/permission-rule-lanes.js +1 -1
- package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
- package/dist/core/runner/prepare-ask-lane.js +2 -1
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +5 -5
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
- package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +16 -9
- package/dist/core/runner/prepare-context-lane.js +2 -0
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
- package/dist/core/runner/prepare-delegation-surface.js +5 -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 +7 -1
- package/dist/core/runner/prepare-hands-readface.js +19 -6
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
- package/dist/core/runner/prepare-inherited-gate.js +22 -31
- 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 +12 -19
- package/dist/core/runner/prepare-park-ask.d.ts +4 -6
- package/dist/core/runner/prepare-park-ask.js +5 -9
- package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
- package/dist/core/runner/prepare-policy-chain.js +136 -121
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +10 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
- package/dist/core/runner/prepare-prompt-inputs.js +10 -20
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +17 -2
- package/dist/core/runner/prepare-run-refs.d.ts +2 -3
- package/dist/core/runner/prepare-run-refs.js +4 -1
- 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 +44 -28
- 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 +5 -4
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.js +3 -3
- package/dist/core/runner/reply-pricing.d.ts +30 -0
- package/dist/core/runner/reply-pricing.js +19 -0
- package/dist/core/runner/resume-admission.js +4 -2
- package/dist/core/runner/resume-apply.js +6 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-policy-outcome.js +5 -5
- package/dist/core/runner/retired-runner-deps.js +4 -1
- package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
- package/dist/core/runner/role-seat-defaulted.js +40 -0
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +3 -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.d.ts +2 -5
- package/dist/core/runner/run-identity-wiring.js +6 -5
- package/dist/core/runner/run-leg.d.ts +2 -0
- package/dist/core/runner/run-leg.js +63 -56
- 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 +14 -6
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
- package/dist/core/runner/run-terminal-adoption.js +9 -3
- package/dist/core/runner/run-turn-boundary.js +89 -77
- package/dist/core/runner/runtask.d.ts +8 -5
- package/dist/core/runner/runtask.js +21 -13
- package/dist/core/runner/side-call-account.d.ts +1 -1
- package/dist/core/runner/side-call-account.js +3 -18
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
- package/dist/core/runner/sub-agent-deny-lists.js +20 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/tool-disclosure.js +0 -2
- package/dist/core/runner/tool-end-body.js +2 -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-occurrence.d.ts +1 -1
- package/dist/core/runner/tool-occurrence.js +2 -2
- 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 +29 -27
- package/dist/core/runner/turn-attachments.js +27 -42
- package/dist/core/runner-deps.d.ts +32 -19
- package/dist/core/secret-env.d.ts +35 -4
- package/dist/core/secret-env.js +65 -3
- package/dist/core/sensitive-path-policy.js +3 -3
- package/dist/core/session-policy-store.d.ts +12 -3
- package/dist/core/session-policy-store.js +29 -10
- package/dist/core/session-store.d.ts +5 -7
- package/dist/core/session-store.js +50 -11
- package/dist/core/side-query.d.ts +11 -1
- package/dist/core/side-query.js +9 -0
- package/dist/core/skill-grant-binding.d.ts +31 -2
- package/dist/core/skill-grant-binding.js +31 -1
- package/dist/core/skill-grant.d.ts +17 -5
- package/dist/core/skill-grant.js +24 -6
- package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
- package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
- 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/synthetic-read-verdict.js +2 -1
- package/dist/core/task-event.d.ts +50 -10
- package/dist/core/task-notification.d.ts +88 -5
- package/dist/core/task-notification.js +146 -17
- package/dist/core/task-registry-agent.d.ts +18 -12
- package/dist/core/task-registry-agent.js +19 -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 +43 -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 +15 -7
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/terminal-cause.d.ts +10 -0
- package/dist/core/tool-catalog-entries.js +1 -1
- package/dist/core/tool-check-reading.d.ts +1 -0
- package/dist/core/tool-check-reading.js +3 -3
- 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 +21 -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-roster.d.ts +112 -5
- package/dist/core/tool-roster.js +42 -1
- package/dist/core/tool-spec.d.ts +23 -5
- package/dist/core/trace.d.ts +0 -1
- package/dist/core/types.d.ts +5 -5
- package/dist/core/types.js +2 -2
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +15 -7
- package/dist/core/wiring-manifest.d.ts +6 -3
- package/dist/engine/compaction/compaction.js +29 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
- package/dist/engine/execution-env/node-execution-env.js +21 -13
- package/dist/engine/harness/agent-harness.d.ts +26 -3
- package/dist/engine/harness/agent-harness.js +49 -16
- package/dist/engine/harness/messages.d.ts +3 -1
- package/dist/engine/harness/messages.js +3 -2
- package/dist/engine/harness/types.d.ts +119 -28
- package/dist/engine/llm/rejected-images.d.ts +46 -0
- package/dist/engine/llm/rejected-images.js +54 -0
- package/dist/engine/llm/tool-turns.d.ts +2 -1
- package/dist/engine/llm/types.d.ts +18 -7
- package/dist/engine/loop/agent-loop.d.ts +20 -12
- package/dist/engine/loop/agent-loop.js +205 -36
- package/dist/engine/loop/types.d.ts +12 -3
- 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/path-to-root.d.ts +38 -0
- package/dist/engine/session/path-to-root.js +39 -0
- package/dist/engine/session/storage-base.js +4 -21
- package/dist/index.d.ts +35 -21
- package/dist/index.js +26 -17
- package/dist/internal/harness-types.d.ts +1 -1
- package/dist/internal/harness.d.ts +1 -0
- package/dist/internal/llm.d.ts +1 -0
- 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-observe.d.ts +17 -1
- package/dist/orchestration/workflow-observe.js +20 -0
- package/dist/orchestration/workflow-types.d.ts +32 -7
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +762 -491
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/shell/counting-pass.d.ts +50 -0
- package/dist/shell/counting-pass.js +502 -0
- package/dist/shell/lex.d.ts +4 -2
- package/dist/shell/lex.js +93 -34
- package/dist/shell/shell-words.d.ts +1 -1
- package/dist/shell/shell-words.js +7 -6
- 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 +9 -11
- 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 +14 -4
- package/dist/tools/fs/fs-bash.js +29 -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 +13 -5
- package/dist/tools/fs/program-read-model.d.ts +13 -0
- package/dist/tools/fs/program-read-model.js +15 -0
- package/dist/tools/fs/program-read-model.rows.js +1 -1
- package/dist/tools/fs/read-deny.d.ts +13 -10
- package/dist/tools/fs/read-deny.js +25 -5
- package/dist/tools/fs/read-floor.d.ts +62 -0
- package/dist/tools/fs/read-floor.js +58 -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/fs/shell-read-check.d.ts +1 -1
- package/dist/tools/fs/shell-read-check.js +2 -1
- package/dist/tools/fs/shell-read-judge.d.ts +16 -8
- package/dist/tools/fs/shell-read-judge.js +10 -6
- package/dist/tools/fs/shell-read-plan.d.ts +6 -1
- package/dist/tools/fs/shell-read-plan.js +22 -15
- package/dist/tools/fs/shell-read-start.js +1 -0
- package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
- package/dist/tools/fs/shell-reentry-text.js +25 -3
- package/dist/tools/monitor.d.ts +9 -4
- package/dist/tools/monitor.js +17 -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 +5 -2
- package/test/export-surface.snapshot.json +161 -21
- package/wire-changes/core-stores-sql@7.59.0.json +29 -0
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core@7.59.0.json +2459 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/mods-kernel@7.59.0.json +29 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/primitives@7.59.0.json +29 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
|
@@ -23,6 +23,16 @@ export interface PlanFileSource {
|
|
|
23
23
|
readonly shown: string;
|
|
24
24
|
readonly read: (signal?: AbortSignal) => Promise<import("./runner/advertised-writable-dirs.js").PlanFileReading>;
|
|
25
25
|
}
|
|
26
|
+
/**
|
|
27
|
+
* What the engine's plan-pause request primitive takes: the requester's own `reason`, and `requestedByCallId` — the id of
|
|
28
|
+
* the call that asks, which the ENGINE binds from that call's own context (the first-party tool passes its ctx's
|
|
29
|
+
* `toolCallId`; a caller tool's `ctx.requestReview` is wrapped per call), never a tool-supplied argument. Parked on the
|
|
30
|
+
* `plan_review` row as provenance: which call presented the plan awaiting a decision.
|
|
31
|
+
*/
|
|
32
|
+
export interface ReviewRequest {
|
|
33
|
+
reason?: string;
|
|
34
|
+
requestedByCallId?: string;
|
|
35
|
+
}
|
|
26
36
|
/**
|
|
27
37
|
* design/80 D-B — the first-party `present_plan` tool (CC `ExitPlanMode` parity). A THIN composition over the
|
|
28
38
|
* general `ctx.requestReview()` primitive: the model calls it with a plan; the tool returns the plan as its
|
|
@@ -31,6 +41,4 @@ export interface PlanFileSource {
|
|
|
31
41
|
* NO side effect (`effect:"read"`); the actual pause/mint is the engine's, gated on a wired `checkpointStore`.
|
|
32
42
|
* `requestReview` is the prepare-task closure (the same primitive `ctx.requestReview` exposes to caller tools).
|
|
33
43
|
*/
|
|
34
|
-
export declare function createPresentPlanTool(requestReview: (opts?:
|
|
35
|
-
reason?: string;
|
|
36
|
-
}) => void, planFile?: PlanFileSource): ToolSpec;
|
|
44
|
+
export declare function createPresentPlanTool(requestReview: (opts?: ReviewRequest) => void, planFile?: PlanFileSource): ToolSpec;
|
|
@@ -114,9 +114,9 @@ export function createPresentPlanTool(requestReview, planFile) {
|
|
|
114
114
|
description: "Your full proposed plan, in markdown. The human reviewer approves / edits / rejects it before you act.",
|
|
115
115
|
}),
|
|
116
116
|
}),
|
|
117
|
-
execute: async (args) => {
|
|
117
|
+
execute: async (args, ctx) => {
|
|
118
118
|
const { plan } = args;
|
|
119
|
-
requestReview({ reason: "ExitPlanMode" });
|
|
119
|
+
requestReview({ reason: "ExitPlanMode", ...(typeof ctx?.toolCallId === "string" && ctx.toolCallId !== "" ? { requestedByCallId: ctx.toolCallId } : {}) });
|
|
120
120
|
return {
|
|
121
121
|
content: `Plan presented for human review:\n\n${delimitUntrusted("plan", plan)}\n\n` +
|
|
122
122
|
"(The run is pausing for approval — you will continue once the plan is approved, edited, or rejected.)",
|
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
* transport writes itself (an MCP request's session, protocol version, content type, accept and resume headers) is the
|
|
8
8
|
* protocol's: neither a seat's answer nor the principal header owns it. The hosted-connector assertion header
|
|
9
9
|
* ({@link MCP_ASSERTION_HEADER}) is the seat's to answer and never the principal header's name. A header the credential
|
|
10
|
-
* vocabulary reads as a credential is one the engine holds from the moment
|
|
11
|
-
* inherits a variable whose value equals it
|
|
10
|
+
* vocabulary reads as a credential is one the engine holds from the moment the seat answers it, before the answer is judged
|
|
11
|
+
* (the carrier's one intake, src/core/peer-seat.ts): no child spawned on this host inherits a variable whose value equals it.
|
|
12
12
|
*
|
|
13
13
|
* A principal header that breaks the rule is that peer's defect: the resolver throws inside the peer's own dial, so the
|
|
14
14
|
* peer is skipped with a coded warning and its siblings still mount; an answer that breaks it is the seat's, and that send
|
|
@@ -54,6 +54,8 @@ export declare function resolveProtocolHttpHeaders(protocol: ProtocolId, t: Prot
|
|
|
54
54
|
/** The engine's default request headers under the declared ones: a declared name, in any case, owns that header
|
|
55
55
|
* (the default of the same name is not sent beside it). */
|
|
56
56
|
export declare function underDeclaredHeaders(defaults: Readonly<Record<string, string>>, declared: Record<string, string> | undefined): Record<string, string>;
|
|
57
|
+
/** A header value as the transport sends it: the HTTP whitespace at its two edges is not part of the value (WHATWG `Headers`). */
|
|
58
|
+
export declare const httpTrimmed: (value: string) => string;
|
|
57
59
|
/**
|
|
58
60
|
* A peer's error text with what the peer was SENT taken out of it. Both kinds of removal are found on the ORIGINAL text (so no marker is
|
|
59
61
|
* rescanned and no replacement can disturb what another one reads) and the ranges they take are merged, one marker per merged range: every
|
|
@@ -69,6 +71,16 @@ export declare function underDeclaredHeaders(defaults: Readonly<Record<string, s
|
|
|
69
71
|
* whole marker with it, so the pass over its own output answers the same text.
|
|
70
72
|
*/
|
|
71
73
|
export declare function scrubRequestEcho(text: string, declared: readonly string[]): string;
|
|
74
|
+
/**
|
|
75
|
+
* A remote's own account of itself read without the credentials its connection's requests carried — THE one eraser of what a successful
|
|
76
|
+
* dial or listing hands the engine (an MCP server's `serverInfo`, instructions and tool listing; an A2A peer's card). The needle is
|
|
77
|
+
* `credentials` (the connection's credential values, `PeerCarrier.credentials`): every occurrence of one, in any spelling the
|
|
78
|
+
* request-echo derivation gives it ({@link requestEchoSpellings}) and in any letter case, becomes the redaction mark in place, the way
|
|
79
|
+
* {@link scrubRequestEcho} takes a declared value out of a failure's words. Nothing else is taken — no Cookie member, no vocabulary
|
|
80
|
+
* guess: the rest of the text is the remote's own account, and only the needle is the engine's to withhold. A text with no needle in it
|
|
81
|
+
* is returned as it was (the same string). The function is a fixed point.
|
|
82
|
+
*/
|
|
83
|
+
export declare function eraseSentCredentials(text: string, credentials: readonly string[]): string;
|
|
72
84
|
/**
|
|
73
85
|
* THE one form a remote endpoint's words take when the engine carries them in its own words — an MCP server's failure, a model
|
|
74
86
|
* provider's error body, frame or transport failure, a memory distiller seat's failure: what the request was declared with
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { authSchemeCredentials
|
|
1
|
+
import { authSchemeCredentials } from "./secret-env.js";
|
|
2
2
|
import { egressText } from "./untrusted-egress.js";
|
|
3
3
|
import { REDACTION_MARK, redactionMarkerSpans } from "./redaction-marks.js";
|
|
4
4
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
@@ -30,7 +30,6 @@ export function resolveProtocolHttpHeaders(protocol, t, principal) {
|
|
|
30
30
|
const principalHeader = t.principalHeader;
|
|
31
31
|
const answered = t.headers;
|
|
32
32
|
const own = { ...(answered !== undefined ? { headers: { ...answered } } : {}), ...(principalHeader !== undefined ? { principalHeader } : {}) };
|
|
33
|
-
holdOwnCredentialValues(credentialHeaderValues(own.headers));
|
|
34
33
|
const collision = headerOwnershipCollision(own, protocol);
|
|
35
34
|
if (collision !== undefined) {
|
|
36
35
|
const problem = collision.engineOwned
|
|
@@ -49,7 +48,7 @@ export function underDeclaredHeaders(defaults, declared) {
|
|
|
49
48
|
const owned = new Set(Object.keys(declared ?? {}).map((k) => k.toLowerCase()));
|
|
50
49
|
return { ...Object.fromEntries(Object.entries(defaults).filter(([k]) => !owned.has(k.toLowerCase()))), ...declared };
|
|
51
50
|
}
|
|
52
|
-
const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
|
|
51
|
+
export const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
|
|
53
52
|
function percentEncoded(value) {
|
|
54
53
|
try {
|
|
55
54
|
return encodeURIComponent(value);
|
|
@@ -105,7 +104,14 @@ function structuredEnd(text, at) {
|
|
|
105
104
|
return text.length;
|
|
106
105
|
}
|
|
107
106
|
export function scrubRequestEcho(text, declared) {
|
|
108
|
-
|
|
107
|
+
return markedOver(text, requestEchoRanges(text, declared));
|
|
108
|
+
}
|
|
109
|
+
export function eraseSentCredentials(text, credentials) {
|
|
110
|
+
if (credentials.length === 0 || text === "")
|
|
111
|
+
return text;
|
|
112
|
+
return markedOver(text, needleRanges(text, credentials, []));
|
|
113
|
+
}
|
|
114
|
+
function markedOver(text, removed) {
|
|
109
115
|
if (removed.length === 0)
|
|
110
116
|
return text;
|
|
111
117
|
removed.sort((a, b) => a[0] - b[0] || b[1] - a[1]);
|
|
@@ -122,13 +128,16 @@ export function scrubRequestEcho(text, declared) {
|
|
|
122
128
|
return out + text.slice(kept);
|
|
123
129
|
}
|
|
124
130
|
function requestEchoRanges(text, declared) {
|
|
131
|
+
const members = cookieMembers(text);
|
|
132
|
+
return [...members.map(([, from, end]) => [from, end]), ...needleRanges(text, declared, members)];
|
|
133
|
+
}
|
|
134
|
+
function needleRanges(text, values, members) {
|
|
125
135
|
const forms = new Set();
|
|
126
|
-
for (const value of
|
|
136
|
+
for (const value of values)
|
|
127
137
|
for (const spelling of requestEchoSpellings(value))
|
|
128
138
|
forms.add(spelling);
|
|
129
139
|
forms.delete("");
|
|
130
|
-
const
|
|
131
|
-
const removed = members.map(([, from, end]) => [from, end]);
|
|
140
|
+
const removed = [];
|
|
132
141
|
const markers = redactionMarkerSpans(text);
|
|
133
142
|
for (const hit of valueHits(text, [...forms])) {
|
|
134
143
|
if (members.some(([name, from]) => hit[0] >= name && hit[1] <= from))
|
|
@@ -12,8 +12,8 @@ import { type ReadDenyEntry } from "../tools/fs/index.js";
|
|
|
12
12
|
* into meaningless one-character entries with zero refusal. Garbage must refuse loudly at the door,
|
|
13
13
|
* never be consumed letter by letter. */
|
|
14
14
|
export declare function assertStringArraySeat(value: unknown, seat: string, entryLaw: "strings" | "compiler-owned"): void;
|
|
15
|
-
/** The
|
|
16
|
-
export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"];
|
|
15
|
+
/** The four DEPLOYMENT read-deny seats: the table's three, and whether the deployment requires the byte floor kept. */
|
|
16
|
+
export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"];
|
|
17
17
|
export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number];
|
|
18
18
|
/**
|
|
19
19
|
* The copy a read-deny seat keeps of its declared value — the one copy law of both doors that admit one (`new Runner`
|
|
@@ -24,7 +24,9 @@ export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number]
|
|
|
24
24
|
export declare function copyReadDenySeat(value: unknown): unknown;
|
|
25
25
|
/**
|
|
26
26
|
* Screen one deployment read-deny seat's value with the laws a prepare applies to it (the array door and the
|
|
27
|
-
* one compiler's entry law for the additions; the built-in table's tier / row-name law for the
|
|
28
|
-
* return a copy; `undefined` stays `undefined` (no declaration
|
|
27
|
+
* one compiler's entry law for the additions; the built-in table's tier / row-name law for the next two; a boolean
|
|
28
|
+
* for the floor requirement) and return a copy; `undefined` stays `undefined` (no declaration — for the requirement,
|
|
29
|
+
* the documented reading "not required", under which an unkept floor is still announced).
|
|
29
30
|
*/
|
|
30
|
-
export declare function screenReadDenySeat(seat:
|
|
31
|
+
export declare function screenReadDenySeat(seat: "readDenyFloorRequired", value: unknown): boolean | undefined;
|
|
32
|
+
export declare function screenReadDenySeat(seat: ReadDenyDeploymentSeat, value: unknown): readonly ReadDenyEntry[] | readonly string[] | boolean | undefined;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { compileReadDeny, readDenyBuiltinConfigOf } from "../tools/fs/index.js";
|
|
2
|
+
import { screenReadDenyFloorRequired } from "../tools/fs/read-floor.js";
|
|
2
3
|
export function assertStringArraySeat(value, seat, entryLaw) {
|
|
3
4
|
if (value === undefined)
|
|
4
5
|
return;
|
|
@@ -18,7 +19,7 @@ export function assertStringArraySeat(value, seat, entryLaw) {
|
|
|
18
19
|
}
|
|
19
20
|
}
|
|
20
21
|
}
|
|
21
|
-
export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"]);
|
|
22
|
+
export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"]);
|
|
22
23
|
export function copyReadDenySeat(value) {
|
|
23
24
|
if (!Array.isArray(value))
|
|
24
25
|
return value;
|
|
@@ -27,6 +28,8 @@ export function copyReadDenySeat(value) {
|
|
|
27
28
|
export function screenReadDenySeat(seat, value) {
|
|
28
29
|
if (value === undefined)
|
|
29
30
|
return undefined;
|
|
31
|
+
if (seat === "readDenyFloorRequired")
|
|
32
|
+
return screenReadDenyFloorRequired(value, `RunnerDeps.${seat}`);
|
|
30
33
|
if (seat === "readDenyPatterns") {
|
|
31
34
|
assertStringArraySeat(value, `RunnerDeps.${seat}`, "compiler-owned");
|
|
32
35
|
const entries = copyReadDenySeat(value);
|
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
/** The marks, by what they stand for. `whole` is the bare mark (a span removed whole — a credential value, a floor, a
|
|
2
2
|
* depth cut); the others name the shape that was withheld: `credentials` a URL's userinfo, `url` a whole URL, `path` an
|
|
3
|
-
* absolute filesystem path. A mark the engine writes is exactly one of these four.
|
|
4
|
-
|
|
3
|
+
* absolute filesystem path. A mark the engine writes is exactly one of these four. Frozen: the table is exported to hosts, and every
|
|
4
|
+
* pass reads it at call time, so a write by a reader would change what the engine writes. */
|
|
5
|
+
export declare const REDACTION_MARKS: Readonly<{
|
|
5
6
|
readonly whole: "[redacted]";
|
|
6
7
|
readonly credentials: "[redacted-credentials]";
|
|
7
8
|
readonly url: "[redacted-url]";
|
|
8
9
|
readonly path: "[redacted-path]";
|
|
9
|
-
}
|
|
10
|
+
}>;
|
|
10
11
|
/** The bare mark — what a host compares against to tell that the engine withheld a value. */
|
|
11
12
|
export declare const REDACTION_MARK: "[redacted]";
|
|
12
13
|
/** Where the marks sit in `s`, one [start, end) span at a time, leftmost first. Lazy: a reader that stops early (a display cut stops
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
export const REDACTION_MARKS = {
|
|
1
|
+
export const REDACTION_MARKS = Object.freeze({
|
|
2
2
|
whole: "[redacted]",
|
|
3
3
|
credentials: "[redacted-credentials]",
|
|
4
4
|
url: "[redacted-url]",
|
|
5
5
|
path: "[redacted-path]",
|
|
6
|
-
};
|
|
6
|
+
});
|
|
7
7
|
export const REDACTION_MARK = REDACTION_MARKS.whole;
|
|
8
8
|
const escapeLiteral = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
9
9
|
const REDACTION_MARKER_RE = new RegExp(Object.values(REDACTION_MARKS).map(escapeLiteral).join("|"), "g");
|
|
@@ -9,9 +9,12 @@
|
|
|
9
9
|
* exactly like `CheckpointStore` (design/45). Core owns the seam shape; service owns the backend.
|
|
10
10
|
*
|
|
11
11
|
* Design rulings folded in (design/48 §10/§11 DeepSeek council):
|
|
12
|
-
* - **#1 [blocker] interface extension, not capability probing**: `RemoteExecutionEnv extends ExecutionEnv
|
|
13
|
-
*
|
|
14
|
-
*
|
|
12
|
+
* - **#1 [blocker] interface extension, not capability probing**: `RemoteExecutionEnv extends ExecutionEnv` with
|
|
13
|
+
* the lifecycle and streaming METHODS a remote workspace has; a consumer that only needs buffered fs/shell keeps
|
|
14
|
+
* accepting the base type. What an environment can DO is not part of this extension: it is the base type's own
|
|
15
|
+
* required block ({@link ExecutionEnvCapabilities}, #2891), declared by every environment, local or remote, and
|
|
16
|
+
* read through the readers at the end of this file. The interface answers only whether the remote methods can be
|
|
17
|
+
* called ({@link isRemoteExecutionEnv}); it never answers a capability.
|
|
15
18
|
* - **#3 [major] do not overload `exec`**: `exec()` stays buffered; streaming is a NEW {@link execStream}.
|
|
16
19
|
* - **#4 [major] suspend × in-flight exec must not hang**: see {@link suspendVM}.
|
|
17
20
|
* - **#8 [major] post-resume consistency**: see {@link postResumeInit}.
|
|
@@ -25,7 +28,7 @@
|
|
|
25
28
|
* mapping; tier *classification* (the static table + Tier1-safe allow-list + fail-closed routing) — all are
|
|
26
29
|
* service/design-45 implementation-time concerns. Core only declares the seam those will plug into.
|
|
27
30
|
*/
|
|
28
|
-
import type { ExecutionEnv } from "../internal/harness-types.js";
|
|
31
|
+
import type { ExecutionEnv, ExecutionEnvCapabilities } from "../internal/harness-types.js";
|
|
29
32
|
/** Snapshot identifier returned by {@link RemoteExecutionEnv.suspendVM}; opaque to core, resolved by the provider. */
|
|
30
33
|
export type SnapshotId = string;
|
|
31
34
|
/**
|
|
@@ -226,7 +229,7 @@ export type RemoteExecutionErrorCode =
|
|
|
226
229
|
| "liveness_no_output"
|
|
227
230
|
/**
|
|
228
231
|
* The op is not supported by this adapter's capabilities (design/61 §9 A) — e.g. `suspendVM`/`resumeVM` on a
|
|
229
|
-
* non-suspendable SSH/ADB env. Permanent for this env; check {@link
|
|
232
|
+
* non-suspendable SSH/ADB env. Permanent for this env; check its declaration ({@link declaredSuspend}) first.
|
|
230
233
|
*/
|
|
231
234
|
| "unsupported"
|
|
232
235
|
/**
|
|
@@ -318,67 +321,6 @@ export declare class RemoteExecutionError extends Error {
|
|
|
318
321
|
* idempotency; the adapter MUST NOT blind-retry.
|
|
319
322
|
*/
|
|
320
323
|
export interface RemoteExecutionEnv extends ExecutionEnv {
|
|
321
|
-
/**
|
|
322
|
-
* What this adapter can actually do (design/61 §9 A, council). The seam was built for E2B (a full
|
|
323
|
-
* `{isolation:true, suspendable:true}` adapter); **partial-capability** adapters (SSH/ADB: `{false, false}`
|
|
324
|
-
* — a real machine/device, not snapshotable and not isolated) declare it here. **Required + explicit** so
|
|
325
|
-
* the orchestrator never has to guess: there is no safe default (assuming isolation when there is none is a
|
|
326
|
-
* security hole; assuming suspendable crashes on `suspendVM`). Use {@link isSuspendable}/{@link isIsolated}/{@link processTableOf}
|
|
327
|
-
* rather than the structural {@link isRemoteExecutionEnv} (method presence ≠ semantics — a stub `suspendVM`
|
|
328
|
-
* that returns `"unsupported"` still satisfies the structural check). Extensible: add fields as new
|
|
329
|
-
* partial-capability classes appear.
|
|
330
|
-
*/
|
|
331
|
-
readonly capabilities: {
|
|
332
|
-
/** True iff actions are contained (E2B microVM); false for a real target (SSH host / ADB device). The
|
|
333
|
-
* orchestrator tightens autonomy + the design/37 policy gate when this is false (design/53 zero-trust). */
|
|
334
|
-
isolation: boolean;
|
|
335
|
-
/** True iff the env can be snapshot/`suspendVM`'d (E2B); false for SSH/ADB (durable suspend N/A).
|
|
336
|
-
*
|
|
337
|
-
* ⚠️ LOAD-BEARING INVARIANT (opus review 1.257.2): `suspendable:false` on a remote env also asserts
|
|
338
|
-
* the workspace is EXTERNALLY DURABLE — it persists on the target across the env object's lifetime
|
|
339
|
-
* (true for SSH hosts / ADB devices). The durable-park-only suspend degrade rests
|
|
340
|
-
* on this: it skips `suspendVM` and trusts the factory to reconnect to the SAME workspace on resume.
|
|
341
|
-
* An adapter for a non-suspendable EPHEMERAL backend (e.g. a snapshot-less container torn down with
|
|
342
|
-
* the transport) must NOT be modeled as `suspendable:false` remote — it would silently take the
|
|
343
|
-
* park-only branch and resume onto a fresh empty workspace. Model such a backend as a per-task env
|
|
344
|
-
* without durable suspend instead (the human gate refuses it), or extend capabilities with an
|
|
345
|
-
* explicit workspace-durability flag before building one. */
|
|
346
|
-
suspendable: boolean;
|
|
347
|
-
/** True iff this adapter's {@link FileSystem.canonicalPath} is the AUTHORITY on where a path lands —
|
|
348
|
-
* it answers for the very filesystem the commands run on, and a failure to answer is a failure of
|
|
349
|
-
* the resolver rather than a namespace it cannot see into. Optional, and absent is not a
|
|
350
|
-
* declaration: an adapter that says nothing keeps the lexical verdict for a chain its resolver answers
|
|
351
|
-
* `not_supported` (no file face); a resolver that FAILS (any other non-answer) is a failure either way —
|
|
352
|
-
* the read station records it and the command is unanswered. Declaring it says that even an
|
|
353
|
-
* unanswerable chain is a question, not an absence — and the read
|
|
354
|
-
* boundary's execute-time recheck then refuses rather than passing the written spelling through.
|
|
355
|
-
* Read STRICTLY through {@link canonicalPathIsAuthoritative}, like every other capability whose
|
|
356
|
-
* `true` changes what a containment leg does; a wrong-SHAPE value reads absent and is announced. */
|
|
357
|
-
canonicalPathAuthoritative?: boolean;
|
|
358
|
-
/** True iff the commands this env runs are processes on a table that holds THIS process — the table the
|
|
359
|
-
* engine itself and the processes above it are on, so a kill the model writes there can reach them.
|
|
360
|
-
* `true` for an adapter that spawns the commands as this process's own descendants (a host lane), and
|
|
361
|
-
* for one whose commands run in a PID namespace that contains this process's (the host of the container
|
|
362
|
-
* the engine runs in); `false` only for one whose commands run where this process is not: another
|
|
363
|
-
* machine (SSH host, device, cloud sandbox) or a PID namespace this process is not in (a sandbox
|
|
364
|
-
* container, a pod). Not {@link isolation}: a non-isolated SSH host is a real machine and still another
|
|
365
|
-
* table. The self-preservation guard of the Bash tool asks its question exactly when this is `true`
|
|
366
|
-
* (and for every env that is not remote at all), and does not ask where it is `false`.
|
|
367
|
-
*
|
|
368
|
-
* What a `true` buys is the guard's question exactly as a NodeExecutionEnv gets it, limits included: on this
|
|
369
|
-
* process's own table, of the platform's `pgrep`, with the kill's words as written, from this process's own
|
|
370
|
-
* working directory. It is put as for this process's descendants, so for commands on the same table that
|
|
371
|
-
* are not (SSH to `localhost`) BSD's `pgrep` leaves its OWN caller's ancestors out where the real kill would
|
|
372
|
-
* not, and from an enclosing namespace the question sees only this process's namespace, not the ancestors
|
|
373
|
-
* above it.
|
|
374
|
-
*
|
|
375
|
-
* REQUIRED, with no default: either reading of an absent value is wrong somewhere (assuming `true`
|
|
376
|
-
* refuses an ordinary `pkill` in a sandbox because a word matched this engine here; assuming `false`
|
|
377
|
-
* lets a host lane's `pkill` end the session that issued it). So an absent or non-boolean value is
|
|
378
|
-
* announced once per run at the env's admission point and the guard refuses every pattern kill that needs the question on
|
|
379
|
-
* that env (`pkill -P $$` runs), naming this declaration, until the adapter states it. Read through {@link processTableOf}. */
|
|
380
|
-
sharesProcessTable: boolean;
|
|
381
|
-
};
|
|
382
324
|
/** Identity of the connected workspace (design/48 §5 gap 1). Synchronous: it is data the env already holds. */
|
|
383
325
|
workspaceHandle(): WorkspaceHandle;
|
|
384
326
|
/** Provision/attach the remote workspace and inject secrets. Returns the resulting {@link WorkspaceHandle}. */
|
|
@@ -571,7 +513,10 @@ export interface ExecutionEnvFactoryContext {
|
|
|
571
513
|
export type ExecutionEnvFactory = (ctx: ExecutionEnvFactoryContext) => ExecutionEnv | Promise<ExecutionEnv>;
|
|
572
514
|
/** True when `env` exposes a lifecycle {@link RemoteExecutionEnv.destroy} the Runner should call on task end. */
|
|
573
515
|
export declare function hasDestroy(env: ExecutionEnv): env is ExecutionEnv & Pick<RemoteExecutionEnv, "destroy">;
|
|
574
|
-
/** Structural check that `env` implements the remote seam (lifecycle + streaming surface
|
|
516
|
+
/** Structural check that `env` implements the remote seam (lifecycle + streaming surface), answering only whether
|
|
517
|
+
* those methods can be called — never a capability. The block conjunct keeps an adapter that carries no capability
|
|
518
|
+
* block at all (a JS adapter the compiler never saw) off the remote paths, as before the block moved to the base; it
|
|
519
|
+
* is read off the block's one receipt ({@link capabilityReceiptOf}), never off the adapter again. */
|
|
575
520
|
export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteExecutionEnv;
|
|
576
521
|
/**
|
|
577
522
|
* The RESTORE half of the suspend contract — the methods the RESUME leg calls after a `suspendVM`
|
|
@@ -585,17 +530,94 @@ export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteEx
|
|
|
585
530
|
* the resume leg — a different process, hours later — with a bare `env.resumeVM is not a function`.
|
|
586
531
|
*/
|
|
587
532
|
export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("resumeVM" | "postResumeInit")[];
|
|
533
|
+
/**
|
|
534
|
+
* The capability readers (#2891). Every key of {@link ExecutionEnvCapabilities} is read through exactly one of the
|
|
535
|
+
* functions below, on every environment — a local one declares the block as a remote one does, so no reader asks the
|
|
536
|
+
* remote INTERFACE first and none gives a non-remote environment a fixed answer.
|
|
537
|
+
*
|
|
538
|
+
* Each reader takes only the boolean the adapter declared, off the block's one receipt ({@link capabilityReceiptOf}):
|
|
539
|
+
* the adapter's block is read once and every reader reads that frozen copy. A value that is absent, not a boolean, or
|
|
540
|
+
* cannot be received (a throwing getter, a Proxy) is no declaration, and the reader answers that key's SAFE side, one
|
|
541
|
+
* row per key in {@link UNDECLARED_CAPABILITY_READING}. The readers never throw and never announce: the admission
|
|
542
|
+
* census does, once per run per finding (`config.execution_env_capability_invalid`).
|
|
543
|
+
*/
|
|
544
|
+
export declare const UNDECLARED_CAPABILITY_READING: {
|
|
545
|
+
readonly isolation: {
|
|
546
|
+
readonly reads: false;
|
|
547
|
+
readonly so: "no reader treats the environment as a sandbox: autonomy, the policy tiers and the read boundary's containment legs stay on their checking side";
|
|
548
|
+
};
|
|
549
|
+
readonly suspendable: {
|
|
550
|
+
readonly reads: "undeclared";
|
|
551
|
+
readonly so: "the snapshot reader takes only a declared `true` and the park-only lane only a declared `false`, so the environment is neither snapshot nor parked, and a run on it cannot suspend durably";
|
|
552
|
+
};
|
|
553
|
+
readonly sharesProcessTable: {
|
|
554
|
+
readonly reads: "undeclared";
|
|
555
|
+
readonly so: "whether the commands it runs are processes on this engine's own process table has no default, so the Bash tool refuses every pattern kill that needs the question (`pkill`, `killall`, a `kill` fed by `pgrep`; `pkill -P $$`, the shell's own children, runs) on this environment — declare `true` when its commands run on a table that holds the engine (a host lane, or a PID namespace that contains the engine's), `false` only when they run where the engine is not (another machine, a PID namespace that does not contain it)";
|
|
556
|
+
};
|
|
557
|
+
readonly canonicalPathAuthoritative: {
|
|
558
|
+
readonly reads: true;
|
|
559
|
+
readonly so: "its resolver's silence is read as a failure, so a command chain it cannot answer at all is refused at the read boundary's execute-time recheck instead of passing on its written spelling";
|
|
560
|
+
};
|
|
561
|
+
readonly hostLocalPaths: {
|
|
562
|
+
readonly reads: "undeclared";
|
|
563
|
+
readonly so: "the engine does not treat a path this environment names as the host's own file, and a worktree child on it is refused (its tree can be neither compared nor exempted)";
|
|
564
|
+
};
|
|
565
|
+
readonly externalContentTarget: {
|
|
566
|
+
readonly reads: "undeclared";
|
|
567
|
+
readonly so: "what it produces is treated as content from outside the deployment's trust boundary (the memory session mark), and a call that reaches it owes what reaching the target and what leaving it both owe (the cross-boundary taint)";
|
|
568
|
+
};
|
|
569
|
+
readonly io: {
|
|
570
|
+
readonly reads: "undeclared";
|
|
571
|
+
readonly so: "no shell face mounts on it, and what it names is still read through it (the project marker), never past its own read limits";
|
|
572
|
+
};
|
|
573
|
+
readonly keepsReadFloor: {
|
|
574
|
+
readonly reads: false;
|
|
575
|
+
readonly so: "it is read as not keeping the byte floor, so a run whose read-deny table is non-empty is announced as such (`config.read_deny_floor_unkept`), or refused at prepare when the deployment sets `readDenyFloorRequired`";
|
|
576
|
+
};
|
|
577
|
+
};
|
|
578
|
+
/** The keys of {@link ExecutionEnvCapabilities}, in declaration order — the census walks exactly these. */
|
|
579
|
+
export declare const CAPABILITY_KEYS: ReadonlyArray<keyof ExecutionEnvCapabilities>;
|
|
580
|
+
/** One finding of a block's receipt: a key of the block not declared as a boolean (`expected: "boolean"`), the block itself
|
|
581
|
+
* when it is not an object or cannot be received (`key: "capabilities"`, `expected: "object"`), or a member the block carries
|
|
582
|
+
* that is no capability (`expected: "absent"`: a misspelled or retired key, whose value no reader takes). */
|
|
583
|
+
export interface CapabilityBlockFinding {
|
|
584
|
+
readonly key: string;
|
|
585
|
+
/** The type the member carries (`"undefined"` where it is absent), or `"unreadable"` where it could not be received. */
|
|
586
|
+
readonly valueType: string;
|
|
587
|
+
readonly expected: "boolean" | "object" | "absent";
|
|
588
|
+
}
|
|
589
|
+
/** What the engine holds of an environment's capability block: the booleans it declares (the eight keys only, frozen), whether the block is
|
|
590
|
+
* an object at all (the remote predicate's block conjunct), and the receipt's findings, in key order and then member order. */
|
|
591
|
+
export interface CapabilityReceipt {
|
|
592
|
+
readonly declared: Readonly<Partial<Record<keyof ExecutionEnvCapabilities, boolean>>>;
|
|
593
|
+
readonly blockIsObject: boolean;
|
|
594
|
+
readonly findings: readonly CapabilityBlockFinding[];
|
|
595
|
+
}
|
|
596
|
+
/**
|
|
597
|
+
* The ONE receipt of an environment's capability block: read off the adapter once per environment object — at its first read,
|
|
598
|
+
* which for a run's environment is the run's admission census — and held frozen; every reader, the census and the remote
|
|
599
|
+
* predicate read this receipt and never the adapter again, so what the census announced is what every reader acts on, and a
|
|
600
|
+
* block the host changes afterwards changes nothing the engine reads. A value that is not an object (a JS caller's `null`) has
|
|
601
|
+
* no block and is not remembered. Total: it never throws.
|
|
602
|
+
*/
|
|
603
|
+
export declare function capabilityReceiptOf(env: Pick<ExecutionEnv, "capabilities">): CapabilityReceipt;
|
|
604
|
+
/**
|
|
605
|
+
* What this environment declares about snapshots, in three states: `true` (it can be snapshot and restored), `false`
|
|
606
|
+
* (it cannot — and, on a remote environment, its workspace is externally durable, the park-only degrade's premise), or
|
|
607
|
+
* `"undeclared"` (absent, not a boolean, unreadable). The snapshot reader ({@link isSuspendable}) takes only `true`, the
|
|
608
|
+
* suspend paths' park-only lane only `false`; an undeclared environment is in neither, so a run on it cannot suspend
|
|
609
|
+
* durably.
|
|
610
|
+
*/
|
|
611
|
+
export declare function declaredSuspend(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
588
612
|
/**
|
|
589
613
|
* Can this env be durably suspended/snapshotted (design/61 §9 A)? Use this — NOT the structural
|
|
590
614
|
* {@link isRemoteExecutionEnv} — before calling `suspendVM` (a non-suspendable SSH/ADB env declares
|
|
591
|
-
* `capabilities.suspendable: false` but still has the method, which returns `"unsupported"`).
|
|
592
|
-
*
|
|
615
|
+
* `capabilities.suspendable: false` but still has the method, which returns `"unsupported"`). An environment
|
|
616
|
+
* without the remote interface has no `suspendVM` to call, whatever it declares.
|
|
593
617
|
*
|
|
594
|
-
* A composite type guard (
|
|
595
|
-
* gets the {@link RemoteExecutionEnv} type without a cast — `true` always implies the structural check too.
|
|
596
|
-
* The
|
|
597
|
-
* the census announces it. This took anything truthy, so `suspendable: "false"` was snapshotted — the one
|
|
598
|
-
* key of the three whose malformed reading fell on the unsafe side.
|
|
618
|
+
* A composite type guard (declaration AND interface AND restore surface) so a `suspendVM` call site narrowed by THIS
|
|
619
|
+
* predicate gets the {@link RemoteExecutionEnv} type without a cast — `true` always implies the structural check too.
|
|
620
|
+
* The declaration is read through {@link declaredSuspend}: only the boolean `true` counts.
|
|
599
621
|
*
|
|
600
622
|
* It also requires the RESTORE surface ({@link missingRestoreSurface}). A suspend is only durable
|
|
601
623
|
* if something can undo it; an adapter that offers `suspendVM` but no `resumeVM` used to pass this guard,
|
|
@@ -605,25 +627,23 @@ export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("res
|
|
|
605
627
|
*
|
|
606
628
|
* ⚠️ A capability-DECLARING but restore-incomplete adapter must NOT be re-routed to the durable-park-only
|
|
607
629
|
* degrade by this predicate returning false — park-only rests on the workspace being externally durable
|
|
608
|
-
* (see
|
|
609
|
-
* sites split the two cases on the DECLARED `capabilities.suspendable` flag, not on this predicate alone.
|
|
630
|
+
* (see `ExecutionEnvCapabilities.suspendable`), which a snapshot backend does not have. Call
|
|
631
|
+
* sites split the two cases on the DECLARED `capabilities.suspendable` flag ({@link declaredSuspend}), not on this predicate alone.
|
|
610
632
|
*/
|
|
611
633
|
export declare function isSuspendable(env: ExecutionEnv): env is RemoteExecutionEnv;
|
|
612
634
|
/**
|
|
613
635
|
* Is this env an isolated sandbox (design/61 §9 A, design/53)? `false` for a real SSH host / ADB device AND
|
|
614
|
-
* for
|
|
615
|
-
* design/37 policy gate when this is `false` (zero-trust on an
|
|
616
|
-
*
|
|
636
|
+
* for an in-process env (the host process is not isolated: `NodeExecutionEnv` and `StubExecutionEnv` declare
|
|
637
|
+
* `false`). The orchestrator tightens autonomy + the design/37 policy gate when this is `false` (zero-trust on an
|
|
638
|
+
* un-isolated target). Isolation must be explicitly declared, never assumed, and that is why the flag is read
|
|
617
639
|
* STRICTLY: every consumer of a `true` here RELAXES something (autonomy, a policy tier, a containment
|
|
618
640
|
* leg that the sandbox is then answerable for), so a value that is not the boolean `true` — absent,
|
|
619
641
|
* a string, a truthy object from a JS adapter the compiler never saw — is not a declaration and lands
|
|
620
|
-
* on the checking side. This is the reading every consumer of the containment question comes through
|
|
621
|
-
* and the only one that also NARROWS; a caller already holding a `RemoteExecutionEnv` may spell the
|
|
622
|
-
* same strict `!== true` test itself (the worktree-isolation refusal in the runner's prepare does).
|
|
642
|
+
* on the checking side. This is the reading every consumer of the containment question comes through.
|
|
623
643
|
* What no caller may do is infer isolation from the remote INTERFACE — implementing the seam is not
|
|
624
644
|
* declaring containment, and a host-lane adapter drives the operator's own machine through it.
|
|
625
645
|
*/
|
|
626
|
-
export declare function isIsolated(env: ExecutionEnv): boolean;
|
|
646
|
+
export declare function isIsolated(env: Pick<ExecutionEnv, "capabilities">): boolean;
|
|
627
647
|
/**
|
|
628
648
|
* Is CONTAINMENT this env's own job rather than the engine's — i.e. may a containment leg stop at the
|
|
629
649
|
* written spelling and leave the rest to the target? True exactly for a DECLARED isolated sandbox: the
|
|
@@ -649,24 +669,52 @@ export declare function boundaryIsTheSandbox(env: ExecutionEnv): boolean;
|
|
|
649
669
|
* a question and the second is an absence, and reading both as the absence is what leaves a containment
|
|
650
670
|
* leg silently open on an RPC-backed lane.
|
|
651
671
|
*
|
|
652
|
-
* So the adapter says which it is
|
|
653
|
-
* `true`
|
|
654
|
-
*
|
|
655
|
-
*
|
|
656
|
-
* reading, which is why the local lane is unchanged: its resolver answers `/`, so the arm this gates
|
|
657
|
-
* has no case to fire on.
|
|
672
|
+
* So the adapter says which it is. Only a declared boolean is a declaration, and the undeclared reading is the
|
|
673
|
+
* refusing one (`true`): an environment that does not say whether its silence is a failure has its silence read as
|
|
674
|
+
* one, and is announced at its admission point — this reader does not validate. `NodeExecutionEnv` declares `true`,
|
|
675
|
+
* which moves nothing on the local lane: its resolver answers `/`, so the arm this gates has no case to fire on.
|
|
658
676
|
*/
|
|
659
|
-
export declare function canonicalPathIsAuthoritative(env: ExecutionEnv): boolean;
|
|
677
|
+
export declare function canonicalPathIsAuthoritative(env: Pick<ExecutionEnv, "capabilities">): boolean;
|
|
660
678
|
/**
|
|
661
679
|
* Which process table this env's commands run on, as its adapter declares it
|
|
662
|
-
* ({@link
|
|
663
|
-
* · `"this"` — a table that holds this process:
|
|
664
|
-
*
|
|
665
|
-
*
|
|
666
|
-
*
|
|
667
|
-
* · `"other"` — a remote env that declares `false`;
|
|
668
|
-
* · `"undeclared"` — a remote env whose declaration is absent, not a boolean, or cannot be read (a throwing
|
|
680
|
+
* ({@link ExecutionEnvCapabilities.sharesProcessTable}):
|
|
681
|
+
* · `"this"` — a table that holds this process: an env that declares `true` (`NodeExecutionEnv`, whose commands are
|
|
682
|
+
* this process's children; a host lane);
|
|
683
|
+
* · `"other"` — an env that declares `false`;
|
|
684
|
+
* · `"undeclared"` — an env whose declaration is absent, not a boolean, or cannot be read (a throwing
|
|
669
685
|
* getter or Proxy trap). There is no default to fold it to, so the caller refuses what it cannot answer.
|
|
670
686
|
* Total: it never throws. It does not announce — the admission census does, once per run.
|
|
671
687
|
*/
|
|
672
|
-
export declare function processTableOf(env: ExecutionEnv): "this" | "other" | "undeclared";
|
|
688
|
+
export declare function processTableOf(env: Pick<ExecutionEnv, "capabilities">): "this" | "other" | "undeclared";
|
|
689
|
+
/**
|
|
690
|
+
* Where the paths this environment names land ({@link ExecutionEnvCapabilities.hostLocalPaths}), in three states: `true`
|
|
691
|
+
* (the host's own files), `false` (somewhere the host does not mount at the same paths), `"undeclared"` — which each
|
|
692
|
+
* consumer reads on ITS safe side: {@link pathsAreHostLocal} takes only `true`; the worktree child's exemption takes only
|
|
693
|
+
* `false`. Total: it never throws.
|
|
694
|
+
*/
|
|
695
|
+
export declare function declaredHostLocalPaths(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
696
|
+
/**
|
|
697
|
+
* Is a path this environment names the same file on the engine host's filesystem? Only a declared `true` says so — the
|
|
698
|
+
* engine never presents a path it cannot vouch for as a host path. Total: it never throws.
|
|
699
|
+
*/
|
|
700
|
+
export declare function pathsAreHostLocal(env: Pick<ExecutionEnv, "capabilities">): boolean;
|
|
701
|
+
/**
|
|
702
|
+
* Does content this environment produces come from outside the deployment's trust boundary
|
|
703
|
+
* ({@link ExecutionEnvCapabilities.externalContentTarget})? Three states: `true`, `false`, or `"undeclared"` (absent, not a
|
|
704
|
+
* boolean, unreadable) — which each consumer reads on ITS safe side: the content fold as outside (`!== false`), the
|
|
705
|
+
* cross-boundary lane as both the target and off it (the union of the two rows' obligations). Total: it never throws.
|
|
706
|
+
*/
|
|
707
|
+
export declare function targetIsExternal(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
708
|
+
/**
|
|
709
|
+
* Do this environment's filesystem and shell faces reach a target ({@link ExecutionEnvCapabilities.io})? Three states:
|
|
710
|
+
* `true`, `false` (the placeholder every operation of which refuses, `StubExecutionEnv`), or `"undeclared"` — which each
|
|
711
|
+
* consumer reads on ITS safe side: a shell face mounts only on `true`; the project marker is read through the environment
|
|
712
|
+
* unless it is `false` (a host-side read would pass the environment's own read limits). Total: it never throws.
|
|
713
|
+
*/
|
|
714
|
+
export declare function performsIo(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
715
|
+
/**
|
|
716
|
+
* Does this environment keep the byte floor a command start carries, or refuse a start whose whole table it cannot
|
|
717
|
+
* keep ({@link ExecutionEnvCapabilities.keepsReadFloor})? Only a declared `true` says so; undeclared ⇒ `false`. The
|
|
718
|
+
* judgment that reads it is taken once per run, where the run's read-deny table is compiled. Total: it never throws.
|
|
719
|
+
*/
|
|
720
|
+
export declare function keepsReadFloor(env: Pick<ExecutionEnv, "capabilities">): boolean;
|