@producible/cereworker-gateway 26.520.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Producible
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,38 @@
+import { type ToolResult } from '@producible/cereworker-core';
+import type { GatewayClientConfig } from './types.js';
+export interface RemoteToolExecutionContext {
+    conversationId?: string;
+    sessionId: string;
+    turnId?: string;
+    attempt?: number;
+    scopeKey?: string;
+    callId?: string;
+}
+export type ToolExecutor = (tool: string, args: Record<string, unknown>, context?: RemoteToolExecutionContext) => Promise<string | ToolResult>;
+export declare class GatewayNodeClient {
+    private ws;
+    private config;
+    private executor;
+    private onEmergencyStop?;
+    private reconnectAttempt;
+    private maxReconnectAttempts;
+    private reconnectTimer;
+    private connected;
+    private stopped;
+    private startedAt;
+    private readonly bus;
+    constructor(config: GatewayClientConfig, executor: ToolExecutor);
+    setEmergencyStopHandler(handler: () => void): void;
+    connect(): Promise<void>;
+    disconnect(reason?: string): Promise<void>;
+    isConnected(): boolean;
+    private doConnect;
+    private handleFrame;
+    private handleInvoke;
+    private normalizeResult;
+    private getStatus;
+    private scheduleReconnect;
+    private sendEnvelope;
+    private sendRaw;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,0BAA0B,KACjC,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;AAElC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;gBAE1B,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY;IAY/D,uBAAuB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAI5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,UAAU,CAAC,MAAM,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3D,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,SAAS;IAgEjB,OAAO,CAAC,WAAW;YA4DL,YAAY;IAgE1B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,OAAO;CAKhB"}

package/dist/client.js

@@ -0,0 +1,282 @@
+import WebSocket from 'ws';
+import { createLogger } from '@producible/cereworker-core';
+import { SessionBusState, buildBusStatePath } from './session-bus.js';
+const log = createLogger('gateway-client');
+export class GatewayNodeClient {
+    ws = null;
+    config;
+    executor;
+    onEmergencyStop;
+    reconnectAttempt = 0;
+    maxReconnectAttempts = 10;
+    reconnectTimer = null;
+    connected = false;
+    stopped = false;
+    startedAt = Date.now();
+    bus;
+    constructor(config, executor) {
+        this.config = config;
+        this.executor = executor;
+        this.bus = new SessionBusState(buildBusStatePath(config.stateDir, `node-${config.nodeId}`, `${config.gatewayUrl}-${config.nodeId}`));
+    }
+    setEmergencyStopHandler(handler) {
+        this.onEmergencyStop = handler;
+    }
+    async connect() {
+        this.stopped = false;
+        this.startedAt = Date.now();
+        return this.doConnect();
+    }
+    async disconnect(reason = 'client shutdown') {
+        this.stopped = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.sendEnvelope('transport.disconnect', {
+                sessionId: `node:${this.config.nodeId}`,
+                source: 'node',
+                payload: { reason },
+            });
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connected = false;
+        log.info('Disconnected from gateway', { reason });
+    }
+    isConnected() {
+        return this.connected;
+    }
+    doConnect() {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.config.gatewayUrl);
+            ws.on('open', () => {
+                this.ws = ws;
+                this.sendEnvelope('transport.connect', {
+                    sessionId: `node:${this.config.nodeId}`,
+                    source: 'node',
+                    payload: {
+                        nodeId: this.config.nodeId,
+                        token: this.config.token,
+                        capabilities: this.config.capabilities,
+                    },
+                    resumeFromSequence: this.bus.getResumeSequence(),
+                });
+            });
+            ws.on('message', (data) => {
+                let frame;
+                try {
+                    frame = JSON.parse(data.toString());
+                }
+                catch {
+                    log.warn('Received invalid JSON from gateway');
+                    return;
+                }
+                const isConnectedFrame = frame.eventType === 'transport.connected';
+                if (isConnectedFrame) {
+                    this.bus.markConnected(frame);
+                }
+                const shouldProcess = isConnectedFrame ? true : this.bus.markReceived(frame);
+                if (frame.eventType !== 'transport.ack') {
+                    this.sendEnvelope('transport.ack', {
+                        sessionId: frame.sessionId,
+                        conversationId: frame.conversationId,
+                        source: 'node',
+                        payload: { message: 'ack' },
+                    });
+                }
+                if (!shouldProcess)
+                    return;
+                this.handleFrame(frame, resolve, reject);
+            });
+            ws.on('close', () => {
+                this.connected = false;
+                this.ws = null;
+                if (!this.stopped) {
+                    log.warn('Connection to gateway lost, reconnecting...');
+                    this.scheduleReconnect();
+                }
+            });
+            ws.on('error', (err) => {
+                log.error('WebSocket error', { error: err.message });
+                if (!this.connected) {
+                    reject(err);
+                }
+            });
+        });
+    }
+    handleFrame(frame, onConnect, onError) {
+        switch (frame.eventType) {
+            case 'transport.connected':
+                this.connected = true;
+                this.reconnectAttempt = 0;
+                for (const pending of this.bus.replayAfter(frame.resumeFromSequence ?? 0)) {
+                    this.sendRaw(pending);
+                }
+                log.info('Connected to gateway', { gatewayId: frame.payload.gatewayId, nodeId: this.config.nodeId });
+                onConnect?.();
+                break;
+            case 'transport.error':
+                log.error('Gateway error', { message: frame.payload.message });
+                if (!this.connected) {
+                    onError?.(new Error(frame.payload.message));
+                }
+                break;
+            case 'invoke.request':
+                void this.handleInvoke(frame);
+                break;
+            case 'transport.ping':
+                this.sendEnvelope('transport.pong', {
+                    sessionId: frame.sessionId,
+                    conversationId: frame.conversationId,
+                    source: 'node',
+                    payload: { sentAt: frame.payload.sentAt },
+                });
+                break;
+            case 'node.status.request':
+                this.sendEnvelope('node.status', {
+                    sessionId: frame.sessionId,
+                    conversationId: frame.conversationId,
+                    source: 'node',
+                    payload: {
+                        requestId: frame.payload.requestId,
+                        status: this.getStatus(),
+                    },
+                });
+                break;
+            case 'transport.emergency-stop':
+                log.warn('Emergency stop received from gateway');
+                this.onEmergencyStop?.();
+                break;
+            case 'transport.disconnect':
+                log.info('Gateway requested disconnect', { reason: frame.payload.reason });
+                this.stopped = true;
+                this.ws?.close();
+                break;
+            default:
+                log.warn('Unexpected frame from gateway', { eventType: frame.eventType });
+        }
+    }
+    async handleInvoke(frame) {
+        const { invocationId, tool, args, context } = frame.payload;
+        log.info('Invoke received', { invocationId, tool });
+        this.sendEnvelope('tool.started', {
+            sessionId: frame.sessionId,
+            conversationId: frame.conversationId,
+            source: 'node',
+            payload: {
+                invocationId,
+                tool,
+                args,
+                context,
+                nodeId: this.config.nodeId,
+            },
+        });
+        let result;
+        try {
+            const rawResult = await this.executor(tool, args, {
+                conversationId: frame.conversationId,
+                sessionId: frame.sessionId,
+                turnId: context?.turnId ?? frame.sessionId,
+                attempt: context?.attempt,
+                scopeKey: context?.scopeKey,
+                callId: context?.callId ?? invocationId,
+            });
+            result = this.normalizeResult(rawResult, context?.callId ?? invocationId);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            result = {
+                callId: context?.callId ?? invocationId,
+                output: message,
+                isError: true,
+                metadata: {
+                    runtimeError: true,
+                },
+            };
+        }
+        this.sendEnvelope('tool.finished', {
+            sessionId: frame.sessionId,
+            conversationId: frame.conversationId,
+            source: 'node',
+            payload: {
+                invocationId,
+                tool,
+                args,
+                result,
+                context,
+                nodeId: this.config.nodeId,
+            },
+        });
+        this.sendEnvelope('invoke.result', {
+            sessionId: frame.sessionId,
+            conversationId: frame.conversationId,
+            source: 'node',
+            payload: {
+                invocationId,
+                result,
+            },
+        });
+    }
+    normalizeResult(raw, callId) {
+        if (typeof raw === 'string') {
+            return {
+                callId,
+                output: raw,
+                isError: false,
+            };
+        }
+        return {
+            ...raw,
+            callId: raw.callId || callId,
+        };
+    }
+    getStatus() {
+        return {
+            healthy: true,
+            uptime: Math.floor((Date.now() - this.startedAt) / 1000),
+            activeTools: this.config.capabilities.length,
+            autoMode: false,
+        };
+    }
+    scheduleReconnect() {
+        if (this.stopped || this.reconnectAttempt >= this.maxReconnectAttempts) {
+            if (this.reconnectAttempt >= this.maxReconnectAttempts) {
+                log.error('Max reconnect attempts reached, giving up');
+            }
+            return;
+        }
+        const baseDelay = 1000;
+        const maxDelay = 30_000;
+        const delay = Math.min(baseDelay * Math.pow(2, this.reconnectAttempt), maxDelay);
+        const jitter = delay * (0.5 + Math.random() * 0.5);
+        this.reconnectAttempt++;
+        log.info('Reconnecting...', { attempt: this.reconnectAttempt, delayMs: Math.round(jitter) });
+        this.reconnectTimer = setTimeout(() => {
+            this.doConnect().catch((err) => {
+                log.error('Reconnect failed', { error: err.message });
+            });
+        }, jitter);
+    }
+    sendEnvelope(eventType, options) {
+        const envelope = this.bus.createEnvelope({
+            eventType,
+            senderId: this.config.nodeId,
+            instanceId: this.config.instanceId,
+            sessionId: options.sessionId,
+            conversationId: options.conversationId,
+            source: options.source,
+            payload: options.payload,
+            resumeFromSequence: options.resumeFromSequence,
+        });
+        this.sendRaw(envelope);
+        return envelope;
+    }
+    sendRaw(frame) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(frame));
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAmB,MAAM,6BAA6B,CAAC;AAO5E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAiB3C,MAAM,OAAO,iBAAiB;IACpB,EAAE,GAAqB,IAAI,CAAC;IAC5B,MAAM,CAAsB;IAC5B,QAAQ,CAAe;IACvB,eAAe,CAAc;IAC7B,gBAAgB,GAAG,CAAC,CAAC;IACrB,oBAAoB,GAAG,EAAE,CAAC;IAC1B,cAAc,GAAyC,IAAI,CAAC;IAC5D,SAAS,GAAG,KAAK,CAAC;IAClB,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACd,GAAG,CAAkB;IAEtC,YAAY,MAA2B,EAAE,QAAsB;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,IAAI,eAAe,CAC5B,iBAAiB,CACf,MAAM,CAAC,QAAQ,EACf,QAAQ,MAAM,CAAC,MAAM,EAAE,EACvB,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,CACxC,CACF,CAAC;IACJ,CAAC;IAED,uBAAuB,CAAC,OAAmB;QACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,iBAAiB;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,CAAC,sBAAsB,EAAE;gBACxC,SAAS,EAAE,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;gBACvC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,MAAM,EAAE;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,SAAS;QACf,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAEjD,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE;oBACrC,SAAS,EAAE,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;oBACvC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;wBAC1B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;wBACxB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;qBACvC;oBACD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE;iBACjD,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE;gBAChC,IAAI,KAAsB,CAAC;gBAC3B,IAAI,CAAC;oBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAoB,CAAC;gBACzD,CAAC;gBAAC,MAAM,CAAC;oBACP,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;oBAC/C,OAAO;gBACT,CAAC;gBAED,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,KAAK,qBAAqB,CAAC;gBACnE,IAAI,gBAAgB,EAAE,CAAC;oBACrB,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBAChC,CAAC;gBACD,MAAM,aAAa,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC7E,IAAI,KAAK,CAAC,SAAS,KAAK,eAAe,EAAE,CAAC;oBACxC,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE;wBACjC,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;wBACpC,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;qBAC5B,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC,aAAa;oBAAE,OAAO;gBAE3B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAClB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACvB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;gBAEf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBAClB,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;oBACxD,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBAC5B,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,KAAsB,EAAE,SAAiC,EAAE,OAA8B;QAC3G,QAAQ,KAAK,CAAC,SAAS,EAAE,CAAC;YACxB,KAAK,qBAAqB;gBACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;gBAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC,EAAE,CAAC;oBAC1E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBACrG,SAAS,EAAE,EAAE,CAAC;gBACd,MAAM;YAER,KAAK,iBAAiB;gBACpB,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM;YAER,KAAK,gBAAgB;gBACnB,KAAK,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC9B,MAAM;YAER,KAAK,gBAAgB;gBACnB,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE;oBAClC,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;oBACpC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;iBAC1C,CAAC,CAAC;gBACH,MAAM;YAER,KAAK,qBAAqB;gBACxB,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE;oBAC/B,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;oBACpC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;wBAClC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;qBACzB;iBACF,CAAC,CAAC;gBACH,MAAM;YAER,KAAK,0BAA0B;gBAC7B,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;gBACjD,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;gBACzB,MAAM;YAER,KAAK,sBAAsB;gBACzB,GAAG,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC3E,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;gBACjB,MAAM;YAER;gBACE,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAwD;QACjF,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,YAAY;gBACZ,IAAI;gBACJ,IAAI;gBACJ,OAAO;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;aAC3B;SACF,CAAC,CAAC;QAEH,IAAI,MAAkB,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE;gBAChD,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC,SAAS;gBAC1C,OAAO,EAAE,OAAO,EAAE,OAAO;gBACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ;gBAC3B,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,YAAY;aACxC,CAAC,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,IAAI,YAAY,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,GAAG;gBACP,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,YAAY;gBACvC,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE;oBACR,YAAY,EAAE,IAAI;iBACnB;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE;YACjC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,YAAY;gBACZ,IAAI;gBACJ,IAAI;gBACJ,MAAM;gBACN,OAAO;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;aAC3B;SACF,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE;YACjC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,YAAY;gBACZ,MAAM;aACP;SACF,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,GAAwB,EAAE,MAAc;QAC9D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACL,MAAM;gBACN,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QACD,OAAO;YACL,GAAG,GAAG;YACN,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,MAAM;SAC7B,CAAC;IACJ,CAAC;IAEO,SAAS;QACf,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;YACxD,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM;YAC5C,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACvE,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBACvD,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACzD,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAEnD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE7F,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;YACpC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC;IAEO,YAAY,CAClB,SAAY,EACZ,OAMC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YACvC,SAAS;YACT,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC5B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;SAC/C,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,QAA2B,CAAC,CAAC;QAC1C,OAAO,QAA2B,CAAC;IACrC,CAAC;IAEO,OAAO,CAAC,KAAsB;QACpC,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { GatewayFrame, AnyGatewayFrame, NodeInfo, NodeStatus, GatewayServerConfig, GatewayClientConfig, SessionBusEventType, SessionBusEnvelopeMap, } from './types.js';
+export { GatewayServer } from './server.js';
+export { GatewayNodeClient } from './client.js';
+export type { ToolExecutor, RemoteToolExecutionContext } from './client.js';
+export { createProxyTools } from './proxy-tools.js';
+export { TRANSPORT_PROTOCOL_VERSION } from './session-bus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { GatewayServer } from './server.js';
+export { GatewayNodeClient } from './client.js';
+export { createProxyTools } from './proxy-tools.js';
+export { TRANSPORT_PROTOCOL_VERSION } from './session-bus.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/proxy-tools.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '@producible/cereworker-core';
+import type { GatewayServer } from './server.js';
+export declare function createProxyTools(server: GatewayServer, nodeId: string, capabilities: string[]): Record<string, ToolDefinition>;
+//# sourceMappingURL=proxy-tools.d.ts.map

