@tangle-network/braid 0.1.0

package/dist/adapters/storage/memory-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-effects.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/memory-effects.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC9D,aAAa,CAAC,MAAM,EAAE,OAAO,+BAA+B,EAAE,YAAY,GAAG;QAC3E,QAAQ,CAAC,MAAM,EAAE,OAAO,+BAA+B,EAAE,YAAY,CAAA;QACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAC1B,CAmBA;IAED,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,+BAA+B,EAAE,YAAY,GAAG,SAAS,CAI7F;IAED,MAAM,CACJ,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,+BAA+B,EAAE,YAAY,GAAG,SAAS,CAMlE;IAED,YAAY,CAAC,MAAM,EAAE,OAAO,+BAA+B,EAAE,YAAY,GAAG,IAAI,CAK/E;IAED,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,OAAO,+BAA+B,EAAE,YAAY,EAAE,CAE5F;CACF"}

package/dist/adapters/storage/memory-effects.js

@@ -0,0 +1,47 @@
+import { assertEffectRecordInput } from './storage-validation.js';
+import { clone } from './memory-base.js';
+import { MemoryRetentionStorage } from './memory-retention.js';
+export class MemoryEffectsStorage extends MemoryRetentionStorage {
+    reserveEffect(record) {
+        this.assertOpen();
+        assertEffectRecordInput(record);
+        const current = this.current(record.operationId);
+        if (current !== undefined) {
+            if (current.requestDigest === record.requestDigest) {
+                return { record: current, created: false };
+            }
+            const conflict = {
+                ...record,
+                status: 'conflict',
+                detail: `Operation is already bound to request digest ${current.requestDigest}`,
+                conflictWithDigest: current.requestDigest,
+            };
+            this.appendEffect(conflict);
+            return { record: clone(conflict), created: false };
+        }
+        this.appendEffect(record);
+        return { record: clone(record), created: true };
+    }
+    current(operationId) {
+        const records = this.effectStore.get(operationId) ?? [];
+        const record = [...records].reverse().find((candidate) => candidate.status !== 'conflict');
+        return record === undefined ? undefined : clone(record);
+    }
+    latest(operationId, requestDigest) {
+        const records = this.effectStore.get(operationId) ?? [];
+        const record = [...records]
+            .reverse()
+            .find((candidate) => candidate.requestDigest === requestDigest);
+        return record === undefined ? undefined : clone(record);
+    }
+    appendEffect(record) {
+        assertEffectRecordInput(record);
+        const records = this.effectStore.get(record.operationId) ?? [];
+        records.push(clone(record));
+        this.effectStore.set(record.operationId, records);
+    }
+    history(operationId) {
+        return clone(this.effectStore.get(operationId) ?? []);
+    }
+}
+//# sourceMappingURL=memory-effects.js.map

package/dist/adapters/storage/memory-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-effects.js","sourceRoot":"","sources":["../../../src/adapters/storage/memory-effects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAExC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IAC9D,aAAa,CAAC,MAA4D;QAIxE,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,uBAAuB,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QAChD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,OAAO,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC;gBACnD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;YAC5C,CAAC;YACD,MAAM,QAAQ,GAAyD;gBACrE,GAAG,MAAM;gBACT,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,gDAAgD,OAAO,CAAC,aAAa,EAAE;gBAC/E,kBAAkB,EAAE,OAAO,CAAC,aAAa;aAC1C,CAAA;YACD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;YAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QACpD,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;QACzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACjD,CAAC;IAED,OAAO,CAAC,WAAmB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;QACvD,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;QAC1F,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,CACJ,WAAmB,EACnB,aAAqB;QAErB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;QACvD,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC;aACxB,OAAO,EAAE;aACT,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,KAAK,aAAa,CAAC,CAAA;QACjE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;IAED,YAAY,CAAC,MAA4D;QACvE,uBAAuB,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;QAC9D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,CAAC,WAAmB;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;IACvD,CAAC;CACF"}

package/dist/adapters/storage/memory-journal.d.ts

