@agent-relay/sdk 7.1.0 → 8.0.1

package/dist/examples/ralph-loop.js

@@ -1,281 +0,0 @@
-/**
- * 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 workspace.set_key with your RELAY_API_KEY env var`,
-        `2. Call agent.register with your name`,
-        `3. Use message.post 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 workspace.set_key with your RELAY_API_KEY env var`,
-        `2. Call agent.register with your name`,
-        `3. Use message.post 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.addListener('messageReceived', (msg) => {
-    channelLog.push(msg);
-    console.log(`  💬 ${msg.from}: "${msg.text.slice(0, 80)}…"`);
-});
-relay.addListener('agentSpawned', (agent) => console.log(`  🟢 ${agent.name} spawned (${agent.runtime})`));
-relay.addListener('agentReleased', (agent) => console.log(`  🔴 ${agent.name} released`));
-relay.addListener('agentExited', (agent) => console.log(`  ⚪ ${agent.name} exited`));
-relay.addListener('messageSent', (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

@@ -1 +0,0 @@
-{"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

@@ -1,32 +0,0 @@
-/**
- * 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

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