package/dist/proxy-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-tools.d.ts","sourceRoot":"","sources":["../src/proxy-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,6BAA6B,CAAC;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuBhC"}

package/dist/proxy-tools.js

@@ -0,0 +1,23 @@
+export function createProxyTools(server, nodeId, capabilities) {
+    const tools = {};
+    for (const cap of capabilities) {
+        const toolName = `${cap}@${nodeId}`;
+        tools[toolName] = {
+            description: `Execute "${cap}" on remote node "${nodeId}"`,
+            parameters: {},
+            execute: async (args, context) => {
+                return server.invoke(nodeId, cap, args, {
+                    conversationId: context?.conversationId,
+                    sessionId: context?.sessionKey ?? context?.turnId,
+                    turnId: context?.turnId,
+                    attempt: context?.attempt,
+                    callId: context?.callId,
+                    requestedToolName: context?.toolName,
+                    scopeKey: context?.scopeKey,
+                });
+            },
+        };
+    }
+    return tools;
+}
+//# sourceMappingURL=proxy-tools.js.map

package/dist/proxy-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-tools.js","sourceRoot":"","sources":["../src/proxy-tools.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,gBAAgB,CAC9B,MAAqB,EACrB,MAAc,EACd,YAAsB;IAEtB,MAAM,KAAK,GAAmC,EAAE,CAAC;IAEjD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;QACpC,KAAK,CAAC,QAAQ,CAAC,GAAG;YAChB,WAAW,EAAE,YAAY,GAAG,qBAAqB,MAAM,GAAG;YAC1D,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAA8B,EAAE,EAAE;gBACtD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;oBACtC,cAAc,EAAE,OAAO,EAAE,cAAc;oBACvC,SAAS,EAAE,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM;oBACjD,MAAM,EAAE,OAAO,EAAE,MAAM;oBACvB,OAAO,EAAE,OAAO,EAAE,OAAO;oBACzB,MAAM,EAAE,OAAO,EAAE,MAAM;oBACvB,iBAAiB,EAAE,OAAO,EAAE,QAAQ;oBACpC,QAAQ,EAAE,OAAO,EAAE,QAAQ;iBAC5B,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,42 @@
+import { type ToolResult } from '@producible/cereworker-core';
+import type { AnyGatewayFrame, GatewayServerConfig, NodeInfo } from './types.js';
+export declare class GatewayServer {
+    private wss;
+    private httpServer;
+    private nodes;
+    private pendingInvocations;
+    private pingTimer;
+    private gatewayId;
+    private config;
+    private onNodeConnected?;
+    private onNodeDisconnected?;
+    private onEnvelope?;
+    constructor(config: GatewayServerConfig);
+    setNodeConnectedHandler(handler: (nodeId: string, capabilities: string[]) => void): void;
+    setNodeDisconnectedHandler(handler: (nodeId: string, reason: string, capabilities: string[]) => void): void;
+    setEnvelopeHandler(handler: (nodeId: string, frame: AnyGatewayFrame) => void): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    invoke(nodeId: string, tool: string, args: Record<string, unknown>, options?: {
+        timeoutMs?: number;
+        conversationId?: string;
+        sessionId?: string;
+        turnId?: string;
+        attempt?: number;
+        callId?: string;
+        requestedToolName?: string;
+        scopeKey?: string;
+    }): Promise<ToolResult>;
+    emergencyStopAll(): void;
+    listNodes(): NodeInfo[];
+    getNode(nodeId: string): NodeInfo | undefined;
+    getGatewayId(): string;
+    getPort(): number;
+    private createServerEnvelope;
+    private handleFrame;
+    private handleNodeDisconnect;
+    private startPingLoop;
+    private sendEnvelope;
+    private sendRaw;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EACV,eAAe,EAEf,mBAAmB,EACnB,QAAQ,EAIT,MAAM,YAAY,CAAC;AAmBpB,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,UAAU,CAAgD;IAClE,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAsB;IAEpC,OAAO,CAAC,eAAe,CAAC,CAAmD;IAC3E,OAAO,CAAC,kBAAkB,CAAC,CAAmE;IAC9F,OAAO,CAAC,UAAU,CAAC,CAAmD;gBAE1D,MAAM,EAAE,mBAAmB;IAKvC,uBAAuB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IAIxF,0BAA0B,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IAI3G,kBAAkB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCrB,MAAM,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,UAAU,CAAC;IAkDtB,gBAAgB,IAAI,IAAI;IAWxB,SAAS,IAAI,QAAQ,EAAE;IAIvB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI7C,YAAY,IAAI,MAAM;IAItB,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,WAAW;IA4DnB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,OAAO;CAKhB"}

package/dist/server.js

@@ -0,0 +1,373 @@
+import { WebSocketServer, WebSocket } from 'ws';
+import { createServer } from 'node:http';
+import { nanoid } from 'nanoid';
+import { createLogger } from '@producible/cereworker-core';
+import { SessionBusState, buildBusStatePath } from './session-bus.js';
+const log = createLogger('gateway-server');
+export class GatewayServer {
+    wss = null;
+    httpServer = null;
+    nodes = new Map();
+    pendingInvocations = new Map();
+    pingTimer = null;
+    gatewayId;
+    config;
+    onNodeConnected;
+    onNodeDisconnected;
+    onEnvelope;
+    constructor(config) {
+        this.config = config;
+        this.gatewayId = nanoid(12);
+    }
+    setNodeConnectedHandler(handler) {
+        this.onNodeConnected = handler;
+    }
+    setNodeDisconnectedHandler(handler) {
+        this.onNodeDisconnected = handler;
+    }
+    setEnvelopeHandler(handler) {
+        this.onEnvelope = handler;
+    }
+    async start() {
+        this.httpServer = createServer((req, res) => {
+            if (req.url === '/status' && req.method === 'GET') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ gatewayId: this.gatewayId, nodes: this.listNodes() }));
+            }
+            else {
+                res.writeHead(404);
+                res.end();
+            }
+        });
+        this.wss = new WebSocketServer({ server: this.httpServer });
+        this.wss.on('connection', (ws) => {
+            let authenticated = false;
+            let nodeId = null;
+            let nodeBus = null;
+            const authTimeout = setTimeout(() => {
+                if (!authenticated) {
+                    this.sendRaw(ws, this.createServerEnvelope('transport.error', {
+                        sessionId: 'gateway',
+                        source: 'gateway',
+                        payload: { message: 'Authentication timeout' },
+                    }));
+                    ws.close();
+                }
+            }, 10_000);
+            ws.on('message', (data) => {
+                let frame;
+                try {
+                    frame = JSON.parse(data.toString());
+                }
+                catch {
+                    this.sendRaw(ws, this.createServerEnvelope('transport.error', {
+                        sessionId: 'gateway',
+                        source: 'gateway',
+                        payload: { message: 'Invalid JSON' },
+                    }));
+                    return;
+                }
+                if (!authenticated) {
+                    if (frame.eventType !== 'transport.connect') {
+                        this.sendRaw(ws, this.createServerEnvelope('transport.error', {
+                            sessionId: 'gateway',
+                            source: 'gateway',
+                            payload: { message: 'Must authenticate first' },
+                        }));
+                        ws.close();
+                        return;
+                    }
+                    clearTimeout(authTimeout);
+                    const { nodeId: requestedNodeId, token, capabilities } = frame.payload;
+                    if (this.config.token && token !== this.config.token) {
+                        this.sendRaw(ws, this.createServerEnvelope('transport.error', {
+                            sessionId: 'gateway',
+                            source: 'gateway',
+                            payload: { message: 'Invalid token' },
+                        }));
+                        ws.close();
+                        return;
+                    }
+                    if (this.nodes.has(requestedNodeId)) {
+                        this.sendRaw(ws, this.createServerEnvelope('transport.error', {
+                            sessionId: 'gateway',
+                            source: 'gateway',
+                            payload: { message: `Node "${requestedNodeId}" already connected` },
+                        }));
+                        ws.close();
+                        return;
+                    }
+                    nodeId = requestedNodeId;
+                    nodeBus = new SessionBusState(buildBusStatePath(this.config.stateDir, `gateway-${requestedNodeId}`, requestedNodeId));
+                    nodeBus.markReceived(frame);
+                    authenticated = true;
+                    const info = {
+                        nodeId: requestedNodeId,
+                        capabilities,
+                        connectedAt: Date.now(),
+                        lastPingAt: Date.now(),
+                        status: 'connected',
+                    };
+                    this.nodes.set(requestedNodeId, { ws, info, bus: nodeBus });
+                    this.sendEnvelope(this.nodes.get(requestedNodeId), 'transport.connected', {
+                        sessionId: 'gateway',
+                        source: 'gateway',
+                        payload: { gatewayId: this.gatewayId },
+                        resumeFromSequence: nodeBus.getHighestReceivedSequence(),
+                    });
+                    const replayFrom = frame.resumeFromSequence ?? 0;
+                    for (const pending of nodeBus.replayAfter(replayFrom)) {
+                        this.sendRaw(ws, pending);
+                    }
+                    log.info('Node connected', { nodeId: requestedNodeId, capabilities, replayFrom });
+                    this.onNodeConnected?.(requestedNodeId, capabilities);
+                    return;
+                }
+                this.handleFrame(nodeId, frame);
+            });
+            ws.on('close', () => {
+                clearTimeout(authTimeout);
+                if (nodeId) {
+                    this.handleNodeDisconnect(nodeId, 'connection closed');
+                }
+            });
+            ws.on('error', (err) => {
+                log.error('WebSocket error', { nodeId, error: err.message });
+                if (nodeId) {
+                    this.handleNodeDisconnect(nodeId, `error: ${err.message}`);
+                }
+            });
+        });
+        await new Promise((resolve) => {
+            this.httpServer.listen(this.config.port, () => {
+                log.info('Gateway server started', { port: this.config.port, gatewayId: this.gatewayId });
+                resolve();
+            });
+        });
+        this.startPingLoop();
+    }
+    async stop() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        for (const [id, pending] of this.pendingInvocations) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('Gateway shutting down'));
+            this.pendingInvocations.delete(id);
+        }
+        for (const [, node] of this.nodes) {
+            this.sendEnvelope(node, 'transport.disconnect', {
+                sessionId: 'gateway',
+                source: 'gateway',
+                payload: { reason: 'gateway shutting down' },
+            });
+            node.ws.close();
+        }
+        this.nodes.clear();
+        if (this.wss) {
+            this.wss.close();
+            this.wss = null;
+        }
+        await new Promise((resolve) => {
+            if (this.httpServer) {
+                this.httpServer.close(() => resolve());
+                this.httpServer = null;
+            }
+            else {
+                resolve();
+            }
+        });
+        log.info('Gateway server stopped');
+    }
+    async invoke(nodeId, tool, args, options) {
+        const node = this.nodes.get(nodeId);
+        if (!node || node.info.status !== 'connected') {
+            throw new Error(`Node "${nodeId}" is not connected`);
+        }
+        const invocationId = nanoid(12);
+        const timeout = options?.timeoutMs ?? this.config.invokeTimeoutMs;
+        const context = {
+            callId: options?.callId,
+            requestedToolName: options?.requestedToolName,
+            turnId: options?.turnId,
+            attempt: options?.attempt,
+            scopeKey: options?.scopeKey,
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingInvocations.delete(invocationId);
+                reject(new Error(`Invoke timeout: ${tool}@${nodeId} after ${timeout}ms`));
+            }, timeout);
+            this.pendingInvocations.set(invocationId, {
+                resolve,
+                reject,
+                timer,
+                nodeId,
+                tool,
+            });
+            this.sendEnvelope(node, 'invoke.request', {
+                sessionId: options?.sessionId ?? options?.turnId ?? `node:${nodeId}`,
+                conversationId: options?.conversationId,
+                source: 'gateway',
+                payload: {
+                    invocationId,
+                    tool,
+                    args,
+                    context,
+                },
+            });
+            log.info('Invoke sent', {
+                invocationId,
+                nodeId,
+                tool,
+                sessionId: options?.sessionId ?? options?.turnId ?? `node:${nodeId}`,
+            });
+        });
+    }
+    emergencyStopAll() {
+        for (const [nodeId, node] of this.nodes) {
+            this.sendEnvelope(node, 'transport.emergency-stop', {
+                sessionId: 'gateway',
+                source: 'gateway',
+                payload: { reason: 'gateway emergency stop' },
+            });
+            log.warn('Emergency stop sent to node', { nodeId });
+        }
+    }
+    listNodes() {
+        return Array.from(this.nodes.values()).map((n) => ({ ...n.info }));
+    }
+    getNode(nodeId) {
+        return this.nodes.get(nodeId)?.info;
+    }
+    getGatewayId() {
+        return this.gatewayId;
+    }
+    getPort() {
+        return this.config.port;
+    }
+    createServerEnvelope(eventType, options) {
+        const bus = new SessionBusState(null);
+        return bus.createEnvelope({
+            eventType,
+            senderId: this.gatewayId,
+            instanceId: this.config.instanceId,
+            sessionId: options.sessionId,
+            conversationId: options.conversationId,
+            source: options.source,
+            payload: options.payload,
+            resumeFromSequence: options.resumeFromSequence,
+        });
+    }
+    handleFrame(nodeId, frame) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        const shouldProcess = node.bus.markReceived(frame);
+        if (frame.eventType !== 'transport.ack') {
+            this.sendEnvelope(node, 'transport.ack', {
+                sessionId: frame.sessionId,
+                conversationId: frame.conversationId,
+                source: 'gateway',
+                payload: { message: 'ack' },
+            });
+        }
+        if (!shouldProcess)
+            return;
+        switch (frame.eventType) {
+            case 'invoke.result': {
+                const pending = this.pendingInvocations.get(frame.payload.invocationId);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    this.pendingInvocations.delete(frame.payload.invocationId);
+                    if (frame.payload.result.isError) {
+                        pending.reject(new Error(frame.payload.result.output));
+                    }
+                    else {
+                        pending.resolve(frame.payload.result);
+                    }
+                    log.info('Invoke result received', {
+                        invocationId: frame.payload.invocationId,
+                        nodeId,
+                        isError: frame.payload.result.isError,
+                    });
+                }
+                this.onEnvelope?.(nodeId, frame);
+                break;
+            }
+            case 'tool.started':
+            case 'tool.finished':
+            case 'node.status':
+                if (frame.eventType === 'node.status') {
+                    node.info.lastPingAt = Date.now();
+                    node.info.status = 'connected';
+                }
+                this.onEnvelope?.(nodeId, frame);
+                break;
+            case 'transport.pong':
+                node.info.lastPingAt = Date.now();
+                node.info.status = 'connected';
+                break;
+            case 'transport.disconnect':
+                this.handleNodeDisconnect(nodeId, frame.payload.reason);
+                break;
+            default:
+                log.warn('Unexpected frame from node', { nodeId, eventType: frame.eventType });
+        }
+    }
+    handleNodeDisconnect(nodeId, reason) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        const capabilities = [...node.info.capabilities];
+        node.info.status = 'disconnected';
+        this.nodes.delete(nodeId);
+        log.info('Node disconnected', { nodeId, reason });
+        this.onNodeDisconnected?.(nodeId, reason, capabilities);
+    }
+    startPingLoop() {
+        this.pingTimer = setInterval(() => {
+            const now = Date.now();
+            const staleThreshold = this.config.pingIntervalMs * 3;
+            const disconnectThreshold = this.config.pingIntervalMs * 6;
+            for (const [nodeId, node] of this.nodes) {
+                const elapsed = now - node.info.lastPingAt;
+                if (elapsed > disconnectThreshold) {
+                    log.warn('Node timed out', { nodeId, elapsedMs: elapsed });
+                    this.handleNodeDisconnect(nodeId, 'ping timeout');
+                    node.ws.close();
+                    continue;
+                }
+                if (elapsed > staleThreshold) {
+                    node.info.status = 'stale';
+                }
+                this.sendEnvelope(node, 'transport.ping', {
+                    sessionId: 'gateway',
+                    source: 'gateway',
+                    payload: { sentAt: Date.now() },
+                });
+            }
+        }, this.config.pingIntervalMs);
+    }
+    sendEnvelope(node, eventType, options) {
+        const envelope = node.bus.createEnvelope({
+            eventType,
+            senderId: this.gatewayId,
+            instanceId: this.config.instanceId,
+            sessionId: options.sessionId,
+            conversationId: options.conversationId,
+            source: options.source,
+            payload: options.payload,
+            resumeFromSequence: options.resumeFromSequence,
+        });
+        this.sendRaw(node.ws, envelope);
+        return envelope;
+    }
+    sendRaw(ws, frame) {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify(frame));
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session-bus.d.ts

