@a5c-ai/adapters-gateway 5.1.1-staging.00ceebd28cf2

package/dist/runs/event-log.d.ts

@@ -0,0 +1,25 @@
+import { EventLogIndex, type RunSeqState } from './event-log-index.js';
+export interface LoggedRunEvent {
+    seq: number;
+    ts: number;
+    source: string;
+    event: Record<string, unknown>;
+}
+export interface ReadRunEventsResult {
+    events: LoggedRunEvent[];
+    state: RunSeqState;
+}
+export declare class EventLog {
+    private readonly eventLogDir;
+    private readonly maxEventsPerRun;
+    readonly index: EventLogIndex;
+    private readonly appendChains;
+    constructor(eventLogDir: string, maxEventsPerRun: number);
+    append(runId: string, source: string, event: Record<string, unknown>): Promise<LoggedRunEvent[]>;
+    readSince(runId: string, sinceSeq: number, tailLimit?: number): Promise<ReadRunEventsResult>;
+    getSeqState(runId: string): RunSeqState;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    private appendSingle;
+    private readAll;
+}

package/dist/runs/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../src/runs/event-log.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;CACpB;AAUD,qBAAa,QAAQ;IAKjB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IALlC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgD;gBAG1D,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM;IAKpC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA2ChG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IASlG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAKd,YAAY;YAcZ,OAAO;CAetB"}

package/dist/runs/event-log.js

