@miriad-systems/backend 0.1.0

package/dist/runtime-client.js

@@ -0,0 +1,347 @@
+/**
+ * Runtime Client
+ *
+ * Manages the WebSocket connection to the CAST backend.
+ * Handles the LocalRuntime protocol: authentication, message routing,
+ * and agent lifecycle coordination.
+ */
+import WebSocket from 'ws';
+import { AgentManager } from './agent-manager.js';
+import { getMachineInfo } from './config.js';
+// =============================================================================
+// Runtime Client
+// =============================================================================
+export class RuntimeClient {
+    runtimeConfig;
+    agentManager;
+    ws = null;
+    status = 'disconnected';
+    reconnectAttempts = 0;
+    reconnectTimeout = null;
+    heartbeatInterval = null;
+    /** Heartbeat interval in milliseconds (30 seconds) */
+    static HEARTBEAT_INTERVAL_MS = 30000;
+    onConnected;
+    onDisconnected;
+    onError;
+    constructor(config) {
+        this.runtimeConfig = config.config;
+        this.onConnected = config.onConnected;
+        this.onDisconnected = config.onDisconnected;
+        this.onError = config.onError;
+        // Create agent manager
+        this.agentManager = new AgentManager({
+            workspaceBasePath: this.runtimeConfig.workspace.basePath,
+            onFrame: (message) => this.sendFrame(message),
+            onCheckin: (agentId) => this.sendCheckin(agentId),
+            onError: (agentId, error) => {
+                console.error(`[RuntimeClient] Agent ${agentId} error:`, error);
+            },
+        });
+    }
+    /**
+     * Get current runtime status.
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * Get agent manager for status queries.
+     */
+    getAgentManager() {
+        return this.agentManager;
+    }
+    /**
+     * Connect to the backend.
+     */
+    async connect() {
+        if (this.ws) {
+            console.log('[RuntimeClient] Already connected');
+            return;
+        }
+        this.status = 'connecting';
+        const { credentials } = this.runtimeConfig;
+        // Use query param for protocol - works with both local dev and AWS Lambda
+        // (API Gateway doesn't have /runtimes/connect route, uses $connect with query param)
+        const url = `${credentials.wsUrl}?protocol=runtime`;
+        console.log(`[RuntimeClient] Connecting to ${url}`);
+        return new Promise((resolve, reject) => {
+            this.ws = new WebSocket(url, {
+                headers: {
+                    Authorization: `Server ${credentials.secret}`,
+                },
+            });
+            this.ws.on('open', () => {
+                console.log('[RuntimeClient] Connected');
+                this.status = 'connected';
+                this.reconnectAttempts = 0;
+                this.sendRuntimeReady();
+                resolve();
+            });
+            this.ws.on('message', (data) => {
+                this.handleMessage(data.toString());
+            });
+            this.ws.on('close', (code, reason) => {
+                console.log(`[RuntimeClient] Disconnected: ${code} ${reason.toString()}`);
+                this.status = 'disconnected';
+                this.ws = null;
+                this.stopHeartbeatInterval();
+                this.onDisconnected?.(code, reason.toString());
+                this.scheduleReconnect();
+            });
+            this.ws.on('error', (error) => {
+                // Log connection errors cleanly without full stack traces
+                const errorMsg = this.formatConnectionError(error);
+                if (errorMsg) {
+                    console.error(`[RuntimeClient] ${errorMsg}`);
+                }
+                else {
+                    console.error('[RuntimeClient] WebSocket error:', error);
+                }
+                this.onError?.(error);
+                if (this.status === 'connecting') {
+                    reject(error);
+                }
+            });
+        });
+    }
+    /**
+     * Disconnect from the backend.
+     */
+    async disconnect() {
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = null;
+        }
+        // Stop heartbeat interval
+        this.stopHeartbeatInterval();
+        // Suspend all agents
+        await this.agentManager.suspendAll();
+        if (this.ws) {
+            this.ws.close(1000, 'Client disconnect');
+            this.ws = null;
+        }
+        this.status = 'disconnected';
+    }
+    // ===========================================================================
+    // Message Handling
+    // ===========================================================================
+    handleMessage(data) {
+        let message;
+        try {
+            message = JSON.parse(data);
+        }
+        catch {
+            console.error('[RuntimeClient] Invalid JSON:', data);
+            return;
+        }
+        switch (message.type) {
+            case 'runtime_connected':
+                console.log(`[RuntimeClient] Runtime connected: ${message.runtimeId} (protocol ${message.protocolVersion})`);
+                this.status = 'ready';
+                this.onConnected?.();
+                // Re-checkin all active agents on reconnect
+                // This ensures backend knows about agents that survived the disconnect
+                this.reCheckinActiveAgents();
+                // Start heartbeat interval for agent liveness
+                this.startHeartbeatInterval();
+                break;
+            case 'activate':
+                this.handleActivate(message);
+                break;
+            case 'message':
+                this.handleDeliverMessage(message);
+                break;
+            case 'suspend':
+                this.handleSuspend(message);
+                break;
+            case 'ping':
+                this.sendPong(message.timestamp);
+                break;
+            case 'error':
+                console.error(`[RuntimeClient] Backend error: ${message.code} - ${message.message}`);
+                break;
+            default:
+                console.log(`[RuntimeClient] Unknown message type: ${message.type}`);
+        }
+    }
+    async handleActivate(message) {
+        console.log(`[RuntimeClient] Activate agent: ${message.agentId}`);
+        await this.agentManager.activate(message);
+    }
+    async handleDeliverMessage(message) {
+        console.log(`[RuntimeClient] Message for agent: ${message.agentId}`);
+        await this.agentManager.deliverMessage(message);
+    }
+    async handleSuspend(message) {
+        console.log(`[RuntimeClient] Suspend agent: ${message.agentId}`);
+        await this.agentManager.suspend(message);
+    }
+    // ===========================================================================
+    // Outgoing Messages
+    // ===========================================================================
+    send(message) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+        else {
+            console.error('[RuntimeClient] Cannot send: WebSocket not open');
+        }
+    }
+    sendRuntimeReady() {
+        const { credentials, spaceId, name } = this.runtimeConfig;
+        const machineInfo = getMachineInfo();
+        const message = {
+            type: 'runtime_ready',
+            runtimeId: credentials.runtimeId,
+            spaceId,
+            name,
+            machineInfo,
+        };
+        console.log(`[RuntimeClient] Sending runtime_ready: ${name} (${credentials.runtimeId})`);
+        this.send(message);
+    }
+    sendCheckin(agentId) {
+        const message = {
+            type: 'agent_checkin',
+            agentId,
+        };
+        console.log(`[RuntimeClient] Agent checkin: ${agentId}`);
+        this.send(message);
+    }
+    sendFrame(frameMessage) {
+        this.send(frameMessage);
+    }
+    sendPong(timestamp) {
+        const message = {
+            type: 'pong',
+            timestamp,
+        };
+        this.send(message);
+    }
+    /**
+     * Re-checkin all active agents after reconnection.
+     * This notifies the backend about agents that survived the disconnect.
+     */
+    reCheckinActiveAgents() {
+        const agents = this.agentManager.getAgents();
+        const activeAgents = agents.filter((a) => a.status !== 'offline');
+        if (activeAgents.length === 0) {
+            console.log('[RuntimeClient] No active agents to re-checkin');
+            return;
+        }
+        console.log(`[RuntimeClient] Re-checking in ${activeAgents.length} active agent(s)`);
+        for (const agent of activeAgents) {
+            this.sendCheckin(agent.agentId);
+        }
+    }
+    // ===========================================================================
+    // Heartbeat
+    // ===========================================================================
+    /**
+     * Start periodic heartbeat for all online agents.
+     */
+    startHeartbeatInterval() {
+        if (this.heartbeatInterval) {
+            return; // Already running
+        }
+        console.log(`[RuntimeClient] Starting heartbeat interval (${RuntimeClient.HEARTBEAT_INTERVAL_MS / 1000}s)`);
+        this.heartbeatInterval = setInterval(() => {
+            this.sendHeartbeats();
+        }, RuntimeClient.HEARTBEAT_INTERVAL_MS);
+    }
+    /**
+     * Stop the heartbeat interval.
+     */
+    stopHeartbeatInterval() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+            console.log('[RuntimeClient] Stopped heartbeat interval');
+        }
+    }
+    /**
+     * Send heartbeats for all online agents.
+     */
+    sendHeartbeats() {
+        const agents = this.agentManager.getAgents();
+        const onlineAgents = agents.filter((a) => a.status === 'online' || a.status === 'busy');
+        if (onlineAgents.length === 0) {
+            return; // No agents to heartbeat
+        }
+        for (const agent of onlineAgents) {
+            const message = {
+                type: 'agent_heartbeat',
+                agentId: agent.agentId,
+            };
+            this.send(message);
+        }
+    }
+    // ===========================================================================
+    // Error Formatting
+    // ===========================================================================
+    /**
+     * Format common connection errors into clean single-line messages.
+     * Returns null for unexpected errors that should show full stack trace.
+     */
+    formatConnectionError(error) {
+        const message = error.message || '';
+        const code = error.code;
+        // Handle AggregateError (multiple connection attempts failed)
+        if (error.name === 'AggregateError' && 'errors' in error) {
+            const aggError = error;
+            if (aggError.errors.length > 0) {
+                const firstError = aggError.errors[0];
+                if (firstError.code === 'ECONNREFUSED') {
+                    return 'Connection refused - server unavailable';
+                }
+                if (firstError.code === 'ETIMEDOUT') {
+                    return 'Connection timed out';
+                }
+            }
+        }
+        // Handle direct error codes
+        if (code === 'ECONNREFUSED') {
+            return 'Connection refused - server unavailable';
+        }
+        if (code === 'ETIMEDOUT') {
+            return 'Connection timed out';
+        }
+        if (code === 'ENOTFOUND') {
+            return 'Server not found - check URL';
+        }
+        if (code === 'ECONNRESET') {
+            return 'Connection reset by server';
+        }
+        // Check message patterns
+        if (message.includes('ECONNREFUSED')) {
+            return 'Connection refused - server unavailable';
+        }
+        if (message.includes('ETIMEDOUT')) {
+            return 'Connection timed out';
+        }
+        return null;
+    }
+    // ===========================================================================
+    // Reconnection
+    // ===========================================================================
+    scheduleReconnect() {
+        if (this.reconnectTimeout)
+            return;
+        // Exponential backoff: 1s, 2s, 4s, 8s, 16s, max 30s
+        const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), 30000);
+        this.reconnectAttempts++;
+        console.log(`[RuntimeClient] Reconnecting in ${delay / 1000}s (attempt ${this.reconnectAttempts})`);
+        this.reconnectTimeout = setTimeout(async () => {
+            this.reconnectTimeout = null;
+            try {
+                await this.connect();
+            }
+            catch {
+                // Error already logged by WebSocket error handler
+                // Will be scheduled again by close handler
+            }
+        }, delay);
+    }
+}
+//# sourceMappingURL=runtime-client.js.map

