@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
|
@@ -6,14 +6,14 @@ import { createReadInboxTool, READ_INBOX_TOOL_NAME } from "../../agents/read-inb
|
|
|
6
6
|
import { valveLeaves } from "../../agents/tool-filter.js";
|
|
7
7
|
import { createMonitorTool } from "../../tools/monitor.js";
|
|
8
8
|
import { createWorktreeTools } from "../../tools/worktree.js";
|
|
9
|
-
import {
|
|
9
|
+
import { createTaskStopTool, defaultTaskRegistry } from "../task-registry.js";
|
|
10
10
|
import { createReadToolResultTool } from "../tool-result-store.js";
|
|
11
11
|
import { emitTrace } from "../trace.js";
|
|
12
12
|
import { deliverEngineNotice } from "../types.js";
|
|
13
13
|
import { RosterBuilder } from "../tool-roster.js";
|
|
14
14
|
import { sendMessageContinuationSeats } from "./send-message-continuation.js";
|
|
15
15
|
export function prepareDelegationSurface(input) {
|
|
16
|
-
const { spec, deps, internals, resume, sessionId, hostTaskId, taskScope, taskRootFinal, taskRootCanonical, executionEnv, runnerSelf, backgroundTaskToolsActive, workflowToolsActive, peerLaneActive, peerSendMessageBuiltIn, peerLaneRefs, sessionBox, roster, axisExplicitNegatives, envHandToolNames, toolFaceSnapshot, firstPartyOffload, offloadStore, subagentRetain, enrichSpecToolCtx, checkpointSeat, handsCwdRef, wsSnapshot, rebaseWsPath, rebaseRestoredPath, workspaceStateSettle, worktreeSeat } = input;
|
|
16
|
+
const { spec, deps, internals, resume, sessionId, hostTaskId, taskScope, taskRootFinal, taskRootCanonical, executionEnv, runnerSelf, backgroundTaskToolsActive, workflowToolsActive, peerLaneActive, peerSendMessageBuiltIn, peerLaneRefs, sessionBox, roster, axisExplicitNegatives, envHandToolNames, toolFaceSnapshot, firstPartyOffload, offloadStore, taskArtifacts, subagentRetain, enrichSpecToolCtx, checkpointSeat, handsCwdRef, wsSnapshot, rebaseWsPath, rebaseRestoredPath, workspaceStateSettle, worktreeSeat } = input;
|
|
17
17
|
let worktreeSessionRef;
|
|
18
18
|
const delegationSurfaceActive = backgroundTaskToolsActive || workflowToolsActive;
|
|
19
19
|
const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
|
|
@@ -21,7 +21,6 @@ export function prepareDelegationSurface(input) {
|
|
|
21
21
|
if (delegationSurfaceActive || internals?.parentNotify !== undefined || peerLaneActive) {
|
|
22
22
|
if (delegationSurfaceActive) {
|
|
23
23
|
roster.mountAll([
|
|
24
|
-
firstPartyOffload(createTaskOutputTool({ registry: defaultTaskRegistry, owner: hostTaskId, scope: taskScope, sessionId, workflowStore: deps.workflowRunStore, agentStore: deps.backgroundAgentStore, notificationWired: internals?.onTaskNotification !== undefined, oneShot: spec.oneShot, toolResultStore: offloadStore, ...(checkpointSeat !== undefined ? { checkpointSeat } : {}) })),
|
|
25
24
|
firstPartyOffload(createTaskStopTool({ registry: defaultTaskRegistry, owner: hostTaskId, scope: taskScope, sessionId, workflowStore: deps.workflowRunStore, agentStore: deps.backgroundAgentStore })),
|
|
26
25
|
], { source: "builtin", mountedBy: "delegation" });
|
|
27
26
|
}
|
|
@@ -36,7 +35,7 @@ export function prepareDelegationSurface(input) {
|
|
|
36
35
|
owner: hostTaskId,
|
|
37
36
|
scope: taskScope,
|
|
38
37
|
...(sessionId !== undefined ? { sessionId } : {}),
|
|
39
|
-
...(internals?.onTaskNotification !== undefined ? { notify: internals.onTaskNotification } : {}), ...(
|
|
38
|
+
...(internals?.onTaskNotification !== undefined ? { notify: internals.onTaskNotification } : {}), ...(taskArtifacts !== undefined ? { taskArtifacts } : {}),
|
|
40
39
|
...(internals?.onSubagentSpawn !== undefined ? { sink: internals.onSubagentSpawn } : {}),
|
|
41
40
|
...(internals?.parentNotify !== undefined
|
|
42
41
|
? { uplink: internals.parentNotify, ...(internals.parentPeerRef !== undefined ? { uplinkRecipient: internals.parentPeerRef } : {}) }
|
|
@@ -93,14 +92,14 @@ export function prepareDelegationSurface(input) {
|
|
|
93
92
|
roster.mount(firstPartyOffload(createMonitorTool(executionEnv, {
|
|
94
93
|
registry: defaultTaskRegistry,
|
|
95
94
|
...(input.shellReadAdmission !== undefined ? { shellReadAdmission: input.shellReadAdmission } : {}),
|
|
96
|
-
|
|
95
|
+
readFloor: input.runReadFloor,
|
|
97
96
|
owner: hostTaskId,
|
|
98
97
|
scope: taskScope,
|
|
99
98
|
...(sessionId !== undefined ? { sessionId } : {}),
|
|
100
99
|
...(internals?.onTaskNotification !== undefined ? { onTaskNotification: internals.onTaskNotification } : {}),
|
|
101
100
|
...(handsCwdRef !== undefined ? { cwdRef: handsCwdRef } : {}),
|
|
102
101
|
rootCanonical: taskRootCanonical,
|
|
103
|
-
...(
|
|
102
|
+
...(spec.oneShot !== undefined ? { oneShot: spec.oneShot } : {}),
|
|
104
103
|
retainBackgroundProcesses: spec.retainBackgroundProcesses === true,
|
|
105
104
|
})), { source: "builtin", mountedBy: "backgroundTasks" });
|
|
106
105
|
}
|
|
@@ -123,9 +122,9 @@ export function prepareDelegationSurface(input) {
|
|
|
123
122
|
worktreeSessionRef.current = seeded;
|
|
124
123
|
if (workspaceStateSettle !== undefined)
|
|
125
124
|
workspaceStateSettle.restoredWorktreeDir = worktreeSessionRef.current?.worktreeDir;
|
|
126
|
-
roster.mountAll(createWorktreeTools(executionEnv, { repoRoot: taskRootFinal, cwdRef: handsCwdRef, session: worktreeSessionRef }).map((t) => (envHandToolNames.add(t.name), firstPartyOffload(t))), { source: "builtin", mountedBy: "hands" });
|
|
125
|
+
roster.mountAll(createWorktreeTools(executionEnv, { repoRoot: taskRootFinal, cwdRef: handsCwdRef, session: worktreeSessionRef, readFloor: input.runReadFloor }).map((t) => (envHandToolNames.add(t.name), firstPartyOffload(t))), { source: "builtin", mountedBy: "hands" });
|
|
127
126
|
}
|
|
128
127
|
if (offloadStore)
|
|
129
|
-
roster.mount(createReadToolResultTool(offloadStore), { source: "builtin", mountedBy: "optional" });
|
|
128
|
+
roster.mount(createReadToolResultTool(offloadStore, (ref, tree) => defaultTaskRegistry.artifactBoundaryLegs(ref, { owner: hostTaskId, scope: taskScope, sessionId }, tree)), { source: "builtin", mountedBy: "optional" });
|
|
130
129
|
return { delegationSurfaceActive, worktreeSessionRef };
|
|
131
130
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type PlacementTarget } from "../remote-env.js";
|
|
1
2
|
import type { ExecutionEnv } from "../../internal/harness.js";
|
|
2
3
|
import type { RunnerDeps, TaskSpec } from "../types.js";
|
|
3
4
|
import type { ChildPlacement, PrepareResume, RollbackStack, RunInternals } from "./contracts.js";
|
|
@@ -19,8 +20,8 @@ export interface PrepareExecutionEnvInput {
|
|
|
19
20
|
spec: Pick<TaskSpec, "taskId">;
|
|
20
21
|
/** borrowed-readonly — the trusted spawn-side requests: the explicit cwd (a contract), the isolation
|
|
21
22
|
* request and the parent's cwd (both threaded to the factory ctx). */
|
|
22
|
-
internals: Pick<RunInternals, "requestedCwd" | "isolation" | "parentCwd" | "callerRoot" | "worktreeOffered"> | undefined;
|
|
23
|
-
/** borrowed-readonly — the resume leg: read to refuse an explicit cwd a checkpoint restore would overrule, and
|
|
23
|
+
internals: Pick<RunInternals, "requestedCwd" | "isolation" | "parentCwd" | "callerRoot" | "worktreeOffered" | "placementTarget"> | undefined;
|
|
24
|
+
/** borrowed-readonly — the resume leg: read to refuse an explicit cwd a checkpoint restore would overrule, and for the target its row recorded (the fence's first member source). */
|
|
24
25
|
resume: Pick<PrepareResume, "workspaceHandle"> | undefined;
|
|
25
26
|
/** borrowed-readonly — the run tree's placement fixed point, resolved ONCE by the driver; the factory
|
|
26
27
|
* door refuses an empty value loudly before the factory is asked. */
|
|
@@ -52,5 +53,7 @@ export interface PrepareExecutionEnvResult {
|
|
|
52
53
|
/** borrowed-readonly — where a CHILD landed against where its caller asked ({@link childPlacementOnLeg}); absent on a leg no
|
|
53
54
|
* delegation caller placed (no `callerRoot`). */
|
|
54
55
|
placement: ChildPlacement | undefined;
|
|
56
|
+
/** borrowed-readonly — the fence this leg was minted under (folded once here; absent when unfenced): the restore phase checks the env against it. */
|
|
57
|
+
placementFence: PlacementTarget | undefined;
|
|
55
58
|
}
|
|
56
59
|
export declare function prepareExecutionEnv(input: PrepareExecutionEnvInput): Promise<PrepareExecutionEnvResult>;
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { StubExecutionEnv } from "../stub-env.js";
|
|
2
|
-
import {
|
|
2
|
+
import { hasDestroy } from "../remote-env.js";
|
|
3
|
+
import { mintPlacementFence } from "./placement-fence.js";
|
|
3
4
|
import { announceMalformedCapabilities } from "./env-capability-census.js";
|
|
4
5
|
import { childPlacementOnLeg, deploymentCanRerootChild, worktreeNotHonored } from "./child-tree.js";
|
|
5
6
|
import { settleTeardownLeg } from "./teardown-bounded.js";
|
|
@@ -17,14 +18,16 @@ export async function prepareExecutionEnv(input) {
|
|
|
17
18
|
await settleTeardownLeg(() => forgetOnThrow(), "forgetOnThrow (cwd-conflicts-restore leg)", (err) => deps.onError?.(err, { phase: "config", sessionId }));
|
|
18
19
|
throw cwdConflictsRestoreError(internals.requestedCwd);
|
|
19
20
|
}
|
|
21
|
+
let placementFence;
|
|
20
22
|
try {
|
|
23
|
+
placementFence = mintPlacementFence(resume?.workspaceHandle, internals?.placementTarget);
|
|
21
24
|
ownedEnv = deps.executionEnvFactory
|
|
22
25
|
? await deps.executionEnvFactory({
|
|
23
26
|
sessionId, placementRootSessionId: mintPlacementRootSessionId(placementRootResolved),
|
|
24
|
-
taskId: spec.taskId,
|
|
27
|
+
...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
|
|
25
28
|
...(internals?.isolation ? { isolation: internals.isolation } : {}),
|
|
26
29
|
...(internals?.parentCwd ? { parentCwd: internals.parentCwd } : {}),
|
|
27
|
-
...(
|
|
30
|
+
...(placementFence !== undefined ? { placementTarget: placementFence } : {}),
|
|
28
31
|
})
|
|
29
32
|
: undefined;
|
|
30
33
|
if (ownedEnv !== undefined)
|
|
@@ -78,7 +81,7 @@ export async function prepareExecutionEnv(input) {
|
|
|
78
81
|
ownedEnvSeat.current = undefined;
|
|
79
82
|
throw worktreeNotHonored(executionEnv.cwd);
|
|
80
83
|
}
|
|
81
|
-
return { executionEnv, ownedEnvSeat, ownedEnvObservedAt, handsEnabled, taskRootInitial, placement };
|
|
84
|
+
return { executionEnv, ownedEnvSeat, ownedEnvObservedAt, handsEnabled, taskRootInitial, placement, placementFence };
|
|
82
85
|
}
|
|
83
86
|
function cwdConflictsRestoreError(requestedCwd) {
|
|
84
87
|
const e = new Error(`RunInternals.requestedCwd ("${requestedCwd}") cannot be combined with a checkpoint workspace restore — ` +
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* PrepareTask's file-history phase, verbatim from the driver: the DV-14 first-touch
|
|
3
|
-
* policy door, the `RunnerDeps.fileHistoryStore` / `fileHistoryCapture` and `TaskSpec.fileHistory` bad-value doors, the
|
|
4
|
-
* split, the restoreFiles / resumeAt / rewindFilesTo combination gates, the run's history coordinates
|
|
3
|
+
* policy door, the `RunnerDeps.fileHistoryStore` / `fileHistoryCapture` and `TaskSpec.fileHistory` bad-value doors, the restoreFiles / resumeAt / rewindFilesTo combination gates, the run's history coordinates
|
|
5
4
|
* (canonical root, recording scope, filesystem identity), the fork carry, the child-scope refusal, the
|
|
6
5
|
* rewind RESTORE itself (anchor translation in "before" mode, the per-file ledger, partial-restore
|
|
7
6
|
* policy), the `trackFileEdit` hook the hands band calls before every mutation lane, and the turn-start
|
|
@@ -32,8 +31,7 @@ export interface PrepareFileHistoryInput {
|
|
|
32
31
|
/** borrowed-readonly — the deployment seats this phase reads: the first-touch failure policy, the history
|
|
33
32
|
* store and its capture switch (all validated HERE, once), the incident sink, and the retired-epoch diagnostic probe. */
|
|
34
33
|
deps: Pick<RunnerDeps, "onError">;
|
|
35
|
-
/** borrowed-readonly — the REBOUND spec's rewind request fields and off-switch word
|
|
36
|
-
* spelling is read off the same object as an unknown key) and the caller's cancel signal for the restore. */
|
|
34
|
+
/** borrowed-readonly — the REBOUND spec's rewind request fields and off-switch word and the caller's cancel signal for the restore. */
|
|
37
35
|
spec: Pick<TaskSpec, "resumeAt" | "restoreFiles" | "acceptPartialRestore" | "signal">;
|
|
38
36
|
/** borrowed-readonly — the request door's resolution ({@link resolveFileHistoryRequest}), judged before the session was
|
|
39
37
|
* acquired: every refusal the request and the deployment's seats decide on their own has already thrown. */
|
|
@@ -125,14 +123,14 @@ export declare function resolveFileHistoryScope(lineage: RunInternals["fileHisto
|
|
|
125
123
|
/**
|
|
126
124
|
* WHICH filesystem an env is a view of — the second coordinate of tree identity for the file-history
|
|
127
125
|
* lineage, read from what the env's MINTER states rather than inferred from a path:
|
|
128
|
-
* ·
|
|
129
|
-
*
|
|
130
|
-
* ·
|
|
131
|
-
*
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
126
|
+
* · an env that DECLARES its paths host-local (`pathsAreHostLocal` — `NodeExecutionEnv`, a host lane) is the
|
|
127
|
+
* control-plane host's filesystem — every such env is one tree, whatever interface it drives it through;
|
|
128
|
+
* · otherwise a remote workspace names itself through its {@link WorkspaceHandle} (provider + sandbox, and
|
|
129
|
+
* the device lane's id when stamped) — two runs on one sandbox share a tree, two sandboxes never do;
|
|
130
|
+
* · anything else — an env declaring `hostLocalPaths: false` with no handle, or one whose declaration is
|
|
131
|
+
* missing or malformed (read as not host-local) — is attested to nothing, so it is its OWN tree: a
|
|
132
|
+
* per-instance token, which still matches when the child literally holds the parent's env object and
|
|
133
|
+
* never matches a fresh per-task mint.
|
|
136
134
|
* A remote handle that cannot be read (an env not yet connected) falls to the per-instance arm for
|
|
137
135
|
* the same reason: unattested is not shared.
|
|
138
136
|
*/
|
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { isRemoteExecutionEnv } from "../remote-env.js";
|
|
1
|
+
import { isRemoteExecutionEnv, pathsAreHostLocal } from "../remote-env.js";
|
|
3
2
|
import { FILE_HISTORY_ERROR_CODES, FileHistoryStoreError } from "../file-history-store.js";
|
|
4
3
|
import { readMember, thrownText } from "../thrown-value.js";
|
|
5
4
|
import { isGovernanceRetryClass } from "../governance-codes.js";
|
|
@@ -8,13 +7,6 @@ export async function prepareFileHistory(input) {
|
|
|
8
7
|
const { deps, spec, request, internals, executionEnv, taskRootFinal, handsEnabled, sessionId, session, abortController } = input;
|
|
9
8
|
const rewindNotes = [];
|
|
10
9
|
const { onTrackFailure, captureOff, declaredOff, fileHistoryStore, captureStore, rewindTarget, rewindBefore } = request;
|
|
11
|
-
if (spec.rewindFiles === true) {
|
|
12
|
-
try {
|
|
13
|
-
deps.onError?.(new Error(`TaskSpec.rewindFiles (capture sense) is retired and was ignored: per-edited-file first-touch tracking is on whenever RunnerDeps.fileHistoryStore is wired and neither RunnerDeps.fileHistoryCapture nor TaskSpec.fileHistory turns it off, so a per-turn capture request has nothing left to ask for. Drop the field; the restore sense moved to TaskSpec.restoreFiles.`), { phase: "config", sessionId });
|
|
14
|
-
}
|
|
15
|
-
catch {
|
|
16
|
-
}
|
|
17
|
-
}
|
|
18
10
|
if (spec.resumeAt !== undefined && spec.restoreFiles !== true) {
|
|
19
11
|
rewindNotes.push({
|
|
20
12
|
code: "conversation_only",
|
|
@@ -226,6 +218,8 @@ export function resolveFileHistoryScope(lineage, historyRoot, historyFs, session
|
|
|
226
218
|
const envFilesystemTokens = new WeakMap();
|
|
227
219
|
let envFilesystemSeq = 0;
|
|
228
220
|
export function fileHistoryFilesystemIdentity(env) {
|
|
221
|
+
if (pathsAreHostLocal(env))
|
|
222
|
+
return "host";
|
|
229
223
|
if (isRemoteExecutionEnv(env)) {
|
|
230
224
|
try {
|
|
231
225
|
const h = env.workspaceHandle();
|
|
@@ -234,9 +228,6 @@ export function fileHistoryFilesystemIdentity(env) {
|
|
|
234
228
|
catch {
|
|
235
229
|
}
|
|
236
230
|
}
|
|
237
|
-
else if (env.hostLocalPaths === true || (env.hostLocalPaths === undefined && env instanceof NodeExecutionEnv)) {
|
|
238
|
-
return "host";
|
|
239
|
-
}
|
|
240
231
|
let token = envFilesystemTokens.get(env);
|
|
241
232
|
if (token === undefined) {
|
|
242
233
|
token = `instance:${++envFilesystemSeq}`;
|
|
@@ -30,7 +30,7 @@ import type { Arbitration, ToolMarkSource } from "../ask-origin.js";
|
|
|
30
30
|
import { type PermissionModeController } from "../mode-policy.js";
|
|
31
31
|
import type { AutoModeDecider, AutoModeDenialTracker } from "../auto-mode.js";
|
|
32
32
|
import { type ComplianceCapability } from "../compliance.js";
|
|
33
|
-
import type {
|
|
33
|
+
import type { InheritedInstallation, LegModBus } from "../mods/stations.js";
|
|
34
34
|
import { type HookEnvCapabilities, type HookInvocationIdentity } from "../hooks.js";
|
|
35
35
|
import type { ToolPolicy } from "../tool-policy.js";
|
|
36
36
|
import { type GateOutcome } from "../gate-outcome.js";
|
|
@@ -47,20 +47,25 @@ import type { ToolCallLike } from "../tool-registry.js";
|
|
|
47
47
|
import type { FrameSettlement } from "../frame-settlement.js";
|
|
48
48
|
import { type ApprovedCallScreen } from "./call-hook-stations.js";
|
|
49
49
|
/**
|
|
50
|
-
* The parent-thread human-rejection boundary —
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
* and
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
*
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
|
|
63
|
-
|
|
50
|
+
* The parent-thread human-rejection boundary — THE judgment behind every halt on a person's "no", read off the one
|
|
51
|
+
* record a decide mints (a live gate pass's, a parked tool approval's, a plan pause's), never off message text. CC
|
|
52
|
+
* parity: the reference's reject handler (one handler for a tool call's card and the plan card) aborts the turn
|
|
53
|
+
* exactly when there is no feedback, no attached content and the run is not a subagent; a rejection WITH the decider's
|
|
54
|
+
* note, and every delegated child — forks included — keep the continue / adapt-or-report posture. True iff the record
|
|
55
|
+
* IS a person's refusal (`deniedBy: ask_resolution` and a `human_refused` settlement — not a later fold layer's deny
|
|
56
|
+
* that merely followed a human interaction), the refusal carried NO note (`settlement.note` absent — a fact composed
|
|
57
|
+
* at the refusal, never re-derived from message text), and the leg is not a delegated child (the raw trusted
|
|
58
|
+
* delegation facet — the same fact that selects the refusal text's posture, so the boundary and the words the model
|
|
59
|
+
* was told always agree). Policy/hook/classifier denies and window/abort settlements never satisfy it. A leg it
|
|
60
|
+
* answers true for ends its turn awaiting the user: the live batch through {@link maybeHumanRejectionHalt}'s
|
|
61
|
+
* directive, a resumed leg by recording the decision and requesting nothing more.
|
|
62
|
+
*/
|
|
63
|
+
export declare function isBareHumanRefusal(gate: GateOutcome | undefined, isDelegatedChild: boolean): boolean;
|
|
64
|
+
/**
|
|
65
|
+
* The loop directive a bare refusal of a CALL ({@link isBareHumanRefusal}) hands the batch it halts: it settles every
|
|
66
|
+
* never-started same-batch sibling with honest known-not-executed wording plus the machine mark (`error`/`code` twin —
|
|
67
|
+
* the wire errorCode lift reads `details.code`; `details.error` is the in-band mark result consumers grep) naming the
|
|
68
|
+
* rejected call. `undefined` = no boundary (the block stands alone).
|
|
64
69
|
*/
|
|
65
70
|
export declare function maybeHumanRejectionHalt(input: {
|
|
66
71
|
gate: GateOutcome | undefined;
|
|
@@ -96,8 +101,9 @@ export interface PrepareGateStationsInput {
|
|
|
96
101
|
/** borrowed-readonly — the leg's mods bus: `classic.PreToolUse` presence arms the gate; the screenings and the post-call
|
|
97
102
|
* events are raised on it. */
|
|
98
103
|
modBus: LegModBus;
|
|
99
|
-
/** borrowed-readonly — the inherited installations the gate
|
|
100
|
-
|
|
104
|
+
/** borrowed-readonly — the inherited installations the gate judges its calls on after `modBus` (`classic.PreToolUse` at phase 1,
|
|
105
|
+
* `tool.check` at the verdict read; the policy-chain phase's). */
|
|
106
|
+
inheritedInstallations: readonly InheritedInstallation[];
|
|
101
107
|
/** borrowed-readonly — the egress vocabulary: arming, and the per-call `egress` flag handed to the gate. */
|
|
102
108
|
egressTools: ReadonlySet<string>;
|
|
103
109
|
/** borrowed-readonly — the irreversible vocabulary: arming only. */
|
|
@@ -29,11 +29,13 @@ function screenGateResult(result) {
|
|
|
29
29
|
}
|
|
30
30
|
return defects.length > 0 ? { defects } : { gate, defects };
|
|
31
31
|
}
|
|
32
|
+
export function isBareHumanRefusal(gate, isDelegatedChild) {
|
|
33
|
+
const d = gate?.disposition;
|
|
34
|
+
const s = gate?.settlement;
|
|
35
|
+
return d?.kind === "denied" && d.deniedBy === "ask_resolution" && s?.kind === "human_refused" && s.note === undefined && !isDelegatedChild;
|
|
36
|
+
}
|
|
32
37
|
export function maybeHumanRejectionHalt(input) {
|
|
33
|
-
|
|
34
|
-
const s = input.gate?.settlement;
|
|
35
|
-
const bare = d?.kind === "denied" && d.deniedBy === "ask_resolution" && s?.kind === "human_refused" && s.note === undefined;
|
|
36
|
-
if (!bare || input.isDelegatedChild)
|
|
38
|
+
if (!isBareHumanRefusal(input.gate, input.isDelegatedChild))
|
|
37
39
|
return undefined;
|
|
38
40
|
return {
|
|
39
41
|
reason: `This tool call was NOT executed: the user rejected the "${input.toolName}" tool call in the same ` +
|
|
@@ -48,7 +50,7 @@ export function maybeHumanRejectionHalt(input) {
|
|
|
48
50
|
};
|
|
49
51
|
}
|
|
50
52
|
export function prepareGateStations(input) {
|
|
51
|
-
const { askLane, parkAsk, tools, toolRosterDeltas, deps, toolCallGateArmedRef, effectivePolicy, egressTools, irreversibleTools, spec, complianceDenies, harness, blockedToolCalls, inheritedAskGrants, inheritedUnavailableAsks, foldAskClasses, ancestorSandboxAdmissions, preToolContexts, toolOccurrences, batchHaltRef, blockedTracked, hookIdentity, reminderMark, hostTaskId, sessionId, handsCwdRef, stampCallTarget, hookEnvFace, writeProtectionCheck, shellReadCheck, crossBoundaryCheck, readFace, irreversibilityTier, reversibilityProbes, abortController, shellGatedTools, autoModeDecider, autoModeDenialTracking, askRoute, permissionMode, toolMarkSources, a2aIsolatePeers, ancestorArbitrations, runId, stopForDenialLimit, permissionRuleLane, permissionRuleOrgLane, questionToolMounted, sandboxAdmissionArmed, sandboxBoundaryCapable, emitSandboxAdmitted, delegation, frameSettlement, seatInputsFor, modBus,
|
|
53
|
+
const { askLane, parkAsk, tools, toolRosterDeltas, deps, toolCallGateArmedRef, effectivePolicy, egressTools, irreversibleTools, spec, complianceDenies, harness, blockedToolCalls, inheritedAskGrants, inheritedUnavailableAsks, foldAskClasses, ancestorSandboxAdmissions, preToolContexts, toolOccurrences, batchHaltRef, blockedTracked, hookIdentity, reminderMark, hostTaskId, sessionId, handsCwdRef, stampCallTarget, hookEnvFace, writeProtectionCheck, shellReadCheck, crossBoundaryCheck, readFace, irreversibilityTier, reversibilityProbes, abortController, shellGatedTools, autoModeDecider, autoModeDenialTracking, askRoute, permissionMode, toolMarkSources, a2aIsolatePeers, ancestorArbitrations, runId, stopForDenialLimit, permissionRuleLane, permissionRuleOrgLane, questionToolMounted, sandboxAdmissionArmed, sandboxBoundaryCapable, emitSandboxAdmitted, delegation, frameSettlement, seatInputsFor, modBus, inheritedInstallations } = input;
|
|
52
54
|
const releasesAnnounced = new Map();
|
|
53
55
|
const onModeReleased = (info) => {
|
|
54
56
|
const table = info.readUnestablished === true ? input.readDenyInForce(info.toolCallId) : undefined;
|
|
@@ -78,6 +80,7 @@ export function prepareGateStations(input) {
|
|
|
78
80
|
toolCallGateArmedRef.armed =
|
|
79
81
|
effectivePolicy !== undefined ||
|
|
80
82
|
modBus.hasHandlers("classic.PreToolUse") ||
|
|
83
|
+
inheritedInstallations.length > 0 ||
|
|
81
84
|
egressTools.size > 0 ||
|
|
82
85
|
irreversibleTools.size > 0 ||
|
|
83
86
|
spec.enablePlanMode === true ||
|
|
@@ -117,7 +120,7 @@ export function prepareGateStations(input) {
|
|
|
117
120
|
identity: hookIdentity,
|
|
118
121
|
reminderMark,
|
|
119
122
|
modBus,
|
|
120
|
-
...(
|
|
123
|
+
...(inheritedInstallations.length > 0 ? { inheritedInstallations } : {}),
|
|
121
124
|
observedPermissionMode: () => permissionMode.observed,
|
|
122
125
|
...(handsCwdRef !== undefined ? { trackedCwd: () => handsCwdRef.current } : {}),
|
|
123
126
|
...(stampCallTarget !== undefined ? { stampCallTarget } : {}),
|
|
@@ -251,7 +254,7 @@ export function prepareGateStations(input) {
|
|
|
251
254
|
});
|
|
252
255
|
}
|
|
253
256
|
}
|
|
254
|
-
const toolResultStation = createToolResultStation({ modBus, blockedToolCalls, toolRosterDeltas, preToolContexts, abortController, spec, handsCwdRef, hookEnvFace, hookIdentity, permissionMode, reminderMark, frameSettlement });
|
|
257
|
+
const toolResultStation = createToolResultStation({ modBus, blockedToolCalls, toolRosterDeltas, preToolContexts, inheritedScreens: inheritedInstallations.length > 0, abortController, spec, handsCwdRef, hookEnvFace, hookIdentity, permissionMode, reminderMark, frameSettlement });
|
|
255
258
|
if (toolResultStation !== undefined)
|
|
256
259
|
harness.on("tool_result", toolResultStation);
|
|
257
260
|
const approvedCallScreen = createApprovedCallScreen({ modBus, permissionMode, abortController, handsCwdRef, hookEnvFace, hookIdentity, preToolContexts });
|
|
@@ -56,6 +56,8 @@ export interface PrepareHandsReadFaceInput {
|
|
|
56
56
|
/** borrowed-readonly — the acquired session's id, for error/notice tags and the band's session
|
|
57
57
|
* registration. */
|
|
58
58
|
sessionId: string;
|
|
59
|
+
/** borrowed-readonly — this run's id, carried on the byte-floor notice (once per run). */
|
|
60
|
+
runId: string;
|
|
59
61
|
/** borrowed-readonly — the host task id: trace frames + the band's task-registry owner. */
|
|
60
62
|
hostTaskId: string;
|
|
61
63
|
/** borrowed-readonly — the registry scope (`internals?.registryScope ?? spec.principal ??
|
|
@@ -98,7 +100,7 @@ export interface PrepareHandsReadFaceInput {
|
|
|
98
100
|
* object (R-4: `deps.onError?.()` keeps its receiver; a new deps read must widen this Pick).
|
|
99
101
|
* `readDenyBuiltinTiers`/`readDenyBuiltinExclude` are SNAPSHOTTED before the first await that
|
|
100
102
|
* precedes the toolkit compile (the caller retains these arrays by reference). */
|
|
101
|
-
deps: Pick<RunnerDeps, "onError" | "onNotice" | "tracer" | "readDenyPatterns" | "readDenyBuiltinTiers" | "readDenyBuiltinExclude" | "agentConfigDir" | "readFace" | "writeFace" | "permissionRuleStore" | "hands">;
|
|
103
|
+
deps: Pick<RunnerDeps, "onError" | "onNotice" | "tracer" | "readDenyPatterns" | "readDenyBuiltinTiers" | "readDenyBuiltinExclude" | "readDenyFloorRequired" | "agentConfigDir" | "readFace" | "writeFace" | "permissionRuleStore" | "hands" | "imageProcessor">;
|
|
102
104
|
/** borrowed-readonly — the trusted spawn-side seats the band forwards: the finished-command
|
|
103
105
|
* notification lane, the mid-flight detach hub, and the Runner's per-session
|
|
104
106
|
* read-state seats and their restore channel (absent on a standalone prepare ⇒ the transcript-replay rung
|
|
@@ -208,7 +210,7 @@ export interface PrepareHandsReadFaceResult {
|
|
|
208
210
|
/** owned — the wsSnapshot path rebaser (identity when no snapshot / same root); the G4 worktree
|
|
209
211
|
* seed applies it to the snapshot's worktree paths. */
|
|
210
212
|
rebaseWsPath: (p: string) => string;
|
|
211
|
-
/** owned — real shell + write hands + background-capable env: gates the driver's
|
|
213
|
+
/** owned — real shell + write hands + background-capable env: gates the driver's
|
|
212
214
|
* TaskStop/Monitor/SendMessage mounts (P11) and the Monitor arm of the shellGate fold here. */
|
|
213
215
|
backgroundTaskToolsActive: boolean;
|
|
214
216
|
/** owned — this run's READ STATIONS as the one gate input (`ToolGateInput.shellReadCheck`): the shell's (ONE judgment of
|
|
@@ -220,9 +222,9 @@ export interface PrepareHandsReadFaceResult {
|
|
|
220
222
|
/** owned — the same station's pre-spawn ADMISSION, published for the P11 face that spawns a shell command
|
|
221
223
|
* and mounts LATER than the band (`Monitor`): the SAME function the band's shell faces got. ⇔ a real shell. */
|
|
222
224
|
shellReadAdmission: ShellReadAdmission | undefined;
|
|
223
|
-
/** owned — the byte floor's seat over the run's read-deny
|
|
224
|
-
*
|
|
225
|
-
|
|
225
|
+
/** owned — the byte floor's seat over the run's read-deny tables (read-floor.ts): every start the run makes reads its floor
|
|
226
|
+
* through it, at the start — a call's own pinned table, else the run's base table. ⇔ the run compiled tables (hands). */
|
|
227
|
+
runReadFloor: ReadFloorSeat | undefined;
|
|
226
228
|
/** owned — the same station's landings of a judged call (`ShellReadStation.landings`): the park binds them, the resumed leg's execution station compares. ⇔ a real shell. */
|
|
227
229
|
shellReadLandings: ShellReadLandings | undefined;
|
|
228
230
|
/** owned — the file read station's admission (`FileReadStation.admitted`) the band's read tools got, for the read tools mounted later (LSP). */
|
|
@@ -285,7 +287,7 @@ export interface PrepareHandsReadFaceResult {
|
|
|
285
287
|
* mounts (Monitor, the worktree pair — the SAME Set identity, mutated at those mount sites).
|
|
286
288
|
* Consumed by the O9a external-content-target fold: these are the tools whose RESULTS are the
|
|
287
289
|
* target's bytes, so membership must be what actually mounted on the env — never a static table
|
|
288
|
-
* (the wake/resume reconciliation table lists
|
|
290
|
+
* (the wake/resume reconciliation table lists TaskStop, which is orchestration, and
|
|
289
291
|
* misses Monitor/worktree, which are hands — both directions wrong for this consumer). Empty on
|
|
290
292
|
* a hands-less leg (nothing mounts on the env; the driver's env mounts are hands-gated too). */
|
|
291
293
|
envHandToolNames: Set<string>;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { emitTrace } from "../trace.js";
|
|
2
|
-
import {
|
|
2
|
+
import { performsIo } from "../remote-env.js";
|
|
3
3
|
import { hasBackgroundShell } from "../background-shell.js";
|
|
4
4
|
import { defaultTaskRegistry } from "../task-registry.js";
|
|
5
5
|
import { bashReversibilityProbe, activeReadDenyBuiltinTiers, readDenyBuiltinConfigOf, compileReadDeny, createHandsToolkit, deploymentFaceClampNotice, pdfModelCapabilitiesOf, inheritSessionReadFileState, backgroundOutputReadExemption, resolveContainmentFace, seedReadFileStateFromContext, seedReadFileStateFromTranscript, } from "../../tools/fs/index.js";
|
|
@@ -9,7 +9,7 @@ import { carryReadFace } from "../../tools/fs/read-deny-home.js";
|
|
|
9
9
|
import { EMPTY_READ_ROOTS, afterCallTables, denySeatsOf, onPinnedRead, pathTablesCompile, readRootsOver } from "./person-path-rows.js";
|
|
10
10
|
import { createShellOverflowSpoolFence } from "../../tools/fs/fs-shared.js";
|
|
11
11
|
import { createShellReadStation } from "../../tools/fs/shell-read-check.js";
|
|
12
|
-
import { readFloorSeat } from "../../tools/fs/read-floor.js";
|
|
12
|
+
import { judgeReadFloorKept, readFloorSeat } from "../../tools/fs/read-floor.js";
|
|
13
13
|
import { createFileReadStation } from "../../tools/fs/file-read-check.js";
|
|
14
14
|
import { isShellFaceToolName, predictMountedToolNames, readTargetToolNames } from "../tool-registry.js";
|
|
15
15
|
import { normalizeFileText } from "../../tools/fs/encoding.js";
|
|
@@ -20,7 +20,7 @@ import { sessionSeatAnchorHolds } from "./session-read-file-states.js";
|
|
|
20
20
|
import { rebaseWorkspacePath } from "./workspace-path.js";
|
|
21
21
|
import { RosterBuilder } from "../tool-roster.js";
|
|
22
22
|
import { unionAddOnly } from "../child-clamp-seats.js";
|
|
23
|
-
import { assertStringArraySeat } from "../read-face-seats.js";
|
|
23
|
+
import { assertStringArraySeat, screenReadDenySeat } from "../read-face-seats.js";
|
|
24
24
|
import { modePolicyOf } from "../mode-policy.js";
|
|
25
25
|
import { valveLeaves } from "../../agents/tool-filter.js";
|
|
26
26
|
const faceClampAnnouncedSinks = { read: new WeakSet(), write: new WeakSet() };
|
|
@@ -87,7 +87,7 @@ export function resolveHandsLessReadFace(input) {
|
|
|
87
87
|
shellReadCheck: undefined,
|
|
88
88
|
shellReadStationArmed: false,
|
|
89
89
|
shellReadAdmission: undefined,
|
|
90
|
-
|
|
90
|
+
runReadFloor: undefined,
|
|
91
91
|
shellReadLandings: undefined,
|
|
92
92
|
readAdmission: undefined,
|
|
93
93
|
resolvedReadFace: undefined,
|
|
@@ -124,7 +124,7 @@ export async function prepareHandsMount(input) {
|
|
|
124
124
|
let rebaseWsPath = (p) => p;
|
|
125
125
|
let backgroundTaskToolsActive = false;
|
|
126
126
|
let shellReadStation;
|
|
127
|
-
let
|
|
127
|
+
let runReadFloor;
|
|
128
128
|
let shellReadTools = new Set();
|
|
129
129
|
let fileReadStation;
|
|
130
130
|
let resolvedReadFace;
|
|
@@ -191,7 +191,7 @@ export async function prepareHandsMount(input) {
|
|
|
191
191
|
seedReadFileStateFromContext(readFileState, rk.key, f.content);
|
|
192
192
|
}
|
|
193
193
|
};
|
|
194
|
-
const handsIncludeShell =
|
|
194
|
+
const handsIncludeShell = performsIo(executionEnv) === true;
|
|
195
195
|
const handsReadOnly = spec.handsReadOnly === true;
|
|
196
196
|
backgroundTaskToolsActive = handsIncludeShell && !handsReadOnly && hasBackgroundShell(executionEnv);
|
|
197
197
|
const shellFaceHere = [...predictMountedToolNames(new Set(backgroundTaskToolsActive ? ["hands", "backgroundTasks"] : ["hands"]))].filter(isShellFaceToolName);
|
|
@@ -214,8 +214,17 @@ export async function prepareHandsMount(input) {
|
|
|
214
214
|
const readDenyBuiltinCfg = readDenyBuiltinConfigOf({ tiers: deps.readDenyBuiltinTiers, exclude: deps.readDenyBuiltinExclude });
|
|
215
215
|
const canonicalize = async (dirs) => { const out = []; for (const d of dirs)
|
|
216
216
|
await canonicalizeExtraDirs([d], "persistedReadRule", out).catch((err) => deps.onError?.(new Error(`persistedReadRule entry skipped (its lookup threw): ${d}: ${thrownText(err)}`), { phase: "config", sessionId })); return out; };
|
|
217
|
-
const
|
|
217
|
+
const floorRequired = screenReadDenySeat("readDenyFloorRequired", deps.readDenyFloorRequired) === true;
|
|
218
|
+
const floorSaid = { done: false };
|
|
219
|
+
const compileRunTables = pathTablesCompile({ env: executionEnv, additions: readDenyAdditions, builtin: readDenyBuiltinCfg, legRows: input.denyRuleRows, leads: input.headLeads, configRoot: deps.agentConfigDir, canonicalize });
|
|
220
|
+
const judgedRunTables = async (person) => {
|
|
221
|
+
const compiled = await compileRunTables(person);
|
|
222
|
+
judgeReadFloorKept({ env: executionEnv, table: compiled.readDeny, floor: readFloorSeat(compiled.readDeny)?.(undefined), required: floorRequired, onNotice: deps.onNotice, attribution: { sessionId, runId: input.runId }, said: floorSaid });
|
|
223
|
+
return compiled;
|
|
224
|
+
};
|
|
225
|
+
const tables = (pathTables = await input.personRows.attachTables(judgedRunTables));
|
|
218
226
|
readDenyMatcher = tables.readDeny;
|
|
227
|
+
runReadFloor = readFloorSeat(tables.readDeny);
|
|
219
228
|
readRoots = readRootsOver({ own: () => [...additionalRootsCanonical, ...additionalReadRootsCanonical], tables, ready: input.personRows.tablesReady, store: () => artifactStoreRef.current,
|
|
220
229
|
onHeld: (entry, store) => emitTrace(deps.tracer, () => ({ kind: "config.additional_directory_skipped", version: 1, taskId: hostTaskId, entry, field: "persistedReadRule", reason: `admits_artifact_store: the local artifact store ${store} lies inside it or it inside the store — the Artifact tool's ledger and stored files stay outside every root the file tools reach`, ts: Date.now() })) });
|
|
221
230
|
readDenyBuiltinTiersActive = activeReadDenyBuiltinTiers(readDenyBuiltinCfg);
|
|
@@ -314,7 +323,6 @@ export async function prepareHandsMount(input) {
|
|
|
314
323
|
return { roots: [rootCanonical, ...readRoots.forCall(toolCallId)()], cwd: rootCanonical, ...denySeat, ...writeDenySeat, ...(input.personRows.unreadFor(toolCallId) ? { unreadPartitions: true } : {}), alsoInside: spoolFence };
|
|
315
324
|
};
|
|
316
325
|
shellReadTools = new Set(shellFaceHere);
|
|
317
|
-
shellReadFloor = readFloorSeat(tables.readDeny);
|
|
318
326
|
shellReadStation = createShellReadStation({
|
|
319
327
|
env: executionEnv,
|
|
320
328
|
tools: shellReadTools,
|
|
@@ -368,7 +376,7 @@ export async function prepareHandsMount(input) {
|
|
|
368
376
|
pdfModelCapabilities: pdfModelCapabilitiesOf(model),
|
|
369
377
|
...(deps.hands?.bashReadonlyAllow !== undefined ? { bashReadonlyAllow: deps.hands.bashReadonlyAllow } : {}),
|
|
370
378
|
...(deps.hands?.commitCoAuthor !== undefined ? { commitCoAuthor: deps.hands.commitCoAuthor } : {}),
|
|
371
|
-
...(deps.
|
|
379
|
+
...(deps.imageProcessor !== undefined ? { imageProcessor: deps.imageProcessor } : {}),
|
|
372
380
|
...(deps.hands?.autoBackgroundOnTimeout !== undefined ? { autoBackgroundOnTimeout: deps.hands.autoBackgroundOnTimeout } : {}),
|
|
373
381
|
beforeWrite: async (w) => {
|
|
374
382
|
const deploymentGate = deps.hands?.beforeWrite;
|
|
@@ -392,7 +400,7 @@ export async function prepareHandsMount(input) {
|
|
|
392
400
|
}
|
|
393
401
|
roster.mountAll(band.map((t) => (envHandToolNames.add(t.name), firstPartyOffload(afterCallTables(input.personRows, t)))), { source: "builtin", mountedBy: "hands" });
|
|
394
402
|
const shellFloor = effectiveShellGate;
|
|
395
|
-
if (
|
|
403
|
+
if (handsIncludeShell && spec.handsReadOnly !== true) {
|
|
396
404
|
const installShellSeat = (name) => {
|
|
397
405
|
const tierBefore = irreversibilityTier.get(name);
|
|
398
406
|
const seatOwned = !egressTools.has(name) && tierBefore !== "always" && tierBefore !== "maybe";
|
|
@@ -419,7 +427,7 @@ export async function prepareHandsMount(input) {
|
|
|
419
427
|
shellReadCheck: onPinnedRead(input.personRows, [...(shellReadStation !== undefined ? [{ check: shellReadStation.check, tools: shellReadTools }] : []), ...(fileReadStation !== undefined ? [fileReadStation] : [])]),
|
|
420
428
|
shellReadStationArmed: shellReadStation !== undefined,
|
|
421
429
|
shellReadAdmission: shellReadStation?.admit,
|
|
422
|
-
|
|
430
|
+
runReadFloor,
|
|
423
431
|
shellReadLandings: shellReadStation?.landings,
|
|
424
432
|
readAdmission: fileReadStation?.admitted,
|
|
425
433
|
resolvedReadFace,
|
|
@@ -37,7 +37,6 @@ import type { AutoModeArmingRecipe } from "../auto-mode-arming.js";
|
|
|
37
37
|
import type { AutoModeDecider, AutoModeDenialTracker } from "../auto-mode.js";
|
|
38
38
|
import { type OnQuestion } from "../ask-question.js";
|
|
39
39
|
import { type ParentSpecSeat } from "../parent-spec-seat.js";
|
|
40
|
-
import { type HookEnvCapabilities } from "../hooks.js";
|
|
41
40
|
import { type LegModBus, type ModChainLink } from "../mods/stations.js";
|
|
42
41
|
import { type ChildClampSource } from "../child-clamp-seats.js";
|
|
43
42
|
import type { LockedPreflight } from "../locked-config.js";
|
|
@@ -45,6 +44,7 @@ import type { OwnOrgAdmissionVerdict } from "../memory-admission.js";
|
|
|
45
44
|
import type { DelegationContentSafety } from "../memory-engine/delegation-provenance.js";
|
|
46
45
|
import type { SessionPermissionRules } from "../session-policy-store.js";
|
|
47
46
|
import type { SessionStore } from "../session.js";
|
|
47
|
+
import { type PlacementTarget } from "../remote-env.js";
|
|
48
48
|
import { type OnAsk, type ToolPolicy } from "../tool-policy.js";
|
|
49
49
|
import type { PathRuleBases } from "../permission-rule-model.js";
|
|
50
50
|
import type { PermissionMode, RunnerDeps, RuntimeCaps, ShellGateDoctrine, TaskEvent, TaskSpec, ToolExecuteContext, ToolSpec } from "../types.js";
|
|
@@ -92,6 +92,9 @@ export interface PrepareInheritedGateInput {
|
|
|
92
92
|
hostTaskId: string;
|
|
93
93
|
/** borrowed-readonly — the SETTLED task root (`ctx.parentCwd`). */
|
|
94
94
|
taskRootFinal: string;
|
|
95
|
+
/** borrowed-readonly — the target this leg's env reported as its workspace settled (`ctx.placementTarget`: the fence of
|
|
96
|
+
* every agent the delegation tools spawn or wake from this leg); absent when it reported none. */
|
|
97
|
+
ownTarget: PlacementTarget | undefined;
|
|
95
98
|
/** borrowed-readonly — the run's resolved env: the full-shell predicate's kind test and the hook-env identity value. */
|
|
96
99
|
executionEnv: ExecutionEnv;
|
|
97
100
|
/** borrowed-readonly — the per-task owned env when a factory minted one (the hook-env identity predicate reads presence). */
|
|
@@ -134,6 +137,8 @@ export interface PrepareInheritedGateInput {
|
|
|
134
137
|
forwardEvent: ((e: TaskEvent) => void) | undefined;
|
|
135
138
|
/** borrowed-readonly — the retain ledger (ctx seat; absent ⇒ no key). */
|
|
136
139
|
subagentRetain: SubagentRetainLedger | undefined;
|
|
140
|
+
/** borrowed-readonly — where a background task's cut result is stored (ctx seat `taskArtifacts`; absent ⇒ no key). */
|
|
141
|
+
taskArtifacts: import("../tool-result-store.js").TaskArtifactSeat | undefined;
|
|
137
142
|
/** borrowed-readonly — the worktree-isolation helper (ctx seat; absent ⇒ no key). */
|
|
138
143
|
worktreeIsolation: SubagentWorktreeIsolation | undefined;
|
|
139
144
|
/** borrowed-readonly — the three run-ref primitives the ctx exposes (plan mode only under `enablePlanMode`). */
|
|
@@ -161,12 +166,10 @@ export interface PrepareInheritedGateInput {
|
|
|
161
166
|
* `inheritedGateForChildren` (the two mandate tests), at spawn time. */
|
|
162
167
|
runtimeCaps: () => RuntimeCaps | undefined;
|
|
163
168
|
/** borrowed-readonly — what the leg hands its descendants of its mods bus (`LegMods.handedDown`: without the skills' own
|
|
164
|
-
* registrations): the chain assembly
|
|
169
|
+
* registrations): the chain assembly hands it down as this leg's screening installation. */
|
|
165
170
|
modBus: LegModBus;
|
|
166
171
|
/** borrowed-readonly — this leg's chain identity as its admission recorded it (`chainOfBus`) — the installation identity's chain term. */
|
|
167
172
|
ownModChain: readonly ModChainLink[];
|
|
168
|
-
/** borrowed-readonly — LATE-BOUND: the hook-env capability face the screening-face entry's policy resolves paths in. */
|
|
169
|
-
hookEnvFace: () => HookEnvCapabilities | undefined;
|
|
170
173
|
/** borrowed-readonly — LATE-BOUND: the armed classifier (undefined = not armed), read where the chain freezes it onto both
|
|
171
174
|
* entries and where the ctx exposes the spawn-review seat. */
|
|
172
175
|
autoModeDecider: () => AutoModeDecider | undefined;
|
|
@@ -176,6 +179,10 @@ export interface PrepareInheritedGateInput {
|
|
|
176
179
|
autoModeArming: () => AutoModeArmingRecipe | undefined;
|
|
177
180
|
/** borrowed-readonly — LATE-BOUND: the fork-governance verdict (ctx `forkAccess`, present only when denied). */
|
|
178
181
|
agentForkDenial: () => ReturnType<typeof forkGovernanceDenial>;
|
|
182
|
+
/** borrowed-readonly — LATE-BOUND: the leg's agent stations (ctx `agentStations`; bound once the leg's identity is known). */
|
|
183
|
+
agentStations: () => import("../mods/agent-stations.js").AgentStations | undefined;
|
|
184
|
+
/** borrowed-readonly — LATE-BOUND: the leg's `session.send` station (ctx `sendStation`; bound once the leg's identity is known). */
|
|
185
|
+
sendStation: () => import("../mods/session-send.js").SendStation | undefined;
|
|
179
186
|
/** borrowed-readonly — LATE-BOUND: the observers grant (ctx `observersAllowed`, present only when explicitly granted). */
|
|
180
187
|
observersActive: () => boolean;
|
|
181
188
|
/** borrowed-readonly — LATE-BOUND: the hands mount's resolved read face (undefined until/unless hands mount). */
|