@a5c-ai/agent-mux-gateway 0.0.0 → 0.4.2

package/dist/protocol/v1.d.ts

@@ -0,0 +1,104 @@
+export type ProtocolVersion = '1';
+export interface AuthFrame {
+    type: 'auth';
+    token: string;
+}
+export interface HelloFrame {
+    type: 'hello';
+    protocolVersions: ProtocolVersion[];
+    serverVersion: string;
+    serverTime: string;
+}
+export interface ErrorFrame {
+    type: 'error';
+    code: string;
+    message: string;
+    runId?: string;
+    tailSeq?: number;
+}
+export interface SubscribeFrame {
+    type: 'subscribe';
+    runId: string;
+    sinceSeq?: number;
+}
+export interface UnsubscribeFrame {
+    type: 'unsubscribe';
+    runId: string;
+}
+export interface SessionSubscribeFrame {
+    type: 'session.subscribe';
+    sessionId: string;
+}
+export interface SessionUnsubscribeFrame {
+    type: 'session.unsubscribe';
+    sessionId: string;
+}
+export interface SessionStartFrame {
+    type: 'session.start';
+    agent: string;
+    prompt: string;
+    model?: string;
+    sessionId?: string;
+    runId?: string;
+}
+export interface SessionMessageFrame {
+    type: 'session.message';
+    sessionId: string;
+    prompt: string;
+    agent?: string;
+    model?: string;
+}
+export interface PingFrame {
+    type: 'ping';
+}
+export interface PongFrame {
+    type: 'pong';
+}
+export interface RunEventFrame {
+    type: 'run.event';
+    runId: string;
+    seq: number;
+    source: string;
+    event: Record<string, unknown>;
+}
+export interface HookRequestFrame {
+    type: 'hook.request';
+    hookRequestId: string;
+    runId: string;
+    hookKind: string;
+    payload: Record<string, unknown>;
+    deadlineTs: number;
+}
+export interface HookDecisionFrame {
+    type: 'hook.decision';
+    hookRequestId: string;
+    decision: 'allow' | 'deny';
+    reason?: string;
+}
+export interface HookResolvedFrame {
+    type: 'hook.resolved';
+    hookRequestId: string;
+    resolvedBy: string;
+    decision: 'allow' | 'deny';
+}
+export interface PairingRegisterFrame {
+    type: 'pairing.register';
+    code: string;
+    url: string;
+    token: string;
+}
+export interface PairingConsumeFrame {
+    type: 'pairing.consume';
+    code: string;
+}
+export interface PairingConsumedFrame {
+    type: 'pairing.consumed';
+    code: string;
+    url: string;
+    token: string;
+    expiresAt: number;
+}
+export type ClientFrame = AuthFrame | SubscribeFrame | UnsubscribeFrame | SessionSubscribeFrame | SessionUnsubscribeFrame | SessionStartFrame | SessionMessageFrame | PingFrame | HookDecisionFrame | PairingRegisterFrame | PairingConsumeFrame;
+export type ServerFrame = HelloFrame | ErrorFrame | PongFrame | RunEventFrame | HookRequestFrame | HookResolvedFrame | PairingConsumedFrame;
+export type GatewayFrame = ClientFrame | ServerFrame;
+//# sourceMappingURL=v1.d.ts.map

package/dist/protocol/v1.d.ts.map

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

package/dist/protocol/v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=v1.js.map

package/dist/protocol/v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../src/protocol/v1.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,29 @@
+import type { RunEntry } from './types.js';
+export interface IndexedRunEvent {
+    seq: number;
+    ts: number;
+    source: string;
+    eventType: string;
+}
+export interface RunSeqState {
+    headSeq: number;
+    tailSeq: number;
+    eventCount: number;
+}
+export declare class EventLogIndex {
+    private readonly eventLogDir;
+    private readonly db;
+    constructor(eventLogDir: string);
+    upsertRun(entry: RunEntry): void;
+    appendEvent(runId: string, event: IndexedRunEvent): void;
+    removeEvents(runId: string, droppedSeqs: readonly number[]): void;
+    getSeqState(runId: string): RunSeqState;
+    nextSeq(runId: string): number;
+    getRun(runId: string): RunEntry | null;
+    listRuns(): RunEntry[];
+    close(): void;
+    indexedEventFor(seq: number, ts: number, source: string, event: Record<string, unknown>): IndexedRunEvent;
+    private minSeq;
+    private rowToRunEntry;
+}
+//# sourceMappingURL=event-log-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-log-index.d.ts","sourceRoot":"","sources":["../../src/runs/event-log-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,WAAW;IAFxC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAM;gBAEI,WAAW,EAAE,MAAM;IAsChD,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IA0ChC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI;IAoBxD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IA2BjE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAkBvC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAStC,QAAQ,IAAI,QAAQ,EAAE;IAStB,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe;IASzG,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,aAAa;CAwBtB"}

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

