@miriad-systems/backend 0.1.0

package/dist/tymbal-bridge.js

@@ -0,0 +1,283 @@
+/**
+ * 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 { generateId } from './config.js';
+export class TymbalBridge {
+    agentId;
+    callsign;
+    onFrame;
+    // Session state
+    sessionId = null;
+    // Current message tracking
+    currentAssistantMsgId = null;
+    assistantContent = '';
+    startFrameEmitted = false;
+    constructor(config) {
+        this.agentId = config.agentId;
+        this.callsign = config.callsign;
+        this.onFrame = config.onFrame;
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+    getCallsign() {
+        return this.callsign;
+    }
+    /**
+     * Process an SDK message and emit appropriate Tymbal frames.
+     */
+    async processSDKMessage(message) {
+        switch (message.type) {
+            case 'system':
+                await this.handleSystem(message);
+                break;
+            case 'assistant':
+                await this.handleAssistant(message);
+                break;
+            case 'stream_event':
+                await this.handlePartialAssistant(message);
+                break;
+            case 'user':
+                await this.handleUser(message);
+                break;
+            case 'result':
+                await this.handleResult(message);
+                break;
+            case 'tool_progress':
+                // Tool progress events (future use)
+                break;
+            default:
+                console.log(`[TymbalBridge] Unhandled message type: ${message.type}`);
+        }
+    }
+    async handleSystem(message) {
+        if (message.subtype === 'init') {
+            this.sessionId = message.session_id;
+            console.log(`[TymbalBridge:${this.callsign}] Session initialized: ${this.sessionId}`);
+        }
+    }
+    async handlePartialAssistant(message) {
+        const event = message.event;
+        if (event.type === 'content_block_start') {
+            if (!this.currentAssistantMsgId) {
+                this.currentAssistantMsgId = generateId();
+                this.assistantContent = '';
+                this.startFrameEmitted = false;
+            }
+            if (!this.startFrameEmitted) {
+                await this.emitFrame({
+                    i: this.currentAssistantMsgId,
+                    m: { type: 'agent', sender: this.callsign, senderType: 'agent' },
+                });
+                this.startFrameEmitted = true;
+            }
+        }
+        if (event.type === 'content_block_delta') {
+            const delta = event.delta;
+            if (delta && 'type' in delta && delta.type === 'text_delta' && 'text' in delta) {
+                this.assistantContent += delta.text;
+            }
+        }
+    }
+    async handleAssistant(message) {
+        const content = message.message.content;
+        if (!content)
+            return;
+        let textContent = '';
+        const toolUseBlocks = [];
+        for (const block of content) {
+            if (block.type === 'text' && 'text' in block) {
+                textContent += block.text;
+            }
+            else if (block.type === 'tool_use' && 'id' in block && 'name' in block) {
+                toolUseBlocks.push(block);
+            }
+        }
+        if (textContent) {
+            const msgId = this.currentAssistantMsgId ?? generateId();
+            if (!this.startFrameEmitted) {
+                await this.emitFrame({
+                    i: msgId,
+                    m: { type: 'agent', sender: this.callsign, senderType: 'agent' },
+                });
+            }
+            await this.emitFrame({
+                i: msgId,
+                t: new Date().toISOString(),
+                v: {
+                    type: 'agent',
+                    sender: this.callsign,
+                    senderType: 'agent',
+                    content: textContent,
+                },
+            });
+            this.currentAssistantMsgId = null;
+            this.assistantContent = '';
+            this.startFrameEmitted = false;
+        }
+        for (const toolBlock of toolUseBlocks) {
+            const toolCallId = generateId();
+            await this.emitFrame({
+                i: toolCallId,
+                t: new Date().toISOString(),
+                v: {
+                    type: 'tool_call',
+                    sender: this.callsign,
+                    senderType: 'agent',
+                    toolCallId: toolBlock.id,
+                    name: toolBlock.name,
+                    args: toolBlock.input,
+                },
+            });
+        }
+    }
+    async handleUser(message) {
+        const apiMessage = message.message;
+        const content = apiMessage.content;
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            if (typeof block === 'object' && block !== null && 'type' in block) {
+                const typedBlock = block;
+                if (typedBlock.type === 'tool_result' && 'tool_use_id' in typedBlock) {
+                    const resultBlock = typedBlock;
+                    const resultId = generateId();
+                    const isError = resultBlock.is_error ?? false;
+                    let resultContent = resultBlock.content;
+                    if (Array.isArray(resultContent)) {
+                        resultContent = resultContent
+                            .filter((item) => typeof item === 'object' && item !== null && item.type === 'text')
+                            .map((item) => item.text)
+                            .join('\n');
+                    }
+                    await this.emitFrame({
+                        i: resultId,
+                        t: new Date().toISOString(),
+                        v: {
+                            type: 'tool_result',
+                            sender: this.callsign,
+                            senderType: 'agent',
+                            toolCallId: resultBlock.tool_use_id,
+                            content: resultContent,
+                            isError,
+                        },
+                    });
+                }
+            }
+        }
+    }
+    async handleResult(message) {
+        // Finalize pending assistant message
+        if (this.currentAssistantMsgId && this.assistantContent) {
+            await this.emitFrame({
+                i: this.currentAssistantMsgId,
+                t: new Date().toISOString(),
+                v: {
+                    type: 'agent',
+                    sender: this.callsign,
+                    senderType: 'agent',
+                    content: this.assistantContent,
+                },
+            });
+            this.currentAssistantMsgId = null;
+            this.assistantContent = '';
+            this.startFrameEmitted = false;
+        }
+        // Check for errors
+        if (message.subtype !== 'success') {
+            const errorMsg = message;
+            const errorMessage = errorMsg.errors?.join(', ') ?? `Error: ${message.subtype}`;
+            await this.emitFrame({
+                i: generateId(),
+                t: new Date().toISOString(),
+                v: {
+                    type: 'error',
+                    sender: this.callsign,
+                    senderType: 'agent',
+                    content: errorMessage,
+                },
+            });
+        }
+        // Emit cost frame
+        const costValue = {
+            type: 'cost',
+            sender: this.callsign,
+            senderType: 'agent',
+            totalCostUsd: message.total_cost_usd,
+            durationMs: message.duration_ms,
+            durationApiMs: message.duration_api_ms,
+            numTurns: message.num_turns,
+            usage: {
+                inputTokens: message.usage.input_tokens,
+                outputTokens: message.usage.output_tokens,
+                cacheReadInputTokens: message.usage.cache_read_input_tokens ?? 0,
+                cacheCreationInputTokens: message.usage.cache_creation_input_tokens ?? 0,
+            },
+        };
+        if (message.modelUsage && Object.keys(message.modelUsage).length > 0) {
+            const modelUsage = {};
+            for (const [model, usage] of Object.entries(message.modelUsage)) {
+                modelUsage[model] = {
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                    cacheReadInputTokens: usage.cacheReadInputTokens,
+                    cacheCreationInputTokens: usage.cacheCreationInputTokens,
+                    costUsd: usage.costUSD,
+                };
+            }
+            costValue.modelUsage = modelUsage;
+        }
+        await this.emitFrame({
+            i: generateId(),
+            t: new Date().toISOString(),
+            v: costValue,
+        });
+        console.log(`[TymbalBridge:${this.callsign}] Cost: $${message.total_cost_usd.toFixed(4)} (${message.num_turns} turns)`);
+        // Emit idle frame (signals processing complete)
+        await this.emitFrame({
+            i: generateId(),
+            t: new Date().toISOString(),
+            v: {
+                type: 'idle',
+                sender: this.callsign,
+                senderType: 'agent',
+            },
+        });
+    }
+    async finalize() {
+        if (this.currentAssistantMsgId && this.assistantContent) {
+            await this.emitFrame({
+                i: this.currentAssistantMsgId,
+                t: new Date().toISOString(),
+                v: {
+                    type: 'agent',
+                    sender: this.callsign,
+                    senderType: 'agent',
+                    content: this.assistantContent,
+                },
+            });
+            this.currentAssistantMsgId = null;
+            this.assistantContent = '';
+            this.startFrameEmitted = false;
+        }
+    }
+    /**
+     * Emit a frame wrapped with agentId for routing.
+     */
+    async emitFrame(frame) {
+        const message = {
+            type: 'frame',
+            agentId: this.agentId,
+            frame,
+        };
+        this.onFrame(message);
+    }
+}
+//# sourceMappingURL=tymbal-bridge.js.map

