@sema-agent/core 7.60.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 +605 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- 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 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- 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.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- 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 +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/brain/anthropic.js +1 -0
- 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/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- 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.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- 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/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- 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 +49 -18
- 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 +10 -0
- package/dist/core/frame-settlement.js +6 -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 +2 -1
- package/dist/core/gate-lanes.js +7 -4
- 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 +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -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 +2 -1
- package/dist/core/locked-config.js +5 -3
- 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-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +220 -46
- package/dist/core/mcp-probe.js +2 -2
- 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 +2 -1
- 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 +6 -49
- package/dist/core/mcp.js +115 -111
- 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-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- 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/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/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- 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 +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- 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/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 +38 -16
- package/dist/core/mods/stations.js +25 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +61 -2
- package/dist/core/own-property-receipt.js +42 -2
- package/dist/core/park-selfcheck.js +4 -2
- 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 +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- 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/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- 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/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -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 -3
- package/dist/core/runner/assemble-result.js +12 -7
- 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/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 +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- 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/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- 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/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 +28 -9
- 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 +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- 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 +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- 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-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -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 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +56 -28
- 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-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- 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-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 +2 -0
- package/dist/core/runner/run-git-lane.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +40 -29
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +9 -7
- 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 +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- 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/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/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 -2
- 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-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- 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 +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- 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 +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- 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 +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +2 -0
- package/dist/core/session-store.js +5 -7
- 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.js +1 -1
- 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 +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- 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 +10 -10
- 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 +2 -5
- 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.js +3 -2
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- 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 +108 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/user-attachment.js +26 -21
- 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 +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +41 -7
- 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 +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- 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 +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- 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 +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- 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.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- 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.js +3 -2
- package/dist/stores/file/session-store.d.ts +16 -3
- package/dist/stores/file/session-store.js +21 -20
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -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/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- 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 +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- 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 +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -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
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
import { REFUSES_NO_WHOLE_TOOL, TOOL_TABLE_VIEW_READ, toolPolicyWholeToolRefusals } from "../tool-policy.js";
|
|
1
2
|
import { persistedRuleMandateOf, ruleClearanceOf } from "../ask-origin.js";
|
|
2
3
|
import {} from "../hooks.js";
|
|
3
|
-
import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText,
|
|
4
|
+
import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, ruleWordsOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
|
|
4
5
|
import { callHostTargetOf } from "../host-target.js";
|
|
5
6
|
import { callTargetViewsOf, validatePath } from "../effective-path-target.js";
|
|
6
7
|
import { bindPathRules, persistedRowAnchors, projectScopeIdentity } from "../path-rule-binding.js";
|
|
@@ -54,9 +55,10 @@ export function pathRuleLaneAnswer(table, req, ctx) {
|
|
|
54
55
|
return persistedRuleAnswerOf(adjudicatePersistedPathRules(table, { tool: req.toolName, cwd: ctx.root, sessionId: ctx.sessionId, face: callPathFaceOf(req), ...(ctx.scopeIdentity !== undefined ? { scopeIdentity: ctx.scopeIdentity } : {}) }, { ...(tighten !== undefined ? { tighten } : {}), ...(allow !== undefined ? { allow } : {}) }, ctx.anchorsOf, ctx.leads));
|
|
55
56
|
}
|
|
56
57
|
export function orgRuleLane(cfg) {
|
|
58
|
+
const questionToolExempt = (call) => wireOf("offer.orgQuestionExemption", call) === cfg.questionToolName && cfg.questionToolMounted;
|
|
57
59
|
return {
|
|
58
60
|
adjudicate: async (req) => {
|
|
59
|
-
if (
|
|
61
|
+
if (questionToolExempt(req))
|
|
60
62
|
return { status: "available" };
|
|
61
63
|
let resolution;
|
|
62
64
|
try {
|
|
@@ -73,13 +75,19 @@ export function orgRuleLane(cfg) {
|
|
|
73
75
|
return { status: "unavailable", disclosures: [`the store's org resolution cannot be read (${reading.refused}) — unreadable governance, never an empty one`] };
|
|
74
76
|
const command = req.args?.command;
|
|
75
77
|
const face = callPathFaceOf(req);
|
|
76
|
-
const verdict = reading.verdictFor({ tool:
|
|
78
|
+
const verdict = reading.verdictFor({ tool: ruleWordsOf(req, "deny"), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
|
|
77
79
|
const revisionCell = orgRevisionEvidenceOf(resolution, cfg.onRevisionDefect);
|
|
78
80
|
const degraded = describeUnreadableOrgRows(reading.unreadable, revisionCell.revision);
|
|
79
81
|
if (degraded !== undefined)
|
|
80
82
|
cfg.onDegraded(degraded);
|
|
81
83
|
return verdict === undefined ? { status: "available", ...revisionCell } : { status: "available", verdict, ...revisionCell };
|
|
82
84
|
},
|
|
85
|
+
refusesWholeOver: (resolution) => {
|
|
86
|
+
const reading = resolution.status === "unavailable" || resolution.status === "ungoverned" ? undefined : readOrgRules(resolution.rules);
|
|
87
|
+
if (reading === undefined || "refused" in reading)
|
|
88
|
+
return REFUSES_NO_WHOLE_TOOL;
|
|
89
|
+
return (tool) => !questionToolExempt(tool) && reading.verdictFor({ tool: ruleWordsOf(tool, "deny"), face: callPathFaceOf({ ...tool, args: undefined }) })?.behavior === "deny";
|
|
90
|
+
},
|
|
83
91
|
};
|
|
84
92
|
}
|
|
85
93
|
export function orgVerdictBeforeClaim(cfg, req) {
|
|
@@ -106,7 +114,7 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
106
114
|
}
|
|
107
115
|
}
|
|
108
116
|
if (provider === undefined)
|
|
109
|
-
return { personal: undefined, org: undefined };
|
|
117
|
+
return { personal: undefined, org: undefined, wholeToolRefusals: undefined };
|
|
110
118
|
const anonymous = readPrincipal(cfg.principal).kind === "absent";
|
|
111
119
|
const reader = cfg.rows;
|
|
112
120
|
const orgViewOf = async (toolCallId, judged) => {
|
|
@@ -119,9 +127,9 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
119
127
|
const personalAdjudicate = async (req) => {
|
|
120
128
|
if (anonymous && !cfg.localOwnerDeclared)
|
|
121
129
|
return undefined;
|
|
122
|
-
const judged =
|
|
123
|
-
if (!judged.some(([, g]) => g === "path") && faceRowsSpeakFor(callPathFaceOf(req)))
|
|
124
|
-
judged.push([req.toolName, "path"]);
|
|
130
|
+
const judged = ruleWordsOf(req, "deny").map((n) => [n, ruleToolGrammarOf(n), ruleWordsOf(req, "allow").includes(n)]);
|
|
131
|
+
if (!judged.some(([, g, grants]) => g === "path" && grants) && faceRowsSpeakFor(callPathFaceOf(req)))
|
|
132
|
+
judged.push([req.toolName, "path", true]);
|
|
125
133
|
const view = await reader.pin(req.toolCallId, req.args);
|
|
126
134
|
const ownRow = (r) => judged.some(([n]) => n === r.tool) || wholeToolRuleReaches(r.tool, req, r.behavior);
|
|
127
135
|
if (judged.length === 0 && !view.rules.some(ownRow))
|
|
@@ -139,7 +147,7 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
139
147
|
const leads = judgesPath ? await cfg.leads.resolve(bindPathRules(table.filter((r) => r.match === "path" || r.match === "subpath").map((r) => ({ parsed: r, ruleText: r.rule, rule: r })), (spec) => anchorsOf(spec.rule))) : NO_LEADS;
|
|
140
148
|
const scopeIdentity = await projectScopeIdentity(table, cfg.rootCanonical, cfg.leads);
|
|
141
149
|
const wholeTool = persistedRuleAnswerOf(adjudicatePersistedToolRules(table, { request: req, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }));
|
|
142
|
-
const judgedAnswer = strongestAnswer([...judged.map(([n, grammar]) => judgeAgainst(table, { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
|
|
150
|
+
const judgedAnswer = strongestAnswer([...judged.map(([n, grammar, grants]) => judgeAgainst(grants ? table : table.filter((r) => r.behavior !== "allow"), { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
|
|
143
151
|
const unjudged = noRule.find(({ row }) => (row.behavior === "deny" || row.behavior === "ask") && eligiblePersisted(row, { tool: row.tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }, row.behavior));
|
|
144
152
|
const answer = unjudged !== undefined && !(judgedAnswer !== undefined && "behavior" in judgedAnswer && judgedAnswer.behavior === "deny") ? unjudgedRowAnswer(unjudged.row, unjudged.why, req.toolName) : judgedAnswer;
|
|
145
153
|
const stands = answer !== undefined && (("behavior" in answer && answer.behavior === "deny") || "unreadable" in answer);
|
|
@@ -176,8 +184,19 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
176
184
|
const coverage = segmentCoverageOf(command, { persisted: table }, { tool: req.toolName, cwd: cfg.root, sessionId: cfg.sessionId, ...execCwd, ...scope });
|
|
177
185
|
return coverage !== undefined ? { segmentCoverage: coverage } : undefined;
|
|
178
186
|
};
|
|
187
|
+
const personalRefusesWholeOver = async (rules) => {
|
|
188
|
+
const deny = anonymous && !cfg.localOwnerDeclared ? [] : rules.filter((r) => r.behavior === "deny" && r.match === "tool");
|
|
189
|
+
const scopeIdentity = deny.length === 0 ? undefined : await projectScopeIdentity(deny, cfg.rootCanonical, cfg.leads);
|
|
190
|
+
return deny.length === 0 ? REFUSES_NO_WHOLE_TOOL : (tool) => !routesContent(tool.face) && adjudicatePersistedToolRules(deny, { request: tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) })?.behavior === "deny";
|
|
191
|
+
};
|
|
179
192
|
const personal = provider.partitions.durable ? { adjudicate: personalAdjudicate } : undefined;
|
|
180
|
-
|
|
193
|
+
let inFlight;
|
|
194
|
+
const viewRead = () => (inFlight ??= reader.pin(TOOL_TABLE_VIEW_READ).finally(() => (inFlight = undefined)));
|
|
195
|
+
const wholeToolRefusals = toolPolicyWholeToolRefusals([
|
|
196
|
+
personal !== undefined ? { wholeToolRefusals: async () => personalRefusesWholeOver((await viewRead()).rules) } : undefined,
|
|
197
|
+
org !== undefined ? { wholeToolRefusals: async () => ((read) => (read.org !== undefined ? org.refusesWholeOver(read.org) : REFUSES_NO_WHOLE_TOOL))(await viewRead()) } : undefined,
|
|
198
|
+
]);
|
|
199
|
+
return { personal, org, wholeToolRefusals };
|
|
181
200
|
}
|
|
182
201
|
export function createRuleOffersOf(cfg) {
|
|
183
202
|
return (call, args, ask) => {
|
|
@@ -271,7 +271,7 @@ export function createPersonPathRows(cfg) {
|
|
|
271
271
|
unexcludableUnder: (scope) => judging().readDeny.unexcludableUnder?.(scope) ?? false,
|
|
272
272
|
rowUnderRoot: (scope) => judging().readDeny.rowUnderRoot?.(scope) ?? null,
|
|
273
273
|
rowAtOrBelow: (path) => judging().readDeny.rowAtOrBelow?.(path) ?? null,
|
|
274
|
-
forCall: (id) => tablesFor(id).readDeny,
|
|
274
|
+
forCall: (id) => (id === undefined ? judging() : tablesFor(id)).readDeny,
|
|
275
275
|
});
|
|
276
276
|
const writeDeny = {
|
|
277
277
|
face: "write",
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The placement fence's two engine readings (the seat and its contract: `ExecutionEnvFactoryContext.placementTarget`,
|
|
3
|
+
* remote-env.ts): the MINT folds a leg's fence once, and the SETTLE POINT reads the leg's own target once — which is
|
|
4
|
+
* also every fenced leg's receipt (a restore takes the same receipt earlier as well, against the env before and the
|
|
5
|
+
* handle after `resumeVM`, in prepare-workspace-restore.ts).
|
|
6
|
+
*/
|
|
7
|
+
import { type PlacementTarget, type WorkspaceHandle } from "../remote-env.js";
|
|
8
|
+
import type { ExecutionEnv } from "../../internal/harness.js";
|
|
9
|
+
/**
|
|
10
|
+
* The fence a leg is minted under, from its two sources: the target its checkpoint row recorded (a durable resume leg)
|
|
11
|
+
* and the one its trusted internals carry (the leg that handed it work). Member by member — a member the row states
|
|
12
|
+
* wins, a member it does not state is the internals' (a row recorded before `deviceId` existed takes the waking leg's
|
|
13
|
+
* device) — so neither source replaces the other whole. `undefined` when neither names a provider. A handed value the
|
|
14
|
+
* engine cannot read as a target (no non-empty string `provider`, a `deviceId` that is not a string) is refused loudly
|
|
15
|
+
* rather than read as "no fence", which would place the leg wherever the current binding points.
|
|
16
|
+
*/
|
|
17
|
+
export declare function mintPlacementFence(row: WorkspaceHandle | undefined, handedValue: unknown): PlacementTarget | undefined;
|
|
18
|
+
/**
|
|
19
|
+
* The leg's OWN target, read once at its settle point (what its env reports, {@link reportedPlacementTarget}) — the fence
|
|
20
|
+
* of every leg it hands work to — and every fenced leg's receipt on that same reading: an env that does not name the
|
|
21
|
+
* device its fence names is refused before anything reports the workspace or runs on it. A leg that restored a
|
|
22
|
+
* checkpointed workspace (its restore took the receipt already, against the restored handle) is refused
|
|
23
|
+
* `resume.env_failed` here too — its env may have moved after the restore (re-initialization reconnecting elsewhere) —
|
|
24
|
+
* any other leg `config.placement_not_honored`.
|
|
25
|
+
*/
|
|
26
|
+
export declare function settleOwnTarget(env: ExecutionEnv | undefined, fence: PlacementTarget | undefined, restoredCheckpoint: boolean): PlacementTarget | undefined;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { placementHonored, placementTargetOf, reportedPlacementTarget } from "../remote-env.js";
|
|
2
|
+
export function mintPlacementFence(row, handedValue) {
|
|
3
|
+
const fromRow = row !== undefined ? placementTargetOf(row) : undefined;
|
|
4
|
+
const handed = handedFence(handedValue);
|
|
5
|
+
const provider = fromRow?.provider ?? handed?.provider;
|
|
6
|
+
if (provider === undefined)
|
|
7
|
+
return undefined;
|
|
8
|
+
const deviceId = fromRow?.deviceId ?? handed?.deviceId;
|
|
9
|
+
return Object.freeze(deviceId !== undefined ? { provider, deviceId } : { provider });
|
|
10
|
+
}
|
|
11
|
+
function handedFence(value) {
|
|
12
|
+
if (value === undefined)
|
|
13
|
+
return undefined;
|
|
14
|
+
const provider = typeof value === "object" && value !== null ? value.provider : undefined;
|
|
15
|
+
const deviceId = typeof value === "object" && value !== null ? value.deviceId : undefined;
|
|
16
|
+
if (typeof provider !== "string" || provider === "" || (deviceId !== undefined && typeof deviceId !== "string")) {
|
|
17
|
+
throw placementNotHonored("RunInternals.placementTarget cannot be read as a target (it needs a non-empty string `provider`, and a string `deviceId` when it names one) — a fence the engine cannot read cannot be honored; fix the lane that handed it instead of dropping it.");
|
|
18
|
+
}
|
|
19
|
+
return Object.freeze(deviceId !== undefined ? { provider, deviceId } : { provider });
|
|
20
|
+
}
|
|
21
|
+
export function settleOwnTarget(env, fence, restoredCheckpoint) {
|
|
22
|
+
const own = reportedPlacementTarget(env);
|
|
23
|
+
if (!placementHonored(fence, own)) {
|
|
24
|
+
const reported = own?.deviceId !== undefined ? `reports device "${own.deviceId}"` : "reports no device";
|
|
25
|
+
throw restoredCheckpoint
|
|
26
|
+
? refusal("resume.env_failed", `resume workspace identity mismatch: the placement fence names deviceId "${fence?.deviceId}" but the restored execution environment ${reported} once its workspace settled — refusing to continue on a different physical device`)
|
|
27
|
+
: refusal("config.placement_not_honored", `this agent's placement fence names device "${fence?.deviceId}" but its execution environment ${reported} — refusing to run it on another target than the one it was handed (the factory must mint on the fenced device or throw)`);
|
|
28
|
+
}
|
|
29
|
+
return own;
|
|
30
|
+
}
|
|
31
|
+
function placementNotHonored(message) {
|
|
32
|
+
return refusal("config.placement_not_honored", message);
|
|
33
|
+
}
|
|
34
|
+
function refusal(code, message) {
|
|
35
|
+
const e = new Error(message);
|
|
36
|
+
e.code = code;
|
|
37
|
+
return e;
|
|
38
|
+
}
|
|
@@ -3,8 +3,8 @@ import type { AgentTool } from "../../internal/harness.js";
|
|
|
3
3
|
import type { AdvertisedWritableDirs } from "./advertised-writable-dirs.js";
|
|
4
4
|
import type { AutoModeDenialTracker } from "../auto-mode.js";
|
|
5
5
|
import { type LegModBus } from "../mods/stations.js";
|
|
6
|
-
import { type OnAsk, type ToolCallRequest, type ToolPolicy } from "../tool-policy.js";
|
|
7
|
-
import type { RunnerDeps
|
|
6
|
+
import { type AskSourceIdentity, type OnAsk, type ToolCallRequest, type ToolPolicy } from "../tool-policy.js";
|
|
7
|
+
import type { RunnerDeps } from "../types.js";
|
|
8
8
|
import type { CwdRef } from "../../tools/fs/fs-shared.js";
|
|
9
9
|
import type { AskLane, Prepared } from "./contracts.js";
|
|
10
10
|
import { type GrantBindingOf } from "../skill-grant-binding.js";
|
|
@@ -60,14 +60,8 @@ export interface PrepareAskLaneInput {
|
|
|
60
60
|
ruleOffersOf: ReturnType<typeof createRuleOffersOf>;
|
|
61
61
|
/** borrowed-readonly — the policy-chain phase's Skill-card binding factory (`boundGrants` / `boundGrantDigest` on the ask). */
|
|
62
62
|
grantBindingOf: GrantBindingOf;
|
|
63
|
-
/** borrowed-readonly — the
|
|
64
|
-
|
|
65
|
-
principal?: string;
|
|
66
|
-
sourceTaskId?: string;
|
|
67
|
-
fromSubagent?: true;
|
|
68
|
-
sourceAgentName?: string;
|
|
69
|
-
isDelegatedChild?: true;
|
|
70
|
-
};
|
|
63
|
+
/** borrowed-readonly — the leg's one ask source (minted once by the driver; every ask mint site spreads it). */
|
|
64
|
+
askSource: AskSourceIdentity;
|
|
71
65
|
/** borrowed-readonly — the policy-chain phase's per-tool risk-axes projection (`riskAxes` on the ask). */
|
|
72
66
|
riskAxesOf: (call: Pick<ToolCallRequest, "toolName" | "face">) => {
|
|
73
67
|
riskAxes?: {
|
|
@@ -80,8 +74,8 @@ export interface PrepareAskLaneInput {
|
|
|
80
74
|
autoModeDenialTracking: {
|
|
81
75
|
readonly current: AutoModeDenialTracker | undefined;
|
|
82
76
|
};
|
|
83
|
-
/** borrowed-readonly — the
|
|
84
|
-
|
|
77
|
+
/** borrowed-readonly — the leg's own task id (`Prepared.taskId`; the late-settlement observer's tag). */
|
|
78
|
+
hostTaskId: string;
|
|
85
79
|
/** borrowed-readonly — the deployment seats this lane reports on, as a Pick over the SAME `deps` object (receiver
|
|
86
80
|
* preserved for `deps.onError?.()`): the late-settlement observer's notice/error sinks and the hook-crash notifier. */
|
|
87
81
|
deps: Pick<RunnerDeps, "onNotice" | "onError">;
|
|
@@ -55,7 +55,7 @@ function resolveApprovalPreview(tools, toolName, args) {
|
|
|
55
55
|
}
|
|
56
56
|
}
|
|
57
57
|
export function prepareAskLane(input) {
|
|
58
|
-
const { gateMachineryActive, abortController, effectivePolicy, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, advertisedWritableDirs, exemptRoots, tools, inheritedUnavailableAsks, inheritedAskGrants, onAsk, humanReviewRef, now, ruleOffersOf, grantBindingOf,
|
|
58
|
+
const { gateMachineryActive, abortController, effectivePolicy, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, advertisedWritableDirs, exemptRoots, tools, inheritedUnavailableAsks, inheritedAskGrants, onAsk, humanReviewRef, now, ruleOffersOf, grantBindingOf, askSource, riskAxesOf, autoModeDenialTracking, hostTaskId, deps, sessionId, runId, grantReadRoot, modBus, notifyOwnHookCrash } = input;
|
|
59
59
|
if (!gateMachineryActive)
|
|
60
60
|
return { askLane: undefined };
|
|
61
61
|
const composedCallSignal = (callSignal) => composeCallSignal(abortController.signal, callSignal);
|
|
@@ -106,7 +106,7 @@ export function prepareAskLane(input) {
|
|
|
106
106
|
...ruleOffersOf(req, req.args, decision.action === "ask" ? decision : undefined),
|
|
107
107
|
...grantBindingOf(req, req.args),
|
|
108
108
|
...cardDisclosureOf(decision, `approval required for "${req.toolName}"`),
|
|
109
|
-
...
|
|
109
|
+
...askSource,
|
|
110
110
|
...riskAxesOf(req),
|
|
111
111
|
...approvalCardMemberOf(req),
|
|
112
112
|
...requesterOf(modBus, req.toolCallId),
|
|
@@ -117,9 +117,9 @@ export function prepareAskLane(input) {
|
|
|
117
117
|
...(decision.action === "ask" && decision.probeCause !== undefined ? { probeCause: decision.probeCause } : {}),
|
|
118
118
|
...(decision.action === "ask" && decision.probeReadRootCandidate !== undefined ? { readRootCandidate: decision.probeReadRootCandidate } : {}),
|
|
119
119
|
...(decision.action === "ask" && decision.ruleEvidence !== undefined ? { ruleEvidence: decision.ruleEvidence } : {}),
|
|
120
|
-
}, onAsk, composedCallSignal(callSignal), lateAskSettlementObserver({ toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId,
|
|
120
|
+
}, onAsk, composedCallSignal(callSignal), lateAskSettlementObserver({ toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, onError: deps.onError }));
|
|
121
121
|
const waitMs = Math.max(0, now() - t0);
|
|
122
|
-
const granting = settleReadRootGrant(resolved.readRootGrant, grantReadRoot, { toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId,
|
|
122
|
+
const granting = settleReadRootGrant(resolved.readRootGrant, grantReadRoot, { toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, signal: composedCallSignal(callSignal) });
|
|
123
123
|
if (granting !== undefined)
|
|
124
124
|
await granting;
|
|
125
125
|
if (resolved.approverUnavailable !== true && attestationOf(resolved, req)?.settlement?.kind !== "task_aborted") {
|
|
@@ -19,6 +19,7 @@ import type { AgentHarness } from "../../internal/harness.js";
|
|
|
19
19
|
import { type CheckpointStore } from "../checkpoint-store.js";
|
|
20
20
|
import type { SessionStore } from "../session.js";
|
|
21
21
|
import type { RunnerDeps, TaskSpec } from "../types.js";
|
|
22
|
+
import type { AskSourceIdentity } from "../tool-policy.js";
|
|
22
23
|
import type { Prepared, SuspendSaga } from "./contracts.js";
|
|
23
24
|
export interface PrepareBoundaryParksInput {
|
|
24
25
|
/** borrowed-readonly — the suspend saga's eight seats (the serializer, the commit saga, the loop cap, the env split, the
|
|
@@ -48,8 +49,10 @@ export interface PrepareBoundaryParksInput {
|
|
|
48
49
|
session: Pick<Prepared["session"], "getLeafId">;
|
|
49
50
|
/** borrowed-readonly — the session store; only the optional `pin` is called (best-effort, after commit). */
|
|
50
51
|
sessions: Pick<SessionStore, "pin">;
|
|
51
|
-
/** borrowed-readonly — the acquired session id (the rows' session,
|
|
52
|
+
/** borrowed-readonly — the acquired session id (the rows' session, every disclosure's tag). */
|
|
52
53
|
sessionId: string;
|
|
54
|
+
/** borrowed-readonly — the leg's one ask source (minted once by the driver): the plan_review row's `sourceSessionId`. */
|
|
55
|
+
askSource: Pick<AskSourceIdentity, "sourceSessionId">;
|
|
53
56
|
/** borrowed-readonly — the deployment's error face, as a Pick over the SAME `deps` object (receiver preserved for
|
|
54
57
|
* `deps.onError?.()`): the suspendVM refusals, the skipped-review lines, the pin failures. */
|
|
55
58
|
deps: Pick<RunnerDeps, "onError">;
|
|
@@ -4,7 +4,7 @@ import { defaultTaskRegistry } from "../task-registry.js";
|
|
|
4
4
|
import { DEFAULT_RESOURCE_TTL_MS, publishCommittedSuspend, sanitizedTtlMs, USAGE_WINDOW_REAP_MARGIN_MS } from "./park-commit.js";
|
|
5
5
|
import { remoteEnvFailureNote } from "./remote-env-retry.js";
|
|
6
6
|
export function prepareBoundaryParks(input) {
|
|
7
|
-
const { saga, spec, checkpointStore, checkpointScope, abortController, harness, session, sessions, sessionId, deps, priorLedger, maxSlices, maxSuspends, resourceTotal, priorSuspendCount, suspendChainBase, humanReviewRef, liveSpendRef, now, pausedRef, remoteEnvFailures, resourceSuspendEligible, durableSuspendInfraReady, suspendTargetGap } = input;
|
|
7
|
+
const { saga, spec, checkpointStore, checkpointScope, abortController, harness, session, sessions, sessionId, askSource, deps, priorLedger, maxSlices, maxSuspends, resourceTotal, priorSuspendCount, suspendChainBase, humanReviewRef, liveSpendRef, now, pausedRef, remoteEnvFailures, resourceSuspendEligible, durableSuspendInfraReady, suspendTargetGap } = input;
|
|
8
8
|
if (saga === undefined)
|
|
9
9
|
return { suspendForResource: undefined, suspendForPlatformLimit: undefined, suspendForReview: undefined };
|
|
10
10
|
const { inFlightSpendMicroUsd, serializeCheckpointState, commitSuspendSaga, suspendLoopCapHit, suspendableEnv, parkOnlyRemoteEnv, parkOnlyHandle } = saga;
|
|
@@ -144,7 +144,7 @@ export function prepareBoundaryParks(input) {
|
|
|
144
144
|
? { count: humanReviewRef.count, totalWaitMs: humanReviewRef.totalWaitMs, gates: [...humanReviewRef.gates] }
|
|
145
145
|
: undefined,
|
|
146
146
|
resourceLedger: reviewLedger,
|
|
147
|
-
|
|
147
|
+
sourceSessionId: askSource.sourceSessionId,
|
|
148
148
|
...(spec.principal ? { principal: spec.principal } : {}),
|
|
149
149
|
...(spec.durableApproval !== undefined ? { durableApproval: { ...spec.durableApproval } } : {}),
|
|
150
150
|
};
|
|
@@ -71,6 +71,8 @@ export interface PrepareCapsAndWorkflowInput {
|
|
|
71
71
|
taskScope: string;
|
|
72
72
|
/** borrowed-readonly — the SETTLED task root the Workflow mount hands its children as `parentCwd`. */
|
|
73
73
|
taskRootFinal: string;
|
|
74
|
+
/** borrowed-readonly — this leg's own target (absent: none), the fence the Workflow mount hands every agent it spawns. */
|
|
75
|
+
ownTarget: import("../remote-env.js").PlacementTarget | undefined;
|
|
74
76
|
/** borrowed-readonly — the run's resolved model: the classifier leg's fallback and the route pre-flight's primary. */
|
|
75
77
|
model: Model;
|
|
76
78
|
/** borrowed-readonly — the run's resolved thinking level, when one is (the Workflow mount's parentThinking fallback). */
|
|
@@ -367,6 +367,7 @@ export async function prepareCapsAndWorkflow(input) {
|
|
|
367
367
|
agentStations: input.agentStations,
|
|
368
368
|
workflowDepth: internals?.workflowDepth,
|
|
369
369
|
parentCwd: taskRootFinal,
|
|
370
|
+
...(input.ownTarget !== undefined ? { placementTarget: input.ownTarget } : {}),
|
|
370
371
|
parentThinking: () => childThinkingSeat(undefined, deploymentSubagentThinking(runnerSelf.agentCatalog?.roles), harnessRef.current?.getThinkingLevel() ?? thinking).thinking,
|
|
371
372
|
parentClamps: runClampSource,
|
|
372
373
|
onNotice: deps.onNotice,
|
|
@@ -36,18 +36,18 @@ import { assertToolBoundaryLegs } from "../tool-roster.js";
|
|
|
36
36
|
import { assertToolCardDeclarations } from "../../prompt-assembly/tool-catalog.js";
|
|
37
37
|
import { refuseRenamedDelegationMounts } from "./sub-agent-deny-lists.js";
|
|
38
38
|
import { readPrincipal } from "../principal-name.js";
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
39
|
+
import { optionKeys, strayMembersOf } from "../own-property-receipt.js";
|
|
40
|
+
const TASK_LIMIT_KEYS = optionKeys()({
|
|
41
|
+
maxTokens: 0,
|
|
42
|
+
maxCostUsd: 0,
|
|
43
|
+
maxTurns: 0,
|
|
44
|
+
maxWalltimeMs: 0,
|
|
45
|
+
maxOutputTokens: 0,
|
|
46
|
+
approachNotice: 0,
|
|
47
|
+
budgetStreamCancel: 0,
|
|
48
|
+
degrade: 0,
|
|
49
|
+
brainCallGuardrailMs: 0,
|
|
50
|
+
});
|
|
51
51
|
const NUMERIC_TASK_LIMIT_KEYS = ["maxTokens", "maxCostUsd", "maxTurns", "maxWalltimeMs", "maxOutputTokens"];
|
|
52
52
|
const RETIRED_TASK_LIMIT_KEYS = {
|
|
53
53
|
timeoutSec: "maxWalltimeMs (milliseconds, not seconds)",
|
|
@@ -76,11 +76,10 @@ export function resolveTaskLimits(limits) {
|
|
|
76
76
|
throw limitConfigError("config.limit_invalid", `TaskSpec.limits must be an object (got ${limits === null ? "null" : Array.isArray(limits) ? "an array" : typeof limits})`);
|
|
77
77
|
}
|
|
78
78
|
const raw = limits;
|
|
79
|
-
const
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
const replacement = RETIRED_TASK_LIMIT_KEYS[key];
|
|
79
|
+
const stray = strayMembersOf(raw, { subject: "TaskSpec.limits", unit: "limit", moment: "when the task is prepared" }, TASK_LIMIT_KEYS)?.names[0];
|
|
80
|
+
if (stray !== undefined) {
|
|
81
|
+
const key = String(stray);
|
|
82
|
+
const replacement = Object.hasOwn(RETIRED_TASK_LIMIT_KEYS, key) ? RETIRED_TASK_LIMIT_KEYS[key] : undefined;
|
|
84
83
|
throw limitConfigError("config.limit_unknown_key", `TaskSpec.limits.${key} is not a limit this engine reads` +
|
|
85
84
|
(replacement !== undefined ? ` — it was replaced by \`${replacement}\`` : "") +
|
|
86
85
|
`. Legal keys: ${TASK_LIMIT_KEYS.join(", ")}. Refused rather than ignored: a limit that is silently dropped reads to the caller as an armed ceiling.`);
|
|
@@ -27,13 +27,17 @@ import type { Prepared, PreparedMicroCompact } from "./contracts.js";
|
|
|
27
27
|
import { type GitStatusLaneRef } from "./git-status-frame.js";
|
|
28
28
|
import type { ReadFileState } from "../../tools/fs/safety.js";
|
|
29
29
|
import { type ToolRosterDeltaSeat } from "../tool-roster.js";
|
|
30
|
+
import { type MediaBudgetRecord } from "./media-removed-seat.js";
|
|
30
31
|
export interface PrepareContextLaneInput {
|
|
31
32
|
/** borrowed-readonly — the task model: the budgets, the trigger-window geometry and `charsPerToken` are read off it. */
|
|
32
33
|
model: Model;
|
|
33
34
|
/** borrowed-readonly — the deployment seats, whole: `onNotice` (the clamp outlet, the offload-loss announcement, the
|
|
34
|
-
* tool-turn repair seat), `tracer` (the cap / clear / trim frames), `
|
|
35
|
-
*
|
|
35
|
+
* tool-turn repair seat, the media-removed seats), `tracer` (the cap / clear / trim frames), `mediaBudgetBase64Chars` (the
|
|
36
|
+
* media trim), `onError` (the git-frame degrade) — the guard chain and the machine-state builder read the whole record. */
|
|
36
37
|
deps: RunnerDeps;
|
|
38
|
+
/** borrowed-mutable — the session's announced record and the leg's receipt ledger: the media budget's account records
|
|
39
|
+
* the blocks it told of and parks the record's write ({@link createMediaBudgetSeat}). */
|
|
40
|
+
announced: MediaBudgetRecord;
|
|
37
41
|
/** borrowed-readonly — the acquired session id (the offload persist key; every disclosure's attribution). */
|
|
38
42
|
sessionId: string;
|
|
39
43
|
/** borrowed-readonly — the run's invocation id (the clamp notice's per-run claim). */
|
|
@@ -3,7 +3,8 @@ import { TOOL_TURN_REPAIR_DROPS } from "../../internal/llm.js";
|
|
|
3
3
|
import { droppedTransmissions } from "../user-attachment.js";
|
|
4
4
|
import { clearStaleToolResults, createClearedProjectionLedger, dropEmptyFailureAssistants, editBudget, replayClearedProjection, resolveTriggerWindow } from "../context-edit.js";
|
|
5
5
|
import { guardBudget, insertTrimNotice, protectGitFrame, trimToBudget } from "../context-guard.js";
|
|
6
|
-
import {
|
|
6
|
+
import { requestMediaLimits } from "../image-admission.js";
|
|
7
|
+
import { trimRequestMedia } from "../media-byte-cap.js";
|
|
7
8
|
import { capAggregateToolResults } from "../tool-result-budget.js";
|
|
8
9
|
import { createOffloadPersist } from "../tool-result-store.js";
|
|
9
10
|
import { emitTrace } from "../trace.js";
|
|
@@ -12,7 +13,7 @@ import { applyGitFrameGuard } from "./git-status-frame.js";
|
|
|
12
13
|
import { applyContextShrinkToReadFileState } from "../../tools/fs/index.js";
|
|
13
14
|
import { rosterToolName } from "../tool-roster.js";
|
|
14
15
|
import { createToolTurnRepairSeat } from "./tool-turn-repair-seat.js";
|
|
15
|
-
import {
|
|
16
|
+
import { createMediaBudgetSeat, createProviderRefusalSeat, createToolSchemaRemovedSeat } from "./media-removed-seat.js";
|
|
16
17
|
export function prepareContextLane(input) {
|
|
17
18
|
const { model, deps, sessionId, runId, hostTaskId, offloadStore, toolRosterDeltas, microCompactKnob, harness, batchHaltRef, gitStatusRef, postureFrameRef, requestLossyRef, trimPressureRef, readFileState } = input;
|
|
18
19
|
const toolNameOf = (recorded) => rosterToolName(toolRosterDeltas.current, recorded);
|
|
@@ -20,7 +21,7 @@ export function prepareContextLane(input) {
|
|
|
20
21
|
const requestGeometry = () => {
|
|
21
22
|
const current = harness.getModel();
|
|
22
23
|
const overlay = contextOverlay();
|
|
23
|
-
return { editAt: editBudget(current, overlay), guardAt: guardBudget(current, overlay), charsPerToken: current.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN };
|
|
24
|
+
return { editAt: editBudget(current, overlay), guardAt: guardBudget(current, overlay), charsPerToken: current.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN, media: requestMediaLimits(current, deps.mediaBudgetBase64Chars) };
|
|
24
25
|
};
|
|
25
26
|
const microCompact = buildMicroCompactState(deps, model, sessionId, runId, offloadStore, microCompactKnob, contextOverlay());
|
|
26
27
|
const charsPerToken = model.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;
|
|
@@ -30,12 +31,15 @@ export function prepareContextLane(input) {
|
|
|
30
31
|
requestLossyRef.current = true;
|
|
31
32
|
announceRepairs(repairs);
|
|
32
33
|
};
|
|
33
|
-
|
|
34
|
+
const mediaNotices = { onNotice: deps.onNotice, sessionId, runId };
|
|
35
|
+
harness.onImagesRemoved = createProviderRefusalSeat(mediaNotices);
|
|
36
|
+
harness.onToolSchemaRefused = createToolSchemaRemovedSeat((notice) => deps.onNotice?.(notice), { sessionId, runId });
|
|
37
|
+
const accountMediaCut = createMediaBudgetSeat(mediaNotices, input.announced, { tracer: deps.tracer, taskId: hostTaskId });
|
|
34
38
|
harness.on("context", async ({ messages, recheck, signal }) => {
|
|
35
39
|
batchHaltRef.current = undefined;
|
|
36
40
|
const pendingProjectionObservations = [];
|
|
37
41
|
try {
|
|
38
|
-
const { editAt, guardAt, charsPerToken: cpt } = requestGeometry();
|
|
42
|
+
const { editAt, guardAt, charsPerToken: cpt, media } = requestGeometry();
|
|
39
43
|
const healed = dropEmptyFailureAssistants(messages);
|
|
40
44
|
const replay = replayClearedProjection(healed, microCompact.ledger);
|
|
41
45
|
const replayed = replay.messages;
|
|
@@ -52,14 +56,10 @@ export function prepareContextLane(input) {
|
|
|
52
56
|
ts: Date.now(),
|
|
53
57
|
}))),
|
|
54
58
|
});
|
|
55
|
-
const
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
if (onMediaStripped !== undefined)
|
|
60
|
-
pendingProjectionObservations.push(() => onMediaStripped(info));
|
|
61
|
-
},
|
|
62
|
-
});
|
|
59
|
+
const mediaTrim = trimRequestMedia(capped, media);
|
|
60
|
+
const mediaCapped = mediaTrim.messages;
|
|
61
|
+
if (mediaTrim.removed.length > 0)
|
|
62
|
+
pendingProjectionObservations.push(() => accountMediaCut(mediaTrim, media));
|
|
63
63
|
let ccPass;
|
|
64
64
|
const edited = microCompact.machine === "off" ? mediaCapped : clearStaleToolResults(mediaCapped, {
|
|
65
65
|
budgetTokens: editAt, toolNameOf,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* PrepareTask's DELEGATION-SURFACE phase, verbatim from the driver: the surface's two doors
|
|
3
3
|
* (the background/workflow door the read/kill faces keep; the delegated-child arm SendMessage additionally mounts
|
|
4
|
-
* on), the
|
|
4
|
+
* on), the TaskStop mount, the SendMessage mount with its tier-3 revival spawner and peer seats, the
|
|
5
5
|
* AgentTranscript residual lane, the peer lane's ListAgents, the Monitor tool, the EnterWorktree / ExitWorktree pair
|
|
6
6
|
* with the worktree session seat it seeds from the checkpoint or the workspace snapshot, and the offload reader. The
|
|
7
7
|
* revival spawner and the continuation tier it yields are machinery below (send-message-continuation.ts). The
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* (`@contract prepare.deps-read-stable`).
|
|
14
14
|
*
|
|
15
15
|
* The roster (`tools`) is borrowed-mutable here — the writer table lives on {@link Prepared.tools};
|
|
16
|
-
* this phase's rows are the
|
|
16
|
+
* this phase's rows are the seven mounts named above. `childPolicy` is NOT a seat yet: the
|
|
17
17
|
* delegation carriers still ride the enriched ctx's individual clamp fields, as they did in the driver.
|
|
18
18
|
*/
|
|
19
19
|
import type { AgentTool, ExecutionEnv, WorkspaceState } from "../../internal/harness.js";
|
|
@@ -31,7 +31,7 @@ export interface PrepareDelegationSurfaceInput {
|
|
|
31
31
|
/** borrowed-readonly — the REBOUND spec. Read: `tools` (the shadow checks and the revival spawner's delegation-tool
|
|
32
32
|
* lookup), `retainBackgroundProcesses` (the Monitor receipt), `handsReadOnly` is NOT read here (the hands mount
|
|
33
33
|
* decided the surface). Never mutated. */
|
|
34
|
-
spec: Pick<TaskSpec, "tools" | "retainBackgroundProcesses" | "excludeAllTools">;
|
|
34
|
+
spec: Pick<TaskSpec, "tools" | "retainBackgroundProcesses" | "excludeAllTools" | "oneShot">;
|
|
35
35
|
/** borrowed-readonly — the deployment seats the mounts read: `workflowRunStore` / `backgroundAgentStore` / `mailboxStore` (the
|
|
36
36
|
* read/kill faces and the tier-3 revival seams), `rosterStore`, `peerLane`, `peerDirectory`, `peerChannel`, `onNotice`,
|
|
37
37
|
* `onBackgroundChildEvent`, `tracer`. */
|
|
@@ -62,9 +62,9 @@ export interface PrepareDelegationSurfaceInput {
|
|
|
62
62
|
backgroundTaskToolsActive: boolean;
|
|
63
63
|
/** borrowed-readonly — this run's shell read station's pre-spawn ADMISSION (declared at the hands phase), for `Monitor`: the only P11 face that spawns a shell command. */
|
|
64
64
|
shellReadAdmission: ShellReadAdmission | undefined;
|
|
65
|
-
/** borrowed-readonly — the
|
|
66
|
-
*
|
|
67
|
-
|
|
65
|
+
/** borrowed-readonly — the run's byte-floor seat (read-floor.ts), for the faces mounted here that start commands
|
|
66
|
+
* (`Monitor`, EnterWorktree / ExitWorktree): each start carries the floor it answers, as the band's shell starts do. */
|
|
67
|
+
runReadFloor: ReadFloorSeat;
|
|
68
68
|
/** borrowed-readonly — the door's second half: the Workflow tool is on the roster. */
|
|
69
69
|
workflowToolsActive: boolean;
|
|
70
70
|
/** borrowed-readonly — the peer lane's mount verdict for this leg. */
|
|
@@ -76,11 +76,11 @@ export interface PrepareDelegationSurfaceInput {
|
|
|
76
76
|
peerLaneRefs: PeerLaneRefs;
|
|
77
77
|
/** borrowed-readonly — the session-box drain's mount judgment (the `ReadInbox` door: a box drained by this leg). */ sessionBox?: import("../task-notification.js").SessionBoxBinding | undefined;
|
|
78
78
|
/** borrowed-mutable — the run's roster builder (`Prepared.tools` is its read face; the writer table is on that field).
|
|
79
|
-
* Writers here: the
|
|
79
|
+
* Writers here: the seven mounts (TaskStop, SendMessage, AgentTranscript, ListAgents, Monitor, the worktree
|
|
80
80
|
* pair, the offload reader), every one a `mount`. */
|
|
81
81
|
roster: RosterBuilder;
|
|
82
82
|
/** borrowed-readonly — not read by this phase: the effect collection (`Prepared.toolEffects`), the same map `roster` writes at each mount
|
|
83
|
-
* (
|
|
83
|
+
* (TaskStop / SendMessage / Monitor / EnterWorktree / ExitWorktree → write, ReadInbox / ListAgents and its
|
|
84
84
|
* alias → read), each from the mounted tool's own declaration; this phase writes nothing into it by name. */
|
|
85
85
|
toolEffects: Map<string, ToolEffect>;
|
|
86
86
|
/** borrowed-mutable — the explicit-negative axis declarations. Writer here: the built-in SendMessage mount's `egress: false`
|
|
@@ -128,7 +128,7 @@ export interface PrepareDelegationSurfaceInput {
|
|
|
128
128
|
worktreeSeat: WorktreeSessionRef;
|
|
129
129
|
}
|
|
130
130
|
export interface PrepareDelegationSurfaceResult {
|
|
131
|
-
/** owned — whether the background/workflow door is open (
|
|
131
|
+
/** owned — whether the background/workflow door is open (TaskStop / AgentTranscript ride it). */
|
|
132
132
|
delegationSurfaceActive: boolean;
|
|
133
133
|
/** borrowed-mutable — the EnterWorktree session's shared serializable state (`Prepared.worktreeSessionRef`), minted iff the
|
|
134
134
|
* worktree pair mounted. Writers: the worktree tools at run time (Enter/Exit); the suspend serializer reads it. */
|
|
@@ -6,7 +6,7 @@ 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";
|
|
@@ -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, 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
|
}
|
|
@@ -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,7 +122,7 @@ 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
128
|
roster.mount(createReadToolResultTool(offloadStore, (ref, tree) => defaultTaskRegistry.artifactBoundaryLegs(ref, { owner: hostTaskId, scope: taskScope, sessionId }, tree)), { source: "builtin", mountedBy: "optional" });
|
|
@@ -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 — ` +
|