@agent-relay/sdk 7.1.0 → 8.0.1

package/dist/event-bus.d.ts

@@ -1,57 +0,0 @@
-/**
- * Typed multi-listener registry shared by `AgentRelay` and `AgentRelayClient`.
- *
- * Replaces the previous single-callback `on*: EventHook<T> = null` fields on
- * `AgentRelay` so multiple integrations (burn stamping, Pear UI, third-party
- * observers, …) can subscribe to the same event without stepping on each
- * other.
- *
- * Each `addListener(event, handler)` returns an unsubscribe function;
- * `removeListener(event, handler)` is also available. Handlers fire in
- * registration order; async handlers are awaited sequentially. Handler
- * exceptions are caught and logged to `console.error` so one bad listener
- * never blocks the originating operation or subsequent listeners.
- *
- * The bus is intentionally generic — callers parameterize it with a typed
- * event map (see `AgentRelayEvents` in `./lifecycle-hooks.ts`) so each
- * event's payload is fully checked at the addListener / emit boundary.
- */
-export type EventMap = Record<string, readonly unknown[]>;
-/**
- * Handler signature for an event. The optional `R` generic lets a
- * specific event widen its return type past `void` — used by the
- * `beforeAgentSpawn` lifecycle hook, whose handlers may return a
- * `SpawnPatch` that the dispatcher folds into the spawn input. The
- * default `R = void` keeps the common case strict.
- */
-export type EventHandler<Args extends readonly unknown[], R = void> = (...args: Args) => R | Promise<R>;
-export declare class EventBus<E extends EventMap> {
-    private handlers;
-    /**
-     * Register a handler for `event`. Returns an unsubscribe function that
-     * removes the handler when called.
-     *
-     * The `R` generic is inferred from the handler return type; callers
-     * that don't care about the return get the default `void` shape, while
-     * events like `beforeAgentSpawn` can pass handlers that return a
-     * `SpawnPatch`.
-     */
-    addListener<K extends keyof E, R = void>(event: K, handler: EventHandler<E[K], R>): () => void;
-    /** Remove a previously-registered handler. Idempotent. */
-    removeListener<K extends keyof E, R = void>(event: K, handler: EventHandler<E[K], R>): void;
-    /** Number of currently-registered handlers for `event`. Useful for tests. */
-    listenerCount<K extends keyof E>(event: K): number;
-    /** Snapshot the handlers for `event` so iteration is safe under concurrent mutation. */
-    listeners<K extends keyof E, R = void>(event: K): Array<EventHandler<E[K], R>>;
-    /**
-     * Fire `event` with `args`, awaiting each handler sequentially in
-     * registration order. Handler exceptions are caught and logged; they
-     * never abort the dispatch chain.
-     *
-     * Return value is intentionally `void`; consumers that need to collect
-     * patches (e.g. `beforeAgentSpawn`'s shallow-merge contract) iterate
-     * `listeners()` directly so they can capture each handler's return.
-     */
-    emit<K extends keyof E>(event: K, ...args: E[K]): Promise<void>;
-}
-//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAExG,qBAAa,QAAQ,CAAC,CAAC,SAAS,QAAQ;IAItC,OAAO,CAAC,QAAQ,CAA2E;IAE3F;;;;;;;;OAQG;IACH,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAsB9F,0DAA0D;IAC1D,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAS3F,6EAA6E;IAC7E,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAIlD,wFAAwF;IACxF,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAK9E;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAStE"}

package/dist/event-bus.js

