@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
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { LineageBreak, entryParentLinks, pathToRoot, replayLossText } from "../../internal/harness.js";
|
|
2
|
+
import { deliverEngineNotice } from "../engine-notice.js";
|
|
3
|
+
const LINEAGE_REROOTED = "session.lineage_rerooted";
|
|
4
|
+
export function viewThroughReplayLoss(storage, found) {
|
|
5
|
+
return new Proxy(storage, {
|
|
6
|
+
get(target, prop, receiver) {
|
|
7
|
+
if (prop === "getPathToRoot")
|
|
8
|
+
return (leafId) => branchReadingLoss(target, leafId, found);
|
|
9
|
+
const value = Reflect.get(target, prop, receiver);
|
|
10
|
+
return typeof value === "function" ? value.bind(target) : value;
|
|
11
|
+
},
|
|
12
|
+
});
|
|
13
|
+
}
|
|
14
|
+
async function branchReadingLoss(storage, leafId, found) {
|
|
15
|
+
let path;
|
|
16
|
+
try {
|
|
17
|
+
path = await storage.getPathToRoot(leafId);
|
|
18
|
+
}
|
|
19
|
+
catch (err) {
|
|
20
|
+
if (!(err instanceof LineageBreak) || err.replayLoss === undefined || err.replayLoss.dropped === 0 || leafId === null)
|
|
21
|
+
throw err;
|
|
22
|
+
const entries = await storage.getEntries();
|
|
23
|
+
const byId = new Map(entries.map((entry) => [entry.id, entry]));
|
|
24
|
+
const leaf = byId.get(leafId);
|
|
25
|
+
if (leaf === undefined)
|
|
26
|
+
throw err;
|
|
27
|
+
const rerooted = pathToRoot(leaf, entryParentLinks(byId), err.childId);
|
|
28
|
+
found({
|
|
29
|
+
break: true,
|
|
30
|
+
missingParentId: err.missingParentId,
|
|
31
|
+
rootedAt: err.childId,
|
|
32
|
+
recordsDropped: err.replayLoss.dropped,
|
|
33
|
+
recordsTotal: err.replayLoss.total,
|
|
34
|
+
leaf: leafId,
|
|
35
|
+
entriesOnPath: rerooted.length,
|
|
36
|
+
entriesCut: entries.length - descendantsOf(entries, err.childId),
|
|
37
|
+
});
|
|
38
|
+
return rerooted;
|
|
39
|
+
}
|
|
40
|
+
const loss = storage.getReplayLoss?.();
|
|
41
|
+
if (loss !== undefined && loss.dropped > 0)
|
|
42
|
+
found({ break: false, recordsDropped: loss.dropped, recordsTotal: loss.total, leaf: leafId, entriesOnPath: path.length });
|
|
43
|
+
return path;
|
|
44
|
+
}
|
|
45
|
+
function descendantsOf(entries, rootId) {
|
|
46
|
+
const children = new Map();
|
|
47
|
+
for (const entry of entries) {
|
|
48
|
+
const parent = entry.parentId || null;
|
|
49
|
+
if (parent === null)
|
|
50
|
+
continue;
|
|
51
|
+
const list = children.get(parent);
|
|
52
|
+
if (list === undefined)
|
|
53
|
+
children.set(parent, [entry.id]);
|
|
54
|
+
else
|
|
55
|
+
list.push(entry.id);
|
|
56
|
+
}
|
|
57
|
+
const seen = new Set([rootId]);
|
|
58
|
+
const todo = [rootId];
|
|
59
|
+
for (let id = todo.pop(); id !== undefined; id = todo.pop()) {
|
|
60
|
+
for (const child of children.get(id) ?? []) {
|
|
61
|
+
if (seen.has(child))
|
|
62
|
+
continue;
|
|
63
|
+
seen.add(child);
|
|
64
|
+
todo.push(child);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return seen.size;
|
|
68
|
+
}
|
|
69
|
+
const WHOLE_BRANCH = "\0whole";
|
|
70
|
+
function lossSentence(finding) {
|
|
71
|
+
const count = replayLossText({ dropped: finding.recordsDropped, total: finding.recordsTotal });
|
|
72
|
+
if (finding.break) {
|
|
73
|
+
return (`This session's log is damaged: entry ${finding.missingParentId}, the parent of ${finding.rootedAt}, is not in it (${count}). ` +
|
|
74
|
+
`The run continues from ${finding.rootedAt}: ${finding.entriesOnPath} entries of the conversation are kept, and ${finding.entriesCut} entries the log holds above the damage are not in its context.`);
|
|
75
|
+
}
|
|
76
|
+
if (finding.leaf === null)
|
|
77
|
+
return `This session's log is damaged: ${count}, and none of it is readable. The run starts from an empty conversation.`;
|
|
78
|
+
return (`This session's log is damaged: ${count}. The run continues from entry ${finding.leaf}, where the records the log still holds leave the conversation: ` +
|
|
79
|
+
`${finding.entriesOnPath} entries of it are kept, and what the unreadable records said — possibly its latest turns — is not in its context.`);
|
|
80
|
+
}
|
|
81
|
+
export function replayLossSeat(ids) {
|
|
82
|
+
const said = new Set();
|
|
83
|
+
return (finding, sessionId) => {
|
|
84
|
+
const key = finding.break ? `${finding.missingParentId}\n${finding.rootedAt}` : WHOLE_BRANCH;
|
|
85
|
+
if (said.has(key))
|
|
86
|
+
return;
|
|
87
|
+
said.add(key);
|
|
88
|
+
if (finding.break)
|
|
89
|
+
said.add(WHOLE_BRANCH);
|
|
90
|
+
deliverEngineNotice(ids.onNotice, { code: LINEAGE_REROOTED, message: lossSentence(finding), detail: { ...finding, sessionId, runId: ids.runId } });
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
export function replayLossLeg(ids) {
|
|
94
|
+
const say = replayLossSeat(ids);
|
|
95
|
+
let held = [];
|
|
96
|
+
return {
|
|
97
|
+
view: (storage, sessionId) => viewThroughReplayLoss(storage, (finding) => (held !== undefined ? void held.push({ finding, sessionId }) : say(finding, sessionId))),
|
|
98
|
+
discard: () => {
|
|
99
|
+
held = [];
|
|
100
|
+
},
|
|
101
|
+
settle: () => {
|
|
102
|
+
const found = [...(held ?? [])].sort((a, b) => Number(b.finding.break) - Number(a.finding.break));
|
|
103
|
+
held = undefined;
|
|
104
|
+
for (const { finding, sessionId } of found)
|
|
105
|
+
say(finding, sessionId);
|
|
106
|
+
},
|
|
107
|
+
};
|
|
108
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The Runner's same-Runner settle claims on checkpoint tokens. A claim is PER ATTEMPT: every in-Runner actor that settles a
|
|
3
|
+
* row (a resume's resolve, an in-Runner expire) opens its own claim with its CAS attempt and closes exactly that claim, once,
|
|
4
|
+
* when its duty is decided (a lost CAS, or the winner's duty done). A token is held while ANY attempt's claim is open — so a
|
|
5
|
+
* losing attempt never closes a winner's still-open claim, and a stream-side reap that loses its own expire preserves the
|
|
6
|
+
* paused-env reap record for whichever same-Runner winner is still on its way to it.
|
|
7
|
+
*/
|
|
8
|
+
import type { CheckpointToken } from "../checkpoint-store.js";
|
|
9
|
+
export declare class LocalClaims {
|
|
10
|
+
#private;
|
|
11
|
+
/** Open one attempt's claim on `token` (with its CAS attempt). */
|
|
12
|
+
open(token: CheckpointToken): void;
|
|
13
|
+
/** Close one attempt's claim on `token` — the attempt's own, once, at its duty decision. */
|
|
14
|
+
close(token: CheckpointToken): void;
|
|
15
|
+
/** Whether any same-Runner attempt's claim on `token` is open. */
|
|
16
|
+
held(token: CheckpointToken): boolean;
|
|
17
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export class LocalClaims {
|
|
2
|
+
#open = new Map();
|
|
3
|
+
open(token) {
|
|
4
|
+
this.#open.set(token, (this.#open.get(token) ?? 0) + 1);
|
|
5
|
+
}
|
|
6
|
+
close(token) {
|
|
7
|
+
const n = this.#open.get(token);
|
|
8
|
+
if (n === undefined)
|
|
9
|
+
return;
|
|
10
|
+
if (n > 1)
|
|
11
|
+
this.#open.set(token, n - 1);
|
|
12
|
+
else
|
|
13
|
+
this.#open.delete(token);
|
|
14
|
+
}
|
|
15
|
+
held(token) {
|
|
16
|
+
return this.#open.has(token);
|
|
17
|
+
}
|
|
18
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The person's account of the media that left the model's view of a request (`context.media_removed`, user) — one code,
|
|
3
|
+
* the reason in `detail.reason`, the message minted once here for both:
|
|
4
|
+
* - `rejected_by_provider`: the harness's request view removes the images a provider refusal points at
|
|
5
|
+
* (`engine/llm/rejected-images.ts`) and hands {@link createProviderRefusalSeat} the removals the run itself met; every
|
|
6
|
+
* request re-reads the transcript — the live failure, then its record or a rebuilt copy — so that seat announces ONCE
|
|
7
|
+
* PER RUN PER REFUSAL, keyed by the identity all of those share (`refusalAt`);
|
|
8
|
+
* - `media_budget`: the request trim (`media-byte-cap.ts`) hands {@link createMediaBudgetSeat} what it did to a request
|
|
9
|
+
* view the context hook handed on (the lane's observation flush, KL-2988-a); that seat traces every such view (`context.media_removed`, the request's numbers) and announces
|
|
10
|
+
* each block ONCE PER SESSION, by the block's identity — the digest of its bytes, which a compaction, a resume or a
|
|
11
|
+
* rewind does not change. The digest rides the session's announced record (the advisory arm, bounded) and the write is
|
|
12
|
+
* parked for the leg's flush; best effort — a lost write, or a block whose digest the bound let go, is said again by a
|
|
13
|
+
* later run, never lost. Within a run a block is looked at once.
|
|
14
|
+
* Beside the provider's image refusal sits its other refused part, a tool's input schema ({@link createToolSchemaRemovedSeat},
|
|
15
|
+
* its own code).
|
|
16
|
+
*/
|
|
17
|
+
import { type EngineNotice } from "../engine-notice.js";
|
|
18
|
+
import type { RejectedImageRemoval } from "../../internal/llm.js";
|
|
19
|
+
import type { RequestMediaLimits } from "../image-admission.js";
|
|
20
|
+
import type { RequestMediaTrim } from "../media-byte-cap.js";
|
|
21
|
+
import { type TracerHook } from "../trace.js";
|
|
22
|
+
import type { Prepared } from "./contracts.js";
|
|
23
|
+
import type { NoticeSeatInput } from "./notice-seat-input.js";
|
|
24
|
+
/** The session's announced record and the leg's receipt ledger (the parked write). */
|
|
25
|
+
export type MediaBudgetRecord = Pick<Prepared, "announcedListingsRef" | "frameReceipts">;
|
|
26
|
+
/** The provider-refusal account: one notice per refusal, once per run. */
|
|
27
|
+
export declare function createProviderRefusalSeat(ids: NoticeSeatInput): (removals: readonly RejectedImageRemoval[]) => void;
|
|
28
|
+
/**
|
|
29
|
+
* The run's account of a tool whose input schema a provider refused (`context.tool_schema_removed`, user): the loop re-sent
|
|
30
|
+
* the turn with that tool's parameters taken out of what the model sees (`engine/llm/rejected-images.ts`), and every later
|
|
31
|
+
* request built from a transcript the refusal's record stands in sends it so. ONCE PER REFUSAL (`refusalAt`): the loop
|
|
32
|
+
* re-sends once per refusal, and a refusal recorded before the run began is never re-sent, so never announced again.
|
|
33
|
+
*/
|
|
34
|
+
export declare function createToolSchemaRemovedSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: {
|
|
35
|
+
sessionId: string;
|
|
36
|
+
runId: string;
|
|
37
|
+
}): (refusal: {
|
|
38
|
+
tool: string;
|
|
39
|
+
refusalAt: number;
|
|
40
|
+
}) => void;
|
|
41
|
+
/** The request budget's account of one request view the trim cut: its trace frame, then — of the blocks it left out, those
|
|
42
|
+
* the session was not yet told of — one notice. */
|
|
43
|
+
export declare function createMediaBudgetSeat(ids: NoticeSeatInput, record: MediaBudgetRecord, trace: {
|
|
44
|
+
readonly tracer: TracerHook | undefined;
|
|
45
|
+
readonly taskId: string;
|
|
46
|
+
}): (trim: RequestMediaTrim, limits: RequestMediaLimits) => void;
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import { deliverEngineNotice } from "../engine-notice.js";
|
|
2
|
+
import { inlineUntrusted } from "../untrusted-text.js";
|
|
3
|
+
import { emitTrace } from "../trace.js";
|
|
4
|
+
import { announceDigest, withAnnounceDigests } from "./announce-once-ledger.js";
|
|
5
|
+
const MEDIA_REMOVED = "context.media_removed";
|
|
6
|
+
const counted = (n, noun) => (n === 1 ? `${noun === "image" ? "an" : "a"} ${noun}` : `${n} ${noun}s`);
|
|
7
|
+
function announceMediaRemoved(ids, reason, images, documents) {
|
|
8
|
+
const what = [images > 0 ? counted(images, "image") : undefined, documents > 0 ? counted(documents, "document") : undefined].filter((s) => s !== undefined).join(" and ");
|
|
9
|
+
const one = images + documents === 1;
|
|
10
|
+
const it = one ? "it" : "them";
|
|
11
|
+
const message = reason === "rejected_by_provider"
|
|
12
|
+
? `The model provider could not process ${what} in this conversation, so ${one ? "it was" : "they were"} removed ` +
|
|
13
|
+
`from what the model sees (each replaced by a line saying so) and the request was sent again without ${it}. ` +
|
|
14
|
+
`The session still holds the original; to show the model this content again, send it in another format.`
|
|
15
|
+
: `${what[0].toUpperCase()}${what.slice(1)} in this conversation no longer fit the request's media budget, so ${one ? "it was" : "they were"} removed ` +
|
|
16
|
+
`from what the model sees (the oldest go first; each is replaced by a line saying so). ` +
|
|
17
|
+
`The session still holds the original; to show the model ${it} again, read the file again or send ${it} again. Said once per image or document per conversation.`;
|
|
18
|
+
deliverEngineNotice(ids.onNotice, { code: MEDIA_REMOVED, message, detail: { reason, images, documents, sessionId: ids.sessionId, runId: ids.runId } });
|
|
19
|
+
}
|
|
20
|
+
export function createProviderRefusalSeat(ids) {
|
|
21
|
+
const announced = new Set();
|
|
22
|
+
return (removals) => {
|
|
23
|
+
for (const { refusalAt, images } of removals) {
|
|
24
|
+
if (announced.has(refusalAt))
|
|
25
|
+
continue;
|
|
26
|
+
announced.add(refusalAt);
|
|
27
|
+
announceMediaRemoved(ids, "rejected_by_provider", images, 0);
|
|
28
|
+
}
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export function createToolSchemaRemovedSeat(onNotice, ids) {
|
|
32
|
+
const announced = new Set();
|
|
33
|
+
return ({ tool, refusalAt }) => {
|
|
34
|
+
if (announced.has(refusalAt))
|
|
35
|
+
return;
|
|
36
|
+
announced.add(refusalAt);
|
|
37
|
+
const name = inlineUntrusted(tool, 160);
|
|
38
|
+
deliverEngineNotice(onNotice, {
|
|
39
|
+
code: "context.tool_schema_removed",
|
|
40
|
+
message: `Tool "${name}": the model provider refused this tool's input schema, so the request was sent again with the tool's parameters ` +
|
|
41
|
+
`taken out of what the model sees. The model can still call the tool in this conversation, but does not see its parameters. ` +
|
|
42
|
+
`Fix the schema on the server that provides the tool, then start a new conversation.`,
|
|
43
|
+
detail: { tool, sessionId: ids.sessionId, runId: ids.runId },
|
|
44
|
+
});
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
export function createMediaBudgetSeat(ids, record, trace) {
|
|
48
|
+
const lookedAt = new WeakSet();
|
|
49
|
+
return ({ removed, removedBase64Chars, items, base64Chars }, { maxItems, budgetBase64Chars }) => {
|
|
50
|
+
const cutImages = removed.filter((r) => r.type === "image").length;
|
|
51
|
+
emitTrace(trace.tracer, () => ({
|
|
52
|
+
kind: MEDIA_REMOVED,
|
|
53
|
+
version: 1,
|
|
54
|
+
taskId: trace.taskId,
|
|
55
|
+
reason: "media_budget",
|
|
56
|
+
images: cutImages,
|
|
57
|
+
documents: removed.length - cutImages,
|
|
58
|
+
removedBase64Chars,
|
|
59
|
+
items,
|
|
60
|
+
base64Chars,
|
|
61
|
+
maxItems,
|
|
62
|
+
...(budgetBase64Chars !== Infinity ? { budgetBase64Chars } : {}),
|
|
63
|
+
ts: Date.now(),
|
|
64
|
+
}));
|
|
65
|
+
const told = new Set(record.announcedListingsRef.advisories ?? []);
|
|
66
|
+
const fresh = new Set();
|
|
67
|
+
let images = 0;
|
|
68
|
+
let documents = 0;
|
|
69
|
+
for (const { block, type, data } of removed) {
|
|
70
|
+
if (lookedAt.has(block))
|
|
71
|
+
continue;
|
|
72
|
+
lookedAt.add(block);
|
|
73
|
+
const digest = announceDigest(MEDIA_REMOVED, `${type}\n${data}`);
|
|
74
|
+
if (told.has(digest) || fresh.has(digest))
|
|
75
|
+
continue;
|
|
76
|
+
fresh.add(digest);
|
|
77
|
+
if (type === "image")
|
|
78
|
+
images++;
|
|
79
|
+
else
|
|
80
|
+
documents++;
|
|
81
|
+
}
|
|
82
|
+
if (fresh.size === 0)
|
|
83
|
+
return;
|
|
84
|
+
announceMediaRemoved(ids, "media_budget", images, documents);
|
|
85
|
+
record.announcedListingsRef.advisories = withAnnounceDigests(record.announcedListingsRef.advisories, [...fresh]);
|
|
86
|
+
record.frameReceipts.listingSnapshotOwed = true;
|
|
87
|
+
};
|
|
88
|
+
}
|
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
* marker the loop stamps on the contaminated siblings, and the deadline arithmetic every mint shares (the retention
|
|
4
4
|
* defaults and the one TTL sanitizer). Moved whole out of the orchestrator so the boundary-parks phase (resource /
|
|
5
5
|
* platform / review) and the park-ask phase (the approval park) reach DOWN for the same publication seam and the same
|
|
6
|
-
* numbers, and the driver keeps reaching down for the marker its harness stamps.
|
|
7
|
-
* is the caller's.
|
|
6
|
+
* numbers, and the driver keeps reaching down for the marker its harness stamps. No engine state of its own (the
|
|
7
|
+
* publication writes the pause holder and marks the harness's capture); the only clock is the caller's.
|
|
8
8
|
*/
|
|
9
9
|
import { type CheckpointGate, type CheckpointToken, type PendingAction } from "../checkpoint-store.js";
|
|
10
10
|
import type { WorkspaceHandle } from "../remote-env.js";
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
* position (a permanent no-op) and a layer's mere presence flips `hasEffectAwareGate`, which would
|
|
24
24
|
* silence the ungated-write warning for deployments that wired no policy at all.
|
|
25
25
|
*/
|
|
26
|
-
import type
|
|
26
|
+
import { type ToolPolicy, type AskRuleEvidence, type ToolCallRequest, type WholeToolRefusal } from "../tool-policy.js";
|
|
27
27
|
import { persistedRuleMandateOf, type RuleClearanceFacts, type RuleOffersAbsence } from "../ask-origin.js";
|
|
28
28
|
import { type OrgGateVerdict, type PersistedRuleAnswer, type PersistedRuleHit, type PersistedRuleUnreadable } from "../hooks.js";
|
|
29
29
|
import type { PersistedRule, PersistedRuleVerdict, RuleOffer, ScopeRootIdentity, SegmentCoverage } from "../permission-rule-model.js";
|
|
@@ -111,7 +111,11 @@ export interface PermissionRuleLanes {
|
|
|
111
111
|
} | undefined;
|
|
112
112
|
org: {
|
|
113
113
|
adjudicate: (req: ToolCallRequest) => Promise<OrgGateVerdict>;
|
|
114
|
+
refusesWholeOver: (resolution: OrgRuleResolution) => WholeToolRefusal;
|
|
114
115
|
} | undefined;
|
|
116
|
+
/** The tools the stored rules refuse every call of — the person's and the org's, over ONE read (a request's view is one
|
|
117
|
+
* judgment), a fold of the two readings; `undefined` when neither lane is wired. */
|
|
118
|
+
wholeToolRefusals: ToolPolicy["wholeToolRefusals"];
|
|
115
119
|
}
|
|
116
120
|
/** The ORG lane: the org's verdict about one call, off the store view `read` supplies — the gate's `orgRules` face over the
|
|
117
121
|
* call's pinned read ({@link createPermissionRuleLanes}), and {@link orgVerdictBeforeClaim} over a view of its own.
|
|
@@ -175,9 +179,10 @@ export declare function createPermissionRuleLanes(cfg: {
|
|
|
175
179
|
/** Sink for a judgment against the rows that threw, and for the org lane's degraded-snapshot line. */
|
|
176
180
|
onDisclosure: (message: string) => void;
|
|
177
181
|
/** The run's one reader of the person's rules: the call's ONE read of the bytes judged, pinned, that the read station, the
|
|
178
|
-
* org lane and the personal lane all take (the lanes consume a reader
|
|
182
|
+
* org lane and the personal lane all take, and a request's read the whole-tool readings take (the lanes consume a reader). */
|
|
179
183
|
rows: {
|
|
180
184
|
pin(toolCallId: string, judged?: unknown): Promise<PersonRowsRead>;
|
|
185
|
+
forRequest(): Promise<PersonRowsRead>;
|
|
181
186
|
};
|
|
182
187
|
/** The allow layer's auto strip over a stored ALLOW row (true ⇒ out of this call's table BEFORE the coverage is chosen). */
|
|
183
188
|
stripsAllow?: (rule: PersistedRule, req: ToolCallRequest) => boolean;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
import { REFUSES_NO_WHOLE_TOOL, 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.forRequest().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) => {
|
|
@@ -11,6 +11,17 @@
|
|
|
11
11
|
* table no longer holds that attempt. A judgment that is no call of the leg (a visibility probe's fixed id, a gate with no
|
|
12
12
|
* leg) keeps nothing: its rule lanes take a read of their own, its read station the run's latest tables.
|
|
13
13
|
*
|
|
14
|
+
* ## One read per request
|
|
15
|
+
*
|
|
16
|
+
* A model request's view of the tool table stands on one read per request ({@link PersonPathRows.forRequest}), asked when the
|
|
17
|
+
* request is sent: a read asked earlier may have been asked before a tool the request follows wrote a rule (a call's read
|
|
18
|
+
* always is; a visibility probe's may be — a changed-files scan outlives its turn's boundary). Two reads stand for a request
|
|
19
|
+
* instead, and ask the store nothing new: the prepare read, for the first request while no read has started after it (no
|
|
20
|
+
* call has been judged before it); and the newest read the store has left unanswered past its bound, asked since the
|
|
21
|
+
* previous request, while no read started after it has been answered — its verdict is the failure law's, the one a new read
|
|
22
|
+
* of the silent store would give. A store that answers slowly, or not at all, so costs a request at most one bound beyond its
|
|
23
|
+
* calls' own reads.
|
|
24
|
+
*
|
|
14
25
|
* ## The run's unit, one entry per partition
|
|
15
26
|
*
|
|
16
27
|
* Every read's outcome lands in the run's unit, per personal partition (the durable one — its user and project rows — and
|
|
@@ -113,6 +124,10 @@ export interface PersonPathRows {
|
|
|
113
124
|
* holds — a judgment reads the store, as the session rules' does. Any other judgment (no leg, or an id the table does not
|
|
114
125
|
* hold — a visibility probe) takes a read of its own, kept by nobody. Bounded ({@link PERSON_READ_BOUND_MS}); never rejects. */
|
|
115
126
|
pin(toolCallId: string, judged?: unknown): Promise<PersonRowsRead>;
|
|
127
|
+
/** The read one model request's view of the tool table stands on, which the request then holds: a read asked now — or,
|
|
128
|
+
* asking the store nothing new, the prepare read for the first request, and the newest read asked since the previous
|
|
129
|
+
* request that the store has left unanswered past its bound. Bounded ({@link PERSON_READ_BOUND_MS}); never rejects. */
|
|
130
|
+
forRequest(): Promise<PersonRowsRead>;
|
|
116
131
|
/** Settles once the tables a reader takes are compiled: a pinned call's own; any other reader's (no id, or a call holding
|
|
117
132
|
* no pin), the unit's newest — through every change that lands meanwhile, within {@link PATH_TABLES_READY_BOUND_MS} —
|
|
118
133
|
* or at `signal` or the run's cut ({@link PersonPathRowsConfig.signal}). Never rejects: a reader whose wait was cut
|
|
@@ -29,6 +29,10 @@ export function createPersonPathRows(cfg) {
|
|
|
29
29
|
const unit = { durable: { failedSeq: 0 }, session: { failedSeq: 0 } };
|
|
30
30
|
let seqs = 0;
|
|
31
31
|
const pins = new Map();
|
|
32
|
+
let prepared;
|
|
33
|
+
let silent;
|
|
34
|
+
let answeredSeq = 0;
|
|
35
|
+
let requestSeq = 0;
|
|
32
36
|
let compile;
|
|
33
37
|
const compiled = new Map();
|
|
34
38
|
let unitTables;
|
|
@@ -72,22 +76,40 @@ export function createPersonPathRows(cfg) {
|
|
|
72
76
|
raw = Promise.reject(err);
|
|
73
77
|
}
|
|
74
78
|
const outcomeOf = (view) => ({ seq, view: holdsPersonRows ? view : { ...view, rules: [] }, failed: holdsPersonRows ? failedOf(view) : new Set() });
|
|
79
|
+
const answer = () => void (answeredSeq = Math.max(answeredSeq, seq));
|
|
75
80
|
void raw.then((view) => {
|
|
81
|
+
answer();
|
|
76
82
|
for (const line of view.disclosures)
|
|
77
83
|
cfg.onDisclosure(line);
|
|
78
84
|
cfg.onRowsDropped(view.droppedRows);
|
|
79
85
|
if (holdsPersonRows && view.unreadable !== undefined)
|
|
80
86
|
announce(at, view.unreadable, view.unreadableSources);
|
|
81
87
|
land(outcomeOf(view));
|
|
82
|
-
},
|
|
83
|
-
|
|
84
|
-
const
|
|
88
|
+
}, answer);
|
|
89
|
+
const read = withGateTimeout(raw, PERSON_READ_BOUND_MS, cfg.signal, "personRules").then((view) => readOf(outcomeOf(view)), (err) => {
|
|
90
|
+
const failure = gateWaitFailureOf(err);
|
|
91
|
+
const cut = failure === "aborted";
|
|
85
92
|
const outcome = { seq, failed: new Set(partitions), why: thrownText(err), ...(cut ? { cut: true } : {}) };
|
|
86
93
|
land(outcome);
|
|
87
94
|
if (holdsPersonRows && !cut)
|
|
88
95
|
announce(at, outcome.why);
|
|
96
|
+
if (failure === "timeout" && seq > (silent?.seq ?? 0))
|
|
97
|
+
silent = { seq, read };
|
|
89
98
|
return readOf(outcome);
|
|
90
99
|
});
|
|
100
|
+
if (at === "prepare")
|
|
101
|
+
prepared = { seq, read };
|
|
102
|
+
return read;
|
|
103
|
+
};
|
|
104
|
+
const forRequest = () => {
|
|
105
|
+
const first = prepared;
|
|
106
|
+
prepared = undefined;
|
|
107
|
+
const s = silent;
|
|
108
|
+
const read = first !== undefined && first.seq === seqs ? first.read
|
|
109
|
+
: s !== undefined && s.seq > requestSeq && s.seq > answeredSeq ? s.read
|
|
110
|
+
: readOnce("call");
|
|
111
|
+
requestSeq = seqs;
|
|
112
|
+
return read;
|
|
91
113
|
};
|
|
92
114
|
const failedOf = (view) => view.unreadable !== undefined && (view.unreadableSources ?? []).length === 0 ? new Set(partitions) : new Set((view.unreadableSources ?? []).map(partitionOf).filter((p) => partitions.includes(p)));
|
|
93
115
|
const defect = (message) => {
|
|
@@ -245,6 +267,7 @@ export function createPersonPathRows(cfg) {
|
|
|
245
267
|
? readOnce("prepare").then(() => undefined)
|
|
246
268
|
: undefined,
|
|
247
269
|
pin,
|
|
270
|
+
forRequest,
|
|
248
271
|
tablesReady: (toolCallId, signal) => {
|
|
249
272
|
const p = pinOf(toolCallId);
|
|
250
273
|
const cut = signal === undefined || cfg.signal === undefined ? (signal ?? cfg.signal) : AbortSignal.any([signal, cfg.signal]);
|
|
@@ -271,7 +294,7 @@ export function createPersonPathRows(cfg) {
|
|
|
271
294
|
unexcludableUnder: (scope) => judging().readDeny.unexcludableUnder?.(scope) ?? false,
|
|
272
295
|
rowUnderRoot: (scope) => judging().readDeny.rowUnderRoot?.(scope) ?? null,
|
|
273
296
|
rowAtOrBelow: (path) => judging().readDeny.rowAtOrBelow?.(path) ?? null,
|
|
274
|
-
forCall: (id) => tablesFor(id).readDeny,
|
|
297
|
+
forCall: (id) => (id === undefined ? judging() : tablesFor(id)).readDeny,
|
|
275
298
|
});
|
|
276
299
|
const writeDeny = {
|
|
277
300
|
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
|
+
}
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
* cached view and never hands out a half-acquired resource.
|
|
15
15
|
*
|
|
16
16
|
* Throws pass through unchanged: `resume.session_not_found` (requireExisting fail-loud mapping),
|
|
17
|
-
* the `resume_at.*` target-validation refusals, `
|
|
17
|
+
* the `resume_at.*` target-validation refusals, `corrupt_session` for a log whose parent links loop back, and — after the
|
|
18
18
|
* bounded re-wake budget — the session conflict itself. A throw after a `resumeAt` branch landed first writes that branch
|
|
19
19
|
* back (`settleBranchWriteBack`); on success the branch is handed over with the session.
|
|
20
20
|
*/
|
|
@@ -25,6 +25,7 @@ import type { TaskSpec, ToolEffect } from "../types.js";
|
|
|
25
25
|
import type { PrepareResume } from "./contracts.js";
|
|
26
26
|
import { type ResumeAtBranch } from "./branch-writeback.js";
|
|
27
27
|
import { type LegWrites } from "./session-write-ledger.js";
|
|
28
|
+
import { replayLossLeg } from "./lineage-reroot-view.js";
|
|
28
29
|
export interface PrepareAcquireReconcileInput {
|
|
29
30
|
/** borrowed-mutable (service port) — the deployment's session store. This phase's verbs on it are
|
|
30
31
|
* the acquire/forget half of the session resource protocol: `acquire` per attempt, `forget` to
|
|
@@ -57,6 +58,8 @@ export interface PrepareAcquireReconcileInput {
|
|
|
57
58
|
report?: (err: Error, sessionId: string) => void;
|
|
58
59
|
/** borrowed-mutable (the Runner's) — this leg's view of the session write ledger, every storage write issued through it ({@link writesThroughLeg}); absent for a standalone prepare. */
|
|
59
60
|
legWrites?: LegWrites;
|
|
61
|
+
/** borrowed-readonly — where the leg says what the log's replay dropped, and re-rooted a branch at it ({@link replayLossLeg}): absent ⇒ nothing said and no re-root (a break is refused). */
|
|
62
|
+
replayLossNotice?: Parameters<typeof replayLossLeg>[0];
|
|
60
63
|
}
|
|
61
64
|
/** The phase's outputs (four-class form). All six are fresh bindings —
|
|
62
65
|
* the driver destructures them into consts, so a consumer moved ahead of this call is a lexical
|