@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
|
@@ -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
|
/**
|
|
@@ -74,11 +77,38 @@ export declare const WORKSPACE_HANDLE_MEMBERS: ReadonlyArray<keyof WorkspaceHand
|
|
|
74
77
|
* structured-clone step to fail on an exotic value. Each member is read the way the engine's own handle comparison reads it.
|
|
75
78
|
*
|
|
76
79
|
* ONE copy per live handle: a second call for the same object answers the copy the first call made (the members are read
|
|
77
|
-
* once), so every place the engine hands a checkpointed handle to the outside — the resume preflight's facts
|
|
78
|
-
*
|
|
79
|
-
*
|
|
80
|
+
* once), so every place the engine hands a checkpointed handle to the outside — the resume preflight's facts and the
|
|
81
|
+
* restore's {@link VmLifecycleOptions.priorHandle} — delivers the same object, not two renderings of one fact; the env
|
|
82
|
+
* factory's {@link ExecutionEnvFactoryContext.placementTarget} is the row's target ({@link placementTargetOf}).
|
|
80
83
|
*/
|
|
81
84
|
export declare function frozenHandleCopy(handle: WorkspaceHandle): Readonly<WorkspaceHandle>;
|
|
85
|
+
/**
|
|
86
|
+
* Which target a leg's environment is on: the backend (`provider`) and, when the target states one, the physical device
|
|
87
|
+
* (`deviceId`) — the two members of a {@link WorkspaceHandle} that NAME a target, and nothing that reconnects to or restores
|
|
88
|
+
* one (a sandbox id, a reconnect token, a snapshot id). The value of {@link ExecutionEnvFactoryContext.placementTarget}.
|
|
89
|
+
*/
|
|
90
|
+
export type PlacementTarget = Readonly<{
|
|
91
|
+
provider: string;
|
|
92
|
+
deviceId?: string;
|
|
93
|
+
}>;
|
|
94
|
+
/** The target `handle` names NOW: its `provider` and `deviceId` read as strings at this call (never through
|
|
95
|
+
* {@link frozenHandleCopy}'s per-object copy — an env may answer one handle object and update it in place, and a receipt
|
|
96
|
+
* must see what the env reports at the moment it is read), frozen; `undefined` when it names no provider (an empty
|
|
97
|
+
* string names none). */
|
|
98
|
+
export declare function placementTargetOf(handle: WorkspaceHandle): PlacementTarget | undefined;
|
|
99
|
+
/**
|
|
100
|
+
* The target an environment reports for itself, read ONCE per leg — at the point the leg's workspace settles: its
|
|
101
|
+
* `workspaceHandle()`'s {@link placementTargetOf}. `undefined` when there is nothing to read: the environment is not a
|
|
102
|
+
* remote one, or its handle cannot answer yet (a lazy-connect adapter before its first connection throws). That leg has
|
|
103
|
+
* no target of its own, so what it spawns carries no fence.
|
|
104
|
+
*/
|
|
105
|
+
export declare function reportedPlacementTarget(env: ExecutionEnv | undefined): PlacementTarget | undefined;
|
|
106
|
+
/**
|
|
107
|
+
* The ONE receipt every fenced leg is checked with: the target its environment reported honors `fence` when the fence names
|
|
108
|
+
* no device, or the report names that same device. A report that could not be read (`undefined`) names none, so it honors
|
|
109
|
+
* no device. `provider` is no part of it: only a durable resume leg also requires the checkpointed backend.
|
|
110
|
+
*/
|
|
111
|
+
export declare function placementHonored(fence: PlacementTarget | undefined, report: PlacementTarget | undefined): boolean;
|
|
82
112
|
/**
|
|
83
113
|
* A reference to a secret injected at {@link RemoteExecutionEnv.connect}/{@link RemoteExecutionEnv.postResumeInit}
|
|
84
114
|
* time (design/48 §5 gap 7) — never baked into the image. The control plane resolves {@link ref} to a value out of
|
|
@@ -129,8 +159,9 @@ export interface VmLifecycleOptions {
|
|
|
129
159
|
* as the legacy current-config behavior).
|
|
130
160
|
*
|
|
131
161
|
* A frozen copy holding exactly the declared members ({@link WORKSPACE_HANDLE_MEMBERS}) the checkpoint row carries
|
|
132
|
-
* as strings
|
|
133
|
-
*
|
|
162
|
+
* as strings ({@link frozenHandleCopy}: the SAME object the resume preflight's facts carry, for the same row) — not
|
|
163
|
+
* the stored row's own object: writing to it throws, and a decoration on the stored handle is absent. The restore
|
|
164
|
+
* facts live here only; the env factory was told the row's target alone ({@link ExecutionEnvFactoryContext.placementTarget}).
|
|
134
165
|
*/
|
|
135
166
|
priorHandle?: Readonly<WorkspaceHandle>;
|
|
136
167
|
}
|
|
@@ -226,7 +257,7 @@ export type RemoteExecutionErrorCode =
|
|
|
226
257
|
| "liveness_no_output"
|
|
227
258
|
/**
|
|
228
259
|
* 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
|
|
260
|
+
* non-suspendable SSH/ADB env. Permanent for this env; check its declaration ({@link declaredSuspend}) first.
|
|
230
261
|
*/
|
|
231
262
|
| "unsupported"
|
|
232
263
|
/**
|
|
@@ -319,67 +350,13 @@ export declare class RemoteExecutionError extends Error {
|
|
|
319
350
|
*/
|
|
320
351
|
export interface RemoteExecutionEnv extends ExecutionEnv {
|
|
321
352
|
/**
|
|
322
|
-
*
|
|
323
|
-
*
|
|
324
|
-
*
|
|
325
|
-
*
|
|
326
|
-
*
|
|
327
|
-
*
|
|
328
|
-
* that returns `"unsupported"` still satisfies the structural check). Extensible: add fields as new
|
|
329
|
-
* partial-capability classes appear.
|
|
353
|
+
* Identity of the connected workspace (design/48 §5 gap 1). Synchronous: it is data the env already holds.
|
|
354
|
+
*
|
|
355
|
+
* The engine reads it once per leg, when the leg's workspace settles, to learn which target the leg is on
|
|
356
|
+
* ({@link reportedPlacementTarget}) — the fence every agent the leg spawns or wakes is minted under. A target-bound
|
|
357
|
+
* adapter (one whose handle states `deviceId`) answers it from construction on, before any connection; an adapter
|
|
358
|
+
* that cannot answer yet (it throws) gives its leg no target, and that leg's agents carry no fence.
|
|
330
359
|
*/
|
|
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
|
-
/** Identity of the connected workspace (design/48 §5 gap 1). Synchronous: it is data the env already holds. */
|
|
383
360
|
workspaceHandle(): WorkspaceHandle;
|
|
384
361
|
/** Provision/attach the remote workspace and inject secrets. Returns the resulting {@link WorkspaceHandle}. */
|
|
385
362
|
connect(config?: RemoteConnectConfig): Promise<{
|
|
@@ -507,7 +484,11 @@ export interface ExecutionEnvFactoryContext {
|
|
|
507
484
|
* factory MUST refuse loudly too (loud-bad-value posture), never default around.
|
|
508
485
|
*/
|
|
509
486
|
placementRootSessionId: string;
|
|
510
|
-
/**
|
|
487
|
+
/**
|
|
488
|
+
* Caller-supplied task id: present only on a leg whose caller set `TaskSpec.taskId`. A child spec the engine builds (a
|
|
489
|
+
* delegated agent of any kind, a revival) never carries one — such a leg's task id IS its session id — so a factory
|
|
490
|
+
* MUST NOT identify a descendant by this key; the tree is {@link placementRootSessionId}, the leg {@link sessionId}.
|
|
491
|
+
*/
|
|
511
492
|
taskId?: string;
|
|
512
493
|
/**
|
|
513
494
|
* design/97 CORE-6 — per-task ISOLATION request threaded from the workflow's `ctx.agent({ isolation })` via
|
|
@@ -535,28 +516,37 @@ export interface ExecutionEnvFactoryContext {
|
|
|
535
516
|
*/
|
|
536
517
|
parentCwd?: string;
|
|
537
518
|
/**
|
|
538
|
-
*
|
|
539
|
-
*
|
|
540
|
-
*
|
|
541
|
-
*
|
|
542
|
-
*
|
|
519
|
+
* The placement FENCE — this context's one answer to "on which target must THIS leg's env be minted". Every leg
|
|
520
|
+
* learns its own target once, when its workspace settles (what its env reports, {@link reportedPlacementTarget});
|
|
521
|
+
* that one value is the fence of every leg it hands work to:
|
|
522
|
+
* · an agent it spawns (a delegated child of any kind, a workflow agent) or wakes (a retained or revived agent: the
|
|
523
|
+
* WAKING leg's target, never one remembered from the spawn);
|
|
524
|
+
* · a later leg of the same piece of work — a cascade rung after the first, a verification gate's verifier and fix
|
|
525
|
+
* legs — carries the FIRST leg's target;
|
|
526
|
+
* · a durable resume leg carries its checkpoint row's target, member by member over the one its waking leg hands it
|
|
527
|
+
* (a member the row states wins; a row recorded without `deviceId` takes the waking leg's).
|
|
528
|
+
* The key is ABSENT (not an `undefined` value) on a top-level first leg its host gave no fence
|
|
529
|
+
* (`RunInternals.placementTarget`), and on a leg whose spawning leg has no target of its own (its env is not remote,
|
|
530
|
+
* or could not answer `workspaceHandle()` when its workspace settled). A frozen value; mutating it reaches nothing.
|
|
543
531
|
*
|
|
544
|
-
* A factory bound to a target (the device lane) **MUST** mint the env on the device
|
|
545
|
-
*
|
|
546
|
-
*
|
|
547
|
-
*
|
|
548
|
-
*
|
|
549
|
-
*
|
|
532
|
+
* A factory bound to a target (the device lane) **MUST** mint the env on the device `placementTarget.deviceId` names
|
|
533
|
+
* and, when it cannot (offline, busy, the placement moved to another device), **THROW** a typed refusal. It **MUST
|
|
534
|
+
* NOT** connect some other device and leave the engine to notice, and it **MUST NOT** choose the target by the
|
|
535
|
+
* current binding of {@link placementRootSessionId}: it may read that binding only to find that it differs from the
|
|
536
|
+
* fence, and then refuse. A fence without `deviceId` states no device to honor; the factory then follows its
|
|
537
|
+
* ordinary routing.
|
|
550
538
|
*
|
|
551
|
-
* The minted env's `workspaceHandle()` **MUST** report the device its connection actually reached; it is
|
|
552
|
-
*
|
|
553
|
-
*
|
|
554
|
-
*
|
|
555
|
-
*
|
|
556
|
-
*
|
|
557
|
-
*
|
|
539
|
+
* The minted env's `workspaceHandle()` **MUST** report the device its connection actually reached; it is never
|
|
540
|
+
* copied from the fence. The engine checks every fenced leg with one receipt ({@link placementHonored}: the report
|
|
541
|
+
* names the fence's `deviceId` whenever the fence carries one, and a report that cannot be read names none): a leg
|
|
542
|
+
* restoring a checkpointed workspace that fails it is refused `resume.env_failed` (that restore also requires the
|
|
543
|
+
* checkpointed `provider`), any other leg `config.placement_not_honored`, before it runs. The receipt TRUSTS the report: a factory that connected elsewhere and
|
|
544
|
+
* reports so is refused, only after the wrong connection was made, but one that echoes the fence while connecting
|
|
545
|
+
* elsewhere defeats its own protection and passes. On a resume leg the fence moves no refusal earlier than it was:
|
|
546
|
+
* it runs after the claim, so what a deployment can still catch BEFORE the claim is `RunnerDeps.resumePreflight`
|
|
547
|
+
* alone.
|
|
558
548
|
*/
|
|
559
|
-
|
|
549
|
+
placementTarget?: PlacementTarget;
|
|
560
550
|
}
|
|
561
551
|
/**
|
|
562
552
|
* A **trusted control-plane** factory that mints a per-task {@link ExecutionEnv} (design/48 §5 answers core
|
|
@@ -571,7 +561,10 @@ export interface ExecutionEnvFactoryContext {
|
|
|
571
561
|
export type ExecutionEnvFactory = (ctx: ExecutionEnvFactoryContext) => ExecutionEnv | Promise<ExecutionEnv>;
|
|
572
562
|
/** True when `env` exposes a lifecycle {@link RemoteExecutionEnv.destroy} the Runner should call on task end. */
|
|
573
563
|
export declare function hasDestroy(env: ExecutionEnv): env is ExecutionEnv & Pick<RemoteExecutionEnv, "destroy">;
|
|
574
|
-
/** Structural check that `env` implements the remote seam (lifecycle + streaming surface
|
|
564
|
+
/** Structural check that `env` implements the remote seam (lifecycle + streaming surface), answering only whether
|
|
565
|
+
* those methods can be called — never a capability. The block conjunct keeps an adapter that carries no capability
|
|
566
|
+
* block at all (a JS adapter the compiler never saw) off the remote paths, as before the block moved to the base; it
|
|
567
|
+
* is read off the block's one receipt ({@link capabilityReceiptOf}), never off the adapter again. */
|
|
575
568
|
export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteExecutionEnv;
|
|
576
569
|
/**
|
|
577
570
|
* The RESTORE half of the suspend contract — the methods the RESUME leg calls after a `suspendVM`
|
|
@@ -585,17 +578,94 @@ export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteEx
|
|
|
585
578
|
* the resume leg — a different process, hours later — with a bare `env.resumeVM is not a function`.
|
|
586
579
|
*/
|
|
587
580
|
export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("resumeVM" | "postResumeInit")[];
|
|
581
|
+
/**
|
|
582
|
+
* The capability readers (#2891). Every key of {@link ExecutionEnvCapabilities} is read through exactly one of the
|
|
583
|
+
* functions below, on every environment — a local one declares the block as a remote one does, so no reader asks the
|
|
584
|
+
* remote INTERFACE first and none gives a non-remote environment a fixed answer.
|
|
585
|
+
*
|
|
586
|
+
* Each reader takes only the boolean the adapter declared, off the block's one receipt ({@link capabilityReceiptOf}):
|
|
587
|
+
* the adapter's block is read once and every reader reads that frozen copy. A value that is absent, not a boolean, or
|
|
588
|
+
* cannot be received (a throwing getter, a Proxy) is no declaration, and the reader answers that key's SAFE side, one
|
|
589
|
+
* row per key in {@link UNDECLARED_CAPABILITY_READING}. The readers never throw and never announce: the admission
|
|
590
|
+
* census does, once per run per finding (`config.execution_env_capability_invalid`).
|
|
591
|
+
*/
|
|
592
|
+
export declare const UNDECLARED_CAPABILITY_READING: {
|
|
593
|
+
readonly isolation: {
|
|
594
|
+
readonly reads: false;
|
|
595
|
+
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";
|
|
596
|
+
};
|
|
597
|
+
readonly suspendable: {
|
|
598
|
+
readonly reads: "undeclared";
|
|
599
|
+
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";
|
|
600
|
+
};
|
|
601
|
+
readonly sharesProcessTable: {
|
|
602
|
+
readonly reads: "undeclared";
|
|
603
|
+
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)";
|
|
604
|
+
};
|
|
605
|
+
readonly canonicalPathAuthoritative: {
|
|
606
|
+
readonly reads: true;
|
|
607
|
+
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";
|
|
608
|
+
};
|
|
609
|
+
readonly hostLocalPaths: {
|
|
610
|
+
readonly reads: "undeclared";
|
|
611
|
+
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)";
|
|
612
|
+
};
|
|
613
|
+
readonly externalContentTarget: {
|
|
614
|
+
readonly reads: "undeclared";
|
|
615
|
+
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)";
|
|
616
|
+
};
|
|
617
|
+
readonly io: {
|
|
618
|
+
readonly reads: "undeclared";
|
|
619
|
+
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";
|
|
620
|
+
};
|
|
621
|
+
readonly keepsReadFloor: {
|
|
622
|
+
readonly reads: false;
|
|
623
|
+
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`";
|
|
624
|
+
};
|
|
625
|
+
};
|
|
626
|
+
/** The keys of {@link ExecutionEnvCapabilities}, in declaration order — the census walks exactly these. */
|
|
627
|
+
export declare const CAPABILITY_KEYS: ReadonlyArray<keyof ExecutionEnvCapabilities>;
|
|
628
|
+
/** One finding of a block's receipt: a key of the block not declared as a boolean (`expected: "boolean"`), the block itself
|
|
629
|
+
* when it is not an object or cannot be received (`key: "capabilities"`, `expected: "object"`), or a member the block carries
|
|
630
|
+
* that is no capability (`expected: "absent"`: a misspelled or retired key, whose value no reader takes). */
|
|
631
|
+
export interface CapabilityBlockFinding {
|
|
632
|
+
readonly key: string;
|
|
633
|
+
/** The type the member carries (`"undefined"` where it is absent), or `"unreadable"` where it could not be received. */
|
|
634
|
+
readonly valueType: string;
|
|
635
|
+
readonly expected: "boolean" | "object" | "absent";
|
|
636
|
+
}
|
|
637
|
+
/** What the engine holds of an environment's capability block: the booleans it declares (the eight keys only, frozen), whether the block is
|
|
638
|
+
* an object at all (the remote predicate's block conjunct), and the receipt's findings, in key order and then member order. */
|
|
639
|
+
export interface CapabilityReceipt {
|
|
640
|
+
readonly declared: Readonly<Partial<Record<keyof ExecutionEnvCapabilities, boolean>>>;
|
|
641
|
+
readonly blockIsObject: boolean;
|
|
642
|
+
readonly findings: readonly CapabilityBlockFinding[];
|
|
643
|
+
}
|
|
644
|
+
/**
|
|
645
|
+
* The ONE receipt of an environment's capability block: read off the adapter once per environment object — at its first read,
|
|
646
|
+
* which for a run's environment is the run's admission census — and held frozen; every reader, the census and the remote
|
|
647
|
+
* predicate read this receipt and never the adapter again, so what the census announced is what every reader acts on, and a
|
|
648
|
+
* block the host changes afterwards changes nothing the engine reads. A value that is not an object (a JS caller's `null`) has
|
|
649
|
+
* no block and is not remembered. Total: it never throws.
|
|
650
|
+
*/
|
|
651
|
+
export declare function capabilityReceiptOf(env: Pick<ExecutionEnv, "capabilities">): CapabilityReceipt;
|
|
652
|
+
/**
|
|
653
|
+
* What this environment declares about snapshots, in three states: `true` (it can be snapshot and restored), `false`
|
|
654
|
+
* (it cannot — and, on a remote environment, its workspace is externally durable, the park-only degrade's premise), or
|
|
655
|
+
* `"undeclared"` (absent, not a boolean, unreadable). The snapshot reader ({@link isSuspendable}) takes only `true`, the
|
|
656
|
+
* suspend paths' park-only lane only `false`; an undeclared environment is in neither, so a run on it cannot suspend
|
|
657
|
+
* durably.
|
|
658
|
+
*/
|
|
659
|
+
export declare function declaredSuspend(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
588
660
|
/**
|
|
589
661
|
* Can this env be durably suspended/snapshotted (design/61 §9 A)? Use this — NOT the structural
|
|
590
662
|
* {@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
|
-
*
|
|
663
|
+
* `capabilities.suspendable: false` but still has the method, which returns `"unsupported"`). An environment
|
|
664
|
+
* without the remote interface has no `suspendVM` to call, whatever it declares.
|
|
593
665
|
*
|
|
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.
|
|
666
|
+
* A composite type guard (declaration AND interface AND restore surface) so a `suspendVM` call site narrowed by THIS
|
|
667
|
+
* predicate gets the {@link RemoteExecutionEnv} type without a cast — `true` always implies the structural check too.
|
|
668
|
+
* The declaration is read through {@link declaredSuspend}: only the boolean `true` counts.
|
|
599
669
|
*
|
|
600
670
|
* It also requires the RESTORE surface ({@link missingRestoreSurface}). A suspend is only durable
|
|
601
671
|
* if something can undo it; an adapter that offers `suspendVM` but no `resumeVM` used to pass this guard,
|
|
@@ -605,25 +675,23 @@ export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("res
|
|
|
605
675
|
*
|
|
606
676
|
* ⚠️ A capability-DECLARING but restore-incomplete adapter must NOT be re-routed to the durable-park-only
|
|
607
677
|
* 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.
|
|
678
|
+
* (see `ExecutionEnvCapabilities.suspendable`), which a snapshot backend does not have. Call
|
|
679
|
+
* sites split the two cases on the DECLARED `capabilities.suspendable` flag ({@link declaredSuspend}), not on this predicate alone.
|
|
610
680
|
*/
|
|
611
681
|
export declare function isSuspendable(env: ExecutionEnv): env is RemoteExecutionEnv;
|
|
612
682
|
/**
|
|
613
683
|
* 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
|
-
*
|
|
684
|
+
* for an in-process env (the host process is not isolated: `NodeExecutionEnv` and `StubExecutionEnv` declare
|
|
685
|
+
* `false`). The orchestrator tightens autonomy + the design/37 policy gate when this is `false` (zero-trust on an
|
|
686
|
+
* un-isolated target). Isolation must be explicitly declared, never assumed, and that is why the flag is read
|
|
617
687
|
* STRICTLY: every consumer of a `true` here RELAXES something (autonomy, a policy tier, a containment
|
|
618
688
|
* leg that the sandbox is then answerable for), so a value that is not the boolean `true` — absent,
|
|
619
689
|
* 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).
|
|
690
|
+
* on the checking side. This is the reading every consumer of the containment question comes through.
|
|
623
691
|
* What no caller may do is infer isolation from the remote INTERFACE — implementing the seam is not
|
|
624
692
|
* declaring containment, and a host-lane adapter drives the operator's own machine through it.
|
|
625
693
|
*/
|
|
626
|
-
export declare function isIsolated(env: ExecutionEnv): boolean;
|
|
694
|
+
export declare function isIsolated(env: Pick<ExecutionEnv, "capabilities">): boolean;
|
|
627
695
|
/**
|
|
628
696
|
* Is CONTAINMENT this env's own job rather than the engine's — i.e. may a containment leg stop at the
|
|
629
697
|
* written spelling and leave the rest to the target? True exactly for a DECLARED isolated sandbox: the
|
|
@@ -649,24 +717,52 @@ export declare function boundaryIsTheSandbox(env: ExecutionEnv): boolean;
|
|
|
649
717
|
* a question and the second is an absence, and reading both as the absence is what leaves a containment
|
|
650
718
|
* leg silently open on an RPC-backed lane.
|
|
651
719
|
*
|
|
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.
|
|
720
|
+
* So the adapter says which it is. Only a declared boolean is a declaration, and the undeclared reading is the
|
|
721
|
+
* refusing one (`true`): an environment that does not say whether its silence is a failure has its silence read as
|
|
722
|
+
* one, and is announced at its admission point — this reader does not validate. `NodeExecutionEnv` declares `true`,
|
|
723
|
+
* which moves nothing on the local lane: its resolver answers `/`, so the arm this gates has no case to fire on.
|
|
658
724
|
*/
|
|
659
|
-
export declare function canonicalPathIsAuthoritative(env: ExecutionEnv): boolean;
|
|
725
|
+
export declare function canonicalPathIsAuthoritative(env: Pick<ExecutionEnv, "capabilities">): boolean;
|
|
660
726
|
/**
|
|
661
727
|
* 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
|
|
728
|
+
* ({@link ExecutionEnvCapabilities.sharesProcessTable}):
|
|
729
|
+
* · `"this"` — a table that holds this process: an env that declares `true` (`NodeExecutionEnv`, whose commands are
|
|
730
|
+
* this process's children; a host lane);
|
|
731
|
+
* · `"other"` — an env that declares `false`;
|
|
732
|
+
* · `"undeclared"` — an env whose declaration is absent, not a boolean, or cannot be read (a throwing
|
|
669
733
|
* getter or Proxy trap). There is no default to fold it to, so the caller refuses what it cannot answer.
|
|
670
734
|
* Total: it never throws. It does not announce — the admission census does, once per run.
|
|
671
735
|
*/
|
|
672
|
-
export declare function processTableOf(env: ExecutionEnv): "this" | "other" | "undeclared";
|
|
736
|
+
export declare function processTableOf(env: Pick<ExecutionEnv, "capabilities">): "this" | "other" | "undeclared";
|
|
737
|
+
/**
|
|
738
|
+
* Where the paths this environment names land ({@link ExecutionEnvCapabilities.hostLocalPaths}), in three states: `true`
|
|
739
|
+
* (the host's own files), `false` (somewhere the host does not mount at the same paths), `"undeclared"` — which each
|
|
740
|
+
* consumer reads on ITS safe side: {@link pathsAreHostLocal} takes only `true`; the worktree child's exemption takes only
|
|
741
|
+
* `false`. Total: it never throws.
|
|
742
|
+
*/
|
|
743
|
+
export declare function declaredHostLocalPaths(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
744
|
+
/**
|
|
745
|
+
* Is a path this environment names the same file on the engine host's filesystem? Only a declared `true` says so — the
|
|
746
|
+
* engine never presents a path it cannot vouch for as a host path. Total: it never throws.
|
|
747
|
+
*/
|
|
748
|
+
export declare function pathsAreHostLocal(env: Pick<ExecutionEnv, "capabilities">): boolean;
|
|
749
|
+
/**
|
|
750
|
+
* Does content this environment produces come from outside the deployment's trust boundary
|
|
751
|
+
* ({@link ExecutionEnvCapabilities.externalContentTarget})? Three states: `true`, `false`, or `"undeclared"` (absent, not a
|
|
752
|
+
* boolean, unreadable) — which each consumer reads on ITS safe side: the content fold as outside (`!== false`), the
|
|
753
|
+
* cross-boundary lane as both the target and off it (the union of the two rows' obligations). Total: it never throws.
|
|
754
|
+
*/
|
|
755
|
+
export declare function targetIsExternal(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
756
|
+
/**
|
|
757
|
+
* Do this environment's filesystem and shell faces reach a target ({@link ExecutionEnvCapabilities.io})? Three states:
|
|
758
|
+
* `true`, `false` (the placeholder every operation of which refuses, `StubExecutionEnv`), or `"undeclared"` — which each
|
|
759
|
+
* consumer reads on ITS safe side: a shell face mounts only on `true`; the project marker is read through the environment
|
|
760
|
+
* unless it is `false` (a host-side read would pass the environment's own read limits). Total: it never throws.
|
|
761
|
+
*/
|
|
762
|
+
export declare function performsIo(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
|
|
763
|
+
/**
|
|
764
|
+
* Does this environment keep the byte floor a command start carries, or refuse a start whose whole table it cannot
|
|
765
|
+
* keep ({@link ExecutionEnvCapabilities.keepsReadFloor})? Only a declared `true` says so; undeclared ⇒ `false`. The
|
|
766
|
+
* judgment that reads it is taken once per run, where the run's read-deny table is compiled. Total: it never throws.
|
|
767
|
+
*/
|
|
768
|
+
export declare function keepsReadFloor(env: Pick<ExecutionEnv, "capabilities">): boolean;
|