agent-relay 2.3.13 → 2.4.0

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

@@ -1,172 +0,0 @@
-/**
- * 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/broker-sdk";
- *
- * 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";
-import { type LogsResult } from "./logs.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[];
-    /** Set when the agent exits. Available after `onAgentExited` fires. */
-    exitCode?: number;
-    /** Set when the agent exits via signal. Available after `onAgentExited` fires. */
-    exitSignal?: 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">;
-    /** Wait for the agent to go idle (no PTY output for the configured threshold).
-     *  @param timeoutMs — optional timeout in ms. Resolves with `"idle"` when first idle event fires,
-     *  `"timeout"` if timeoutMs elapses first, or `"exited"` if the agent exits. */
-    waitForIdle(timeoutMs?: number): Promise<"idle" | "timeout" | "exited">;
-    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[];
-        task?: 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>;
-    onAgentReady: EventHook<Agent>;
-    onWorkerOutput: EventHook<{
-        name: string;
-        stream: string;
-        chunk: string;
-    }>;
-    onDeliveryUpdate: EventHook<BrokerEvent>;
-    onAgentIdle: EventHook<{
-        name: string;
-        idleSecs: number;
-    }>;
-    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 exitResolverSeq;
-    private readonly idleResolvers;
-    private idleResolverSeq;
-    private readonly relaycastByName;
-    constructor(options?: AgentRelayOptions);
-    spawnPty(input: SpawnPtyInput): Promise<Agent>;
-    human(opts: {
-        name: string;
-    }): HumanHandle;
-    /**
-     * Broadcast a message to all connected agents.
-     * @param text — the message body
-     * @param options — optional sender name (defaults to "human:orchestrator")
-     */
-    broadcast(text: string, options?: {
-        from?: string;
-    }): Promise<Message>;
-    listAgents(): Promise<Agent[]>;
-    getStatus(): Promise<BrokerStatus>;
-    /**
-     * Read the last N lines of an agent's log file.
-     *
-     * @example
-     * ```ts
-     * const logs = await relay.getLogs("Worker1", { lines: 100 });
-     * if (logs.found) console.log(logs.content);
-     * ```
-     */
-    getLogs(agentName: string, options?: {
-        lines?: number;
-    }): Promise<LogsResult>;
-    /** List all agents that have log files. */
-    listLoggedAgents(): Promise<string[]>;
-    /**
-     * Wait for any one of the given agents to exit. Returns the first agent
-     * that exits along with its exit reason.
-     *
-     * @example
-     * ```ts
-     * const { agent, result } = await AgentRelay.waitForAny([worker1, worker2], 60_000);
-     * console.log(`${agent.name} finished: ${result}`);
-     * ```
-     */
-    static waitForAny(agents: Agent[], timeoutMs?: number): Promise<{
-        agent: Agent;
-        result: "exited" | "timeout" | "released";
-    }>;
-    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/broker-sdk/dist/relay.d.ts.map

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

package/packages/broker-sdk/dist/relay.js

