@qduc/term2 0.14.0 → 0.15.0

package/dist/gateway/persistence/interaction-checkpoint.js

@@ -0,0 +1,75 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { GatewayPersistenceError } from './contracts.js';
+import { fsyncDirectory } from './storage.js';
+import { sanitizePendingInteractionDto } from '../interaction-protocol.js';
+export class InteractionCheckpointStore {
+    #path;
+    #checkpoint = null;
+    constructor(directory) {
+        this.#path = path.join(directory, 'interaction-checkpoint.json');
+        if (fs.existsSync(this.#path)) {
+            try {
+                const value = JSON.parse(fs.readFileSync(this.#path, 'utf8'));
+                if (!value.turnId || !value.generation || !value.interaction)
+                    throw new Error();
+                this.#checkpoint = Object.freeze({
+                    ...value,
+                    interaction: sanitizePendingInteractionDto(value.interaction),
+                });
+            }
+            catch {
+                throw new GatewayPersistenceError('corrupt', 'interaction checkpoint is corrupt');
+            }
+        }
+    }
+    get current() {
+        return this.#checkpoint;
+    }
+    save(checkpoint) {
+        const safeCheckpoint = {
+            ...checkpoint,
+            interaction: sanitizePendingInteractionDto(checkpoint.interaction),
+        };
+        const temporary = `${this.#path}.${process.pid}.tmp`;
+        fs.writeFileSync(temporary, JSON.stringify(safeCheckpoint) + '\n', { mode: 0o600 });
+        const fd = fs.openSync(temporary, 'r');
+        try {
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fs.renameSync(temporary, this.#path);
+        fsyncDirectory(path.dirname(this.#path));
+        this.#checkpoint = Object.freeze({
+            ...safeCheckpoint,
+        });
+    }
+    clear() {
+        try {
+            fs.unlinkSync(this.#path);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+        this.#checkpoint = null;
+    }
+    async recover(journal) {
+        const checkpoint = this.#checkpoint;
+        if (!checkpoint)
+            return;
+        await journal.append({
+            sessionId: journal.sessionId,
+            type: 'interaction_recovered',
+            payload: {
+                turnId: checkpoint.turnId,
+                interaction: sanitizePendingInteractionDto(checkpoint.interaction),
+                reason: 'daemon_restart',
+            },
+        }, { durability: 'critical' });
+        this.clear();
+    }
+}
+//# sourceMappingURL=interaction-checkpoint.js.map

package/dist/gateway/persistence/interaction-checkpoint.js.map

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

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

@@ -0,0 +1,53 @@
+import { type RestoredState } from '../../services/conversation/conversation-replay.js';
+import type { ConversationService } from '../../services/conversation/conversation-service.js';
+import { type AgentEventEnvelope, type GatewaySessionRecord, type ReplayLiveSubscription } from './contracts.js';
+import { GatewayEventJournalImpl } from './event-journal.js';
+import { GatewaySessionIndex } from './session-index.js';
+import { type GatewayStorageLayout } from './storage.js';
+import type { PendingInteractionDto } from '../interaction-protocol.js';
+export type { PendingInteractionDto } from '../interaction-protocol.js';
+export type ProjectionCommandStatus = 'completed' | 'failed' | 'aborted' | 'unknown';
+export type ProjectionCommand = Readonly<{
+    callId: string;
+    toolName: string;
+    status: ProjectionCommandStatus;
+}>;
+export type InteractionProjection = null | {
+    readonly state: 'pending';
+    readonly interaction: PendingInteractionDto;
+    readonly turnId: string;
+} | {
+    readonly state: 'recovered';
+    readonly interaction: PendingInteractionDto;
+    readonly turnId: string;
+    readonly resolvable: false;
+    readonly reason: 'daemon_restart' | 'forced_shutdown' | 'persistence_recovery';
+};
+export type SessionProjectionSource = {
+    readonly session: GatewaySessionRecord;
+    readonly latestSequence: number;
+    readonly earliestReplayableSequence: number;
+    /** Cursor covered by the hydrated transcript; never below the replay floor. */
+    readonly projectionSequence: number;
+    /** Journal-sourced terminal tool state, keyed by the owning turn ID. */
+    readonly journalCommands: ReadonlyMap<string, readonly ProjectionCommand[]>;
+    readonly transcript: RestoredState | null;
+    readonly interaction: InteractionProjection;
+    readonly resolvedInteractionIds: ReadonlySet<string>;
+    subscribeFrom(after: number | null, listener: (event: AgentEventEnvelope) => void): ReplayLiveSubscription;
+};
+export declare function hydrateTranscript(directory: string, expectedSessionId?: string): RestoredState | null;
+export declare function hydrateConversationService(service: ConversationService, directory: string, expectedSessionId?: string): RestoredState | null;
+export declare function createSessionProjectionSource(options: {
+    index: GatewaySessionIndex;
+    layout: GatewayStorageLayout;
+    ownerUserId: string;
+    sessionId: string;
+    journal: GatewayEventJournalImpl;
+    liveInteraction?: () => Promise<{
+        state: 'pending';
+        interaction: PendingInteractionDto;
+        turnId: string;
+    } | null> | null;
+}): Promise<SessionProjectionSource>;
+//# sourceMappingURL=projection.d.ts.map

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

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

package/dist/gateway/persistence/projection.js

@@ -0,0 +1,226 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { decodeLogEnvelope } from '../../services/conversation/conversation-decoder.js';
+import { replayEvents } from '../../services/conversation/conversation-replay.js';
+import { GatewayPersistenceError, } from './contracts.js';
+import { fsyncDirectory } from './storage.js';
+function quarantine(pathname, bytes, suffix) {
+    const directory = path.join(path.dirname(pathname), 'corruption');
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(path.join(directory, `${path.basename(pathname)}.${Date.now()}.${suffix}`), bytes, { mode: 0o600 });
+}
+function rewriteAndSync(pathname, content) {
+    fs.writeFileSync(pathname, content, { mode: 0o600 });
+    const fd = fs.openSync(pathname, 'r');
+    try {
+        fs.fsyncSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    fsyncDirectory(path.dirname(pathname));
+}
+function decodeLines(pathname, repairFinalTail) {
+    const data = fs.readFileSync(pathname, 'utf8');
+    const lines = data.split('\n');
+    const envelopes = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index];
+        const isLastWithoutNewline = index === lines.length - 1 && line.length > 0;
+        if (!line.trim())
+            continue;
+        try {
+            const envelope = decodeLogEnvelope(JSON.parse(line));
+            if (!envelope || !Number.isSafeInteger(envelope.seq) || envelope.seq <= 0) {
+                throw new GatewayPersistenceError('corrupt', 'term2 transcript contains an invalid sequence');
+            }
+            envelopes.push(envelope);
+        }
+        catch (error) {
+            if (repairFinalTail && isLastWithoutNewline) {
+                quarantine(pathname, Buffer.from(line, 'utf8'), 'tail');
+                const valid = envelopes.map((envelope) => JSON.stringify(envelope) + '\n').join('');
+                rewriteAndSync(pathname, valid);
+                return { envelopes, warning: `${path.basename(pathname)} torn tail quarantined and repaired` };
+            }
+            throw error instanceof GatewayPersistenceError
+                ? error
+                : new GatewayPersistenceError('corrupt', `${path.basename(pathname)} contains invalid JSON`);
+        }
+    }
+    return { envelopes, warning: null };
+}
+function readTerm2Envelopes(directory, expectedSessionId) {
+    const canonicalPath = path.join(directory, 'term2.jsonl');
+    if (!fs.existsSync(canonicalPath))
+        return [];
+    const canonical = decodeLines(canonicalPath, true);
+    const all = [...canonical.envelopes];
+    const deltaPath = path.join(directory, 'term2.deltas');
+    if (fs.existsSync(deltaPath)) {
+        try {
+            all.push(...decodeLines(deltaPath, false).envelopes);
+        }
+        catch (error) {
+            if (error instanceof GatewayPersistenceError) {
+                quarantine(deltaPath, fs.readFileSync(deltaPath), 'corrupt');
+                // A corrupt sidecar only loses an unsettled turn. The canonical prefix remains replayable.
+            }
+            else {
+                throw new GatewayPersistenceError('corrupt', 'term2 delta sidecar is corrupt');
+            }
+        }
+    }
+    all.sort((a, b) => a.seq - b.seq);
+    let previous = 0;
+    for (const envelope of all) {
+        if (envelope.seq <= previous)
+            throw new GatewayPersistenceError('corrupt', 'term2 transcript sequence is duplicated');
+        previous = envelope.seq;
+        if (expectedSessionId &&
+            envelope.event.type === 'session_init' &&
+            'id' in envelope.event &&
+            envelope.event.id !== expectedSessionId) {
+            throw new GatewayPersistenceError('corrupt', 'term2 transcript belongs to another session');
+        }
+    }
+    return all;
+}
+function commandsFromJournal(events) {
+    const commandsByTurn = new Map();
+    const statusByTerminalEvent = new Map([
+        ['turn_completed', 'completed'],
+        ['turn_failed', 'failed'],
+        ['turn_aborted', 'aborted'],
+    ]);
+    for (const event of events) {
+        if (event.type === 'tool_started') {
+            const turnId = typeof event.payload.turnId === 'string' ? event.payload.turnId : null;
+            const callId = typeof event.payload.callId === 'string' ? event.payload.callId : null;
+            const toolName = typeof event.payload.toolName === 'string' ? event.payload.toolName : null;
+            if (!turnId || !callId || !toolName)
+                continue;
+            const commands = commandsByTurn.get(turnId) ?? [];
+            if (!commands.some((command) => command.callId === callId) && commands.length < 64) {
+                commands.push({ callId, toolName, status: 'unknown' });
+            }
+            commandsByTurn.set(turnId, commands);
+            continue;
+        }
+        const status = statusByTerminalEvent.get(event.type);
+        const turnId = typeof event.payload.turnId === 'string' ? event.payload.turnId : null;
+        if (!status || !turnId)
+            continue;
+        const commands = commandsByTurn.get(turnId);
+        if (!commands)
+            continue;
+        commandsByTurn.set(turnId, commands.map((command) => ({ ...command, status })));
+    }
+    return commandsByTurn;
+}
+function interactionFromJournal(journal) {
+    let projection = null;
+    const resolvedInteractionIds = new Set();
+    for (const event of journal.events()) {
+        if (event.type === 'interaction_resolved' && typeof event.payload.interactionId === 'string') {
+            resolvedInteractionIds.add(event.payload.interactionId);
+        }
+        if (event.type === 'approval_required' || event.type === 'interaction_updated') {
+            projection = {
+                state: 'recovered',
+                interaction: event.payload.interaction && typeof event.payload.interaction === 'object'
+                    ? event.payload.interaction
+                    : {},
+                turnId: String(event.payload.turnId),
+                resolvable: false,
+                reason: 'daemon_restart',
+            };
+        }
+        const recoveredInteractionId = event.type === 'interaction_recovered' &&
+            event.payload.interaction &&
+            typeof event.payload.interaction === 'object' &&
+            typeof event.payload.interaction.interactionId === 'string'
+            ? event.payload.interaction.interactionId
+            : null;
+        if (event.type === 'interaction_recovered' && !resolvedInteractionIds.has(recoveredInteractionId ?? '')) {
+            projection = {
+                state: 'recovered',
+                interaction: event.payload.interaction && typeof event.payload.interaction === 'object'
+                    ? event.payload.interaction
+                    : {},
+                turnId: String(event.payload.turnId),
+                resolvable: false,
+                reason: event.payload.reason === 'forced_shutdown' || event.payload.reason === 'persistence_recovery'
+                    ? event.payload.reason
+                    : 'daemon_restart',
+            };
+        }
+        if (event.type === 'interaction_resolved' ||
+            event.type === 'turn_completed' ||
+            event.type === 'turn_aborted' ||
+            event.type === 'turn_failed') {
+            projection = null;
+        }
+    }
+    return projection;
+}
+export function hydrateTranscript(directory, expectedSessionId) {
+    const envelopes = readTerm2Envelopes(directory, expectedSessionId);
+    if (envelopes.length === 0)
+        return null;
+    return replayEvents(envelopes);
+}
+export function hydrateConversationService(service, directory, expectedSessionId) {
+    const restored = hydrateTranscript(directory, expectedSessionId);
+    if (!restored)
+        return null;
+    service.importState({
+        history: restored.history,
+        previousResponseId: restored.previousResponseId,
+        toolLedger: restored.toolLedger,
+        updatedAt: restored.updatedAt,
+    });
+    return restored;
+}
+export async function createSessionProjectionSource(options) {
+    const session = options.index.getForOwner(options.ownerUserId, options.sessionId);
+    const highWater = options.journal.highWater();
+    const journalEvents = options.journal.events();
+    const journalCommands = commandsFromJournal(journalEvents);
+    // The transcript is hydrated from the durable log, so it covers every
+    // published journal event. Report that coverage rather than the journal's
+    // optional checkpoint, which may still be zero after restart/compaction.
+    const projectionSequence = Math.max(highWater.lastPublishedSequence, highWater.firstRetainedEventSequence, highWater.projectionSequence);
+    let interaction = interactionFromJournal(options.journal);
+    const resolvedInteractionIds = new Set();
+    for (const event of journalEvents) {
+        if (event.type === 'interaction_resolved' && typeof event.payload.interactionId === 'string') {
+            resolvedInteractionIds.add(event.payload.interactionId);
+        }
+    }
+    if (options.liveInteraction) {
+        try {
+            const live = await options.liveInteraction();
+            if (live)
+                interaction = live;
+        }
+        catch {
+            // A disposed runtime is represented by the non-resolvable recovery projection.
+        }
+    }
+    const directory = options.layout.existingSessionPath(session.ownerUserId, session.workspaceId, session.id);
+    if (!directory)
+        throw new GatewayPersistenceError('not_found', 'session persistence directory not found');
+    return {
+        session,
+        latestSequence: highWater.lastPublishedSequence,
+        earliestReplayableSequence: highWater.firstRetainedEventSequence,
+        projectionSequence,
+        journalCommands,
+        transcript: hydrateTranscript(directory, session.id),
+        interaction,
+        resolvedInteractionIds,
+        subscribeFrom: (after, listener) => options.journal.subscribeFrom(after, listener, session.transcriptGeneration),
+    };
+}
+//# sourceMappingURL=projection.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { type GatewaySessionRecord } from './contracts.js';
+import { GatewaySessionIndex } from './session-index.js';
+import { type GatewayStorageLayout } from './storage.js';
+export type RetentionPolicy = {
+    readonly closedRetentionMs: number;
+    readonly maxSessionBytes: number;
+    readonly maxGlobalBytes: number;
+};
+export declare const DEFAULT_RETENTION_POLICY: RetentionPolicy;
+export declare class GatewayRetentionManager {
+    #private;
+    constructor(index: GatewaySessionIndex, layout: GatewayStorageLayout, policy?: Partial<RetentionPolicy>);
+    sessionBytes(record: GatewaySessionRecord): number;
+    evictEligible(now?: number, limit?: number): string[];
+}
+//# sourceMappingURL=retention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../../source/gateway/persistence/retention.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAIrC,CAAC;AA+BH,qBAAa,uBAAuB;;IAKlC,YAAY,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EAO1G;IAED,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAGjD;IAED,aAAa,CAAC,GAAG,SAAa,EAAE,KAAK,SAAM,GAAG,MAAM,EAAE,CAgCrD;CACF"}

package/dist/gateway/persistence/retention.js

@@ -0,0 +1,93 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { GatewayPersistenceError } from './contracts.js';
+import { fsyncDirectory } from './storage.js';
+export const DEFAULT_RETENTION_POLICY = Object.freeze({
+    closedRetentionMs: 30 * 24 * 60 * 60 * 1000,
+    maxSessionBytes: 128 * 1024 * 1024,
+    maxGlobalBytes: 2 * 1024 * 1024 * 1024,
+});
+function directorySize(directory) {
+    let total = 0;
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const pathname = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            total += directorySize(pathname);
+        else
+            total += fs.statSync(pathname).size;
+    }
+    return total;
+}
+function acquireSessionLock(directory) {
+    const lockPath = path.join(directory, 'term2.lock');
+    try {
+        const fd = fs.openSync(lockPath, 'wx', 0o600);
+        try {
+            fs.writeSync(fd, JSON.stringify({ pid: process.pid, purpose: 'retention' }));
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        return lockPath;
+    }
+    catch (error) {
+        throw new GatewayPersistenceError('storage_capacity', error instanceof Error ? `session lock unavailable: ${error.message}` : 'session lock unavailable');
+    }
+}
+export class GatewayRetentionManager {
+    #index;
+    #layout;
+    #policy;
+    constructor(index, layout, policy = {}) {
+        this.#index = index;
+        this.#layout = layout;
+        this.#policy = Object.freeze({ ...DEFAULT_RETENTION_POLICY, ...policy });
+        if (Object.values(this.#policy).some((value) => !Number.isSafeInteger(value) || value <= 0)) {
+            throw new GatewayPersistenceError('storage_capacity', 'retention policy must be finite and positive');
+        }
+    }
+    sessionBytes(record) {
+        const directory = this.#layout.existingSessionPath(record.ownerUserId, record.workspaceId, record.id);
+        return directory ? directorySize(directory) : 0;
+    }
+    evictEligible(now = Date.now(), limit = 100) {
+        const evicted = [];
+        // retentionEligibleAt is written as close-time + the single policy window;
+        // the query receives the actual current time and does not apply it again.
+        for (const record of this.#index.listEvictionCandidates(new Date(now).toISOString(), limit)) {
+            if (record.status !== 'closed')
+                continue;
+            const directory = this.#layout.existingSessionPath(record.ownerUserId, record.workspaceId, record.id);
+            if (!directory)
+                continue;
+            this.#index.tombstone(record.id);
+            let lockPath;
+            try {
+                lockPath = acquireSessionLock(directory);
+                fs.rmSync(directory, { recursive: true, force: false });
+                // The removed entry lives below the workspace hash directory.
+                fsyncDirectory(path.dirname(directory));
+                this.#index.removeTombstoned(record.id);
+                evicted.push(record.id);
+            }
+            catch (error) {
+                throw error instanceof GatewayPersistenceError
+                    ? error
+                    : new GatewayPersistenceError('storage_capacity', 'session deletion failed');
+            }
+            finally {
+                if (lockPath) {
+                    try {
+                        fs.unlinkSync(lockPath);
+                    }
+                    catch {
+                        // The directory may have been removed with the lock inside it.
+                    }
+                }
+            }
+        }
+        return evicted;
+    }
+}
+//# sourceMappingURL=retention.js.map

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

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

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

@@ -0,0 +1,34 @@
+import { type AdmissionRecord, type GatewaySessionRecord, type SessionListPage } from './contracts.js';
+import type { GatewayStorageLayout } from './storage.js';
+export declare class GatewaySessionIndex {
+    #private;
+    constructor(layout: GatewayStorageLayout, options?: {
+        closedRetentionMs?: number;
+    });
+    get readonly(): boolean;
+    assertHealthy(): void;
+    assertIntegrity(): void;
+    create(record: Omit<GatewaySessionRecord, 'lastAppendedSequence' | 'lastPublishedSequence' | 'firstRetainedEventSequence' | 'projectionSequence' | 'transcriptGeneration'> & Partial<Pick<GatewaySessionRecord, 'lastAppendedSequence' | 'lastPublishedSequence' | 'firstRetainedEventSequence' | 'projectionSequence' | 'transcriptGeneration'>>): GatewaySessionRecord;
+    get(sessionId: string): GatewaySessionRecord | null;
+    getForOwner(ownerUserId: string, sessionId: string): GatewaySessionRecord;
+    list(ownerUserId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): SessionListPage;
+    update(sessionId: string, patch: Partial<Pick<GatewaySessionRecord, 'status' | 'updatedAt' | 'lastAppendedSequence' | 'lastPublishedSequence' | 'firstRetainedEventSequence' | 'projectionSequence' | 'transcriptGeneration'>> & {
+        activeTurnId?: string | null;
+        interruptedAt?: string | null;
+        recoveryWarning?: string | null;
+        retentionEligibleAt?: string | null;
+    }): GatewaySessionRecord;
+    listEvictionCandidates(now?: string, limit?: number): GatewaySessionRecord[];
+    removeTombstoned(sessionId: string): void;
+    tombstone(sessionId: string): void;
+    admission(ownerUserId: string, sessionId: string, clientRequestId: string): AdmissionRecord | null;
+    insertAdmission(record: AdmissionRecord): void;
+    updateAdmission(ownerUserId: string, sessionId: string, clientRequestId: string, patch: Partial<Pick<AdmissionRecord, 'state' | 'result' | 'phase' | 'transcriptChecksum' | 'journalChecksum'>>): AdmissionRecord;
+    deleteAdmission(ownerUserId: string, sessionId: string, clientRequestId: string): void;
+    listAdmissions(ownerUserId: string, sessionId: string): AdmissionRecord[];
+    close(): void;
+}
+//# sourceMappingURL=session-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-index.d.ts","sourceRoot":"","sources":["../../../source/gateway/persistence/session-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAkEzD,qBAAa,mBAAmB;;IAM9B,YAAY,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO,EA0DrF;IAmBD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,aAAa,IAAI,IAAI,CAGpB;IAED,eAAe,IAAI,IAAI,CAMtB;IAED,MAAM,CACJ,MAAM,EAAE,IAAI,CACV,oBAAoB,EAClB,sBAAsB,GACtB,uBAAuB,GACvB,4BAA4B,GAC5B,oBAAoB,GACpB,sBAAsB,CACzB,GACC,OAAO,CACL,IAAI,CACF,oBAAoB,EAClB,sBAAsB,GACtB,uBAAuB,GACvB,4BAA4B,GAC5B,oBAAoB,GACpB,sBAAsB,CACzB,CACF,GACF,oBAAoB,CAuCtB;IAED,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAMlD;IAED,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAKxE;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe,CAwC5F;IAED,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,CACZ,IAAI,CACF,oBAAoB,EAClB,QAAQ,GACR,WAAW,GACX,sBAAsB,GACtB,uBAAuB,GACvB,4BAA4B,GAC5B,oBAAoB,GACpB,sBAAsB,CACzB,CACF,GAAG;QACF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrC,GACA,oBAAoB,CA6CtB;IAED,sBAAsB,CAAC,GAAG,SAA2B,EAAE,KAAK,SAAM,GAAG,oBAAoB,EAAE,CAS1F;IAED,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIxC;IAED,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAWjC;IAED,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAKjG;IAED,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA8B7C;IAED,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,oBAAoB,GAAG,iBAAiB,CAAC,CAAC,GAC7G,eAAe,CAqBjB;IAED,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAOrF;IAED,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CAOxE;IAED,KAAK,IAAI,IAAI,CAIZ;CACF"}