@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
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
* put, when the leg settles) also when conversation content follows the newest record. A write that fails refuses its call (or its
|
|
12
12
|
* row) on a governed tree; a prepare's or a settle's, and any write on a tree that is not governed, mints
|
|
13
13
|
* `config.cross_boundary_record_unwritten`, once per state. A record says how the content before it is READ: a leg's end record also
|
|
14
|
-
* carries what the session is still owed — each unfinished background task the leg's
|
|
14
|
+
* carries what the session is still owed — each unfinished background task the leg's task access reaches, judged as the poll the
|
|
15
15
|
* session's next leg (another tree) would make of it, so its delivery is read under the bit it brings. A leg that takes over a
|
|
16
16
|
* session whose content no record covers (none on the branch, or after the newest), on an armed tree, reads that content as
|
|
17
17
|
* off-target.
|
|
@@ -94,7 +94,7 @@ export interface DecideVerdict {
|
|
|
94
94
|
}
|
|
95
95
|
/**
|
|
96
96
|
* Read and judge the host's decision facts — the ONE validation for every durable decide. `raw` is the caller's
|
|
97
|
-
* `hostDecision`, read ONCE by the lane (this function reads `decidedBy` and `
|
|
97
|
+
* `hostDecision`, read ONCE by the lane (this function reads `decidedBy`, `approver` and `decidedVia` once each, off it).
|
|
98
98
|
* - the facts are REQUIRED: absence (or a non-object) is refused — absence is not a fact about the wait, and core
|
|
99
99
|
* does not guess one;
|
|
100
100
|
* - `decidedBy` is a member of the closed set ({@link isHostDecider}); the sweep's word is the host's SLA sweep and
|
|
@@ -102,7 +102,9 @@ export interface DecideVerdict {
|
|
|
102
102
|
* the word would file a record of an event that row's contract says cannot happen;
|
|
103
103
|
* - WHO MAY ALLOW the row: not the sweep's word (a wait nobody answered), and not the policy on a row that demands a
|
|
104
104
|
* person (`policyCannotAnswer`, the synchronous seat's rule);
|
|
105
|
-
* - the attribution passes the shared screen (a bounded plain string) — refused rather than dropped
|
|
105
|
+
* - the attribution passes the shared screen (a bounded plain string) — refused rather than dropped;
|
|
106
|
+
* - `decidedVia`, when present, is a member of its closed set beside `decidedBy: "policy"` ({@link screenDecidedVia}, the
|
|
107
|
+
* synchronous seam's screen); a plan pause takes it under the same screen and its reminder reads `decidedBy` alone.
|
|
106
108
|
*/
|
|
107
109
|
export declare function captureHostDecision(cp: Checkpoint, raw: unknown, lane: DecideLane, verdict: DecideVerdict): HostDecisionFacts;
|
|
108
110
|
/** The origin word of the ask a pending row holds: a tool approval's was stamped on the park by the gate; a plan
|
|
@@ -2,10 +2,10 @@ import { isAskOrigin } from "../ask-origin.js";
|
|
|
2
2
|
import { isLiveQuestionFace, markBoundOnlyQuestionFace } from "../ask-question.js";
|
|
3
3
|
import { boundInputHashOf } from "../canonical-json.js";
|
|
4
4
|
import { CheckpointError } from "../checkpoint-store.js";
|
|
5
|
-
import { decidersNote, isHostDecider, settlementOfHostDecision } from "../gate-outcome.js";
|
|
5
|
+
import { decidersNote, isHostDecider, policyDeciderOf, settlementOfHostDecision } from "../gate-outcome.js";
|
|
6
6
|
import { formatHookFeedback } from "../hooks.js";
|
|
7
7
|
import { facetOf, isGateKind, isQuestionGate } from "../pause-registry.js";
|
|
8
|
-
import { humanRefusalSentence, policyCannotAnswer, screenApproverAttribution } from "../tool-policy.js";
|
|
8
|
+
import { humanRefusalSentence, policyCannotAnswer, screenApproverAttribution, screenDecidedVia } from "../tool-policy.js";
|
|
9
9
|
import { mintGateOutcome } from "./gate-exit.js";
|
|
10
10
|
import { delimitUntrusted, REVIEWER_NOTE_MAX_BODY } from "../untrusted-text.js";
|
|
11
11
|
import { writtenFeedback } from "./approval-feedback.js";
|
|
@@ -108,7 +108,10 @@ export function captureHostDecision(cp, raw, lane, verdict) {
|
|
|
108
108
|
if (attribution.defect !== undefined) {
|
|
109
109
|
throw new CheckpointError("checkpoint.invalid_outcome", `resume carries an approver attribution this engine refuses: ${attribution.defect}; refusing pre-CAS, the checkpoint stays pending`, { field: "approver" });
|
|
110
110
|
}
|
|
111
|
-
|
|
111
|
+
const via = screenDecidedVia(raw.decidedVia, decidedBy);
|
|
112
|
+
if (via.defect !== undefined)
|
|
113
|
+
throw new CheckpointError("checkpoint.invalid_outcome", `resume hostDecision carries a decidedVia this engine refuses: ${via.defect}; refusing pre-CAS, the checkpoint stays pending`, { field: "hostDecision" });
|
|
114
|
+
return { decidedBy, ...(attribution.approver !== undefined ? { approver: attribution.approver } : {}), ...(via.decidedVia !== undefined ? { decidedVia: via.decidedVia } : {}) };
|
|
112
115
|
}
|
|
113
116
|
export function parkedOriginOf(cp) {
|
|
114
117
|
if (cp.pendingAction.kind === "tool_approval")
|
|
@@ -183,6 +186,6 @@ export function resumeContinuation(resume, mark, fullShellReachable, delegatedCh
|
|
|
183
186
|
}
|
|
184
187
|
const decided = decision === "allow"
|
|
185
188
|
? "was APPROVED and has now been executed — its result is in the tool results above"
|
|
186
|
-
: `was DENIED ${hostDecision.decidedBy === "policy" ?
|
|
189
|
+
: `was DENIED ${hostDecision.decidedBy === "policy" ? `by ${policyDeciderOf(hostDecision.decidedVia).name}` : "because its approval window elapsed with no answer"}, not by a person — the refusal and its reason are in the tool results above`;
|
|
187
190
|
return formatHookFeedback(`The pending tool call "${pendingAction.toolName}" ${decided}. ${resumed}${carryOn}`, mark);
|
|
188
191
|
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { SessionStore } from "../session.js";
|
|
2
|
+
/**
|
|
3
|
+
* The delegation tree's owner as one run binds it: `bound` with the owner (`null` = the tree root's row is anonymous), or `unbound`
|
|
4
|
+
* when the row this run acquired no longer stands under its id (deleted, or deleted and created again for another occupant) the first
|
|
5
|
+
* time the owner is asked for — a child placed on that answer would record whoever holds the id now, not this tree's owner. `reason` is
|
|
6
|
+
* the engine's sentence; a read that threw carries what it threw in `fault` (the host's to read, never the model's text).
|
|
7
|
+
*/
|
|
8
|
+
export type DelegationOwnerReading = {
|
|
9
|
+
readonly bound: true;
|
|
10
|
+
readonly owner: string | null;
|
|
11
|
+
} | {
|
|
12
|
+
readonly bound: false;
|
|
13
|
+
readonly reason: string;
|
|
14
|
+
readonly fault?: unknown;
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* The delegation tree's owner: the owner cell of the tree root's row, as the root run read it — once. A run spawned by another run
|
|
18
|
+
* holds its spawner's seat (by reference, so the whole tree shares one reading); a run nobody spawned (a top-level run, a revived
|
|
19
|
+
* child, a parked child resumed on its own) holds a seat over the row it acquired itself ({@link ownRowDelegationOwner}). The first
|
|
20
|
+
* answer that binds or refuses is the answer for every later call; a read fault rejects and binds nothing.
|
|
21
|
+
*/
|
|
22
|
+
export interface DelegationOwnerSeat {
|
|
23
|
+
read(): Promise<DelegationOwnerReading>;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* The seat of a run nobody spawned: the owner of the row it acquired, read by id through its own store's {@link SessionStore.headOf}
|
|
27
|
+
* and taken only while the row's occupant is the one acquired — the head's `incarnation` equals the acquired session's metadata's
|
|
28
|
+
* (both absent = a row written before occupants were minted, taken as it reads). A store without a by-id read has no owner to read:
|
|
29
|
+
* the reading is `null`.
|
|
30
|
+
*/
|
|
31
|
+
export declare function ownRowDelegationOwner(sessions: Pick<SessionStore, "headOf">, sessionId: string, acquiredIncarnation: () => Promise<string | undefined>): DelegationOwnerSeat;
|
|
32
|
+
/** The refusal of a delegation whose tree owner does not bind ({@link DelegationOwnerReading}): the child is not started and no row is
|
|
33
|
+
* created for it. */
|
|
34
|
+
export declare const DELEGATION_OWNER_UNBOUND = "delegation.owner_unbound";
|
|
35
|
+
export declare function delegationOwnerUnbound(reason: string): Error & {
|
|
36
|
+
code: typeof DELEGATION_OWNER_UNBOUND;
|
|
37
|
+
};
|
|
38
|
+
/** The owner a seat binds, or `null` where no seat rides (a tool driven with no run around it has no tree root to read). */
|
|
39
|
+
export declare function delegationOwnerOf(seat: DelegationOwnerSeat | undefined): Promise<DelegationOwnerReading>;
|
|
40
|
+
/** A revived child's tree owner: the owner its own row records, read by id through the store it lives in (`null` where the store has
|
|
41
|
+
* no by-id read, or holds no row for the id — a revival of a missing row re-opens nothing). A row whose owner cell is not a name or
|
|
42
|
+
* `null` does not bind, as in the seat of a run nobody spawned. */
|
|
43
|
+
export declare function rowOwnerReading(sessions: Pick<SessionStore, "headOf">, sessionId: string | undefined): Promise<DelegationOwnerReading>;
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
function ownerCellReading(sessionId, head) {
|
|
2
|
+
const owner = head.owner;
|
|
3
|
+
if (owner === null || typeof owner === "string")
|
|
4
|
+
return { bound: true, owner };
|
|
5
|
+
return { bound: false, reason: `the session ${sessionId}'s row answers an owner that is neither a name nor anonymous (${owner === undefined ? "none" : typeof owner})` };
|
|
6
|
+
}
|
|
7
|
+
export function ownRowDelegationOwner(sessions, sessionId, acquiredIncarnation) {
|
|
8
|
+
let settled;
|
|
9
|
+
let inFlight;
|
|
10
|
+
const bind = async () => {
|
|
11
|
+
const headOf = sessions.headOf;
|
|
12
|
+
if (typeof headOf !== "function")
|
|
13
|
+
return { bound: true, owner: null };
|
|
14
|
+
const [head, acquired] = await Promise.all([headOf.call(sessions, sessionId), acquiredIncarnation()]);
|
|
15
|
+
if (head === undefined)
|
|
16
|
+
return { bound: false, reason: `the session ${sessionId} this run acquired has no row any more` };
|
|
17
|
+
if (head.incarnation !== acquired)
|
|
18
|
+
return { bound: false, reason: `the session ${sessionId} this run acquired now holds another occupant` };
|
|
19
|
+
return ownerCellReading(sessionId, head);
|
|
20
|
+
};
|
|
21
|
+
return {
|
|
22
|
+
read() {
|
|
23
|
+
if (settled !== undefined)
|
|
24
|
+
return Promise.resolve(settled);
|
|
25
|
+
inFlight ??= bind().then((reading) => {
|
|
26
|
+
settled = reading;
|
|
27
|
+
return reading;
|
|
28
|
+
}, (err) => {
|
|
29
|
+
inFlight = undefined;
|
|
30
|
+
throw err;
|
|
31
|
+
});
|
|
32
|
+
return inFlight;
|
|
33
|
+
},
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
export const DELEGATION_OWNER_UNBOUND = "delegation.owner_unbound";
|
|
37
|
+
export function delegationOwnerUnbound(reason) {
|
|
38
|
+
return Object.assign(new Error(`the delegation tree's owner does not bind: ${reason}`), { code: DELEGATION_OWNER_UNBOUND });
|
|
39
|
+
}
|
|
40
|
+
async function settled(read) {
|
|
41
|
+
try {
|
|
42
|
+
return await read();
|
|
43
|
+
}
|
|
44
|
+
catch (err) {
|
|
45
|
+
return { bound: false, reason: "the row that names it could not be read", fault: err };
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
export function delegationOwnerOf(seat) {
|
|
49
|
+
return seat === undefined ? Promise.resolve({ bound: true, owner: null }) : settled(() => seat.read());
|
|
50
|
+
}
|
|
51
|
+
export function rowOwnerReading(sessions, sessionId) {
|
|
52
|
+
return settled(async () => {
|
|
53
|
+
const headOf = sessions.headOf;
|
|
54
|
+
if (typeof headOf !== "function" || sessionId === undefined)
|
|
55
|
+
return { bound: true, owner: null };
|
|
56
|
+
const head = await headOf.call(sessions, sessionId);
|
|
57
|
+
return head === undefined ? { bound: true, owner: null } : ownerCellReading(sessionId, head);
|
|
58
|
+
});
|
|
59
|
+
}
|
|
@@ -4,7 +4,7 @@ import { type ClassifierUnavailableSeat } from "../classifier-unavailable-arm.js
|
|
|
4
4
|
import { type PermissionResult, type ResolvedAsk, type ToolCallRequest } from "../tool-policy.js";
|
|
5
5
|
import { type Settlement } from "../gate-outcome.js";
|
|
6
6
|
import { type EngineNotice } from "../types.js";
|
|
7
|
-
import { type AskClass, type AskClassFacts, type AskClassification, type AskOrigin, type
|
|
7
|
+
import { type AskClass, type AskClassFacts, type AskClassification, type AskOrigin, type AskReason } from "../ask-origin.js";
|
|
8
8
|
import type { Prepared, StopForDenialLimit } from "./contracts.js";
|
|
9
9
|
/**
|
|
10
10
|
* The classifier DENIAL-LIMIT arms of the tool gate's inherited (delegation) lane, extracted
|
|
@@ -89,23 +89,6 @@ export declare function createDenialLimitStop(opts: {
|
|
|
89
89
|
export type InheritedAsk = Extract<PermissionResult, {
|
|
90
90
|
action: "ask";
|
|
91
91
|
}>;
|
|
92
|
-
/**
|
|
93
|
-
* The delegation half of the live gate's classifier eligibility: the SAME class row (`classifyAsk` over the
|
|
94
|
-
* ask's own members) answers for the FROZEN classifier — an ask raised by a hook, minted by an
|
|
95
|
-
* explicit `ask` permission rule, or already a denial-limit fallback is exactly as out of the frozen
|
|
96
|
-
* decider's reach as the live one's, because the person's / hook's standing decision travels with the
|
|
97
|
-
* frozen entry and a frozen decider resolving it would re-open the same hole one process over. The
|
|
98
|
-
* three GATE-HELD facts of the derivation are not this station's to judge: an ancestor's frozen
|
|
99
|
-
* classifier runs inside the policy fold, BEFORE the live gate's org layer has spoken and before its
|
|
100
|
-
* question-tool and marked-call lanes run, so they read as absent here and those asks meet their
|
|
101
|
-
* exclusions downstream, where the facts exist. Excluded asks fall through to the frozen approver
|
|
102
|
-
* chain, the delegation lane's original chain. The word and the class set are derived inside
|
|
103
|
-
* {@link judgeInheritedClassifier} and threaded to every reader ({@link inheritedAskCarry}).
|
|
104
|
-
* The MANDATE marks here are empty (the base names no seat): the policy-chain phase builds each call's facts over this
|
|
105
|
-
* base with THIS task's tool seat — the seat the request's risk axes are read from — so a marked tool's ask is
|
|
106
|
-
* classified by the seat at the station as at the gate. What the ancestor's ask carries on ITSELF still answers. No call either (each station's own).
|
|
107
|
-
*/
|
|
108
|
-
export declare const INHERITED_STATION_FACTS: Omit<AskOriginFacts, "call">;
|
|
109
92
|
/** The members of a surviving ask that ride onto the approval request with a COMPUTED value — what the
|
|
110
93
|
* four request mint stations (the gate's own and the three inherited-lane ones) spread after the seats
|
|
111
94
|
* they spell themselves: the ask's origin word, its class (the word and the set, carried together) and its
|
|
@@ -116,6 +99,9 @@ export interface AskRequestCarry {
|
|
|
116
99
|
classes?: readonly AskClass[];
|
|
117
100
|
denialLimitFallback?: DenialLimitFallback;
|
|
118
101
|
classifierNoRuling?: AutoModeFallbackCause;
|
|
102
|
+
/** The askers' own words ({@link import("../ask-origin.js").AskReason}), as the gate's stamp left them or as an inherited
|
|
103
|
+
* station read them off the ancestor's ask. */
|
|
104
|
+
askReasons?: readonly AskReason[];
|
|
119
105
|
}
|
|
120
106
|
/** The GATE's own mint station: every member is read off the surviving decision, which is the gate's
|
|
121
107
|
* OWN snapshot (its stamp point spreads the policy's object and stamps the word and the class onto the copy),
|
|
@@ -131,7 +117,7 @@ export declare function gateAskCarry(decision: InheritedAsk, liveApprover: boole
|
|
|
131
117
|
* read). */
|
|
132
118
|
export declare function inheritedAskCarry(judged: Pick<Extract<InheritedClassifierJudgment<InheritedAsk>, {
|
|
133
119
|
kind: "resolve";
|
|
134
|
-
}>, "origin" | "classification" | "fallback" | "ask">, liveApprover: boolean, tracker: AutoModeDenialTracker | undefined): AskRequestCarry;
|
|
120
|
+
}>, "origin" | "classification" | "fallback" | "ask" | "askReasons">, liveApprover: boolean, tracker: AutoModeDenialTracker | undefined): AskRequestCarry;
|
|
135
121
|
/** What {@link judgeInheritedClassifier} hands back to the arm that called it. */
|
|
136
122
|
export type InheritedClassifierJudgment<A extends InheritedAsk> =
|
|
137
123
|
/** The frozen classifier allowed. `result` is the allow the arm RETURNS — minted at the judging station so
|
|
@@ -167,6 +153,7 @@ export type InheritedClassifierJudgment<A extends InheritedAsk> =
|
|
|
167
153
|
origin: AskOrigin;
|
|
168
154
|
classification: AskClassification;
|
|
169
155
|
noRulingHere?: true;
|
|
156
|
+
askReasons?: readonly AskReason[];
|
|
170
157
|
};
|
|
171
158
|
/**
|
|
172
159
|
* The ancestor's frozen classifier, run BEFORE its frozen approver in the ancestor's own gate order,
|
|
@@ -213,12 +200,18 @@ export declare function judgeInheritedClassifier<A extends InheritedAsk>(opts: {
|
|
|
213
200
|
/** The station's facts for this call (the base with this task's tool seat); absent ⇒ {@link INHERITED_STATION_FACTS}. */
|
|
214
201
|
facts?: AskClassFacts;
|
|
215
202
|
}): Promise<InheritedClassifierJudgment<A>>;
|
|
203
|
+
/** The ancestor's ask as an inherited station floats it back into this leg's fold (its approver unavailable): the askers the station
|
|
204
|
+
* read before narrating it ride the engine's record, so the gate's receipt reads them, not the narrated sentence. */
|
|
205
|
+
export declare function floatedInheritedAsk<A extends InheritedAsk>(judged: Pick<ResolveJudgment<A>, "ask" | "askReasons">, call: {
|
|
206
|
+
toolCallId: string;
|
|
207
|
+
toolName: string;
|
|
208
|
+
}): A;
|
|
216
209
|
/** The fallback an inherited station hands its frozen approver, minted ONCE for both ways a bound is reached (a counted ruling
|
|
217
210
|
* refusal; a no-ruling card the approver's POLICY refused, {@link settleNoRulingAsk}) — its own object, word and class set. */
|
|
218
211
|
type ResolveJudgment<A extends InheritedAsk> = Extract<InheritedClassifierJudgment<A>, {
|
|
219
212
|
kind: "resolve";
|
|
220
213
|
}>;
|
|
221
|
-
export declare function inheritedFallbackJudgment<A extends InheritedAsk>(ask: A, fallback: UnarmedDenialLimitFallback, latestBlockedAction: string, facts: AskClassFacts): ResolveJudgment<A>;
|
|
214
|
+
export declare function inheritedFallbackJudgment<A extends InheritedAsk>(ask: A, fallback: UnarmedDenialLimitFallback, latestBlockedAction: string, facts: AskClassFacts, askReasons: readonly AskReason[] | undefined): ResolveJudgment<A>;
|
|
222
215
|
/** One resolution of an inherited ask at its frozen approver (the three arms): a no-ruling card its POLICY refused counts
|
|
223
216
|
* ({@link settleNoRulingAsk}); at the bound the call is resolved again there as the fallback. Returns the judgment it answered. */
|
|
224
217
|
export declare function resolveInheritedAsk<A extends InheritedAsk>(judged: ResolveJudgment<A>, resolveWith: (j: ResolveJudgment<A>) => Promise<ResolvedAsk>, tracker: AutoModeDenialTracker | undefined, call: {
|
|
@@ -277,7 +270,8 @@ export declare function lateAskSettlementObserver(args: {
|
|
|
277
270
|
toolCallId: string;
|
|
278
271
|
sessionId: string;
|
|
279
272
|
runId: string;
|
|
280
|
-
taskId
|
|
273
|
+
/** The leg's own task id (`Prepared.taskId`), always present. */
|
|
274
|
+
taskId: string;
|
|
281
275
|
onNotice: import("../types.js").RunnerDeps["onNotice"];
|
|
282
276
|
onError: import("../types.js").RunnerDeps["onError"];
|
|
283
277
|
}): (late: {
|
|
@@ -4,9 +4,10 @@ import { sanitizeAutoModeArmingRecipe, tightenDenialLimit } from "../auto-mode-a
|
|
|
4
4
|
import { classifierNoRulingArm, settleNoRulingAsk } from "../classifier-unavailable-arm.js";
|
|
5
5
|
import { attest, attestationOf } from "../tool-policy.js";
|
|
6
6
|
import { SETTLEMENT_NOBODY_JUDGED } from "../gate-outcome.js";
|
|
7
|
+
import { legNoticeTaskId } from "../mods/stations.js";
|
|
7
8
|
import { deliverEngineNotice } from "../types.js";
|
|
8
9
|
import { inlineUntrusted } from "../untrusted-text.js";
|
|
9
|
-
import { askClassMembersOf, askOriginOf, classifyAsk } from "../ask-origin.js";
|
|
10
|
+
import { askClassMembersOf, askOriginOf, askReasonsOf, chainAskReasonsOf, classifyAsk, INHERITED_STATION_FACTS } from "../ask-origin.js";
|
|
10
11
|
export function attachRebuiltDenialTrackers(entries, denialLimit) {
|
|
11
12
|
if (entries === undefined)
|
|
12
13
|
return undefined;
|
|
@@ -60,7 +61,6 @@ export function createDenialLimitStop(opts) {
|
|
|
60
61
|
};
|
|
61
62
|
return { gateStopRef, stopForDenialLimit };
|
|
62
63
|
}
|
|
63
|
-
export const INHERITED_STATION_FACTS = { contentQuestion: false, markedUnresolvable: false, org: undefined, tightened: undefined, mandateMarks: {} };
|
|
64
64
|
const noRulingCarry = (why) => (isAutoModeFallbackCause(why) ? { classifierNoRuling: why } : {});
|
|
65
65
|
function fallbackCarry(fallback, liveApprover, tracker) {
|
|
66
66
|
if (fallback === undefined)
|
|
@@ -73,6 +73,7 @@ export function gateAskCarry(decision, liveApprover, tracker) {
|
|
|
73
73
|
...(decision.askClass !== undefined && decision.classes !== undefined ? { askClass: decision.askClass, classes: decision.classes } : {}),
|
|
74
74
|
...fallbackCarry(decision.denialLimitFallback, liveApprover, tracker),
|
|
75
75
|
...noRulingCarry(decision.classifierNoRuling),
|
|
76
|
+
...askReasonsOf(decision),
|
|
76
77
|
};
|
|
77
78
|
}
|
|
78
79
|
export function inheritedAskCarry(judged, liveApprover, tracker) {
|
|
@@ -81,6 +82,7 @@ export function inheritedAskCarry(judged, liveApprover, tracker) {
|
|
|
81
82
|
...askClassMembersOf(judged.classification),
|
|
82
83
|
...fallbackCarry(judged.fallback, liveApprover, tracker),
|
|
83
84
|
...noRulingCarry(judged.ask.classifierNoRuling),
|
|
85
|
+
...(judged.askReasons !== undefined && judged.askReasons.length > 0 ? { askReasons: judged.askReasons } : {}),
|
|
84
86
|
};
|
|
85
87
|
}
|
|
86
88
|
export const inheritedAskFallbackMessage = (toolName) => `approval required for "${toolName}" (inherited parent policy)`;
|
|
@@ -88,6 +90,8 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
88
90
|
const { autoMode, req } = opts;
|
|
89
91
|
const facts = opts.facts ?? { ...INHERITED_STATION_FACTS, call: req }, m = facts.mandateMarks;
|
|
90
92
|
const frames = [...(m.egress === true ? [markTightenMessage(req.toolName, "egress")] : []), ...(m.irreversibility === "always" ? [markTightenMessage(req.toolName, "irreversible")] : [])];
|
|
93
|
+
const askReasons = opts.ask.askReasons ?? chainAskReasonsOf(opts.ask, req);
|
|
94
|
+
const reasoned = askReasons !== undefined ? { askReasons } : {};
|
|
91
95
|
const ask = (frames.length > 0 ? { ...opts.ask, message: [opts.ask.message ?? inheritedAskFallbackMessage(req.toolName), ...frames].join(" — ") } : opts.ask);
|
|
92
96
|
const origin = askOriginOf(ask, facts);
|
|
93
97
|
const classification = classifyAsk(ask, facts);
|
|
@@ -96,13 +100,13 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
96
100
|
return live === "dontAsk" || live === "bypassPermissions" || live === "plan" || (autoMode?.liveMode !== undefined && autoMode.liveMode.current !== "auto");
|
|
97
101
|
};
|
|
98
102
|
if (autoMode === undefined || classifierStandsDown() || !classification.row.classifierEligible) {
|
|
99
|
-
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification };
|
|
103
|
+
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification, ...reasoned };
|
|
100
104
|
}
|
|
101
105
|
const verdict = await autoMode.decider
|
|
102
106
|
.decide({ req, ...(ask.message !== undefined ? { askMessage: ask.message } : {}) }, opts.signal)
|
|
103
107
|
.catch(() => ({ kind: "unavailable", cause: "error" }));
|
|
104
108
|
if (verdict.kind === "allow" && classifierStandsDown())
|
|
105
|
-
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification };
|
|
109
|
+
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification, ...reasoned };
|
|
106
110
|
const attributed = (d) => (verdict.classifier !== undefined ? attest(d, req, { classifierRound: verdict.classifier }) : d);
|
|
107
111
|
if (verdict.kind === "allow") {
|
|
108
112
|
autoMode.denialTracking?.recordAllow();
|
|
@@ -111,7 +115,7 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
111
115
|
const noRuling = rungDidNotRule(verdict);
|
|
112
116
|
const arm = noRuling !== undefined ? classifierNoRulingArm({ ask, req, cause: noRuling, seat: opts.unavailableSeat, aborted: opts.signal.aborted }) : undefined;
|
|
113
117
|
if (arm?.kind === "asked")
|
|
114
|
-
return { kind: "resolve", ask: arm.ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification: classifyAsk(arm.ask, facts), noRulingHere: true };
|
|
118
|
+
return { kind: "resolve", ask: arm.ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification: classifyAsk(arm.ask, facts), noRulingHere: true, ...reasoned };
|
|
115
119
|
if (arm?.kind === "denied")
|
|
116
120
|
return { kind: "deny", result: attributed(arm.deny) };
|
|
117
121
|
const reason = verdict.kind === "block" ? (verdict.reason ? inlineUntrusted(verdict.reason) : "") : classifierParseFailureDenyMessage(verdict.classifier);
|
|
@@ -125,19 +129,22 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
125
129
|
};
|
|
126
130
|
return { kind: "deny", result: attributed(verdict.kind === "parse_error" ? attest(denied, req, { classifierCause: "parse_error" }) : denied) };
|
|
127
131
|
}
|
|
128
|
-
return inheritedFallbackJudgment(ask, tracked.fallback, reason || category || req.toolName, facts);
|
|
132
|
+
return inheritedFallbackJudgment(ask, tracked.fallback, reason || category || req.toolName, facts, askReasons);
|
|
129
133
|
}
|
|
130
|
-
export function
|
|
134
|
+
export function floatedInheritedAsk(judged, call) {
|
|
135
|
+
return attest(judged.ask, call, { receivedAskReasons: judged.askReasons ?? [] });
|
|
136
|
+
}
|
|
137
|
+
export function inheritedFallbackJudgment(ask, fallback, latestBlockedAction, facts, askReasons) {
|
|
131
138
|
const { classifierNoRuling: _why, ...standing } = ask;
|
|
132
139
|
const minted = { ...standing, message: denialLimitFallbackMessage(fallback, latestBlockedAction), decisionReason: "classifier", requiresRealApproval: true, denialLimitFallback: fallback };
|
|
133
|
-
return { kind: "resolve", ask: minted, fallback, mintedHere: true, origin: askOriginOf(minted, facts), classification: classifyAsk(minted, facts) };
|
|
140
|
+
return { kind: "resolve", ask: minted, fallback, mintedHere: true, origin: askOriginOf(minted, facts), classification: classifyAsk(minted, facts), ...(askReasons !== undefined ? { askReasons } : {}) };
|
|
134
141
|
}
|
|
135
142
|
export async function resolveInheritedAsk(judged, resolveWith, tracker, call, facts) {
|
|
136
143
|
const resolved = await resolveWith(judged);
|
|
137
144
|
const refallback = settleNoRulingAsk({ ask: judged.ask, mintedHere: judged.noRulingHere === true, resolved: fallbackResolutionOf(resolved, call), tracker });
|
|
138
145
|
if (refallback === undefined)
|
|
139
146
|
return { resolved, judged };
|
|
140
|
-
const again = inheritedFallbackJudgment(judged.ask, refallback, call.toolName, facts);
|
|
147
|
+
const again = inheritedFallbackJudgment(judged.ask, refallback, call.toolName, facts, judged.askReasons);
|
|
141
148
|
return { resolved: await resolveWith(again), judged: again };
|
|
142
149
|
}
|
|
143
150
|
export const fallbackResolutionOf = (r, call) => ({ action: r.action, settlement: attestationOf(r, call)?.settlement, ...(r.approverUnavailable === true ? { approverUnavailable: true } : {}) });
|
|
@@ -173,7 +180,7 @@ export function lateAskSettlementObserver(args) {
|
|
|
173
180
|
toolCallId: args.toolCallId,
|
|
174
181
|
sessionId: args.sessionId,
|
|
175
182
|
runId: args.runId,
|
|
176
|
-
...(args
|
|
183
|
+
...legNoticeTaskId(args),
|
|
177
184
|
},
|
|
178
185
|
});
|
|
179
186
|
return;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The single-shot TERMINAL settle of a pending checkpoint row by an actor of THIS Runner, and the duty an expired row carries — one
|
|
3
|
+
* statement for the actors that settle a row so: the resume preflight's terminal arm (the deployment ruled the binding dead),
|
|
4
|
+
* `Runner.voidVerifierPause` (the host voids a verifier's own card) and the stream-side reap of a suspended run.
|
|
5
|
+
*
|
|
6
|
+
* `expire` races `resolve` on the same pending row and exactly one settler wins; `expired` is terminal (an expired token is never
|
|
7
|
+
* redeemed again — reopen serves resolved rows only). So the duty is keyed on the ROW, not on who won: once the row is expired, the
|
|
8
|
+
* token's parked parent-constraint entry is evicted and, when THIS process holds the paused env, its reap record is TAKEN (one
|
|
9
|
+
* synchronous take — the record is the ownership token, so two observers never destroy twice) and the env destroyed, BOUNDED (a
|
|
10
|
+
* wedged adapter must not hold the settle's answer hostage: a timeout or throw goes to `onDestroyError`, never masks the settle).
|
|
11
|
+
* The winner runs it; a settler that LOSES reads what the row is now and runs the same duty when it finds it `expired` — another
|
|
12
|
+
* Runner, the deployment reaper or an earlier settler expired it, and none of them holds this process's env. A row the loser finds
|
|
13
|
+
* anything else (a resume resolved it and owns the env) keeps its env and its record. A store throw on the settle closes this
|
|
14
|
+
* attempt's claim and propagates; a throw reading the row after a loss is said and the record kept for a later settle to act on.
|
|
15
|
+
*/
|
|
16
|
+
import type { CheckpointStore, CheckpointToken } from "../checkpoint-store.js";
|
|
17
|
+
import type { LocalClaims } from "./local-claims.js";
|
|
18
|
+
import type { InheritedGate, SuspendReap } from "./contracts.js";
|
|
19
|
+
export interface ExpireRowInput {
|
|
20
|
+
/** borrowed-readonly — the row's token and its OWN scope (read off the row, never the caller's). */
|
|
21
|
+
token: CheckpointToken;
|
|
22
|
+
scope: string;
|
|
23
|
+
/** borrowed-readonly — the store the row lives in. */
|
|
24
|
+
store: CheckpointStore;
|
|
25
|
+
/** borrowed-mutable — the Runner's same-Runner claims: this attempt opens its own with the CAS and closes it once the duty is decided. */
|
|
26
|
+
locallyClaimedTokens: LocalClaims;
|
|
27
|
+
/** borrowed-mutable — the Runner's parked-constraint registry: the token's entry is evicted once the row is expired. */
|
|
28
|
+
parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
|
|
29
|
+
/** borrowed-mutable — the Runner's suspended-env reap handles: whoever runs the expired duty takes and retires this token's. */
|
|
30
|
+
suspendedEnvReaps: Map<CheckpointToken, SuspendReap>;
|
|
31
|
+
/** borrowed-readonly — the bounded destroy's label, and where its timeout or throw (or a failed read after a loss) is said, with the parked session. */
|
|
32
|
+
destroyLabel: string;
|
|
33
|
+
onDestroyError: (err: unknown, sessionId: string) => void;
|
|
34
|
+
}
|
|
35
|
+
/** Settle the row `expired`; `true` = this call won the CAS, `false` = another settler already had (the duty still runs if the row is expired). */
|
|
36
|
+
export declare function expireRowWithDuty(input: ExpireRowInput): Promise<boolean>;
|
|
37
|
+
/**
|
|
38
|
+
* A settle attempt of this Runner LOST its CAS: read the row, and run the expired duty when it is `expired`. Answers what was seen —
|
|
39
|
+
* the row's status, `"absent"` (no row), or `undefined` (nothing held here to act on, or the read threw: said, record kept) — and
|
|
40
|
+
* never throws.
|
|
41
|
+
*/
|
|
42
|
+
export declare function settleLostRow(input: Omit<ExpireRowInput, "scope" | "locallyClaimedTokens">): Promise<"pending" | "resolved" | "expired" | "absent" | undefined>;
|
|
43
|
+
/** The expired row's duty in THIS Runner: evict the parked constraint, take the reap record, destroy its env (bounded). */
|
|
44
|
+
export declare function runExpiredDuty(input: Omit<ExpireRowInput, "scope" | "store" | "locallyClaimedTokens">): Promise<void>;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { hasDestroy } from "../remote-env.js";
|
|
2
|
+
import { settleTeardownLeg } from "./teardown-bounded.js";
|
|
3
|
+
export async function expireRowWithDuty(input) {
|
|
4
|
+
const { token, scope, store, locallyClaimedTokens } = input;
|
|
5
|
+
locallyClaimedTokens.open(token);
|
|
6
|
+
let won;
|
|
7
|
+
try {
|
|
8
|
+
won = await store.expire(token, scope);
|
|
9
|
+
}
|
|
10
|
+
catch (expireErr) {
|
|
11
|
+
locallyClaimedTokens.close(token);
|
|
12
|
+
throw expireErr;
|
|
13
|
+
}
|
|
14
|
+
locallyClaimedTokens.close(token);
|
|
15
|
+
if (!won) {
|
|
16
|
+
await settleLostRow(input);
|
|
17
|
+
return false;
|
|
18
|
+
}
|
|
19
|
+
await runExpiredDuty(input);
|
|
20
|
+
return true;
|
|
21
|
+
}
|
|
22
|
+
export async function settleLostRow(input) {
|
|
23
|
+
const { token, store, suspendedEnvReaps } = input;
|
|
24
|
+
const reap = suspendedEnvReaps.get(token);
|
|
25
|
+
if (reap === undefined)
|
|
26
|
+
return undefined;
|
|
27
|
+
let status;
|
|
28
|
+
try {
|
|
29
|
+
status = (await store.get(token))?.status ?? "absent";
|
|
30
|
+
}
|
|
31
|
+
catch (readErr) {
|
|
32
|
+
say(input, readErr, reap.sessionId);
|
|
33
|
+
return undefined;
|
|
34
|
+
}
|
|
35
|
+
if (status === "expired")
|
|
36
|
+
await runExpiredDuty(input);
|
|
37
|
+
return status;
|
|
38
|
+
}
|
|
39
|
+
export async function runExpiredDuty(input) {
|
|
40
|
+
const { token, parentConstraintRegistry, suspendedEnvReaps, destroyLabel } = input;
|
|
41
|
+
parentConstraintRegistry.delete(token);
|
|
42
|
+
const reap = suspendedEnvReaps.get(token);
|
|
43
|
+
suspendedEnvReaps.delete(token);
|
|
44
|
+
if (reap === undefined || reap.env === undefined)
|
|
45
|
+
return;
|
|
46
|
+
const { env, sessionId } = reap;
|
|
47
|
+
await settleTeardownLeg(() => (hasDestroy(env) ? env.destroy() : undefined), destroyLabel, (envErr) => say(input, envErr, sessionId));
|
|
48
|
+
}
|
|
49
|
+
function say(input, err, sessionId) {
|
|
50
|
+
try {
|
|
51
|
+
input.onDestroyError(err, sessionId);
|
|
52
|
+
}
|
|
53
|
+
catch {
|
|
54
|
+
}
|
|
55
|
+
}
|
|
@@ -155,9 +155,9 @@ export declare function probeGitStatusLane(args: {
|
|
|
155
155
|
};
|
|
156
156
|
handsEnabled: boolean;
|
|
157
157
|
taskRoot: string;
|
|
158
|
-
/** The byte floor of the
|
|
159
|
-
*
|
|
160
|
-
readFloor?: ReadFloor;
|
|
158
|
+
/** The byte floor of the snapshot's start, read as it starts: the run's base read-deny table (`git config` reads what an
|
|
159
|
+
* `include.path` names). A floor that cannot be read degrades the frame, as a failed snapshot does. */
|
|
160
|
+
readFloor?: () => ReadFloor | undefined;
|
|
161
161
|
onDegrade: (reason: string) => void;
|
|
162
162
|
}): Promise<GitStatusLaneRef>;
|
|
163
163
|
/**
|
|
@@ -75,7 +75,8 @@ export async function probeGitStatusLane(args) {
|
|
|
75
75
|
...(envFacts.gitDirty !== undefined ? { dirty: envFacts.gitDirty } : {}),
|
|
76
76
|
};
|
|
77
77
|
try {
|
|
78
|
-
const
|
|
78
|
+
const snapFloor = readFloor?.();
|
|
79
|
+
const snap = await executionEnv.exec(`(m=$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null); m=\${m#origin/}; for s in "$m" main master; do if [ -n "$s" ] && git show-ref --verify --quiet "refs/remotes/origin/$s"; then echo "$s"; break; fi; done) || true; echo "${SEP}"; (git config user.name 2>/dev/null || true); echo "${SEP}"; gs=$(git --no-optional-locks status --short) || exit 41; printf '%s\\n' "$gs"; echo "${SEP}"; gl=$(git --no-optional-locks log --oneline -n 5) || exit 42; printf '%s\\n' "$gl"`, { cwd: envFacts.cwd, timeout: 10, ...(snapFloor !== undefined ? { readFloor: snapFloor } : {}) });
|
|
79
80
|
if (snap.ok && snap.value.exitCode === 0) {
|
|
80
81
|
const parts = snap.value.stdout.split(`${SEP}\n`);
|
|
81
82
|
if (parts.length === 4) {
|
|
@@ -21,7 +21,8 @@ export interface UnconsumedHaltDisclosureInput {
|
|
|
21
21
|
onNotice: RunnerDeps["onNotice"];
|
|
22
22
|
sessionId: string;
|
|
23
23
|
runId: string;
|
|
24
|
-
taskId
|
|
24
|
+
/** The leg's own task id (`Prepared.taskId`) — always present. */
|
|
25
|
+
taskId: string;
|
|
25
26
|
}
|
|
26
27
|
/**
|
|
27
28
|
* The ACCEPTED-but-UNCONSUMED halt: the verb latched the stop (and may have cut a seat), but the run ended for
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { legNoticeTaskId } from "../mods/stations.js";
|
|
1
2
|
import { deliverEngineNotice } from "../types.js";
|
|
2
3
|
export function haltConsumed(c) {
|
|
3
4
|
return c?.turnCut === "halt" || c?.boundaryStop?.sources.includes("halt") === true;
|
|
@@ -10,7 +11,7 @@ export function discloseUnconsumedHalt(input) {
|
|
|
10
11
|
message: "a user halt was accepted, but the run ended for its own reason before the halt stopped or cut anything: " +
|
|
11
12
|
"no turn was settled as its cut and no boundary stopped for it — the run's own ending stands, and the result " +
|
|
12
13
|
"will not carry haltedByUser for this halt.",
|
|
13
|
-
detail: { sessionId: input.sessionId, runId: input.runId, ...(input
|
|
14
|
+
detail: { sessionId: input.sessionId, runId: input.runId, ...legNoticeTaskId(input) },
|
|
14
15
|
});
|
|
15
16
|
return true;
|
|
16
17
|
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A run continues a session whose log lost records: the leg's view of the session's storage tells the run what the replay that loaded the
|
|
3
|
+
* log dropped (`SessionStorage.getReplayLoss`), at the first branch read of the run. Two findings, one notice a leg:
|
|
4
|
+
*
|
|
5
|
+
* - the branch read broke at a parent the log does not hold, and the replay dropped records (the {@link LineageBreak}'s `replayLoss`) —
|
|
6
|
+
* the evidence that the missing parent may be one of them: the branch ends at the entry that names it, the entries that survive below
|
|
7
|
+
* the break are the conversation the run continues, and the finding is a `break`;
|
|
8
|
+
* - the branch is whole but the replay dropped records (the log's last records were unreadable and its head fell back to the last one
|
|
9
|
+
* still readable, or the damage sat off the branch): the finding is the count and the head the run continues from.
|
|
10
|
+
*
|
|
11
|
+
* The stop is the walk's own floor stop (`pathToRoot` with the break's child as the floor), so no second walk exists. A break the
|
|
12
|
+
* replay cannot account for (it dropped nothing: a log written with a parent it never held) is refused as it was — `corrupt_session` —
|
|
13
|
+
* and so is every reader outside a run (a fork, an export, the store kit), which gets no announcement and so no re-root.
|
|
14
|
+
*/
|
|
15
|
+
import { type SessionStorage } from "../../internal/harness.js";
|
|
16
|
+
import type { NoticeSeatInput } from "./notice-seat-input.js";
|
|
17
|
+
/** What a branch read found of the records the log's replay dropped: the replay's count, the head the branch was read from (`null` = nothing
|
|
18
|
+
* of the log is readable) and the branch's length. */
|
|
19
|
+
export interface BranchLoss {
|
|
20
|
+
readonly recordsDropped: number;
|
|
21
|
+
readonly recordsTotal: number;
|
|
22
|
+
readonly leaf: string | null;
|
|
23
|
+
readonly entriesOnPath: number;
|
|
24
|
+
}
|
|
25
|
+
/** What one re-rooted branch read found besides: the parent the log does not hold, the entry the branch now starts at, and how many entries
|
|
26
|
+
* of the log do not descend from that entry (the history above the break, and its side branches). */
|
|
27
|
+
export interface LineageReroot extends BranchLoss {
|
|
28
|
+
readonly leaf: string;
|
|
29
|
+
readonly missingParentId: string;
|
|
30
|
+
readonly rootedAt: string;
|
|
31
|
+
readonly entriesCut: number;
|
|
32
|
+
}
|
|
33
|
+
/** What a branch read found: the branch broke (and was ended at the break), or it is whole and the replay dropped records. */
|
|
34
|
+
export type ReplayLossFinding = ({
|
|
35
|
+
readonly break: false;
|
|
36
|
+
} & BranchLoss) | ({
|
|
37
|
+
readonly break: true;
|
|
38
|
+
} & LineageReroot);
|
|
39
|
+
/** The leg's view of `storage`: every member as the storage answers it, but a branch read that breaks at a replay-proven loss ends at the
|
|
40
|
+
* break, and a branch read in a log whose replay dropped records is reported to `found` (`leaf` = the entry the read started from). */
|
|
41
|
+
export declare function viewThroughReplayLoss(storage: SessionStorage, found: (finding: ReplayLossFinding) => void): SessionStorage;
|
|
42
|
+
/** The leg's account of what the log's replay dropped (`session.lineage_rerooted`): one a leg for a whole branch, one a break for a broken one
|
|
43
|
+
* (whichever read met it first), and a broken branch's notice already carries the count, so a whole branch read after it says nothing more. */
|
|
44
|
+
export declare function replayLossSeat(ids: Pick<NoticeSeatInput, "onNotice" | "runId">): (finding: ReplayLossFinding, sessionId: string) => void;
|
|
45
|
+
/** One leg's reading of what the log's replay dropped. The acquire phase reads again after a lost write race and keeps only the attempt
|
|
46
|
+
* that holds, so what an attempt found is held until the phase settles on one and said then (a break before a whole branch, so the break's
|
|
47
|
+
* notice is the leg's only one); reads after that are said as they are made. */
|
|
48
|
+
export interface ReplayLossLeg {
|
|
49
|
+
/** `storage` as this leg reads it, naming the session its findings are about. */
|
|
50
|
+
view(storage: SessionStorage, sessionId: string): SessionStorage;
|
|
51
|
+
/** The attempt that found what is held is discarded: none of it is said. */
|
|
52
|
+
discard(): void;
|
|
53
|
+
/** The attempt that holds is known: say what it found. */
|
|
54
|
+
settle(): void;
|
|
55
|
+
}
|
|
56
|
+
export declare function replayLossLeg(ids: Pick<NoticeSeatInput, "onNotice" | "runId">): ReplayLossLeg;
|