@@ -0,0 +1,18 @@
+import type { AppendResult, ConversationId, JournalEvent, ProjectionSnapshot, ReplayResult, RunId, StoredJournalEvent, WorkspaceId } from '../../ports/storage.js';
+import { MemoryStorageBase } from './memory-base.js';
+export declare class MemoryJournalStorage extends MemoryStorageBase {
+    append(events: readonly JournalEvent[]): Promise<AppendResult>;
+    replay(input: {
+        readonly runId: RunId;
+        readonly afterSequence?: number;
+    }): Promise<ReplayResult>;
+    events(input?: {
+        readonly workspaceId?: WorkspaceId;
+        readonly conversationId?: ConversationId;
+        readonly runId?: RunId;
+        readonly afterStorageId?: number;
+    }): Promise<readonly StoredJournalEvent[]>;
+    projection(): Promise<ProjectionSnapshot>;
+    projectionChecksum(): Promise<string>;
+}
+//# sourceMappingURL=memory-journal.d.ts.map

package/dist/adapters/storage/memory-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-journal.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/memory-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EAEd,YAAY,EAEZ,kBAAkB,EAClB,YAAY,EACZ,KAAK,EACL,kBAAkB,EAClB,WAAW,EACZ,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAGL,iBAAiB,EAIlB,MAAM,kBAAkB,CAAA;AAKzB,qBAAa,oBAAqB,SAAQ,iBAAiB;IACnD,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CA8GnE;IAEK,MAAM,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;QACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAChC,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxB;IAEK,MAAM,CACV,KAAK,GAAE;QACL,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;QAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;QACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;QACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAC5B,GACL,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAUxC;IAEK,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAG9C;IAEK,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG1C;CACF"}

package/dist/adapters/storage/memory-journal.js

