agent-relay 2.2.24 → 2.3.0

package/packages/sdk-ts/dist/protocol.d.ts

@@ -0,0 +1,249 @@
+export declare const PROTOCOL_VERSION: 1;
+export type AgentRuntime = "pty" | "headless_claude";
+export interface AgentSpec {
+    name: string;
+    runtime: AgentRuntime;
+    cli?: string;
+    args?: string[];
+    channels?: string[];
+}
+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;
+    };
+} | {
+    type: "send_message";
+    payload: {
+        to: string;
+        text: string;
+        from?: string;
+        thread_id?: string;
+        priority?: number;
+    };
+} | {
+    type: "release_agent";
+    payload: {
+        name: string;
+    };
+} | {
+    type: "list_agents";
+    payload: Record<string, never>;
+} | {
+    type: "get_status";
+    payload: Record<string, never>;
+} | {
+    type: "shutdown";
+    payload: Record<string, never>;
+};
+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;
+        channels: string[];
+        parent?: string;
+        pid?: number;
+    }>;
+    pending_delivery_count: number;
+    pending_deliveries: PendingDeliveryInfo[];
+}
+export interface ProtocolError {
+    code: string;
+    message: string;
+    retryable: boolean;
+    data?: unknown;
+}
+export type BrokerEvent = {
+    kind: "agent_spawned";
+    name: string;
+    runtime: AgentRuntime;
+    parent?: string;
+} | {
+    kind: "agent_released";
+    name: 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;
+} | {
+    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[];
+};
+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/packages/sdk-ts/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/packages/sdk-ts/dist/protocol.js

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

package/packages/sdk-ts/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/packages/sdk-ts/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/packages/sdk-ts/dist/pty.d.ts.map

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

package/packages/sdk-ts/dist/pty.js

@@ -0,0 +1,14 @@
+/**
+ * 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;
+/** Strip ANSI escape sequences from a string. */
+export function stripAnsi(s) {
+    return s.replace(ANSI_RE, "");
+}
+/** 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/packages/sdk-ts/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,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAChC,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/packages/sdk-ts/dist/relay.d.ts

@@ -0,0 +1,118 @@
+/**
+ * High-level facade for the Agent Relay SDK.
+ *
+ * Provides a clean, property-based API on top of the lower-level
+ * {@link AgentRelayClient} protocol client.
+ *
+ * @example
+ * ```ts
+ * import { AgentRelay } from "@agent-relay/sdk-ts";
+ *
+ * const relay = new AgentRelay();
+ *
+ * relay.onMessageReceived = (message) => console.log(message);
+ * relay.onAgentSpawned = (agent) => console.log("spawned", agent.name);
+ *
+ * const codex = await relay.codex.spawn();
+ * const human = relay.human({ name: "System" });
+ * await human.sendMessage({ to: codex.name, text: "Hello!" });
+ *
+ * const agents = await relay.listAgents();
+ * for (const a of agents) await a.release();
+ * await relay.shutdown();
+ * ```
+ */
+import { type SpawnPtyInput } from "./client.js";
+import type { AgentRuntime, BrokerEvent, BrokerStatus } from "./protocol.js";
+export interface Message {
+    eventId: string;
+    from: string;
+    to: string;
+    text: string;
+    threadId?: string;
+}
+export interface Agent {
+    readonly name: string;
+    readonly runtime: AgentRuntime;
+    readonly channels: string[];
+    release(): Promise<void>;
+    /** Wait for the agent process to exit on its own.
+     *  @param timeoutMs — optional timeout in ms. Resolves with `"timeout"` if exceeded,
+     *  `"exited"` if the agent exited naturally, or `"released"` if released externally. */
+    waitForExit(timeoutMs?: number): Promise<"exited" | "timeout" | "released">;
+    sendMessage(input: {
+        to: string;
+        text: string;
+        threadId?: string;
+        priority?: number;
+    }): Promise<Message>;
+}
+export interface HumanHandle {
+    readonly name: string;
+    sendMessage(input: {
+        to: string;
+        text: string;
+        threadId?: string;
+        priority?: number;
+    }): Promise<Message>;
+}
+export interface AgentSpawner {
+    spawn(options?: {
+        name?: string;
+        args?: string[];
+        channels?: string[];
+    }): Promise<Agent>;
+}
+export type EventHook<T> = ((value: T) => void) | null;
+export interface AgentRelayOptions {
+    binaryPath?: string;
+    binaryArgs?: string[];
+    brokerName?: string;
+    channels?: string[];
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    requestTimeoutMs?: number;
+    shutdownTimeoutMs?: number;
+}
+export declare class AgentRelay {
+    onMessageReceived: EventHook<Message>;
+    onMessageSent: EventHook<Message>;
+    onAgentSpawned: EventHook<Agent>;
+    onAgentReleased: EventHook<Agent>;
+    onAgentExited: EventHook<Agent>;
+    onWorkerOutput: EventHook<{
+        name: string;
+        stream: string;
+        chunk: string;
+    }>;
+    onDeliveryUpdate: EventHook<BrokerEvent>;
+    readonly codex: AgentSpawner;
+    readonly claude: AgentSpawner;
+    readonly gemini: AgentSpawner;
+    private readonly clientOptions;
+    private readonly defaultChannels;
+    private client?;
+    private startPromise?;
+    private unsubEvent?;
+    private readonly knownAgents;
+    private readonly exitResolvers;
+    private readonly relaycastByName;
+    constructor(options?: AgentRelayOptions);
+    spawnPty(input: SpawnPtyInput): Promise<Agent>;
+    human(opts: {
+        name: string;
+    }): HumanHandle;
+    listAgents(): Promise<Agent[]>;
+    getStatus(): Promise<BrokerStatus>;
+    shutdown(): Promise<void>;
+    /** Resolve a target to a channel name. If `to` is `#channel`, use that
+     *  channel. If it's a known agent name, use the agent's first channel.
+     *  Otherwise fall back to the relay's default channel. */
+    private resolveChannel;
+    private ensureRelaycast;
+    private ensureStarted;
+    private wireEvents;
+    private makeAgent;
+    private createSpawner;
+}
+//# sourceMappingURL=relay.d.ts.map

package/packages/sdk-ts/dist/relay.d.ts.map

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