@miriad-systems/backend 0.1.0

package/dist/cli.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+/**
+ * Local Runtime CLI
+ *
+ * Run CAST agents on your local machine.
+ *
+ * Commands:
+ *   auth <connection-string>  - Authenticate with CAST
+ *   start [--name <name>]     - Start the runtime
+ *   status                    - Show runtime status
+ *   agents                    - List active agents
+ */
+import { RuntimeClient } from './runtime-client.js';
+import { loadConfig, initFromConnectionString, getConfigPath, } from './config.js';
+// =============================================================================
+// Help Text
+// =============================================================================
+const HELP = `
+Miriad Backend - Run CAST agents on your local machine
+
+Usage:
+  npx @miriad-systems/backend auth <connection-string>   Authenticate with CAST
+  npx @miriad-systems/backend start [options]            Start the runtime
+  npx @miriad-systems/backend status                     Show runtime status
+  npx @miriad-systems/backend agents                     List active agents
+  npx @miriad-systems/backend help                       Show this help message
+
+Commands:
+  auth <connection-string>
+    Authenticate with CAST using a connection string from the UI.
+    Example: npx @miriad-systems/backend auth "cast://bst_xxx@api.cast.dev/space_abc"
+
+  start [--name <name>]
+    Start the runtime and connect to CAST.
+    Options:
+      --name <name>    Runtime name (default: hostname)
+
+  status
+    Show the runtime configuration and connection status.
+
+  agents
+    List all active agents on this runtime.
+
+Configuration:
+  Config is stored at: ~/.config/miriad/config.json
+
+Environment Variables:
+  ANTHROPIC_API_KEY    Required for Claude Agent SDK
+`;
+// =============================================================================
+// Commands
+// =============================================================================
+async function cmdAuth(args) {
+    const connectionString = args[0];
+    if (!connectionString) {
+        console.error('Error: Connection string required');
+        console.error('Usage: npx @miriad-systems/backend auth "cast://bst_xxx@api.cast.dev/space_abc"');
+        process.exit(1);
+    }
+    // Check for --name flag
+    let name;
+    const nameIdx = args.indexOf('--name');
+    if (nameIdx !== -1 && args[nameIdx + 1]) {
+        name = args[nameIdx + 1];
+    }
+    try {
+        await initFromConnectionString(connectionString, name);
+        console.log('\nAuthentication successful!');
+        console.log('Run "npx @miriad-systems/backend start" to connect.');
+    }
+    catch (error) {
+        console.error('Authentication failed:', error.message);
+        process.exit(1);
+    }
+}
+async function cmdStart(args) {
+    // Validate API key
+    if (!process.env.ANTHROPIC_API_KEY) {
+        console.error('Error: ANTHROPIC_API_KEY environment variable is required');
+        process.exit(1);
+    }
+    // Load config
+    const config = await loadConfig();
+    if (!config) {
+        console.error('Error: Not authenticated. Run "npx @miriad-systems/backend auth" first.');
+        process.exit(1);
+    }
+    // Check for --name flag to override
+    const nameIdx = args.indexOf('--name');
+    if (nameIdx !== -1 && args[nameIdx + 1]) {
+        config.name = args[nameIdx + 1];
+    }
+    console.log('Starting local runtime...');
+    console.log(`  Runtime: ${config.name} (${config.credentials.runtimeId})`);
+    console.log(`  Space: ${config.spaceId}`);
+    console.log(`  Workspace: ${config.workspace.basePath}`);
+    console.log();
+    // Create and connect runtime client
+    const client = new RuntimeClient({
+        config,
+        onConnected: () => {
+            console.log('Runtime ready. Waiting for agents...');
+        },
+        onDisconnected: (code, reason) => {
+            console.log(`Disconnected: ${code} ${reason}`);
+        },
+        onError: () => {
+            // Error already logged by RuntimeClient with clean formatting
+        },
+    });
+    // Handle shutdown signals
+    const shutdown = async () => {
+        console.log('\nShutting down...');
+        await client.disconnect();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    try {
+        await client.connect();
+        // Keep process alive
+        console.log('Press Ctrl+C to stop.');
+    }
+    catch {
+        // Error already logged by RuntimeClient
+        // Don't exit - let reconnection handle it
+    }
+}
+async function cmdStatus() {
+    const config = await loadConfig();
+    if (!config) {
+        console.log('Status: Not configured');
+        console.log(`Config file: ${getConfigPath()}`);
+        console.log('\nRun "npx @miriad-systems/backend auth" to configure.');
+        return;
+    }
+    console.log('Local Runtime Status');
+    console.log('====================');
+    console.log();
+    console.log(`Runtime ID:    ${config.credentials.runtimeId}`);
+    console.log(`Runtime Name:  ${config.name}`);
+    console.log(`Space:         ${config.spaceId}`);
+    console.log(`Server:        ${config.credentials.serverId}`);
+    console.log(`API URL:       ${config.credentials.apiUrl}`);
+    console.log(`WebSocket URL: ${config.credentials.wsUrl}`);
+    console.log(`Workspace:     ${config.workspace.basePath}`);
+    console.log(`Configured:    ${config.createdAt}`);
+    console.log();
+    console.log(`Config file: ${getConfigPath()}`);
+    console.log();
+    console.log('Note: To see active agents, start the runtime and check the UI.');
+}
+async function cmdAgents() {
+    const config = await loadConfig();
+    if (!config) {
+        console.error('Error: Not configured. Run "npx @miriad-systems/backend auth" first.');
+        process.exit(1);
+    }
+    console.log('Active Agents');
+    console.log('=============');
+    console.log();
+    console.log('Note: This command shows agents only when the runtime is running.');
+    console.log('Use "npx @miriad-systems/backend start" to start the runtime first.');
+    console.log();
+    console.log('To see agent status, check the CAST UI or runtime logs.');
+}
+function cmdHelp() {
+    console.log(HELP);
+}
+// =============================================================================
+// Main
+// =============================================================================
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (!command || command === 'help' || command === '--help' || command === '-h') {
+        cmdHelp();
+        process.exit(0);
+    }
+    switch (command) {
+        case 'auth':
+            await cmdAuth(args.slice(1));
+            break;
+        case 'start':
+            await cmdStart(args.slice(1));
+            break;
+        case 'status':
+            await cmdStatus();
+            break;
+        case 'agents':
+            await cmdAgents();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.error('Run "npx @miriad-systems/backend help" for usage.');
+            process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Configuration Module
+ *
+ * Handles reading/writing runtime config from ~/.config/miriad/config.json
+ * and API interactions for bootstrap exchange.
+ */
+import type { RuntimeConfig, BootstrapResponse, ParsedConnectionString } from './types.js';
+export declare function getApiProtocol(host: string): 'http' | 'https';
+export declare function getWsProtocol(host: string): 'ws' | 'wss';
+/**
+ * Parse a CAST connection string.
+ * Format: cast://<token>@<host>/<spaceId>
+ * Example: cast://bst_abc123@api.cast.dev/space_xyz
+ */
+export declare function parseConnectionString(connectionString: string): ParsedConnectionString;
+/**
+ * Load runtime config from disk.
+ * Returns null if no config file exists.
+ * Expands tilde (~) in workspace.basePath.
+ */
+export declare function loadConfig(): Promise<RuntimeConfig | null>;
+/**
+ * Save runtime config to disk.
+ */
+export declare function saveConfig(config: RuntimeConfig): Promise<void>;
+/**
+ * Delete stored config.
+ */
+export declare function deleteConfig(): Promise<void>;
+/**
+ * Get config file path (for display).
+ */
+export declare function getConfigPath(): string;
+/**
+ * Generate a ULID for message/frame IDs.
+ * Uses the standard ulid library which maintains monotonicity within the same
+ * millisecond (increments random portion instead of generating new random).
+ */
+export declare function generateId(): string;
+/**
+ * Generate a runtime ID (rt_ prefix).
+ * Uses ULID for the unique portion, truncated to fit VARCHAR(26) column.
+ * Format: rt_ (3 chars) + 23 char ULID fragment = 26 chars
+ */
+export declare function generateRuntimeId(): string;
+/**
+ * Exchange a bootstrap token for server credentials.
+ */
+export declare function exchangeBootstrapToken(host: string, bootstrapToken: string): Promise<BootstrapResponse>;
+/**
+ * Initialize runtime config from a connection string.
+ * Parses the string, exchanges the bootstrap token, generates runtimeId,
+ * and saves config.
+ */
+export declare function initFromConnectionString(connectionString: string, runtimeName?: string): Promise<RuntimeConfig>;
+export declare function getMachineInfo(): {
+    os: string;
+    hostname: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAyD3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAExD;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG,sBAAsB,CAWtF;AAMD;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAehE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAQlD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAwB5B;AAMD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,EAAE,MAAM,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CA0CxB;AAMD,wBAAgB,cAAc,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAKjE"}

package/dist/config.js

@@ -0,0 +1,221 @@
+/**
+ * Configuration Module
+ *
+ * Handles reading/writing runtime config from ~/.config/miriad/config.json
+ * and API interactions for bootstrap exchange.
+ */
+import { mkdir, readFile, writeFile, unlink } from 'node:fs/promises';
+import { homedir, hostname, platform } from 'node:os';
+import { dirname, join } from 'node:path';
+import { ulid } from 'ulid';
+// =============================================================================
+// Configuration Paths
+// =============================================================================
+const CONFIG_DIR = join(homedir(), '.config', 'miriad');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DEFAULT_WORKSPACE_BASE = '/tmp/cast-agents';
+/**
+ * Expand tilde (~) to home directory in paths.
+ */
+function expandTilde(path) {
+    if (path.startsWith('~/')) {
+        return join(homedir(), path.slice(2));
+    }
+    if (path === '~') {
+        return homedir();
+    }
+    return path;
+}
+function detectEnvironment(host) {
+    const hostLower = host.toLowerCase();
+    if (hostLower.includes('localhost') || hostLower.startsWith('127.')) {
+        return 'local';
+    }
+    if (hostLower.includes('staging')) {
+        return 'staging';
+    }
+    return 'production';
+}
+function getEnvironmentConfig(env) {
+    switch (env) {
+        case 'local':
+            return { apiProtocol: 'http', wsProtocol: 'ws' };
+        case 'staging':
+        case 'production':
+        default:
+            return { apiProtocol: 'https', wsProtocol: 'wss' };
+    }
+}
+export function getApiProtocol(host) {
+    return getEnvironmentConfig(detectEnvironment(host)).apiProtocol;
+}
+export function getWsProtocol(host) {
+    return getEnvironmentConfig(detectEnvironment(host)).wsProtocol;
+}
+// =============================================================================
+// Connection String Parsing
+// =============================================================================
+/**
+ * Parse a CAST connection string.
+ * Format: cast://<token>@<host>/<spaceId>
+ * Example: cast://bst_abc123@api.cast.dev/space_xyz
+ */
+export function parseConnectionString(connectionString) {
+    const match = connectionString.match(/^cast:\/\/([^@]+)@([^/]+)\/(.+)$/);
+    if (!match) {
+        throw new Error(`Invalid connection string format. Expected: cast://<token>@<host>/<spaceId>`);
+    }
+    const [, bootstrapToken, host, spaceId] = match;
+    return { host, bootstrapToken, spaceId };
+}
+// =============================================================================
+// Config Storage
+// =============================================================================
+/**
+ * Load runtime config from disk.
+ * Returns null if no config file exists.
+ * Expands tilde (~) in workspace.basePath.
+ */
+export async function loadConfig() {
+    try {
+        const content = await readFile(CONFIG_FILE, 'utf-8');
+        const config = JSON.parse(content);
+        // Expand tilde in workspace basePath
+        if (config.workspace?.basePath) {
+            config.workspace.basePath = expandTilde(config.workspace.basePath);
+        }
+        return config;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Save runtime config to disk.
+ */
+export async function saveConfig(config) {
+    await mkdir(dirname(CONFIG_FILE), { recursive: true });
+    await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+/**
+ * Delete stored config.
+ */
+export async function deleteConfig() {
+    try {
+        await unlink(CONFIG_FILE);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+}
+/**
+ * Get config file path (for display).
+ */
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+// =============================================================================
+// ULID Generation
+// =============================================================================
+/**
+ * Generate a ULID for message/frame IDs.
+ * Uses the standard ulid library which maintains monotonicity within the same
+ * millisecond (increments random portion instead of generating new random).
+ */
+export function generateId() {
+    return ulid();
+}
+/**
+ * Generate a runtime ID (rt_ prefix).
+ * Uses ULID for the unique portion, truncated to fit VARCHAR(26) column.
+ * Format: rt_ (3 chars) + 23 char ULID fragment = 26 chars
+ */
+export function generateRuntimeId() {
+    // Take first 23 chars of ULID to fit in 26 char limit with rt_ prefix
+    return `rt_${ulid().substring(0, 23)}`;
+}
+// =============================================================================
+// API Interactions
+// =============================================================================
+/**
+ * Exchange a bootstrap token for server credentials.
+ */
+export async function exchangeBootstrapToken(host, bootstrapToken) {
+    const protocol = getApiProtocol(host);
+    const url = `${protocol}://${host}/api/runtimes/auth/bootstrap`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ bootstrapToken }),
+    });
+    if (!response.ok) {
+        if (response.status === 400) {
+            throw new Error('Invalid bootstrap token format.');
+        }
+        if (response.status === 401) {
+            throw new Error('Bootstrap token is invalid or expired.');
+        }
+        if (response.status === 409) {
+            throw new Error('Bootstrap token has already been used.');
+        }
+        throw new Error(`Bootstrap exchange failed: ${response.statusText}`);
+    }
+    return (await response.json());
+}
+// =============================================================================
+// Auth Flow
+// =============================================================================
+/**
+ * Initialize runtime config from a connection string.
+ * Parses the string, exchanges the bootstrap token, generates runtimeId,
+ * and saves config.
+ */
+export async function initFromConnectionString(connectionString, runtimeName) {
+    const parsed = parseConnectionString(connectionString);
+    console.log(`Connecting to ${parsed.host}...`);
+    // Exchange bootstrap token for credentials
+    const response = await exchangeBootstrapToken(parsed.host, parsed.bootstrapToken);
+    // Generate stable runtime ID
+    const runtimeId = generateRuntimeId();
+    // Determine runtime name
+    const name = runtimeName ?? hostname();
+    // Build API and WS URLs
+    const apiProtocol = getApiProtocol(response.host);
+    const wsProtocol = getWsProtocol(response.wsHost);
+    const config = {
+        spaceId: response.spaceId,
+        name,
+        credentials: {
+            runtimeId,
+            serverId: response.serverId,
+            secret: response.secret,
+            apiUrl: `${apiProtocol}://${response.host}`,
+            wsUrl: `${wsProtocol}://${response.wsHost}`,
+        },
+        workspace: {
+            basePath: DEFAULT_WORKSPACE_BASE,
+        },
+        createdAt: new Date().toISOString(),
+    };
+    await saveConfig(config);
+    console.log(`Config saved to ${CONFIG_FILE}`);
+    console.log(`Runtime ID: ${config.credentials.runtimeId}`);
+    console.log(`Runtime name: ${config.name}`);
+    console.log(`Space: ${config.spaceId}`);
+    return config;
+}
+// =============================================================================
+// Machine Info
+// =============================================================================
+export function getMachineInfo() {
+    return {
+        os: platform(),
+        hostname: hostname(),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @miriad-systems/backend
+ *
+ * Run CAST agents on your local machine.
+ */
+export { RuntimeClient, type RuntimeClientConfig, type RuntimeStatus } from './runtime-client.js';
+export { AgentManager, type AgentManagerConfig, parseAgentId } from './agent-manager.js';
+export { TymbalBridge, type TymbalBridgeConfig } from './tymbal-bridge.js';
+export { loadConfig, saveConfig, deleteConfig, getConfigPath, initFromConnectionString, parseConnectionString, generateId, generateRuntimeId, getMachineInfo, getApiProtocol, getWsProtocol, } from './config.js';
+export * from './types.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;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @miriad-systems/backend
+ *
+ * Run CAST agents on your local machine.
+ */
+export { RuntimeClient } from './runtime-client.js';
+export { AgentManager, parseAgentId } from './agent-manager.js';
+export { TymbalBridge } from './tymbal-bridge.js';
+export { loadConfig, saveConfig, deleteConfig, getConfigPath, initFromConnectionString, parseConnectionString, generateId, generateRuntimeId, getMachineInfo, getApiProtocol, getWsProtocol, } from './config.js';
+export * from './types.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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAgD,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAE,YAAY,EAA2B,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,YAAY,EAA2B,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,cAAc,YAAY,CAAC"}

package/dist/runtime-client.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Runtime Client
+ *
+ * Manages the WebSocket connection to the CAST backend.
+ * Handles the LocalRuntime protocol: authentication, message routing,
+ * and agent lifecycle coordination.
+ */
+import { AgentManager } from './agent-manager.js';
+import type { RuntimeConfig } from './types.js';
+export interface RuntimeClientConfig {
+    config: RuntimeConfig;
+    onConnected?: () => void;
+    onDisconnected?: (code: number, reason: string) => void;
+    onError?: (error: Error) => void;
+}
+export type RuntimeStatus = 'disconnected' | 'connecting' | 'connected' | 'ready';
+export declare class RuntimeClient {
+    private readonly runtimeConfig;
+    private readonly agentManager;
+    private ws;
+    private status;
+    private reconnectAttempts;
+    private reconnectTimeout;
+    private heartbeatInterval;
+    /** Heartbeat interval in milliseconds (30 seconds) */
+    private static readonly HEARTBEAT_INTERVAL_MS;
+    private readonly onConnected?;
+    private readonly onDisconnected?;
+    private readonly onError?;
+    constructor(config: RuntimeClientConfig);
+    /**
+     * Get current runtime status.
+     */
+    getStatus(): RuntimeStatus;
+    /**
+     * Get agent manager for status queries.
+     */
+    getAgentManager(): AgentManager;
+    /**
+     * Connect to the backend.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the backend.
+     */
+    disconnect(): Promise<void>;
+    private handleMessage;
+    private handleActivate;
+    private handleDeliverMessage;
+    private handleSuspend;
+    private send;
+    private sendRuntimeReady;
+    private sendCheckin;
+    private sendFrame;
+    private sendPong;
+    /**
+     * Re-checkin all active agents after reconnection.
+     * This notifies the backend about agents that survived the disconnect.
+     */
+    private reCheckinActiveAgents;
+    /**
+     * Start periodic heartbeat for all online agents.
+     */
+    private startHeartbeatInterval;
+    /**
+     * Stop the heartbeat interval.
+     */
+    private stopHeartbeatInterval;
+    /**
+     * Send heartbeats for all online agents.
+     */
+    private sendHeartbeats;
+    /**
+     * Format common connection errors into clean single-line messages.
+     * Returns null for unexpected errors that should show full stack trace.
+     */
+    private formatConnectionError;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=runtime-client.d.ts.map

package/dist/runtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.d.ts","sourceRoot":"","sources":["../src/runtime-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EACV,aAAa,EAWd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAMlF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,iBAAiB,CAA+C;IAExE,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAEtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyC;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAyB;gBAEtC,MAAM,EAAE,mBAAmB;IAiBvC;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0D9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBjC,OAAO,CAAC,aAAa;YA8CP,cAAc;YAKd,oBAAoB;YAKpB,aAAa;IAS3B,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;IAQhB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA+C7B,OAAO,CAAC,iBAAiB;CAmB1B"}