@@ -0,0 +1,27 @@
+import type { AnyGatewayFrame, GatewayFrame, SessionBusEnvelopeMap, SessionBusEventType } from './types.js';
+export declare const TRANSPORT_PROTOCOL_VERSION = 1;
+export declare function buildBusStatePath(stateDir: string | undefined, prefix: string, id: string): string | null;
+export declare class SessionBusState {
+    private state;
+    private readonly statePath;
+    private readonly seenEnvelopeIds;
+    constructor(statePath: string | null);
+    getHighestReceivedSequence(): number;
+    getResumeSequence(): number;
+    markConnected(frame: AnyGatewayFrame): void;
+    createEnvelope<K extends SessionBusEventType>(base: {
+        eventType: K;
+        senderId: string;
+        sessionId: string;
+        conversationId?: string;
+        source: GatewayFrame<K>['source'];
+        instanceId?: string;
+        payload: SessionBusEnvelopeMap[K];
+        resumeFromSequence?: number;
+    }): GatewayFrame<K>;
+    markReceived(frame: AnyGatewayFrame): boolean;
+    ackThrough(sequence: number): void;
+    replayAfter(sequence: number): AnyGatewayFrame[];
+    private persist;
+}
+//# sourceMappingURL=session-bus.d.ts.map

package/dist/session-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bus.d.ts","sourceRoot":"","sources":["../src/session-bus.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAkC5C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzG;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;gBAEzC,SAAS,EAAE,MAAM,GAAG,IAAI;IAapC,0BAA0B,IAAI,MAAM;IAIpC,iBAAiB,IAAI,MAAM;IAI3B,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAW3C,cAAc,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE;QAClD,SAAS,EAAE,CAAC,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,GAAG,YAAY,CAAC,CAAC,CAAC;IA6BnB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAqB7C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMlC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAIhD,OAAO,CAAC,OAAO;CAIhB"}

