@sema-agent/core 7.59.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 +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- 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 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- 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.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- 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 +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- 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/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- 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-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- 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/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- 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 +106 -32
- 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 +15 -0
- package/dist/core/frame-settlement.js +10 -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 +9 -6
- package/dist/core/gate-lanes.js +46 -12
- 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 +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -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 +55 -3
- package/dist/core/locked-config.js +84 -51
- 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-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -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 +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- 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 +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- 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 +23 -55
- package/dist/core/mcp.js +172 -156
- 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-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- 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/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- 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/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- 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 +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- 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 +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- 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 +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- 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 +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- 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/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- 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/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -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 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- 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/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- 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 +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- 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/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- 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/memory-consolidation-driver.js +4 -4
- 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 +29 -10
- 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 +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- 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 +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- 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-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -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 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- 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-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- 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-checkpoint-screen.js +4 -4
- 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 +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- 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 +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- 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/skills-seat.js +2 -2
- 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/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- 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 -4
- 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.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- 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-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- 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 +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- 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 +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- 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 +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- 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.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- 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 +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- 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 +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- 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 +3 -6
- 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.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- 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 +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- 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 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- 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 +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- 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 +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- 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 +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- 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.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- 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.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -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/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- 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 +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- 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 +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -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
|
@@ -24,7 +24,7 @@ export declare class FileMemoryStore implements MemoryStore {
|
|
|
24
24
|
/** Set by {@link close}: a background embed that resolves AFTER close must NOT writeSync to the (now closed)
|
|
25
25
|
* vlog fd — a stray write on a recycled fd could corrupt an unrelated file. */
|
|
26
26
|
private closed;
|
|
27
|
-
constructor(root: string,
|
|
27
|
+
constructor(root: string, options?: {
|
|
28
28
|
embedder?: Embedder;
|
|
29
29
|
embedTimeoutMs?: number;
|
|
30
30
|
});
|
|
@@ -4,8 +4,10 @@ import { firstSentence, lexicalSearchMatch, parseNoteTimestamp, MemoryProjection
|
|
|
4
4
|
import { cosineDistance, jaccardDistance, termSet } from "../../core/memory-vector.js";
|
|
5
5
|
import { canonicalStoreKey, AppendLog, atomicWriteFile, ensureDir, readJsonlRecords, sanitizeScope, } from "./fs-atomic.js";
|
|
6
6
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
7
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
7
8
|
const MAX_OPEN_MEMORY_SCOPES = 64;
|
|
8
9
|
const sharedMemoryDirs = new Map();
|
|
10
|
+
const FILE_MEMORY_STORE_OPTION_KEYS = optionKeys()({ embedder: 0, embedTimeoutMs: 0 });
|
|
9
11
|
export class FileMemoryStore {
|
|
10
12
|
root;
|
|
11
13
|
embedder;
|
|
@@ -17,7 +19,8 @@ export class FileMemoryStore {
|
|
|
17
19
|
sharedScopes;
|
|
18
20
|
scopeKey;
|
|
19
21
|
closed = false;
|
|
20
|
-
constructor(root,
|
|
22
|
+
constructor(root, options) {
|
|
23
|
+
const opts = receiveOptions(options, "FileMemoryStore", FILE_MEMORY_STORE_OPTION_KEYS);
|
|
21
24
|
assertAdoptionBootGate(root, "FileMemoryStore");
|
|
22
25
|
this.root = join(root, "memory");
|
|
23
26
|
this.scopeKey = canonicalStoreKey(this.root);
|
|
@@ -6,40 +6,43 @@ import { principalNameOf } from "../../core/principal-name.js";
|
|
|
6
6
|
import { createPermissionRuleStoreProvider } from "../../core/permission-rule-provider.js";
|
|
7
7
|
import { syncPermissionRules } from "../../core/permission-rule-sync.js";
|
|
8
8
|
import { thrownText } from "../../core/thrown-value.js";
|
|
9
|
+
import { optionKeys, receiveMembers } from "../../core/own-property-receipt.js";
|
|
9
10
|
import { FileStoreLockError } from "./fs-atomic.js";
|
|
10
11
|
import { FileDurableRulePartitionProvider, LOCAL_OWNER_FILE, principalRuleFileName, readRuleAdoptionFile, writeRuleAdoptionFile, } from "./permission-rule-store.js";
|
|
12
|
+
const ADOPT_OPTION_KEYS = optionKeys()({ dir: 0, from: 0, toPrincipal: 0, transport: 0, now: 0, onError: 0 });
|
|
11
13
|
export async function adoptFilePermissionRuleStore(opts) {
|
|
12
|
-
|
|
14
|
+
const o = receiveMembers(opts, { subject: "adoptFilePermissionRuleStore options", unit: "option", moment: "at adoptFilePermissionRuleStore" }, ADOPT_OPTION_KEYS);
|
|
15
|
+
if (principalNameOf(o.toPrincipal) === undefined) {
|
|
13
16
|
throw new Error("adoptFilePermissionRuleStore requires the adopting principal, a principal name — adoption is the act of giving this bucket an identity");
|
|
14
17
|
}
|
|
15
|
-
const from = readRuleOwner(
|
|
18
|
+
const from = readRuleOwner(o.from);
|
|
16
19
|
if (from === undefined) {
|
|
17
20
|
throw new Error("adoptFilePermissionRuleStore requires a source owner — a principal owner whose principal is a principal name, or the local owner");
|
|
18
21
|
}
|
|
19
|
-
if (from.kind === "principal" && from.principal ===
|
|
20
|
-
throw new Error(`the bucket already belongs to "${
|
|
22
|
+
if (from.kind === "principal" && from.principal === o.toPrincipal) {
|
|
23
|
+
throw new Error(`the bucket already belongs to "${o.toPrincipal}" — there is nothing to adopt`);
|
|
21
24
|
}
|
|
22
|
-
const sourceFile = join(
|
|
23
|
-
const targetFile = join(
|
|
24
|
-
const existing = readRuleAdoptionFile(
|
|
25
|
+
const sourceFile = join(o.dir, from.kind === "local-owner" ? LOCAL_OWNER_FILE : principalRuleFileName(from.principal));
|
|
26
|
+
const targetFile = join(o.dir, principalRuleFileName(o.toPrincipal));
|
|
27
|
+
const existing = readRuleAdoptionFile(o.dir);
|
|
25
28
|
if (existing !== undefined) {
|
|
26
29
|
if ("adopted" in existing) {
|
|
27
|
-
if (existing.adopted.toPrincipal ===
|
|
30
|
+
if (existing.adopted.toPrincipal === o.toPrincipal && sameRuleOwner(existing.adopted.from, from))
|
|
28
31
|
return { status: "adopted" };
|
|
29
32
|
throw new Error(`this directory already carries a completed adoption (${ruleOwnerText(existing.adopted.from)} → "${existing.adopted.toPrincipal}") — a second adoption of the same directory is not a shape this helper supports`);
|
|
30
33
|
}
|
|
31
|
-
if (existing.marker.toPrincipal !==
|
|
34
|
+
if (existing.marker.toPrincipal !== o.toPrincipal || !sameRuleOwner(existing.marker.from, from)) {
|
|
32
35
|
throw new Error(`an adoption toward "${existing.marker.toPrincipal}" is already in flight in this directory — refusing to start a different one (resume the original, or repair the marker by hand)`);
|
|
33
36
|
}
|
|
34
37
|
}
|
|
35
38
|
else if (existsSync(targetFile)) {
|
|
36
|
-
throw new Error(`the target bucket for "${
|
|
39
|
+
throw new Error(`the target bucket for "${o.toPrincipal}" already exists — merging two existing buckets goes through an explicit sync join, not a rename`);
|
|
37
40
|
}
|
|
38
|
-
const provider = new FileDurableRulePartitionProvider(
|
|
41
|
+
const provider = new FileDurableRulePartitionProvider(o.dir, o.onError);
|
|
39
42
|
try {
|
|
40
43
|
let lockProbe;
|
|
41
44
|
try {
|
|
42
|
-
lockProbe = writerOf(provider.forPrincipal(
|
|
45
|
+
lockProbe = writerOf(provider.forPrincipal(o.toPrincipal));
|
|
43
46
|
}
|
|
44
47
|
catch (err) {
|
|
45
48
|
if (!(err instanceof FileStoreLockError))
|
|
@@ -50,7 +53,7 @@ export async function adoptFilePermissionRuleStore(opts) {
|
|
|
50
53
|
throw new Error("the target store refused a write face");
|
|
51
54
|
let phase = existing !== undefined && "marker" in existing ? existing.marker.phase : 2;
|
|
52
55
|
if (existing === undefined) {
|
|
53
|
-
writeRuleAdoptionFile(
|
|
56
|
+
writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 2));
|
|
54
57
|
phase = 2;
|
|
55
58
|
}
|
|
56
59
|
if (phase < 3) {
|
|
@@ -61,11 +64,11 @@ export async function adoptFilePermissionRuleStore(opts) {
|
|
|
61
64
|
}
|
|
62
65
|
if (sourcePresent)
|
|
63
66
|
renameSync(sourceFile, targetFile);
|
|
64
|
-
writeRuleAdoptionFile(
|
|
67
|
+
writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 3));
|
|
65
68
|
phase = 3;
|
|
66
69
|
}
|
|
67
70
|
if (phase < 4) {
|
|
68
|
-
writeRuleAdoptionFile(
|
|
71
|
+
writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 4));
|
|
69
72
|
phase = 4;
|
|
70
73
|
}
|
|
71
74
|
let syncResult;
|
|
@@ -73,9 +76,9 @@ export async function adoptFilePermissionRuleStore(opts) {
|
|
|
73
76
|
try {
|
|
74
77
|
syncResult = await syncPermissionRules({
|
|
75
78
|
provider: createPermissionRuleStoreProvider({ durable: provider }),
|
|
76
|
-
principal:
|
|
77
|
-
transport:
|
|
78
|
-
...(
|
|
79
|
+
principal: o.toPrincipal,
|
|
80
|
+
transport: o.transport,
|
|
81
|
+
...(o.now !== undefined ? { now: o.now } : {}),
|
|
79
82
|
});
|
|
80
83
|
}
|
|
81
84
|
catch (err) {
|
|
@@ -88,12 +91,12 @@ export async function adoptFilePermissionRuleStore(opts) {
|
|
|
88
91
|
error: `the first sync round did not land clean (${(syncResult.warnings ?? []).join("; ") || `${syncResult.dropped.length} drop(s)`}) — resume when the endpoint is healthy`,
|
|
89
92
|
};
|
|
90
93
|
}
|
|
91
|
-
writeRuleAdoptionFile(
|
|
94
|
+
writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 5));
|
|
92
95
|
phase = 5;
|
|
93
96
|
}
|
|
94
|
-
writeRuleAdoptionFile(
|
|
97
|
+
writeRuleAdoptionFile(o.dir, {
|
|
95
98
|
schemaVersion: 1,
|
|
96
|
-
adopted: { from, toPrincipal:
|
|
99
|
+
adopted: { from, toPrincipal: o.toPrincipal, atMs: (o.now ?? Date.now)() },
|
|
97
100
|
});
|
|
98
101
|
return { status: "adopted", ...(syncResult !== undefined ? { syncResult } : {}) };
|
|
99
102
|
}
|
|
@@ -11,6 +11,7 @@ import { SESSION_RULES_GRAMMAR, readRuleGrammarStamp } from "../../core/session-
|
|
|
11
11
|
import { canonicalize } from "../../core/canonical-json.js";
|
|
12
12
|
import { BootLock, FileStoreLockError } from "./fs-atomic.js";
|
|
13
13
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
14
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
14
15
|
import { thrownText } from "../../core/thrown-value.js";
|
|
15
16
|
function isRuleFile(v) {
|
|
16
17
|
const p = v;
|
|
@@ -402,6 +403,7 @@ class FileDurableRulePartition {
|
|
|
402
403
|
}),
|
|
403
404
|
};
|
|
404
405
|
}
|
|
406
|
+
const FILE_DURABLE_RULE_PARTITION_PROVIDER_OPTION_KEYS = optionKeys()({ dataRoot: 0, platform: 0 });
|
|
405
407
|
export class FileDurableRulePartitionProvider {
|
|
406
408
|
dir;
|
|
407
409
|
onError;
|
|
@@ -411,11 +413,12 @@ export class FileDurableRulePartitionProvider {
|
|
|
411
413
|
constructor(dir, onError, opts) {
|
|
412
414
|
this.dir = dir;
|
|
413
415
|
this.onError = onError;
|
|
414
|
-
|
|
415
|
-
|
|
416
|
+
const options = receiveOptions(opts, "FileDurableRulePartitionProvider", FILE_DURABLE_RULE_PARTITION_PROVIDER_OPTION_KEYS);
|
|
417
|
+
if (options.dataRoot !== undefined)
|
|
418
|
+
assertAdoptionBootGate(options.dataRoot, "FileDurableRulePartitionProvider");
|
|
416
419
|
let said = false;
|
|
417
420
|
this.vetting = {
|
|
418
|
-
platform:
|
|
421
|
+
platform: options.platform,
|
|
419
422
|
modeBitsUnjudged: (where) => {
|
|
420
423
|
if (said)
|
|
421
424
|
return;
|
|
@@ -146,7 +146,7 @@ export declare class FileSessionPolicyStore implements SessionPolicyStore {
|
|
|
146
146
|
* identity, so on such a root the anonymous key IS the adopted principal — reads and writes
|
|
147
147
|
* alike (a window-era anonymous write must not mint a fresh orphan row). */
|
|
148
148
|
private readonly anonymousAlias;
|
|
149
|
-
constructor(root: string,
|
|
149
|
+
constructor(root: string, options?: FileSessionPolicyStoreOptions);
|
|
150
150
|
/** The one delivery point for {@link onCorruptRead}. */
|
|
151
151
|
private disclose;
|
|
152
152
|
/** The ONE refusal for a rules file that is PRESENT but cannot be served as rules — every damage grade lands
|
|
@@ -4,6 +4,8 @@ import { judgeSessionRulesWrite, readMountedToolNames, readSessionRulesShape, Se
|
|
|
4
4
|
import { atomicWriteFile, ensureDir, sanitizeScope } from "./fs-atomic.js";
|
|
5
5
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
6
6
|
import { assertAdoptionBootGate, readRootAdoptionFile } from "./adoption/marker.js";
|
|
7
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
8
|
+
const FILE_SESSION_POLICY_STORE_OPTION_KEYS = optionKeys()({ mountedToolNames: 0, onCorruptRead: 0 });
|
|
7
9
|
export const SESSION_POLICY_MARK_SUFFIX = ".hwm.json";
|
|
8
10
|
const MARK_SUFFIX = SESSION_POLICY_MARK_SUFFIX;
|
|
9
11
|
export function readSessionPolicyMark(path) {
|
|
@@ -73,7 +75,8 @@ export class FileSessionPolicyStore {
|
|
|
73
75
|
onCorruptRead;
|
|
74
76
|
mountedToolNames;
|
|
75
77
|
anonymousAlias;
|
|
76
|
-
constructor(root,
|
|
78
|
+
constructor(root, options) {
|
|
79
|
+
const opts = receiveOptions(options, "FileSessionPolicyStore", FILE_SESSION_POLICY_STORE_OPTION_KEYS);
|
|
77
80
|
assertAdoptionBootGate(root, "FileSessionPolicyStore");
|
|
78
81
|
this.mountedToolNames = readMountedToolNames(opts?.mountedToolNames);
|
|
79
82
|
this.dir = join(root, "session-policy");
|
|
@@ -32,7 +32,7 @@ export declare class FileSessionRepo implements SessionRepo {
|
|
|
32
32
|
* `dispose()` walks it and releases each holder share; the weak value is what makes the identity
|
|
33
33
|
* check on the way out possible without pinning a storage the table itself only holds weakly. */
|
|
34
34
|
private readonly joined;
|
|
35
|
-
constructor(root: string,
|
|
35
|
+
constructor(root: string, options?: FileSessionRepoOptions);
|
|
36
36
|
/** The one delivery point for {@link FileSessionRepoOptions.onCorruptRead}'s whole-file level; `sessionId` when the file is one session's log. */
|
|
37
37
|
private disclose;
|
|
38
38
|
private pathFor;
|
|
@@ -51,6 +51,13 @@ export declare class FileSessionRepo implements SessionRepo {
|
|
|
51
51
|
* the row). `skipped` words the corrupt-header refusal's reading of the records around it, where the caller has one.
|
|
52
52
|
*/
|
|
53
53
|
private headerOf;
|
|
54
|
+
/**
|
|
55
|
+
* The row's header record, where the log has one: its FIRST record, which must be the meta header every write path lays down. A log whose
|
|
56
|
+
* first record is anything else is no row this store wrote — `corrupt_session`, said once here for every reader of the row. The cells
|
|
57
|
+
* inside it are each read by their own reader ({@link headerOf} for the whole header, `placementOf` for the placement tuple alone):
|
|
58
|
+
* a reader of one cell does not answer for the others.
|
|
59
|
+
*/
|
|
60
|
+
private metaLineOf;
|
|
54
61
|
/**
|
|
55
62
|
* The row's head in one read, without replaying the log: ONE descriptor on the session file, its first record for the owner and
|
|
56
63
|
* occupant cells, and walking back from its end to the last entry record for the leaf. The three come from one inode — a file
|
|
@@ -73,9 +80,13 @@ export declare class FileSessionRepo implements SessionRepo {
|
|
|
73
80
|
* `undefined` = no row; a row whose header cannot be read rejects (`corrupt_session`).
|
|
74
81
|
*/
|
|
75
82
|
private rowOf;
|
|
76
|
-
/** The one descriptor a by-id read of the row takes: its size and modification time and its header, from one inode (a
|
|
77
|
-
* or removed while this reads is still the inode this descriptor opened); `undefined` = no file.
|
|
83
|
+
/** The one descriptor a by-id read of the row takes: its size and modification time and its header decoded whole, from one inode (a
|
|
84
|
+
* file replaced or removed while this reads is still the inode this descriptor opened); `undefined` = no file. A reader of one cell
|
|
85
|
+
* alone takes {@link atFirstRecord}, which this is built on. */
|
|
78
86
|
private atRow;
|
|
87
|
+
/** The descriptor under every by-id header read: the file's size and modification time and its first record, undecoded — the bytes
|
|
88
|
+
* each cell's reader decodes. One inode, bounded by the lines before the first record, never by the log; `undefined` = no file. */
|
|
89
|
+
private atFirstRecord;
|
|
79
90
|
private storage;
|
|
80
91
|
/**
|
|
81
92
|
* RB-437 — release every shared authority this repo joined (LAST holder ⇒ evict + close the append fd).
|
|
@@ -119,7 +130,9 @@ export declare class FileSessionRepo implements SessionRepo {
|
|
|
119
130
|
scope?: string;
|
|
120
131
|
}): Promise<PlacedSessionRow[]>;
|
|
121
132
|
/** Cheap placement probe for one id (the TtlSessionStore's cold-cache release consults it so the
|
|
122
|
-
* placed real-deletion obligation holds after a restart)
|
|
133
|
+
* placed real-deletion obligation holds after a restart), answered from the row's header record alone — never a replay of its log —
|
|
134
|
+
* and from the placement cell alone: a row whose owner cell cannot be read still says whether it is placed (the readers of the owner
|
|
135
|
+
* refuse that row; this probe is not one of them). `undefined` = missing file OR unplaced; a log with no header record rejects. */
|
|
123
136
|
placementOf(sessionId: string): Promise<SessionPlacementRecord | undefined>;
|
|
124
137
|
delete(metadata: SessionMetadata, expect?: SessionRowExpectation): Promise<void>;
|
|
125
138
|
fork(sourceMetadata: SessionMetadata, options?: SessionForkOptions & SessionCreateOptions): Promise<Session>;
|
|
@@ -4,6 +4,7 @@ import { BaseSessionStorage, StoredSession, SessionError, assertForkTarget, comp
|
|
|
4
4
|
import { canonicalStoreKey, AppendLog, atomicWriteFile, ensureDir, firstJsonlRecord, lastJsonlRecord, readJsonlRecords, sanitizePathComponent, writeThenLink } from "./fs-atomic.js";
|
|
5
5
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
6
6
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
7
|
+
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
7
8
|
import { thrownText } from "../../core/thrown-value.js";
|
|
8
9
|
const SUFFIX = ".jsonl";
|
|
9
10
|
const SESSION_LINE_JUDGE = {
|
|
@@ -71,12 +72,14 @@ class FileSessionStorage extends BaseSessionStorage {
|
|
|
71
72
|
this.recordEntry(entry);
|
|
72
73
|
}
|
|
73
74
|
}
|
|
75
|
+
const FILE_SESSION_REPO_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
|
|
74
76
|
export class FileSessionRepo {
|
|
75
77
|
dir;
|
|
76
78
|
tmpDir;
|
|
77
79
|
onCorruptRead;
|
|
78
80
|
joined = new Map();
|
|
79
|
-
constructor(root,
|
|
81
|
+
constructor(root, options) {
|
|
82
|
+
const opts = receiveOptions(options, "FileSessionRepo", FILE_SESSION_REPO_OPTION_KEYS);
|
|
80
83
|
assertAdoptionBootGate(root, "FileSessionRepo");
|
|
81
84
|
this.dir = join(root, "sessions");
|
|
82
85
|
this.tmpDir = join(root, "tmp");
|
|
@@ -109,21 +112,25 @@ export class FileSessionRepo {
|
|
|
109
112
|
return { meta, entries };
|
|
110
113
|
}
|
|
111
114
|
headerOf(id, path, first, skipped = () => "") {
|
|
112
|
-
|
|
113
|
-
throw new SessionError("corrupt_session", `Session ${id} is unreadable: its log has no meta header${skipped()}`);
|
|
115
|
+
const head = this.metaLineOf(id, first, skipped);
|
|
114
116
|
const said = (key) => (detail) => this.disclose(path, `session header ${key}: ${detail}`, id);
|
|
115
|
-
const incarnation = readIncarnationCell(
|
|
116
|
-
const forkedFromIncarnation = readIncarnationCell(
|
|
117
|
+
const incarnation = readIncarnationCell(head.incarnation, said("incarnation"));
|
|
118
|
+
const forkedFromIncarnation = readIncarnationCell(head.forkedFromIncarnation, said("forkedFromIncarnation"));
|
|
117
119
|
return {
|
|
118
120
|
id,
|
|
119
|
-
createdAt:
|
|
120
|
-
...(
|
|
121
|
-
...(
|
|
121
|
+
createdAt: head.createdAt,
|
|
122
|
+
...(head.forkedFrom !== undefined ? { forkedFrom: head.forkedFrom } : {}),
|
|
123
|
+
...(head.placement !== undefined ? { placement: head.placement } : {}),
|
|
122
124
|
...(incarnation !== undefined ? { incarnation } : {}),
|
|
123
125
|
...(forkedFromIncarnation !== undefined ? { forkedFromIncarnation } : {}),
|
|
124
|
-
owner: readOwnerCell(
|
|
126
|
+
owner: readOwnerCell(head.owner, id),
|
|
125
127
|
};
|
|
126
128
|
}
|
|
129
|
+
metaLineOf(id, first, skipped = () => "") {
|
|
130
|
+
if (first === undefined || first.kind !== "meta")
|
|
131
|
+
throw new SessionError("corrupt_session", `Session ${id} is unreadable: its log has no meta header${skipped()}`);
|
|
132
|
+
return first;
|
|
133
|
+
}
|
|
127
134
|
async headOf(sessionId) {
|
|
128
135
|
return this.headNow(sessionId);
|
|
129
136
|
}
|
|
@@ -154,9 +161,12 @@ export class FileSessionRepo {
|
|
|
154
161
|
}
|
|
155
162
|
atRow(sessionId, read) {
|
|
156
163
|
const path = this.pathFor(sessionId);
|
|
164
|
+
return this.atFirstRecord(sessionId, (fd, size, first, mtimeMs) => read(fd, size, this.headerOf(sessionId, path, first), mtimeMs));
|
|
165
|
+
}
|
|
166
|
+
atFirstRecord(sessionId, read) {
|
|
157
167
|
let fd;
|
|
158
168
|
try {
|
|
159
|
-
fd = openSync(
|
|
169
|
+
fd = openSync(this.pathFor(sessionId), "r");
|
|
160
170
|
}
|
|
161
171
|
catch (err) {
|
|
162
172
|
if (err.code === "ENOENT")
|
|
@@ -165,7 +175,7 @@ export class FileSessionRepo {
|
|
|
165
175
|
}
|
|
166
176
|
try {
|
|
167
177
|
const { size, mtimeMs } = fstatSync(fd);
|
|
168
|
-
return read(fd, size,
|
|
178
|
+
return read(fd, size, firstJsonlRecord(fd, size, SESSION_LINE_JUDGE), mtimeMs);
|
|
169
179
|
}
|
|
170
180
|
finally {
|
|
171
181
|
closeSync(fd);
|
|
@@ -290,14 +300,7 @@ export class FileSessionRepo {
|
|
|
290
300
|
return out;
|
|
291
301
|
}
|
|
292
302
|
async placementOf(sessionId) {
|
|
293
|
-
|
|
294
|
-
return this.read(sessionId).meta.placement;
|
|
295
|
-
}
|
|
296
|
-
catch (err) {
|
|
297
|
-
if (err instanceof SessionError && err.code === "not_found")
|
|
298
|
-
return undefined;
|
|
299
|
-
throw err;
|
|
300
|
-
}
|
|
303
|
+
return this.atFirstRecord(sessionId, (_fd, _size, first) => this.metaLineOf(sessionId, first).placement);
|
|
301
304
|
}
|
|
302
305
|
async delete(metadata, expect) {
|
|
303
306
|
if (expect !== undefined && !sessionRowMatches(expect, this.headNow(metadata.id), () => sessionLogMarkOf(this.read(metadata.id).entries)))
|
|
@@ -92,6 +92,32 @@ export interface LedgerModel<Row, Ev> {
|
|
|
92
92
|
judgeRow(x: unknown): boolean;
|
|
93
93
|
judgeEvent(x: unknown): boolean;
|
|
94
94
|
}
|
|
95
|
+
/**
|
|
96
|
+
* The ONE fold of a snapshot+ledger pair into its rows: the snapshot (the compacted base) row by row, then the live ledger's events in
|
|
97
|
+
* order (last-writer-wins, `model.apply`). A READ — it takes no writer fence, opens no append handle and creates nothing (a missing file
|
|
98
|
+
* reads as empty), so it is what both the authority's own bootstrap ({@link LedgerCore.bootstrap}, which takes the fence first) and a
|
|
99
|
+
* reader that must not contend for the directory ({@link readLedgerSettled}) run: a reader never carries a second copy of the fold.
|
|
100
|
+
*/
|
|
101
|
+
export declare function replayLedger<Row, Ev>(paths: Pick<LedgerPaths, "snapshotPath" | "ledgerPath" | "onCorruptRead">, model: LedgerModel<Row, Ev>): {
|
|
102
|
+
rows: Map<string, Row>;
|
|
103
|
+
events: number;
|
|
104
|
+
};
|
|
105
|
+
/**
|
|
106
|
+
* {@link replayLedger} for a reader that takes NO writer fence, beside a writer that may be compacting. The pair is read snapshot-first, and
|
|
107
|
+
* compaction rewrites the snapshot and THEN empties the ledger, so a read that saw the old snapshot and the emptied ledger would miss every
|
|
108
|
+
* row that lives only in the new snapshot — a clean-looking state that never existed. Such a read is recognisable by the snapshot having
|
|
109
|
+
* changed version by the time the ledger was read, and is discarded and redone, at most {@link SETTLED_READ_ATTEMPTS} times; a snapshot that
|
|
110
|
+
* will not hold still yields `settled: false` — no reading at all — never the last read. (A compaction that has replaced the snapshot but not
|
|
111
|
+
* yet the ledger is a state a crashed writer leaves too, and the authority's own bootstrap replays exactly that pair.) Appends move nothing
|
|
112
|
+
* here: a ledger read ends at a record boundary, so the events it holds are a prefix of the writer's.
|
|
113
|
+
*/
|
|
114
|
+
export declare function readLedgerSettled<Row, Ev>(paths: Pick<LedgerPaths, "snapshotPath" | "ledgerPath" | "onCorruptRead">, model: LedgerModel<Row, Ev>): {
|
|
115
|
+
settled: true;
|
|
116
|
+
rows: Map<string, Row>;
|
|
117
|
+
events: number;
|
|
118
|
+
} | {
|
|
119
|
+
settled: false;
|
|
120
|
+
};
|
|
95
121
|
/**
|
|
96
122
|
* One directory's authority: the replayed row map, the per-key async mutex, the append log and the
|
|
97
123
|
* event counter. Created and owned by {@link SharedLedgerTable}; every store instance over the
|
|
@@ -1,4 +1,38 @@
|
|
|
1
|
+
import { statSync } from "node:fs";
|
|
1
2
|
import { acquireStoreDirLock, AppendLog, atomicWriteFile, canonicalStoreKey, ensureDir, readJsonlRecords, } from "./fs-atomic.js";
|
|
3
|
+
export function replayLedger(paths, model) {
|
|
4
|
+
const rows = new Map();
|
|
5
|
+
const disclose = paths.onCorruptRead;
|
|
6
|
+
const judge = (accepts, what) => ({ accepts, what: `a ${what} carries none of this ${model.label}'s own members` });
|
|
7
|
+
for (const row of readJsonlRecords(paths.snapshotPath, disclose, judge(model.judgeRow, "snapshot row"))) {
|
|
8
|
+
rows.set(model.keyOf(row), row);
|
|
9
|
+
}
|
|
10
|
+
const events = readJsonlRecords(paths.ledgerPath, disclose, judge(model.judgeEvent, "ledger event"));
|
|
11
|
+
for (const ev of events)
|
|
12
|
+
model.apply(rows, ev);
|
|
13
|
+
return { rows, events: events.length };
|
|
14
|
+
}
|
|
15
|
+
function snapshotVersion(snapshotPath) {
|
|
16
|
+
try {
|
|
17
|
+
const st = statSync(snapshotPath, { bigint: true });
|
|
18
|
+
return `${st.dev}:${st.ino}:${st.size}:${st.mtimeNs}`;
|
|
19
|
+
}
|
|
20
|
+
catch (e) {
|
|
21
|
+
if (e.code === "ENOENT")
|
|
22
|
+
return "absent";
|
|
23
|
+
throw e;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
const SETTLED_READ_ATTEMPTS = 3;
|
|
27
|
+
export function readLedgerSettled(paths, model) {
|
|
28
|
+
for (let attempt = 0; attempt < SETTLED_READ_ATTEMPTS; attempt++) {
|
|
29
|
+
const before = snapshotVersion(paths.snapshotPath);
|
|
30
|
+
const read = replayLedger(paths, model);
|
|
31
|
+
if (snapshotVersion(paths.snapshotPath) === before)
|
|
32
|
+
return { settled: true, ...read };
|
|
33
|
+
}
|
|
34
|
+
return { settled: false };
|
|
35
|
+
}
|
|
2
36
|
export class LedgerCore {
|
|
3
37
|
key;
|
|
4
38
|
paths;
|
|
@@ -20,15 +54,10 @@ export class LedgerCore {
|
|
|
20
54
|
bootstrap() {
|
|
21
55
|
this.fence = acquireStoreDirLock(this.paths.dir, { label: this.model.label });
|
|
22
56
|
try {
|
|
23
|
-
const
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
}
|
|
28
|
-
const events = readJsonlRecords(this.paths.ledgerPath, disclose, judge(this.model.judgeEvent, "ledger event"));
|
|
29
|
-
this.events = events.length;
|
|
30
|
-
for (const ev of events)
|
|
31
|
-
this.model.apply(this.rows, ev);
|
|
57
|
+
const replayed = replayLedger(this.paths, this.model);
|
|
58
|
+
for (const [key, row] of replayed.rows)
|
|
59
|
+
this.rows.set(key, row);
|
|
60
|
+
this.events = replayed.events;
|
|
32
61
|
this.handle = new AppendLog(this.paths.ledgerPath);
|
|
33
62
|
}
|
|
34
63
|
catch (e) {
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ToolResultDeletionReport, ToolResultProvenance, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
|
|
1
|
+
import type { ToolResultDeletionReport, ToolResultProvenance, ToolResultSessionListing, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
|
|
2
2
|
import { type CorruptReadInfo } from "./corrupt-read-sink.js";
|
|
3
3
|
/**
|
|
4
4
|
* design/80 §2.5 — file {@link ToolResultStore}: write-once-idempotent, ONE file per ref.
|
|
@@ -36,7 +36,7 @@ export interface FileToolResultStoreOptions {
|
|
|
36
36
|
export declare class FileToolResultStore implements ToolResultStore {
|
|
37
37
|
private readonly dir;
|
|
38
38
|
private readonly discloseCorrupt;
|
|
39
|
-
constructor(root: string,
|
|
39
|
+
constructor(root: string, options?: FileToolResultStoreOptions);
|
|
40
40
|
/** The one delivery point for {@link FileToolResultStoreOptions.onCorruptRead}. */
|
|
41
41
|
private disclose;
|
|
42
42
|
/** The directory a ref's files live in, and their shared stem. See {@link encodeRefFilename} for why
|
|
@@ -105,4 +105,33 @@ export declare class FileToolResultStore implements ToolResultStore {
|
|
|
105
105
|
* even with a damaged owner record, so removing one on a guess would destroy another session's output.
|
|
106
106
|
*/
|
|
107
107
|
deleteBySession(sessionId: string): ToolResultDeletionReport;
|
|
108
|
+
/**
|
|
109
|
+
* Age out the entries stored more than `maxAgeMs` before `now` (interface: {@link ToolResultStore.reap}). An entry's
|
|
110
|
+
* age is its content file's modification time: the write-once publication sets it and nothing rewrites the file.
|
|
111
|
+
* Both namespaces are swept, and only names this store writes are judged. Removal is content then owner record, the order {@link deleteBySession} keeps; an owner
|
|
112
|
+
* record whose content is already gone — the leftover of an interrupted pass, or of a session sweep — is removed
|
|
113
|
+
* once it is past the cutoff too, and is not counted (it was not an entry). Synchronous: under the data root's single
|
|
114
|
+
* writer nothing interleaves with it.
|
|
115
|
+
*/
|
|
116
|
+
reap(now: number, opts?: {
|
|
117
|
+
maxAgeMs?: number;
|
|
118
|
+
}): number;
|
|
119
|
+
/**
|
|
120
|
+
* The entries `sessionId` owns, as ref + recorded owner (interface: {@link ToolResultStore.listBySession}). The selection is
|
|
121
|
+
* {@link deleteBySession}'s own: it walks the same two namespaces and matches on the SIDECAR's `sessionId`, never on a file name; a
|
|
122
|
+
* sidecar that cannot be read, and content with no sidecar, are counted `unattributable` and not listed.
|
|
123
|
+
*
|
|
124
|
+
* Naming the ref is this backend's one extra step, because a folded name is a digest of the ref and cannot be read back. An entry
|
|
125
|
+
* written by this engine carries its ref in its sidecar; an identity-named entry (a ref inside the filename charset) is its own stem.
|
|
126
|
+
* The ref a record states is believed only when its own encoding is the very file the record sits beside — a record that names a ref
|
|
127
|
+
* stored somewhere else is not this entry's. An entry owned by the session whose ref can be named by neither is counted
|
|
128
|
+
* `unaddressable` (a folded entry written before the sidecar carried it): it is still removed by a sweep, and is never listed under a
|
|
129
|
+
* guessed ref. An entry is what the sweep counts: an owner record whose content file is gone (the leftover of an interrupted sweep, which
|
|
130
|
+
* the next sweep finishes) is listed like the sweep counts it, and `get` answers `undefined` for it — the honest absence a reader of a
|
|
131
|
+
* listing already handles.
|
|
132
|
+
*/
|
|
133
|
+
listBySession(sessionId: string): ToolResultSessionListing;
|
|
134
|
+
/** The ref an entry stored at `dir`/`stem` is stored under, or `undefined` when none can be named: the ref its sidecar states when
|
|
135
|
+
* that ref's own location is this file, else — for an identity-named entry — the stem itself. */
|
|
136
|
+
private refOfEntry;
|
|
108
137
|
}
|