@agent-relay/sdk 2.3.14 → 2.3.15

package/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/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/dist/examples/workflow-superiority.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Workflow Superiority — Multi-Agent Implementation Campaign
+ *
+ * A fully specified DAG workflow that orchestrates Claude (lead + reviewer)
+ * and Codex workers across five implementation tiers to make the relay
+ * broker-sdk workflow system decisively superior to Agno and Swarms AI.
+ *
+ * Architecture:
+ *   - Claude lead: orchestrates each phase, approves trajectories, makes
+ *     final architectural decisions
+ *   - Codex workers: implement code changes, one per specialization domain
+ *   - Claude code-reviewer: independent review after every implementation phase
+ *     (separate from lead to avoid confirmation bias)
+ *
+ * DAG phases:
+ *   Phase 0 → Codebase analysis + spec approval
+ *   Phase 1 → Type system extension (condition/loop/router/hitl/sub-workflow)
+ *   Phase 2 → Execution engine (runner handles new primitives + session)
+ *   Phase 3 → Meta-orchestration (parallel with Phase 4)
+ *   Phase 4 → Storage backends (parallel with Phase 3)
+ *   Phase 5 → Deployment & observability
+ *   Phase 6 → Integration validation + final lead sign-off
+ *
+ * Run:
+ *   npx tsx src/examples/workflow-superiority.ts
+ *
+ * Environment:
+ *   RELAY_API_KEY — optional. If absent the runner auto-provisions a
+ *   fresh Relaycast workspace for each run (fully isolated, no caching).
+ */
+export {};
+//# sourceMappingURL=workflow-superiority.d.ts.map

package/dist/examples/workflow-superiority.d.ts.map

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