agent-relay 2.2.24 → 2.3.1

package/packages/sdk-ts/dist/__tests__/quickstart.test.js

@@ -0,0 +1,176 @@
+/**
+ * Quickstart integration tests — exercises the AgentRelay facade:
+ * spawn agents, send messages, list, release, event hooks, shutdown.
+ *
+ * Run:
+ *   npm run build && node --test dist/__tests__/quickstart.test.js
+ *
+ * Requires:
+ *   RELAY_API_KEY — Relaycast workspace key
+ *   AGENT_RELAY_BIN (optional) — path to agent-relay binary
+ */
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import path from "node:path";
+import test from "node:test";
+import { AgentRelay } from "../relay.js";
+// ── helpers ─────────────────────────────────────────────────────────────────
+function resolveBinaryPath() {
+    if (process.env.AGENT_RELAY_BIN) {
+        return process.env.AGENT_RELAY_BIN;
+    }
+    return path.resolve(process.cwd(), "../../target/debug/agent-relay");
+}
+function requireRelaycast(t) {
+    if (!process.env.RELAY_API_KEY?.trim()) {
+        t.skip("RELAY_API_KEY is required");
+        return false;
+    }
+    return true;
+}
+function requireBinary(t) {
+    const bin = resolveBinaryPath();
+    if (!fs.existsSync(bin)) {
+        t.skip(`agent-relay binary not found at ${bin}`);
+        return null;
+    }
+    return bin;
+}
+// ── full lifecycle ──────────────────────────────────────────────────────────
+test("facade: spawn → message → list → release → shutdown", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+    const spawnedNames = [];
+    const releasedNames = [];
+    const receivedMessages = [];
+    const sentMessages = [];
+    relay.onAgentSpawned = (agent) => spawnedNames.push(agent.name);
+    relay.onAgentReleased = (agent) => releasedNames.push(agent.name);
+    relay.onMessageReceived = (msg) => receivedMessages.push(msg);
+    relay.onMessageSent = (msg) => sentMessages.push(msg);
+    try {
+        // Spawn two agents in parallel
+        const [codex, worker1] = await Promise.all([
+            relay.codex.spawn({ name: `Codex-${suffix}` }),
+            relay.spawnPty({
+                name: `Worker1-${suffix}`,
+                cli: "cat",
+                channels: ["general"],
+            }),
+        ]);
+        assert.equal(codex.runtime, "pty");
+        assert.equal(worker1.runtime, "pty");
+        // Send a message from a human source
+        const human = relay.human({ name: "System" });
+        const msg = await human.sendMessage({
+            to: codex.name,
+            text: "Hello, world!",
+        });
+        assert.ok(msg.eventId, "should return eventId");
+        assert.equal(msg.from, "System");
+        assert.equal(msg.to, codex.name);
+        // onMessageSent should have fired
+        assert.equal(sentMessages.length, 1);
+        assert.equal(sentMessages[0].text, "Hello, world!");
+        // List agents — should return Agent objects with release()
+        const agents = await relay.listAgents();
+        const names = agents.map((a) => a.name);
+        assert.ok(names.includes(codex.name));
+        assert.ok(names.includes(worker1.name));
+        assert.equal(typeof agents[0].release, "function");
+        // Release all via agent.release()
+        for (const agent of agents) {
+            if (agent.name === codex.name || agent.name === worker1.name) {
+                await agent.release();
+            }
+        }
+        // Verify gone
+        const remaining = await relay.listAgents();
+        assert.ok(!remaining.some((a) => a.name === codex.name));
+        assert.ok(!remaining.some((a) => a.name === worker1.name));
+        // Event hooks should have fired
+        assert.ok(spawnedNames.includes(codex.name));
+        assert.ok(spawnedNames.includes(worker1.name));
+        assert.ok(releasedNames.includes(codex.name));
+        assert.ok(releasedNames.includes(worker1.name));
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── agent.sendMessage ───────────────────────────────────────────────────────
+test("facade: agent.sendMessage sends from the agent identity", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+    const sentMessages = [];
+    relay.onMessageSent = (msg) => sentMessages.push(msg);
+    try {
+        const [a, b] = await Promise.all([
+            relay.spawnPty({ name: `A-${suffix}`, cli: "cat", channels: ["general"] }),
+            relay.spawnPty({ name: `B-${suffix}`, cli: "cat", channels: ["general"] }),
+        ]);
+        const msg = await a.sendMessage({ to: b.name, text: "ping" });
+        assert.equal(msg.from, a.name);
+        assert.equal(msg.to, b.name);
+        assert.equal(sentMessages.length, 1);
+        assert.equal(sentMessages[0].from, a.name);
+        await a.release();
+        await b.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── threading ───────────────────────────────────────────────────────────────
+test("facade: message threading with threadId", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+    try {
+        const agent = await relay.spawnPty({
+            name: `Thread-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        const human = relay.human({ name: "Human" });
+        const msg1 = await human.sendMessage({ to: agent.name, text: "start" });
+        const msg2 = await human.sendMessage({
+            to: agent.name,
+            text: "follow-up",
+            threadId: msg1.eventId,
+        });
+        assert.ok(msg2.eventId);
+        assert.notEqual(msg1.eventId, msg2.eventId);
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+//# sourceMappingURL=quickstart.test.js.map

package/packages/sdk-ts/dist/__tests__/quickstart.test.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Browser-compatible entry point for the broker SDK.
+ *
+ * Exports only modules with zero Node.js dependencies.
+ * The ConsensusEngine class (needs node:crypto + node:events) is NOT
+ * exported here — only its types and pure helper functions.
+ *
+ * @example
+ * ```ts
+ * import { PROTOCOL_VERSION, type BrokerEvent } from "agent-relay/broker/browser";
+ * ```
+ */
+export { PROTOCOL_VERSION, type AgentRuntime, type AgentSpec, type BrokerEvent, type BrokerStatus, type BrokerToSdk, type BrokerToWorker, type PendingDeliveryInfo, type ProtocolEnvelope, type ProtocolError, type RelayDelivery, type SdkToBroker, type WorkerToBroker, } from "./protocol.js";
+export { formatProposalMessage, formatResultMessage, parseVoteCommand, parseProposalCommand, isConsensusCommand, type ConsensusType, type VoteValue, type ProposalStatus, type AgentWeight, type Vote, type Proposal, type ConsensusResult, type ConsensusConfig, type ConsensusEvents, type ParsedProposalCommand, } from "./consensus-helpers.js";
+export { ShadowManager, type ShadowConfig, type ShadowRelationship, type ShadowCopy, type SpeakOnTrigger, } from "./shadow.js";
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Browser-compatible entry point for the broker SDK.
+ *
+ * Exports only modules with zero Node.js dependencies.
+ * The ConsensusEngine class (needs node:crypto + node:events) is NOT
+ * exported here — only its types and pure helper functions.
+ *
+ * @example
+ * ```ts
+ * import { PROTOCOL_VERSION, type BrokerEvent } from "agent-relay/broker/browser";
+ * ```
+ */
+// Protocol types — pure TypeScript, zero deps
+export { PROTOCOL_VERSION, } from "./protocol.js";
+// Consensus types + pure functions (from the Node-free helpers file)
+export { formatProposalMessage, formatResultMessage, parseVoteCommand, parseProposalCommand, isConsensusCommand, } from "./consensus-helpers.js";
+// Shadow manager — pure in-memory, no I/O deps
+export { ShadowManager, } from "./shadow.js";
+//# sourceMappingURL=browser.js.map

package/packages/sdk-ts/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,8CAA8C;AAC9C,OAAO,EACL,gBAAgB,GAajB,MAAM,eAAe,CAAC;AAEvB,qEAAqE;AACrE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GAWnB,MAAM,wBAAwB,CAAC;AAEhC,+CAA+C;AAC/C,OAAO,EACL,aAAa,GAKd,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,91 @@
+import { type AgentRuntime, type BrokerEvent, type BrokerStatus, type ProtocolError } from "./protocol.js";
+export interface AgentRelayClientOptions {
+    binaryPath?: string;
+    binaryArgs?: string[];
+    brokerName?: string;
+    channels?: string[];
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    requestTimeoutMs?: number;
+    shutdownTimeoutMs?: number;
+    clientName?: string;
+    clientVersion?: string;
+}
+export interface SpawnPtyInput {
+    name: string;
+    cli: string;
+    args?: string[];
+    channels?: string[];
+}
+export interface SpawnHeadlessClaudeInput {
+    name: string;
+    args?: string[];
+    channels?: string[];
+}
+export interface SendMessageInput {
+    to: string;
+    text: string;
+    from?: string;
+    threadId?: string;
+    priority?: number;
+}
+export interface ListAgent {
+    name: string;
+    runtime: AgentRuntime;
+    channels: string[];
+    parent?: string;
+    pid?: number;
+}
+export declare class AgentRelayProtocolError extends Error {
+    code: string;
+    retryable: boolean;
+    data?: unknown;
+    constructor(payload: ProtocolError);
+}
+export declare class AgentRelayProcessError extends Error {
+    constructor(message: string);
+}
+export declare class AgentRelayClient {
+    private readonly options;
+    private child?;
+    private stdoutRl?;
+    private stderrRl?;
+    private requestSeq;
+    private pending;
+    private startingPromise?;
+    private eventListeners;
+    private stderrListeners;
+    private exitPromise?;
+    constructor(options?: AgentRelayClientOptions);
+    static start(options?: AgentRelayClientOptions): Promise<AgentRelayClient>;
+    onEvent(listener: (event: BrokerEvent) => void): () => void;
+    onBrokerStderr(listener: (line: string) => void): () => void;
+    start(): Promise<void>;
+    spawnPty(input: SpawnPtyInput): Promise<{
+        name: string;
+        runtime: AgentRuntime;
+    }>;
+    spawnHeadlessClaude(input: SpawnHeadlessClaudeInput): Promise<{
+        name: string;
+        runtime: AgentRuntime;
+    }>;
+    release(name: string): Promise<{
+        name: string;
+    }>;
+    sendMessage(input: SendMessageInput): Promise<{
+        event_id: string;
+        targets: string[];
+    }>;
+    listAgents(): Promise<ListAgent[]>;
+    getStatus(): Promise<BrokerStatus>;
+    shutdown(): Promise<void>;
+    waitForExit(): Promise<void>;
+    private startInternal;
+    private disposeProcessHandles;
+    private failAllPending;
+    private handleStdoutLine;
+    private requestHello;
+    private requestOk;
+    private sendRequest;
+}
+//# sourceMappingURL=client.d.ts.map

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

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