@qduc/term2 0.14.0 → 0.15.0

package/dist/gateway/persistence/coordinator.js

@@ -0,0 +1,181 @@
+import crypto from 'node:crypto';
+import { GatewayPersistenceError, TERMINAL_AGENT_EVENT_TYPES } from './contracts.js';
+import { createSessionPersistence } from './session-persistence.js';
+import { GatewaySessionIndex } from './session-index.js';
+export function computeBindingFingerprint(binding) {
+    const targetKind = binding.canonicalRoot.startsWith('ssh:') ? 'ssh' : 'local';
+    return crypto
+        .createHash('sha256')
+        .update(JSON.stringify({
+        salt: 'term2-gateway-binding-v1',
+        canonicalRoot: binding.canonicalRoot,
+        access: binding.access,
+        targetKind,
+        grantVersion: binding.grantVersion,
+    }), 'utf8')
+        .digest('hex');
+}
+/** Owns the one admission/attachment ordering used by a gateway session. */
+export class GatewayPersistenceCoordinator {
+    #layout;
+    #index;
+    constructor(layout, index = new GatewaySessionIndex(layout)) {
+        this.#layout = layout;
+        this.#index = index;
+    }
+    get index() {
+        return this.#index;
+    }
+    get layout() {
+        return this.#layout;
+    }
+    assertBinding(record, binding) {
+        if (record.bindingFingerprint !== computeBindingFingerprint(binding)) {
+            throw new GatewayPersistenceError('readonly', 'session binding fingerprint mismatch; operator recovery required');
+        }
+    }
+    async open(binding, options = {}) {
+        const now = options.createdAt ?? new Date().toISOString();
+        const existing = this.#index.get(binding.sessionId);
+        let created = false;
+        if (!existing) {
+            this.#index.create({
+                id: binding.sessionId,
+                ownerUserId: binding.ownerUserId,
+                workspaceId: binding.workspaceId,
+                grantVersion: String(binding.grantVersion),
+                bindingFingerprint: computeBindingFingerprint(binding),
+                status: 'initializing',
+                createdAt: now,
+                updatedAt: now,
+            });
+            created = true;
+        }
+        else {
+            this.assertBinding(existing, binding);
+            if (existing.ownerUserId !== binding.ownerUserId || existing.workspaceId !== binding.workspaceId) {
+                throw new GatewayPersistenceError('owner_mismatch', 'session not found');
+            }
+            if (existing.status === 'closed')
+                throw new GatewayPersistenceError('conflict', 'session is closed');
+        }
+        let persistence;
+        try {
+            persistence = createSessionPersistence({
+                layout: this.#layout,
+                ownerUserId: binding.ownerUserId,
+                workspaceId: binding.workspaceId,
+                sessionId: binding.sessionId,
+                createdAt: existing?.createdAt ?? now,
+                transcriptGeneration: existing?.transcriptGeneration,
+            });
+            if (created) {
+                await persistence.critical.appendCritical({ type: 'session_init', id: binding.sessionId, createdAt: now }, { sessionId: binding.sessionId, type: 'session_created', payload: {} });
+            }
+            const highWater = persistence.journal.highWater();
+            this.#index.update(binding.sessionId, {
+                status: created ? 'idle' : existing.status,
+                lastAppendedSequence: highWater.lastAppendedSequence,
+                lastPublishedSequence: highWater.lastPublishedSequence,
+                firstRetainedEventSequence: highWater.firstRetainedEventSequence,
+                projectionSequence: highWater.projectionSequence,
+                updatedAt: new Date().toISOString(),
+            });
+            await persistence.interactionCheckpoint.recover(persistence.journal);
+            await this.reconcileStartup(binding, persistence, existing?.status);
+            return { record: this.#index.get(binding.sessionId), persistence };
+        }
+        catch (error) {
+            try {
+                await persistence?.close();
+            }
+            catch {
+                // Preserve the original admission error; the directory remains evidence.
+            }
+            try {
+                this.#index.update(binding.sessionId, {
+                    status: 'interrupted',
+                    recoveryWarning: 'session persistence initialization failed',
+                    interruptedAt: new Date().toISOString(),
+                    updatedAt: new Date().toISOString(),
+                    activeTurnId: null,
+                });
+            }
+            catch {
+                // Preserve the initialization failure if the index itself is unhealthy.
+            }
+            throw error instanceof GatewayPersistenceError
+                ? error
+                : new GatewayPersistenceError('readonly', 'session persistence initialization failed');
+        }
+    }
+    async reconcileStartup(binding, persistence, priorStatus) {
+        const record = this.#index.getForOwner(binding.ownerUserId, binding.sessionId);
+        const events = persistence.journal.events();
+        const trailing = events.at(-1);
+        const hasInFlightFact = trailing &&
+            [
+                'user_message_accepted',
+                'assistant_started',
+                'tool_started',
+                'approval_required',
+                'interaction_updated',
+            ].includes(trailing.type);
+        if (['running', 'awaiting_interaction'].includes(priorStatus ?? record.status) || hasInFlightFact) {
+            this.#index.update(binding.sessionId, {
+                status: 'interrupted',
+                activeTurnId: null,
+                interruptedAt: new Date().toISOString(),
+                recoveryWarning: 'session interrupted during startup reconciliation',
+                updatedAt: new Date().toISOString(),
+            });
+        }
+        for (const admission of this.#index.listAdmissions(binding.ownerUserId, binding.sessionId)) {
+            if (!['accepted', 'committed'].includes(admission.state))
+                continue;
+            const alreadyRejected = events.some((event) => event.type === 'user_message_rejected' && event.payload.turnId === admission.turnId);
+            const started = events.some((event) => event.type === 'assistant_started' && event.payload.turnId === admission.turnId);
+            if (alreadyRejected || started)
+                continue;
+            const terminalEvent = events.find((event) => TERMINAL_AGENT_EVENT_TYPES.has(event.type) && event.payload.turnId === admission.turnId);
+            if (terminalEvent) {
+                this.#index.updateAdmission(binding.ownerUserId, binding.sessionId, admission.clientRequestId, {
+                    state: 'terminal',
+                    result: terminalEvent.type === 'turn_completed'
+                        ? 'accepted'
+                        : terminalEvent.type === 'turn_failed'
+                            ? 'failed'
+                            : 'aborted',
+                });
+                continue;
+            }
+            await persistence.journal.append({
+                sessionId: binding.sessionId,
+                type: 'user_message_rejected',
+                payload: {
+                    turnId: admission.turnId,
+                    clientRequestId: admission.clientRequestId,
+                    reason: 'queue_discarded',
+                },
+            }, { durability: 'critical' });
+            this.#index.updateAdmission(binding.ownerUserId, binding.sessionId, admission.clientRequestId, {
+                state: 'rejected',
+                result: 'queue_discarded',
+            });
+        }
+    }
+    async close(sessionId, status = 'closed') {
+        const record = this.#index.get(sessionId);
+        if (!record)
+            throw new GatewayPersistenceError('not_found', 'session not found');
+        this.#index.update(sessionId, {
+            status,
+            activeTurnId: status === 'closed' || status === 'interrupted' ? null : record.activeTurnId,
+            updatedAt: new Date().toISOString(),
+        });
+    }
+    closeIndex() {
+        this.#index.close();
+    }
+}
+//# sourceMappingURL=coordinator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../source/gateway/persistence/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAA6B,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAAE,wBAAwB,EAAiC,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AASzD,MAAM,UAAU,yBAAyB,CAAC,OAAuB;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9E,OAAO,MAAM;SACV,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CACL,IAAI,CAAC,SAAS,CAAC;QACb,IAAI,EAAE,0BAA0B;QAChC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU;QACV,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,EACF,MAAM,CACP;SACA,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,MAAM,OAAO,6BAA6B;IAC/B,OAAO,CAAuB;IAC9B,MAAM,CAAsB;IAErC,YAAY,MAA4B,EAAE,KAAK,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC;QAC/E,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,aAAa,CAAC,MAA4B,EAAE,OAAuB;QACjE,IAAI,MAAM,CAAC,kBAAkB,KAAK,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,uBAAuB,CAAC,UAAU,EAAE,kEAAkE,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAuB,EAAE,OAAO,GAA2B,EAAE;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;gBACjB,EAAE,EAAE,OAAO,CAAC,SAAS;gBACrB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;gBAC1C,kBAAkB,EAAE,yBAAyB,CAAC,OAAO,CAAC;gBACtD,MAAM,EAAE,cAAc;gBACtB,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtC,IAAI,QAAQ,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;gBACjG,MAAM,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ;gBAAE,MAAM,IAAI,uBAAuB,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,WAAiD,CAAC;QACtD,IAAI,CAAC;YACH,WAAW,GAAG,wBAAwB,CAAC;gBACrC,MAAM,EAAE,IAAI,CAAC,OAAO;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG;gBACrC,oBAAoB,EAAE,QAAQ,EAAE,oBAAoB;aACrD,CAAC,CAAC;YACH,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,WAAW,CAAC,QAAQ,CAAC,cAAc,CACvC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,EAC/D,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,EAAE,CACvE,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE;gBACpC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAS,CAAC,MAAM;gBAC3C,oBAAoB,EAAE,SAAS,CAAC,oBAAoB;gBACpD,qBAAqB,EAAE,SAAS,CAAC,qBAAqB;gBACtD,0BAA0B,EAAE,SAAS,CAAC,0BAA0B;gBAChE,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;gBAChD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;YACH,MAAM,WAAW,CAAC,qBAAqB,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACrE,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACpE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAE,EAAE,WAAW,EAAE,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE;oBACpC,MAAM,EAAE,aAAa;oBACrB,eAAe,EAAE,2CAA2C;oBAC5D,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,YAAY,EAAE,IAAI;iBACnB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;YAC1E,CAAC;YACD,MAAM,KAAK,YAAY,uBAAuB;gBAC5C,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,uBAAuB,CAAC,UAAU,EAAE,2CAA2C,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,OAAuB,EACvB,WAAqC,EACrC,WAA4C;QAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,eAAe,GACnB,QAAQ;YACR;gBACE,uBAAuB;gBACvB,mBAAmB;gBACnB,cAAc;gBACd,mBAAmB;gBACnB,qBAAqB;aACtB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;YAClG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE;gBACpC,MAAM,EAAE,aAAa;gBACrB,YAAY,EAAE,IAAI;gBAClB,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACvC,eAAe,EAAE,mDAAmD;gBACpE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3F,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,SAAS;YACnE,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CACjC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,uBAAuB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,CAC/F,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CACzB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,CAC3F,CAAC;YACF,IAAI,eAAe,IAAI,OAAO;gBAAE,SAAS;YACzC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,CACnG,CAAC;YACF,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE;oBAC7F,KAAK,EAAE,UAAU;oBACjB,MAAM,EACJ,aAAa,CAAC,IAAI,KAAK,gBAAgB;wBACrC,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,aAAa,CAAC,IAAI,KAAK,aAAa;4BACtC,CAAC,CAAC,QAAQ;4BACV,CAAC,CAAC,SAAS;iBAChB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,CAC9B;gBACE,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE;oBACP,MAAM,EAAE,SAAS,CAAC,MAAM;oBACxB,eAAe,EAAE,SAAS,CAAC,eAAe;oBAC1C,MAAM,EAAE,iBAAiB;iBAC1B;aACF,EACD,EAAE,UAAU,EAAE,UAAU,EAAE,CAC3B,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE;gBAC7F,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,iBAAiB;aAC1B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,MAAM,GAAsC,QAAQ;QACjF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,uBAAuB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;YAC5B,MAAM;YACN,YAAY,EAAE,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY;YAC1F,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/gateway/persistence/event-journal.d.ts