@@ -0,0 +1,136 @@
+import { clone, MemoryStorageBase, missing, projectionOf, refreshCursor, } from './memory-base.js';
+import { assertPersistablePayload, payloadChecksum } from './sqlite-crypto.js';
+import { StorageError } from './sqlite-errors.js';
+import { assertJournalEventInput, canAppendAfterTerminal } from './storage-validation.js';
+export class MemoryJournalStorage extends MemoryStorageBase {
+    async append(events) {
+        this.assertOpen();
+        const acceptedEventIds = [];
+        const duplicateEventIds = [];
+        const missingRuns = new Set();
+        for (const event of events) {
+            assertJournalEventInput(event);
+            assertPersistablePayload(event.payload);
+            const checksum = payloadChecksum(event.payload);
+            const existing = this.eventStore.find((candidate) => candidate.runId === event.runId && candidate.eventId === event.eventId);
+            if (existing) {
+                const sameImmutableInput = existing.workspaceId === event.workspaceId &&
+                    existing.conversationId === event.conversationId &&
+                    existing.runId === event.runId &&
+                    existing.eventId === event.eventId &&
+                    (existing.providerEventId ?? null) === (event.providerEventId ?? null) &&
+                    existing.sequence === event.sequence &&
+                    existing.kind === event.kind &&
+                    (existing.cursor ?? null) === (event.cursor ?? null) &&
+                    (existing.operationId ?? null) === (event.operationId ?? null) &&
+                    existing.payloadChecksum === checksum &&
+                    existing.occurredAt === event.occurredAt &&
+                    (event.receivedAt === undefined || existing.receivedAt === event.receivedAt) &&
+                    existing.terminal === (event.terminal === true);
+                if (!sameImmutableInput) {
+                    throw new StorageError('EVENT_ID_CONFLICT', `Event ${event.eventId} changed its durable input on retry`);
+                }
+                duplicateEventIds.push(event.eventId);
+                continue;
+            }
+            const sequenceExisting = this.eventStore.find((candidate) => candidate.runId === event.runId && candidate.sequence === event.sequence);
+            if (sequenceExisting && sequenceExisting.eventId !== event.eventId) {
+                throw new StorageError('SEQUENCE_CONFLICT', `Sequence ${event.sequence} is already assigned for run ${event.runId}`);
+            }
+            const cursor = this.cursorStore.get(event.runId);
+            const lastSequence = cursor?.lastSequence ?? 0;
+            if (cursor && cursor.conversationId !== event.conversationId) {
+                throw new StorageError('RUN_CONVERSATION_CONFLICT', `Run ${event.runId} belongs to another conversation`);
+            }
+            const isMissingSequence = cursor?.missingFrom !== null &&
+                cursor?.missingFrom !== undefined &&
+                cursor?.missingTo !== null &&
+                cursor?.missingTo !== undefined &&
+                event.sequence >= cursor.missingFrom &&
+                event.sequence <= cursor.missingTo;
+            if (cursor?.terminal && !isMissingSequence && !canAppendAfterTerminal(event)) {
+                throw new StorageError('TERMINAL_RUN_MUTATION', `Run ${event.runId} is terminal`);
+            }
+            const next = cursor ?? {
+                runId: event.runId,
+                conversationId: event.conversationId,
+                lastSequence: 0,
+                lastCursor: null,
+                missingFrom: null,
+                missingTo: null,
+                terminal: false,
+            };
+            const stored = {
+                workspaceId: event.workspaceId,
+                conversationId: event.conversationId,
+                runId: event.runId,
+                eventId: event.eventId,
+                ...(event.providerEventId === undefined ? {} : { providerEventId: event.providerEventId }),
+                sequence: event.sequence,
+                kind: event.kind,
+                payload: clone(event.payload),
+                payloadState: 'available',
+                payloadChecksum: checksum,
+                occurredAt: event.occurredAt,
+                receivedAt: event.receivedAt ?? new Date().toISOString(),
+                ...(event.cursor === undefined ? {} : { cursor: event.cursor }),
+                ...(event.operationId === undefined ? {} : { operationId: event.operationId }),
+                terminal: event.terminal === true,
+                redacted: false,
+            };
+            this.eventStore.push(stored);
+            next.lastCursor =
+                event.sequence >= lastSequence ? (event.cursor ?? next.lastCursor) : next.lastCursor;
+            next.terminal ||= event.terminal === true;
+            refreshCursor(next, this.eventStore);
+            this.cursorStore.set(event.runId, next);
+            if (next.missingFrom !== null)
+                missingRuns.add(event.runId);
+            acceptedEventIds.push(event.eventId);
+        }
+        this.projectionState = projectionOf(this.eventStore, [...this.cursorStore.values()]);
+        return {
+            acceptedEventIds,
+            duplicateEventIds,
+            missingHistory: [...missingRuns]
+                .map((runId) => this.cursorStore.get(runId))
+                .filter((cursor) => cursor !== undefined)
+                .map(missing)
+                .filter((range) => range !== null),
+            projectionChecksum: this.projectionState.checksum,
+        };
+    }
+    async replay(input) {
+        this.assertOpen();
+        const afterSequence = input.afterSequence ?? 0;
+        const cursor = this.cursorStore.get(input.runId);
+        const events = this.eventStore
+            .filter((event) => event.runId === input.runId && event.sequence > afterSequence)
+            .sort((left, right) => left.sequence - right.sequence);
+        const range = cursor === undefined ? null : missing(cursor);
+        return {
+            events: clone(events),
+            complete: range === null,
+            missingHistory: range === null ? [] : [range],
+            lastSequence: cursor?.lastSequence ?? 0,
+            ...(cursor?.lastCursor === null || cursor?.lastCursor === undefined
+                ? {}
+                : { lastCursor: cursor.lastCursor }),
+        };
+    }
+    async events(input = {}) {
+        this.assertOpen();
+        return clone(this.eventStore.filter((event) => (input.workspaceId === undefined || event.workspaceId === input.workspaceId) &&
+            (input.conversationId === undefined || event.conversationId === input.conversationId) &&
+            (input.runId === undefined || event.runId === input.runId)));
+    }
+    async projection() {
+        this.assertOpen();
+        return clone(this.projectionState);
+    }
+    async projectionChecksum() {
+        this.assertOpen();
+        return this.projectionState.checksum;
+    }
+}
+//# sourceMappingURL=memory-journal.js.map

