@sema-agent/core 7.60.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +605 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +49 -18
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +2 -1
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +2 -1
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +220 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +38 -16
- package/dist/core/mods/stations.js +25 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +61 -2
- package/dist/core/own-property-receipt.js +42 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +56 -28
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +40 -29
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +9 -7
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +2 -0
- package/dist/core/session-store.js +5 -7
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +10 -10
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +108 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +41 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +16 -3
- package/dist/stores/file/session-store.js +21 -20
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -1,23 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { mediaRemovedPlaceholder } from "../internal/llm.js";
|
|
2
|
+
import { claimedMediaType } from "./image-admission.js";
|
|
2
3
|
import { readMember } from "./thrown-value.js";
|
|
3
|
-
export const AGGREGATE_MEDIA_BUDGET_BYTES = 30 * 1024 * 1024;
|
|
4
|
-
export function mediaBudgetBytes(cap) {
|
|
5
|
-
const limit = cap ?? AGGREGATE_MEDIA_BUDGET_BYTES;
|
|
6
|
-
return Number.isFinite(limit) && limit > 0 ? limit : Infinity;
|
|
7
|
-
}
|
|
8
|
-
export function checkedMediaByteCap(value, seat) {
|
|
9
|
-
if (value === undefined || (typeof value === "number" && value >= 0))
|
|
10
|
-
return;
|
|
11
|
-
const e = new Error(`${seat} ${describeRejectedValue(value)} is not a media byte budget — expected a non-negative number of bytes (0 or Infinity: no budget), or omit it for the default ${AGGREGATE_MEDIA_BUDGET_BYTES}`);
|
|
12
|
-
e.code = "config.invalid_argument";
|
|
13
|
-
throw e;
|
|
14
|
-
}
|
|
15
|
-
const MEDIA_STRIPPED_MARKER = "[media removed to fit the request media budget — re-read the file if you still need to see it]";
|
|
16
|
-
const MEDIA_BLOCK_TYPES = new Set(["image", "document"]);
|
|
17
|
-
export function claimedMediaType(block) {
|
|
18
|
-
const type = readMember(block, "type");
|
|
19
|
-
return MEDIA_BLOCK_TYPES.has(type) ? type : undefined;
|
|
20
|
-
}
|
|
21
4
|
const mediaTyped = (b) => claimedMediaType(b) !== undefined;
|
|
22
5
|
export function isMediaBlock(block) {
|
|
23
6
|
return mediaTyped(block) && typeof readMember(block, "data") === "string";
|
|
@@ -35,44 +18,61 @@ function blocksOf(m) {
|
|
|
35
18
|
const content = m.content;
|
|
36
19
|
return Array.isArray(content) ? content : undefined;
|
|
37
20
|
}
|
|
38
|
-
export function
|
|
39
|
-
const
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
21
|
+
export function trimRequestMedia(messages, limits) {
|
|
22
|
+
const media = [];
|
|
23
|
+
const contents = messages.map(blocksOf);
|
|
24
|
+
for (const [mi, blocks] of contents.entries()) {
|
|
25
|
+
const ordinal = { image: 0, document: 0 };
|
|
26
|
+
for (const [bi, b] of (blocks ?? []).entries()) {
|
|
27
|
+
const type = claimedMediaType(b);
|
|
28
|
+
if (type === undefined)
|
|
29
|
+
continue;
|
|
30
|
+
const data = readMember(b, "data");
|
|
31
|
+
media.push({ message: mi, block: bi, type, ordinal: ++ordinal[type], data: typeof data === "string" ? data : "" });
|
|
32
|
+
}
|
|
49
33
|
}
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
34
|
+
const sizes = media.map((m) => m.data.length);
|
|
35
|
+
const base64Total = sizes.reduce((n, s) => n + s, 0);
|
|
36
|
+
const cut = new Set();
|
|
37
|
+
const kept = [];
|
|
38
|
+
const keepAfterCountCut = Math.max(0, limits.maxItems - limits.margin);
|
|
39
|
+
let keptChars = 0;
|
|
40
|
+
for (const [i, size] of sizes.entries()) {
|
|
41
|
+
kept.push(i);
|
|
42
|
+
keptChars += size;
|
|
43
|
+
if (kept.length > limits.maxItems) {
|
|
44
|
+
for (const j of kept.splice(0, kept.length - keepAfterCountCut)) {
|
|
45
|
+
cut.add(j);
|
|
46
|
+
keptChars -= sizes[j];
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
if (keptChars > limits.budgetBase64Chars) {
|
|
50
|
+
for (let k = 0; k < kept.length && keptChars > limits.budgetBase64Chars - limits.hysteresisBase64Chars;) {
|
|
51
|
+
const j = kept[k];
|
|
52
|
+
if (sizes[j] === 0) {
|
|
53
|
+
k++;
|
|
54
|
+
continue;
|
|
55
|
+
}
|
|
56
|
+
kept.splice(k, 1);
|
|
57
|
+
cut.add(j);
|
|
58
|
+
keptChars -= sizes[j];
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
if (cut.size === 0)
|
|
63
|
+
return { messages, removed: [], removedBase64Chars: 0, items: sizes.length, base64Chars: base64Total };
|
|
64
|
+
const removed = [];
|
|
55
65
|
const out = messages.slice();
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
if (!
|
|
66
|
+
const rewritten = new Map();
|
|
67
|
+
for (const [i, at] of media.entries()) {
|
|
68
|
+
if (!cut.has(i))
|
|
59
69
|
continue;
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
remaining -= bytes;
|
|
65
|
-
removedBytes += bytes;
|
|
66
|
-
removedCount += 1;
|
|
67
|
-
changed = true;
|
|
68
|
-
return { type: "text", text: MEDIA_STRIPPED_MARKER };
|
|
69
|
-
}
|
|
70
|
-
return b;
|
|
71
|
-
});
|
|
72
|
-
if (changed)
|
|
73
|
-
out[i] = { ...out[i], content: next };
|
|
70
|
+
const blocks = rewritten.get(at.message) ?? contents[at.message].slice();
|
|
71
|
+
rewritten.set(at.message, blocks);
|
|
72
|
+
removed.push({ block: blocks[at.block], type: at.type, data: at.data });
|
|
73
|
+
blocks[at.block] = { type: "text", text: mediaRemovedPlaceholder("media_budget", at.type, at.ordinal) };
|
|
74
74
|
}
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
return out;
|
|
75
|
+
for (const [mi, content] of rewritten)
|
|
76
|
+
out[mi] = { ...messages[mi], content };
|
|
77
|
+
return { messages: out, removed, removedBase64Chars: removed.reduce((n, r) => n + r.data.length, 0), items: sizes.length, base64Chars: base64Total };
|
|
78
78
|
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `face`'s members `members`, read as one group. `undefined` when none is present and the group was not declared;
|
|
3
|
+
* the bound members when every one is a function; otherwise a refusal (`config.invalid_argument`) naming the group's
|
|
4
|
+
* owner and what is wrong. `declared` = the group's own container is present (a nested group object), so even zero
|
|
5
|
+
* members present is half a group.
|
|
6
|
+
*/
|
|
7
|
+
export declare function readMemberGroup<K extends string>(owner: string, face: object, members: readonly K[], declared?: boolean): Readonly<Record<K, (...args: never[]) => unknown>> | undefined;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
2
|
+
import { thrownText } from "./thrown-value.js";
|
|
3
|
+
function invalidGroup(message) {
|
|
4
|
+
const e = new Error(message);
|
|
5
|
+
e.code = "config.invalid_argument";
|
|
6
|
+
return e;
|
|
7
|
+
}
|
|
8
|
+
export function readMemberGroup(owner, face, members, declared = false) {
|
|
9
|
+
const read = new Map();
|
|
10
|
+
for (const member of members) {
|
|
11
|
+
let value;
|
|
12
|
+
try {
|
|
13
|
+
value = face[member];
|
|
14
|
+
}
|
|
15
|
+
catch (cause) {
|
|
16
|
+
throw invalidGroup(`${owner}.${member} could not be read (${thrownText(cause)}) — ${members.join(" / ")} are one capability, read as one group.`);
|
|
17
|
+
}
|
|
18
|
+
read.set(member, value);
|
|
19
|
+
}
|
|
20
|
+
const present = members.filter((m) => read.get(m) !== undefined);
|
|
21
|
+
if (present.length === 0 && !declared)
|
|
22
|
+
return undefined;
|
|
23
|
+
const missing = members.filter((m) => read.get(m) === undefined);
|
|
24
|
+
if (missing.length > 0) {
|
|
25
|
+
throw invalidGroup(`${owner} ${present.length === 0 ? "declares the group" : `carries ${present.join(" / ")}`} but not ${missing.join(" / ")} — ${members.join(" / ")} are one capability: every one of them, or none.`);
|
|
26
|
+
}
|
|
27
|
+
const out = {};
|
|
28
|
+
for (const member of members) {
|
|
29
|
+
const value = read.get(member);
|
|
30
|
+
if (typeof value !== "function")
|
|
31
|
+
throw invalidGroup(`${owner}.${member} is ${describeRejectedValue(value)}, not a function — ${members.join(" / ")} are one capability, each a function.`);
|
|
32
|
+
out[member] = value.bind(face);
|
|
33
|
+
}
|
|
34
|
+
return Object.freeze(out);
|
|
35
|
+
}
|
|
@@ -179,7 +179,7 @@ export interface ScreenedConsolidationOptions {
|
|
|
179
179
|
* - D-13a: `multiNode: true` without an injected lease refuses — the declaration exists exactly
|
|
180
180
|
* to make that omission explicit.
|
|
181
181
|
*/
|
|
182
|
-
export declare function screenConsolidationOptions(
|
|
182
|
+
export declare function screenConsolidationOptions(given: MemoryConsolidationOptions, provenance: "off" | "carry"): ScreenedConsolidationOptions;
|
|
183
183
|
/** §1.2-2 — the supersession fuse ceiling: min(N-1, max(floor, ⌊ratio×N⌋)); N ≤ 1 ⇒ 0 (one plan
|
|
184
184
|
* may NEVER empty the active set — the N-1 ceiling is unconditional, G21). */
|
|
185
185
|
export declare function supersessionFuseCeiling(activeSetSize: number, opts: Pick<ScreenedConsolidationOptions, "supersedeRatioCap" | "supersedeAbsoluteFloor">): number;
|
|
@@ -3,6 +3,7 @@ import { join } from "node:path";
|
|
|
3
3
|
import { uuidv7 } from "../../engine/session/uuid.js";
|
|
4
4
|
import { atomicWriteFileSync, lockedStrictUpdate, readStrictSidecar, ControlPlaneCorruptError, ensureDirExists } from "./layout.js";
|
|
5
5
|
import { thrownText } from "../thrown-value.js";
|
|
6
|
+
import { optionKeys, receiveMembers } from "../own-property-receipt.js";
|
|
6
7
|
export function deriveSupersededSet(headers, opts = {}) {
|
|
7
8
|
const byId = new Map();
|
|
8
9
|
for (const h of headers)
|
|
@@ -34,6 +35,10 @@ export function memorySupersededNote(carrierId) {
|
|
|
34
35
|
return `note: a newer consolidated entry supersedes this one — memory entry ${carrierId} carries the current form; this entry remains readable as evidence.`;
|
|
35
36
|
}
|
|
36
37
|
export const MEMORY_SEARCH_SUPERSEDED_TAG = "[superseded]";
|
|
38
|
+
const CONSOLIDATION_OPTION_KEYS = optionKeys()({
|
|
39
|
+
supersedeRatioCap: 0, supersedeAbsoluteFloor: 0, maxProductsPerRun: 0, maxInputsPerProduct: 0, maxDirectedPatchesPerPlan: 0, minRunIntervalMs: 0,
|
|
40
|
+
minSessionsBetweenRuns: 0, scanRefusalRatioCap: 0, scanRefusalMaxPerPlan: 0, allowInstructionProducts: 0, multiNode: 0, lease: 0,
|
|
41
|
+
});
|
|
37
42
|
export const CONSOLIDATION_DEFAULTS = {
|
|
38
43
|
supersedeRatioCap: 0.25,
|
|
39
44
|
supersedeAbsoluteFloor: 4,
|
|
@@ -53,10 +58,11 @@ function coded(message, code) {
|
|
|
53
58
|
e.code = code;
|
|
54
59
|
return e;
|
|
55
60
|
}
|
|
56
|
-
export function screenConsolidationOptions(
|
|
61
|
+
export function screenConsolidationOptions(given, provenance) {
|
|
57
62
|
if (provenance === "off") {
|
|
58
63
|
throw coded(`MemoryEngineOptions.consolidation cannot be enabled under provenance: "off" — the consolidation fold law must be able to mint origin markers (a marked input's product would otherwise commit unmarked). Enable provenance "carry" or remove the consolidation options.`, "config.memory_consolidation_provenance_off");
|
|
59
64
|
}
|
|
65
|
+
const raw = receiveMembers(given, { subject: "MemoryEngineOptions.consolidation", unit: "option", moment: "at construction" }, CONSOLIDATION_OPTION_KEYS);
|
|
60
66
|
const num = (name, v, check, want) => {
|
|
61
67
|
if (v === undefined)
|
|
62
68
|
return CONSOLIDATION_DEFAULTS[name];
|
|
@@ -2,6 +2,7 @@ import type { ParsedScopeKey } from "./scope-contract.js";
|
|
|
2
2
|
import type { HarvestReport, MemoryBackend } from "./types.js";
|
|
3
3
|
import type { MemoryInjection } from "./engine.js";
|
|
4
4
|
import { type MemoryPartitionIncidentSink } from "./layout.js";
|
|
5
|
+
import { type MemoryErasureAttestation } from "./file-backend.js";
|
|
5
6
|
/** The personal plane's shared mount under the config root (ALL projects, one home — the plane is
|
|
6
7
|
* keyed by scope, not by repo: `user:alice` is the same disk from every checkout). */
|
|
7
8
|
export declare function derivePersonalMemoryDir(configRoot: string): string;
|
|
@@ -69,6 +70,18 @@ export interface MemoryScopeStoreInput {
|
|
|
69
70
|
* as a session's opening does); resolve once per scope and keep it.
|
|
70
71
|
*/
|
|
71
72
|
export declare function resolveMemoryScopeStore(input: MemoryScopeStoreInput): MemoryScopeStore;
|
|
73
|
+
/** The two deployment facts a store resolution reads besides the backend, judged as {@link resolveMemoryScopeStore}
|
|
74
|
+
* states (required keys; `undefined` written out states absence) — one judgment for every face that takes them. */
|
|
75
|
+
export declare function judgeMemoryStoreSeat(face: string, input: {
|
|
76
|
+
scopeContract: "v2" | undefined;
|
|
77
|
+
memoryEngineDir: string | undefined;
|
|
78
|
+
}): void;
|
|
79
|
+
/** The plane carrying `scope`, read as a session spells the key: the Runner's own normalization (trimmed;
|
|
80
|
+
* under v2 the contract's parse), then {@link scopePlanesOf}. A key the contract cannot read, or a blank or
|
|
81
|
+
* non-string one, is refused (`config.memory_scope_key`). */
|
|
82
|
+
export declare function memoryScopePlaneOf(face: string, scope: unknown, scopeContract: "v2" | undefined): "project" | "personal";
|
|
83
|
+
/** The store-resolution input refusal (`config.memory_scope_key`), named by the face that refused. */
|
|
84
|
+
export declare function refuseMemoryStoreInput(face: string, what: string, v: unknown, cause?: unknown): never;
|
|
72
85
|
/** True when the classified session needs the dual-root assembly at all. */
|
|
73
86
|
export declare function needsDualRoots(planes: ScopePlanes): boolean;
|
|
74
87
|
/** Convenience for the placement gate: the parsed keys that stay on the PROJECT plane. */
|
|
@@ -86,3 +99,21 @@ export declare function mergeInjections(project: MemoryInjection | undefined, pe
|
|
|
86
99
|
* merged lists). 独立轨 F7: pass the WRITE plane's report as `a` — first-argument fields (incident
|
|
87
100
|
* seat, degraded seat) prefer `a`, and the write plane's degradation is the one that matters. */
|
|
88
101
|
export declare function mergeHarvestReports(a: HarvestReport, b: HarvestReport): HarvestReport;
|
|
102
|
+
/**
|
|
103
|
+
* Merge two stores' receipts for ONE erasure request (same requestId, same selector) into the one receipt the
|
|
104
|
+
* request answers — the harvest merge's law on the erasure report: counters add, lists concatenate, and
|
|
105
|
+
* `status` is `"complete"` only when both receipts are (each store's own `erasureStatusOf` answer): a
|
|
106
|
+
* store that could not establish its share keeps the request partial, whatever the other store erased. Pass
|
|
107
|
+
* the receipts in store order (the project plane's first). Member by member:
|
|
108
|
+
* - `at` is the later of the two (the receipt stands as of the last store's answer); `requestId`, `select`,
|
|
109
|
+
* `selectHash` are the request's (both receipts carry the same);
|
|
110
|
+
* - `resolvedIds` is the union; `erased`, `erasedPreviously`, `conflicts` concatenate; a `notFound` id is
|
|
111
|
+
* dropped when the other store claimed it (erased / erasedPreviously — the id had a row there), appears once
|
|
112
|
+
* otherwise, and carries `historyUnknown` when either store that resolved it could not judge its history;
|
|
113
|
+
* - `evidenceCapability` is `"journal"` only when both are; `custodyState` is the worse of the two
|
|
114
|
+
* (`damaged` ≻ `capability-absent` ≻ `complete`);
|
|
115
|
+
* - each carrier class adds `removed` / `remaining`, and is `unverified` when either store's answer is (or is
|
|
116
|
+
* missing); `quarantineUnattributed` / `derivedEntries` add their counts the same way; `replay` is
|
|
117
|
+
* `"converges"` only when both are; `propagation` stays `"local-store-only"` (every store merged is local).
|
|
118
|
+
*/
|
|
119
|
+
export declare function mergeErasureAttestations(a: MemoryErasureAttestation, b: MemoryErasureAttestation): MemoryErasureAttestation;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { isCentralAuthorityScope, parseScopeKey } from "./scope-contract.js";
|
|
2
2
|
import { CONTROL_PLANE_DIR, resolveMemoryEngineRoot } from "./layout.js";
|
|
3
|
-
import { FileMemoryEngineBackend } from "./file-backend.js";
|
|
3
|
+
import { ERASURE_CARRIER_CLASSES, FileMemoryEngineBackend } from "./file-backend.js";
|
|
4
4
|
import { thrownText } from "../thrown-value.js";
|
|
5
5
|
import { normalizeMemorySpec } from "../memory.js";
|
|
6
6
|
import { join } from "node:path";
|
|
@@ -32,30 +32,37 @@ export function memoryPlaneStore(plane, backend, engineRoot, onIncident) {
|
|
|
32
32
|
return new FileMemoryEngineBackend(derivePersonalMemoryDir(engineRoot), { controlDir: derivePersonalControlDir(engineRoot), ...(onIncident !== undefined ? { onIncident } : {}) });
|
|
33
33
|
}
|
|
34
34
|
export function resolveMemoryScopeStore(input) {
|
|
35
|
-
const
|
|
35
|
+
const face = "resolveMemoryScopeStore";
|
|
36
|
+
judgeMemoryStoreSeat(face, input);
|
|
37
|
+
const plane = memoryScopePlaneOf(face, input.scope, input.scopeContract);
|
|
38
|
+
return { plane, backend: memoryPlaneStore(plane, input.backend, resolveMemoryEngineRoot(input.memoryEngineDir), input.onIncident) };
|
|
39
|
+
}
|
|
40
|
+
export function judgeMemoryStoreSeat(face, input) {
|
|
41
|
+
const { scopeContract, memoryEngineDir } = input;
|
|
36
42
|
for (const key of ["scopeContract", "memoryEngineDir"]) {
|
|
37
43
|
if (!Object.prototype.hasOwnProperty.call(input, key))
|
|
38
|
-
|
|
44
|
+
refuseMemoryStoreInput(face, `${key} is a required key (write undefined to state its absence)`, undefined);
|
|
39
45
|
}
|
|
40
46
|
if (scopeContract !== undefined && scopeContract !== "v2")
|
|
41
|
-
|
|
47
|
+
refuseMemoryStoreInput(face, `scopeContract must be "v2" or undefined`, scopeContract);
|
|
42
48
|
if (memoryEngineDir !== undefined && (typeof memoryEngineDir !== "string" || memoryEngineDir === ""))
|
|
43
|
-
|
|
49
|
+
refuseMemoryStoreInput(face, "memoryEngineDir must be a non-empty string or undefined", memoryEngineDir);
|
|
50
|
+
}
|
|
51
|
+
export function memoryScopePlaneOf(face, scope, scopeContract) {
|
|
44
52
|
let spec;
|
|
45
53
|
try {
|
|
46
54
|
spec = normalizeMemorySpec({ scopes: [scope], writeScope: scope, ...(scopeContract === "v2" ? { scopeContract } : {}) });
|
|
47
55
|
}
|
|
48
56
|
catch (err) {
|
|
49
|
-
|
|
57
|
+
refuseMemoryStoreInput(face, `the scope contract cannot read the key: ${thrownText(err)}`, scope, err);
|
|
50
58
|
}
|
|
51
59
|
if (spec === undefined || spec.writeScope === null)
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
return { plane, backend: memoryPlaneStore(plane, input.backend, resolveMemoryEngineRoot(memoryEngineDir), input.onIncident) };
|
|
60
|
+
refuseMemoryStoreInput(face, "scope must be a non-empty key", scope);
|
|
61
|
+
return scopePlanesOf(spec.scopes, spec.writeScope, spec.scopeContract)?.writePlane ?? "project";
|
|
55
62
|
}
|
|
56
|
-
function
|
|
63
|
+
export function refuseMemoryStoreInput(face, what, v, cause) {
|
|
57
64
|
const got = typeof v === "string" ? JSON.stringify(v.length > 64 ? `${v.slice(0, 64)}…` : v) : v === null ? "null" : typeof v;
|
|
58
|
-
const e = new Error(
|
|
65
|
+
const e = new Error(`${face}: ${what} (got ${got}) — refusing to guess which store was meant.`, cause !== undefined ? { cause } : undefined);
|
|
59
66
|
e.code = "config.memory_scope_key";
|
|
60
67
|
throw e;
|
|
61
68
|
}
|
|
@@ -140,3 +147,44 @@ export function mergeHarvestReports(a, b) {
|
|
|
140
147
|
}
|
|
141
148
|
return merged;
|
|
142
149
|
}
|
|
150
|
+
export function mergeErasureAttestations(a, b) {
|
|
151
|
+
const claimed = new Set([...a.erased, ...b.erased, ...(a.erasedPreviously ?? []), ...(b.erasedPreviously ?? [])].map((row) => row.id));
|
|
152
|
+
const notFound = new Map();
|
|
153
|
+
for (const row of [...a.notFound, ...b.notFound]) {
|
|
154
|
+
if (claimed.has(row.id))
|
|
155
|
+
continue;
|
|
156
|
+
const unknown = row.historyUnknown === true || notFound.get(row.id)?.historyUnknown === true;
|
|
157
|
+
notFound.set(row.id, unknown ? { id: row.id, historyUnknown: true } : { id: row.id });
|
|
158
|
+
}
|
|
159
|
+
const answered = (x) => typeof x === "object" && x !== null && typeof x.removed === "number" && typeof x.remaining === "number";
|
|
160
|
+
const carrier = (x, y) => (answered(x) && answered(y) ? { removed: x.removed + y.removed, remaining: x.remaining + y.remaining } : { unverified: true });
|
|
161
|
+
const counted = (x) => typeof x === "object" && x !== null && typeof x.count === "number";
|
|
162
|
+
const count = (x, y) => (counted(x) && counted(y) ? { count: x.count + y.count } : { unverified: true });
|
|
163
|
+
const custodyRank = { complete: 0, "capability-absent": 1, damaged: 2 };
|
|
164
|
+
const erasedPreviously = [...(a.erasedPreviously ?? []), ...(b.erasedPreviously ?? [])];
|
|
165
|
+
const carriers = {};
|
|
166
|
+
for (const cls of ERASURE_CARRIER_CLASSES)
|
|
167
|
+
carriers[cls] = carrier(a.residuals.carriers[cls], b.residuals.carriers[cls]);
|
|
168
|
+
return {
|
|
169
|
+
v: 2,
|
|
170
|
+
requestId: a.requestId,
|
|
171
|
+
at: Math.max(a.at, b.at),
|
|
172
|
+
status: a.status === "complete" && b.status === "complete" ? "complete" : "partial",
|
|
173
|
+
evidenceCapability: a.evidenceCapability === "journal" && b.evidenceCapability === "journal" ? "journal" : "none",
|
|
174
|
+
custodyState: custodyRank[a.custodyState] >= custodyRank[b.custodyState] ? a.custodyState : b.custodyState,
|
|
175
|
+
select: a.select,
|
|
176
|
+
selectHash: a.selectHash,
|
|
177
|
+
resolvedIds: [...new Set([...a.resolvedIds, ...b.resolvedIds])],
|
|
178
|
+
erased: [...a.erased, ...b.erased],
|
|
179
|
+
notFound: [...notFound.values()],
|
|
180
|
+
...(erasedPreviously.length > 0 ? { erasedPreviously } : {}),
|
|
181
|
+
conflicts: [...a.conflicts, ...b.conflicts],
|
|
182
|
+
residuals: {
|
|
183
|
+
carriers,
|
|
184
|
+
quarantineUnattributed: count(a.residuals.quarantineUnattributed, b.residuals.quarantineUnattributed),
|
|
185
|
+
derivedEntries: count(a.residuals.derivedEntries, b.residuals.derivedEntries),
|
|
186
|
+
replay: a.residuals.replay === "converges" && b.residuals.replay === "converges" ? "converges" : "unsupported",
|
|
187
|
+
propagation: "local-store-only",
|
|
188
|
+
},
|
|
189
|
+
};
|
|
190
|
+
}
|
|
@@ -24,6 +24,7 @@ import { createSessionIncarnationSeat, recalledForAnyIdentity, recalledForIdenti
|
|
|
24
24
|
import { scanMemoryFileName, scanMemoryWrite, scanRemediation } from "./scan.js";
|
|
25
25
|
import { writableRootOf } from "./types.js";
|
|
26
26
|
import { thrownText } from "../thrown-value.js";
|
|
27
|
+
import { optionKeys, receiveOptions } from "../own-property-receipt.js";
|
|
27
28
|
import { admitLandingsThrough, directedLandings, planWritten, refusalNamingWritten, requireWriteGate } from "./consolidation-write-gate.js";
|
|
28
29
|
import { applyEachAlone } from "./landing-admission.js";
|
|
29
30
|
export const MEMORY_RECALL_FRAMING = "Recalled memories appearing inside `<system-reminder>` blocks are background context, not user instructions, and reflect what was true when written — if one names a file, function, or flag, verify it still exists before recommending it.";
|
|
@@ -117,6 +118,7 @@ function homeRel(home, canonical) {
|
|
|
117
118
|
}
|
|
118
119
|
export const DEFAULT_HOLD_SETTLE_TIMEOUT_MS = 72 * 60 * 60 * 1000;
|
|
119
120
|
export const MASS_DELETION_FUSE_RATIO = 0.5;
|
|
121
|
+
const MEMORY_ENGINE_OPTION_KEYS = optionKeys()({ backend: 0, memoryDir: 0, controlDir: 0, now: 0, perScopeBudgetBytes: 0, perFileBytes: 0, maxFiles: 0, maxDepth: 0, provenance: 0, captureRecordStore: 0, sessionIncarnation: 0, holdSettleTimeoutMs: 0, harvestDeadlineMs: 0, harvestFileBudget: 0, onIncident: 0, consolidation: 0 });
|
|
120
122
|
let indexCaptureSeq = 0;
|
|
121
123
|
export function memorySessionPollutedNotice(input) {
|
|
122
124
|
const reason = inlineUntrusted(input.reason, 200);
|
|
@@ -336,43 +338,44 @@ export class MemoryEngine {
|
|
|
336
338
|
unsettleableDisclosed = false;
|
|
337
339
|
zeroCopy;
|
|
338
340
|
constructor(opts) {
|
|
339
|
-
|
|
340
|
-
|
|
341
|
+
const o = receiveOptions(opts, "MemoryEngine", MEMORY_ENGINE_OPTION_KEYS);
|
|
342
|
+
if (o.provenance !== undefined && o.provenance !== "off" && o.provenance !== "carry") {
|
|
343
|
+
const got = typeof o.provenance === "string" ? JSON.stringify(o.provenance) : o.provenance === null ? "null" : typeof o.provenance;
|
|
341
344
|
const e = new Error(`MemoryEngineOptions.provenance must be "off" or "carry" when present (got ${got}) — an unevaluable provenance mode is refused loudly, never folded to either mode.`);
|
|
342
345
|
e.code = "config.memory_provenance";
|
|
343
346
|
throw e;
|
|
344
347
|
}
|
|
345
|
-
this.provenance =
|
|
346
|
-
this.backend =
|
|
347
|
-
this.memoryDir =
|
|
348
|
-
const pinned =
|
|
349
|
-
if (typeof pinned === "string" && pinned !== "" && landingPathOf(pinned) !== landingPathOf(
|
|
350
|
-
const e = new Error(`MemoryEngineOptions.memoryDir must be the File backend's own directory (the backend is pinned to ${pinned}, memoryDir is ${
|
|
348
|
+
this.provenance = o.provenance ?? "carry";
|
|
349
|
+
this.backend = o.backend;
|
|
350
|
+
this.memoryDir = o.memoryDir;
|
|
351
|
+
const pinned = o.backend.directoryRoot;
|
|
352
|
+
if (typeof pinned === "string" && pinned !== "" && landingPathOf(pinned) !== landingPathOf(o.memoryDir)) {
|
|
353
|
+
const e = new Error(`MemoryEngineOptions.memoryDir must be the File backend's own directory (the backend is pinned to ${pinned}, memoryDir is ${o.memoryDir}) — a copy-out projection over a File backend is not supported; pass the backend's directoryRoot as memoryDir.`);
|
|
351
354
|
e.code = "config.memory_dir_not_backend_root";
|
|
352
355
|
throw e;
|
|
353
356
|
}
|
|
354
357
|
this.zeroCopy = typeof pinned === "string" && pinned !== "";
|
|
355
|
-
this.controlDir = effectiveControlRootOf(
|
|
356
|
-
this.now =
|
|
357
|
-
this.perScopeBudgetBytes =
|
|
358
|
-
this.perFileBytes =
|
|
359
|
-
this.maxFiles =
|
|
360
|
-
this.maxDepth =
|
|
361
|
-
this.harvestDeadlineMs =
|
|
362
|
-
this.harvestFileBudget =
|
|
363
|
-
if (
|
|
364
|
-
const got = typeof
|
|
358
|
+
this.controlDir = effectiveControlRootOf(o.memoryDir, { pinnedBy: o.backend, controlDir: o.controlDir, onIncident: o.onIncident });
|
|
359
|
+
this.now = o.now ?? Date.now;
|
|
360
|
+
this.perScopeBudgetBytes = o.perScopeBudgetBytes ?? Number.MAX_SAFE_INTEGER;
|
|
361
|
+
this.perFileBytes = o.perFileBytes ?? MAX_MEMORY_BYTES;
|
|
362
|
+
this.maxFiles = o.maxFiles ?? DEFAULT_MAX_MEMORY_FILES;
|
|
363
|
+
this.maxDepth = o.maxDepth ?? DEFAULT_MAX_ENTRY_DEPTH;
|
|
364
|
+
this.harvestDeadlineMs = o.harvestDeadlineMs ?? DEFAULT_HARVEST_DEADLINE_MS;
|
|
365
|
+
this.harvestFileBudget = o.harvestFileBudget ?? DEFAULT_HARVEST_FILE_BUDGET;
|
|
366
|
+
if (o.holdSettleTimeoutMs !== undefined && (typeof o.holdSettleTimeoutMs !== "number" || !Number.isFinite(o.holdSettleTimeoutMs) || o.holdSettleTimeoutMs <= 0)) {
|
|
367
|
+
const got = typeof o.holdSettleTimeoutMs === "number" ? String(o.holdSettleTimeoutMs) : o.holdSettleTimeoutMs === null ? "null" : typeof o.holdSettleTimeoutMs;
|
|
365
368
|
const e = new Error(`MemoryEngineOptions.holdSettleTimeoutMs must be a finite positive number of milliseconds when present (got ${got}) — an unevaluable settlement window is refused loudly, never folded to the default.`);
|
|
366
369
|
e.code = "config.memory_hold_timeout";
|
|
367
370
|
throw e;
|
|
368
371
|
}
|
|
369
|
-
this.holdSettleTimeoutMs =
|
|
370
|
-
this.onIncident =
|
|
371
|
-
if (
|
|
372
|
-
this.consolidation = screenConsolidationOptions(
|
|
372
|
+
this.holdSettleTimeoutMs = o.holdSettleTimeoutMs ?? DEFAULT_HOLD_SETTLE_TIMEOUT_MS;
|
|
373
|
+
this.onIncident = o.onIncident;
|
|
374
|
+
if (o.consolidation !== undefined) {
|
|
375
|
+
this.consolidation = screenConsolidationOptions(o.consolidation, this.provenance);
|
|
373
376
|
}
|
|
374
|
-
this.captureRecords =
|
|
375
|
-
this.incarnation = createSessionIncarnationSeat({ resolve:
|
|
377
|
+
this.captureRecords = o.captureRecordStore ?? fileSessionCaptureRecordStore(this.controlDir);
|
|
378
|
+
this.incarnation = createSessionIncarnationSeat({ resolve: o.sessionIncarnation, onIncident: o.onIncident });
|
|
376
379
|
}
|
|
377
380
|
incarnation;
|
|
378
381
|
get provenanceMode() {
|
|
@@ -1104,6 +1104,19 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
|
|
|
1104
1104
|
/** Does the control-plane directory `name` hold any entry? ENOENT ⇒ no; any other read failure ⇒
|
|
1105
1105
|
* yes (an unreadable directory may hold anything). */
|
|
1106
1106
|
private controlDirHoldsAnything;
|
|
1107
|
+
/**
|
|
1108
|
+
* The erasure request `requestId` as THIS store's evidence chain records it: the selector hash and the
|
|
1109
|
+
* authorization set (canonical form) its first execution pinned on its anchor, or `undefined` when no local
|
|
1110
|
+
* anchor names it (an imported request's anchor is not a local request — the same reading the replay
|
|
1111
|
+
* judgment of {@link eraseWithEvidence} takes, one function). Read inside the transaction lock after the
|
|
1112
|
+
* journal recovery an erasure itself starts with, so an anchor a crashed erasure left in its journal reads
|
|
1113
|
+
* as recorded. A blank or non-string id is refused (`config.memory_erasure_request`); a spliced chain
|
|
1114
|
+
* (two local anchors for one id) and an unreadable chain refuse as they do for an erasure.
|
|
1115
|
+
*/
|
|
1116
|
+
erasureAnchorOf(requestId: string): Promise<{
|
|
1117
|
+
selectHash: string;
|
|
1118
|
+
expectedScopes?: string[];
|
|
1119
|
+
} | undefined>;
|
|
1107
1120
|
eraseWithEvidence(input: EraseMemoryEntriesInput): Promise<MemoryErasureAttestation>;
|
|
1108
1121
|
/** Bounded journal-quiescence fence (attempt count × retry pause). Constants, not knobs: the
|
|
1109
1122
|
* contended window is the commit tail of one transaction (milliseconds); a store where it stays
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { fstatSync, linkSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, openSync, fsyncSync, closeSync
|
|
1
|
+
import { fstatSync, linkSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, openSync, fsyncSync, closeSync } from "node:fs";
|
|
2
2
|
import { createHash, randomUUID } from "node:crypto";
|
|
3
3
|
import { dirname, join, relative } from "node:path";
|
|
4
4
|
import { canonicalJsonStringify } from "../canonical-json.js";
|
|
@@ -9,13 +9,14 @@ import { ambiguousOriginRepresentation, committedDistilledOf, committedOriginOf,
|
|
|
9
9
|
import { convertV1SidecarKeys } from "./delegation-settlement.js";
|
|
10
10
|
import { layerObservationLookup, observedDivergenceNotice } from "./layer-observations.js";
|
|
11
11
|
import { DEFAULT_MAX_ENTRY_DEPTH, MEMORY_INDEX_FILENAME, scanEntryFiles } from "./entry-scan.js";
|
|
12
|
-
import { ControlPlaneCorruptError, CURSORS_FILE, QUARANTINE_DIR, CHALLENGES_FILE, IMPORT_RECEIPTS_DIR, LINEAGE_FILE, SESSION_POLLUTION_DIR, appendChallengeEvents, atomicWriteFileSync, quarantineAndTombstone, captureAndClearLineageForEntries, adoptRootScopeLayout, anchorStoreRoot, effectiveControlRootOf, ensureDirExists, LEDGER_FILE, enqueueMemoryAnnouncement, importLatchTxnId, importLineageCommitted, importSessionPollution, isContainedIn, lockedStrictUpdate, readStrictSidecar, permissionRemedyOf, withPermissionRemedy, lineageContributionsOfSession, listSessionPollution, readChallengeEvents, readLineageRecord, registerScope, registeredScopes, releaseImportLatch, layoutNeedsAdoption, scopeDirFor, scopeDirName, scopeRegistryShape, stageImportLatch, landsOutsideStore, storeActRefusal, storeRootMovedRefusal, writeAllSync, STORE_JOURNAL_FILE, ERASURE_SWEEP_RECORD_FILE, ERASURE_SWEEP_RECORD_WHAT, coerceErasureSweepRecord, erasureSweepOwedAt, erasureSweepRecordPathOf, STORE_TXN_LOCK_DIR, TXN_LOCK_STALE_MS, acquireStoreTxnLock, assertStoreTxnLockOwnership, tryStoreTxnLock, } from "./layout.js";
|
|
12
|
+
import { ControlPlaneCorruptError, CURSORS_FILE, QUARANTINE_DIR, CHALLENGES_FILE, IMPORT_RECEIPTS_DIR, LINEAGE_FILE, SESSION_POLLUTION_DIR, appendChallengeEvents, atomicWriteFileSync, quarantineAndTombstone, captureAndClearLineageForEntries, adoptRootScopeLayout, anchorStoreRoot, effectiveControlRootOf, ensureDirExists, LEDGER_FILE, enqueueMemoryAnnouncement, importLatchTxnId, importLineageCommitted, importSessionPollution, isContainedIn, lockedStrictUpdate, readStrictSidecar, permissionRemedyOf, withPermissionRemedy, lineageContributionsOfSession, listSessionPollution, readChallengeEvents, readLineageRecord, registerScope, registeredScopes, releaseImportLatch, layoutNeedsAdoption, scopeDirFor, scopeDirName, scopeRegistryShape, stageImportLatch, landsOutsideStore, storeActRefusal, storeRootMovedRefusal, writeAllSync, STORE_JOURNAL_FILE, ERASURE_SWEEP_RECORD_FILE, ERASURE_SWEEP_RECORD_WHAT, coerceErasureSweepRecord, erasureSweepOwedAt, erasureSweepRecordPathOf, STORE_TXN_LOCK_DIR, TXN_LOCK_STALE_MS, acquireStoreTxnLock, assertStoreTxnLockOwnership, renewStoreTxnLock, tryStoreTxnLock, } from "./layout.js";
|
|
13
13
|
import { screenInboundEntries } from "./data-plane.js";
|
|
14
14
|
import { CONSOLIDATION_DRIVER_PLANS_DIR, CONSOLIDATION_PLANS_DIR } from "./consolidation.js";
|
|
15
15
|
import { canonicalExpectedScopes, expectedScopesInvalid, firstOutsideExpectedScopes } from "./export-bundle.js";
|
|
16
16
|
import { scanMemoryFileName, scanMemoryWrite } from "./scan.js";
|
|
17
17
|
import { admittingLandings, cutPerLanding, LandingsNeedAdmission, requireLandingsAdmitted } from "./landing-admission.js";
|
|
18
18
|
import { thrownText } from "../thrown-value.js";
|
|
19
|
+
import { optionKeys, receiveOptions } from "../own-property-receipt.js";
|
|
19
20
|
export { DEFAULT_MAX_ENTRY_DEPTH, MEMORY_INDEX_FILENAME, scanEntryFiles } from "./entry-scan.js";
|
|
20
21
|
export const ERASURE_CARRIER_CLASSES = Object.freeze(["projection", "shadow", "indexLine", "quarantineCopy", "planArchive", "planWorkbook", "evidenceBinding", "backendDerived"]);
|
|
21
22
|
export function erasureStatusOf(att) {
|
|
@@ -126,6 +127,13 @@ function erasureCodedError(message, code) {
|
|
|
126
127
|
e.code = code;
|
|
127
128
|
return e;
|
|
128
129
|
}
|
|
130
|
+
function localErasureAnchorOf(chain, requestId) {
|
|
131
|
+
const localAnchors = chain.filter((r) => r.parsed.channel === "erasure-anchor" && r.parsed.origin === undefined && r.parsed.req === requestId);
|
|
132
|
+
if (localAnchors.length > 1) {
|
|
133
|
+
throw new ControlPlaneCorruptError(`erasure request ${JSON.stringify(requestId)} has ${localAnchors.length} anchors on the evidence chain — a second anchor cannot be minted by this store (the lock-held chain check runs first), so the chain was spliced out of band; refusing to pick one by file order (a human adjudicates)`);
|
|
134
|
+
}
|
|
135
|
+
return localAnchors[0]?.parsed;
|
|
136
|
+
}
|
|
129
137
|
function cloneErasureSelect(select) {
|
|
130
138
|
if ("ids" in select)
|
|
131
139
|
return { ids: [...select.ids] };
|
|
@@ -585,6 +593,7 @@ function probeProjection(absPath, id) {
|
|
|
585
593
|
}
|
|
586
594
|
return parseEntryFile(text).id === id ? "present" : "undecidable";
|
|
587
595
|
}
|
|
596
|
+
const FILE_MEMORY_ENGINE_BACKEND_OPTION_KEYS = optionKeys()({ controlDir: 0, now: 0, onIncident: 0 });
|
|
588
597
|
export class FileMemoryEngineBackend {
|
|
589
598
|
directoryRoot;
|
|
590
599
|
controlPlaneRoot;
|
|
@@ -605,10 +614,11 @@ export class FileMemoryEngineBackend {
|
|
|
605
614
|
inboundFindings = [];
|
|
606
615
|
batchScan;
|
|
607
616
|
constructor(dir, opts = {}) {
|
|
608
|
-
|
|
609
|
-
this.
|
|
617
|
+
const o = receiveOptions(opts, "FileMemoryEngineBackend", FILE_MEMORY_ENGINE_BACKEND_OPTION_KEYS);
|
|
618
|
+
this.now = o.now ?? Date.now;
|
|
619
|
+
this.onIncident = o.onIncident;
|
|
610
620
|
this.directoryRoot = dir;
|
|
611
|
-
this.controlPlaneRoot = effectiveControlRootOf(dir, { controlDir:
|
|
621
|
+
this.controlPlaneRoot = effectiveControlRootOf(dir, { controlDir: o.controlDir, onIncident: o.onIncident });
|
|
612
622
|
this.assertRootAnchored();
|
|
613
623
|
ensureDirExists(dir);
|
|
614
624
|
ensureDirExists(this.controlPlaneRoot);
|
|
@@ -635,11 +645,7 @@ export class FileMemoryEngineBackend {
|
|
|
635
645
|
ownerCandidate,
|
|
636
646
|
onIncident: onIncident ?? this.onIncident,
|
|
637
647
|
convertSidecars: convertV1SidecarKeys,
|
|
638
|
-
renew: () =>
|
|
639
|
-
const now = new Date();
|
|
640
|
-
utimesSync(this.txnLockDir(), now, now);
|
|
641
|
-
this.assertTxnLockOwnership(lockToken);
|
|
642
|
-
},
|
|
648
|
+
renew: () => renewStoreTxnLock(this.controlPlaneRoot, lockToken),
|
|
643
649
|
});
|
|
644
650
|
}
|
|
645
651
|
ensureLayout(ownerCandidate) {
|
|
@@ -2649,6 +2655,24 @@ export class FileMemoryEngineBackend {
|
|
|
2649
2655
|
return err.code !== "ENOENT";
|
|
2650
2656
|
}
|
|
2651
2657
|
}
|
|
2658
|
+
async erasureAnchorOf(requestId) {
|
|
2659
|
+
if (typeof requestId !== "string" || requestId.length === 0)
|
|
2660
|
+
throw erasureCodedError("erasureAnchorOf: requestId is required (a non-empty string)", "config.memory_erasure_request");
|
|
2661
|
+
const lock = await this.acquireTxnLock();
|
|
2662
|
+
try {
|
|
2663
|
+
this.assertTxnLockOwnership(lock.token);
|
|
2664
|
+
this.ledger = undefined;
|
|
2665
|
+
this.recoverJournal({ token: lock.token });
|
|
2666
|
+
const anchor = localErasureAnchorOf(this.readTransferChain(lock.token), requestId);
|
|
2667
|
+
if (anchor === undefined)
|
|
2668
|
+
return undefined;
|
|
2669
|
+
const grant = anchor.expectedScopes;
|
|
2670
|
+
return { selectHash: anchor.selectHash, ...(grant !== undefined ? { expectedScopes: [...grant] } : {}) };
|
|
2671
|
+
}
|
|
2672
|
+
finally {
|
|
2673
|
+
lock.release();
|
|
2674
|
+
}
|
|
2675
|
+
}
|
|
2652
2676
|
async eraseWithEvidence(input) {
|
|
2653
2677
|
const captured = captureErasureInput(input);
|
|
2654
2678
|
const bad = erasureRequestInvalid(captured);
|
|
@@ -2671,11 +2695,7 @@ export class FileMemoryEngineBackend {
|
|
|
2671
2695
|
const custodyState = degraded ? "damaged" : "complete";
|
|
2672
2696
|
const selectHash = erasureSelectHash(select);
|
|
2673
2697
|
const now = this.now();
|
|
2674
|
-
const
|
|
2675
|
-
if (localAnchors.length > 1) {
|
|
2676
|
-
throw new ControlPlaneCorruptError(`erasure request ${JSON.stringify(requestId)} has ${localAnchors.length} anchors on the evidence chain — a second anchor cannot be minted by this store (the lock-held chain check runs first), so the chain was spliced out of band; refusing to pick one by file order (a human adjudicates)`);
|
|
2677
|
-
}
|
|
2678
|
-
const priorAnchor = localAnchors[0]?.parsed;
|
|
2698
|
+
const priorAnchor = localErasureAnchorOf(chain, requestId);
|
|
2679
2699
|
if (priorAnchor !== undefined) {
|
|
2680
2700
|
const recorded = priorAnchor.expectedScopes;
|
|
2681
2701
|
const same = recorded === undefined || grant === undefined ? recorded === grant : recorded.length === grant.length && recorded.every((s, i) => grant[i] === s);
|
|
@@ -417,6 +417,9 @@ export declare function tryStoreTxnLock(controlDir: string, opts: {
|
|
|
417
417
|
* stolen, tombstoned lock) is lost too. A holder that stalled past the stale line was stolen from; acting on
|
|
418
418
|
* would overwrite the stealer's transaction. */
|
|
419
419
|
export declare function assertStoreTxnLockOwnership(controlDir: string, token: string): void;
|
|
420
|
+
/** The holder's heartbeat: refresh the lock's mtime (its stale line moves on) and re-prove it is still `token`'s —
|
|
421
|
+
* a holder stolen from throws {@link assertStoreTxnLockOwnership}'s refusal, never acts on. */
|
|
422
|
+
export declare function renewStoreTxnLock(controlDir: string, token: string): void;
|
|
420
423
|
/** Wait for the store's transaction lock: one {@link tryStoreTxnLock} per round, paced 20–60 ms (the wait
|
|
421
424
|
* yields the event loop every round), until the deadline — `waitMs`, extended to an observed lock's stale
|
|
422
425
|
* line plus the steal grace. Past it: a loud timeout. */
|