@@ -1,486 +0,0 @@
-/**
- * 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/broker-sdk";
- *
- * 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 { randomBytes } from "node:crypto";
-import path from "node:path";
-import { AgentRelayClient, AgentRelayProtocolError, } from "./client.js";
-import { RelaycastApi } from "./relaycast.js";
-import { getLogs as getLogsFromFile, listLoggedAgents as listLoggedAgentsFromFile } from "./logs.js";
-function isUnsupportedOperation(error) {
-    return error instanceof AgentRelayProtocolError && error.code === "unsupported_operation";
-}
-function buildUnsupportedOperationMessage(from, input) {
-    return {
-        eventId: "unsupported_operation",
-        from,
-        to: input.to,
-        text: input.text,
-        threadId: input.threadId,
-    };
-}
-// ── AgentRelay facade ───────────────────────────────────────────────────────
-export class AgentRelay {
-    // Event hooks — assign a callback or null to clear.
-    onMessageReceived = null;
-    onMessageSent = null;
-    onAgentSpawned = null;
-    onAgentReleased = null;
-    onAgentExited = null;
-    onAgentReady = null;
-    onWorkerOutput = null;
-    onDeliveryUpdate = null;
-    onAgentIdle = null;
-    // Shorthand spawners
-    codex;
-    claude;
-    gemini;
-    clientOptions;
-    defaultChannels;
-    client;
-    startPromise;
-    unsubEvent;
-    knownAgents = new Map();
-    exitResolvers = new Map();
-    exitResolverSeq = 0;
-    idleResolvers = new Map();
-    idleResolverSeq = 0;
-    relaycastByName = new Map();
-    constructor(options = {}) {
-        this.defaultChannels = options.channels ?? ["general"];
-        this.clientOptions = {
-            binaryPath: options.binaryPath,
-            binaryArgs: options.binaryArgs,
-            brokerName: options.brokerName,
-            channels: this.defaultChannels,
-            cwd: options.cwd,
-            env: options.env,
-            requestTimeoutMs: options.requestTimeoutMs,
-            shutdownTimeoutMs: options.shutdownTimeoutMs,
-        };
-        this.codex = this.createSpawner("codex", "Codex", "pty");
-        this.claude = this.createSpawner("claude", "Claude", "pty");
-        this.gemini = this.createSpawner("gemini", "Gemini", "pty");
-    }
-    // ── Spawning ────────────────────────────────────────────────────────────
-    async spawnPty(input) {
-        const client = await this.ensureStarted();
-        const channels = input.channels ?? ["general"];
-        const result = await client.spawnPty({
-            name: input.name,
-            cli: input.cli,
-            args: input.args,
-            channels,
-            task: input.task,
-            idleThresholdSecs: input.idleThresholdSecs,
-        });
-        const agent = this.makeAgent(result.name, result.runtime, channels);
-        this.knownAgents.set(agent.name, agent);
-        return agent;
-    }
-    // ── Human source ────────────────────────────────────────────────────────
-    human(opts) {
-        const relay = this;
-        return {
-            name: opts.name,
-            async sendMessage(input) {
-                const client = await relay.ensureStarted();
-                let result;
-                try {
-                    result = await client.sendMessage({
-                        to: input.to,
-                        text: input.text,
-                        from: opts.name,
-                        threadId: input.threadId,
-                        priority: input.priority,
-                    });
-                }
-                catch (error) {
-                    if (isUnsupportedOperation(error)) {
-                        return buildUnsupportedOperationMessage(opts.name, input);
-                    }
-                    throw error;
-                }
-                if (result?.event_id === "unsupported_operation") {
-                    return buildUnsupportedOperationMessage(opts.name, input);
-                }
-                const eventId = result?.event_id ?? randomBytes(8).toString("hex");
-                const msg = {
-                    eventId,
-                    from: opts.name,
-                    to: input.to,
-                    text: input.text,
-                    threadId: input.threadId,
-                };
-                relay.onMessageSent?.(msg);
-                return msg;
-            },
-        };
-    }
-    // ── Messaging ─────────────────────────────────────────────────────────
-    /**
-     * Broadcast a message to all connected agents.
-     * @param text — the message body
-     * @param options — optional sender name (defaults to "human:orchestrator")
-     */
-    async broadcast(text, options) {
-        const from = options?.from ?? "human:orchestrator";
-        return this.human({ name: from }).sendMessage({ to: "*", text });
-    }
-    // ── Listing ─────────────────────────────────────────────────────────────
-    async listAgents() {
-        const client = await this.ensureStarted();
-        const list = await client.listAgents();
-        return list.map((entry) => {
-            const existing = this.knownAgents.get(entry.name);
-            if (existing)
-                return existing;
-            const agent = this.makeAgent(entry.name, entry.runtime, entry.channels);
-            this.knownAgents.set(agent.name, agent);
-            return agent;
-        });
-    }
-    // ── Status ────────────────────────────────────────────────────────────
-    async getStatus() {
-        const client = await this.ensureStarted();
-        return client.getStatus();
-    }
-    // ── Logs ──────────────────────────────────────────────────────────────
-    /**
-     * Read the last N lines of an agent's log file.
-     *
-     * @example
-     * ```ts
-     * const logs = await relay.getLogs("Worker1", { lines: 100 });
-     * if (logs.found) console.log(logs.content);
-     * ```
-     */
-    async getLogs(agentName, options) {
-        const cwd = this.clientOptions.cwd ?? process.cwd();
-        const logsDir = path.join(cwd, ".agent-relay", "worker-logs");
-        return getLogsFromFile(agentName, { logsDir, lines: options?.lines });
-    }
-    /** List all agents that have log files. */
-    async listLoggedAgents() {
-        const cwd = this.clientOptions.cwd ?? process.cwd();
-        const logsDir = path.join(cwd, ".agent-relay", "worker-logs");
-        return listLoggedAgentsFromFile(logsDir);
-    }
-    // ── Wait helpers ──────────────────────────────────────────────────────
-    /**
-     * Wait for any one of the given agents to exit. Returns the first agent
-     * that exits along with its exit reason.
-     *
-     * @example
-     * ```ts
-     * const { agent, result } = await AgentRelay.waitForAny([worker1, worker2], 60_000);
-     * console.log(`${agent.name} finished: ${result}`);
-     * ```
-     */
-    static async waitForAny(agents, timeoutMs) {
-        if (agents.length === 0) {
-            throw new Error("waitForAny requires at least one agent");
-        }
-        return Promise.race(agents.map(async (agent) => {
-            const result = await agent.waitForExit(timeoutMs);
-            return { agent, result };
-        }));
-    }
-    // ── Lifecycle ───────────────────────────────────────────────────────────
-    async shutdown() {
-        if (this.unsubEvent) {
-            this.unsubEvent();
-            this.unsubEvent = undefined;
-        }
-        if (this.client) {
-            await this.client.shutdown();
-            this.client = undefined;
-        }
-        this.knownAgents.clear();
-        for (const entry of this.exitResolvers.values()) {
-            entry.resolve("released");
-        }
-        this.exitResolvers.clear();
-        for (const entry of this.idleResolvers.values()) {
-            entry.resolve("exited");
-        }
-        this.idleResolvers.clear();
-    }
-    // ── Private helpers ─────────────────────────────────────────────────────
-    /** 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. */
-    resolveChannel(to) {
-        if (to.startsWith("#"))
-            return to.slice(1);
-        const agent = this.knownAgents.get(to);
-        if (agent && agent.channels.length > 0)
-            return agent.channels[0];
-        return this.defaultChannels[0];
-    }
-    ensureRelaycast(agentName) {
-        let rc = this.relaycastByName.get(agentName);
-        if (!rc) {
-            const cwd = this.clientOptions.cwd ?? process.cwd();
-            rc = new RelaycastApi({
-                agentName,
-                cachePath: path.join(cwd, ".agent-relay", "relaycast.json"),
-            });
-            this.relaycastByName.set(agentName, rc);
-        }
-        return rc;
-    }
-    async ensureStarted() {
-        if (this.client)
-            return this.client;
-        if (this.startPromise)
-            return this.startPromise;
-        this.startPromise = AgentRelayClient.start(this.clientOptions)
-            .then((c) => {
-            this.client = c;
-            this.startPromise = undefined;
-            this.wireEvents(c);
-            return c;
-        })
-            .catch((err) => {
-            this.startPromise = undefined;
-            throw err;
-        });
-        return this.startPromise;
-    }
-    wireEvents(client) {
-        this.unsubEvent = client.onEvent((event) => {
-            switch (event.kind) {
-                case "relay_inbound": {
-                    const msg = {
-                        eventId: event.event_id,
-                        from: event.from,
-                        to: event.target,
-                        text: event.body,
-                        threadId: event.thread_id,
-                    };
-                    this.onMessageReceived?.(msg);
-                    break;
-                }
-                case "agent_spawned": {
-                    let agent = this.knownAgents.get(event.name);
-                    if (!agent) {
-                        agent = this.makeAgent(event.name, event.runtime, []);
-                        this.knownAgents.set(event.name, agent);
-                    }
-                    this.onAgentSpawned?.(agent);
-                    break;
-                }
-                case "agent_released": {
-                    const agent = this.knownAgents.get(event.name) ??
-                        this.makeAgent(event.name, "pty", []);
-                    this.onAgentReleased?.(agent);
-                    this.knownAgents.delete(event.name);
-                    this.exitResolvers.get(event.name)?.resolve("released");
-                    this.exitResolvers.delete(event.name);
-                    this.idleResolvers.get(event.name)?.resolve("exited");
-                    this.idleResolvers.delete(event.name);
-                    break;
-                }
-                case "agent_exited": {
-                    const agent = this.knownAgents.get(event.name) ??
-                        this.makeAgent(event.name, "pty", []);
-                    // Populate exit info before firing the hook
-                    agent.exitCode = event.code;
-                    agent.exitSignal = event.signal;
-                    this.onAgentExited?.(agent);
-                    this.knownAgents.delete(event.name);
-                    this.exitResolvers.get(event.name)?.resolve("exited");
-                    this.exitResolvers.delete(event.name);
-                    this.idleResolvers.get(event.name)?.resolve("exited");
-                    this.idleResolvers.delete(event.name);
-                    break;
-                }
-                case "worker_ready": {
-                    let agent = this.knownAgents.get(event.name);
-                    if (!agent) {
-                        agent = this.makeAgent(event.name, event.runtime, []);
-                        this.knownAgents.set(event.name, agent);
-                    }
-                    this.onAgentReady?.(agent);
-                    break;
-                }
-                case "worker_stream": {
-                    this.onWorkerOutput?.({
-                        name: event.name,
-                        stream: event.stream,
-                        chunk: event.chunk,
-                    });
-                    break;
-                }
-                case "agent_idle": {
-                    this.onAgentIdle?.({
-                        name: event.name,
-                        idleSecs: event.idle_secs,
-                    });
-                    // Resolve idle waiters
-                    this.idleResolvers.get(event.name)?.resolve("idle");
-                    this.idleResolvers.delete(event.name);
-                    break;
-                }
-            }
-            if (event.kind.startsWith("delivery_")) {
-                this.onDeliveryUpdate?.(event);
-            }
-        });
-    }
-    makeAgent(name, runtime, channels) {
-        const relay = this;
-        return {
-            name,
-            runtime,
-            channels,
-            exitCode: undefined,
-            exitSignal: undefined,
-            async release() {
-                const client = await relay.ensureStarted();
-                await client.release(name);
-            },
-            waitForExit(timeoutMs) {
-                return new Promise((resolve) => {
-                    // If already gone, resolve immediately
-                    if (!relay.knownAgents.has(name)) {
-                        resolve("exited");
-                        return;
-                    }
-                    // Non-blocking poll: timeoutMs === 0 means "check now, return immediately"
-                    if (timeoutMs === 0) {
-                        resolve("timeout");
-                        return;
-                    }
-                    let timer;
-                    const token = ++relay.exitResolverSeq;
-                    relay.exitResolvers.set(name, {
-                        resolve(reason) {
-                            if (timer)
-                                clearTimeout(timer);
-                            resolve(reason);
-                        },
-                        token,
-                    });
-                    if (timeoutMs !== undefined) {
-                        timer = setTimeout(() => {
-                            // Only delete if this is still our resolver (not one from a later call)
-                            const current = relay.exitResolvers.get(name);
-                            if (current?.token === token) {
-                                relay.exitResolvers.delete(name);
-                            }
-                            resolve("timeout");
-                        }, timeoutMs);
-                    }
-                });
-            },
-            waitForIdle(timeoutMs) {
-                return new Promise((resolve) => {
-                    if (!relay.knownAgents.has(name)) {
-                        resolve("exited");
-                        return;
-                    }
-                    if (timeoutMs === 0) {
-                        resolve("timeout");
-                        return;
-                    }
-                    let timer;
-                    const token = ++relay.idleResolverSeq;
-                    relay.idleResolvers.set(name, {
-                        resolve(reason) {
-                            if (timer)
-                                clearTimeout(timer);
-                            resolve(reason);
-                        },
-                        token,
-                    });
-                    if (timeoutMs !== undefined) {
-                        timer = setTimeout(() => {
-                            const current = relay.idleResolvers.get(name);
-                            if (current?.token === token) {
-                                relay.idleResolvers.delete(name);
-                            }
-                            resolve("timeout");
-                        }, timeoutMs);
-                    }
-                });
-            },
-            async sendMessage(input) {
-                const client = await relay.ensureStarted();
-                let result;
-                try {
-                    result = await client.sendMessage({
-                        to: input.to,
-                        text: input.text,
-                        from: name,
-                        threadId: input.threadId,
-                        priority: input.priority,
-                    });
-                }
-                catch (error) {
-                    if (isUnsupportedOperation(error)) {
-                        return buildUnsupportedOperationMessage(name, input);
-                    }
-                    throw error;
-                }
-                if (result?.event_id === "unsupported_operation") {
-                    return buildUnsupportedOperationMessage(name, input);
-                }
-                const eventId = result?.event_id ?? randomBytes(8).toString("hex");
-                const msg = {
-                    eventId,
-                    from: name,
-                    to: input.to,
-                    text: input.text,
-                    threadId: input.threadId,
-                };
-                relay.onMessageSent?.(msg);
-                return msg;
-            },
-        };
-    }
-    createSpawner(cli, defaultName, runtime) {
-        const relay = this;
-        return {
-            async spawn(options) {
-                const client = await relay.ensureStarted();
-                const name = options?.name ?? defaultName;
-                const channels = options?.channels ?? ["general"];
-                const args = options?.args ?? [];
-                const task = options?.task;
-                let result;
-                if (runtime === "headless_claude") {
-                    result = await client.spawnHeadlessClaude({ name, args, channels, task });
-                }
-                else {
-                    result = await client.spawnPty({ name, cli, args, channels, task });
-                }
-                const agent = relay.makeAgent(result.name, result.runtime, channels);
-                relay.knownAgents.set(agent.name, agent);
-                return agent;
-            },
-        };
-    }
-}
-//# sourceMappingURL=relay.js.map