package/dist/adapters/storage/memory-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-journal.js","sourceRoot":"","sources":["../../../src/adapters/storage/memory-journal.ts"],"names":[],"mappings":"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"}

package/dist/adapters/storage/memory-maintenance.d.ts

@@ -0,0 +1,14 @@
+import type { BackupReport, MigrationReport, OperationIntent, RestoreReport } from '../../ports/storage.js';
+import { MemoryOperationStorage } from './memory-operations.js';
+export declare class MemoryMaintenanceStorage extends MemoryOperationStorage {
+    migrate(operation: OperationIntent): Promise<MigrationReport>;
+    backup(input: {
+        readonly path: string;
+        readonly operation: OperationIntent;
+    }): Promise<BackupReport>;
+    restore(input: {
+        readonly path: string;
+        readonly operation: OperationIntent;
+    }): Promise<RestoreReport>;
+}
+//# sourceMappingURL=memory-maintenance.d.ts.map

package/dist/adapters/storage/memory-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-maintenance.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/memory-maintenance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAA;AAM/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAE/D,qBAAa,wBAAyB,SAAQ,sBAAsB;IAC5D,OAAO,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAYlE;IAEK,MAAM,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;KACpC,GAAG,OAAO,CAAC,YAAY,CAAC,CAaxB;IAEK,OAAO,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;KACpC,GAAG,OAAO,CAAC,aAAa,CAAC,CAczB;CACF"}

package/dist/adapters/storage/memory-maintenance.js

@@ -0,0 +1,54 @@
+import { canonicalJson } from '../../domain/canonical.js';
+import { PROJECTION_SCHEMA_VERSION } from '../../ports/storage.js';
+import { StorageError } from './sqlite-errors.js';
+import { assertOperationRequestDigest } from './storage-validation.js';
+import { jsonValue } from './memory-base.js';
+import { MemoryOperationStorage } from './memory-operations.js';
+export class MemoryMaintenanceStorage extends MemoryOperationStorage {
+    async migrate(operation) {
+        this.assertOpen();
+        assertOperationRequestDigest(operation, {});
+        const replay = await this.reuseMutation(operation);
+        if (replay !== undefined)
+            return replay;
+        const result = {
+            fromVersion: PROJECTION_SCHEMA_VERSION,
+            toVersion: PROJECTION_SCHEMA_VERSION,
+            migrated: false,
+        };
+        await this.completeMutation(operation, 'terminal', result);
+        return result;
+    }
+    async backup(input) {
+        this.assertOpen();
+        assertOperationRequestDigest(input.operation, { path: input.path });
+        const replay = await this.reuseMutation(input.operation);
+        if (replay !== undefined)
+            return replay;
+        this.snapshotStore.set(input.path, this.snapshot());
+        const result = {
+            path: input.path,
+            bytes: Buffer.byteLength(canonicalJson(this.snapshot())),
+            encrypted: false,
+        };
+        await this.completeMutation(input.operation, 'terminal', jsonValue(result));
+        return result;
+    }
+    async restore(input) {
+        this.assertOpen();
+        assertOperationRequestDigest(input.operation, { path: input.path });
+        const replay = await this.reuseMutation(input.operation);
+        if (replay !== undefined)
+            return replay;
+        const snapshot = this.snapshotStore.get(input.path);
+        if (!snapshot) {
+            await this.completeMutation(input.operation, 'failed', { code: 'BACKUP_NOT_FOUND' });
+            throw new StorageError('BACKUP_NOT_FOUND', `Memory backup ${input.path} was not found`);
+        }
+        this.restoreSnapshot(snapshot);
+        const result = { path: input.path, restored: true, integrity: await this.integrity() };
+        await this.completeMutation(input.operation, 'terminal', jsonValue(result));
+        return result;
+    }
+}
+//# sourceMappingURL=memory-maintenance.js.map

