@agent-relay/sdk 2.3.14 → 2.3.15

package/dist/protocol.d.ts

@@ -0,0 +1,366 @@
+export declare const PROTOCOL_VERSION: 1;
+export type AgentRuntime = 'pty' | 'headless_claude';
+export interface RestartPolicy {
+    enabled?: boolean;
+    max_restarts?: number;
+    cooldown_ms?: number;
+    max_consecutive_failures?: number;
+}
+export interface AgentSpec {
+    name: string;
+    runtime: AgentRuntime;
+    cli?: string;
+    args?: string[];
+    channels?: string[];
+    model?: string;
+    cwd?: string;
+    team?: string;
+    shadow_of?: string;
+    shadow_mode?: string;
+    restart_policy?: RestartPolicy;
+}
+export interface RelayDelivery {
+    delivery_id: string;
+    event_id: string;
+    from: string;
+    target: string;
+    body: string;
+    thread_id?: string;
+    priority?: number;
+}
+export interface ProtocolEnvelope<TPayload> {
+    v: number;
+    type: string;
+    request_id?: string;
+    payload: TPayload;
+}
+export type SdkToBroker = {
+    type: 'hello';
+    payload: {
+        client_name: string;
+        client_version: string;
+    };
+} | {
+    type: 'spawn_agent';
+    payload: {
+        agent: AgentSpec;
+        initial_task?: string;
+    };
+} | {
+    type: 'send_message';
+    payload: {
+        to: string;
+        text: string;
+        from?: string;
+        thread_id?: string;
+        priority?: number;
+        data?: Record<string, unknown>;
+    };
+} | {
+    type: 'release_agent';
+    payload: {
+        name: string;
+        reason?: string;
+    };
+} | {
+    type: 'send_input';
+    payload: {
+        name: string;
+        data: string;
+    };
+} | {
+    type: 'set_model';
+    payload: {
+        name: string;
+        model: string;
+        timeout_ms?: number;
+    };
+} | {
+    type: 'get_metrics';
+    payload: {
+        agent?: string;
+    };
+} | {
+    type: 'list_agents';
+    payload: Record<string, never>;
+} | {
+    type: 'get_status';
+    payload: Record<string, never>;
+} | {
+    type: 'get_crash_insights';
+    payload: Record<string, never>;
+} | {
+    type: 'shutdown';
+    payload: Record<string, never>;
+} | {
+    /** Pre-register a batch of agents with Relaycast before their steps execute.
+     *  Broker warms its token cache in parallel; subsequent spawn_agent calls hit
+     *  the cache instead of waiting on individual HTTP registrations. */
+    type: 'preflight_agents';
+    payload: {
+        agents: Array<{
+            name: string;
+            cli: string;
+        }>;
+    };
+};
+export interface PendingDeliveryInfo {
+    delivery_id: string;
+    worker_name: string;
+    event_id: string;
+    attempts: number;
+}
+export interface BrokerStatus {
+    agent_count: number;
+    agents: Array<{
+        name: string;
+        runtime: AgentRuntime;
+        cli?: string;
+        model?: string;
+        team?: string;
+        channels: string[];
+        parent?: string;
+        pid?: number;
+    }>;
+    pending_delivery_count: number;
+    pending_deliveries: PendingDeliveryInfo[];
+}
+export type BrokerAgentStatus = 'healthy' | 'restarting' | 'dead' | 'released';
+export interface AgentStats {
+    spawns: number;
+    crashes: number;
+    restarts: number;
+    releases: number;
+    status: BrokerAgentStatus;
+    current_uptime_secs: number;
+    memory_bytes: number;
+}
+export interface BrokerStats {
+    uptime_secs: number;
+    total_agents_spawned: number;
+    total_crashes: number;
+    total_restarts: number;
+    active_agents: number;
+}
+export type CrashCategory = 'oom' | 'segfault' | 'error' | 'signal' | 'unknown';
+export interface CrashRecord {
+    agent_name: string;
+    exit_code?: number;
+    signal?: string;
+    timestamp: number;
+    uptime_secs: number;
+    category: CrashCategory;
+    description: string;
+}
+export interface CrashPattern {
+    category: CrashCategory;
+    count: number;
+    agents: string[];
+}
+export interface CrashInsightsResponse {
+    total_crashes: number;
+    recent: CrashRecord[];
+    patterns: CrashPattern[];
+    health_score: number;
+}
+export interface ProtocolError {
+    code: string;
+    message: string;
+    retryable: boolean;
+    data?: unknown;
+}
+export type BrokerEvent = {
+    kind: 'agent_spawned';
+    name: string;
+    runtime: AgentRuntime;
+    cli?: string;
+    model?: string;
+    parent?: string;
+    pid?: number;
+    source?: string;
+} | {
+    kind: 'agent_released';
+    name: string;
+} | {
+    kind: 'agent_exit';
+    name: string;
+    reason: string;
+} | {
+    kind: 'agent_exited';
+    name: string;
+    code?: number;
+    signal?: string;
+} | {
+    kind: 'relay_inbound';
+    event_id: string;
+    from: string;
+    target: string;
+    body: string;
+    thread_id?: string;
+} | {
+    kind: 'worker_stream';
+    name: string;
+    stream: string;
+    chunk: string;
+} | {
+    kind: 'delivery_retry';
+    name: string;
+    delivery_id: string;
+    event_id: string;
+    attempts: number;
+} | {
+    kind: 'delivery_dropped';
+    name: string;
+    count: number;
+    reason: string;
+} | {
+    kind: 'delivery_queued';
+    name: string;
+    delivery_id: string;
+    event_id: string;
+    timestamp?: unknown;
+} | {
+    kind: 'delivery_injected';
+    name: string;
+    delivery_id: string;
+    event_id: string;
+    timestamp?: unknown;
+} | {
+    kind: 'delivery_verified';
+    name: string;
+    delivery_id: string;
+    event_id: string;
+} | {
+    kind: 'delivery_failed';
+    name: string;
+    delivery_id: string;
+    event_id: string;
+    reason: string;
+} | {
+    kind: 'delivery_active';
+    name: string;
+    delivery_id: string;
+    event_id: string;
+} | {
+    kind: 'delivery_ack';
+    name: string;
+    delivery_id: string;
+    event_id: string;
+} | {
+    kind: 'worker_ready';
+    name: string;
+    runtime: AgentRuntime;
+    cli?: string;
+    model?: string;
+} | {
+    kind: 'worker_error';
+    name: string;
+    code: string;
+    message: string;
+} | {
+    kind: 'relaycast_published';
+    event_id: string;
+    to: string;
+    target_type: string;
+} | {
+    kind: 'relaycast_publish_failed';
+    event_id: string;
+    to: string;
+    reason: string;
+} | {
+    kind: 'acl_denied';
+    name: string;
+    sender: string;
+    owner_chain: string[];
+} | {
+    kind: 'agent_idle';
+    name: string;
+    idle_secs: number;
+} | {
+    kind: 'agent_restarting';
+    name: string;
+    code?: number;
+    signal?: string;
+    restart_count: number;
+    delay_ms: number;
+} | {
+    kind: 'agent_restarted';
+    name: string;
+    restart_count: number;
+} | {
+    kind: 'agent_permanently_dead';
+    name: string;
+    reason: string;
+};
+export type BrokerToSdk = {
+    type: 'hello_ack';
+    payload: {
+        broker_version: string;
+        protocol_version: number;
+    };
+} | {
+    type: 'ok';
+    payload: {
+        result: unknown;
+    };
+} | {
+    type: 'error';
+    payload: ProtocolError;
+} | {
+    type: 'event';
+    payload: BrokerEvent;
+};
+export type BrokerToWorker = {
+    type: 'init_worker';
+    payload: {
+        agent: AgentSpec;
+    };
+} | {
+    type: 'deliver_relay';
+    payload: RelayDelivery;
+} | {
+    type: 'shutdown_worker';
+    payload: {
+        reason: string;
+        grace_ms?: number;
+    };
+} | {
+    type: 'ping';
+    payload: {
+        ts_ms: number;
+    };
+};
+export type WorkerToBroker = {
+    type: 'worker_ready';
+    payload: {
+        name: string;
+        runtime: AgentRuntime;
+    };
+} | {
+    type: 'delivery_ack';
+    payload: {
+        delivery_id: string;
+        event_id: string;
+    };
+} | {
+    type: 'worker_stream';
+    payload: {
+        stream: string;
+        chunk: string;
+    };
+} | {
+    type: 'worker_error';
+    payload: ProtocolError;
+} | {
+    type: 'worker_exited';
+    payload: {
+        code?: number;
+        signal?: string;
+    };
+} | {
+    type: 'pong';
+    payload: {
+        ts_ms: number;
+    };
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,2 @@
+export const PROTOCOL_VERSION = 1;
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC"}

package/dist/pty.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PTY stream utilities — ANSI stripping and line extraction.
+ */
+/** Strip ANSI escape sequences from a string. */
+export declare function stripAnsi(s: string): string;
+/** Strip ANSI, split on newlines, trim, and drop empty lines. */
+export declare function cleanLines(raw: string): string[];
+//# sourceMappingURL=pty.d.ts.map

package/dist/pty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty.d.ts","sourceRoot":"","sources":["../src/pty.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAS3C;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhD"}

package/dist/pty.js

@@ -0,0 +1,26 @@
+/**
+ * PTY stream utilities — ANSI stripping and line extraction.
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI_RE = /\x1b(?:\[[0-9;?]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)?|[()][0-9A-Za-z]|[\x20-\x2f]*[\x40-\x7e])|\x1b/g;
+// eslint-disable-next-line no-control-regex
+const CURSOR_FORWARD_CSI_RE = /\x1b\[(\d*)C/g;
+// eslint-disable-next-line no-control-regex
+const ORPHANED_CURSOR_FORWARD_CSI_RE = /\[(\d*)C/g;
+function cursorForwardSpaces(countText) {
+    const count = Number.parseInt(countText || "1", 10);
+    const width = Number.isFinite(count) && count > 0 ? count : 1;
+    return " ".repeat(width);
+}
+/** Strip ANSI escape sequences from a string. */
+export function stripAnsi(s) {
+    let result = s.replace(CURSOR_FORWARD_CSI_RE, (_match, count) => cursorForwardSpaces(count));
+    result = result.replace(ANSI_RE, "");
+    result = result.replace(ORPHANED_CURSOR_FORWARD_CSI_RE, (_match, count) => cursorForwardSpaces(count));
+    return result;
+}
+/** Strip ANSI, split on newlines, trim, and drop empty lines. */
+export function cleanLines(raw) {
+    return stripAnsi(raw).split(/\r?\n/).map(l => l.trimEnd()).filter(Boolean);
+}
+//# sourceMappingURL=pty.js.map

package/dist/pty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty.js","sourceRoot":"","sources":["../src/pty.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,4CAA4C;AAC5C,MAAM,OAAO,GAAG,yGAAyG,CAAC;AAE1H,4CAA4C;AAC5C,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,8BAA8B,GAAG,WAAW,CAAC;AAEnD,SAAS,mBAAmB,CAAC,SAA6B;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE,CACtE,mBAAmB,CAAC,KAAK,CAAC,CAC3B,CAAC;IACF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE,CAChF,mBAAmB,CAAC,KAAK,CAAC,CAC3B,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC"}

package/dist/relay-adapter.d.ts

@@ -0,0 +1,139 @@
+/**
+ * RelayAdapter — high-level interface over the broker SDK.
+ *
+ * Wraps AgentRelayClient with auto-start, safe result patterns,
+ * and convenience methods. Usable by any integration: dashboard,
+ * MCP, ACP bridge, CLI, or custom tooling.
+ *
+ * Usage:
+ *   import { RelayAdapter } from '@agent-relay/sdk';
+ *
+ *   const relay = new RelayAdapter({ cwd: projectRoot });
+ *   await relay.start();
+ *
+ *   await relay.spawn({ name: 'Worker1', cli: 'claude', task: 'Build auth' });
+ *   const agents = await relay.listAgents();
+ *   await relay.sendMessage({ to: 'Worker1', text: 'status?' });
+ *   await relay.release('Worker1');
+ *
+ *   await relay.shutdown();
+ */
+import { AgentRelayClient, type SendMessageInput } from './client.js';
+import type { BrokerEvent, BrokerStats, BrokerStatus, CrashInsightsResponse } from './protocol.js';
+export interface RelayAdapterOptions {
+    /** Project root directory (required — the broker locks per project). */
+    cwd: string;
+    /** Path to the agent-relay binary. Falls back to bundled/PATH resolution. */
+    binaryPath?: string;
+    /** Default channels for spawned agents. */
+    channels?: string[];
+    /** Environment variables forwarded to the broker process. */
+    env?: NodeJS.ProcessEnv;
+    /** Client name reported in the hello handshake. */
+    clientName?: string;
+}
+export interface RelaySpawnRequest {
+    name: string;
+    cli: string;
+    task?: string;
+    team?: string;
+    cwd?: string;
+    model?: string;
+    interactive?: boolean;
+    shadowMode?: string;
+    shadowOf?: string;
+    shadowAgent?: string;
+    shadowTriggers?: string;
+    shadowSpeakOn?: string;
+    spawnerName?: string;
+    userId?: string;
+    includeWorkflowConventions?: boolean;
+}
+export interface RelaySpawnResult {
+    success: boolean;
+    name: string;
+    pid?: number;
+    error?: string;
+}
+export interface RelayAgentInfo {
+    name: string;
+    cli?: string;
+    pid?: number;
+    channels: string[];
+    parent?: string;
+    runtime: string;
+}
+export interface RelayReleaseResult {
+    success: boolean;
+    name: string;
+    error?: string;
+}
+export declare class RelayAdapter {
+    private client;
+    private started;
+    constructor(opts: RelayAdapterOptions);
+    /** Start the broker process. Idempotent. */
+    start(): Promise<void>;
+    /** Shut down the broker and all spawned agents. */
+    shutdown(): Promise<void>;
+    /** Spawn an agent via the broker's PTY runtime. */
+    spawn(req: RelaySpawnRequest): Promise<RelaySpawnResult>;
+    /** Release (stop) a spawned agent. */
+    release(name: string, reason?: string): Promise<RelayReleaseResult>;
+    /** List all agents managed by this broker instance. */
+    listAgents(): Promise<RelayAgentInfo[]>;
+    /** Check if a specific agent is spawned. */
+    hasAgent(name: string): Promise<boolean>;
+    /** Get broker status (agent count, pending deliveries). */
+    getStatus(): Promise<BrokerStatus>;
+    /** Send a message to an agent or channel. */
+    sendMessage(input: SendMessageInput): Promise<{
+        event_id: string;
+        targets: string[];
+    }>;
+    /**
+     * Send raw input to an agent's PTY stdin.
+     * Useful for interrupts (ESC sequences), confirmations, etc.
+     */
+    sendInput(name: string, data: string): Promise<void>;
+    /**
+     * Send an interrupt (ESC ESC) to an agent.
+     * Convenience wrapper around sendInput.
+     */
+    interruptAgent(name: string): Promise<boolean>;
+    /** Switch an agent's model at runtime. */
+    setModel(name: string, model: string, opts?: {
+        timeoutMs?: number;
+    }): Promise<{
+        success: boolean;
+        name: string;
+        model: string;
+    }>;
+    /** Get resource metrics for agents (memory, uptime) and broker stats. */
+    getMetrics(agent?: string): Promise<{
+        agents: Array<{
+            name: string;
+            pid: number;
+            memory_bytes: number;
+            uptime_secs: number;
+        }>;
+        broker?: BrokerStats;
+    }>;
+    /** Get crash insights: recent crashes, patterns, and health score. */
+    getCrashInsights(): Promise<CrashInsightsResponse>;
+    /**
+     * Subscribe to broker events (agent_spawned, agent_released,
+     * relay_inbound, worker_stream, etc.).
+     *
+     * Returns an unsubscribe function.
+     */
+    onEvent(listener: (event: BrokerEvent) => void): () => void;
+    /**
+     * Subscribe to broker stderr output (debug logs from the Rust binary).
+     * Returns an unsubscribe function.
+     */
+    onStderr(listener: (line: string) => void): () => void;
+    /** Access the underlying AgentRelayClient for advanced operations. */
+    get raw(): AgentRelayClient;
+}
+//# sourceMappingURL=relay-adapter.d.ts.map

package/dist/relay-adapter.d.ts.map

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