agent-relay 2.2.23 → 2.3.0

package/packages/sdk-ts/dist/examples/demo.js

@@ -0,0 +1,63 @@
+/**
+ * Runnable demo — shows the full AgentRelay message flow with real output.
+ * Uses `cat` as a universally-available stand-in for agent CLIs.
+ *
+ * Run:
+ *   npm run build && npm run demo
+ */
+import { AgentRelay } from "../relay.js";
+const relay = new AgentRelay({ env: process.env });
+// ── Event hooks ─────────────────────────────────────────────────────────────
+relay.onMessageReceived = (message) => {
+    console.log(`  📨 received  │ from=${message.from}  to=${message.to}  text="${message.text}"`);
+};
+relay.onMessageSent = (message) => {
+    console.log(`  📤 sent      │ from=${message.from}  to=${message.to}  text="${message.text}"`);
+};
+relay.onAgentSpawned = (agent) => {
+    console.log(`  🟢 spawned   │ ${agent.name} (${agent.runtime})`);
+};
+relay.onAgentReleased = (agent) => {
+    console.log(`  🔴 released  │ ${agent.name}`);
+};
+relay.onAgentExited = (agent) => {
+    console.log(`  ⚪ exited    │ ${agent.name}`);
+};
+// ── Spawn agents ────────────────────────────────────────────────────────────
+console.log("\n─── Spawning agents ───\n");
+const [agentA, agentB] = await Promise.all([
+    relay.spawnPty({ name: "AgentA", cli: "claude", args: ["--print"], channels: ["general"] }),
+    relay.spawnPty({ name: "AgentB", cli: "claude", args: ["--print"], channels: ["general"] }),
+]);
+// ── Send messages ───────────────────────────────────────────────────────────
+console.log("\n─── Sending messages ───\n");
+const human = relay.human({ name: "System" });
+await human.sendMessage({ to: agentA.name, text: "Hello AgentA, welcome!" });
+await human.sendMessage({ to: agentB.name, text: "Hello AgentB, welcome!" });
+// Agent-to-agent messaging
+await agentA.sendMessage({ to: agentB.name, text: "Hey B, got a task for you" });
+await agentB.sendMessage({ to: agentA.name, text: "On it!" });
+// Threaded conversation
+const thread = await human.sendMessage({ to: agentA.name, text: "Status update?" });
+await agentA.sendMessage({ to: human.name, text: "All good!", threadId: thread.eventId });
+// Priority messages
+await human.sendMessage({ to: agentA.name, text: "Critical alert!", priority: 0 });
+await human.sendMessage({ to: agentB.name, text: "Low priority FYI", priority: 4 });
+// Small delay to let events propagate
+await new Promise((r) => setTimeout(r, 500));
+// ── List agents ─────────────────────────────────────────────────────────────
+console.log("\n─── Active agents ───\n");
+const agents = await relay.listAgents();
+for (const agent of agents) {
+    console.log(`  • ${agent.name}  runtime=${agent.runtime}  channels=[${agent.channels}]`);
+}
+// ── Release all ─────────────────────────────────────────────────────────────
+console.log("\n─── Releasing agents ───\n");
+for (const agent of agents) {
+    await agent.release();
+}
+await new Promise((r) => setTimeout(r, 300));
+// ── Shutdown ────────────────────────────────────────────────────────────────
+await relay.shutdown();
+console.log("\n─── Done ───\n");
+//# sourceMappingURL=demo.js.map

package/packages/sdk-ts/dist/examples/demo.js.map

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

package/packages/sdk-ts/dist/examples/example.d.ts

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

package/packages/sdk-ts/dist/examples/example.d.ts.map

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

package/packages/sdk-ts/dist/examples/example.js