package/dist/adapters/storage/memory-maintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-maintenance.js","sourceRoot":"","sources":["../../../src/adapters/storage/memory-maintenance.ts"],"names":[],"mappings":"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"}

package/dist/adapters/storage/memory-operations.d.ts

@@ -0,0 +1,25 @@
+import type { IntegrityReport, JsonValue, OperationId, OperationIntent, OperationRecord, OperationReservation, ProjectionSnapshot } from '../../ports/storage.js';
+import { MemoryJournalStorage } from './memory-journal.js';
+export declare class MemoryOperationStorage extends MemoryJournalStorage {
+    rebuild(operation: OperationIntent): Promise<ProjectionSnapshot>;
+    reserveOperation(intent: OperationIntent): Promise<OperationReservation>;
+    completeOperation(input: {
+        readonly operationId: OperationId;
+        readonly requestDigest: string;
+        readonly status: Exclude<import('../../ports/storage.js').EffectStatus, 'pending' | 'conflict'>;
+        readonly result?: JsonValue;
+        readonly updatedAt?: string;
+    }): Promise<OperationRecord>;
+    recordOperationConflict(input: {
+        readonly operationId: OperationId;
+        readonly requestDigest: string;
+        readonly attemptedDigest: string;
+        readonly occurredAt?: string;
+    }): Promise<void>;
+    operation(operationId: OperationId): Promise<OperationRecord | null>;
+    integrity(): Promise<IntegrityReport>;
+    reuseMutation<T>(intent: OperationIntent): Promise<T | undefined>;
+    completeMutation(intent: OperationIntent, status: 'terminal' | 'failed' | 'unknown', result: JsonValue): Promise<void>;
+    completeMutationFailure(intent: OperationIntent, error: unknown): Promise<void>;
+}
+//# sourceMappingURL=memory-operations.d.ts.map

package/dist/adapters/storage/memory-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-operations.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/memory-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,wBAAwB,CAAA;AAO/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,qBAAa,sBAAuB,SAAQ,oBAAoB;IACxD,OAAO,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC,CASrE;IAEK,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyB7E;IAEK,iBAAiB,CAAC,KAAK,EAAE;QAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;QACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;QAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,wBAAwB,EAAE,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC,CAAA;QAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAC5B,GAAG,OAAO,CAAC,eAAe,CAAC,CAuC3B;IAEK,uBAAuB,CAAC,KAAK,EAAE;QACnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;QACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;QAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;QAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChB;IAEK,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAIzE;IAEK,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAY1C;IAEK,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAgCtE;IAEK,gBAAgB,CACpB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,EACzC,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC,CAOf;IAEK,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpF;CACF"}

package/dist/adapters/storage/memory-operations.js

