@qduc/term2 0.14.0 → 0.15.0

package/dist/gateway/lifecycle.js

@@ -0,0 +1,38 @@
+export class GatewayLifecycle {
+    #state = 'running';
+    #workers = new Set();
+    get state() {
+        return this.#state;
+    }
+    get activeWorkerCount() {
+        return this.#workers.size;
+    }
+    assertAccepting() {
+        if (this.#state !== 'running')
+            throw new Error('gateway is not accepting sessions');
+    }
+    registerWorker(worker) {
+        this.assertAccepting();
+        this.#workers.add(worker);
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            this.#workers.delete(worker);
+        };
+    }
+    async shutdown(graceMs) {
+        if (this.#state === 'stopped')
+            return;
+        this.#state = 'draining';
+        const workers = [...this.#workers];
+        await Promise.race([
+            Promise.all(workers.map((worker) => worker.close())),
+            new Promise((resolve) => setTimeout(resolve, Math.max(0, graceMs))),
+        ]);
+        this.#state = 'stopped';
+        this.#workers.clear();
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/gateway/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../source/gateway/lifecycle.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,gBAAgB;IAC3B,MAAM,GAAuC,SAAS,CAAC;IAC9C,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEnD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IACD,eAAe;QACb,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtF,CAAC;IAED,cAAc,CAAC,MAA2B;QACxC,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QACtC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACpD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;SAC1E,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

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

@@ -0,0 +1,82 @@
+import type { LogEvent } from '../../services/logging/conversation-log-events.js';
+import { type AdmissionRecord, type AdmissionResult, type DurableEventCandidate } from './contracts.js';
+import type { GatewayCriticalPersistence } from './session-persistence.js';
+import { GatewaySessionIndex } from './session-index.js';
+export declare function normalizedBodyHash(body: unknown): string;
+export type AdmissionLookup = {
+    readonly kind: 'new';
+} | {
+    readonly kind: 'replayed';
+    readonly record: AdmissionRecord;
+} | {
+    readonly kind: 'conflict';
+    readonly record: AdmissionRecord;
+};
+export type GatewayMessageAdmissionRuntime = {
+    prepareMessage(input: unknown, ids: {
+        turnId: string;
+        clientRequestId: string;
+    }): Promise<{
+        kind: 'prepared';
+        leaseId: string;
+        turnId: string;
+    } | {
+        kind: 'rejected';
+        reason: 'busy' | 'queue_full' | 'closed';
+    }>;
+    commitMessage(leaseId: string): Promise<void>;
+    cancelPreparedMessage(leaseId: string): Promise<void>;
+};
+export type GatewayAdmissionResult = {
+    readonly kind: 'accepted';
+    readonly record: AdmissionRecord;
+    readonly replayed: false;
+} | {
+    readonly kind: 'replayed';
+    readonly record: AdmissionRecord;
+    readonly replayed: true;
+} | {
+    readonly kind: 'rejected';
+    readonly reason: 'busy' | 'queue_full' | 'closed';
+};
+export declare class GatewayAdmissionPersistence {
+    #private;
+    constructor(index: GatewaySessionIndex, options?: {
+        leaseTtlMs?: number;
+    });
+    lookup(ownerUserId: string, sessionId: string, clientRequestId: string, body: unknown): AdmissionLookup;
+    prepare(input: {
+        ownerUserId: string;
+        sessionId: string;
+        clientRequestId: string;
+        body: unknown;
+        turnId: string;
+    }): AdmissionRecord;
+    admit(input: {
+        ownerUserId: string;
+        sessionId: string;
+        clientRequestId: string;
+        body: unknown;
+        turnId: string;
+        runtime: GatewayMessageAdmissionRuntime;
+        persistence: GatewayCriticalPersistence;
+        term2Fact: LogEvent;
+        acceptedEvent: DurableEventCandidate;
+        /** Runs after accepted facts are durable and before runtime execution starts. */
+        beforeCommit?: () => Promise<void>;
+    }): Promise<GatewayAdmissionResult>;
+    accept(input: {
+        record: AdmissionRecord;
+        persistence: GatewayCriticalPersistence;
+        term2Fact: LogEvent;
+        acceptedEvent: DurableEventCandidate;
+    }): Promise<AdmissionRecord>;
+    markTerminal(ownerUserId: string, sessionId: string, clientRequestId: string, result: AdmissionResult): AdmissionRecord;
+    reconcile(ownerUserId: string, sessionId: string, clientRequestId: string, callbacks: {
+        cancelPrepared: (turnId: string) => Promise<void>;
+        verifyTranscript?: (record: AdmissionRecord) => Promise<boolean>;
+        verifyJournal?: (record: AdmissionRecord) => Promise<boolean>;
+        repairAcceptedEvent?: (record: AdmissionRecord) => Promise<void>;
+    }): Promise<AdmissionRecord | null>;
+}
+//# sourceMappingURL=admission-persistence.d.ts.map

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

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

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

@@ -0,0 +1,215 @@
+import crypto from 'node:crypto';
+import { GatewayPersistenceError, } from './contracts.js';
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([key, child]) => [key, canonicalize(child)]));
+    }
+    return value;
+}
+export function normalizedBodyHash(body) {
+    return crypto
+        .createHash('sha256')
+        .update(JSON.stringify(canonicalize(body)), 'utf8')
+        .digest('hex');
+}
+export class GatewayAdmissionPersistence {
+    #index;
+    #leaseTtlMs;
+    constructor(index, options = {}) {
+        this.#index = index;
+        this.#leaseTtlMs = options.leaseTtlMs ?? 60_000;
+    }
+    lookup(ownerUserId, sessionId, clientRequestId, body) {
+        const record = this.#index.admission(ownerUserId, sessionId, clientRequestId);
+        if (!record)
+            return { kind: 'new' };
+        if (Date.parse(record.expiresAt) <= Date.now()) {
+            this.#index.deleteAdmission(ownerUserId, sessionId, clientRequestId);
+            return { kind: 'new' };
+        }
+        if (!['accepted', 'committed', 'terminal'].includes(record.state)) {
+            this.#index.deleteAdmission(ownerUserId, sessionId, clientRequestId);
+            return { kind: 'new' };
+        }
+        return record.normalizedBodyHash === normalizedBodyHash(body)
+            ? { kind: 'replayed', record }
+            : { kind: 'conflict', record };
+    }
+    prepare(input) {
+        const existing = this.lookup(input.ownerUserId, input.sessionId, input.clientRequestId, input.body);
+        if (existing.kind === 'replayed')
+            return existing.record;
+        if (existing.kind === 'conflict')
+            throw new GatewayPersistenceError('conflict', 'idempotency key has a different body');
+        const now = new Date();
+        const record = {
+            ownerUserId: input.ownerUserId,
+            sessionId: input.sessionId,
+            clientRequestId: input.clientRequestId,
+            normalizedBodyHash: normalizedBodyHash(input.body),
+            turnId: input.turnId,
+            state: 'prepared',
+            phase: 'prepared',
+            createdAt: now.toISOString(),
+            expiresAt: new Date(now.getTime() + this.#leaseTtlMs).toISOString(),
+        };
+        try {
+            this.#index.insertAdmission(record);
+            return record;
+        }
+        catch (error) {
+            const retry = this.lookup(input.ownerUserId, input.sessionId, input.clientRequestId, input.body);
+            if (retry.kind === 'replayed')
+                return retry.record;
+            throw error;
+        }
+    }
+    async admit(input) {
+        const lookup = this.lookup(input.ownerUserId, input.sessionId, input.clientRequestId, input.body);
+        if (lookup.kind === 'conflict')
+            throw new GatewayPersistenceError('conflict', 'idempotency key has a different body');
+        if (lookup.kind === 'replayed')
+            return { kind: 'replayed', record: lookup.record, replayed: true };
+        const prepared = await input.runtime.prepareMessage(input.body, {
+            turnId: input.turnId,
+            clientRequestId: input.clientRequestId,
+        });
+        if (prepared.kind !== 'prepared')
+            return prepared;
+        let record;
+        try {
+            record = this.prepare(input);
+        }
+        catch (error) {
+            await input.runtime.cancelPreparedMessage(prepared.leaseId);
+            throw error;
+        }
+        try {
+            record = await this.accept({
+                record,
+                persistence: input.persistence,
+                term2Fact: input.term2Fact,
+                acceptedEvent: input.acceptedEvent,
+            });
+            await input.beforeCommit?.();
+            await input.runtime.commitMessage(prepared.leaseId);
+            return { kind: 'accepted', record, replayed: false };
+        }
+        catch (error) {
+            const durable = this.#index.admission(input.ownerUserId, input.sessionId, input.clientRequestId);
+            if (!durable || durable.phase === 'prepared') {
+                try {
+                    await input.runtime.cancelPreparedMessage(prepared.leaseId);
+                }
+                catch {
+                    // The runtime's own interruption/read-only state is the recovery signal.
+                }
+            }
+            if (durable && (durable.state === 'accepted' || durable.state === 'committed')) {
+                this.markTerminal(durable.ownerUserId, durable.sessionId, durable.clientRequestId, 'failed');
+            }
+            throw error;
+        }
+    }
+    async accept(input) {
+        const current = this.#index.admission(input.record.ownerUserId, input.record.sessionId, input.record.clientRequestId);
+        if (!current)
+            throw new GatewayPersistenceError('not_found', 'prepared admission not found');
+        if (current.state === 'accepted' || current.state === 'committed')
+            return current;
+        if (current.state !== 'prepared')
+            throw new GatewayPersistenceError('conflict', 'admission is no longer prepared');
+        const transcript = await input.persistence.appendTranscriptCritical(input.term2Fact);
+        this.#index.updateAdmission(current.ownerUserId, current.sessionId, current.clientRequestId, {
+            phase: 'transcript_written',
+            transcriptChecksum: transcript.checksum,
+        });
+        const journal = await input.persistence.appendJournalCritical(input.acceptedEvent);
+        this.#index.updateAdmission(current.ownerUserId, current.sessionId, current.clientRequestId, {
+            phase: 'journal_written',
+            journalChecksum: journal.checksum,
+        });
+        if (!input.persistence.verifyTranscriptFact(input.term2Fact, transcript.checksum) ||
+            !input.persistence.verifyJournalEvent(input.acceptedEvent, journal.checksum)) {
+            throw new GatewayPersistenceError('readonly', 'admission durable facts failed checksum validation');
+        }
+        return this.#index.updateAdmission(current.ownerUserId, current.sessionId, current.clientRequestId, {
+            state: 'accepted',
+            result: 'accepted',
+            phase: 'committed',
+            transcriptChecksum: transcript.checksum,
+            journalChecksum: journal.checksum,
+        });
+    }
+    markTerminal(ownerUserId, sessionId, clientRequestId, result) {
+        const current = this.#index.admission(ownerUserId, sessionId, clientRequestId);
+        if (!current)
+            throw new GatewayPersistenceError('not_found', 'admission not found');
+        if (current.state !== 'accepted' && current.state !== 'committed') {
+            return this.#index.updateAdmission(ownerUserId, sessionId, clientRequestId, {
+                state: 'rejected',
+                result: result === 'accepted' ? 'failed' : result,
+            });
+        }
+        return this.#index.updateAdmission(ownerUserId, sessionId, clientRequestId, {
+            state: 'terminal',
+            result,
+            phase: 'committed',
+        });
+    }
+    reconcile(ownerUserId, sessionId, clientRequestId, callbacks) {
+        const record = this.#index.admission(ownerUserId, sessionId, clientRequestId);
+        if (!record)
+            return Promise.resolve(null);
+        const commit = () => this.#index.updateAdmission(ownerUserId, sessionId, clientRequestId, {
+            state: 'accepted',
+            result: 'accepted',
+            phase: 'committed',
+        });
+        if (record.state === 'prepared') {
+            if (callbacks.verifyTranscript && record.transcriptChecksum) {
+                return callbacks.verifyTranscript(record).then((present) => {
+                    if (!present) {
+                        return callbacks.cancelPrepared(record.turnId).then(() => this.#index.updateAdmission(ownerUserId, sessionId, clientRequestId, {
+                            state: 'rejected',
+                            result: 'failed',
+                        }));
+                    }
+                    if (!callbacks.repairAcceptedEvent)
+                        throw new GatewayPersistenceError('readonly', 'accepted event repair is unavailable');
+                    return callbacks.repairAcceptedEvent(record).then(commit);
+                });
+            }
+            return callbacks.cancelPrepared(record.turnId).then(() => this.#index.updateAdmission(ownerUserId, sessionId, clientRequestId, {
+                state: 'rejected',
+                result: 'failed',
+            }));
+        }
+        if (record.phase === 'transcript_written') {
+            if (!callbacks.verifyTranscript || !callbacks.repairAcceptedEvent)
+                throw new GatewayPersistenceError('readonly', 'transcript admission fact cannot be verified');
+            return callbacks.verifyTranscript(record).then((valid) => {
+                if (!valid)
+                    throw new GatewayPersistenceError('readonly', 'transcript admission fact is corrupt');
+                return callbacks.repairAcceptedEvent(record).then(commit);
+            });
+        }
+        if (record.phase === 'journal_written') {
+            if (!callbacks.verifyTranscript || !callbacks.verifyJournal)
+                throw new GatewayPersistenceError('readonly', 'accepted admission facts cannot be verified');
+            return Promise.all([callbacks.verifyTranscript(record), callbacks.verifyJournal(record)]).then(([transcript, journal]) => {
+                if (!transcript || !journal)
+                    throw new GatewayPersistenceError('readonly', 'accepted admission fact checksum mismatch');
+                return commit();
+            });
+        }
+        if (record.state === 'accepted' || record.state === 'committed' || record.state === 'terminal')
+            return Promise.resolve(record);
+        return Promise.resolve(record);
+    }
+}
+//# sourceMappingURL=admission-persistence.js.map

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

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

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

