@qduc/term2 0.14.0 → 0.16.0

package/dist/gateway/persistence/session-index.js

@@ -0,0 +1,348 @@
+import { DatabaseSync } from 'node:sqlite';
+import fs from 'node:fs';
+import { GatewayPersistenceError, } from './contracts.js';
+const DEFAULT_PAGE_SIZE = 20;
+const MAX_PAGE_SIZE = 50;
+function optionalString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function sessionFromRow(row) {
+    return {
+        id: String(row.id),
+        ownerUserId: String(row.owner_user_id),
+        workspaceId: String(row.workspace_id),
+        grantVersion: String(row.grant_version),
+        bindingFingerprint: String(row.binding_fingerprint),
+        status: String(row.status),
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+        lastAppendedSequence: Number(row.last_appended_sequence),
+        lastPublishedSequence: Number(row.last_published_sequence),
+        firstRetainedEventSequence: Number(row.first_retained_event_sequence),
+        projectionSequence: Number(row.projection_sequence),
+        transcriptGeneration: Number(row.transcript_generation),
+        activeTurnId: optionalString(row.active_turn_id),
+        interruptedAt: optionalString(row.interrupted_at),
+        recoveryWarning: optionalString(row.recovery_warning),
+        retentionEligibleAt: optionalString(row.retention_eligible_at),
+    };
+}
+function admissionFromRow(row) {
+    return {
+        ownerUserId: String(row.owner_user_id),
+        sessionId: String(row.session_id),
+        clientRequestId: String(row.client_request_id),
+        normalizedBodyHash: String(row.normalized_body_hash),
+        turnId: String(row.turn_id),
+        state: String(row.state),
+        result: optionalString(row.result),
+        phase: optionalString(row.phase),
+        createdAt: String(row.created_at),
+        expiresAt: String(row.expires_at),
+        transcriptChecksum: optionalString(row.transcript_checksum),
+        journalChecksum: optionalString(row.journal_checksum),
+    };
+}
+function encodeCursor(value) {
+    return Buffer.from(JSON.stringify(value), 'utf8').toString('base64url');
+}
+function decodeCursor(cursor, ownerUserId) {
+    try {
+        const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
+        if (parsed.ownerUserId !== ownerUserId || typeof parsed.updatedAt !== 'string' || typeof parsed.id !== 'string') {
+            throw new Error();
+        }
+        return { updatedAt: parsed.updatedAt, id: parsed.id };
+    }
+    catch {
+        throw new GatewayPersistenceError('cursor_invalid', 'session list cursor is invalid for this owner');
+    }
+}
+export class GatewaySessionIndex {
+    #db;
+    #closed = false;
+    #readonly = false;
+    #closedRetentionMs;
+    constructor(layout, options = {}) {
+        try {
+            this.#closedRetentionMs = options.closedRetentionMs ?? 30 * 24 * 60 * 60 * 1000;
+            this.#db = new DatabaseSync(layout.indexPath);
+            this.#db.exec('PRAGMA foreign_keys = ON; PRAGMA journal_mode = WAL; PRAGMA synchronous = FULL;');
+            this.#db.exec(`
+        CREATE TABLE IF NOT EXISTS gateway_sessions (
+          id TEXT PRIMARY KEY,
+          owner_user_id TEXT NOT NULL,
+          workspace_id TEXT NOT NULL,
+          grant_version TEXT NOT NULL,
+          binding_fingerprint TEXT NOT NULL,
+          status TEXT NOT NULL,
+          created_at TEXT NOT NULL,
+          updated_at TEXT NOT NULL,
+          last_appended_sequence INTEGER NOT NULL DEFAULT 0,
+          last_published_sequence INTEGER NOT NULL DEFAULT 0,
+          first_retained_event_sequence INTEGER NOT NULL DEFAULT 1,
+          projection_sequence INTEGER NOT NULL DEFAULT 0,
+          transcript_generation INTEGER NOT NULL DEFAULT 1,
+          active_turn_id TEXT,
+          interrupted_at TEXT,
+          recovery_warning TEXT,
+          retention_eligible_at TEXT,
+          tombstone INTEGER NOT NULL DEFAULT 0
+        );
+        CREATE INDEX IF NOT EXISTS gateway_sessions_owner_updated
+          ON gateway_sessions(owner_user_id, updated_at DESC, id ASC);
+        CREATE TABLE IF NOT EXISTS gateway_admissions (
+          owner_user_id TEXT NOT NULL,
+          session_id TEXT NOT NULL,
+          client_request_id TEXT NOT NULL,
+          normalized_body_hash TEXT NOT NULL,
+          turn_id TEXT NOT NULL,
+          state TEXT NOT NULL,
+          result TEXT,
+          phase TEXT,
+          created_at TEXT NOT NULL,
+          expires_at TEXT NOT NULL,
+          transcript_checksum TEXT,
+          journal_checksum TEXT,
+          PRIMARY KEY (owner_user_id, session_id, client_request_id),
+          FOREIGN KEY (session_id) REFERENCES gateway_sessions(id)
+        );
+      `);
+            for (const column of ['transcript_checksum', 'journal_checksum']) {
+                try {
+                    this.#db.exec(`ALTER TABLE gateway_admissions ADD COLUMN ${column} TEXT`);
+                }
+                catch {
+                    // Existing databases already have this migration column.
+                }
+            }
+            this.assertIntegrity();
+            fs.chmodSync(layout.indexPath, 0o600);
+        }
+        catch (error) {
+            if (error instanceof GatewayPersistenceError)
+                throw error;
+            throw new GatewayPersistenceError('integrity_failed', 'gateway index integrity check failed');
+        }
+    }
+    #transaction(operation) {
+        this.assertHealthy();
+        this.#db.exec('BEGIN IMMEDIATE');
+        try {
+            const value = operation();
+            this.#db.exec('COMMIT');
+            return value;
+        }
+        catch (error) {
+            try {
+                this.#db.exec('ROLLBACK');
+            }
+            catch {
+                // Preserve the original failure.
+            }
+            throw error;
+        }
+    }
+    get readonly() {
+        return this.#readonly;
+    }
+    assertHealthy() {
+        if (this.#closed)
+            throw new GatewayPersistenceError('readonly', 'gateway index is closed');
+        if (this.#readonly)
+            throw new GatewayPersistenceError('integrity_failed', 'gateway index is read-only');
+    }
+    assertIntegrity() {
+        const row = this.#db.prepare('PRAGMA integrity_check').get();
+        if (row.integrity_check !== 'ok') {
+            this.#readonly = true;
+            throw new GatewayPersistenceError('integrity_failed', 'gateway index integrity check failed');
+        }
+    }
+    create(record) {
+        this.assertHealthy();
+        try {
+            return this.#transaction(() => {
+                this.#db
+                    .prepare(`
+          INSERT INTO gateway_sessions
+          (id, owner_user_id, workspace_id, grant_version, binding_fingerprint, status, created_at, updated_at,
+           last_appended_sequence, last_published_sequence, first_retained_event_sequence, projection_sequence,
+           transcript_generation, active_turn_id, interrupted_at, recovery_warning, retention_eligible_at, tombstone)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0)
+        `)
+                    .run(record.id, record.ownerUserId, record.workspaceId, record.grantVersion, record.bindingFingerprint, record.status, record.createdAt, record.updatedAt, record.lastAppendedSequence ?? 0, record.lastPublishedSequence ?? 0, record.firstRetainedEventSequence ?? 1, record.projectionSequence ?? 0, record.transcriptGeneration ?? 1, record.activeTurnId ?? null, record.interruptedAt ?? null, record.recoveryWarning ?? null, record.retentionEligibleAt ?? null);
+                return this.get(record.id);
+            });
+        }
+        catch (error) {
+            if (error instanceof GatewayPersistenceError)
+                throw error;
+            throw new GatewayPersistenceError('conflict', 'session already exists or could not be created');
+        }
+    }
+    get(sessionId) {
+        if (this.#closed)
+            throw new GatewayPersistenceError('readonly', 'gateway index is closed');
+        const row = this.#db.prepare('SELECT * FROM gateway_sessions WHERE id = ? AND tombstone = 0').get(sessionId);
+        return row ? sessionFromRow(row) : null;
+    }
+    getForOwner(ownerUserId, sessionId) {
+        const record = this.get(sessionId);
+        if (!record)
+            throw new GatewayPersistenceError('not_found', 'session not found');
+        if (record.ownerUserId !== ownerUserId)
+            throw new GatewayPersistenceError('owner_mismatch', 'session not found');
+        return record;
+    }
+    list(ownerUserId, options = {}) {
+        if (this.#closed)
+            throw new GatewayPersistenceError('readonly', 'gateway index is closed');
+        const limit = Math.min(Math.max(Math.floor(options.limit ?? DEFAULT_PAGE_SIZE), 1), MAX_PAGE_SIZE);
+        const cursor = options.cursor ? decodeCursor(options.cursor, ownerUserId) : null;
+        const rows = (cursor
+            ? this.#db
+                .prepare(`SELECT * FROM gateway_sessions WHERE owner_user_id = ? AND tombstone = 0 AND status != 'initializing'
+         AND (updated_at < ? OR (updated_at = ? AND id > ?)) ORDER BY updated_at DESC, id ASC LIMIT ?`)
+                .all(ownerUserId, cursor.updatedAt, cursor.updatedAt, cursor.id, limit + 1)
+            : this.#db
+                .prepare(`SELECT * FROM gateway_sessions WHERE owner_user_id = ? AND tombstone = 0 AND status != 'initializing'
+         ORDER BY updated_at DESC, id ASC LIMIT ?`)
+                .all(ownerUserId, limit + 1));
+        const pageRows = rows.slice(0, limit);
+        const sessions = pageRows.map((row) => {
+            const record = sessionFromRow(row);
+            return {
+                id: record.id,
+                workspaceId: record.workspaceId,
+                status: record.status,
+                createdAt: record.createdAt,
+                updatedAt: record.updatedAt,
+                latestSequence: record.lastPublishedSequence,
+            };
+        });
+        const nextCursor = rows.length > limit && pageRows.length > 0
+            ? encodeCursor({
+                ownerUserId,
+                updatedAt: sessions[sessions.length - 1].updatedAt,
+                id: sessions[sessions.length - 1].id,
+            })
+            : null;
+        return { sessions, nextCursor };
+    }
+    update(sessionId, patch) {
+        this.assertHealthy();
+        const current = this.get(sessionId);
+        if (!current)
+            throw new GatewayPersistenceError('not_found', 'session not found');
+        const allowed = {
+            status: patch.status ?? current.status,
+            updatedAt: patch.updatedAt ?? current.updatedAt,
+            lastAppendedSequence: patch.lastAppendedSequence ?? current.lastAppendedSequence,
+            lastPublishedSequence: patch.lastPublishedSequence ?? current.lastPublishedSequence,
+            firstRetainedEventSequence: patch.firstRetainedEventSequence ?? current.firstRetainedEventSequence,
+            projectionSequence: patch.projectionSequence ?? current.projectionSequence,
+            transcriptGeneration: patch.transcriptGeneration ?? current.transcriptGeneration,
+            activeTurnId: patch.activeTurnId === undefined ? current.activeTurnId ?? null : patch.activeTurnId,
+            interruptedAt: patch.interruptedAt === undefined ? current.interruptedAt ?? null : patch.interruptedAt,
+            recoveryWarning: patch.recoveryWarning === undefined ? current.recoveryWarning ?? null : patch.recoveryWarning,
+            retentionEligibleAt: patch.retentionEligibleAt === undefined
+                ? patch.status === 'closed'
+                    ? new Date(Date.now() + this.#closedRetentionMs).toISOString()
+                    : current.retentionEligibleAt ?? null
+                : patch.retentionEligibleAt,
+        };
+        return this.#transaction(() => {
+            this.#db
+                .prepare(`UPDATE gateway_sessions SET status=?, updated_at=?, last_appended_sequence=?, last_published_sequence=?,
+        first_retained_event_sequence=?, projection_sequence=?, transcript_generation=?, active_turn_id=?, interrupted_at=?,
+        recovery_warning=?, retention_eligible_at=? WHERE id=? AND tombstone=0`)
+                .run(allowed.status, allowed.updatedAt, allowed.lastAppendedSequence, allowed.lastPublishedSequence, allowed.firstRetainedEventSequence, allowed.projectionSequence, allowed.transcriptGeneration, allowed.activeTurnId, allowed.interruptedAt, allowed.recoveryWarning, allowed.retentionEligibleAt, sessionId);
+            return this.get(sessionId);
+        });
+    }
+    listEvictionCandidates(now = new Date().toISOString(), limit = 100) {
+        const rows = this.#db
+            .prepare(`SELECT * FROM gateway_sessions WHERE status='closed' AND tombstone=0
+      AND retention_eligible_at IS NOT NULL AND retention_eligible_at <= ?
+      ORDER BY updated_at ASC, id ASC LIMIT ?`)
+            .all(now, Math.max(1, Math.min(limit, 1000)));
+        return rows.map(sessionFromRow);
+    }
+    removeTombstoned(sessionId) {
+        this.#transaction(() => {
+            this.#db.prepare('DELETE FROM gateway_sessions WHERE id=? AND tombstone=1').run(sessionId);
+        });
+    }
+    tombstone(sessionId) {
+        this.assertHealthy();
+        const record = this.get(sessionId);
+        if (!record)
+            throw new GatewayPersistenceError('not_found', 'session not found');
+        if (record.status !== 'closed')
+            throw new GatewayPersistenceError('conflict', 'only closed sessions may be deleted');
+        this.#transaction(() => {
+            this.#db
+                .prepare('UPDATE gateway_sessions SET tombstone=1, updated_at=? WHERE id=?')
+                .run(new Date().toISOString(), sessionId);
+        });
+    }
+    admission(ownerUserId, sessionId, clientRequestId) {
+        const row = this.#db
+            .prepare(`SELECT * FROM gateway_admissions WHERE owner_user_id=? AND session_id=? AND client_request_id=?`)
+            .get(ownerUserId, sessionId, clientRequestId);
+        return row ? admissionFromRow(row) : null;
+    }
+    insertAdmission(record) {
+        this.assertHealthy();
+        try {
+            this.#transaction(() => {
+                this.#db
+                    .prepare(`INSERT INTO gateway_admissions
+          (owner_user_id, session_id, client_request_id, normalized_body_hash, turn_id, state, result, phase, created_at, expires_at,
+           transcript_checksum, journal_checksum)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                    .run(record.ownerUserId, record.sessionId, record.clientRequestId, record.normalizedBodyHash, record.turnId, record.state, record.result ?? null, record.phase ?? null, record.createdAt, record.expiresAt, record.transcriptChecksum ?? null, record.journalChecksum ?? null);
+            });
+        }
+        catch (error) {
+            if (error instanceof GatewayPersistenceError)
+                throw error;
+            throw new GatewayPersistenceError('conflict', 'admission already exists or violates its session binding');
+        }
+    }
+    updateAdmission(ownerUserId, sessionId, clientRequestId, patch) {
+        this.assertHealthy();
+        const current = this.admission(ownerUserId, sessionId, clientRequestId);
+        if (!current)
+            throw new GatewayPersistenceError('not_found', 'admission not found');
+        return this.#transaction(() => {
+            this.#db
+                .prepare('UPDATE gateway_admissions SET state=?, result=?, phase=?, transcript_checksum=?, journal_checksum=? WHERE owner_user_id=? AND session_id=? AND client_request_id=?')
+                .run(patch.state ?? current.state, patch.result ?? current.result ?? null, patch.phase ?? current.phase ?? null, patch.transcriptChecksum ?? current.transcriptChecksum ?? null, patch.journalChecksum ?? current.journalChecksum ?? null, ownerUserId, sessionId, clientRequestId);
+            return this.admission(ownerUserId, sessionId, clientRequestId);
+        });
+    }
+    deleteAdmission(ownerUserId, sessionId, clientRequestId) {
+        this.assertHealthy();
+        this.#transaction(() => {
+            this.#db
+                .prepare('DELETE FROM gateway_admissions WHERE owner_user_id=? AND session_id=? AND client_request_id=?')
+                .run(ownerUserId, sessionId, clientRequestId);
+        });
+    }
+    listAdmissions(ownerUserId, sessionId) {
+        if (this.#closed)
+            throw new GatewayPersistenceError('readonly', 'gateway index is closed');
+        return this.#db
+            .prepare('SELECT * FROM gateway_admissions WHERE owner_user_id=? AND session_id=? ORDER BY created_at ASC')
+            .all(ownerUserId, sessionId).map(admissionFromRow);
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#db.close();
+    }
+}
+//# sourceMappingURL=session-index.js.map