@@ -1,76 +0,0 @@
-export class EventBus {
-    // Stored type uses `unknown` for `R` so a single Set can hold handlers
-    // from any overload — the dispatcher casts back when it cares about a
-    // non-void return value (see `runBeforeSpawn` in `client.ts`).
-    handlers = new Map();
-    /**
-     * Register a handler for `event`. Returns an unsubscribe function that
-     * removes the handler when called.
-     *
-     * The `R` generic is inferred from the handler return type; callers
-     * that don't care about the return get the default `void` shape, while
-     * events like `beforeAgentSpawn` can pass handlers that return a
-     * `SpawnPatch`.
-     */
-    addListener(event, handler) {
-        let set = this.handlers.get(event);
-        if (!set) {
-            set = new Set();
-            this.handlers.set(event, set);
-        }
-        set.add(handler);
-        return () => {
-            // Re-read the current Set from the map so a stale closure can't blow
-            // away the new Set if the caller unsubscribes, re-registers a fresh
-            // handler under the same event, then calls the original `off` again.
-            // Without this identity check the double-`off()` would silently drop
-            // every listener for the event.
-            const current = this.handlers.get(event);
-            if (current !== set)
-                return;
-            current.delete(handler);
-            if (current.size === 0) {
-                this.handlers.delete(event);
-            }
-        };
-    }
-    /** Remove a previously-registered handler. Idempotent. */
-    removeListener(event, handler) {
-        const set = this.handlers.get(event);
-        if (!set)
-            return;
-        set.delete(handler);
-        if (set.size === 0) {
-            this.handlers.delete(event);
-        }
-    }
-    /** Number of currently-registered handlers for `event`. Useful for tests. */
-    listenerCount(event) {
-        return this.handlers.get(event)?.size ?? 0;
-    }
-    /** Snapshot the handlers for `event` so iteration is safe under concurrent mutation. */
-    listeners(event) {
-        const set = this.handlers.get(event);
-        return set ? Array.from(set) : [];
-    }
-    /**
-     * Fire `event` with `args`, awaiting each handler sequentially in
-     * registration order. Handler exceptions are caught and logged; they
-     * never abort the dispatch chain.
-     *
-     * Return value is intentionally `void`; consumers that need to collect
-     * patches (e.g. `beforeAgentSpawn`'s shallow-merge contract) iterate
-     * `listeners()` directly so they can capture each handler's return.
-     */
-    async emit(event, ...args) {
-        for (const handler of this.listeners(event)) {
-            try {
-                await handler(...args);
-            }
-            catch (err) {
-                console.error(`[agent-relay] listener for "${String(event)}" threw:`, err);
-            }
-        }
-    }
-}
-//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,QAAQ;IACnB,uEAAuE;IACvE,sEAAsE;IACtE,+DAA+D;IACvD,QAAQ,GAAiE,IAAI,GAAG,EAAE,CAAC;IAE3F;;;;;;;;OAQG;IACH,WAAW,CAA8B,KAAQ,EAAE,OAA8B;QAC/E,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAoD,CAAC,CAAC;QAC9D,OAAO,GAAG,EAAE;YACV,qEAAqE;YACrE,oEAAoE;YACpE,qEAAqE;YACrE,qEAAqE;YACrE,gCAAgC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,OAAO,KAAK,GAAG;gBAAE,OAAO;YAC5B,OAAO,CAAC,MAAM,CAAC,OAAoD,CAAC,CAAC;YACrE,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,cAAc,CAA8B,KAAQ,EAAE,OAA8B;QAClF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,GAAG,CAAC,MAAM,CAAC,OAAoD,CAAC,CAAC;QACjE,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,aAAa,CAAoB,KAAQ;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,wFAAwF;IACxF,SAAS,CAA8B,KAAQ;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC,CAAC,CAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAkC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAoB,KAAQ,EAAE,GAAG,IAAU;QACnD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/examples/demo.d.ts

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

package/dist/examples/demo.d.ts.map

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

package/dist/examples/demo.js