package/dist/session-bus.js

@@ -0,0 +1,127 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { basename, join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { ensureDir, readJsonFile, writeJsonFileAtomic, } from '@producible/cereworker-core';
+export const TRANSPORT_PROTOCOL_VERSION = 1;
+const DEFAULT_STATE = {
+    nextSequence: 1,
+    highestReceivedSequence: 0,
+    outbound: [],
+};
+const MAX_OUTBOUND_ENVELOPES = 500;
+function shouldPersistOutgoing(eventType) {
+    return ![
+        'transport.connect',
+        'transport.connected',
+        'transport.ack',
+        'transport.ping',
+        'transport.pong',
+    ].includes(eventType);
+}
+function expandHome(path) {
+    return resolve(path.replace(/^~(?=\/|$)/, homedir()));
+}
+function sanitizeSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, '-');
+}
+export function buildBusStatePath(stateDir, prefix, id) {
+    if (!stateDir)
+        return null;
+    const dir = expandHome(stateDir);
+    ensureDir(dir);
+    const digest = createHash('sha1').update(id).digest('hex').slice(0, 12);
+    return join(dir, `${sanitizeSegment(prefix)}-${sanitizeSegment(basename(id) || prefix)}-${digest}.json`);
+}
+export class SessionBusState {
+    state = { ...DEFAULT_STATE };
+    statePath;
+    seenEnvelopeIds = new Set();
+    constructor(statePath) {
+        this.statePath = statePath;
+        if (!statePath)
+            return;
+        const parsed = readJsonFile(statePath, null);
+        if (parsed) {
+            this.state = {
+                nextSequence: parsed.nextSequence || 1,
+                highestReceivedSequence: parsed.highestReceivedSequence || 0,
+                outbound: Array.isArray(parsed.outbound) ? parsed.outbound : [],
+            };
+        }
+    }
+    getHighestReceivedSequence() {
+        return this.state.highestReceivedSequence;
+    }
+    getResumeSequence() {
+        return this.state.highestReceivedSequence;
+    }
+    markConnected(frame) {
+        if (typeof frame.ackedThrough === 'number') {
+            this.ackThrough(frame.ackedThrough);
+        }
+        this.seenEnvelopeIds.clear();
+        if (typeof frame.sequence === 'number') {
+            this.state.highestReceivedSequence = frame.sequence;
+        }
+        this.persist();
+    }
+    createEnvelope(base) {
+        const envelope = {
+            envelopeId: randomUUID(),
+            protocolVersion: TRANSPORT_PROTOCOL_VERSION,
+            senderId: base.senderId,
+            instanceId: base.instanceId,
+            sessionId: base.sessionId,
+            conversationId: base.conversationId,
+            source: base.source,
+            eventType: base.eventType,
+            timestamp: Date.now(),
+            payload: base.payload,
+            sequence: this.state.nextSequence++,
+            ackedThrough: this.state.highestReceivedSequence,
+            ...(base.resumeFromSequence !== undefined
+                ? { resumeFromSequence: base.resumeFromSequence }
+                : {}),
+        };
+        if (shouldPersistOutgoing(base.eventType)) {
+            this.state.outbound.push(envelope);
+            if (this.state.outbound.length > MAX_OUTBOUND_ENVELOPES) {
+                this.state.outbound = this.state.outbound.slice(-MAX_OUTBOUND_ENVELOPES);
+            }
+        }
+        this.persist();
+        return envelope;
+    }
+    markReceived(frame) {
+        if (typeof frame.ackedThrough === 'number') {
+            this.ackThrough(frame.ackedThrough);
+        }
+        if (typeof frame.sequence !== 'number') {
+            this.persist();
+            return true;
+        }
+        if (this.seenEnvelopeIds.has(frame.envelopeId) || frame.sequence <= this.state.highestReceivedSequence) {
+            this.persist();
+            return false;
+        }
+        this.seenEnvelopeIds.add(frame.envelopeId);
+        this.state.highestReceivedSequence = Math.max(this.state.highestReceivedSequence, frame.sequence);
+        this.persist();
+        return true;
+    }
+    ackThrough(sequence) {
+        if (sequence <= 0)
+            return;
+        this.state.outbound = this.state.outbound.filter((frame) => (frame.sequence ?? 0) > sequence);
+        this.persist();
+    }
+    replayAfter(sequence) {
+        return this.state.outbound.filter((frame) => (frame.sequence ?? 0) > sequence);
+    }
+    persist() {
+        if (!this.statePath)
+            return;
+        writeJsonFileAtomic(this.statePath, this.state);
+    }
+}
+//# sourceMappingURL=session-bus.js.map