package/dist/gateway/persistence/session-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-index.js","sourceRoot":"","sources":["../../../source/gateway/persistence/session-index.ts"],"names":[],"mappings":"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"}

package/dist/gateway/persistence/session-persistence.d.ts

@@ -0,0 +1,68 @@
+import type { ILoggingService } from '../../services/service-interfaces.js';
+import type { LogEvent } from '../../services/logging/conversation-log-events.js';
+import { type ConversationLogWriter } from '../../services/logging/conversation-log-writer.js';
+import { type DurableEventCandidate } from './contracts.js';
+import { type GatewayEventJournalImpl } from './event-journal.js';
+import { InteractionCheckpointStore } from './interaction-checkpoint.js';
+import type { GatewayStorageLayout } from './storage.js';
+export interface GatewayCriticalPersistence {
+    appendTranscriptCritical(term2Fact: LogEvent): Promise<{
+        checksum: string;
+        fsynced: true;
+    }>;
+    appendJournalCritical(event: DurableEventCandidate): Promise<{
+        id: number;
+        checksum: string;
+        fsynced: true;
+    }>;
+    appendCritical(term2Fact: LogEvent, event: DurableEventCandidate): Promise<{
+        id: number;
+        fsynced: true;
+    }>;
+    verifyTranscriptFact(term2Fact: LogEvent, expectedChecksum?: string): boolean;
+    verifyJournalEvent(event: DurableEventCandidate, expectedChecksum?: string): boolean;
+    flush(): Promise<void>;
+    assertHealthy(): void;
+    readonly failure: Error | null;
+}
+export declare class GatewayCriticalPersistenceImpl implements GatewayCriticalPersistence {
+    #private;
+    constructor(writer: ConversationLogWriter, journal: GatewayEventJournalImpl);
+    get failure(): Error | null;
+    assertHealthy(): void;
+    appendTranscriptCritical(term2Fact: LogEvent): Promise<{
+        checksum: string;
+        fsynced: true;
+    }>;
+    appendJournalCritical(event: DurableEventCandidate): Promise<{
+        id: number;
+        checksum: string;
+        fsynced: true;
+    }>;
+    appendCritical(term2Fact: LogEvent, event: DurableEventCandidate): Promise<{
+        id: number;
+        fsynced: true;
+    }>;
+    verifyTranscriptFact(term2Fact: LogEvent, expectedChecksum?: string): boolean;
+    verifyJournalEvent(event: DurableEventCandidate, expectedChecksum?: string): boolean;
+    flush(): Promise<void>;
+}
+export type SessionPersistenceHandle = {
+    readonly directory: string;
+    readonly writer: ConversationLogWriter;
+    readonly journal: GatewayEventJournalImpl;
+    readonly critical: GatewayCriticalPersistenceImpl;
+    readonly interactionCheckpoint: InteractionCheckpointStore;
+    close(): Promise<void>;
+};
+export type CreateSessionPersistenceOptions = {
+    layout: GatewayStorageLayout;
+    ownerUserId: string;
+    workspaceId: string;
+    sessionId: string;
+    createdAt?: string;
+    logger?: ILoggingService;
+    transcriptGeneration?: number;
+};
+export declare function createSessionPersistence(options: CreateSessionPersistenceOptions): SessionPersistenceHandle;
+//# sourceMappingURL=session-persistence.d.ts.map

