@sema-agent/core 7.62.0 → 7.64.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 +936 -0
- package/dist/agents/cc-peer-directory.js +1 -0
- package/dist/agents/cc-peer-wire.d.ts +4 -0
- package/dist/agents/cc-peer-wire.js +1 -0
- package/dist/agents/cc-uds-peer-channel.js +5 -0
- package/dist/agents/cross-session-judge.d.ts +3 -1
- package/dist/agents/cross-session-judge.js +4 -1
- package/dist/agents/peer-directory.d.ts +8 -0
- package/dist/agents/peer-directory.js +4 -0
- package/dist/agents/peer-held-queue.d.ts +9 -3
- package/dist/agents/peer-held-queue.js +12 -9
- package/dist/agents/peer-idle.d.ts +20 -1
- package/dist/agents/peer-idle.js +23 -12
- package/dist/agents/peer-notice-route.d.ts +16 -5
- package/dist/agents/peer-notice-route.js +11 -9
- package/dist/agents/peer-notices.d.ts +25 -8
- package/dist/agents/peer-notices.js +6 -1
- package/dist/agents/peer-session-drain.d.ts +32 -6
- package/dist/agents/peer-session-drain.js +100 -26
- package/dist/agents/send-message-tool.d.ts +7 -0
- package/dist/agents/send-message-tool.js +18 -6
- package/dist/agents/subagent-transcript-placement.d.ts +23 -0
- package/dist/agents/subagent-transcript-placement.js +14 -0
- package/dist/agents/subagent.js +102 -54
- package/dist/brain/route-adjudicator.js +9 -4
- package/dist/core/allow-entry.d.ts +4 -0
- package/dist/core/approval-object.js +1 -1
- package/dist/core/arg-summary.js +1 -1
- package/dist/core/ask-origin.d.ts +1 -1
- package/dist/core/ask-origin.js +2 -2
- package/dist/core/ask-question.d.ts +2 -2
- package/dist/core/ask-unresolvable-notice.d.ts +13 -4
- package/dist/core/ask-unresolvable-notice.js +10 -3
- package/dist/core/auto-compaction.d.ts +7 -5
- package/dist/core/background-agent-store.d.ts +7 -0
- package/dist/core/background-agent-store.js +3 -0
- package/dist/core/canonical-json.d.ts +23 -13
- package/dist/core/canonical-json.js +4 -4
- package/dist/core/checkpoint-queries.d.ts +50 -4
- package/dist/core/checkpoint-queries.js +42 -17
- package/dist/core/checkpoint-requirements.d.ts +3 -3
- package/dist/core/checkpoint-requirements.js +2 -1
- package/dist/core/checkpoint-row-verdict.d.ts +15 -4
- package/dist/core/checkpoint-row-verdict.js +22 -2
- package/dist/core/checkpoint-store.d.ts +28 -11
- package/dist/core/checkpoint-store.js +45 -4
- package/dist/core/compliance.d.ts +6 -2
- package/dist/core/compliance.js +3 -3
- package/dist/core/context-settings.d.ts +40 -9
- package/dist/core/context-settings.js +32 -10
- package/dist/core/engine-attestation.d.ts +27 -7
- package/dist/core/engine-attestation.js +5 -1
- package/dist/core/engine-notice.d.ts +43 -5
- package/dist/core/extension-requester.d.ts +9 -0
- package/dist/core/extension-requester.js +7 -0
- package/dist/core/file-history-store.d.ts +28 -0
- package/dist/core/file-history-store.js +48 -5
- package/dist/core/fs-write-gate-policy.js +1 -1
- package/dist/core/gate-fold.js +2 -0
- package/dist/core/gate-lanes.js +2 -0
- package/dist/core/gate-outcome.d.ts +39 -2
- package/dist/core/gate-outcome.js +20 -1
- package/dist/core/git-worktree-env.d.ts +62 -3
- package/dist/core/git-worktree-env.js +91 -30
- package/dist/core/governance-codes.d.ts +9 -3
- package/dist/core/governance-codes.js +17 -3
- package/dist/core/leg-identity.d.ts +19 -1
- package/dist/core/leg-identity.js +12 -0
- package/dist/core/mailbox-store.d.ts +39 -4
- package/dist/core/mailbox-store.js +14 -2
- package/dist/core/memory-engine/consolidation-driver.d.ts +32 -17
- package/dist/core/memory-engine/consolidation-driver.js +99 -98
- package/dist/core/memory-engine/consolidation.d.ts +74 -10
- package/dist/core/memory-engine/consolidation.js +183 -11
- package/dist/core/memory-engine/control-objects.d.ts +25 -0
- package/dist/core/memory-engine/control-objects.js +151 -0
- package/dist/core/memory-engine/control-plane-adoption.d.ts +48 -0
- package/dist/core/memory-engine/control-plane-adoption.js +159 -0
- package/dist/core/memory-engine/data-plane.d.ts +8 -4
- package/dist/core/memory-engine/data-plane.js +11 -6
- package/dist/core/memory-engine/delegation-settlement.d.ts +58 -40
- package/dist/core/memory-engine/delegation-settlement.js +270 -85
- package/dist/core/memory-engine/dual-root.d.ts +12 -6
- package/dist/core/memory-engine/dual-root.js +11 -7
- package/dist/core/memory-engine/engine.d.ts +136 -58
- package/dist/core/memory-engine/engine.js +491 -394
- package/dist/core/memory-engine/entry-scan.d.ts +8 -0
- package/dist/core/memory-engine/entry-scan.js +3 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -60
- package/dist/core/memory-engine/file-backend.js +122 -198
- package/dist/core/memory-engine/index.d.ts +8 -7
- package/dist/core/memory-engine/index.js +7 -6
- package/dist/core/memory-engine/landing-admission.d.ts +5 -3
- package/dist/core/memory-engine/landing-admission.js +3 -3
- package/dist/core/memory-engine/layout.d.ts +127 -46
- package/dist/core/memory-engine/layout.js +264 -109
- package/dist/core/memory-engine/memory-backend-contract.d.ts +26 -1
- package/dist/core/memory-engine/memory-backend-contract.js +476 -0
- package/dist/core/memory-engine/memory-deployment.d.ts +42 -11
- package/dist/core/memory-engine/memory-deployment.js +54 -15
- package/dist/core/memory-engine/origin-clearance.d.ts +12 -3
- package/dist/core/memory-engine/origin-clearance.js +68 -9
- package/dist/core/memory-engine/scope-contract.d.ts +52 -11
- package/dist/core/memory-engine/scope-contract.js +68 -19
- package/dist/core/memory-engine/session-write-home.d.ts +37 -2
- package/dist/core/memory-engine/session-write-home.js +38 -11
- package/dist/core/memory-engine/sync-client.d.ts +3 -1
- package/dist/core/memory-engine/sync-client.js +7 -0
- package/dist/core/memory-engine/sync-report.d.ts +3 -2
- package/dist/core/memory-engine/sync-report.js +6 -2
- package/dist/core/memory-engine/tools.d.ts +2 -2
- package/dist/core/memory-engine/tools.js +10 -10
- package/dist/core/memory-engine/types.d.ts +155 -19
- package/dist/core/memory-engine/types.js +2 -0
- package/dist/core/memory.js +15 -6
- package/dist/core/mode-policy.js +3 -3
- package/dist/core/mods/agent-stations.d.ts +18 -0
- package/dist/core/mods/agent-stations.js +8 -6
- package/dist/core/mods/extension-call.d.ts +4 -0
- package/dist/core/mods/extension-call.js +8 -0
- package/dist/core/mods/stations.d.ts +20 -1
- package/dist/core/mods/stations.js +21 -2
- package/dist/core/mods/tool-call.js +3 -4
- package/dist/core/parent-spec-seat.d.ts +2 -2
- package/dist/core/park-selfcheck.js +2 -2
- package/dist/core/pause-registry.d.ts +2 -0
- package/dist/core/pause-registry.js +3 -0
- package/dist/core/peer-channel.d.ts +5 -0
- package/dist/core/permission-rule-consent.d.ts +26 -8
- package/dist/core/permission-rule-consent.js +76 -36
- package/dist/core/permission-rule-store.d.ts +72 -13
- package/dist/core/permission-rule-store.js +29 -8
- package/dist/core/read-only-shell.js +3 -2
- package/dist/core/redaction-marks.d.ts +8 -0
- package/dist/core/redaction-marks.js +6 -0
- package/dist/core/refusal-echo.d.ts +20 -0
- package/dist/core/refusal-echo.js +33 -0
- package/dist/core/remote-env.d.ts +12 -1
- package/dist/core/remote-env.js +3 -0
- package/dist/core/retention.d.ts +180 -10
- package/dist/core/retention.js +45 -0
- package/dist/core/retired-keys.d.ts +5 -0
- package/dist/core/retired-keys.js +3 -0
- package/dist/core/rule-offer-read.d.ts +0 -4
- package/dist/core/rule-offer-read.js +2 -18
- package/dist/core/runner/child-tree.d.ts +29 -3
- package/dist/core/runner/child-tree.js +39 -16
- package/dist/core/runner/classifier-ladder.d.ts +7 -1
- package/dist/core/runner/classifier-ladder.js +4 -2
- package/dist/core/runner/compact-session.js +10 -7
- package/dist/core/runner/compaction-call-options.d.ts +7 -7
- package/dist/core/runner/compaction-call-options.js +3 -2
- package/dist/core/runner/contracts.d.ts +39 -11
- package/dist/core/runner/delegation-owner.d.ts +10 -3
- package/dist/core/runner/delegation-owner.js +4 -1
- package/dist/core/runner/gate-exit.d.ts +6 -0
- package/dist/core/runner/gate-exit.js +13 -4
- package/dist/core/runner/inherited-ask-grants.js +1 -1
- package/dist/core/runner/memory-consolidation-driver.d.ts +10 -5
- package/dist/core/runner/memory-consolidation-driver.js +12 -9
- package/dist/core/runner/memory-consolidation-write-judge.d.ts +2 -1
- package/dist/core/runner/memory-consolidation-write-judge.js +3 -2
- package/dist/core/runner/person-path-rows.d.ts +8 -3
- package/dist/core/runner/person-path-rows.js +5 -1
- package/dist/core/runner/placement-fence.d.ts +12 -0
- package/dist/core/runner/placement-fence.js +20 -6
- package/dist/core/runner/prepare-ask-lane.js +5 -5
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +7 -4
- package/dist/core/runner/prepare-config-doors.js +4 -0
- package/dist/core/runner/prepare-delegation-surface.d.ts +3 -0
- package/dist/core/runner/prepare-delegation-surface.js +2 -2
- package/dist/core/runner/prepare-execution-env.js +17 -6
- package/dist/core/runner/prepare-gate-stations.d.ts +5 -0
- package/dist/core/runner/prepare-gate-stations.js +5 -5
- package/dist/core/runner/prepare-hands-readface.d.ts +2 -1
- package/dist/core/runner/prepare-hands-readface.js +5 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +13 -9
- package/dist/core/runner/prepare-inherited-gate.js +12 -6
- package/dist/core/runner/prepare-memory-engine-session.d.ts +2 -4
- package/dist/core/runner/prepare-memory-engine-session.js +4 -4
- package/dist/core/runner/prepare-memory.d.ts +7 -2
- package/dist/core/runner/prepare-memory.js +41 -39
- package/dist/core/runner/prepare-park-ask.js +4 -3
- package/dist/core/runner/prepare-policy-chain.js +7 -7
- package/dist/core/runner/prepare-prompt-inputs.js +1 -1
- package/dist/core/runner/prepare-task.js +26 -18
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -1
- package/dist/core/runner/prepare-wiring-manifest.js +3 -2
- package/dist/core/runner/prepare-workspace-restore.js +3 -6
- package/dist/core/runner/resume-admission.d.ts +2 -2
- package/dist/core/runner/resume-admission.js +2 -23
- package/dist/core/runner/role-resolution-table.d.ts +98 -0
- package/dist/core/runner/role-resolution-table.js +62 -0
- package/dist/core/runner/run-compaction-machinery.js +2 -2
- package/dist/core/runner/run-identity-wiring.js +12 -9
- package/dist/core/runner/run-leg.js +9 -5
- package/dist/core/runner/run-notification-lane.js +22 -22
- package/dist/core/runner/run-recovery-lanes.js +3 -3
- package/dist/core/runner/run-settle-and-teardown.js +3 -2
- package/dist/core/runner/run-terminal-adoption.js +1 -1
- package/dist/core/runner/run-turn-boundary.js +14 -15
- package/dist/core/runner/runtask.js +1 -1
- package/dist/core/runner/terminal-account.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +4 -2
- package/dist/core/runner/tool-occurrence.js +2 -2
- package/dist/core/runner-deps.d.ts +7 -3
- package/dist/core/secret-env.d.ts +1 -1
- package/dist/core/secret-env.js +4 -4
- package/dist/core/session-checkout.d.ts +168 -0
- package/dist/core/session-checkout.js +579 -0
- package/dist/core/session-store.d.ts +12 -4
- package/dist/core/session-store.js +23 -3
- package/dist/core/session.d.ts +16 -2
- package/dist/core/session.js +3 -0
- package/dist/core/shell-read-silence.js +8 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +0 -12
- package/dist/core/store-contracts/checkpoint-store-contract.js +6 -7
- package/dist/core/store-contracts/peer-directory-contract.js +8 -1
- package/dist/core/store-contracts/session-store-contract.js +39 -0
- package/dist/core/task-event.d.ts +30 -5
- package/dist/core/task-notification.d.ts +119 -32
- package/dist/core/task-notification.js +186 -100
- package/dist/core/task-registry-agent.d.ts +25 -2
- package/dist/core/task-registry-agent.js +56 -22
- package/dist/core/task-registry-shared.d.ts +33 -11
- package/dist/core/task-registry.d.ts +33 -9
- package/dist/core/task-registry.js +36 -18
- package/dist/core/task-spec-members.js +1 -1
- package/dist/core/task-spec.d.ts +27 -2
- package/dist/core/tool-errors.d.ts +14 -6
- package/dist/core/tool-errors.js +1 -1
- package/dist/core/tool-policy.d.ts +32 -13
- package/dist/core/tool-policy.js +27 -17
- package/dist/core/tool-result-store.d.ts +20 -0
- package/dist/core/tool-spec.d.ts +42 -19
- package/dist/core/trace.d.ts +3 -2
- package/dist/core/types.d.ts +1 -1
- package/dist/core/untrusted-egress.d.ts +15 -4
- package/dist/core/untrusted-egress.js +23 -22
- package/dist/core/workflow-journal-store.d.ts +11 -0
- package/dist/core/workflow-journal-store.js +7 -0
- package/dist/core/workflow-run-store.d.ts +9 -0
- package/dist/core/workflow-run-store.js +6 -0
- package/dist/core/workspace-snapshot.d.ts +3 -1
- package/dist/core/workspace-snapshot.js +1 -0
- package/dist/engine/compaction/compaction.d.ts +2 -1
- package/dist/engine/harness/types.d.ts +67 -1
- package/dist/engine/harness/types.js +108 -0
- package/dist/engine/session/import-validate.js +6 -1
- package/dist/engine/session/session.d.ts +30 -1
- package/dist/engine/session/session.js +48 -1
- package/dist/index.d.ts +12 -7
- package/dist/index.js +12 -7
- package/dist/internal/harness-types.d.ts +1 -1
- package/dist/orchestration/run-workflow-tool.d.ts +8 -1
- package/dist/orchestration/run-workflow-tool.js +8 -0
- package/dist/orchestration/workflow-types.d.ts +2 -1
- package/dist/orchestration/workflow.d.ts +6 -0
- package/dist/orchestration/workflow.js +5 -2
- package/dist/stores/file/checkpoint-store.d.ts +6 -0
- package/dist/stores/file/checkpoint-store.js +4 -1
- package/dist/stores/file/file-history-store.d.ts +13 -0
- package/dist/stores/file/file-history-store.js +75 -13
- package/dist/stores/file/index.d.ts +11 -1
- package/dist/stores/file/index.js +7 -11
- package/dist/stores/file/permission-rule-store.d.ts +23 -0
- package/dist/stores/file/permission-rule-store.js +75 -7
- package/dist/stores/file/session-store.js +2 -1
- package/dist/stores/file/tool-result-store.d.ts +14 -0
- package/dist/stores/file/tool-result-store.js +39 -2
- package/dist/stores/file/workflow-journal-store.d.ts +4 -0
- package/dist/stores/file/workflow-journal-store.js +17 -0
- package/dist/stores/file/workflow-run-store.d.ts +3 -0
- package/dist/stores/file/workflow-run-store.js +15 -0
- package/dist/tools/fs/bash-program-position.js +3 -3
- package/dist/tools/fs/program-read-model.d.ts +34 -10
- package/dist/tools/fs/program-read-model.js +37 -7
- package/dist/tools/fs/program-read-model.rows.js +13 -2
- package/dist/tools/fs/read-deny.d.ts +28 -3
- package/dist/tools/fs/read-deny.js +18 -2
- package/dist/tools/fs/removal-targets.js +3 -3
- package/dist/tools/fs/safety.d.ts +2 -0
- package/dist/tools/fs/safety.js +1 -1
- package/dist/tools/fs/shell-read-argv.d.ts +8 -1
- package/dist/tools/fs/shell-read-argv.js +34 -29
- package/dist/tools/fs/shell-read-bindings.d.ts +2 -0
- package/dist/tools/fs/shell-read-bindings.js +5 -1
- package/dist/tools/fs/shell-read-brace.d.ts +18 -0
- package/dist/tools/fs/shell-read-brace.js +79 -0
- package/dist/tools/fs/shell-read-check.d.ts +8 -2
- package/dist/tools/fs/shell-read-check.js +16 -14
- package/dist/tools/fs/shell-read-establish.js +23 -16
- package/dist/tools/fs/shell-read-judge.d.ts +11 -0
- package/dist/tools/fs/shell-read-judge.js +3 -3
- package/dist/tools/fs/shell-read-plan.d.ts +10 -0
- package/dist/tools/fs/shell-read-plan.js +189 -93
- package/dist/tools/fs/shell-read-start.d.ts +19 -9
- package/dist/tools/fs/shell-read-start.js +20 -12
- package/dist/tools/fs/shell-read-word.d.ts +10 -0
- package/dist/tools/fs/shell-read-word.js +9 -5
- package/dist/tools/fs/shell-read-workdir.d.ts +26 -7
- package/dist/tools/fs/shell-read-workdir.js +73 -12
- package/dist/tools/fs/shell-read-write-targets.js +13 -8
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +7 -35
- package/package.json +3 -2
- package/test/export-surface.snapshot.json +135 -11
- package/wire-changes/core-stores-sql@7.63.0.json +30 -0
- package/wire-changes/core-stores-sql@7.64.0.json +30 -0
- package/wire-changes/core@7.63.0.json +3523 -0
- package/wire-changes/core@7.64.0.json +2653 -0
- package/wire-changes/mods-kernel@7.63.0.json +30 -0
- package/wire-changes/mods-kernel@7.64.0.json +30 -0
- package/wire-changes/primitives@7.63.0.json +445 -0
- package/wire-changes/primitives@7.64.0.json +30 -0
- package/dist/core/credential-vocabulary.d.ts +0 -176
- package/dist/core/credential-vocabulary.js +0 -190
- package/dist/core/redaction-passes.d.ts +0 -82
- package/dist/core/redaction-passes.js +0 -377
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
2
|
import { closeSync, existsSync, fsyncSync, linkSync, lstatSync, openSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
|
|
3
3
|
import { basename, dirname, join } from "node:path";
|
|
4
|
-
import { QUARANTINE_DIR, appendChallengeEvents, claimStaging,
|
|
4
|
+
import { QUARANTINE_DIR, appendChallengeEvents, claimStaging, ensureDirExists, fileGovernanceDocOf, isSameFile, lockedStrictUpdate, mintStagingName, readStrictSidecar, stagingNamePattern, v1MemoryPathKeyResolver, lineageContributionsOfSession, markSessionPolluted, readProjectionDebts, readSessionPollution, ControlPlaneCorruptError } from "./layout.js";
|
|
5
5
|
import { thrownText } from "../thrown-value.js";
|
|
6
|
-
|
|
6
|
+
import { fileControlObjectDirOf } from "./control-objects.js";
|
|
7
7
|
function reqStr(v) {
|
|
8
8
|
return typeof v === "string" && v.length > 0;
|
|
9
9
|
}
|
|
@@ -48,33 +48,33 @@ function coerceSettlement(raw) {
|
|
|
48
48
|
export function syncSettleId(sessionId, toolCallId) {
|
|
49
49
|
return `sync:${encodeURIComponent(sessionId)}:${encodeURIComponent(toolCallId)}`;
|
|
50
50
|
}
|
|
51
|
-
export function registerDelegationLaunch(
|
|
52
|
-
|
|
51
|
+
export async function registerDelegationLaunch(docs, input) {
|
|
52
|
+
await docs.updateDoc("settlements", coerceSettlement, (rec) => {
|
|
53
53
|
if (rec.rows.some((r) => r.settleId === input.settleId))
|
|
54
54
|
return { result: undefined };
|
|
55
55
|
rec.rows.push({ settleId: input.settleId, sessionId: input.sessionId, launchedAt: input.now(), lane: "background", status: "pending", ...(input.toolUseId !== undefined ? { toolUseId: input.toolUseId } : {}) });
|
|
56
56
|
return { next: rec, result: undefined };
|
|
57
57
|
});
|
|
58
58
|
}
|
|
59
|
-
export function recordSyncUnattestable(
|
|
59
|
+
export async function recordSyncUnattestable(docs, input) {
|
|
60
60
|
const settleId = syncSettleId(input.sessionId, input.toolCallId);
|
|
61
|
-
|
|
61
|
+
await docs.updateDoc("settlements", coerceSettlement, (rec) => {
|
|
62
62
|
if (rec.rows.some((r) => r.settleId === settleId))
|
|
63
63
|
return { result: undefined };
|
|
64
64
|
rec.rows.push({ settleId, sessionId: input.sessionId, launchedAt: input.now(), lane: "sync", status: "unattestable" });
|
|
65
65
|
return { next: rec, result: undefined };
|
|
66
66
|
});
|
|
67
67
|
}
|
|
68
|
-
export function settleDelegation(
|
|
68
|
+
export async function settleDelegation(docs, input) {
|
|
69
69
|
const eventId = input.eventId ?? `settle:${input.settleId}:${input.status}`;
|
|
70
|
-
|
|
70
|
+
await docs.updateDoc("settlements", coerceSettlement, (rec) => {
|
|
71
71
|
if (rec.events.some((e) => e.eventId === eventId))
|
|
72
72
|
return { result: undefined };
|
|
73
73
|
rec.events.push({ settleId: input.settleId, eventId, at: input.now(), kind: "settle", status: input.status, ...(input.note !== undefined ? { note: input.note } : {}) });
|
|
74
74
|
return { next: rec, result: undefined };
|
|
75
75
|
});
|
|
76
76
|
}
|
|
77
|
-
export function resolveSettlementRecord(
|
|
77
|
+
export async function resolveSettlementRecord(docs, input) {
|
|
78
78
|
if (typeof input.requestId !== "string" || input.requestId.length === 0) {
|
|
79
79
|
const e = new Error("resolveSettlement requires a non-empty requestId (the audit attribution of who resolved) — refused, never defaulted.");
|
|
80
80
|
e.code = "memory.settlement_resolve_unattributed";
|
|
@@ -86,7 +86,7 @@ export function resolveSettlementRecord(controlDir, input) {
|
|
|
86
86
|
throw e;
|
|
87
87
|
}
|
|
88
88
|
const eventId = `admin:${input.requestId}:${input.settleId}:${input.to}`;
|
|
89
|
-
|
|
89
|
+
await docs.updateDoc("settlements", coerceSettlement, (rec) => {
|
|
90
90
|
if (!rec.rows.some((r) => r.settleId === input.settleId)) {
|
|
91
91
|
const e = new Error(`resolveSettlement: unknown settleId ${JSON.stringify(input.settleId)}`);
|
|
92
92
|
e.code = "memory.settlement_resolve_unknown";
|
|
@@ -143,8 +143,8 @@ function foldOne(row, events) {
|
|
|
143
143
|
}
|
|
144
144
|
return { row, effective, everExternal, ...(terminalEventId !== undefined ? { terminalEventId } : {}) };
|
|
145
145
|
}
|
|
146
|
-
export function effectiveSettlements(
|
|
147
|
-
const rec = coerceSettlement(
|
|
146
|
+
export async function effectiveSettlements(docs) {
|
|
147
|
+
const rec = coerceSettlement(await docs.readDoc("settlements"));
|
|
148
148
|
const bySettle = new Map();
|
|
149
149
|
for (const e of rec.events) {
|
|
150
150
|
const arr = bySettle.get(e.settleId);
|
|
@@ -155,8 +155,8 @@ export function effectiveSettlements(controlDir) {
|
|
|
155
155
|
}
|
|
156
156
|
return rec.rows.map((row) => foldOne(row, bySettle.get(row.settleId) ?? []));
|
|
157
157
|
}
|
|
158
|
-
export function sessionSettlements(
|
|
159
|
-
return effectiveSettlements(
|
|
158
|
+
export async function sessionSettlements(docs, sessionId) {
|
|
159
|
+
return (await effectiveSettlements(docs)).filter((s) => s.row.sessionId === sessionId);
|
|
160
160
|
}
|
|
161
161
|
export function classifySessionSettlements(rows) {
|
|
162
162
|
let sawPending = false;
|
|
@@ -184,18 +184,18 @@ export function classifySessionSettlements(rows) {
|
|
|
184
184
|
return { state: "pending" };
|
|
185
185
|
return { state: "clean" };
|
|
186
186
|
}
|
|
187
|
-
export function expireOverdueSettlements(
|
|
188
|
-
const overdue = effectiveSettlements(
|
|
187
|
+
export async function expireOverdueSettlements(docs, input) {
|
|
188
|
+
const overdue = (await effectiveSettlements(docs)).filter((s) => s.effective === "pending" && input.now() - s.row.launchedAt > input.timeoutMs);
|
|
189
189
|
for (const s of overdue)
|
|
190
|
-
settleDelegation(
|
|
190
|
+
await settleDelegation(docs, { settleId: s.row.settleId, status: "expired", now: input.now });
|
|
191
191
|
return overdue.map((s) => s.row.settleId);
|
|
192
192
|
}
|
|
193
|
-
export function replayExternalSettlementEffects(controlDir, input) {
|
|
193
|
+
export async function replayExternalSettlementEffects(docs, controlDir, input) {
|
|
194
194
|
const applied = [];
|
|
195
|
-
const folded = effectiveSettlements(
|
|
195
|
+
const folded = (await effectiveSettlements(docs)).filter((s) => s.effective === "external" && s.terminalEventId !== undefined);
|
|
196
196
|
if (folded.length === 0)
|
|
197
197
|
return applied;
|
|
198
|
-
const rec = coerceSettlement(
|
|
198
|
+
const rec = coerceSettlement(await docs.readDoc("settlements"));
|
|
199
199
|
for (const s of folded) {
|
|
200
200
|
if (rec.effects[s.row.settleId] === s.terminalEventId)
|
|
201
201
|
continue;
|
|
@@ -204,9 +204,9 @@ export function replayExternalSettlementEffects(controlDir, input) {
|
|
|
204
204
|
if (outcome === "unpersisted")
|
|
205
205
|
continue;
|
|
206
206
|
try {
|
|
207
|
-
const swept = lineageContributionsOfSession(
|
|
207
|
+
const swept = await lineageContributionsOfSession(docs, sessionId);
|
|
208
208
|
const contributions = input.carry ? swept.filter((c) => c.marked !== true) : swept;
|
|
209
|
-
appendChallengeEvents(
|
|
209
|
+
await appendChallengeEvents(docs, contributions.map((c) => ({
|
|
210
210
|
eventId: `settlement:${s.row.settleId}:${s.terminalEventId}:${c.entryId}`,
|
|
211
211
|
entryId: c.entryId,
|
|
212
212
|
reason: "challenged: the contributing session's delegation settled external",
|
|
@@ -217,7 +217,7 @@ export function replayExternalSettlementEffects(controlDir, input) {
|
|
|
217
217
|
continue;
|
|
218
218
|
}
|
|
219
219
|
console.warn(`[sema] delegation settlement: a background delegation of session ${JSON.stringify(sessionId)} settled EXTERNAL after launch — the session is marked and its unmarked committed contributions are challenged`);
|
|
220
|
-
|
|
220
|
+
await docs.updateDoc("settlements", coerceSettlement, (r) => {
|
|
221
221
|
r.effects[s.row.settleId] = s.terminalEventId;
|
|
222
222
|
return { next: r, result: undefined };
|
|
223
223
|
});
|
|
@@ -225,7 +225,6 @@ export function replayExternalSettlementEffects(controlDir, input) {
|
|
|
225
225
|
}
|
|
226
226
|
return applied;
|
|
227
227
|
}
|
|
228
|
-
export const SESSION_ACCOUNTS_FILE = "session-accounts.json";
|
|
229
228
|
function malformedAccountRow(row) {
|
|
230
229
|
return (typeof row !== "object" ||
|
|
231
230
|
row === null ||
|
|
@@ -301,30 +300,36 @@ function convertSessionAccounts(read, controlDir) {
|
|
|
301
300
|
export function convertV1SidecarKeys(controlDir) {
|
|
302
301
|
readProjectionDebts(controlDir);
|
|
303
302
|
readHolds(controlDir);
|
|
304
|
-
|
|
303
|
+
const accounts = fileGovernanceDocOf("session-accounts");
|
|
304
|
+
if (coerceSessionAccounts(readStrictSidecar(controlDir, accounts.file, accounts.what)).version !== 2) {
|
|
305
|
+
lockedStrictUpdate(controlDir, accounts.file, accounts.what, coerceSessionAccounts, (again) => {
|
|
306
|
+
const { rec, converted } = convertSessionAccounts(again, controlDir);
|
|
307
|
+
return converted ? { next: rec, result: undefined } : { result: undefined };
|
|
308
|
+
});
|
|
309
|
+
}
|
|
305
310
|
}
|
|
306
|
-
function readSessionAccountsConverted(controlDir) {
|
|
307
|
-
const read = coerceSessionAccounts(
|
|
311
|
+
async function readSessionAccountsConverted(docs, controlDir) {
|
|
312
|
+
const read = coerceSessionAccounts(await docs.readDoc("session-accounts"));
|
|
308
313
|
if (read.version === 2)
|
|
309
314
|
return read;
|
|
310
|
-
return
|
|
315
|
+
return docs.updateDoc("session-accounts", coerceSessionAccounts, (again) => {
|
|
311
316
|
const { rec, converted } = convertSessionAccounts(again, controlDir);
|
|
312
317
|
return converted ? { next: rec, result: rec } : { result: rec };
|
|
313
318
|
});
|
|
314
319
|
}
|
|
315
|
-
export function foreignDanglingSessionAccounts(controlDir, selfSessionId) {
|
|
316
|
-
const rec = readSessionAccountsConverted(controlDir);
|
|
320
|
+
export async function foreignDanglingSessionAccounts(docs, controlDir, selfSessionId) {
|
|
321
|
+
const rec = await readSessionAccountsConverted(docs, controlDir);
|
|
317
322
|
return rec.rows.filter((r) => r.sessionId !== selfSessionId && (r.closedAt === undefined || r.unadjudicated === true));
|
|
318
323
|
}
|
|
319
|
-
export function openLayerWriters(controlDir, selfLeg) {
|
|
320
|
-
const open = readSessionAccountsConverted(controlDir).rows.filter((r) => (selfLeg === undefined || r.leg !== selfLeg) && (r.writeScope !== undefined ? r.terminatedAt === undefined : r.closedAt === undefined));
|
|
324
|
+
export async function openLayerWriters(docs, controlDir, selfLeg) {
|
|
325
|
+
const open = (await readSessionAccountsConverted(docs, controlDir)).rows.filter((r) => (selfLeg === undefined || r.leg !== selfLeg) && (r.writeScope !== undefined ? r.terminatedAt === undefined : r.closedAt === undefined));
|
|
321
326
|
return { scopes: new Set(open.flatMap((r) => (r.writeScope !== undefined ? [r.writeScope] : []))), unscoped: open.filter((r) => r.writeScope === undefined).length };
|
|
322
327
|
}
|
|
323
|
-
export function sessionAccountLeg(controlDir, sessionId) {
|
|
324
|
-
return readSessionAccountsConverted(controlDir).rows.find((r) => r.sessionId === sessionId)?.leg;
|
|
328
|
+
export async function sessionAccountLeg(docs, controlDir, sessionId) {
|
|
329
|
+
return (await readSessionAccountsConverted(docs, controlDir)).rows.find((r) => r.sessionId === sessionId)?.leg;
|
|
325
330
|
}
|
|
326
|
-
export function sessionAccountWriteHome(
|
|
327
|
-
const read = coerceSessionAccounts(
|
|
331
|
+
export async function sessionAccountWriteHome(docs, sessionId) {
|
|
332
|
+
const read = coerceSessionAccounts(await docs.readDoc("session-accounts"));
|
|
328
333
|
if (read.version !== 2)
|
|
329
334
|
return undefined;
|
|
330
335
|
const row = read.rows.find((r) => r.sessionId === sessionId);
|
|
@@ -336,8 +341,8 @@ export function emptyUnattributedSet() {
|
|
|
336
341
|
function memberKey(scope, rel) {
|
|
337
342
|
return JSON.stringify([scope, rel]);
|
|
338
343
|
}
|
|
339
|
-
export function openSessionAccount(controlDir, input) {
|
|
340
|
-
|
|
344
|
+
export async function openSessionAccount(docs, controlDir, input) {
|
|
345
|
+
await docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
|
|
341
346
|
const { rec } = convertSessionAccounts(read, controlDir);
|
|
342
347
|
const row = rec.rows.find((r) => r.sessionId === input.sessionId);
|
|
343
348
|
if (row !== undefined && input.writeScope !== undefined)
|
|
@@ -369,16 +374,16 @@ export function openSessionAccount(controlDir, input) {
|
|
|
369
374
|
return { next: rec, result: undefined };
|
|
370
375
|
});
|
|
371
376
|
}
|
|
372
|
-
export function sessionUnattributedSet(controlDir, sessionId) {
|
|
373
|
-
const row = readSessionAccountsConverted(controlDir).rows.find((r) => r.sessionId === sessionId);
|
|
377
|
+
export async function sessionUnattributedSet(docs, controlDir, sessionId) {
|
|
378
|
+
const row = (await readSessionAccountsConverted(docs, controlDir)).rows.find((r) => r.sessionId === sessionId);
|
|
374
379
|
if (row === undefined)
|
|
375
380
|
return emptyUnattributedSet();
|
|
376
381
|
const all = (row.unattributable?.length ?? 0) > 0;
|
|
377
382
|
const keys = new Set(row.unattributed.map((m) => memberKey(m.scope, m.rel)));
|
|
378
383
|
return { has: (scope, rel) => all || keys.has(memberKey(scope, rel.split("\\").join("/"))), empty: !all && keys.size === 0 };
|
|
379
384
|
}
|
|
380
|
-
export function closeSessionAccount(controlDir, input) {
|
|
381
|
-
return
|
|
385
|
+
export async function closeSessionAccount(docs, controlDir, input) {
|
|
386
|
+
return docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
|
|
382
387
|
const { rec } = convertSessionAccounts(read, controlDir);
|
|
383
388
|
const row = rec.rows.find((r) => r.sessionId === input.sessionId);
|
|
384
389
|
if (row === undefined)
|
|
@@ -392,8 +397,8 @@ export function closeSessionAccount(controlDir, input) {
|
|
|
392
397
|
return { next: rec, result: "written" };
|
|
393
398
|
});
|
|
394
399
|
}
|
|
395
|
-
export function terminateSessionAccount(controlDir, input) {
|
|
396
|
-
return
|
|
400
|
+
export async function terminateSessionAccount(docs, controlDir, input) {
|
|
401
|
+
return docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
|
|
397
402
|
const { rec } = convertSessionAccounts(read, controlDir);
|
|
398
403
|
const row = rec.rows.find((r) => r.sessionId === input.sessionId);
|
|
399
404
|
if (row === undefined)
|
|
@@ -404,13 +409,13 @@ export function terminateSessionAccount(controlDir, input) {
|
|
|
404
409
|
return { next: rec, result: "written" };
|
|
405
410
|
});
|
|
406
411
|
}
|
|
407
|
-
export function resolveSessionAccountRecord(controlDir, input) {
|
|
412
|
+
export async function resolveSessionAccountRecord(docs, controlDir, input) {
|
|
408
413
|
if (typeof input.requestId !== "string" || input.requestId.length === 0) {
|
|
409
414
|
const e = new Error("resolveSessionAccount requires a non-empty requestId (the audit attribution of who closed) — refused, never defaulted.");
|
|
410
415
|
e.code = "memory.session_account_resolve_unattributed";
|
|
411
416
|
throw e;
|
|
412
417
|
}
|
|
413
|
-
|
|
418
|
+
await docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
|
|
414
419
|
const { rec } = convertSessionAccounts(read, controlDir);
|
|
415
420
|
const row = rec.rows.find((r) => r.sessionId === input.sessionId);
|
|
416
421
|
if (row === undefined) {
|
|
@@ -424,8 +429,9 @@ export function resolveSessionAccountRecord(controlDir, input) {
|
|
|
424
429
|
return { next: rec, result: undefined };
|
|
425
430
|
});
|
|
426
431
|
}
|
|
427
|
-
export const HOLDS_FILE = "holds.
|
|
428
|
-
|
|
432
|
+
export const HOLDS_FILE = fileGovernanceDocOf("holds").file;
|
|
433
|
+
const HOLDS_WHAT = fileGovernanceDocOf("holds").what;
|
|
434
|
+
export const HOLD_DIR = fileControlObjectDirOf("hold");
|
|
429
435
|
const HOLD_STATUSES = new Set(["capturing", "held", "released", "disposed"]);
|
|
430
436
|
const HOLD_TERMINALS = new Set(["dirty", "expired", "conflict", "discarded", "capture_lost"]);
|
|
431
437
|
function coerceHolds(raw) {
|
|
@@ -479,10 +485,10 @@ function holdsOnDiskAreV1(raw) {
|
|
|
479
485
|
return typeof raw === "object" && raw !== null && raw.version === 1;
|
|
480
486
|
}
|
|
481
487
|
export function readHolds(controlDir) {
|
|
482
|
-
const raw = readStrictSidecar(controlDir, HOLDS_FILE,
|
|
488
|
+
const raw = readStrictSidecar(controlDir, HOLDS_FILE, HOLDS_WHAT);
|
|
483
489
|
if (!holdsOnDiskAreV1(raw))
|
|
484
490
|
return coerceHolds(raw).rows;
|
|
485
|
-
return lockedStrictUpdate(controlDir, HOLDS_FILE,
|
|
491
|
+
return lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (again) => ({ next: again, result: again.rows }));
|
|
486
492
|
}
|
|
487
493
|
function sha256(buf) {
|
|
488
494
|
return createHash("sha256").update(buf).digest("hex");
|
|
@@ -571,14 +577,14 @@ export function openInstructionHold(controlDir, input) {
|
|
|
571
577
|
const refuse = (rawReason, terminal) => {
|
|
572
578
|
const reason = thirdWriterStrandedAt === undefined ? rawReason : `${rawReason}; a concurrent writer's bytes are preserved at ${thirdWriterStrandedAt}`;
|
|
573
579
|
try {
|
|
574
|
-
disposeHold(controlDir, { holdId, terminal
|
|
580
|
+
disposeHold(controlDir, { holdId, terminal });
|
|
575
581
|
}
|
|
576
582
|
catch {
|
|
577
583
|
}
|
|
578
584
|
return { ok: false, holdId, reason };
|
|
579
585
|
};
|
|
580
586
|
try {
|
|
581
|
-
lockedStrictUpdate(controlDir, HOLDS_FILE,
|
|
587
|
+
lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
582
588
|
if (rec.rows.some((r) => r.holdId === holdId))
|
|
583
589
|
return { result: undefined };
|
|
584
590
|
rec.rows.push({
|
|
@@ -640,7 +646,7 @@ export function openInstructionHold(controlDir, input) {
|
|
|
640
646
|
}
|
|
641
647
|
}
|
|
642
648
|
try {
|
|
643
|
-
lockedStrictUpdate(controlDir, HOLDS_FILE,
|
|
649
|
+
lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
644
650
|
const row = rec.rows.find((r) => r.holdId === holdId);
|
|
645
651
|
if (row === undefined || row.status !== "capturing")
|
|
646
652
|
return { result: undefined };
|
|
@@ -656,17 +662,7 @@ export function openInstructionHold(controlDir, input) {
|
|
|
656
662
|
export function reconcileHolds(controlDir, input) {
|
|
657
663
|
const holdDir = join(controlDir, HOLD_DIR);
|
|
658
664
|
const discloseStranded = (holdId, scope, rel, at) => {
|
|
659
|
-
|
|
660
|
-
enqueueMemoryAnnouncement(controlDir, {
|
|
661
|
-
kind: "gate",
|
|
662
|
-
scope,
|
|
663
|
-
at: input.now(),
|
|
664
|
-
items: [`instruction hold ${holdId}: a concurrent writer's bytes for ${JSON.stringify(rel)} could not be restored onto the plane — they are preserved at ${at} for host recovery`],
|
|
665
|
-
});
|
|
666
|
-
}
|
|
667
|
-
catch {
|
|
668
|
-
console.warn(`[sema] instruction hold ${holdId}: concurrent-writer bytes preserved at ${at} could not be restored or announced`);
|
|
669
|
-
}
|
|
665
|
+
input.onStranded(scope, `instruction hold ${holdId}: a concurrent writer's bytes for ${JSON.stringify(rel)} could not be restored onto the plane — they are preserved at ${at} for host recovery`);
|
|
670
666
|
};
|
|
671
667
|
const finishRemoval = (row, plane) => {
|
|
672
668
|
const stagingName = mintStagingName(row.holdId, input.now);
|
|
@@ -733,7 +729,8 @@ export function reconcileHolds(controlDir, input) {
|
|
|
733
729
|
discloseStranded(row.holdId, row.scope, row.rel, retired.at);
|
|
734
730
|
}
|
|
735
731
|
};
|
|
736
|
-
const
|
|
732
|
+
const ledger = readHolds(controlDir);
|
|
733
|
+
const rows = ledger.filter((r) => r.status === "capturing");
|
|
737
734
|
for (const row of rows) {
|
|
738
735
|
const custody = join(holdDir, row.captureName);
|
|
739
736
|
let custodyBytes;
|
|
@@ -789,7 +786,7 @@ export function reconcileHolds(controlDir, input) {
|
|
|
789
786
|
terminalLost = true;
|
|
790
787
|
}
|
|
791
788
|
}
|
|
792
|
-
lockedStrictUpdate(controlDir, HOLDS_FILE,
|
|
789
|
+
lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
793
790
|
const r = rec.rows.find((x) => x.holdId === row.holdId);
|
|
794
791
|
if (r === undefined || r.status !== "capturing")
|
|
795
792
|
return { result: undefined };
|
|
@@ -803,36 +800,224 @@ export function reconcileHolds(controlDir, input) {
|
|
|
803
800
|
return { next: rec, result: undefined };
|
|
804
801
|
});
|
|
805
802
|
}
|
|
803
|
+
let custodyNames;
|
|
804
|
+
try {
|
|
805
|
+
custodyNames = new Set(readdirSync(holdDir));
|
|
806
|
+
}
|
|
807
|
+
catch {
|
|
808
|
+
custodyNames = new Set();
|
|
809
|
+
}
|
|
810
|
+
for (const row of ledger) {
|
|
811
|
+
const quarantineName = row.disposition?.quarantineName;
|
|
812
|
+
if (row.status !== "disposed" || quarantineName === undefined || !custodyNames.has(row.captureName))
|
|
813
|
+
continue;
|
|
814
|
+
try {
|
|
815
|
+
const moved = moveCustodyToSeat(controlDir, row, quarantineName);
|
|
816
|
+
if (moved.at === "custody") {
|
|
817
|
+
input.onStranded(row.scope, `instruction hold ${row.holdId} (disposed, ${row.disposition.terminal}): its custody bytes could not be moved to the quarantine seat ${quarantineName} (${moved.code}) — they stay at ${join(holdDir, row.captureName)} for host recovery, and the move is retried at every harvest`);
|
|
818
|
+
}
|
|
819
|
+
}
|
|
820
|
+
catch (err) {
|
|
821
|
+
input.onStranded(row.scope, `instruction hold ${row.holdId} (disposed, ${row.disposition.terminal}): ${thrownText(err)}`);
|
|
822
|
+
}
|
|
823
|
+
}
|
|
824
|
+
adoptOrphanedQuarantineBytes(controlDir, ledger);
|
|
806
825
|
}
|
|
807
|
-
|
|
808
|
-
const
|
|
809
|
-
const
|
|
810
|
-
|
|
811
|
-
|
|
826
|
+
function adoptOrphanedQuarantineBytes(controlDir, snapshot) {
|
|
827
|
+
const holdDir = join(controlDir, HOLD_DIR);
|
|
828
|
+
const qDir = join(controlDir, QUARANTINE_DIR);
|
|
829
|
+
let listing;
|
|
830
|
+
try {
|
|
831
|
+
listing = readdirSync(qDir).filter((n) => n.includes("-hold-") && safeBasename(n)).sort();
|
|
832
|
+
}
|
|
833
|
+
catch {
|
|
834
|
+
return;
|
|
835
|
+
}
|
|
836
|
+
const seats = new Set();
|
|
837
|
+
for (const r of snapshot)
|
|
838
|
+
if (r.disposition?.quarantineName !== undefined)
|
|
839
|
+
seats.add(r.disposition.quarantineName);
|
|
840
|
+
if (listing.every((n) => seats.has(n)))
|
|
841
|
+
return;
|
|
842
|
+
lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
843
|
+
const claimed = new Set();
|
|
844
|
+
for (const r of rec.rows)
|
|
845
|
+
if (r.disposition?.quarantineName !== undefined)
|
|
846
|
+
claimed.add(r.disposition.quarantineName);
|
|
847
|
+
const digests = new Map();
|
|
848
|
+
const digestOf = (name) => {
|
|
849
|
+
if (!digests.has(name)) {
|
|
850
|
+
let digest;
|
|
851
|
+
try {
|
|
852
|
+
const path = join(qDir, name);
|
|
853
|
+
digest = lstatSync(path).isFile() ? sha256(readFileSync(path)) : undefined;
|
|
854
|
+
}
|
|
855
|
+
catch {
|
|
856
|
+
digest = undefined;
|
|
857
|
+
}
|
|
858
|
+
digests.set(name, digest);
|
|
859
|
+
}
|
|
860
|
+
return digests.get(name);
|
|
861
|
+
};
|
|
862
|
+
const wants = (r) => {
|
|
863
|
+
if (existsSync(join(holdDir, r.captureName)))
|
|
864
|
+
return false;
|
|
865
|
+
if (r.status === "held")
|
|
866
|
+
return true;
|
|
867
|
+
if (r.status !== "disposed")
|
|
868
|
+
return false;
|
|
869
|
+
const seat = r.disposition?.quarantineName;
|
|
870
|
+
return seat === undefined || !existsSync(join(qDir, seat));
|
|
871
|
+
};
|
|
872
|
+
const endsWithCapture = (name, r) => name.endsWith(`-hold-${r.captureName}`);
|
|
873
|
+
const reservedForOther = (name) => rec.rows.some((r) => endsWithCapture(name, r));
|
|
874
|
+
const wanting = rec.rows.filter(wants);
|
|
875
|
+
const found = new Map();
|
|
876
|
+
for (const r of wanting) {
|
|
877
|
+
const f = listing.find((n) => !claimed.has(n) && endsWithCapture(n, r) && digestOf(n) === r.contentDigest);
|
|
878
|
+
if (f !== undefined) {
|
|
879
|
+
found.set(r, f);
|
|
880
|
+
claimed.add(f);
|
|
881
|
+
}
|
|
882
|
+
}
|
|
883
|
+
for (const r of wanting) {
|
|
884
|
+
if (found.has(r))
|
|
885
|
+
continue;
|
|
886
|
+
const f = listing.find((n) => !claimed.has(n) && !reservedForOther(n) && digestOf(n) === r.contentDigest);
|
|
887
|
+
if (f !== undefined) {
|
|
888
|
+
found.set(r, f);
|
|
889
|
+
claimed.add(f);
|
|
890
|
+
}
|
|
891
|
+
}
|
|
892
|
+
let changed = false;
|
|
893
|
+
for (const [r, f] of found) {
|
|
894
|
+
if (r.status === "disposed") {
|
|
895
|
+
r.disposition = { ...r.disposition, quarantineName: f };
|
|
896
|
+
changed = true;
|
|
897
|
+
continue;
|
|
898
|
+
}
|
|
899
|
+
try {
|
|
900
|
+
ensureDirExists(holdDir);
|
|
901
|
+
moveNoReplace(join(qDir, f), join(holdDir, r.captureName));
|
|
902
|
+
}
|
|
903
|
+
catch {
|
|
904
|
+
}
|
|
905
|
+
}
|
|
906
|
+
return changed ? { next: rec, result: undefined } : { result: undefined };
|
|
907
|
+
});
|
|
908
|
+
}
|
|
909
|
+
export function holdQuarantineNameOf(row) {
|
|
910
|
+
return `${row.contentDigest.slice(0, 16)}-hold-${row.captureName}`;
|
|
911
|
+
}
|
|
912
|
+
function quarantineSeatState(seat, digest) {
|
|
913
|
+
let isFile;
|
|
914
|
+
try {
|
|
915
|
+
isFile = lstatSync(seat).isFile();
|
|
916
|
+
}
|
|
917
|
+
catch (err) {
|
|
918
|
+
return err.code === "ENOENT" ? "absent" : "foreign";
|
|
919
|
+
}
|
|
920
|
+
if (!isFile)
|
|
921
|
+
return "foreign";
|
|
922
|
+
try {
|
|
923
|
+
return sha256(readFileSync(seat)) === digest ? "holds" : "foreign";
|
|
924
|
+
}
|
|
925
|
+
catch {
|
|
926
|
+
return "foreign";
|
|
927
|
+
}
|
|
928
|
+
}
|
|
929
|
+
function foreignSeatRefusal(holdId, seat) {
|
|
930
|
+
return new ControlPlaneCorruptError(`memory instruction hold ${holdId}: the quarantine seat ${seat} is occupied by something that is not the hold's captured bytes — refusing to replace or adopt it (fail-closed; inspect or remove it, and the next harvest converges)`);
|
|
931
|
+
}
|
|
932
|
+
function moveCustodyToSeat(controlDir, row, seatName) {
|
|
812
933
|
const custody = join(controlDir, HOLD_DIR, row.captureName);
|
|
813
|
-
const quarantineName = `${input.now()}-hold-${row.captureName}`;
|
|
814
934
|
const qDir = join(controlDir, QUARANTINE_DIR);
|
|
815
|
-
|
|
935
|
+
const seat = join(qDir, seatName);
|
|
936
|
+
const atSeat = () => {
|
|
937
|
+
const state = quarantineSeatState(seat, row.contentDigest);
|
|
938
|
+
if (state === "foreign")
|
|
939
|
+
throw foreignSeatRefusal(row.holdId, seat);
|
|
940
|
+
if (state === "absent")
|
|
941
|
+
return undefined;
|
|
942
|
+
try {
|
|
943
|
+
if (sha256(readFileSync(custody)) === row.contentDigest)
|
|
944
|
+
unlinkSync(custody);
|
|
945
|
+
}
|
|
946
|
+
catch {
|
|
947
|
+
}
|
|
948
|
+
return { at: "seat" };
|
|
949
|
+
};
|
|
950
|
+
const there = atSeat();
|
|
951
|
+
if (there !== undefined)
|
|
952
|
+
return there;
|
|
953
|
+
if (!existsSync(custody))
|
|
954
|
+
return { at: "none" };
|
|
816
955
|
try {
|
|
817
956
|
ensureDirExists(qDir);
|
|
818
|
-
|
|
819
|
-
|
|
957
|
+
}
|
|
958
|
+
catch (err) {
|
|
959
|
+
return { at: "custody", code: err.code ?? "mkdir error" };
|
|
960
|
+
}
|
|
961
|
+
if (moveNoReplace(custody, seat) === "moved")
|
|
962
|
+
return { at: "seat" };
|
|
963
|
+
return atSeat() ?? { at: "custody", code: "move refused" };
|
|
964
|
+
}
|
|
965
|
+
function moveNoReplace(from, to) {
|
|
966
|
+
try {
|
|
967
|
+
linkSync(from, to);
|
|
968
|
+
}
|
|
969
|
+
catch (err) {
|
|
970
|
+
const code = err.code;
|
|
971
|
+
if (code === "EEXIST")
|
|
972
|
+
return "occupied";
|
|
973
|
+
if (code === "ENOENT")
|
|
974
|
+
return "refused";
|
|
975
|
+
try {
|
|
976
|
+
renameSync(from, to);
|
|
977
|
+
return "moved";
|
|
978
|
+
}
|
|
979
|
+
catch {
|
|
980
|
+
return "refused";
|
|
981
|
+
}
|
|
982
|
+
}
|
|
983
|
+
try {
|
|
984
|
+
unlinkSync(from);
|
|
820
985
|
}
|
|
821
986
|
catch {
|
|
822
|
-
moved = existsSync(join(qDir, quarantineName));
|
|
823
987
|
}
|
|
824
|
-
|
|
988
|
+
return "moved";
|
|
989
|
+
}
|
|
990
|
+
export function disposeHold(controlDir, input) {
|
|
991
|
+
const row = readHolds(controlDir).find((r) => r.holdId === input.holdId);
|
|
992
|
+
if (row === undefined || row.status === "disposed" || row.status === "released")
|
|
993
|
+
return { ok: false };
|
|
994
|
+
const quarantineName = holdQuarantineNameOf(row);
|
|
995
|
+
if (!safeBasename(quarantineName)) {
|
|
996
|
+
throw new ControlPlaneCorruptError(`memory instruction hold ${row.holdId}: its digest and capture name do not make a safe quarantine file name — refusing (fail-closed)`);
|
|
997
|
+
}
|
|
998
|
+
const seatPath = join(controlDir, QUARANTINE_DIR, quarantineName);
|
|
999
|
+
const verdict = lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
825
1000
|
const r = rec.rows.find((x) => x.holdId === input.holdId);
|
|
826
1001
|
if (r === undefined || r.status === "disposed" || r.status === "released")
|
|
827
1002
|
return { result: undefined };
|
|
1003
|
+
const custodyHere = existsSync(join(controlDir, HOLD_DIR, r.captureName));
|
|
1004
|
+
const seatState = quarantineSeatState(seatPath, r.contentDigest);
|
|
1005
|
+
const named = seatState === "holds" || (custodyHere && seatState === "absent");
|
|
828
1006
|
r.status = "disposed";
|
|
829
|
-
r.disposition = { terminal: input.terminal, ...(
|
|
830
|
-
return { next: rec, result:
|
|
1007
|
+
r.disposition = { terminal: input.terminal, ...(named ? { quarantineName } : {}) };
|
|
1008
|
+
return { next: rec, result: { named, refused: custodyHere && seatState === "foreign" } };
|
|
831
1009
|
});
|
|
832
|
-
|
|
1010
|
+
if (verdict === undefined)
|
|
1011
|
+
return { ok: false };
|
|
1012
|
+
if (verdict.refused)
|
|
1013
|
+
throw foreignSeatRefusal(row.holdId, seatPath);
|
|
1014
|
+
if (!verdict.named)
|
|
1015
|
+
return { ok: true };
|
|
1016
|
+
const moved = moveCustodyToSeat(controlDir, row, quarantineName);
|
|
1017
|
+
return { ok: true, ...(moved.at === "seat" ? { quarantineName } : {}) };
|
|
833
1018
|
}
|
|
834
1019
|
export function markHoldReleased(controlDir, input) {
|
|
835
|
-
const captureName = lockedStrictUpdate(controlDir, HOLDS_FILE,
|
|
1020
|
+
const captureName = lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
836
1021
|
const r = rec.rows.find((x) => x.holdId === input.holdId);
|
|
837
1022
|
if (r === undefined || (r.status !== "held" && !(r.status === "disposed" && r.disposition?.terminal === "expired")))
|
|
838
1023
|
return { result: undefined };
|
|
@@ -860,7 +1045,7 @@ export function resolveHoldRecord(controlDir, input) {
|
|
|
860
1045
|
e.code = "memory.hold_resolve_invalid";
|
|
861
1046
|
throw e;
|
|
862
1047
|
}
|
|
863
|
-
lockedStrictUpdate(controlDir, HOLDS_FILE,
|
|
1048
|
+
lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
864
1049
|
const r = rec.rows.find((x) => x.holdId === input.holdId);
|
|
865
1050
|
if (r === undefined) {
|
|
866
1051
|
const e = new Error(`resolveHold: unknown holdId ${JSON.stringify(input.holdId)}`);
|
|
@@ -884,7 +1069,7 @@ export function resolveHoldRecord(controlDir, input) {
|
|
|
884
1069
|
});
|
|
885
1070
|
}
|
|
886
1071
|
export function clearHoldResolution(controlDir, input) {
|
|
887
|
-
lockedStrictUpdate(controlDir, HOLDS_FILE,
|
|
1072
|
+
lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
|
|
888
1073
|
const r = rec.rows.find((x) => x.holdId === input.holdId);
|
|
889
1074
|
if (r === undefined || r.resolved === undefined || r.resolvedAt !== input.ifResolvedAt)
|
|
890
1075
|
return { result: undefined };
|
|
@@ -906,8 +1091,8 @@ export function readHoldCustody(controlDir, row) {
|
|
|
906
1091
|
}
|
|
907
1092
|
return undefined;
|
|
908
1093
|
}
|
|
909
|
-
export function sessionBlocksCleanRelease(controlDir, sessionId) {
|
|
1094
|
+
export async function sessionBlocksCleanRelease(docs, controlDir, sessionId) {
|
|
910
1095
|
if (readSessionPollution(controlDir, sessionId) !== undefined)
|
|
911
1096
|
return true;
|
|
912
|
-
return sessionSettlements(
|
|
1097
|
+
return (await sessionSettlements(docs, sessionId)).some((s) => s.effective !== "clean" && s.effective !== "void");
|
|
913
1098
|
}
|
|
@@ -10,11 +10,12 @@ export declare function derivePersonalControlDir(configRoot: string): string;
|
|
|
10
10
|
export interface ScopePlanes {
|
|
11
11
|
/** proj:/legacy scopes — the repo/path-keyed plane (order preserved). */
|
|
12
12
|
project: string[];
|
|
13
|
-
/** user:/userproj:/org: scopes — the home-mount plane (order preserved). `org` is
|
|
13
|
+
/** user:/userlocal:/userproj:/org: scopes — the home-mount plane (order preserved). `org` is
|
|
14
14
|
* CENTRAL-authority (§2 表), so it routes with the personal keys — under a pinned in-repo File
|
|
15
15
|
* backend an org layer projected into the repo would leak tenant-shared memory into commit
|
|
16
16
|
* history. The mount is still the "personal" directory (one home plane; the plane is about
|
|
17
|
-
* WHERE-NOT-to-project, not about ownership — org's authority disk is the central DB anyway
|
|
17
|
+
* WHERE-NOT-to-project, not about ownership — org's authority disk is the central DB anyway, and a
|
|
18
|
+
* `userlocal:` layer's is the store it is written in: it is never replicated). */
|
|
18
19
|
personal: string[];
|
|
19
20
|
/** Which plane owns the write face (null = read-only layering everywhere). */
|
|
20
21
|
writePlane: "project" | "personal" | null;
|
|
@@ -67,7 +68,8 @@ export interface MemoryScopeStoreInput {
|
|
|
67
68
|
* non-empty string, and under v2 a typed key the scope contract cannot read.
|
|
68
69
|
* On a directory-pinned deployment a personal-plane answer is a File store opened over the
|
|
69
70
|
* personal mount (opening creates the mount's directories and finishes an interrupted transaction,
|
|
70
|
-
* as a session's opening does); resolve once per scope and keep it.
|
|
71
|
+
* as a session's opening does); resolve once per scope and keep it. Opening is not a write: a store
|
|
72
|
+
* only opened or read is not in a deployment's store set (`memory.deployment.store_set`).
|
|
71
73
|
*/
|
|
72
74
|
export declare function resolveMemoryScopeStore(input: MemoryScopeStoreInput): MemoryScopeStore;
|
|
73
75
|
/** The two deployment facts a store resolution reads besides the backend, judged as {@link resolveMemoryScopeStore}
|
|
@@ -76,9 +78,13 @@ export declare function judgeMemoryStoreSeat(face: string, input: {
|
|
|
76
78
|
scopeContract: "v2" | undefined;
|
|
77
79
|
memoryEngineDir: string | undefined;
|
|
78
80
|
}): void;
|
|
79
|
-
/** The plane carrying `scope
|
|
80
|
-
*
|
|
81
|
-
*
|
|
81
|
+
/** The plane carrying `scope`: the one reading of which plane a scope key belongs to, shared by the store resolution and the
|
|
82
|
+
* deployment face and exported for a host that needs the answer without a store — the Runner's own normalization
|
|
83
|
+
* (surrounding whitespace trimmed; under v2 the scope contract's parse), then {@link scopePlanesOf}. No store is opened and
|
|
84
|
+
* no disk is read. `face` is the caller's own name, written into every refusal (`<face>: …`); `scopeContract` is the
|
|
85
|
+
* session's `TaskSpec.memory.scopeContract`, `undefined` written out for the opt-in absent (anything but `"v2"` and
|
|
86
|
+
* `undefined` is refused). A key the contract cannot read, a blank or non-string one, and a bad contract are refused
|
|
87
|
+
* (`config.memory_scope_key`). */
|
|
82
88
|
export declare function memoryScopePlaneOf(face: string, scope: unknown, scopeContract: "v2" | undefined): "project" | "personal";
|
|
83
89
|
/** The store-resolution input refusal (`config.memory_scope_key`), named by the face that refused. */
|
|
84
90
|
export declare function refuseMemoryStoreInput(face: string, what: string, v: unknown, cause?: unknown): never;
|