@@ -0,0 +1,31 @@
+import { type AgentEventEnvelope, type DurableEventCandidate, type GatewayEventJournal, type PersistenceHighWater, type ReplayLiveSubscription } from './contracts.js';
+export type GatewayEventJournalOptions = {
+    sessionId: string;
+    directory: string;
+    maxEventBytes?: number;
+    transcriptGeneration?: number;
+};
+export declare class GatewayEventJournalImpl implements GatewayEventJournal {
+    #private;
+    constructor(options: GatewayEventJournalOptions);
+    get repairWarning(): string | null;
+    get transcriptGeneration(): number;
+    assertHealthy(): void;
+    append(event: DurableEventCandidate, options: {
+        durability: 'critical' | 'stream';
+    }): Promise<{
+        id: number;
+        fsynced: boolean;
+    }>;
+    flush(): Promise<void>;
+    get sessionId(): string;
+    get directory(): string;
+    events(): readonly AgentEventEnvelope[];
+    highWater(): PersistenceHighWater;
+    setProjectionSequence(sequence: number): void;
+    subscribeFrom(after: number | null, listener: (event: AgentEventEnvelope) => void, expectedTranscriptGeneration?: number): ReplayLiveSubscription;
+    compactThrough(sequence: number): void;
+    close(): void;
+}
+export declare function createGatewayEventJournal(options: GatewayEventJournalOptions): GatewayEventJournalImpl;
+//# sourceMappingURL=event-journal.d.ts.map