package/dist/gateway/persistence/session-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-persistence.d.ts","sourceRoot":"","sources":["../../../source/gateway/persistence/session-persistence.ts"],"names":[],"mappings":"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"}

package/dist/gateway/persistence/session-persistence.js

@@ -0,0 +1,165 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { CONVERSATION_FSYNC_EVENTS, createConversationLogWriter, } from '../../services/logging/conversation-log-writer.js';
+import { decodeLogEnvelope } from '../../services/conversation/conversation-decoder.js';
+import { GatewayPersistenceError } from './contracts.js';
+import { createGatewayEventJournal } from './event-journal.js';
+import { InteractionCheckpointStore } from './interaction-checkpoint.js';
+const noopLogger = {
+    debug: () => undefined,
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+    security: () => undefined,
+    setCorrelationId: () => undefined,
+    getCorrelationId: () => 'gateway-persistence',
+    clearCorrelationId: () => undefined,
+};
+function checksum(value) {
+    return crypto.createHash('sha256').update(JSON.stringify(value), 'utf8').digest('hex');
+}
+function journalFactChecksum(event) {
+    return checksum({ sessionId: event.sessionId, type: event.type, payload: event.payload });
+}
+export class GatewayCriticalPersistenceImpl {
+    #writer;
+    #journal;
+    #failure = null;
+    constructor(writer, journal) {
+        this.#writer = writer;
+        this.#journal = journal;
+    }
+    get failure() {
+        return this.#failure;
+    }
+    assertHealthy() {
+        if (this.#failure)
+            throw new GatewayPersistenceError('journal_unhealthy', this.#failure.message);
+        this.#journal.assertHealthy();
+    }
+    #assertCriticalFact(term2Fact) {
+        if (!CONVERSATION_FSYNC_EVENTS.has(term2Fact.type)) {
+            throw new GatewayPersistenceError('conflict', `term2 fact ${term2Fact.type} is not a critical fsync boundary`);
+        }
+    }
+    async appendTranscriptCritical(term2Fact) {
+        this.assertHealthy();
+        this.#assertCriticalFact(term2Fact);
+        try {
+            this.#writer.append(term2Fact);
+            return { checksum: checksum(term2Fact), fsynced: true };
+        }
+        catch (error) {
+            this.#failure = error instanceof Error ? error : new Error(String(error));
+            throw new GatewayPersistenceError('journal_unhealthy', 'critical transcript append failed');
+        }
+    }
+    async appendJournalCritical(event) {
+        this.assertHealthy();
+        try {
+            const occurredAt = event.occurredAt ?? new Date().toISOString();
+            const normalized = { ...event, occurredAt };
+            const appended = await this.#journal.append(normalized, { durability: 'critical' });
+            if (!appended.fsynced)
+                throw new Error('critical journal append was not fsynced');
+            return { id: appended.id, checksum: journalFactChecksum(event), fsynced: true };
+        }
+        catch (error) {
+            this.#failure = error instanceof Error ? error : new Error(String(error));
+            throw new GatewayPersistenceError('journal_unhealthy', 'critical journal append failed');
+        }
+    }
+    async appendCritical(term2Fact, event) {
+        await this.appendTranscriptCritical(term2Fact);
+        const appended = await this.appendJournalCritical(event);
+        return { id: appended.id, fsynced: true };
+    }
+    verifyTranscriptFact(term2Fact, expectedChecksum) {
+        const file = path.join(this.#journal.directory, 'term2.jsonl');
+        if (!fs.existsSync(file))
+            return false;
+        try {
+            return fs
+                .readFileSync(file, 'utf8')
+                .split('\n')
+                .filter(Boolean)
+                .some((line) => {
+                const envelope = decodeLogEnvelope(JSON.parse(line));
+                return envelope && checksum(envelope.event) === (expectedChecksum ?? checksum(term2Fact));
+            });
+        }
+        catch {
+            return false;
+        }
+    }
+    verifyJournalEvent(event, expectedChecksum) {
+        const wanted = expectedChecksum ?? journalFactChecksum(event);
+        return this.#journal.events().some((candidate) => journalFactChecksum({
+            sessionId: candidate.sessionId,
+            type: candidate.type,
+            payload: candidate.payload,
+        }) === wanted);
+    }
+    async flush() {
+        this.assertHealthy();
+        try {
+            await this.#writer.flush();
+            await this.#journal.flush();
+        }
+        catch (error) {
+            this.#failure = error instanceof Error ? error : new Error(String(error));
+            throw new GatewayPersistenceError('journal_unhealthy', 'critical persistence flush failed');
+        }
+    }
+}
+export function createSessionPersistence(options) {
+    const directory = options.layout.sessionPath(options.ownerUserId, options.workspaceId, options.sessionId);
+    const writer = createConversationLogWriter({
+        sessionId: 'term2',
+        dir: directory,
+        logger: options.logger ?? noopLogger,
+        // Gateway index discovery replaces the CLI last.json mechanism.
+        saveLast: () => undefined,
+    });
+    try {
+        writer.init({ id: options.sessionId, createdAt: options.createdAt ?? new Date().toISOString() });
+        const journal = createGatewayEventJournal({
+            sessionId: options.sessionId,
+            directory,
+            transcriptGeneration: options.transcriptGeneration,
+        });
+        const critical = new GatewayCriticalPersistenceImpl(writer, journal);
+        const interactionCheckpoint = new InteractionCheckpointStore(directory);
+        return {
+            directory,
+            writer,
+            journal,
+            critical,
+            interactionCheckpoint,
+            async close() {
+                let failure;
+                try {
+                    await critical.flush();
+                }
+                catch (error) {
+                    failure = error;
+                }
+                journal.close();
+                try {
+                    await writer.close();
+                }
+                catch (error) {
+                    failure ??= error;
+                }
+                if (failure)
+                    throw failure;
+            },
+        };
+    }
+    catch (error) {
+        void writer.close().catch(() => undefined);
+        throw error;
+    }
+}
+//# sourceMappingURL=session-persistence.js.map

package/dist/gateway/persistence/session-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-persistence.js","sourceRoot":"","sources":["../../../source/gateway/persistence/session-persistence.ts"],"names":[],"mappings":"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"}

package/dist/gateway/persistence/storage.d.ts

@@ -0,0 +1,13 @@
+export declare function assertOpaqueStorageId(value: string, field?: string): void;
+/** Hashes IDs before they become path components; the original ID is never a path. */
+export declare function storageHash(value: string): string;
+export type GatewayStorageLayout = {
+    readonly root: string;
+    readonly indexPath: string;
+    readonly sessionsPath: string;
+    sessionPath(ownerUserId: string, workspaceId: string, sessionId: string): string;
+    existingSessionPath(ownerUserId: string, workspaceId: string, sessionId: string): string | null;
+};
+export declare function createGatewayStorageLayout(dataRoot: string): GatewayStorageLayout;
+export declare function fsyncDirectory(directory: string): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/gateway/persistence/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../source/gateway/persistence/storage.ts"],"names":[],"mappings":"AAOA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,IAAI,CAIvE;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACjF,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACjG,CAAC;AAmBF,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CA8CjF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOtD"}