package/dist/runtime-client.js.map

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

package/dist/tymbal-bridge.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Tymbal Bridge for Local Runtime
+ *
+ * Translates Claude Agent SDK messages to Tymbal protocol frames
+ * and sends them to the backend via the runtime's WS connection.
+ *
+ * Adapted from local-agent-engine for multi-agent support:
+ * - Frames are wrapped with agentId for routing
+ * - Uses callback instead of direct WS send (runtime manages connection)
+ */
+import type { SDKMessage } from '@anthropic-ai/claude-agent-sdk';
+import type { AgentFrameMessage } from './types.js';
+export interface TymbalBridgeConfig {
+    /** Agent ID ({spaceId}:{channelId}:{callsign}) */
+    agentId: string;
+    /** Agent callsign for frame sender attribution */
+    callsign: string;
+    /** Callback to send frames to runtime */
+    onFrame: (message: AgentFrameMessage) => void;
+}
+export declare class TymbalBridge {
+    private readonly agentId;
+    private readonly callsign;
+    private readonly onFrame;
+    private sessionId;
+    private currentAssistantMsgId;
+    private assistantContent;
+    private startFrameEmitted;
+    constructor(config: TymbalBridgeConfig);
+    getSessionId(): string | null;
+    getCallsign(): string;
+    /**
+     * Process an SDK message and emit appropriate Tymbal frames.
+     */
+    processSDKMessage(message: SDKMessage): Promise<void>;
+    private handleSystem;
+    private handlePartialAssistant;
+    private handleAssistant;
+    private handleUser;
+    private handleResult;
+    finalize(): Promise<void>;
+    /**
+     * Emit a frame wrapped with agentId for routing.
+     */
+    private emitFrame;
+}
+//# sourceMappingURL=tymbal-bridge.d.ts.map

package/dist/tymbal-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tymbal-bridge.d.ts","sourceRoot":"","sources":["../src/tymbal-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,UAAU,EAMX,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAA0C,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA6B5F,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC/C;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAG/D,OAAO,CAAC,SAAS,CAAuB;IAGxC,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,iBAAiB,CAAkB;gBAE/B,MAAM,EAAE,kBAAkB;IAMtC,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YA+B7C,YAAY;YAOZ,sBAAsB;YA2BtB,eAAe;YA0Df,UAAU;YA2CV,YAAY;IAwFpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B;;OAEG;YACW,SAAS;CASxB"}