@@ -0,0 +1,161 @@
+import { parseOperationId } from '../../domain/ids.js';
+import { isCanonicalIsoDateTime } from '../../domain/text.js';
+import { PROJECTION_SCHEMA_VERSION } from '../../ports/storage.js';
+import { assertPersistablePayload } from './sqlite-crypto.js';
+import { StorageError } from './sqlite-errors.js';
+import { assertOperationIntentInput, assertOperationRequestDigest } from './storage-validation.js';
+import { clone, jsonValue, projectionOf } from './memory-base.js';
+import { MemoryJournalStorage } from './memory-journal.js';
+export class MemoryOperationStorage extends MemoryJournalStorage {
+    async rebuild(operation) {
+        this.assertOpen();
+        assertOperationRequestDigest(operation, {});
+        const replay = await this.reuseMutation(operation);
+        if (replay !== undefined)
+            return replay;
+        this.projectionState = projectionOf(this.eventStore, [...this.cursorStore.values()]);
+        const result = clone(this.projectionState);
+        await this.completeMutation(operation, 'terminal', jsonValue(result));
+        return result;
+    }
+    async reserveOperation(intent) {
+        this.assertOpen();
+        assertOperationIntentInput(intent);
+        assertPersistablePayload(intent.request);
+        const existing = this.operationStore.get(intent.operationId);
+        if (existing) {
+            if (existing.requestDigest !== intent.requestDigest) {
+                const conflict = {
+                    ...existing,
+                    status: 'conflict',
+                    updatedAt: new Date().toISOString(),
+                };
+                return { record: clone(conflict), created: false };
+            }
+            return { record: clone(existing), created: false };
+        }
+        const createdAt = intent.createdAt ?? new Date().toISOString();
+        const record = {
+            ...intent,
+            status: 'pending',
+            createdAt,
+            updatedAt: createdAt,
+        };
+        this.operationStore.set(intent.operationId, record);
+        return { record: clone(record), created: true };
+    }
+    async completeOperation(input) {
+        this.assertOpen();
+        parseOperationId(input.operationId);
+        if (!/^[0-9a-f]{64}$/u.test(input.requestDigest)) {
+            throw new StorageError('OPERATION_INVALID', 'Operation request digest must be a SHA-256 digest');
+        }
+        if (input.updatedAt !== undefined && !isCanonicalIsoDateTime(input.updatedAt)) {
+            throw new StorageError('OPERATION_INVALID', 'Operation updatedAt must be a canonical ISO date');
+        }
+        const current = this.operationStore.get(input.operationId);
+        if (!current)
+            throw new StorageError('OPERATION_NOT_FOUND', `Operation ${input.operationId} was not reserved`);
+        if (current.requestDigest !== input.requestDigest) {
+            const conflict = {
+                ...current,
+                status: 'conflict',
+                updatedAt: input.updatedAt ?? new Date().toISOString(),
+            };
+            return clone(conflict);
+        }
+        if (current.status !== 'pending' && current.status !== 'unknown')
+            return clone(current);
+        if (input.result !== undefined)
+            assertPersistablePayload(input.result);
+        const next = {
+            ...current,
+            status: input.status,
+            updatedAt: input.updatedAt ?? new Date().toISOString(),
+            ...(input.result === undefined ? {} : { result: clone(input.result) }),
+        };
+        this.operationStore.set(input.operationId, next);
+        return clone(next);
+    }
+    async recordOperationConflict(input) {
+        this.assertOpen();
+        parseOperationId(input.operationId);
+        if (!/^[0-9a-f]{64}$/u.test(input.requestDigest) ||
+            !/^[0-9a-f]{64}$/u.test(input.attemptedDigest)) {
+            throw new StorageError('OPERATION_INVALID', 'Operation conflict digests must be SHA-256 digests');
+        }
+        if (input.requestDigest === input.attemptedDigest) {
+            throw new StorageError('OPERATION_INVALID', 'A conflict requires a different digest');
+        }
+        if (input.occurredAt !== undefined && !isCanonicalIsoDateTime(input.occurredAt)) {
+            throw new StorageError('OPERATION_INVALID', 'Operation conflict occurredAt must be a canonical ISO date');
+        }
+        const current = this.operationStore.get(input.operationId);
+        if (!current) {
+            throw new StorageError('OPERATION_NOT_FOUND', `Operation ${input.operationId} was not reserved`);
+        }
+        if (current.requestDigest !== input.requestDigest) {
+            throw new StorageError('OPERATION_CONFLICT', `Operation ${input.operationId} is bound to another request digest`);
+        }
+    }
+    async operation(operationId) {
+        this.assertOpen();
+        const record = this.operationStore.get(operationId);
+        return record === undefined ? null : clone(record);
+    }
+    async integrity() {
+        this.assertOpen();
+        return {
+            ok: true,
+            encryption: 'not-applicable',
+            quickCheck: true,
+            fullCheck: true,
+            foreignKeys: true,
+            wal: false,
+            schemaVersion: PROJECTION_SCHEMA_VERSION,
+            errors: [],
+        };
+    }
+    async reuseMutation(intent) {
+        const reservation = await this.reserveOperation(intent);
+        if (reservation.record.status === 'conflict') {
+            throw new StorageError('OPERATION_CONFLICT', `Operation ${intent.operationId} was reused with a different request digest`);
+        }
+        if (!reservation.created && reservation.record.status === 'failed') {
+            throw new StorageError('OPERATION_FAILED_REPLAY', `Operation ${intent.operationId} already failed; use a new operation identifier to retry`);
+        }
+        if (!reservation.created && reservation.record.status === 'unknown') {
+            throw new StorageError('OPERATION_OUTCOME_UNKNOWN', `Operation ${intent.operationId} has an unknown outcome and requires reconciliation`);
+        }
+        if (!reservation.created &&
+            (reservation.record.status === 'terminal' || reservation.record.status === 'acknowledged')) {
+            if (reservation.record.result === undefined)
+                throw new StorageError('OPERATION_RESULT_MISSING', `Operation ${intent.operationId} has no stored result`);
+            return clone(reservation.record.result);
+        }
+        return undefined;
+    }
+    async completeMutation(intent, status, result) {
+        await this.completeOperation({
+            operationId: intent.operationId,
+            requestDigest: intent.requestDigest,
+            status,
+            result,
+        });
+    }
+    async completeMutationFailure(intent, error) {
+        const result = {
+            code: error instanceof StorageError ? error.code : 'STORAGE_MUTATION_FAILED',
+            message: error instanceof StorageError ? error.code : 'Storage mutation failed',
+        };
+        try {
+            await this.completeMutation(intent, 'failed', result);
+        }
+        catch {
+            await this.completeMutation(intent, 'unknown', {
+                code: 'STORAGE_MUTATION_OUTCOME_UNKNOWN',
+            }).catch(() => undefined);
+        }
+    }
+}
+//# sourceMappingURL=memory-operations.js.map