@@ -1,63 +0,0 @@
-/**
- * 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.addListener('messageReceived', (message) => {
-    console.log(`  📨 received  │ from=${message.from}  to=${message.to}  text="${message.text}"`);
-});
-relay.addListener('messageSent', (message) => {
-    console.log(`  📤 sent      │ from=${message.from}  to=${message.to}  text="${message.text}"`);
-});
-relay.addListener('agentSpawned', (agent) => {
-    console.log(`  🟢 spawned   │ ${agent.name} (${agent.runtime})`);
-});
-relay.addListener('agentReleased', (agent) => {
-    console.log(`  🔴 released  │ ${agent.name}`);
-});
-relay.addListener('agentExited', (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/dist/examples/demo.js.map

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

package/dist/examples/example.d.ts

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

package/dist/examples/example.d.ts.map

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

package/dist/examples/example.js

@@ -1,77 +0,0 @@
-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.spawn({
-        channels: [channel],
-        onStderr: (line) => console.log(`[${now()}] broker:stderr ${line}`),
-    });
-    const stopLogging = client.onEvent((event) => {
-        console.log(`[${now()}] event`, JSON.stringify(event));
-    });
-    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();
-    };
-    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 mcp__relaycast__message_dm_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/dist/examples/example.js.map

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

package/dist/examples/persona-spawn.d.ts

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

package/dist/examples/persona-spawn.d.ts.map

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

package/dist/examples/persona-spawn.js

@@ -1,43 +0,0 @@
-/**
- * persona-spawn — spawn an agent from an AgentWorkforce persona.
- *
- * Personas are JSON files describing a pre-configured agent (harness, model,
- * system prompt, MCP servers, permissions). They live in
- *   ./agentworkforce/personas
- * or any directory you pass via `searchDirs` / `extraDirs`.
- *
- * Run:
- *   npm run build && node dist/examples/persona-spawn.js frontend "Build a settings page"
- *
- * Environment:
- *   RELAY_API_KEY — Relaycast workspace key (required)
- */
-import { AgentRelay } from '../relay.js';
-import { listPersonas } from '../personas.js';
-const [, , personaId, ...taskParts] = process.argv;
-const task = taskParts.join(' ').trim();
-if (!personaId) {
-    const found = listPersonas();
-    console.error('Usage: persona-spawn <personaId> [task...]\n');
-    if (found.length > 0) {
-        console.error('Personas discovered in the default cascade:');
-        for (const p of found) {
-            console.error(`  - ${p.id}  (${p.path})`);
-        }
-    }
-    else {
-        console.error('No personas found. Place JSON files under ./agentworkforce/personas ' + 'or set AGENT_WORKFORCE_HOME.');
-    }
-    process.exit(1);
-}
-const relay = new AgentRelay();
-relay.addListener('agentSpawned', (agent) => console.log(`spawned ${agent.name} (${agent.runtime})`));
-relay.addListener('agentExited', (agent) => console.log(`exited ${agent.name} code=${agent.exitCode ?? 'none'}`));
-const agent = await relay.spawnPersona(personaId, {
-    ...(task ? { task } : {}),
-    channels: ['general'],
-});
-console.log(`agent ${agent.name} ready, waiting for exit...`);
-await agent.waitForExit();
-await relay.shutdown();
-//# sourceMappingURL=persona-spawn.js.map

package/dist/examples/persona-spawn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"persona-spawn.js","sourceRoot":"","sources":["../../src/examples/persona-spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,CAAC,EAAE,AAAD,EAAG,SAAS,EAAE,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AACnD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAExC,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,sEAAsE,GAAG,8BAA8B,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;AAE/B,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;AACtG,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CACzC,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CACrE,CAAC;AAEF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE;IAChD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,6BAA6B,CAAC,CAAC;AAC9D,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;AAC1B,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC"}

package/dist/examples/quickstart.d.ts

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

package/dist/examples/quickstart.d.ts.map

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

package/dist/examples/quickstart.js

@@ -1,56 +0,0 @@
-/**
- * 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.addListener('messageReceived', (message) => {
-    console.log(`message received  → from=${message.from} to=${message.to}`);
-});
-relay.addListener('messageSent', (message) => {
-    console.log(`message sent      → from=${message.from} to=${message.to}`);
-});
-relay.addListener('agentSpawned', (agent) => {
-    console.log(`agent spawned     → ${agent.name} (${agent.runtime})`);
-});
-relay.addListener('agentReleased', (agent) => {
-    console.log(`agent released    → ${agent.name}`);
-});
-relay.addListener('agentExited', (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/dist/examples/quickstart.js.map

@@ -1 +0,0 @@
-{"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,WAAW,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,EAAE;IAC/C,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;IAC3C,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;IAC1C,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;IAC3C,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;IACzC,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,+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/dist/examples/ralph-loop.d.ts

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

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

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