@@ -0,0 +1,104 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { EventLogIndex } from './event-log-index.js';
+function eventLogPath(eventLogDir, runId) {
+    return path.join(eventLogDir, `${runId}.ndjson`);
+}
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+export class EventLog {
+    eventLogDir;
+    maxEventsPerRun;
+    index;
+    appendChains = new Map();
+    constructor(eventLogDir, maxEventsPerRun) {
+        this.eventLogDir = eventLogDir;
+        this.maxEventsPerRun = maxEventsPerRun;
+        this.index = new EventLogIndex(eventLogDir);
+    }
+    async append(runId, source, event) {
+        const previous = this.appendChains.get(runId) ?? Promise.resolve([]);
+        const next = previous.catch(() => []).then(async () => {
+            await ensureDir(this.eventLogDir);
+            const logged = await this.appendSingle(runId, source, event);
+            const state = this.index.getSeqState(runId);
+            if (state.eventCount <= this.maxEventsPerRun) {
+                return [logged];
+            }
+            const dropCount = Math.max(1, Math.ceil(this.maxEventsPerRun * 0.1));
+            const filePath = eventLogPath(this.eventLogDir, runId);
+            const allEvents = await this.readAll(runId);
+            const dropped = allEvents.slice(0, dropCount);
+            const kept = allEvents.slice(dropCount);
+            await fs.writeFile(filePath, kept.map((entry) => JSON.stringify(entry)).join('\n') + (kept.length > 0 ? '\n' : ''), 'utf8');
+            this.index.removeEvents(runId, dropped.map((entry) => entry.seq));
+            const stateAfterDrop = this.index.getSeqState(runId);
+            const notification = await this.appendSingle(runId, 'gateway', {
+                type: 'gateway.notification',
+                code: 'events_truncated',
+                droppedCount: dropped.length,
+                headSeq: stateAfterDrop.headSeq,
+                tailSeq: stateAfterDrop.tailSeq,
+            });
+            return [logged, notification];
+        });
+        this.appendChains.set(runId, next);
+        try {
+            return await next;
+        }
+        finally {
+            if (this.appendChains.get(runId) === next) {
+                this.appendChains.delete(runId);
+            }
+        }
+    }
+    async readSince(runId, sinceSeq, tailLimit) {
+        const state = this.index.getSeqState(runId);
+        const events = await this.readAll(runId);
+        return {
+            events: events.filter((entry) => entry.seq > sinceSeq && (tailLimit == null || entry.seq <= tailLimit)),
+            state,
+        };
+    }
+    getSeqState(runId) {
+        return this.index.getSeqState(runId);
+    }
+    async flush() {
+        await Promise.allSettled(Array.from(this.appendChains.values()));
+    }
+    async close() {
+        await this.flush();
+        this.index.close();
+    }
+    async appendSingle(runId, source, event) {
+        const ts = Date.now();
+        const seq = this.index.nextSeq(runId);
+        const logged = {
+            seq,
+            ts,
+            source,
+            event,
+        };
+        await fs.appendFile(eventLogPath(this.eventLogDir, runId), `${JSON.stringify(logged)}\n`, 'utf8');
+        this.index.appendEvent(runId, this.index.indexedEventFor(seq, ts, source, event));
+        return logged;
+    }
+    async readAll(runId) {
+        try {
+            const raw = await fs.readFile(eventLogPath(this.eventLogDir, runId), 'utf8');
+            return raw
+                .split('\n')
+                .filter((line) => line.trim().length > 0)
+                .map((line) => JSON.parse(line))
+                .sort((left, right) => left.seq - right.seq);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=event-log.js.map

package/dist/runs/event-log.js.map

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

package/dist/runs/hook-broker.d.ts

@@ -0,0 +1,18 @@
+import type { HookDecision } from '@a5c-ai/comm-adapter';
+import type { HookDecisionFrame, HookRequestFrame, HookResolvedFrame } from '../protocol/v1.js';
+import type { ClientConn } from '../fanout/client-conn.js';
+interface HookBrokerDeps {
+    getSubscribers(runId: string): ClientConn[];
+    send(frame: HookRequestFrame | HookResolvedFrame, recipients: readonly ClientConn[]): void;
+    persist(runId: string, event: Record<string, unknown>): Promise<void>;
+    notify?(frame: HookRequestFrame): Promise<void>;
+}
+export declare class HookBroker {
+    private readonly deps;
+    private readonly pending;
+    constructor(deps: HookBrokerDeps);
+    requestDecision(runId: string, hookKind: string, payload: Record<string, unknown>, timeoutMs: number): Promise<HookDecision>;
+    submitDecision(conn: ClientConn, frame: HookDecisionFrame): boolean;
+    private finish;
+}
+export {};

package/dist/runs/hook-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-broker.d.ts","sourceRoot":"","sources":["../../src/runs/hook-broker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,UAAU,cAAc;IACtB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,UAAU,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAAC;IAC3F,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAWD,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAErC,IAAI,EAAE,cAAc;IAE3C,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IAkExB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO;YAmBrD,MAAM;CAqCrB"}

package/dist/runs/hook-broker.js

@@ -0,0 +1,110 @@
+import { randomUUID } from 'node:crypto';
+export class HookBroker {
+    deps;
+    pending = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async requestDecision(runId, hookKind, payload, timeoutMs) {
+        const hookRequestId = randomUUID();
+        const timestamp = Date.now();
+        const deadlineTs = Date.now() + timeoutMs;
+        const recipients = this.deps.getSubscribers(runId);
+        await this.deps.persist(runId, {
+            type: 'hook_requested',
+            hookRequestId,
+            hookKind,
+            payload,
+            deadlineTs,
+            timestamp,
+        });
+        if (recipients.length === 0) {
+            await this.deps.persist(runId, {
+                type: 'gateway.notification',
+                code: 'hook_zero_subscribers',
+                hookKind,
+                hookRequestId,
+            });
+            await this.deps.persist(runId, {
+                type: 'hook_decision',
+                hookRequestId,
+                hookKind,
+                decision: 'allow',
+                resolvedBy: 'fallback',
+            });
+            return { decision: 'allow' };
+        }
+        return await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                void this.finish(hookRequestId, { decision: 'allow' }, 'timeout');
+            }, timeoutMs);
+            this.pending.set(hookRequestId, {
+                runId,
+                hookKind,
+                recipients,
+                settled: false,
+                timer,
+                resolveDecision: resolve,
+            });
+            this.deps.send({
+                type: 'hook.request',
+                hookRequestId,
+                runId,
+                hookKind,
+                payload,
+                deadlineTs,
+            }, recipients);
+            void this.deps.notify?.({
+                type: 'hook.request',
+                hookRequestId,
+                runId,
+                hookKind,
+                payload,
+                deadlineTs,
+            });
+        });
+    }
+    submitDecision(conn, frame) {
+        const pending = this.pending.get(frame.hookRequestId);
+        if (!pending || pending.settled) {
+            return false;
+        }
+        if (!pending.recipients.some((recipient) => recipient.id === conn.id)) {
+            return false;
+        }
+        void this.finish(frame.hookRequestId, {
+            decision: frame.decision,
+            reason: frame.reason,
+        }, conn.id);
+        return true;
+    }
+    async finish(hookRequestId, decision, resolvedBy) {
+        const pending = this.pending.get(hookRequestId);
+        if (!pending || pending.settled) {
+            return;
+        }
+        pending.settled = true;
+        clearTimeout(pending.timer);
+        this.pending.delete(hookRequestId);
+        const losingRecipients = pending.recipients.filter((recipient) => recipient.id !== resolvedBy);
+        if (losingRecipients.length > 0) {
+            this.deps.send({
+                type: 'hook.resolved',
+                hookRequestId,
+                resolvedBy,
+                decision: decision.decision,
+            }, losingRecipients);
+        }
+        await this.deps.persist(pending.runId, {
+            type: 'hook_decision',
+            hookRequestId,
+            hookKind: pending.hookKind,
+            decision: decision.decision,
+            reason: decision.decision === 'deny' ? decision.reason : undefined,
+            resolvedBy,
+            timestamp: Date.now(),
+        });
+        pending.resolveDecision(decision);
+    }
+}
+//# sourceMappingURL=hook-broker.js.map