package/dist/gateway/persistence/event-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-journal.d.ts","sourceRoot":"","sources":["../../../source/gateway/persistence/event-journal.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAE5B,MAAM,gBAAgB,CAAC;AA0ExB,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,qBAAa,uBAAwB,YAAW,mBAAmB;;IAiBjE,YAAY,OAAO,EAAE,0BAA0B,EAS9C;IAkGD,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED,aAAa,IAAI,IAAI,CAGpB;IAEK,MAAM,CACV,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE;QAAE,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAA;KAAE,GAC7C,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CA+C3C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3B;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,MAAM,IAAI,SAAS,kBAAkB,EAAE,CAEtC;IAED,SAAS,IAAI,oBAAoB,CAOhC;IAED,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO5C;IAED,aAAa,CACX,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,EAC7C,4BAA4B,CAAC,EAAE,MAAM,GACpC,sBAAsB,CAiDxB;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAiBrC;IAED,KAAK,IAAI,IAAI,CAGZ;CACF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,uBAAuB,CAEtG"}

package/dist/gateway/persistence/event-journal.js

@@ -0,0 +1,378 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { GatewayPersistenceError, FROZEN_AGENT_EVENT_TYPES, } from './contracts.js';
+import { fsyncDirectory } from './storage.js';
+const MAX_EVENT_BYTES = 256 * 1024;
+const FORBIDDEN_PAYLOAD_KEYS = new Set([
+    'ownerUserId',
+    'projectPath',
+    'canonicalRoot',
+    'sshHost',
+    'sshTargetId',
+    'credentials',
+    'apiKey',
+    'rawInterruption',
+    'path',
+    'cwd',
+    'root',
+    'stack',
+    'authorization',
+    'previousResponseId',
+]);
+const PATH_KEYS = new Set(['path', 'cwd', 'root', 'canonicalRoot', 'projectPath']);
+const CREDENTIAL_KEYS = new Set([
+    'credential',
+    'credentials',
+    'token',
+    'secret',
+    'password',
+    'apiKey',
+    'authorization',
+]);
+const FROZEN_EVENT_TYPE_SET = new Set(FROZEN_AGENT_EVENT_TYPES);
+function assertSafePayload(value, depth = 0) {
+    if (depth > 8)
+        throw new GatewayPersistenceError('corrupt', 'event payload nesting is too deep');
+    if (typeof value === 'string') {
+        if (value.length > 32_000 || value.includes('\u0000'))
+            throw new GatewayPersistenceError('corrupt', 'event payload is unsafe');
+        return;
+    }
+    if (Array.isArray(value)) {
+        if (value.length > 512)
+            throw new GatewayPersistenceError('corrupt', 'event payload array is too large');
+        for (const item of value)
+            assertSafePayload(item, depth + 1);
+        return;
+    }
+    if (value && typeof value === 'object') {
+        for (const [key, child] of Object.entries(value)) {
+            if (FORBIDDEN_PAYLOAD_KEYS.has(key))
+                throw new GatewayPersistenceError('corrupt', `event payload contains ${key}`);
+            if (CREDENTIAL_KEYS.has(key) || (typeof child === 'string' && /^Bearer\s+|^sk-[A-Za-z0-9]/.test(child)))
+                throw new GatewayPersistenceError('corrupt', `event payload contains credential material`);
+            if (PATH_KEYS.has(key) && typeof child === 'string' && /^(?:\/(?:[^/]|$)|[A-Za-z]:[\\/])/.test(child))
+                throw new GatewayPersistenceError('corrupt', `event payload contains an absolute path`);
+            assertSafePayload(child, depth + 1);
+        }
+    }
+}
+function fsyncFile(fd) {
+    fs.fsyncSync(fd);
+}
+function atomicCheckpoint(pathname, value) {
+    const temporary = `${pathname}.${process.pid}.tmp`;
+    fs.writeFileSync(temporary, JSON.stringify(value) + '\n', { mode: 0o600 });
+    const fd = fs.openSync(temporary, 'r');
+    try {
+        fsyncFile(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    fs.renameSync(temporary, pathname);
+    fsyncDirectory(path.dirname(pathname));
+}
+export class GatewayEventJournalImpl {
+    #sessionId;
+    #directory;
+    #eventsPath;
+    #checkpointPath;
+    #maxEventBytes;
+    #transcriptGeneration;
+    #listeners = new Set();
+    #events = [];
+    #lastAppendedSequence = 0;
+    #lastPublishedSequence = 0;
+    #firstRetainedEventSequence = 1;
+    #projectionSequence = 0;
+    #failure = null;
+    #closed = false;
+    #repairWarning = null;
+    constructor(options) {
+        this.#sessionId = options.sessionId;
+        this.#directory = options.directory;
+        this.#eventsPath = path.join(options.directory, 'events.jsonl');
+        this.#checkpointPath = path.join(options.directory, 'event-checkpoint.json');
+        this.#maxEventBytes = options.maxEventBytes ?? MAX_EVENT_BYTES;
+        this.#transcriptGeneration = options.transcriptGeneration ?? 1;
+        fs.mkdirSync(options.directory, { recursive: true, mode: 0o700 });
+        this.#load();
+    }
+    #load() {
+        try {
+            let checkpointLastAppended = 0;
+            if (fs.existsSync(this.#checkpointPath)) {
+                const checkpoint = JSON.parse(fs.readFileSync(this.#checkpointPath, 'utf8'));
+                if (Number.isSafeInteger(checkpoint.firstRetainedEventSequence) && checkpoint.firstRetainedEventSequence > 0) {
+                    this.#firstRetainedEventSequence = checkpoint.firstRetainedEventSequence;
+                }
+                if (Number.isSafeInteger(checkpoint.projectionSequence))
+                    this.#projectionSequence = checkpoint.projectionSequence;
+                if (checkpoint.lastAppendedSequence !== undefined &&
+                    (!Number.isSafeInteger(checkpoint.lastAppendedSequence) || checkpoint.lastAppendedSequence < 0)) {
+                    throw new GatewayPersistenceError('corrupt', 'journal checkpoint sequence is invalid');
+                }
+                checkpointLastAppended = checkpoint.lastAppendedSequence ?? 0;
+                this.#lastAppendedSequence = checkpointLastAppended;
+            }
+            if (!fs.existsSync(this.#eventsPath))
+                return;
+            const data = fs.readFileSync(this.#eventsPath, 'utf8');
+            const lines = data.split('\n');
+            const parsed = [];
+            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 event = JSON.parse(line);
+                    this.#validateStoredEvent(event, parsed.length > 0 ? parsed[parsed.length - 1].id : 0);
+                    parsed.push(event);
+                }
+                catch (error) {
+                    if (isLastWithoutNewline) {
+                        this.#quarantineTail(Buffer.from(line, 'utf8'));
+                        const valid = parsed.length ? parsed.map((event) => JSON.stringify(event) + '\n').join('') : '';
+                        fs.writeFileSync(this.#eventsPath, valid, { mode: 0o600 });
+                        const fd = fs.openSync(this.#eventsPath, 'r');
+                        try {
+                            fsyncFile(fd);
+                        }
+                        finally {
+                            fs.closeSync(fd);
+                        }
+                        fsyncDirectory(this.#directory);
+                        this.#repairWarning = 'journal torn tail quarantined and repaired';
+                        break;
+                    }
+                    throw error instanceof GatewayPersistenceError
+                        ? error
+                        : new GatewayPersistenceError('corrupt', 'journal contains invalid JSON');
+                }
+            }
+            this.#events = parsed;
+            const lastRecordId = parsed.at(-1)?.id ?? 0;
+            if (parsed.length > 0 && checkpointLastAppended > lastRecordId) {
+                throw new GatewayPersistenceError('corrupt', 'journal checkpoint is ahead of its records');
+            }
+            this.#lastAppendedSequence = Math.max(checkpointLastAppended, lastRecordId);
+            this.#lastPublishedSequence = this.#lastAppendedSequence;
+            if (parsed.length > 0 && this.#firstRetainedEventSequence > lastRecordId) {
+                throw new GatewayPersistenceError('corrupt', 'journal retained range is ahead of its records');
+            }
+        }
+        catch (error) {
+            this.#failure = error instanceof Error ? error : new Error(String(error));
+            if (error instanceof GatewayPersistenceError)
+                throw error;
+            throw new GatewayPersistenceError('corrupt', 'gateway event journal is corrupt');
+        }
+    }
+    #quarantineTail(bytes) {
+        const directory = path.join(this.#directory, 'corruption');
+        fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+        fs.writeFileSync(path.join(directory, `events.${Date.now()}.tail`), bytes, { mode: 0o600 });
+    }
+    #validateStoredEvent(event, previousId) {
+        if (!event ||
+            event.schemaVersion !== 1 ||
+            event.sessionId !== this.#sessionId ||
+            !Number.isSafeInteger(event.id) ||
+            event.id <= previousId) {
+            throw new GatewayPersistenceError('corrupt', 'journal sequence or session identity is invalid');
+        }
+        if (typeof event.type !== 'string' ||
+            !FROZEN_EVENT_TYPE_SET.has(event.type) ||
+            typeof event.occurredAt !== 'string' ||
+            !event.payload ||
+            typeof event.payload !== 'object') {
+            throw new GatewayPersistenceError('corrupt', 'journal event shape is invalid');
+        }
+        assertSafePayload(event.payload);
+    }
+    get repairWarning() {
+        return this.#repairWarning;
+    }
+    get transcriptGeneration() {
+        return this.#transcriptGeneration;
+    }
+    assertHealthy() {
+        if (this.#closed)
+            throw new GatewayPersistenceError('readonly', 'event journal is closed');
+        if (this.#failure)
+            throw new GatewayPersistenceError('journal_unhealthy', this.#failure.message);
+    }
+    async append(event, options) {
+        this.assertHealthy();
+        try {
+            if (event.sessionId !== this.#sessionId)
+                throw new GatewayPersistenceError('corrupt', 'event belongs to another session');
+            if (!FROZEN_EVENT_TYPE_SET.has(event.type))
+                throw new GatewayPersistenceError('conflict', 'event type is outside the frozen v1 allowlist');
+            if (event.type !== 'session_created' && typeof event.payload.turnId !== 'string') {
+                throw new GatewayPersistenceError('corrupt', 'turn-scoped event is missing turnId');
+            }
+            assertSafePayload(event.payload);
+            const envelope = {
+                schemaVersion: 1,
+                id: this.#lastAppendedSequence + 1,
+                sessionId: this.#sessionId,
+                type: event.type,
+                occurredAt: event.occurredAt ?? new Date().toISOString(),
+                payload: event.payload,
+            };
+            const line = JSON.stringify(envelope) + '\n';
+            if (Buffer.byteLength(line, 'utf8') > this.#maxEventBytes)
+                throw new GatewayPersistenceError('corrupt', 'event exceeds persistence bound');
+            const fd = fs.openSync(this.#eventsPath, 'a', 0o600);
+            try {
+                fs.writeSync(fd, line);
+                if (options.durability === 'critical')
+                    fsyncFile(fd);
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+            this.#events.push(envelope);
+            this.#lastAppendedSequence = envelope.id;
+            atomicCheckpoint(this.#checkpointPath, this.highWater());
+            this.#lastPublishedSequence = envelope.id;
+            for (const listener of [...this.#listeners]) {
+                try {
+                    listener(envelope);
+                }
+                catch {
+                    // A subscriber cannot make a durable append fail.
+                }
+            }
+            atomicCheckpoint(this.#checkpointPath, this.highWater());
+            return { id: envelope.id, fsynced: options.durability === 'critical' };
+        }
+        catch (error) {
+            if (error instanceof GatewayPersistenceError && error.code !== 'journal_unhealthy')
+                throw error;
+            this.#failure = error instanceof Error ? error : new Error(String(error));
+            throw new GatewayPersistenceError('journal_unhealthy', 'event journal append failed');
+        }
+    }
+    async flush() {
+        this.assertHealthy();
+        const fd = fs.openSync(this.#eventsPath, 'a');
+        try {
+            fsyncFile(fd);
+        }
+        catch (error) {
+            this.#failure = error instanceof Error ? error : new Error(String(error));
+            throw new GatewayPersistenceError('journal_unhealthy', 'event journal flush failed');
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        atomicCheckpoint(this.#checkpointPath, this.highWater());
+    }
+    get sessionId() {
+        return this.#sessionId;
+    }
+    get directory() {
+        return this.#directory;
+    }
+    events() {
+        return this.#events.map((event) => ({ ...event, payload: { ...event.payload } }));
+    }
+    highWater() {
+        return {
+            lastAppendedSequence: this.#lastAppendedSequence,
+            lastPublishedSequence: this.#lastPublishedSequence,
+            firstRetainedEventSequence: this.#firstRetainedEventSequence,
+            projectionSequence: this.#projectionSequence,
+        };
+    }
+    setProjectionSequence(sequence) {
+        this.assertHealthy();
+        if (!Number.isSafeInteger(sequence) || sequence < 0 || sequence > this.#lastAppendedSequence) {
+            throw new GatewayPersistenceError('conflict', 'projection sequence is invalid');
+        }
+        this.#projectionSequence = sequence;
+        atomicCheckpoint(this.#checkpointPath, this.highWater());
+    }
+    subscribeFrom(after, listener, expectedTranscriptGeneration) {
+        const highWater = this.#lastPublishedSequence;
+        if (this.#failure) {
+            return {
+                kind: 'reload_required',
+                reason: 'journal_unhealthy',
+                firstRetainedEventSequence: this.#firstRetainedEventSequence,
+                latestSequence: highWater,
+            };
+        }
+        if (expectedTranscriptGeneration !== undefined && expectedTranscriptGeneration !== this.#transcriptGeneration) {
+            return {
+                kind: 'reload_required',
+                reason: 'generation_mismatch',
+                firstRetainedEventSequence: this.#firstRetainedEventSequence,
+                latestSequence: highWater,
+            };
+        }
+        const cursor = after ?? highWater;
+        if (!Number.isSafeInteger(cursor) || cursor < 0)
+            throw new GatewayPersistenceError('cursor_invalid', 'event cursor is invalid');
+        if (after !== null && cursor < this.#firstRetainedEventSequence - 1) {
+            return {
+                kind: 'reload_required',
+                reason: 'cursor_compacted',
+                firstRetainedEventSequence: this.#firstRetainedEventSequence,
+                latestSequence: highWater,
+            };
+        }
+        if (cursor > highWater) {
+            return {
+                kind: 'reload_required',
+                reason: 'sequence_gap',
+                firstRetainedEventSequence: this.#firstRetainedEventSequence,
+                latestSequence: highWater,
+            };
+        }
+        const replay = after === null ? [] : this.#events.filter((event) => event.id > cursor && event.id <= highWater);
+        const wrapped = (event) => {
+            if (event.id > highWater)
+                listener(event);
+        };
+        this.#listeners.add(wrapped);
+        return {
+            kind: 'subscribed',
+            replay,
+            replayHighWater: highWater,
+            firstRetainedEventSequence: this.#firstRetainedEventSequence,
+            unsubscribe: () => this.#listeners.delete(wrapped),
+        };
+    }
+    compactThrough(sequence) {
+        this.assertHealthy();
+        if (!Number.isSafeInteger(sequence) || sequence < 0 || sequence > this.#lastPublishedSequence) {
+            throw new GatewayPersistenceError('conflict', 'compact sequence is invalid');
+        }
+        this.#events = this.#events.filter((event) => event.id > sequence);
+        this.#firstRetainedEventSequence = this.#events[0]?.id ?? this.#lastAppendedSequence + 1;
+        const contents = this.#events.map((event) => JSON.stringify(event) + '\n').join('');
+        fs.writeFileSync(this.#eventsPath, contents, { mode: 0o600 });
+        const fd = fs.openSync(this.#eventsPath, 'r');
+        try {
+            fsyncFile(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fsyncDirectory(this.#directory);
+        atomicCheckpoint(this.#checkpointPath, this.highWater());
+    }
+    close() {
+        this.#closed = true;
+        this.#listeners.clear();
+    }
+}
+export function createGatewayEventJournal(options) {
+    return new GatewayEventJournalImpl(options);
+}
+//# sourceMappingURL=event-journal.js.map

package/dist/gateway/persistence/event-journal.js.map

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

package/dist/gateway/persistence/interaction-checkpoint.d.ts

@@ -0,0 +1,17 @@
+import type { GatewayEventJournalImpl } from './event-journal.js';
+import { type PendingInteractionDto } from '../interaction-protocol.js';
+export type InteractionCheckpoint = {
+    readonly turnId: string;
+    readonly interaction: PendingInteractionDto;
+    readonly revision: number;
+    readonly generation: string;
+};
+export declare class InteractionCheckpointStore {
+    #private;
+    constructor(directory: string);
+    get current(): InteractionCheckpoint | null;
+    save(checkpoint: InteractionCheckpoint): void;
+    clear(): void;
+    recover(journal: GatewayEventJournalImpl): Promise<void>;
+}
+//# sourceMappingURL=interaction-checkpoint.d.ts.map

package/dist/gateway/persistence/interaction-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-checkpoint.d.ts","sourceRoot":"","sources":["../../../source/gateway/persistence/interaction-checkpoint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGlE,OAAO,EAAiC,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEvG,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qBAAa,0BAA0B;;IAIrC,YAAY,SAAS,EAAE,MAAM,EAc5B;IAED,IAAI,OAAO,IAAI,qBAAqB,GAAG,IAAI,CAE1C;IAED,IAAI,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAkB5C;IAED,KAAK,IAAI,IAAI,CAOZ;IAEK,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7D;CACF"}