@@ -0,0 +1,94 @@
+export type GatewaySessionStatus = 'initializing' | 'idle' | 'running' | 'awaiting_interaction' | 'interrupted' | 'closed';
+export type GatewaySessionRecord = {
+    readonly id: string;
+    readonly ownerUserId: string;
+    readonly workspaceId: string;
+    readonly grantVersion: string;
+    readonly bindingFingerprint: string;
+    readonly status: GatewaySessionStatus;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly lastAppendedSequence: number;
+    readonly lastPublishedSequence: number;
+    readonly firstRetainedEventSequence: number;
+    readonly projectionSequence: number;
+    readonly transcriptGeneration: number;
+    readonly activeTurnId?: string;
+    readonly interruptedAt?: string;
+    readonly recoveryWarning?: string;
+    readonly retentionEligibleAt?: string;
+};
+export type SessionListItem = Pick<GatewaySessionRecord, 'id' | 'workspaceId' | 'status' | 'createdAt' | 'updatedAt'> & {
+    readonly latestSequence: number;
+};
+export type SessionListPage = {
+    readonly sessions: readonly SessionListItem[];
+    readonly nextCursor: string | null;
+};
+export type AdmissionState = 'prepared' | 'accepted' | 'committed' | 'terminal' | 'rejected';
+export type AdmissionResult = 'accepted' | 'replayed' | 'queue_discarded' | 'failed' | 'aborted';
+export type AdmissionPhase = 'prepared' | 'transcript_written' | 'journal_written' | 'committed';
+export type AdmissionRecord = {
+    readonly ownerUserId: string;
+    readonly sessionId: string;
+    readonly clientRequestId: string;
+    readonly normalizedBodyHash: string;
+    readonly turnId: string;
+    readonly state: AdmissionState;
+    readonly result?: AdmissionResult;
+    readonly phase?: AdmissionPhase;
+    readonly createdAt: string;
+    readonly expiresAt: string;
+    readonly transcriptChecksum?: string;
+    readonly journalChecksum?: string;
+};
+export type AgentEventType = 'session_created' | 'user_message_accepted' | 'user_message_rejected' | 'assistant_started' | 'text_delta' | 'reasoning_delta' | 'tool_started' | 'command_message' | 'approval_required' | 'interaction_updated' | 'interaction_resolved' | 'interaction_recovered' | 'usage_update' | 'turn_completed' | 'turn_failed' | 'turn_aborted';
+export declare const TERMINAL_AGENT_EVENT_TYPES: ReadonlySet<AgentEventType>;
+export declare const FROZEN_AGENT_EVENT_TYPES: readonly ['session_created', 'user_message_accepted', 'user_message_rejected', 'assistant_started', 'text_delta', 'reasoning_delta', 'tool_started', 'command_message', 'approval_required', 'interaction_updated', 'interaction_resolved', 'interaction_recovered', 'usage_update', 'turn_completed', 'turn_failed', 'turn_aborted'];
+export type AgentEventEnvelope = {
+    readonly schemaVersion: 1;
+    readonly id: number;
+    readonly sessionId: string;
+    readonly type: AgentEventType;
+    readonly occurredAt: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+};
+export type DurableEventCandidate = Omit<AgentEventEnvelope, 'id' | 'occurredAt' | 'schemaVersion'> & {
+    readonly occurredAt?: string;
+};
+export type ReloadRequiredReason = 'cursor_compacted' | 'sequence_gap' | 'generation_mismatch' | 'journal_unhealthy';
+export type ReplayLiveSubscription = {
+    readonly kind: 'subscribed';
+    readonly replay: readonly AgentEventEnvelope[];
+    readonly replayHighWater: number;
+    readonly firstRetainedEventSequence: number;
+    readonly unsubscribe: () => void;
+} | {
+    readonly kind: 'reload_required';
+    readonly reason: ReloadRequiredReason;
+    readonly firstRetainedEventSequence: number;
+    readonly latestSequence: number;
+};
+export type PersistenceHighWater = {
+    readonly lastAppendedSequence: number;
+    readonly lastPublishedSequence: number;
+    readonly firstRetainedEventSequence: number;
+    readonly projectionSequence: number;
+};
+export declare class GatewayPersistenceError extends Error {
+    readonly code: 'unsafe_root' | 'integrity_failed' | 'not_found' | 'owner_mismatch' | 'conflict' | 'readonly' | 'corrupt' | 'storage_capacity' | 'cursor_invalid' | 'cursor_compacted' | 'journal_unhealthy';
+    constructor(code: GatewayPersistenceError['code'], message?: string);
+}
+export interface GatewayEventJournal {
+    append(event: DurableEventCandidate, options: {
+        durability: 'critical' | 'stream';
+    }): Promise<{
+        id: number;
+        fsynced: boolean;
+    }>;
+    flush(): Promise<void>;
+    highWater(): PersistenceHighWater;
+    subscribeFrom(after: number | null, listener: (event: AgentEventEnvelope) => void, expectedTranscriptGeneration?: number): ReplayLiveSubscription;
+    assertHealthy(): void;
+}
+//# sourceMappingURL=contracts.d.ts.map

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

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