@@ -0,0 +1,80 @@
+import { AgentRelayClient } from "../client.js";
+function parseArgs(raw) {
+    if (!raw || raw.trim() === "") {
+        return [];
+    }
+    return raw
+        .split(" ")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+function now() {
+    return new Date().toISOString();
+}
+async function main() {
+    const codexCmd = process.env.CODEX_CMD ?? "codex";
+    const codexArgs = parseArgs(process.env.CODEX_ARGS);
+    const channel = process.env.RELAY_CHANNEL ?? "general";
+    const xName = process.env.AGENT_X_NAME ?? "CodexX";
+    const oName = process.env.AGENT_O_NAME ?? "CodexO";
+    const client = await AgentRelayClient.start({
+        channels: [channel],
+    });
+    const stopLogging = client.onEvent((event) => {
+        console.log(`[${now()}] event`, JSON.stringify(event));
+    });
+    const stopStderrLogging = client.onBrokerStderr((line) => {
+        console.log(`[${now()}] broker:stderr ${line}`);
+    });
+    const cleanup = async () => {
+        console.log(`[${now()}] cleaning up agents + broker`);
+        try {
+            await client.release(xName);
+        }
+        catch {
+            // ignore
+        }
+        try {
+            await client.release(oName);
+        }
+        catch {
+            // ignore
+        }
+        await client.shutdown();
+        stopLogging();
+        stopStderrLogging();
+    };
+    process.on("SIGINT", async () => {
+        console.log(`[${now()}] SIGINT received`);
+        await cleanup();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        console.log(`[${now()}] SIGTERM received`);
+        await cleanup();
+        process.exit(0);
+    });
+    console.log(`[${now()}] spawning ${xName} (${codexCmd} ${codexArgs.join(" ")})`);
+    await client.spawnPty({
+        name: xName,
+        cli: codexCmd,
+        args: codexArgs,
+        channels: [channel],
+    });
+    console.log(`[${now()}] spawning ${oName} (${codexCmd} ${codexArgs.join(" ")})`);
+    await client.spawnPty({
+        name: oName,
+        cli: codexCmd,
+        args: codexArgs,
+        channels: [channel],
+    });
+    console.log(`[${now()}] workers spawned. send kickoff via Relaycast (MCP relay_send) and watch events here (Ctrl+C to stop).`);
+    await new Promise(() => {
+        // keep process alive while events stream
+    });
+}
+main().catch((error) => {
+    console.error(`[${now()}] fatal`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=example.js.map

package/packages/sdk-ts/dist/examples/example.js.map

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

package/packages/sdk-ts/dist/examples/quickstart.d.ts

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

package/packages/sdk-ts/dist/examples/quickstart.d.ts.map

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

package/packages/sdk-ts/dist/examples/quickstart.js

@@ -0,0 +1,56 @@
+/**
+ * Quickstart — shows the clean AgentRelay facade API.
+ *
+ * Run:
+ *   npm run build && npm run quickstart
+ *
+ * Environment:
+ *   RELAY_API_KEY   — Relaycast workspace key (required)
+ *   AGENT_RELAY_BIN — path to agent-relay binary (optional)
+ */
+import { AgentRelay } from "../relay.js";
+// The Relay is the communication backbone for your agents.
+// Drop it into your codebase and let your agents communicate.
+const relay = new AgentRelay();
+// ── Event hooks ─────────────────────────────────────────────────────────────
+relay.onMessageReceived = (message) => {
+    console.log(`message received  → from=${message.from} to=${message.to}`);
+};
+relay.onMessageSent = (message) => {
+    console.log(`message sent      → from=${message.from} to=${message.to}`);
+};
+relay.onAgentSpawned = (agent) => {
+    console.log(`agent spawned     → ${agent.name} (${agent.runtime})`);
+};
+relay.onAgentReleased = (agent) => {
+    console.log(`agent released    → ${agent.name}`);
+};
+relay.onAgentExited = (agent) => {
+    console.log(`agent exited      → ${agent.name}`);
+};
+// ── Create agents with sane defaults, running locally ───────────────────────
+const [codex, claude, gemini] = await Promise.all([
+    relay.codex.spawn(),
+    relay.claude.spawn(),
+    relay.gemini.spawn(),
+]);
+// ── Configure messaging with custom CLI agents ─────────────────────────────
+const worker1 = await relay.spawnPty({
+    name: "Worker1",
+    cli: "codex",
+    args: ["--model", "gpt-5"],
+    channels: ["general"],
+});
+// ── Control messaging from non-agent sources ────────────────────────────────
+const human = relay.human({ name: "System" });
+await human.sendMessage({ to: codex.name, text: "Hello, world!" });
+// ── List agents ─────────────────────────────────────────────────────────────
+const agents = await relay.listAgents();
+for (const agent of agents) {
+    console.log(`  ${agent.name}  runtime=${agent.runtime}  channels=[${agent.channels}]`);
+}
+for (const agent of agents) {
+    await agent.release();
+}
+await relay.shutdown();
+//# sourceMappingURL=quickstart.js.map

package/packages/sdk-ts/dist/examples/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../src/examples/quickstart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,2DAA2D;AAC3D,8DAA8D;AAC9D,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;AAE/B,+EAA+E;AAE/E,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,EAAE;IACpC,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF,KAAK,CAAC,aAAa,GAAG,CAAC,OAAO,EAAE,EAAE;IAChC,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF,KAAK,CAAC,cAAc,GAAG,CAAC,KAAK,EAAE,EAAE;IAC/B,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,EAAE,EAAE;IAChC,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,KAAK,CAAC,aAAa,GAAG,CAAC,KAAK,EAAE,EAAE;IAC9B,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,+EAA+E;AAE/E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;IAChD,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;IACnB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE;IACpB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE;CACrB,CAAC,CAAC;AAEH,8EAA8E;AAE9E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC;IACnC,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,OAAO;IACZ,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC,CAAC;AAEH,+EAA+E;AAE/E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC9C,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AAEnE,+EAA+E;AAE/E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;AACxC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,OAAO,eAAe,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzF,CAAC;AAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;IAC3B,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC"}

package/packages/sdk-ts/dist/examples/ralph-loop.d.ts

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

package/packages/sdk-ts/dist/examples/ralph-loop.d.ts.map

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

package/packages/sdk-ts/dist/examples/ralph-loop.js

@@ -0,0 +1,281 @@
+/**
+ * Ralph Loop — Claude + Codex pair-programming through a PRD.
+ *
+ * Each iteration spawns TWO agents that work together simultaneously:
+ *   - Claude (PTY) — the architect. Plans, guides, and reviews.
+ *   - Codex (PTY, --full-auto) — the builder. Implements the code.
+ *
+ * Both agents join #general and communicate in real-time:
+ *   1. Claude receives the story and posts an implementation plan
+ *   2. Codex receives the story + sees Claude's plan on #general
+ *   3. As Codex works, Claude can course-correct via the channel
+ *   4. When Codex finishes, Claude reviews and posts REVIEW:PASS/FAIL
+ *   5. Quality checks run, story marked done or retried with feedback
+ *
+ * Why two agents instead of one?
+ *   - Claude reasons about architecture, Codex executes rapidly
+ *   - They see each other's messages in real-time (not just handoffs)
+ *   - Fresh eyes on review catch mistakes a single agent misses
+ *   - Each iteration is doubly effective — thinking + doing in parallel
+ *
+ * Run:
+ *   npx tsc && npm run ralph
+ *
+ * References:
+ *   https://github.com/snarktank/ralph
+ *   https://ghuntley.com/ralph/
+ */
+import fs from "node:fs";
+import { execSync } from "node:child_process";
+import { AgentRelay } from "../relay.js";
+// ── Configuration ───────────────────────────────────────────────────────────
+const PRD_PATH = process.env.PRD_PATH ?? "prd.json";
+const PROGRESS_PATH = process.env.PROGRESS_PATH ?? "progress.txt";
+const MAX_ITERATIONS = Number(process.env.MAX_ITERATIONS ?? 10);
+const MAX_REVIEW_ROUNDS = Number(process.env.MAX_REVIEW_ROUNDS ?? 2);
+const QUALITY_CMD = process.env.QUALITY_CMD ?? "npm run check";
+/** Max time (ms) to wait for both agents per round before releasing them. */
+const ROUND_TIMEOUT_MS = Number(process.env.ROUND_TIMEOUT_MS ?? 5 * 60 * 1000);
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function loadPrd() {
+    return JSON.parse(fs.readFileSync(PRD_PATH, "utf-8"));
+}
+function savePrd(prd) {
+    fs.writeFileSync(PRD_PATH, JSON.stringify(prd, null, 2) + "\n");
+}
+function appendProgress(entry) {
+    const line = `[${new Date().toISOString()}] ${entry}\n`;
+    fs.appendFileSync(PROGRESS_PATH, line);
+}
+function readProgress() {
+    return fs.existsSync(PROGRESS_PATH)
+        ? fs.readFileSync(PROGRESS_PATH, "utf-8")
+        : "";
+}
+function nextStory(prd) {
+    return prd.userStories.find((s) => !s.passes);
+}
+function runQualityChecks() {
+    try {
+        const output = execSync(QUALITY_CMD, { encoding: "utf-8", stdio: "pipe" });
+        return { passed: true, output };
+    }
+    catch (err) {
+        const output = err.stdout ?? String(err);
+        return { passed: false, output };
+    }
+}
+// ── Prompt builders ─────────────────────────────────────────────────────────
+function architectPrompt(story, progress) {
+    const criteria = story.acceptanceCriteria.map((c) => `  - ${c}`).join("\n");
+    return [
+        `## Architect: ${story.title}`,
+        ``,
+        `You are the architect. A Codex agent ("Builder") is working alongside you.`,
+        `You are both on the #general channel and can communicate freely.`,
+        ``,
+        `### How to communicate`,
+        `Use the Relaycast MCP tools to post messages to #general:`,
+        `1. Call set_workspace_key with your RELAY_API_KEY env var`,
+        `2. Register as an agent using your name`,
+        `3. Use post_message to send to the #general channel`,
+        ``,
+        story.description,
+        ``,
+        `### Acceptance Criteria`,
+        criteria,
+        ``,
+        `### Previous Learnings`,
+        progress || "(first story)",
+        ``,
+        `### Your job`,
+        `1. Post a concise implementation plan to #general (files, changes, edge cases)`,
+        `2. Monitor the Builder's progress messages on the channel`,
+        `3. Provide guidance if the Builder asks questions or goes off track`,
+        `4. When the Builder says it's done, review the git diff`,
+        `5. Post exactly "REVIEW:PASS" to #general if all criteria are met`,
+        `6. Post exactly "REVIEW:FAIL" followed by feedback to #general if issues remain`,
+        ``,
+        `IMPORTANT: You MUST use Relaycast MCP tools to post messages. This is how`,
+        `the orchestrator knows you're done. Post your plan first, then your verdict.`,
+    ].join("\n");
+}
+function builderPrompt(story, progress, reviewFeedback) {
+    const criteria = story.acceptanceCriteria.map((c) => `  - ${c}`).join("\n");
+    const sections = [
+        `## Builder: ${story.title}`,
+        ``,
+        `You are the builder. A Claude agent ("Architect") is guiding you on #general.`,
+        `Read the Architect's plan from the channel and implement it.`,
+        ``,
+        `### How to communicate`,
+        `Use the Relaycast MCP tools to post messages to #general:`,
+        `1. Call set_workspace_key with your RELAY_API_KEY env var`,
+        `2. Register as an agent using your name`,
+        `3. Use post_message to send to the #general channel`,
+        ``,
+        story.description,
+        ``,
+        `### Acceptance Criteria`,
+        criteria,
+    ];
+    if (reviewFeedback) {
+        sections.push(``, `### Review Feedback (fix these issues first)`, reviewFeedback);
+    }
+    sections.push(``, `### Previous Learnings`, progress || "(first story)", ``, `### Your job`, `1. Read the Architect's plan from #general`, `2. Implement the changes`, `3. Post progress updates to #general as you work`, `4. When done, post exactly "IMPLEMENTATION COMPLETE" to #general`, ``, `IMPORTANT: You MUST use Relaycast MCP tools to post messages. This is how`, `the orchestrator knows you're done.`);
+    return sections.join("\n");
+}
+// ── Main loop ───────────────────────────────────────────────────────────────
+const relay = new AgentRelay({ env: process.env });
+const channelLog = [];
+relay.onMessageReceived = (msg) => {
+    channelLog.push(msg);
+    console.log(`  💬 ${msg.from}: "${msg.text.slice(0, 80)}…"`);
+};
+relay.onAgentSpawned = (agent) => console.log(`  🟢 ${agent.name} spawned (${agent.runtime})`);
+relay.onAgentReleased = (agent) => console.log(`  🔴 ${agent.name} released`);
+relay.onAgentExited = (agent) => console.log(`  ⚪ ${agent.name} exited`);
+relay.onMessageSent = (msg) => console.log(`  📤 → ${msg.to}: "${msg.text.slice(0, 60)}…"`);
+const prd = loadPrd();
+const orchestrator = relay.human({ name: "Ralph" });
+console.log(`\n══ Ralph Loop (Claude + Codex) ══`);
+console.log(`  branch: ${prd.branchName}`);
+console.log(`  stories: ${prd.userStories.length}`);
+console.log(`  remaining: ${prd.userStories.filter((s) => !s.passes).length}`);
+console.log(`  max iterations: ${MAX_ITERATIONS}`);
+console.log(`  max review rounds: ${MAX_REVIEW_ROUNDS}\n`);
+let iteration = 0;
+while (iteration < MAX_ITERATIONS) {
+    const story = nextStory(prd);
+    if (!story)
+        break;
+    iteration++;
+    console.log(`\n── Story ${story.id}: ${story.title} (iteration ${iteration}) ──\n`);
+    let reviewFeedback;
+    let storyPassed = false;
+    for (let round = 0; round < MAX_REVIEW_ROUNDS; round++) {
+        const roundLabel = round === 0 ? "initial" : `fix-${round}`;
+        const progress = readProgress();
+        // ── Spawn both agents concurrently ──────────────────────────────────
+        console.log(`  ⚡ Spawning Claude (architect) + Codex (builder) — round: ${roundLabel}`);
+        const [architect, builder] = await Promise.all([
+            relay.claude.spawn({
+                name: `Architect-${story.id}-${roundLabel}`,
+                channels: ["general"],
+            }),
+            relay.codex.spawn({
+                name: `Builder-${story.id}-${roundLabel}`,
+                args: ["--full-auto"],
+                channels: ["general"],
+            }),
+        ]);
+        // ── Inject tasks via relay ──────────────────────────────────────────
+        // Claude gets the architect prompt first so it can post the plan
+        await orchestrator.sendMessage({
+            to: architect.name,
+            text: architectPrompt(story, progress),
+        });
+        // Small delay so Claude's plan arrives before Codex starts reading
+        await new Promise((r) => setTimeout(r, 2000));
+        await orchestrator.sendMessage({
+            to: builder.name,
+            text: builderPrompt(story, progress, reviewFeedback),
+        });
+        // ── Wait for agents to finish or detect completion ────────────────────
+        // Interactive agents don't exit on their own, so we poll channel
+        // messages for completion signals and release them when done.
+        console.log(`  ⏳ Claude + Codex working together on #general…`);
+        const startLen = channelLog.length;
+        const deadline = Date.now() + ROUND_TIMEOUT_MS;
+        let verdict;
+        // Poll every 5s for completion signals in channel messages
+        while (Date.now() < deadline) {
+            const recent = channelLog.slice(startLen);
+            // Check if Claude posted a review verdict
+            const review = recent.find((m) => m.text.includes("REVIEW:PASS") || m.text.includes("REVIEW:FAIL"));
+            if (review) {
+                verdict = review.text;
+                console.log(`  📋 Claude posted verdict`);
+                break;
+            }
+            // Check if Codex signaled completion (Claude may still be reviewing)
+            const implDone = recent.find((m) => m.text.includes("IMPLEMENTATION COMPLETE"));
+            if (implDone) {
+                console.log(`  📋 Codex finished, waiting for Claude's review…`);
+                // Give Claude up to 60s more to post a verdict
+                const reviewDeadline = Date.now() + 60_000;
+                while (Date.now() < reviewDeadline) {
+                    await new Promise((r) => setTimeout(r, 3000));
+                    const afterImpl = channelLog.slice(startLen);
+                    const rv = afterImpl.find((m) => m.text.includes("REVIEW:PASS") || m.text.includes("REVIEW:FAIL"));
+                    if (rv) {
+                        verdict = rv.text;
+                        break;
+                    }
+                }
+                break;
+            }
+            // Check if either agent exited on its own
+            const archResult = await architect.waitForExit(0);
+            const buildResult = await builder.waitForExit(0);
+            if (archResult !== "timeout" && buildResult !== "timeout")
+                break;
+            await new Promise((r) => setTimeout(r, 5000));
+        }
+        // Release both agents (they're interactive so won't exit on their own)
+        const cleanup = async (agent) => {
+            try {
+                await agent.release();
+            }
+            catch { /* already exited */ }
+        };
+        await Promise.all([cleanup(architect), cleanup(builder)]);
+        // ── Quality gate ────────────────────────────────────────────────────
+        console.log(`  🔍 running quality checks…`);
+        const quality = runQualityChecks();
+        if (!quality.passed) {
+            appendProgress(`❌ ${story.id} round=${roundLabel} — quality checks failed`);
+            reviewFeedback = `Quality checks failed:\n${quality.output.slice(0, 500)}`;
+            console.log(`  ❌ quality checks failed\n`);
+            continue;
+        }
+        // ── Check verdict ─────────────────────────────────────────────────────
+        if (verdict?.includes("REVIEW:PASS")) {
+            storyPassed = true;
+            appendProgress(`✅ ${story.id} — ${story.title} — PASSED (round=${roundLabel})`);
+            console.log(`  ✅ story passed!\n`);
+            break;
+        }
+        else if (verdict?.includes("REVIEW:FAIL")) {
+            const failText = verdict.replace("REVIEW:FAIL", "").trim();
+            reviewFeedback = failText;
+            appendProgress(`🔄 ${story.id} round=${roundLabel} — review failed: ${reviewFeedback.slice(0, 200)}`);
+            console.log(`  🔄 review failed, starting new round\n`);
+        }
+        else {
+            // No verdict from Claude — quality passed so accept it
+            storyPassed = true;
+            appendProgress(`✅ ${story.id} — ${story.title} — PASSED (quality only, round=${roundLabel})`);
+            console.log(`  ✅ quality passed (no explicit review verdict)\n`);
+            break;
+        }
+    }
+    if (storyPassed) {
+        story.passes = true;
+        savePrd(prd);
+    }
+    else {
+        appendProgress(`⚠️ ${story.id} — exhausted review rounds, moving on`);
+        console.log(`  ⚠️ exhausted ${MAX_REVIEW_ROUNDS} review rounds for ${story.id}\n`);
+    }
+}
+// ── Summary ─────────────────────────────────────────────────────────────────
+const remaining = prd.userStories.filter((s) => !s.passes);
+if (remaining.length === 0) {
+    console.log(`\n🎉 COMPLETE — all stories pass.`);
+}
+else {
+    console.log(`\n⚠️ ${remaining.length} stories remain after ${iteration} iterations.`);
+}
+await relay.shutdown();
+//# sourceMappingURL=ralph-loop.js.map

package/packages/sdk-ts/dist/examples/ralph-loop.js.map

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

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

@@ -0,0 +1,9 @@
+export * from "./protocol.js";
+export * from "./client.js";
+export * from "./relaycast.js";
+export * from "./pty.js";
+export * from "./relay.js";
+export * from "./logs.js";
+export * from "./consensus.js";
+export * from "./shadow.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,9 @@
+export * from "./protocol.js";
+export * from "./client.js";
+export * from "./relaycast.js";
+export * from "./pty.js";
+export * from "./relay.js";
+export * from "./logs.js";
+export * from "./consensus.js";
+export * from "./shadow.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Log reading utilities for the broker SDK.
+ *
+ * Reads agent logs from the local filesystem at
+ * `.agent-relay/worker-logs/{agent}.log`.
+ */
+export interface GetLogsOptions {
+    /** Directory containing worker logs. Defaults to `.agent-relay/worker-logs` in cwd. */
+    logsDir?: string;
+    /** Number of lines to return from the end. Default: 50 */
+    lines?: number;
+}
+export interface LogsResult {
+    agent: string;
+    content: string;
+    found: boolean;
+    lineCount: number;
+    /** Other agents that have log files (populated when `found` is false). */
+    availableAgents?: string[];
+}
+/**
+ * Get logs for a specific agent.
+ *
+ * @example
+ * ```ts
+ * import { getLogs } from "agent-relay/broker";
+ *
+ * const result = await getLogs("Worker1", { lines: 100 });
+ * if (result.found) {
+ *   console.log(result.content);
+ * }
+ * ```
+ */
+export declare function getLogs(agent: string, options?: GetLogsOptions): Promise<LogsResult>;
+/**
+ * List all agents that have log files.
+ *
+ * @example
+ * ```ts
+ * import { listLoggedAgents } from "agent-relay/broker";
+ *
+ * const agents = await listLoggedAgents();
+ * console.log("Agents with logs:", agents);
+ * ```
+ */
+export declare function listLoggedAgents(logsDir?: string): Promise<string[]>;
+//# sourceMappingURL=logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2ED;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW1E"}