@@ -0,0 +1,195 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const { DatabaseSync } = require('node:sqlite');
+function ensureParentDir(filePath) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+function eventTypeOf(event) {
+    return typeof event['type'] === 'string' ? event['type'] : 'unknown';
+}
+export class EventLogIndex {
+    eventLogDir;
+    db;
+    constructor(eventLogDir) {
+        this.eventLogDir = eventLogDir;
+        const dbPath = path.join(eventLogDir, 'index.db');
+        ensureParentDir(dbPath);
+        this.db = new DatabaseSync(dbPath);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS runs (
+        run_id TEXT PRIMARY KEY,
+        agent TEXT NOT NULL,
+        model TEXT,
+        status TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        started_at INTEGER NOT NULL,
+        ended_at INTEGER,
+        session_id TEXT,
+        exit_reason TEXT,
+        error_code TEXT,
+        error_message TEXT,
+        owner_token_id TEXT,
+        owner_name TEXT,
+        owner_remote_address TEXT,
+        head_seq INTEGER NOT NULL DEFAULT 1,
+        tail_seq INTEGER NOT NULL DEFAULT 0,
+        event_count INTEGER NOT NULL DEFAULT 0,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS run_events (
+        run_id TEXT NOT NULL,
+        seq INTEGER NOT NULL,
+        ts INTEGER NOT NULL,
+        source TEXT NOT NULL,
+        event_type TEXT NOT NULL,
+        PRIMARY KEY (run_id, seq)
+      );
+      CREATE INDEX IF NOT EXISTS idx_runs_updated_at ON runs (updated_at DESC);
+      CREATE INDEX IF NOT EXISTS idx_runs_status ON runs (status);
+    `);
+    }
+    upsertRun(entry) {
+        this.db.prepare(`
+      INSERT INTO runs (
+        run_id, agent, model, status, created_at, started_at, ended_at, session_id,
+        exit_reason, error_code, error_message, owner_token_id, owner_name,
+        owner_remote_address, updated_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(run_id) DO UPDATE SET
+        agent = excluded.agent,
+        model = excluded.model,
+        status = excluded.status,
+        created_at = excluded.created_at,
+        started_at = excluded.started_at,
+        ended_at = excluded.ended_at,
+        session_id = excluded.session_id,
+        exit_reason = excluded.exit_reason,
+        error_code = excluded.error_code,
+        error_message = excluded.error_message,
+        owner_token_id = excluded.owner_token_id,
+        owner_name = excluded.owner_name,
+        owner_remote_address = excluded.owner_remote_address,
+        updated_at = excluded.updated_at
+    `).run(entry.runId, entry.agent, entry.model ?? null, entry.status, entry.createdAt, entry.startedAt, entry.endedAt, entry.sessionId ?? null, entry.exitReason ?? null, entry.error?.code ?? null, entry.error?.message ?? null, entry.owner.tokenId, entry.owner.name, entry.owner.remoteAddress ?? null, Date.now());
+    }
+    appendEvent(runId, event) {
+        this.db.prepare(`
+      INSERT INTO run_events (run_id, seq, ts, source, event_type)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(runId, event.seq, event.ts, event.source, event.eventType);
+        this.db.prepare(`
+      UPDATE runs
+      SET
+        tail_seq = ?,
+        head_seq = CASE
+          WHEN event_count = 0 THEN ?
+          ELSE head_seq
+        END,
+        event_count = event_count + 1,
+        updated_at = ?
+      WHERE run_id = ?
+    `).run(event.seq, event.seq, Date.now(), runId);
+    }
+    removeEvents(runId, droppedSeqs) {
+        if (droppedSeqs.length === 0)
+            return;
+        this.db.prepare(`
+      DELETE FROM run_events
+      WHERE run_id = ?
+        AND seq IN (${droppedSeqs.map(() => '?').join(', ')})
+    `).run(runId, ...droppedSeqs);
+        const nextState = this.getSeqState(runId);
+        this.db.prepare(`
+      UPDATE runs
+      SET
+        head_seq = ?,
+        tail_seq = ?,
+        event_count = ?,
+        updated_at = ?
+      WHERE run_id = ?
+    `).run(nextState.tailSeq === 0 ? 1 : Number(this.minSeq(runId) ?? nextState.tailSeq), nextState.tailSeq, nextState.eventCount, Date.now(), runId);
+    }
+    getSeqState(runId) {
+        const row = this.db.prepare(`
+      SELECT head_seq, tail_seq, event_count
+      FROM runs
+      WHERE run_id = ?
+    `).get(runId);
+        if (!row) {
+            return { headSeq: 1, tailSeq: 0, eventCount: 0 };
+        }
+        return {
+            headSeq: Number(row['head_seq'] ?? 1),
+            tailSeq: Number(row['tail_seq'] ?? 0),
+            eventCount: Number(row['event_count'] ?? 0),
+        };
+    }
+    nextSeq(runId) {
+        return this.getSeqState(runId).tailSeq + 1;
+    }
+    getRun(runId) {
+        const row = this.db.prepare(`
+      SELECT *
+      FROM runs
+      WHERE run_id = ?
+    `).get(runId);
+        return row ? this.rowToRunEntry(row) : null;
+    }
+    listRuns() {
+        const rows = this.db.prepare(`
+      SELECT *
+      FROM runs
+      ORDER BY updated_at DESC, created_at DESC
+    `).all();
+        return rows.map((row) => this.rowToRunEntry(row));
+    }
+    close() {
+        this.db.close();
+    }
+    indexedEventFor(seq, ts, source, event) {
+        return {
+            seq,
+            ts,
+            source,
+            eventType: eventTypeOf(event),
+        };
+    }
+    minSeq(runId) {
+        const row = this.db.prepare(`
+      SELECT MIN(seq) AS min_seq
+      FROM run_events
+      WHERE run_id = ?
+    `).get(runId);
+        if (!row || row['min_seq'] == null)
+            return null;
+        return Number(row['min_seq']);
+    }
+    rowToRunEntry(row) {
+        return {
+            runId: String(row['run_id']),
+            agent: String(row['agent']),
+            model: row['model'] == null ? undefined : String(row['model']),
+            status: String(row['status']),
+            createdAt: Number(row['created_at']),
+            startedAt: Number(row['started_at']),
+            endedAt: row['ended_at'] == null ? null : Number(row['ended_at']),
+            sessionId: row['session_id'] == null ? undefined : String(row['session_id']),
+            exitReason: row['exit_reason'] == null ? undefined : String(row['exit_reason']),
+            error: row['error_code'] == null
+                ? null
+                : {
+                    code: String(row['error_code']),
+                    message: String(row['error_message'] ?? ''),
+                },
+            owner: {
+                tokenId: row['owner_token_id'] == null ? null : String(row['owner_token_id']),
+                name: row['owner_name'] == null ? null : String(row['owner_name']),
+                remoteAddress: row['owner_remote_address'] == null ? null : String(row['owner_remote_address']),
+            },
+        };
+    }
+}
+//# sourceMappingURL=event-log-index.js.map

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

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

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

@@ -0,0 +1,26 @@
+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;
+}
+//# sourceMappingURL=event-log.d.ts.map

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":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AAcvE,SAAS,YAAY,CAAC,WAAmB,EAAE,KAAa;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAe;IACtC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,OAAO,QAAQ;IAKA;IACA;IALV,KAAK,CAAgB;IACb,YAAY,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE7E,YACmB,WAAmB,EACnB,eAAuB;QADvB,gBAAW,GAAX,WAAW,CAAQ;QACnB,oBAAe,GAAf,eAAe,CAAQ;QAExC,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAc,EAAE,KAA8B;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAmB,EAAE,CAAC,CAAC;QACvF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACpD,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC;YACrE,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxC,MAAM,EAAE,CAAC,SAAS,CAChB,QAAQ,EACR,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EACrF,MAAM,CACP,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAElE,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACrD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE;gBAC7D,IAAI,EAAE,sBAAsB;gBAC5B,IAAI,EAAE,kBAAkB;gBACxB,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,OAAO,EAAE,cAAc,CAAC,OAAO;gBAC/B,OAAO,EAAE,cAAc,CAAC,OAAO;aAChC,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,QAAgB,EAAE,SAAkB;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,QAAQ,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,KAAK,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC;YACvG,KAAK;SACN,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,MAAc,EAAE,KAA8B;QACtF,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,MAAM,GAAmB;YAC7B,GAAG;YACH,EAAE;YACF,MAAM;YACN,KAAK;SACN,CAAC;QACF,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAa;QACjC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7E,OAAO,GAAG;iBACP,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;iBACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;iBACjD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,19 @@
+import type { HookDecision } from '@a5c-ai/agent-mux-core';
+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 {};
+//# sourceMappingURL=hook-broker.d.ts.map

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,wBAAwB,CAAC;AAE3D,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;AAUD,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;IAuDxB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO;YAmBrD,MAAM;CAmCrB"}

package/dist/runs/hook-broker.js

@@ -0,0 +1,97 @@
+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 recipients = this.deps.getSubscribers(runId);
+        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,
+                recipients,
+                settled: false,
+                timer,
+                resolveDecision: resolve,
+            });
+            this.deps.send({
+                type: 'hook.request',
+                hookRequestId,
+                runId,
+                hookKind,
+                payload,
+                deadlineTs: Date.now() + timeoutMs,
+            }, recipients);
+            void this.deps.notify?.({
+                type: 'hook.request',
+                hookRequestId,
+                runId,
+                hookKind,
+                payload,
+                deadlineTs: Date.now() + timeoutMs,
+            });
+        });
+    }
+    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,
+            decision: decision.decision,
+            reason: decision.decision === 'deny' ? decision.reason : undefined,
+            resolvedBy,
+        });
+        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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"}