agent-relay 2.3.2 → 2.3.5

package/packages/sdk-py/src/agent_relay/types.py

@@ -0,0 +1,92 @@
+"""Type definitions for Agent Relay workflows."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Literal
+
+SwarmPattern = Literal[
+    "fan-out",
+    "pipeline",
+    "hub-spoke",
+    "consensus",
+    "mesh",
+    "handoff",
+    "cascade",
+    "dag",
+    "debate",
+    "hierarchical",
+]
+
+AgentCli = Literal["claude", "codex", "gemini", "aider", "goose"]
+
+
+@dataclass
+class VerificationCheck:
+    type: Literal["output_contains", "exit_code", "file_exists", "custom"]
+    value: str
+    description: str | None = None
+
+    def to_dict(self) -> dict:
+        d: dict = {"type": self.type, "value": self.value}
+        if self.description is not None:
+            d["description"] = self.description
+        return d
+
+
+@dataclass
+class AgentOptions:
+    cli: AgentCli
+    role: str | None = None
+    task: str | None = None
+    channels: list[str] | None = None
+    model: str | None = None
+    max_tokens: int | None = None
+    timeout_ms: int | None = None
+    retries: int | None = None
+
+
+@dataclass
+class StepOptions:
+    agent: str
+    task: str
+    depends_on: list[str] | None = None
+    verification: VerificationCheck | None = None
+    timeout_ms: int | None = None
+    retries: int | None = None
+
+
+@dataclass
+class ErrorOptions:
+    max_retries: int | None = None
+    retry_delay_ms: int | None = None
+    notify_channel: str | None = None
+
+
+@dataclass
+class RunOptions:
+    """Options for running a workflow."""
+
+    workflow: str | None = None
+    cwd: str | None = None
+    vars: dict[str, str] | None = None
+
+
+@dataclass
+class WorkflowResult:
+    """Result of a workflow execution."""
+
+    status: str
+    run_id: str
+    error: str | None = None
+    steps: list[StepResult] = field(default_factory=list)
+
+
+@dataclass
+class StepResult:
+    """Result of a single workflow step."""
+
+    name: str
+    status: str
+    output: str | None = None
+    error: str | None = None

package/packages/sdk-py/tests/test_builder.py

@@ -0,0 +1,101 @@
+"""Tests for the workflow builder."""
+
+import yaml
+import pytest
+from agent_relay import workflow, VerificationCheck
+
+
+def test_basic_builder():
+    config = (
+        workflow("test-workflow")
+        .pattern("dag")
+        .agent("worker", cli="claude", role="Test worker")
+        .step("do-work", agent="worker", task="Do the work")
+        .to_config()
+    )
+
+    assert config["version"] == "1.0"
+    assert config["name"] == "test-workflow"
+    assert config["swarm"]["pattern"] == "dag"
+    assert len(config["agents"]) == 1
+    assert config["agents"][0]["name"] == "worker"
+    assert config["agents"][0]["cli"] == "claude"
+    assert config["agents"][0]["role"] == "Test worker"
+    assert len(config["workflows"]) == 1
+    assert config["workflows"][0]["name"] == "test-workflow-workflow"
+    assert len(config["workflows"][0]["steps"]) == 1
+
+
+def test_full_builder():
+    config = (
+        workflow("migration")
+        .description("Full migration workflow")
+        .pattern("dag")
+        .max_concurrency(3)
+        .timeout(5_400_000)
+        .channel("migration-channel")
+        .agent("backend", cli="claude", role="Backend engineer")
+        .agent("tester", cli="codex", role="Test engineer", model="gpt-4")
+        .step(
+            "build",
+            agent="backend",
+            task="Build the API",
+            verification=VerificationCheck(type="output_contains", value="BUILD_DONE"),
+            retries=2,
+        )
+        .step(
+            "test",
+            agent="tester",
+            task="Run tests",
+            depends_on=["build"],
+            timeout_ms=600_000,
+        )
+        .on_error("retry", max_retries=2, retry_delay_ms=5000)
+        .to_config()
+    )
+
+    assert config["description"] == "Full migration workflow"
+    assert config["swarm"]["maxConcurrency"] == 3
+    assert config["swarm"]["timeoutMs"] == 5_400_000
+    assert config["swarm"]["channel"] == "migration-channel"
+
+    assert len(config["agents"]) == 2
+    assert config["agents"][1]["cli"] == "codex"
+    assert config["agents"][1]["constraints"]["model"] == "gpt-4"
+
+    steps = config["workflows"][0]["steps"]
+    assert steps[0]["verification"] == {"type": "output_contains", "value": "BUILD_DONE"}
+    assert steps[0]["retries"] == 2
+    assert steps[1]["dependsOn"] == ["build"]
+    assert steps[1]["timeoutMs"] == 600_000
+
+    assert config["errorHandling"]["strategy"] == "retry"
+    assert config["errorHandling"]["maxRetries"] == 2
+
+
+def test_to_yaml_roundtrip():
+    builder = (
+        workflow("roundtrip")
+        .pattern("fan-out")
+        .agent("a", cli="claude")
+        .step("s1", agent="a", task="Do something")
+    )
+
+    yaml_str = builder.to_yaml()
+    parsed = yaml.safe_load(yaml_str)
+
+    assert parsed["version"] == "1.0"
+    assert parsed["name"] == "roundtrip"
+    assert parsed["swarm"]["pattern"] == "fan-out"
+    assert parsed["agents"][0]["name"] == "a"
+    assert parsed["workflows"][0]["steps"][0]["task"] == "Do something"
+
+
+def test_empty_agents_raises():
+    with pytest.raises(ValueError, match="at least one agent"):
+        workflow("empty").pattern("dag").step("s", agent="a", task="x").to_config()
+
+
+def test_empty_steps_raises():
+    with pytest.raises(ValueError, match="at least one step"):
+        workflow("empty").pattern("dag").agent("a", cli="claude").to_config()

package/packages/sdk-ts/dist/__tests__/facade.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=facade.test.d.ts.map

package/packages/sdk-ts/dist/__tests__/facade.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/facade.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,257 @@
+/**
+ * Facade integration tests — exercises new AgentRelay capabilities:
+ * spawn with initial task, getLogs, waitForAny, broadcast, onAgentReady, exit code.
+ *
+ * Run:
+ *   npm run build && node --test dist/__tests__/facade.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;
+}
+function makeRelay(bin) {
+    return new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+}
+// ── spawn with initial task ─────────────────────────────────────────────────
+test("facade: spawn with initial task delivers task after worker_ready", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const readyNames = [];
+    relay.onAgentReady = (agent) => readyNames.push(agent.name);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Task-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+            task: "Hello from initial task",
+        });
+        // Wait a bit for worker_ready event to propagate
+        await new Promise((r) => setTimeout(r, 2_000));
+        assert.ok(readyNames.includes(agent.name), "onAgentReady should fire for spawned agent");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── onAgentReady ────────────────────────────────────────────────────────────
+test("facade: onAgentReady fires when worker becomes ready", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const readyAgents = [];
+    relay.onAgentReady = (agent) => readyAgents.push(agent);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Ready-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        // Give the worker time to send worker_ready
+        await new Promise((r) => setTimeout(r, 2_000));
+        assert.ok(readyAgents.some((a) => a.name === agent.name), "onAgentReady should fire with the correct agent");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── broadcast ───────────────────────────────────────────────────────────────
+test("facade: broadcast sends to all agents", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const sentMessages = [];
+    relay.onMessageSent = (msg) => sentMessages.push(msg);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Broadcast-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        const msg = await relay.broadcast("Hello everyone!");
+        assert.equal(msg.to, "*");
+        assert.equal(msg.text, "Hello everyone!");
+        assert.equal(msg.from, "human:orchestrator");
+        assert.equal(sentMessages.length, 1);
+        // Broadcast with custom from
+        const msg2 = await relay.broadcast("Custom sender", { from: "System" });
+        assert.equal(msg2.from, "System");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── waitForAny ──────────────────────────────────────────────────────────────
+test("facade: waitForAny returns first agent to exit", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    try {
+        const [a, b] = await Promise.all([
+            relay.spawnPty({ name: `WaitA-${suffix}`, cli: "cat", channels: ["general"] }),
+            relay.spawnPty({ name: `WaitB-${suffix}`, cli: "cat", channels: ["general"] }),
+        ]);
+        // Release agent A — it should be the first to exit
+        setTimeout(() => a.release(), 500);
+        const { agent, result } = await AgentRelay.waitForAny([a, b], 10_000);
+        assert.equal(agent.name, a.name);
+        assert.equal(result, "released");
+        await b.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── waitForAny with timeout ─────────────────────────────────────────────────
+test("facade: waitForAny respects timeout", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Timeout-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        const { result } = await AgentRelay.waitForAny([agent], 500);
+        assert.equal(result, "timeout");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── exit code ───────────────────────────────────────────────────────────────
+test("facade: onAgentExited populates exitCode and exitSignal", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const exitedAgents = [];
+    relay.onAgentExited = (agent) => exitedAgents.push(agent);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Exit-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        await agent.release();
+        // Give time for exit event to propagate
+        await new Promise((r) => setTimeout(r, 1_000));
+        // The agent should have exited — check that exitCode or exitSignal is set
+        // (exact values depend on how cat is terminated)
+        const exited = exitedAgents.find((a) => a.name === agent.name);
+        if (exited) {
+            assert.ok(exited.exitCode !== undefined || exited.exitSignal !== undefined, "exitCode or exitSignal should be populated");
+        }
+        // It's also valid for only onAgentReleased to fire (not onAgentExited)
+        // since the broker may clean up before the process exits
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── getLogs ──────────────────────────────────────────────────────────────────
+test("facade: getLogs returns log content for agent", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Logs-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        // Give time for some output to be logged
+        await new Promise((r) => setTimeout(r, 2_000));
+        const logs = await relay.getLogs(agent.name);
+        // Logs may or may not be found depending on whether the worker writes to the log file
+        // The important thing is the API works without error
+        assert.equal(logs.agent, agent.name);
+        assert.equal(typeof logs.found, "boolean");
+        assert.equal(typeof logs.content, "string");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── listLoggedAgents ────────────────────────────────────────────────────────
+test("facade: listLoggedAgents returns array", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const relay = makeRelay(bin);
+    try {
+        // Just verify the API works and returns an array
+        const agents = await relay.listLoggedAgents();
+        assert.ok(Array.isArray(agents));
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+//# sourceMappingURL=facade.test.js.map

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

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

package/packages/sdk-ts/dist/__tests__/unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unit.test.d.ts.map

package/packages/sdk-ts/dist/__tests__/unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/unit.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,124 @@
+/**
+ * Unit tests — no broker binary or RELAY_API_KEY required.
+ *
+ * Run:
+ *   npm run build && node --test dist/__tests__/unit.test.js
+ */
+import assert from "node:assert/strict";
+import { join } from "node:path";
+import { mkdtemp, writeFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import test from "node:test";
+import { AgentRelay } from "../relay.js";
+import { getLogs, listLoggedAgents } from "../logs.js";
+// ── waitForAny ──────────────────────────────────────────────────────────────
+function makeFakeAgent(name, exitAfterMs) {
+    let resolveExit;
+    const exitPromise = new Promise((resolve) => {
+        resolveExit = resolve;
+    });
+    if (exitAfterMs !== undefined) {
+        setTimeout(() => resolveExit?.("exited"), exitAfterMs);
+    }
+    return {
+        name,
+        runtime: "pty",
+        channels: ["general"],
+        exitCode: undefined,
+        exitSignal: undefined,
+        async release() {
+            resolveExit?.("released");
+        },
+        waitForExit(timeoutMs) {
+            if (timeoutMs === 0)
+                return Promise.resolve("timeout");
+            if (timeoutMs !== undefined) {
+                return Promise.race([
+                    exitPromise,
+                    new Promise((resolve) => setTimeout(() => resolve("timeout"), timeoutMs)),
+                ]);
+            }
+            return exitPromise;
+        },
+        async sendMessage() {
+            return { eventId: "fake", from: name, to: "", text: "" };
+        },
+    };
+}
+test("waitForAny: returns first agent to exit", async () => {
+    const fast = makeFakeAgent("fast", 50);
+    const slow = makeFakeAgent("slow", 5_000);
+    const { agent, result } = await AgentRelay.waitForAny([fast, slow], 3_000);
+    assert.equal(agent.name, "fast");
+    assert.equal(result, "exited");
+});
+test("waitForAny: returns timeout when no agent exits", async () => {
+    const a = makeFakeAgent("a");
+    const b = makeFakeAgent("b");
+    const { result } = await AgentRelay.waitForAny([a, b], 100);
+    assert.equal(result, "timeout");
+});
+test("waitForAny: handles released agent", async () => {
+    const agent = makeFakeAgent("releasable");
+    // Release after 50ms
+    setTimeout(() => agent.release(), 50);
+    const { agent: resolved, result } = await AgentRelay.waitForAny([agent], 3_000);
+    assert.equal(resolved.name, "releasable");
+    assert.equal(result, "released");
+});
+test("waitForAny: throws on empty agents array", async () => {
+    await assert.rejects(() => AgentRelay.waitForAny([]), { message: "waitForAny requires at least one agent" });
+});
+// ── getLogs ──────────────────────────────────────────────────────────────────
+test("getLogs: rejects path traversal", async () => {
+    const result = await getLogs("../../etc/passwd", {
+        logsDir: "/tmp/test-logs",
+    });
+    assert.equal(result.found, false);
+    assert.equal(result.content, "");
+});
+test("getLogs: returns not found for missing agent", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "relay-test-logs-"));
+    try {
+        const result = await getLogs("nonexistent", { logsDir: dir });
+        assert.equal(result.found, false);
+        assert.equal(result.content, "");
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+});
+test("getLogs: reads content from log file", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "relay-test-logs-"));
+    try {
+        const logContent = "line1\nline2\nline3\n";
+        await writeFile(join(dir, "TestAgent.log"), logContent);
+        const result = await getLogs("TestAgent", { logsDir: dir, lines: 2 });
+        assert.equal(result.found, true);
+        assert.equal(result.content, "line2\nline3");
+        assert.equal(result.lineCount, 2);
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+});
+test("listLoggedAgents: lists agent names from log files", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "relay-test-logs-"));
+    try {
+        await writeFile(join(dir, "Alice.log"), "hello\n");
+        await writeFile(join(dir, "Bob.log"), "world\n");
+        await writeFile(join(dir, "not-a-log.txt"), "skip\n");
+        const agents = await listLoggedAgents(dir);
+        assert.ok(agents.includes("Alice"));
+        assert.ok(agents.includes("Bob"));
+        assert.ok(!agents.includes("not-a-log"));
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+});
+test("listLoggedAgents: returns empty for missing directory", async () => {
+    const agents = await listLoggedAgents("/tmp/definitely-nonexistent-dir");
+    assert.deepEqual(agents, []);
+});
+//# sourceMappingURL=unit.test.js.map

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

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

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

@@ -16,11 +16,13 @@ export interface SpawnPtyInput {
     cli: string;
     args?: string[];
     channels?: string[];
+    task?: string;
 }
 export interface SpawnHeadlessClaudeInput {
     name: string;
     args?: string[];
     channels?: string[];
+    task?: string;
 }
 export interface SendMessageInput {
     to: string;

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

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

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

@@ -92,6 +92,7 @@ export class AgentRelayClient {
         };
         const result = await this.requestOk("spawn_agent", {
             agent,
+            ...(input.task != null ? { initial_task: input.task } : {}),
         });
         return result;
     }
@@ -105,6 +106,7 @@ export class AgentRelayClient {
         };
         const result = await this.requestOk("spawn_agent", {
             agent,
+            ...(input.task != null ? { initial_task: input.task } : {}),
         });
         return result;
     }