package/dist/runs/hook-broker.js.map

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

package/dist/runs/manager.d.ts

@@ -0,0 +1,57 @@
+import type { FullSession } from '@a5c-ai/comm-adapter';
+import type { GatewayConfig } from '../config.js';
+import type { ClientConn } from '../fanout/client-conn.js';
+import type { GatewayLogger } from '../logging.js';
+import type { HookDecisionFrame } from '../protocol/v1.js';
+import type { RunEntry, RunOwner, RunStartInput, SessionEntry } from './types.js';
+export declare class RunManager {
+    private readonly config;
+    private readonly logger;
+    private static readonly NATIVE_SESSIONS_CACHE_TTL_MS;
+    private static readonly NATIVE_SESSION_CONTENT_CACHE_TTL_MS;
+    private readonly client;
+    private readonly eventLog;
+    private readonly workspaceService;
+    private readonly activeRuns;
+    private readonly observations;
+    private readonly subscribers;
+    private readonly sessionSubscribers;
+    private readonly hookBroker;
+    private nativeSessionsCache;
+    private nativeSessionsPromise;
+    private readonly nativeSessionContentCache;
+    private readonly nativeSessionContentPromises;
+    constructor(config: GatewayConfig, logger: GatewayLogger);
+    start(input: RunStartInput, owner: RunOwner): Promise<RunEntry>;
+    stop(runId: string): Promise<boolean>;
+    sendInput(runId: string, input: string): Promise<boolean>;
+    sendSessionInput(sessionId: string, input: string, owner: RunOwner, overrides?: Partial<Pick<RunStartInput, 'agent' | 'model' | 'attachments' | 'approvalMode'>>): Promise<RunEntry | null>;
+    get(runId: string): RunEntry | null;
+    list(): RunEntry[];
+    getSession(sessionId: string): Promise<SessionEntry | null>;
+    getSessionContent(sessionId: string): Promise<FullSession | null>;
+    listSessions(): Promise<SessionEntry[]>;
+    listWorkspaces(): Promise<import("@a5c-ai/comm-adapter").WorkspaceListResult>;
+    subscribe(conn: ClientConn, runId: string, sinceSeq?: number): Promise<void>;
+    subscribeSession(conn: ClientConn, sessionId: string): Promise<void>;
+    unsubscribeSession(conn: ClientConn, sessionId: string): void;
+    unsubscribe(conn: ClientConn, runId: string): void;
+    removeConnection(conn: ClientConn): void;
+    submitHookDecision(conn: ClientConn, frame: HookDecisionFrame): boolean;
+    shutdown(): Promise<void>;
+    private observeRun;
+    private recordAgentEvent;
+    private recordGatewayEvent;
+    private recordLoggedEvents;
+    private readReplay;
+    private attachSessionSubscribersToRun;
+    private invalidateNativeSessionCaches;
+    private listNativeSessions;
+    private loadNativeSessions;
+    private getAmbientNativeSessionBinding;
+    private loadSessionContent;
+    private tryLoadSessionContentDirect;
+    private buildRuntimeSurface;
+    private readRecentEvents;
+    private toWorkspaceSessionBinding;
+}

package/dist/runs/manager.d.ts.map

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