package/dist/adapters/storage/memory-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-operations.js","sourceRoot":"","sources":["../../../src/adapters/storage/memory-operations.ts"],"names":[],"mappings":"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"}

package/dist/adapters/storage/memory-retention.d.ts

@@ -0,0 +1,25 @@
+import type { ConversationId, DestructionReport, EventId, NonTerminalRun, OperationIntent, RedactionReport, RetentionReport, StorageArtifacts } from '../../ports/storage.js';
+import { MemoryMaintenanceStorage } from './memory-maintenance.js';
+export declare class MemoryRetentionStorage extends MemoryMaintenanceStorage {
+    applyRetention(input: {
+        readonly before: string;
+        readonly conversationId?: ConversationId;
+        readonly operation: OperationIntent;
+    }): Promise<RetentionReport>;
+    redact(input: {
+        readonly conversationId: ConversationId;
+        readonly eventId: EventId;
+        readonly reason: string;
+        readonly operation: OperationIntent;
+    }): Promise<RedactionReport>;
+    destroyConversation(input: {
+        readonly conversationId: ConversationId;
+        readonly reason: string;
+        readonly operation: OperationIntent;
+    }): Promise<DestructionReport>;
+    compact(operation: OperationIntent): Promise<void>;
+    artifacts(): StorageArtifacts;
+    reconcileNonTerminalRuns(): Promise<readonly NonTerminalRun[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=memory-retention.d.ts.map

package/dist/adapters/storage/memory-retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retention.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/memory-retention.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,wBAAwB,CAAA;AAM/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAElE,qBAAa,sBAAuB,SAAQ,wBAAwB;IAC5D,cAAc,CAAC,KAAK,EAAE;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;QACxC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;KACpC,GAAG,OAAO,CAAC,eAAe,CAAC,CAgC3B;IAEK,MAAM,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;QACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;KACpC,GAAG,OAAO,CAAC,eAAe,CAAC,CA2C3B;IAEK,mBAAmB,CAAC,KAAK,EAAE;QAC/B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;QACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;KACpC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqC7B;IAEK,OAAO,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvD;IAED,SAAS,IAAI,gBAAgB,CAE5B;IAEK,wBAAwB,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAWnE;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}