@sema-agent/core 7.60.0 → 7.62.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 +917 -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 +71 -12
- package/dist/agents/cascade.js +61 -21
- 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-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- 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 +49 -10
- 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 +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- 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-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- 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 +68 -21
- package/dist/core/engine-notice.js +9 -2
- 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 +4 -3
- 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 +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- 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 +4 -3
- 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 +225 -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-driver.d.ts +1 -1
- 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/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- 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 +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- 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 +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -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 +138 -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 +88 -21
- package/dist/core/mods/stations.js +149 -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 +68 -2
- package/dist/core/own-property-receipt.js +45 -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/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- 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 +18 -3
- 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 +116 -34
- 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/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- 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/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- 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 +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- 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 +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- 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 +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- 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 +61 -30
- 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 +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- 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.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- 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 +64 -36
- 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 +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- 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 +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- 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/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- 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 +16 -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-face-overlay.js +2 -0
- 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 +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- 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 +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- 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 +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- 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 +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -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/session-store-contract.js +22 -8
- 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 +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- 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 +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- 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 +11 -11
- 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 +36 -6
- 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 +8 -5
- package/dist/core/tool-face.js +1 -1
- 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 +109 -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-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -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 +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- 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 +52 -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/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- 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 +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- 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 +26 -7
- package/dist/stores/file/session-store.js +59 -35
- 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/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- 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/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- 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/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- 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 +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -7,6 +7,7 @@ import { reconcileInterruptedSession } from "../session-reconcile.js";
|
|
|
7
7
|
import { detectConflicts, settleBranchWriteBack } from "./branch-writeback.js";
|
|
8
8
|
import { settleTeardownLeg } from "./teardown-bounded.js";
|
|
9
9
|
import { writesThroughLeg } from "./session-write-ledger.js";
|
|
10
|
+
import { replayLossLeg } from "./lineage-reroot-view.js";
|
|
10
11
|
const RECONCILE_MAX_RETRIES = 3;
|
|
11
12
|
export async function prepareAcquireReconcile(input) {
|
|
12
13
|
const { sessions, spec, resume, wakeEffects } = input;
|
|
@@ -15,6 +16,7 @@ export async function prepareAcquireReconcile(input) {
|
|
|
15
16
|
let conflictRef;
|
|
16
17
|
let wakeRecovered = [];
|
|
17
18
|
let branch;
|
|
19
|
+
const lossLeg = input.replayLossNotice !== undefined ? replayLossLeg(input.replayLossNotice) : undefined;
|
|
18
20
|
for (let attempt = 0;; attempt++) {
|
|
19
21
|
try {
|
|
20
22
|
acquired = await sessions.acquire(spec.sessionId, spec.requireExistingSession ? { requireExisting: true } : input.placement !== undefined ? { placement: input.placement } : undefined);
|
|
@@ -30,14 +32,15 @@ export async function prepareAcquireReconcile(input) {
|
|
|
30
32
|
}
|
|
31
33
|
conflictRef = { hit: false };
|
|
32
34
|
const own = { ids: undefined };
|
|
33
|
-
|
|
35
|
+
const legStorage = input.legWrites !== undefined ? writesThroughLeg(acquired.session.getStorage(), input.legWrites, acquired.sessionId) : acquired.session.getStorage();
|
|
36
|
+
session = new StoredSession(detectConflicts(lossLeg !== undefined ? lossLeg.view(legStorage, acquired.sessionId) : legStorage, conflictRef, own));
|
|
34
37
|
if (!spec.sessionId) {
|
|
35
38
|
break;
|
|
36
39
|
}
|
|
37
40
|
try {
|
|
38
41
|
if (resume) {
|
|
39
42
|
await session.getStorage().setLeafId(resume.leafId).catch((cut) => {
|
|
40
|
-
throw readMember(cut, "code") === "not_found" ? new SessionError("
|
|
43
|
+
throw readMember(cut, "code") === "not_found" ? new SessionError("corrupt_session", `session "${spec.sessionId}" no longer holds the entry its checkpoint was cut at ("${resume.leafId}")`, cut) : cut;
|
|
41
44
|
});
|
|
42
45
|
}
|
|
43
46
|
else if (spec.resumeAt !== undefined) {
|
|
@@ -113,6 +116,7 @@ export async function prepareAcquireReconcile(input) {
|
|
|
113
116
|
await settleTeardownLeg(() => Promise.resolve(forget(id)).catch(() => undefined), "forget (acquire-reconcile re-wake leg)", (e) => input.report?.(e, id));
|
|
114
117
|
}
|
|
115
118
|
branch = undefined;
|
|
119
|
+
lossLeg?.discard();
|
|
116
120
|
continue;
|
|
117
121
|
}
|
|
118
122
|
if (branch !== undefined)
|
|
@@ -121,5 +125,6 @@ export async function prepareAcquireReconcile(input) {
|
|
|
121
125
|
throw err;
|
|
122
126
|
}
|
|
123
127
|
}
|
|
128
|
+
lossLeg?.settle();
|
|
124
129
|
return { acquired, session, conflictRef, wakeRecovered, branch };
|
|
125
130
|
}
|
|
@@ -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
|
};
|
|
@@ -59,6 +59,7 @@ export interface PrepareCapsAndWorkflowInput {
|
|
|
59
59
|
* the chain's auto-mode face (`inheritedGate.autoModeFace`). */
|
|
60
60
|
internals: Pick<RunInternals, "rootSessionId" | "placementRoot" | "onTaskNotification" | "workflowDepth" | "memoryCaptureAncestors" | "workflowParkedResume" | "holder" | "questionFaceStripped" | "inheritedGate"> | undefined;
|
|
61
61
|
/** borrowed-readonly — the tree's cross-boundary token (inherited or minted), which the Workflow mount hands to its children. */ crossBoundaryTree: import("../cross-boundary-taint.js").CrossBoundaryTreeToken;
|
|
62
|
+
/** borrowed-readonly — the tree's owner seat, which the Workflow mount hands to its children (by reference). */ delegationOwner: import("./delegation-owner.js").DelegationOwnerSeat;
|
|
62
63
|
/** borrowed-readonly — the acquired session; the classifier leg rebuilds its transcript window from `buildContext`. */
|
|
63
64
|
session: Pick<StoredSession, "buildContext">;
|
|
64
65
|
/** borrowed-readonly — the acquired session id (operator-line context, the refusal codes' phase record). */
|
|
@@ -71,6 +72,8 @@ export interface PrepareCapsAndWorkflowInput {
|
|
|
71
72
|
taskScope: string;
|
|
72
73
|
/** borrowed-readonly — the SETTLED task root the Workflow mount hands its children as `parentCwd`. */
|
|
73
74
|
taskRootFinal: string;
|
|
75
|
+
/** borrowed-readonly — this leg's own target (absent: none), the fence the Workflow mount hands every agent it spawns. */
|
|
76
|
+
ownTarget: import("../remote-env.js").PlacementTarget | undefined;
|
|
74
77
|
/** borrowed-readonly — the run's resolved model: the classifier leg's fallback and the route pre-flight's primary. */
|
|
75
78
|
model: Model;
|
|
76
79
|
/** borrowed-readonly — the run's resolved thinking level, when one is (the Workflow mount's parentThinking fallback). */
|
|
@@ -331,7 +331,7 @@ export async function prepareCapsAndWorkflow(input) {
|
|
|
331
331
|
scope: taskScope,
|
|
332
332
|
notifier: deps.workflowCompletionNotifier,
|
|
333
333
|
originatingSessionId: sessionId,
|
|
334
|
-
rootSessionId: internals?.rootSessionId ?? sessionId, ...(internals?.placementRoot !== undefined ? { placementRoot: internals.placementRoot } : {}), crossBoundaryTree: input.crossBoundaryTree,
|
|
334
|
+
rootSessionId: internals?.rootSessionId ?? sessionId, ...(internals?.placementRoot !== undefined ? { placementRoot: internals.placementRoot } : {}), crossBoundaryTree: input.crossBoundaryTree, delegationOwner: input.delegationOwner,
|
|
335
335
|
taskRegistry: defaultTaskRegistry,
|
|
336
336
|
taskNotification: internals?.onTaskNotification, ...(taskArtifacts !== undefined ? { taskArtifacts } : {}),
|
|
337
337
|
taskOwner: hostTaskId,
|
|
@@ -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,
|
|
@@ -24,7 +24,6 @@ import type { ThinkingLevel } from "../../internal/harness.js";
|
|
|
24
24
|
import { type MicroCompactMachine } from "../context-edit.js";
|
|
25
25
|
import { type CrossBoundaryPosture } from "../cross-boundary-taint.js";
|
|
26
26
|
import { type HostFloor } from "../host-floor.js";
|
|
27
|
-
import { type CheckpointState } from "../checkpoint-store.js";
|
|
28
27
|
import { runOriginOfLeg, type RunOrigin } from "../run-origin.js";
|
|
29
28
|
import { type ConfigDoorEntry, type LockedPreflight, type ReceivedPeerDeclarations } from "../locked-config.js";
|
|
30
29
|
import { type ResolvedRole } from "../roles.js";
|
|
@@ -269,15 +268,16 @@ export declare function configValueDoors(input: {
|
|
|
269
268
|
* The doors a RESUMED leg's prepare refuses at, run as one screen BEFORE the claim — prepare's own functions, so a refusal carries
|
|
270
269
|
* the very sentence and code prepare throws: the mode doors (`refusePermissionModeDoors`), the output-style seat, the approval
|
|
271
270
|
* reach, the skills invoked by name (the part no roster changes), the attachments (a resume sends no new human message, so any
|
|
272
|
-
* entry is refused), the leg declarations of the tools it re-supplies (this phase's first door), this phase's value doors over the config, the deployment's deps and the session store the Runner holds
|
|
273
|
-
* ({@link configValueDoors}, the retention capability door and the run-origin door over the
|
|
274
|
-
*
|
|
271
|
+
* entry is refused), the leg declarations of the tools it re-supplies (this phase's first door), and this phase's value doors over the config, the deployment's deps and the session store the Runner holds
|
|
272
|
+
* ({@link configValueDoors}, the retention capability door and the run-origin door over the config's word included). The words the
|
|
273
|
+
* row recorded (its mode seed, its run origin) are not this door's: the row's own verdict judged them before it (`judgeCheckpointRow`,
|
|
274
|
+
* checkpoint-row-verdict.ts), so this door reads nothing off the row. It leaves by the resume's ONE refusal channel (`asResumeConfigRefusal`:
|
|
275
275
|
* `checkpoint.config_refused`, `detail.code` = prepare's code, `detail.field` = `"taskConfig"`, `"deps"` or `"inheritedGate"`)
|
|
276
276
|
* where prepare would end the leg `failed` after the claim — the row consumed on a store without `reopen`, replayed as a system
|
|
277
277
|
* retry on one with it, which a configuration fix cannot reach. Before the claim the row stays `pending` and byte-identical and the
|
|
278
278
|
* corrected resume redeems the same token. A throw that is none of prepare's codes leaves as it was thrown. Returns the config the
|
|
279
|
-
* leg is handed: the caller's, its MCP servers and A2A peers the
|
|
279
|
+
* leg is handed: the caller's, its MCP servers and A2A peers the lock layer's judged copies of the lists THIS resume handed (read once, dialed as judged; the row records none).
|
|
280
280
|
*/
|
|
281
|
-
export declare function refuseResumeDoors<C extends ValueDoorSpec & Pick<TaskSpec, "userAttachments">>(config: C,
|
|
281
|
+
export declare function refuseResumeDoors<C extends ValueDoorSpec & Pick<TaskSpec, "userAttachments">>(config: C, deps: RunnerDeps, sessions: SessionStore, holder?: string): C;
|
|
282
282
|
export declare function prepareConfigDoors(input: PrepareConfigDoorsInput): PrepareConfigDoorsResult;
|
|
283
283
|
export {};
|
|
@@ -5,7 +5,7 @@ import { assertAddOnlySeats } from "../child-clamp-seats.js";
|
|
|
5
5
|
import { CROSS_BOUNDARY_POSTURES } from "../cross-boundary-taint.js";
|
|
6
6
|
import { compileHostFloor } from "../host-floor.js";
|
|
7
7
|
import { assertNoRetiredRunnerDeps } from "./retired-runner-deps.js";
|
|
8
|
-
import {
|
|
8
|
+
import { resolveCheckpointStore } from "../checkpoint-store.js";
|
|
9
9
|
import { runOriginOfLeg, screenRecordedRunOrigin } from "../run-origin.js";
|
|
10
10
|
import { assertCheckpointStoreJudgesHolder, assertHolderValue } from "../checkpoint-generation.js";
|
|
11
11
|
import { asResumeConfigRefusal, refusePermissionModeDoors } from "../mode-policy.js";
|
|
@@ -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.`);
|
|
@@ -347,7 +346,7 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
|
|
|
347
346
|
enter("taskConfig", () => assertRetentionWords({ ...retention, stores: [{ name: "checkpointStore", store: taskStore }] }));
|
|
348
347
|
return { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin, deploymentRoles, taskRoles };
|
|
349
348
|
}
|
|
350
|
-
export function refuseResumeDoors(config,
|
|
349
|
+
export function refuseResumeDoors(config, deps, sessions, holder) {
|
|
351
350
|
asResumeConfigRefusal("taskConfig", () => {
|
|
352
351
|
refusePermissionModeDoors(config);
|
|
353
352
|
resolveOutputStyleFrame(config.outputStyle);
|
|
@@ -357,8 +356,7 @@ export function refuseResumeDoors(config, recorded, deps, sessions, holder) {
|
|
|
357
356
|
assertToolBoundaryLegs(config.tools);
|
|
358
357
|
assertToolCardDeclarations(config.tools);
|
|
359
358
|
});
|
|
360
|
-
const { lockedPreflight, skills } = configValueDoors({ spec: config, deps, resumeLeg: true, sessions, holder,
|
|
361
|
-
asResumeConfigRefusal("inheritedGate", () => void recordedModeSeed(recorded?.inheritedGate));
|
|
359
|
+
const { lockedPreflight, skills } = configValueDoors({ spec: config, deps, resumeLeg: true, sessions, holder, resumedRow: { recorded: undefined } }, asResumeConfigRefusal);
|
|
362
360
|
return { ...config, ...(config.mcp !== undefined ? { mcp: lockedPreflight.mcp ?? [] } : {}), ...(config.a2a !== undefined ? { a2a: lockedPreflight.a2a ?? [] } : {}), skills };
|
|
363
361
|
}
|
|
364
362
|
export function prepareConfigDoors(input) {
|
|
@@ -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 — ` +
|