package/dist/gateway/persistence/contracts.js

@@ -0,0 +1,32 @@
+export const TERMINAL_AGENT_EVENT_TYPES = new Set([
+    'turn_completed',
+    'turn_failed',
+    'turn_aborted',
+]);
+export const FROZEN_AGENT_EVENT_TYPES = [
+    'session_created',
+    'user_message_accepted',
+    'user_message_rejected',
+    'assistant_started',
+    'text_delta',
+    'reasoning_delta',
+    'tool_started',
+    'command_message',
+    'approval_required',
+    'interaction_updated',
+    'interaction_resolved',
+    'interaction_recovered',
+    'usage_update',
+    'turn_completed',
+    'turn_failed',
+    'turn_aborted',
+];
+export class GatewayPersistenceError extends Error {
+    code;
+    constructor(code, message = 'gateway persistence rejected the operation') {
+        super(message);
+        this.name = 'GatewayPersistenceError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/dist/gateway/persistence/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../source/gateway/persistence/contracts.ts"],"names":[],"mappings":"AA2EA,MAAM,CAAC,MAAM,0BAA0B,GAAgC,IAAI,GAAG,CAAC;IAC7E,gBAAgB;IAChB,aAAa;IACb,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,iBAAiB;IACjB,uBAAuB;IACvB,uBAAuB;IACvB,mBAAmB;IACnB,YAAY;IACZ,iBAAiB;IACjB,cAAc;IACd,iBAAiB;IACjB,mBAAmB;IACnB,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,cAAc;CACN,CAAC;AAuCX,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,CAWW;IACxB,YAAY,IAAqC,EAAE,OAAO,GAAG,4CAA4C;QACvG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+import { type GatewaySessionRecord } from './contracts.js';
+import { type SessionPersistenceHandle } from './session-persistence.js';
+import { GatewaySessionIndex } from './session-index.js';
+import type { GatewayStorageLayout } from './storage.js';
+import type { SessionBinding } from '../contracts.js';
+export type GatewayPersistedSession = {
+    readonly record: GatewaySessionRecord;
+    readonly persistence: SessionPersistenceHandle;
+};
+export declare function computeBindingFingerprint(binding: SessionBinding): string;
+/** Owns the one admission/attachment ordering used by a gateway session. */
+export declare class GatewayPersistenceCoordinator {
+    #private;
+    constructor(layout: GatewayStorageLayout, index?: GatewaySessionIndex);
+    get index(): GatewaySessionIndex;
+    get layout(): GatewayStorageLayout;
+    assertBinding(record: GatewaySessionRecord, binding: SessionBinding): void;
+    open(binding: SessionBinding, options?: {
+        createdAt?: string;
+    }): Promise<GatewayPersistedSession>;
+    reconcileStartup(binding: SessionBinding, persistence: SessionPersistenceHandle, priorStatus?: GatewaySessionRecord['status']): Promise<void>;
+    close(sessionId: string, status?: 'closed' | 'idle' | 'interrupted'): Promise<void>;
+    closeIndex(): void;
+}
+//# sourceMappingURL=coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../source/gateway/persistence/coordinator.ts"],"names":[],"mappings":"AACA,OAAO,EAAuD,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAA4B,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAezE;AAED,4EAA4E;AAC5E,qBAAa,6BAA6B;;IAIxC,YAAY,MAAM,EAAE,oBAAoB,EAAE,KAAK,sBAAkC,EAGhF;IAED,IAAI,KAAK,IAAI,mBAAmB,CAE/B;IAED,IAAI,MAAM,IAAI,oBAAoB,CAEjC;IAED,aAAa,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAIzE;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAwE1G;IAEK,gBAAgB,CACpB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,wBAAwB,EACrC,WAAW,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA+Df;IAEK,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,GAAG,MAAM,GAAG,aAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlG;IAED,UAAU,IAAI,IAAI,CAEjB;CACF"}