package/dist/session-bus.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+import type { ToolResult, TransportEnvelope } from '@producible/cereworker-core';
+export interface NodeStatus {
+    healthy: boolean;
+    uptime: number;
+    activeTools: number;
+    autoMode: boolean;
+}
+export interface SessionInvokeContext {
+    callId?: string;
+    requestedToolName?: string;
+    turnId?: string;
+    attempt?: number;
+    scopeKey?: string;
+}
+export interface SessionBusEnvelopeMap {
+    'transport.connect': {
+        nodeId: string;
+        token: string;
+        capabilities: string[];
+    };
+    'transport.connected': {
+        gatewayId: string;
+    };
+    'transport.error': {
+        message: string;
+    };
+    'transport.ack': {
+        message?: string;
+    };
+    'transport.ping': {
+        sentAt?: number;
+    };
+    'transport.pong': {
+        sentAt?: number;
+    };
+    'transport.disconnect': {
+        reason: string;
+    };
+    'transport.emergency-stop': {
+        reason?: string;
+    };
+    'node.status.request': {
+        requestId: string;
+    };
+    'node.status': {
+        requestId?: string;
+        status: NodeStatus;
+    };
+    'invoke.request': {
+        invocationId: string;
+        tool: string;
+        args: Record<string, unknown>;
+        context?: SessionInvokeContext;
+    };
+    'invoke.result': {
+        invocationId: string;
+        result: ToolResult;
+    };
+    'tool.started': {
+        invocationId: string;
+        tool: string;
+        args: Record<string, unknown>;
+        context?: SessionInvokeContext;
+        nodeId?: string;
+    };
+    'tool.finished': {
+        invocationId: string;
+        tool: string;
+        args: Record<string, unknown>;
+        result: ToolResult;
+        context?: SessionInvokeContext;
+        nodeId?: string;
+    };
+}
+export type SessionBusEventType = keyof SessionBusEnvelopeMap;
+export type GatewayFrame<K extends SessionBusEventType = SessionBusEventType> = TransportEnvelope<SessionBusEnvelopeMap[K]> & {
+    eventType: K;
+};
+export type AnyGatewayFrame = {
+    [K in SessionBusEventType]: GatewayFrame<K>;
+}[SessionBusEventType];
+export interface NodeInfo {
+    nodeId: string;
+    capabilities: string[];
+    connectedAt: number;
+    lastPingAt: number;
+    status: 'connected' | 'stale' | 'disconnected';
+}
+export interface GatewayServerConfig {
+    port: number;
+    token?: string;
+    invokeTimeoutMs: number;
+    pingIntervalMs: number;
+    stateDir?: string;
+    instanceId?: string;
+}
+export interface GatewayClientConfig {
+    gatewayUrl: string;
+    nodeId: string;
+    token: string;
+    capabilities: string[];
+    stateDir?: string;
+    instanceId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@producible/cereworker-gateway",
+  "version": "26.520.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Producible/CereWorker.git",
+    "directory": "packages/gateway"
+  },
+  "dependencies": {
+    "nanoid": "^5.0.9",
+    "ws": "^8.18.0",
+    "@producible/cereworker-core": "26.520.1"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.14",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}