package/dist/tymbal-bridge.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Protocol types for LocalRuntime WebSocket communication.
+ * Aligned with backend RuntimeConnectionManager protocol (spec section 2.2)
+ */
+export interface RuntimeConnectedMessage {
+    type: 'runtime_connected';
+    runtimeId: string;
+    protocolVersion: string;
+}
+export interface ActivateAgentMessage {
+    type: 'activate';
+    agentId: string;
+    systemPrompt: string;
+    mcpServers?: McpServerConfig[];
+    workspacePath: string;
+}
+export interface DeliverMessageMessage {
+    type: 'message';
+    agentId: string;
+    messageId: string;
+    content: string;
+    sender: string;
+    systemPrompt?: string;
+    mcpServers?: McpServerConfig[];
+}
+export interface SuspendAgentMessage {
+    type: 'suspend';
+    agentId: string;
+    reason?: string;
+}
+export interface PingMessage {
+    type: 'ping';
+    timestamp: string;
+}
+export interface ErrorMessage {
+    type: 'error';
+    code: string;
+    message: string;
+}
+export type BackendToRuntimeMessage = RuntimeConnectedMessage | ActivateAgentMessage | DeliverMessageMessage | SuspendAgentMessage | PingMessage | ErrorMessage;
+export interface RuntimeReadyMessage {
+    type: 'runtime_ready';
+    runtimeId: string;
+    spaceId: string;
+    name: string;
+    machineInfo?: {
+        os: string;
+        hostname: string;
+    };
+}
+export interface AgentCheckinMessage {
+    type: 'agent_checkin';
+    agentId: string;
+}
+export interface AgentHeartbeatMessage {
+    type: 'agent_heartbeat';
+    agentId: string;
+}
+export interface AgentFrameMessage {
+    type: 'frame';
+    agentId: string;
+    frame: TymbalFrame;
+}
+export interface PongMessage {
+    type: 'pong';
+    timestamp: string;
+}
+export type RuntimeToBackendMessage = RuntimeReadyMessage | AgentCheckinMessage | AgentHeartbeatMessage | AgentFrameMessage | PongMessage;
+export interface McpServerConfig {
+    name: string;
+    slug?: string;
+    transport: 'stdio' | 'sse' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+}
+export interface TymbalFrame {
+    i: string;
+    t?: string;
+    m?: TymbalMetadata;
+    a?: string;
+    v?: TymbalValue;
+}
+export interface TymbalMetadata {
+    type: TymbalValueType;
+    sender: string;
+    senderType: 'agent';
+}
+export type TymbalValueType = 'agent' | 'tool_call' | 'tool_result' | 'error' | 'idle' | 'cost' | 'status';
+interface TymbalValueBase {
+    type: TymbalValueType;
+    sender: string;
+    senderType: 'agent';
+}
+export interface AgentValue extends TymbalValueBase {
+    type: 'agent';
+    content: string;
+}
+export interface ToolCallValue extends TymbalValueBase {
+    type: 'tool_call';
+    toolCallId: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface ToolResultValue extends TymbalValueBase {
+    type: 'tool_result';
+    toolCallId: string;
+    content: unknown;
+    isError: boolean;
+}
+export interface ErrorValue extends TymbalValueBase {
+    type: 'error';
+    content: string;
+}
+export interface IdleValue extends TymbalValueBase {
+    type: 'idle';
+}
+export interface CostUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+}
+export interface CostModelUsage extends CostUsage {
+    costUsd: number;
+}
+export interface CostValue extends TymbalValueBase {
+    type: 'cost';
+    totalCostUsd: number;
+    durationMs: number;
+    durationApiMs: number;
+    numTurns: number;
+    usage: CostUsage;
+    modelUsage?: Record<string, CostModelUsage>;
+}
+export type TymbalValue = AgentValue | ToolCallValue | ToolResultValue | ErrorValue | IdleValue | CostValue;
+/** Runtime config stored in ~/.config/miriad/config.json */
+export interface RuntimeConfig {
+    spaceId: string;
+    name: string;
+    credentials: {
+        runtimeId: string;
+        serverId: string;
+        secret: string;
+        apiUrl: string;
+        wsUrl: string;
+    };
+    workspace: {
+        basePath: string;
+    };
+    createdAt: string;
+}
+/** Bootstrap exchange response */
+export interface BootstrapResponse {
+    serverId: string;
+    secret: string;
+    spaceId: string;
+    host: string;
+    wsHost: string;
+}
+/** Parsed connection string */
+export interface ParsedConnectionString {
+    host: string;
+    bootstrapToken: string;
+    spaceId: string;
+}
+export type AgentStatus = 'activating' | 'online' | 'busy' | 'offline' | 'error';
+export interface AgentState {
+    agentId: string;
+    status: AgentStatus;
+    workspacePath: string;
+    systemPrompt: string;
+    mcpServers?: McpServerConfig[];
+    activatedAt: string;
+    lastActivity: string;
+}
+export {};
+//# 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,6 @@
+/**
+ * Protocol types for LocalRuntime WebSocket communication.
+ * Aligned with backend RuntimeConnectionManager protocol (spec section 2.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":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@miriad-systems/backend",
+  "version": "0.1.0",
+  "description": "Run CAST agents on your local machine",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": "./dist/cli.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "cast",
+    "claude",
+    "agent",
+    "local",
+    "runtime"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.76",
+    "ulid": "^2.3.0",
+    "ws": "^8.16.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/ws": "^8.5.10",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit"
+  }
+}