@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
|
@@ -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. */
|
|
@@ -7,6 +7,9 @@ import { MEMORY_ORIGIN_CAUSES } from "./types.js";
|
|
|
7
7
|
import { physicalPathOf, physicalPathOfExisting, priorCallerCasedPathOf } from "../physical-path.js";
|
|
8
8
|
import { thrownLabel, thrownText } from "../thrown-value.js";
|
|
9
9
|
import { egressText } from "../untrusted-egress.js";
|
|
10
|
+
import { optionKeys, receiveMembers } from "../own-property-receipt.js";
|
|
11
|
+
const REANCHOR_OPTION_KEYS = optionKeys()({ controlDir: 0, onIncident: 0 });
|
|
12
|
+
const ANNOUNCEMENT_OPTION_KEYS = optionKeys()({ supersedesPrefix: 0 });
|
|
10
13
|
const SCOPES_FILE = "scopes.json";
|
|
11
14
|
export const CURSORS_FILE = "cursors.json";
|
|
12
15
|
export const CONTROL_PLANE_DIR = ".engine";
|
|
@@ -1036,6 +1039,11 @@ export function assertStoreTxnLockOwnership(controlDir, token) {
|
|
|
1036
1039
|
throw new ControlPlaneCorruptError("txn lock ownership lost before commit (holder stalled past the stale deadline and was stolen from?) — transaction aborted, nothing was committed", { facet: "lock-ownership" });
|
|
1037
1040
|
}
|
|
1038
1041
|
}
|
|
1042
|
+
export function renewStoreTxnLock(controlDir, token) {
|
|
1043
|
+
const now = new Date();
|
|
1044
|
+
utimesSync(join(controlDir, STORE_TXN_LOCK_DIR), now, now);
|
|
1045
|
+
assertStoreTxnLockOwnership(controlDir, token);
|
|
1046
|
+
}
|
|
1039
1047
|
export async function acquireStoreTxnLock(controlDir, opts) {
|
|
1040
1048
|
const staleMs = opts.timings?.staleMs ?? TXN_LOCK_STALE_MS;
|
|
1041
1049
|
const waitMs = opts.timings?.waitMs ?? TXN_LOCK_WAIT_MS;
|
|
@@ -1103,7 +1111,8 @@ function reanchorRefusal(sentence) {
|
|
|
1103
1111
|
return e;
|
|
1104
1112
|
}
|
|
1105
1113
|
export async function reanchorMemoryStoreRoot(dir, opts = {}) {
|
|
1106
|
-
const
|
|
1114
|
+
const o = receiveMembers(opts, { subject: "reanchorMemoryStoreRoot options", unit: "option", moment: "at reanchorMemoryStoreRoot" }, REANCHOR_OPTION_KEYS);
|
|
1115
|
+
const controlDir = effectiveControlRootOf(dir, { controlDir: o.controlDir, onIncident: o.onIncident });
|
|
1107
1116
|
const to = reanchorDestination(dir);
|
|
1108
1117
|
const lock = join(controlDir, `${ROOT_ANCHOR_FILE}.lock`);
|
|
1109
1118
|
if (lstatOrAbsent(join(controlDir, ROOT_ANCHOR_FILE)) === undefined && !controlPlaneHoldsStore(controlDir)) {
|
|
@@ -1148,7 +1157,7 @@ export async function reanchorMemoryStoreRoot(dir, opts = {}) {
|
|
|
1148
1157
|
finally {
|
|
1149
1158
|
txn.release();
|
|
1150
1159
|
}
|
|
1151
|
-
discloseLayoutIncident(
|
|
1160
|
+
discloseLayoutIncident(o.onIncident, "memory.root_reanchored", `memory store root re-anchored: ${dir} now opens at ${to}${from !== undefined ? ` (was ${from})` : ""} — control plane ${controlDir}`);
|
|
1152
1161
|
return from !== undefined ? { from, to, controlDir } : { to, controlDir };
|
|
1153
1162
|
}
|
|
1154
1163
|
export function permissionRemedyOf(err, memoryDir) {
|
|
@@ -1586,12 +1595,13 @@ function mergeScopeQueues(rec, scopes) {
|
|
|
1586
1595
|
return { folded, queue: lines.map((l) => l.a) };
|
|
1587
1596
|
}
|
|
1588
1597
|
export function enqueueMemoryAnnouncement(controlDir, ann, opts) {
|
|
1598
|
+
const o = opts === undefined ? undefined : receiveMembers(opts, { subject: "enqueueMemoryAnnouncement options", unit: "option", moment: "at enqueueMemoryAnnouncement" }, ANNOUNCEMENT_OPTION_KEYS);
|
|
1589
1599
|
if (typeof ann.scope !== "string" || ann.scope === "") {
|
|
1590
1600
|
throw new TypeError("enqueueMemoryAnnouncement: announcement.scope is required — each notice is filed under the one scope it reports on");
|
|
1591
1601
|
}
|
|
1592
1602
|
const scope = ann.scope;
|
|
1593
1603
|
ann = { ...ann, items: mintedItems(ann.items) };
|
|
1594
|
-
const family =
|
|
1604
|
+
const family = o?.supersedesPrefix === undefined ? undefined : egressText("same-principal", o.supersedesPrefix);
|
|
1595
1605
|
if (ann.items.length === 0 && family === undefined)
|
|
1596
1606
|
return;
|
|
1597
1607
|
lockedJournaledUpdate(controlDir, ANNOUNCEMENTS_FILE, (current) => {
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { MemoryEngine, type SessionMemoryStatus } from "./engine.js";
|
|
2
|
+
import { type MemoryPartitionIncidentSink, type SessionCaptureRecordStore } from "./layout.js";
|
|
3
|
+
import { type EraseMemoryEntriesInput, type MemoryErasureAttestation } from "./file-backend.js";
|
|
4
|
+
import type { MemoryBackend } from "./types.js";
|
|
5
|
+
/** The directory (under the engine root) whose transaction lock serializes a deployment's erasures — the
|
|
6
|
+
* judgment across stores and the executions it admits run as one critical section. */
|
|
7
|
+
export declare const MEMORY_DEPLOYMENT_ERASURE_LOCK_DIR = ".memory-erasure-judge";
|
|
8
|
+
export interface MemoryDeploymentInput {
|
|
9
|
+
/** The deployment's backend — the instance given as `RunnerDeps.memoryBackend`. It must own its control
|
|
10
|
+
* plane (`controlPlaneRoot`, a non-empty string): a backend without one keeps a session's memory facts in
|
|
11
|
+
* per-project control planes no deployment-wide reading can name, and is refused (`config.memory_scope_key`). */
|
|
12
|
+
backend: MemoryBackend;
|
|
13
|
+
/** The value given as `RunnerDeps.memoryEngineDir` — a required key, judged as `resolveMemoryScopeStore`
|
|
14
|
+
* judges it (`undefined` written out reads the Runner's same fallback). */
|
|
15
|
+
memoryEngineDir: string | undefined;
|
|
16
|
+
/** The scope contract the deployment's sessions are minted under (`TaskSpec.memory.scopeContract`) — the
|
|
17
|
+
* reading of which plane a request's scope keys belong to. A required key, judged as `resolveMemoryScopeStore`
|
|
18
|
+
* judges it. */
|
|
19
|
+
scopeContract: "v2" | undefined;
|
|
20
|
+
/** Advisory incident seat for every engine and store this face opens (`MemoryEngineOptions.onIncident`). */
|
|
21
|
+
onIncident?: MemoryPartitionIncidentSink;
|
|
22
|
+
/** The host's capture record carrier (`RunnerDeps.memoryCaptureRecordStore`), instantiated per store and
|
|
23
|
+
* keyed by that store's control plane — the seat sessions read. Absent ⇒ each engine's file default. */
|
|
24
|
+
memoryCaptureRecordStore?: (plane: {
|
|
25
|
+
controlDir: string;
|
|
26
|
+
}) => SessionCaptureRecordStore;
|
|
27
|
+
}
|
|
28
|
+
/** One store of the deployment and the engine this face drives it with. */
|
|
29
|
+
export interface MemoryDeploymentStore {
|
|
30
|
+
readonly plane: "project" | "personal";
|
|
31
|
+
readonly backend: MemoryBackend;
|
|
32
|
+
readonly engine: MemoryEngine;
|
|
33
|
+
}
|
|
34
|
+
/** The keys of {@link SessionMemoryStatus} that are facts of the SESSION and fold across stores. */
|
|
35
|
+
type FoldedStatusKey = "captureOptedOut" | "committedCount" | "foldedCount" | "optOutSource" | "lastCaptureAt";
|
|
36
|
+
/**
|
|
37
|
+
* A session's memory status across every store of the deployment ({@link MemoryDeployment.sessionMemoryStatus}):
|
|
38
|
+
* the session keys folded by {@link foldSessionMemoryStatuses}, plus each store's own answer.
|
|
39
|
+
*/
|
|
40
|
+
export interface DeploymentSessionMemoryStatus extends Pick<SessionMemoryStatus, FoldedStatusKey> {
|
|
41
|
+
/** Always present: one row per store of the deployment, in store order (project plane first) — each store's
|
|
42
|
+
* answer exactly as its engine gave it. The folded keys are read from these rows; a store whose answer made a
|
|
43
|
+
* folded key absent is the row whose key is absent; a store-bound key (`writeHome`, the directory of the
|
|
44
|
+
* session's write home IN that store) is answered here only. A store that could not be opened answers
|
|
45
|
+
* `{ optOutSource: "fault" }` (every source unreadable). */
|
|
46
|
+
planes: ReadonlyArray<{
|
|
47
|
+
readonly plane: "project" | "personal";
|
|
48
|
+
readonly status: SessionMemoryStatus;
|
|
49
|
+
}>;
|
|
50
|
+
}
|
|
51
|
+
export interface MemoryDeployment {
|
|
52
|
+
/** The deployment's stores, read at each call: the project plane (the deployment's backend), then — on a
|
|
53
|
+
* directory-pinned deployment — the personal plane's store once its mount exists under the engine root
|
|
54
|
+
* (opened on first use and kept). A store this face opened for a request stays in the set. */
|
|
55
|
+
stores(): readonly MemoryDeploymentStore[];
|
|
56
|
+
/**
|
|
57
|
+
* Erase across the deployment — the input and the receipt of `MemoryEngine.eraseMemoryEntries`, judged as one
|
|
58
|
+
* request in the whole deployment. The deployment's erasures run one at a time (a transaction lock under the
|
|
59
|
+
* engine root, renewed while the stores execute; a lock found lost before a store executes or after the last
|
|
60
|
+
* one throws `ControlPlaneCorruptError`, facet `lock-ownership`, instead of a receipt); under it the stores
|
|
61
|
+
* are read once, and the reach, the judgment and the executions read that one census. The stores a request
|
|
62
|
+
* reaches:
|
|
63
|
+
* - a `{ scope }` selector ⇒ the store carrying that scope (opened if it does not exist yet);
|
|
64
|
+
* - with `expectedScopes` ⇒ the store carrying the granted scopes (the project store for an empty grant); a
|
|
65
|
+
* grant naming scopes kept in two stores is refused (`config.memory_erasure_scope`) before anything is
|
|
66
|
+
* deleted or recorded — one request is judged in one store's lock;
|
|
67
|
+
* - an `{ ids }` or `{ sessionId }` selector without a grant ⇒ every store of the deployment (each resolves
|
|
68
|
+
* its own share).
|
|
69
|
+
* Before any store executes, every store is asked for an anchor of the same requestId: one recorded under a
|
|
70
|
+
* different authorization set refuses (`config.memory_erasure_scope`); one with a different selector, or in a
|
|
71
|
+
* store this request does not reach, refuses `memory.erasure_selector_mismatch` — nothing is deleted or
|
|
72
|
+
* recorded. A store holding this request's own anchor replays it. The reached stores then execute in store
|
|
73
|
+
* order, and their receipts merge into one (`mergeErasureAttestations`: `complete` only when every store's
|
|
74
|
+
* receipt is; one store ⇒ its receipt as given). A
|
|
75
|
+
* failure in a later store throws after an earlier store executed: that store keeps its anchor and a replay
|
|
76
|
+
* of the same requestId converges every store.
|
|
77
|
+
*
|
|
78
|
+
* @contract memory.erasure.request_per_deployment — an erasure requestId names one request in the whole
|
|
79
|
+
* deployment: its record is the anchor of the store that executed it, every store is read for that anchor
|
|
80
|
+
* before any store executes, and a requestId first executed with another selector or in a store the request
|
|
81
|
+
* does not reach is refused `memory.erasure_selector_mismatch` with nothing deleted; an erasure that bypasses
|
|
82
|
+
* this face (a store's own engine) is judged by that store alone.
|
|
83
|
+
*/
|
|
84
|
+
eraseMemoryEntries(input: EraseMemoryEntriesInput): Promise<MemoryErasureAttestation>;
|
|
85
|
+
/** A session's memory status across every store of the deployment ({@link DeploymentSessionMemoryStatus}).
|
|
86
|
+
* Never throws — an unreadable source is an absent key, as on one store. */
|
|
87
|
+
sessionMemoryStatus(sessionId: string): Promise<DeploymentSessionMemoryStatus>;
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Fold the stores' answers for one session into the session's status — the deployment-wide reading's ONE law
|
|
91
|
+
* (one store ⇒ its five keys unchanged). Each store's answer comes from its engine; nothing is coined:
|
|
92
|
+
* - `committedCount` / `foldedCount`: the stores' counts added; any store's count absent (its ledger
|
|
93
|
+
* unreadable) ⇒ absent;
|
|
94
|
+
* - `lastCaptureAt`: the latest of the stores'; absent when the folded `committedCount` is absent (a store's
|
|
95
|
+
* ledger unreadable may hide a later capture) or no store has a capture;
|
|
96
|
+
* - `captureOptedOut`: `true` (with `optOutSource: "record"`) when any store holds a standing record — a
|
|
97
|
+
* one-way record anywhere is the session's record; `false` only when every store answers `false`; otherwise
|
|
98
|
+
* (a store's record read faulted, no store holds a record) absent, with `optOutSource: "fault"`.
|
|
99
|
+
*
|
|
100
|
+
* @contract memory.deployment_status.fold — a session's memory status across a deployment's stores is folded
|
|
101
|
+
* by this function only: counts add (any store's count absent ⇒ absent), `lastCaptureAt` is the latest
|
|
102
|
+
* (absent when a count is absent or no store has a capture), `captureOptedOut` is `true` when any store holds a
|
|
103
|
+
* record and `false` only when every store answers `false`, else absent with `optOutSource: "fault"`; a host
|
|
104
|
+
* that shows the deployment's answer projects it and folds nothing itself.
|
|
105
|
+
*/
|
|
106
|
+
export declare function foldSessionMemoryStatuses(statuses: readonly SessionMemoryStatus[]): Pick<SessionMemoryStatus, FoldedStatusKey>;
|
|
107
|
+
/** The deployment-wide memory face over `input` (see {@link MemoryDeployment}). Input keys are judged as
|
|
108
|
+
* `resolveMemoryScopeStore` judges them; a backend without its own control plane is refused. */
|
|
109
|
+
export declare function createMemoryDeployment(input: MemoryDeploymentInput): MemoryDeployment;
|
|
110
|
+
export {};
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
import { lstatSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { MemoryEngine } from "./engine.js";
|
|
4
|
+
import { derivePersonalControlDir, derivePersonalMemoryDir, directoryPinOf, judgeMemoryStoreSeat, memoryPlaneStore, memoryScopePlaneOf, mergeErasureAttestations, refuseMemoryStoreInput } from "./dual-root.js";
|
|
5
|
+
import { acquireStoreTxnLock, assertStoreTxnLockOwnership, ControlPlaneCorruptError, renewStoreTxnLock, resolveMemoryEngineRoot, TXN_LOCK_STALE_MS } from "./layout.js";
|
|
6
|
+
import { captureErasureInput, erasureRequestInvalid, erasureSelectHash } from "./file-backend.js";
|
|
7
|
+
import { canonicalExpectedScopes } from "./export-bundle.js";
|
|
8
|
+
const FACE = "createMemoryDeployment";
|
|
9
|
+
export const MEMORY_DEPLOYMENT_ERASURE_LOCK_DIR = ".memory-erasure-judge";
|
|
10
|
+
const STATUS_KEYS_DECIDED = true;
|
|
11
|
+
void STATUS_KEYS_DECIDED;
|
|
12
|
+
export function foldSessionMemoryStatuses(statuses) {
|
|
13
|
+
const sum = (key) => {
|
|
14
|
+
let n = 0;
|
|
15
|
+
for (const s of statuses) {
|
|
16
|
+
const v = s[key];
|
|
17
|
+
if (v === undefined)
|
|
18
|
+
return undefined;
|
|
19
|
+
n += v;
|
|
20
|
+
}
|
|
21
|
+
return n;
|
|
22
|
+
};
|
|
23
|
+
const committedCount = sum("committedCount");
|
|
24
|
+
const foldedCount = sum("foldedCount");
|
|
25
|
+
const captures = statuses.flatMap((s) => (s.lastCaptureAt !== undefined ? [s.lastCaptureAt] : []));
|
|
26
|
+
const lastCaptureAt = committedCount !== undefined && captures.length > 0 ? Math.max(...captures) : undefined;
|
|
27
|
+
const capture = statuses.some((s) => s.captureOptedOut === true)
|
|
28
|
+
? { captureOptedOut: true, optOutSource: "record" }
|
|
29
|
+
: statuses.every((s) => s.captureOptedOut === false)
|
|
30
|
+
? { captureOptedOut: false }
|
|
31
|
+
: { optOutSource: "fault" };
|
|
32
|
+
return {
|
|
33
|
+
...capture,
|
|
34
|
+
...(committedCount !== undefined ? { committedCount } : {}),
|
|
35
|
+
...(foldedCount !== undefined ? { foldedCount } : {}),
|
|
36
|
+
...(lastCaptureAt !== undefined ? { lastCaptureAt } : {}),
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
export function createMemoryDeployment(input) {
|
|
40
|
+
judgeMemoryStoreSeat(FACE, input);
|
|
41
|
+
const { backend, scopeContract, onIncident, memoryCaptureRecordStore } = input;
|
|
42
|
+
const controlOf = (store) => {
|
|
43
|
+
const root = store.controlPlaneRoot;
|
|
44
|
+
return typeof root === "string" && root !== "" ? root : undefined;
|
|
45
|
+
};
|
|
46
|
+
if (controlOf(backend) === undefined) {
|
|
47
|
+
refuseMemoryStoreInput(FACE, "the backend owns no control plane (controlPlaneRoot) — a session's memory facts then live in per-project control planes no deployment-wide reading can name", backend);
|
|
48
|
+
}
|
|
49
|
+
const engineRoot = resolveMemoryEngineRoot(input.memoryEngineDir);
|
|
50
|
+
const pinned = directoryPinOf(backend) !== undefined;
|
|
51
|
+
const seatOf = (plane, store) => {
|
|
52
|
+
const controlDir = controlOf(store);
|
|
53
|
+
const engine = new MemoryEngine({
|
|
54
|
+
backend: store,
|
|
55
|
+
memoryDir: directoryPinOf(store) ?? engineRoot,
|
|
56
|
+
...(onIncident !== undefined ? { onIncident } : {}),
|
|
57
|
+
...(memoryCaptureRecordStore !== undefined && controlDir !== undefined ? { captureRecordStore: memoryCaptureRecordStore({ controlDir }) } : {}),
|
|
58
|
+
});
|
|
59
|
+
return Object.freeze({ plane, backend: store, engine });
|
|
60
|
+
};
|
|
61
|
+
const project = seatOf("project", backend);
|
|
62
|
+
let personal;
|
|
63
|
+
const personalStore = () => (personal ??= seatOf("personal", memoryPlaneStore("personal", backend, engineRoot, onIncident)));
|
|
64
|
+
const personalMountExists = () => [derivePersonalMemoryDir(engineRoot), derivePersonalControlDir(engineRoot)].some((p) => {
|
|
65
|
+
try {
|
|
66
|
+
return lstatSync(p, { throwIfNoEntry: false }) !== undefined;
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
return true;
|
|
70
|
+
}
|
|
71
|
+
});
|
|
72
|
+
const hasPersonalStore = () => pinned && (personal !== undefined || personalMountExists());
|
|
73
|
+
const stores = () => (hasPersonalStore() ? [project, personalStore()] : [project]);
|
|
74
|
+
const storeOfPlane = (plane) => (plane === "personal" && pinned ? personalStore() : project);
|
|
75
|
+
const planeOf = (scope) => memoryScopePlaneOf(FACE, scope, scopeContract);
|
|
76
|
+
const reachOf = (req, all) => {
|
|
77
|
+
const select = req.select;
|
|
78
|
+
if ("scope" in select)
|
|
79
|
+
return [storeOfPlane(planeOf(select.scope))];
|
|
80
|
+
if (req.expectedScopes !== undefined) {
|
|
81
|
+
const seats = new Set(canonicalExpectedScopes(req.expectedScopes).map((s) => storeOfPlane(planeOf(s))));
|
|
82
|
+
if (seats.size > 1) {
|
|
83
|
+
throw coded("eraseMemoryEntries: the request's expectedScopes name scopes kept in two of this deployment's memory stores, and one request is judged in one store's lock — send one request per store (nothing was deleted, nothing was recorded; no scope is reported)", "config.memory_erasure_scope");
|
|
84
|
+
}
|
|
85
|
+
return [[...seats][0] ?? project];
|
|
86
|
+
}
|
|
87
|
+
return [...all];
|
|
88
|
+
};
|
|
89
|
+
return {
|
|
90
|
+
stores: () => stores(),
|
|
91
|
+
async eraseMemoryEntries(raw) {
|
|
92
|
+
const req = captureErasureInput(raw);
|
|
93
|
+
const bad = erasureRequestInvalid(req);
|
|
94
|
+
if (bad !== undefined)
|
|
95
|
+
throw coded(`eraseMemoryEntries: ${bad}`, "config.memory_erasure_request");
|
|
96
|
+
const lockDir = join(engineRoot, MEMORY_DEPLOYMENT_ERASURE_LOCK_DIR);
|
|
97
|
+
const lock = await acquireStoreTxnLock(lockDir, { now: Date.now });
|
|
98
|
+
let lost;
|
|
99
|
+
const heartbeat = setInterval(() => {
|
|
100
|
+
try {
|
|
101
|
+
renewStoreTxnLock(lockDir, lock.token);
|
|
102
|
+
}
|
|
103
|
+
catch (err) {
|
|
104
|
+
lost ??= err;
|
|
105
|
+
}
|
|
106
|
+
}, TXN_LOCK_STALE_MS / 3);
|
|
107
|
+
heartbeat.unref?.();
|
|
108
|
+
const fence = (when) => {
|
|
109
|
+
if (lost === undefined) {
|
|
110
|
+
try {
|
|
111
|
+
assertStoreTxnLockOwnership(lockDir, lock.token);
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
catch (err) {
|
|
115
|
+
lost = err;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
throw new ControlPlaneCorruptError(`eraseMemoryEntries: the deployment's erasure lock was lost ${when} (the holder stalled past its stale line and another erasure took it) — the stores this request executed keep their anchors; a replay of the same requestId converges them`, { cause: lost, facet: "lock-ownership" });
|
|
119
|
+
};
|
|
120
|
+
try {
|
|
121
|
+
const all = stores();
|
|
122
|
+
const reach = reachOf(req, all);
|
|
123
|
+
const grant = req.expectedScopes !== undefined ? canonicalExpectedScopes(req.expectedScopes) : undefined;
|
|
124
|
+
const selectHash = erasureSelectHash(req.select);
|
|
125
|
+
for (const store of new Set([...all, ...reach])) {
|
|
126
|
+
const anchor = await anchorOf(store.backend, req.requestId);
|
|
127
|
+
if (anchor === undefined)
|
|
128
|
+
continue;
|
|
129
|
+
const recorded = anchor.expectedScopes;
|
|
130
|
+
const sameGrant = recorded === undefined || grant === undefined ? recorded === grant : recorded.length === grant.length && recorded.every((s, i) => grant[i] === s);
|
|
131
|
+
if (!sameGrant) {
|
|
132
|
+
throw coded(`eraseMemoryEntries: requestId ${JSON.stringify(req.requestId)} was first executed under a different expectedScopes set — a requestId names one request under one authorization; nothing is reported`, "config.memory_erasure_scope");
|
|
133
|
+
}
|
|
134
|
+
if (anchor.selectHash === selectHash && reach.includes(store))
|
|
135
|
+
continue;
|
|
136
|
+
throw coded(`eraseMemoryEntries: requestId ${JSON.stringify(req.requestId)} was first executed ${anchor.selectHash === selectHash ? "in another of this deployment's memory stores" : "with a DIFFERENT selector"} — a requestId names ONE request in the deployment; use a new requestId for a new selector (nothing was deleted, nothing was recorded)`, "memory.erasure_selector_mismatch");
|
|
137
|
+
}
|
|
138
|
+
let receipt;
|
|
139
|
+
for (const store of reach) {
|
|
140
|
+
fence(receipt === undefined ? "before any store executed" : "between two stores' executions");
|
|
141
|
+
const part = await store.engine.eraseMemoryEntries(req);
|
|
142
|
+
receipt = receipt === undefined ? part : mergeErasureAttestations(receipt, part);
|
|
143
|
+
}
|
|
144
|
+
fence("while a store executed");
|
|
145
|
+
if (receipt === undefined)
|
|
146
|
+
throw new Error("eraseMemoryEntries: no store reached (unreachable — a request reaches at least the project store)");
|
|
147
|
+
return receipt;
|
|
148
|
+
}
|
|
149
|
+
finally {
|
|
150
|
+
clearInterval(heartbeat);
|
|
151
|
+
lock.release();
|
|
152
|
+
}
|
|
153
|
+
},
|
|
154
|
+
async sessionMemoryStatus(sessionId) {
|
|
155
|
+
const planes = [{ plane: "project", status: await project.engine.sessionMemoryStatus(sessionId) }];
|
|
156
|
+
if (hasPersonalStore()) {
|
|
157
|
+
let seat;
|
|
158
|
+
try {
|
|
159
|
+
seat = personalStore();
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
seat = undefined;
|
|
163
|
+
}
|
|
164
|
+
planes.push({ plane: "personal", status: seat !== undefined ? await seat.engine.sessionMemoryStatus(sessionId) : { optOutSource: "fault" } });
|
|
165
|
+
}
|
|
166
|
+
return { ...foldSessionMemoryStatuses(planes.map((p) => p.status)), planes };
|
|
167
|
+
},
|
|
168
|
+
};
|
|
169
|
+
}
|
|
170
|
+
async function anchorOf(store, requestId) {
|
|
171
|
+
const face = store;
|
|
172
|
+
if (typeof face.erasureAnchorOf === "function")
|
|
173
|
+
return face.erasureAnchorOf.call(store, requestId);
|
|
174
|
+
if (typeof face.eraseWithEvidence !== "function")
|
|
175
|
+
return undefined;
|
|
176
|
+
throw coded("eraseMemoryEntries: another store of this deployment has an erasure-evidence face but no anchor read (erasureAnchorOf), so whether it already executed this requestId cannot be judged — nothing was deleted", "memory.erasure_evidence_unavailable");
|
|
177
|
+
}
|
|
178
|
+
function coded(message, code) {
|
|
179
|
+
const e = new Error(message);
|
|
180
|
+
e.code = code;
|
|
181
|
+
return e;
|
|
182
|
+
}
|
|
@@ -1,15 +1,18 @@
|
|
|
1
1
|
import { type MemorySyncCursor } from "./sync.js";
|
|
2
2
|
import { type MemoryBackend, type MemoryEntry, type PatchReport } from "./types.js";
|
|
3
|
-
type CursorAxis = "scope" | "peer" | "store";
|
|
4
|
-
/** The refusal of a sync
|
|
5
|
-
* sync's (`config.memory_sync_cursor_mismatch`, with `detail` naming the axis
|
|
6
|
-
*
|
|
7
|
-
*
|
|
3
|
+
type CursorAxis = "scope" | "peer" | "store" | "incarnation";
|
|
4
|
+
/** The refusal of a sync whose baseline does not hold, raised before anything is written on either side: the cursor
|
|
5
|
+
* is not this sync's (`config.memory_sync_cursor_mismatch`, with `detail` naming the axis, what the cursor carried
|
|
6
|
+
* there and this sync's value on it) — judged here before any read or transport call on its scope, peer and store,
|
|
7
|
+
* and by the peer before any write on its incarnation, read off the peer's refusal before any local write — or the
|
|
8
|
+
* local store has nothing to bind a cursor to (`config.memory_sync_store`, no `detail`). `outs` are the two ways out
|
|
9
|
+
* its sentence names. */
|
|
8
10
|
type SyncRefusal = Error & {
|
|
9
11
|
code: "config.memory_sync_cursor_mismatch" | "config.memory_sync_store";
|
|
10
12
|
detail?: {
|
|
11
13
|
readonly axis: CursorAxis;
|
|
12
14
|
readonly found: "absent" | "other";
|
|
15
|
+
readonly want: string;
|
|
13
16
|
};
|
|
14
17
|
outs: readonly [string, string];
|
|
15
18
|
};
|
|
@@ -29,9 +32,11 @@ export interface MemorySyncTransport {
|
|
|
29
32
|
* same-principal egress pass would redact is refused before any read or request. Read once per call, and
|
|
30
33
|
* taken at its word: the engine cannot see where `post` actually sends. */
|
|
31
34
|
readonly peer: string;
|
|
32
|
-
/** Maps `path` (e.g. `/
|
|
33
|
-
* JSON body of a 2xx response
|
|
34
|
-
*
|
|
35
|
+
/** Maps `path` (e.g. `/v2/memory/sync/user%3Aalice`) onto the peer, attaches auth, and returns the DECODED
|
|
36
|
+
* JSON body of a 2xx response — the answer to the call: its result, or the peer's refusal of it
|
|
37
|
+
* (`{ refused: "baseline_incarnation", incarnation }`, a 2xx answer like a result); any non-2xx / network
|
|
38
|
+
* failure should THROW (the call then aborts with zero local side effects — the transport runs before any
|
|
39
|
+
* local write). */
|
|
35
40
|
post(path: string, body: unknown): Promise<unknown>;
|
|
36
41
|
}
|
|
37
42
|
/** The wire REQUEST of one round (the server's `parseMemorySyncRequest` twin): the push
|
|
@@ -40,6 +45,11 @@ export interface MemorySyncTransport {
|
|
|
40
45
|
export interface MemorySyncRequestBody {
|
|
41
46
|
/** The transport's {@link MemorySyncTransport.peer}. */
|
|
42
47
|
peer: string;
|
|
48
|
+
/** The claim of which state of the peer `baseRevs` was taken against: the cursor's
|
|
49
|
+
* {@link MemorySyncCursor.peerIncarnation} verbatim, present whenever the cursor carries one. The peer compares it
|
|
50
|
+
* with its own incarnation before any write and refuses — writing nothing — when they differ, or when
|
|
51
|
+
* `baseRevs` is not empty and no claim is made. */
|
|
52
|
+
peerIncarnation?: string;
|
|
43
53
|
/** id → rev at the last completed round (the cursor's baseRevs; empty = first round). */
|
|
44
54
|
baseRevs: Record<string, string>;
|
|
45
55
|
/** Full state of every entry new/changed here since the baseline. When
|
|
@@ -59,7 +69,9 @@ export interface MemorySyncRequestBody {
|
|
|
59
69
|
/** The wire RESPONSE of one round (server `MemorySyncResponse` twin: one RTT, both
|
|
60
70
|
* directions; `serverDeletes` is the delete-propagation leg [without it a central
|
|
61
71
|
* removal never crosses = livelock]; `cursor` is the server-computed next baseline with the
|
|
62
|
-
* retention discipline ALREADY applied to the pull half).
|
|
72
|
+
* retention discipline ALREADY applied to the pull half). A peer that refuses answers
|
|
73
|
+
* `{ refused: "baseline_incarnation", incarnation }` instead — its own incarnation, nothing written — which the
|
|
74
|
+
* sync raises as the cursor refusal on the incarnation axis. */
|
|
63
75
|
export interface MemorySyncResponseBody {
|
|
64
76
|
/** Ops the server actually landed from our push (empty on an idempotent replay). */
|
|
65
77
|
applied: PatchReport["applied"];
|
|
@@ -81,9 +93,13 @@ export interface MemorySyncResponseBody {
|
|
|
81
93
|
/** The next baseline to persist AFTER the pull half lands (the client cannot compute it — it
|
|
82
94
|
* does not hold the central set). Pull-half ids are retained at the OLD baseline inside; the
|
|
83
95
|
* client advances the LANDED ones to their landed state before persisting (see ⑤ — otherwise
|
|
84
|
-
* every landed pull echoes back next round and a central delete can be resurrected).
|
|
96
|
+
* every landed pull echoes back next round and a central delete can be resurrected).
|
|
97
|
+
* `incarnation` names the state that answered — the scope's partition on this peer, a value no other partition
|
|
98
|
+
* or state of it carries, every write of this exchange committed under it; it equals the request's claim when
|
|
99
|
+
* one was made, and the next cursor carries it as its `peerIncarnation`. */
|
|
85
100
|
cursor: {
|
|
86
101
|
peer: string;
|
|
102
|
+
incarnation: string;
|
|
87
103
|
baseRevs: Record<string, string>;
|
|
88
104
|
updatedAtMs: number;
|
|
89
105
|
};
|
|
@@ -113,13 +129,16 @@ export interface SyncMemoryScopeOptions {
|
|
|
113
129
|
transport: MemorySyncTransport;
|
|
114
130
|
/** The persisted cursor from the last completed sync with this transport's peer; absent = the first sync. A
|
|
115
131
|
* cursor for another scope, peer or local store — or one with no peer or store binding — is refused
|
|
116
|
-
* (`config.memory_sync_cursor_mismatch`) before any I/O;
|
|
117
|
-
*
|
|
118
|
-
*
|
|
119
|
-
*
|
|
120
|
-
*
|
|
121
|
-
*
|
|
122
|
-
*
|
|
132
|
+
* (`config.memory_sync_cursor_mismatch`) before any I/O; a cursor whose baseline was taken against another state of
|
|
133
|
+
* the peer — or one with a non-empty baseline and no incarnation — is refused by the peer before it writes, and the
|
|
134
|
+
* call raises the same refusal before any local write. The refusal carries `detail: { axis, found, want }` and the
|
|
135
|
+
* two ways out its sentence names (`outs`): for a scope, that partition's own cursor or none before its first
|
|
136
|
+
* completed sync; for a peer, re-bind over a transport that reaches the cursor's peer, or drop the cursor; for an
|
|
137
|
+
* incarnation, re-bind against the state the baseline was taken against (setting `peerIncarnation` to `want` only
|
|
138
|
+
* for a cursor that carries none, over that same state), or drop the cursor; for a store, rebind the cursor to this
|
|
139
|
+
* store (its `store` set to `memorySyncStoreOf(backend)`) when this store holds the entries its baseline was taken
|
|
140
|
+
* over, or delete it and sync from none, which brings back an entry deleted on either side since the last completed
|
|
141
|
+
* sync. The engine takes none of them on the host's behalf; `memorySyncReportOf` reads the refusal for a host. */
|
|
123
142
|
cursor?: MemorySyncCursor;
|
|
124
143
|
/** Caller-injected clock (engine precedent) — stamps the returned cursor's updatedAtMs. */
|
|
125
144
|
now?: () => number;
|
|
@@ -184,7 +203,9 @@ export interface MemorySyncClientResult {
|
|
|
184
203
|
/** Does a name a sync carries verbatim (a peer identity, a target, a scope key) hold a credential — a URL with userinfo
|
|
185
204
|
* (any, a bare user name included: the slot is the credential's), or anything the same-principal egress pass would
|
|
186
205
|
* redact? Such a name is refused, never cleaned: a cleaned identity is another identity, and the cursor taken under it
|
|
187
|
-
* would not be this peer's. The
|
|
206
|
+
* would not be this peer's. The userinfo is looked for wherever the string holds a URL's authority, not only at its head:
|
|
207
|
+
* a name that wraps a URL under another scheme (`proj:https://user@host/…`) parses as an opaque path, with no userinfo
|
|
208
|
+
* slot to read, yet it carries the same credential. The one test for the sync client and its report. */
|
|
188
209
|
export declare function carriesCredential(peer: string): boolean;
|
|
189
210
|
/**
|
|
190
211
|
* One full CLIENT sync round for one (scope, peer) against the central sync API — see the
|