agent-relay 2.2.23 → 2.3.0

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/mcp",
-  "version": "2.2.23",
+  "version": "2.3.0",
   "description": "MCP server for Agent Relay - native messaging tools for AI agents in Claude, Cursor, and VS Code",
   "author": "Agent Workforce Inc.",
   "license": "Apache-2.0",
@@ -47,15 +47,15 @@
     "prepublishOnly": "npm run clean && npm run build && npm test"
   },
   "dependencies": {
-    "@agent-relay/config": "2.2.23",
-    "@agent-relay/protocol": "2.2.23",
-    "@agent-relay/utils": "2.2.23",
+    "@agent-relay/config": "2.3.0",
+    "@agent-relay/protocol": "2.3.0",
+    "@agent-relay/utils": "2.3.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "smol-toml": "^1.6.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agent-relay/sdk": "2.2.23",
+    "@agent-relay/sdk": "2.3.0",
     "@types/node": "^22.19.3",
     "typescript": "^5.9.3",
     "vitest": "^2.1.9"

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/memory",
-  "version": "2.2.23",
+  "version": "2.3.0",
   "description": "Semantic memory storage and retrieval system for agent-relay with multiple backend support",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/hooks": "2.2.23"
+    "@agent-relay/hooks": "2.3.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/policy",
-  "version": "2.2.23",
+  "version": "2.3.0",
   "description": "Agent policy management with multi-level fallback (repo, local PRPM, cloud workspace)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "2.2.23"
+    "@agent-relay/config": "2.3.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/protocol",
-  "version": "2.2.23",
+  "version": "2.3.0",
   "description": "Wire protocol types and framing for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/resiliency/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/resiliency",
-  "version": "2.2.23",
+  "version": "2.3.0",
   "description": "Health monitoring, logging, metrics, and crash resilience utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

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

@@ -245,7 +245,7 @@ export declare class RelayClient {
      * @param options.shadowSpeakOn - Shadow speak-on triggers
      * @param options.waitForReady - Wait for the agent to be ready before resolving (default: false)
      * @param options.readyTimeoutMs - Timeout for agent to become ready (default: 60000ms)
-     * @param timeoutMs - Timeout for spawn operation (default: 30000ms)
+     * @param timeoutMs - Timeout for spawn operation (default: 60000ms)
      * @returns Spawn result. When waitForReady is true, includes `ready` and `readyInfo` fields.
      */
     spawn(options: {

package/packages/sdk/dist/client.js

@@ -513,10 +513,10 @@ export class RelayClient {
      * @param options.shadowSpeakOn - Shadow speak-on triggers
      * @param options.waitForReady - Wait for the agent to be ready before resolving (default: false)
      * @param options.readyTimeoutMs - Timeout for agent to become ready (default: 60000ms)
-     * @param timeoutMs - Timeout for spawn operation (default: 30000ms)
+     * @param timeoutMs - Timeout for spawn operation (default: 60000ms)
      * @returns Spawn result. When waitForReady is true, includes `ready` and `readyInfo` fields.
      */
-    async spawn(options, timeoutMs = 30000) {
+    async spawn(options, timeoutMs = 60000) {
         if (this._state !== 'READY') {
             throw new Error('Client not ready');
         }

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.2.23",
+  "version": "2.3.0",
   "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -77,8 +77,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.2.23",
-    "@agent-relay/utils": "2.2.23"
+    "@agent-relay/protocol": "2.3.0",
+    "@agent-relay/utils": "2.3.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/packages/sdk/src/client.ts

@@ -782,7 +782,7 @@ export class RelayClient {
    * @param options.shadowSpeakOn - Shadow speak-on triggers
    * @param options.waitForReady - Wait for the agent to be ready before resolving (default: false)
    * @param options.readyTimeoutMs - Timeout for agent to become ready (default: 60000ms)
-   * @param timeoutMs - Timeout for spawn operation (default: 30000ms)
+   * @param timeoutMs - Timeout for spawn operation (default: 60000ms)
    * @returns Spawn result. When waitForReady is true, includes `ready` and `readyInfo` fields.
    */
   async spawn(
@@ -811,7 +811,7 @@ export class RelayClient {
       /** Timeout for agent to become ready (default: 60000ms). Only used when waitForReady is true. */
       readyTimeoutMs?: number;
     },
-    timeoutMs = 30000
+    timeoutMs = 60000
   ): Promise<SpawnResult> {
     if (this._state !== 'READY') {
       throw new Error('Client not ready');

package/packages/sdk-ts/README.md

@@ -0,0 +1,65 @@
+# `@agent-relay/broker-sdk`
+
+TypeScript SDK for driving `agent-relay init` over stdio.
+
+## Status
+- Broker lifecycle + request/response protocol client implemented.
+- Spawn/list/release/shutdown APIs implemented.
+- Event subscription for broker `event` frames implemented.
+
+## Bundled binary
+- The SDK package bundles `agent-relay` inside `bin/` during `npm run build` and `npm pack`.
+- By default, `AgentRelayClient` uses the bundled binary path when present.
+- You can still override with `binaryPath` in `AgentRelayClient.start(...)`.
+
+## Quick example
+```ts
+import { AgentRelayClient } from "@agent-relay/broker-sdk";
+
+const client = await AgentRelayClient.start({
+  binaryPath: "/absolute/path/to/agent-relay",
+  env: process.env,
+});
+
+await client.spawnPty({
+  name: "Worker1",
+  cli: "codex",
+  args: ["--model", "gpt-5"],
+  channels: ["general"],
+});
+
+const agents = await client.listAgents();
+console.log(agents);
+
+await client.release("Worker1");
+await client.shutdown();
+```
+
+## Tic-tac-toe demo script
+After build, run:
+```bash
+npm --prefix packages/sdk-ts run example
+```
+
+Optional env:
+- `CODEX_CMD` (default: `codex`)
+- `CODEX_ARGS` (space-separated CLI args)
+- `AGENT_X_NAME` / `AGENT_O_NAME`
+- `RELAY_CHANNEL` (default: `general`)
+- `AGENT_RELAY_BIN` (override bundled binary path)
+
+## Integration test
+```bash
+cargo build
+npm --prefix packages/sdk-ts install
+npm --prefix packages/sdk-ts run build
+AGENT_RELAY_BIN="$(pwd)/target/debug/agent-relay" npm --prefix packages/sdk-ts run test:integration
+```
+
+Integration tests require Relaycast credentials in environment (`RELAY_API_KEY`).
+
+## Package tarball
+```bash
+npm --prefix packages/sdk-ts pack
+```
+The generated tarball includes `dist/` and `bin/agent-relay` (or `bin/agent-relay.exe` on Windows).

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

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

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

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

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

@@ -0,0 +1,139 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import path from "node:path";
+import test from "node:test";
+import { AgentRelayClient, AgentRelayProcessError } from "../client.js";
+function resolveBinaryPath() {
+    if (process.env.AGENT_RELAY_BIN) {
+        return process.env.AGENT_RELAY_BIN;
+    }
+    return path.resolve(process.cwd(), "../../target/debug/agent-relay");
+}
+function resolveBundledBinaryPath() {
+    const exe = process.platform === "win32" ? "agent-relay.exe" : "agent-relay";
+    return path.resolve(process.cwd(), "bin", exe);
+}
+function requireRelaycast(t) {
+    const relayKey = process.env.RELAY_API_KEY?.trim();
+    if (!relayKey) {
+        t.skip("RELAY_API_KEY is required for broker integration tests");
+        return false;
+    }
+    return true;
+}
+test("sdk can use bundled binary by default", async (t) => {
+    if (!requireRelaycast(t)) {
+        return;
+    }
+    const bundledBinary = resolveBundledBinaryPath();
+    if (!fs.existsSync(bundledBinary)) {
+        t.skip(`bundled binary not found at ${bundledBinary}`);
+        return;
+    }
+    const client = await AgentRelayClient.start({
+        env: process.env,
+    });
+    try {
+        const agents = await client.listAgents();
+        assert.ok(Array.isArray(agents), "listAgents should return an array");
+    }
+    finally {
+        await client.shutdown();
+    }
+});
+test("sdk can start broker and manage agent lifecycle", async (t) => {
+    if (!requireRelaycast(t)) {
+        return;
+    }
+    const binaryPath = resolveBinaryPath();
+    if (!fs.existsSync(binaryPath)) {
+        t.skip(`agent-relay binary not found at ${binaryPath}`);
+        return;
+    }
+    const client = await AgentRelayClient.start({
+        binaryPath,
+        requestTimeoutMs: 8_000,
+        shutdownTimeoutMs: 2_000,
+        env: process.env,
+    });
+    const spawnedName = `sdk-test-${Date.now().toString(36)}`;
+    const seenEvents = [];
+    const unsub = client.onEvent((event) => {
+        seenEvents.push(event.kind);
+    });
+    try {
+        const spawned = await client.spawnPty({
+            name: spawnedName,
+            cli: "cat",
+            channels: ["general"],
+        });
+        assert.equal(spawned.name, spawnedName);
+        assert.equal(spawned.runtime, "pty");
+        const agentsAfterSpawn = await client.listAgents();
+        const spawnedAgent = agentsAfterSpawn.find((agent) => agent.name === spawnedName);
+        assert.ok(spawnedAgent, "spawned agent should be present in listAgents()");
+        assert.equal(spawnedAgent?.runtime, "pty");
+        const released = await client.release(spawnedName);
+        assert.equal(released.name, spawnedName);
+        const agentsAfterRelease = await client.listAgents();
+        assert.equal(agentsAfterRelease.some((agent) => agent.name === spawnedName), false, "released agent should not be present in listAgents()");
+        assert.ok(seenEvents.includes("agent_spawned"), "expected agent_spawned event");
+        assert.ok(seenEvents.includes("agent_released"), "expected agent_released event");
+    }
+    finally {
+        unsub();
+        await client.shutdown();
+    }
+});
+test("sdk can spawn and release headless claude worker", async (t) => {
+    if (!requireRelaycast(t)) {
+        return;
+    }
+    const binaryPath = resolveBinaryPath();
+    if (!fs.existsSync(binaryPath)) {
+        t.skip(`agent-relay binary not found at ${binaryPath}`);
+        return;
+    }
+    const client = await AgentRelayClient.start({
+        binaryPath,
+        requestTimeoutMs: 8_000,
+        shutdownTimeoutMs: 2_000,
+        env: process.env,
+    });
+    const spawnedName = `sdk-headless-${Date.now().toString(36)}`;
+    const seenEvents = [];
+    const unsub = client.onEvent((event) => {
+        seenEvents.push(event.kind);
+    });
+    try {
+        const spawned = await client.spawnHeadlessClaude({
+            name: spawnedName,
+            channels: ["general"],
+        });
+        assert.equal(spawned.name, spawnedName);
+        assert.equal(spawned.runtime, "headless_claude");
+        const agentsAfterSpawn = await client.listAgents();
+        const spawnedAgent = agentsAfterSpawn.find((agent) => agent.name === spawnedName);
+        assert.ok(spawnedAgent, "spawned headless agent should be present in listAgents()");
+        assert.equal(spawnedAgent?.runtime, "headless_claude");
+        const released = await client.release(spawnedName);
+        assert.equal(released.name, spawnedName);
+        const agentsAfterRelease = await client.listAgents();
+        assert.equal(agentsAfterRelease.some((agent) => agent.name === spawnedName), false, "released headless agent should not be present in listAgents()");
+        assert.ok(seenEvents.includes("agent_spawned"), "expected agent_spawned event");
+        assert.ok(seenEvents.includes("agent_released"), "expected agent_released event");
+    }
+    finally {
+        unsub();
+        await client.shutdown();
+    }
+});
+test("sdk surfaces process error when binary is missing", async () => {
+    await assert.rejects(AgentRelayClient.start({
+        binaryPath: "/definitely/missing/agent-relay",
+        requestTimeoutMs: 1_000,
+    }), (error) => {
+        return error instanceof AgentRelayProcessError || error instanceof Error;
+    });
+});
+//# sourceMappingURL=integration.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,176 @@
+/**
+ * Quickstart integration tests — exercises the AgentRelay facade:
+ * spawn agents, send messages, list, release, event hooks, shutdown.
+ *
+ * Run:
+ *   npm run build && node --test dist/__tests__/quickstart.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;
+}
+// ── full lifecycle ──────────────────────────────────────────────────────────
+test("facade: spawn → message → list → release → shutdown", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+    const spawnedNames = [];
+    const releasedNames = [];
+    const receivedMessages = [];
+    const sentMessages = [];
+    relay.onAgentSpawned = (agent) => spawnedNames.push(agent.name);
+    relay.onAgentReleased = (agent) => releasedNames.push(agent.name);
+    relay.onMessageReceived = (msg) => receivedMessages.push(msg);
+    relay.onMessageSent = (msg) => sentMessages.push(msg);
+    try {
+        // Spawn two agents in parallel
+        const [codex, worker1] = await Promise.all([
+            relay.codex.spawn({ name: `Codex-${suffix}` }),
+            relay.spawnPty({
+                name: `Worker1-${suffix}`,
+                cli: "cat",
+                channels: ["general"],
+            }),
+        ]);
+        assert.equal(codex.runtime, "pty");
+        assert.equal(worker1.runtime, "pty");
+        // Send a message from a human source
+        const human = relay.human({ name: "System" });
+        const msg = await human.sendMessage({
+            to: codex.name,
+            text: "Hello, world!",
+        });
+        assert.ok(msg.eventId, "should return eventId");
+        assert.equal(msg.from, "System");
+        assert.equal(msg.to, codex.name);
+        // onMessageSent should have fired
+        assert.equal(sentMessages.length, 1);
+        assert.equal(sentMessages[0].text, "Hello, world!");
+        // List agents — should return Agent objects with release()
+        const agents = await relay.listAgents();
+        const names = agents.map((a) => a.name);
+        assert.ok(names.includes(codex.name));
+        assert.ok(names.includes(worker1.name));
+        assert.equal(typeof agents[0].release, "function");
+        // Release all via agent.release()
+        for (const agent of agents) {
+            if (agent.name === codex.name || agent.name === worker1.name) {
+                await agent.release();
+            }
+        }
+        // Verify gone
+        const remaining = await relay.listAgents();
+        assert.ok(!remaining.some((a) => a.name === codex.name));
+        assert.ok(!remaining.some((a) => a.name === worker1.name));
+        // Event hooks should have fired
+        assert.ok(spawnedNames.includes(codex.name));
+        assert.ok(spawnedNames.includes(worker1.name));
+        assert.ok(releasedNames.includes(codex.name));
+        assert.ok(releasedNames.includes(worker1.name));
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── agent.sendMessage ───────────────────────────────────────────────────────
+test("facade: agent.sendMessage sends from the agent identity", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+    const sentMessages = [];
+    relay.onMessageSent = (msg) => sentMessages.push(msg);
+    try {
+        const [a, b] = await Promise.all([
+            relay.spawnPty({ name: `A-${suffix}`, cli: "cat", channels: ["general"] }),
+            relay.spawnPty({ name: `B-${suffix}`, cli: "cat", channels: ["general"] }),
+        ]);
+        const msg = await a.sendMessage({ to: b.name, text: "ping" });
+        assert.equal(msg.from, a.name);
+        assert.equal(msg.to, b.name);
+        assert.equal(sentMessages.length, 1);
+        assert.equal(sentMessages[0].from, a.name);
+        await a.release();
+        await b.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── threading ───────────────────────────────────────────────────────────────
+test("facade: message threading with threadId", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+    try {
+        const agent = await relay.spawnPty({
+            name: `Thread-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        const human = relay.human({ name: "Human" });
+        const msg1 = await human.sendMessage({ to: agent.name, text: "start" });
+        const msg2 = await human.sendMessage({
+            to: agent.name,
+            text: "follow-up",
+            threadId: msg1.eventId,
+        });
+        assert.ok(msg2.eventId);
+        assert.notEqual(msg1.eventId, msg2.eventId);
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+//# sourceMappingURL=quickstart.test.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Browser-compatible entry point for the broker SDK.
+ *
+ * Exports only modules with zero Node.js dependencies.
+ * The ConsensusEngine class (needs node:crypto + node:events) is NOT
+ * exported here — only its types and pure helper functions.
+ *
+ * @example
+ * ```ts
+ * import { PROTOCOL_VERSION, type BrokerEvent } from "agent-relay/broker/browser";
+ * ```
+ */
+export { PROTOCOL_VERSION, type AgentRuntime, type AgentSpec, type BrokerEvent, type BrokerStatus, type BrokerToSdk, type BrokerToWorker, type PendingDeliveryInfo, type ProtocolEnvelope, type ProtocolError, type RelayDelivery, type SdkToBroker, type WorkerToBroker, } from "./protocol.js";
+export { formatProposalMessage, formatResultMessage, parseVoteCommand, parseProposalCommand, isConsensusCommand, type ConsensusType, type VoteValue, type ProposalStatus, type AgentWeight, type Vote, type Proposal, type ConsensusResult, type ConsensusConfig, type ConsensusEvents, type ParsedProposalCommand, } from "./consensus-helpers.js";
+export { ShadowManager, type ShadowConfig, type ShadowRelationship, type ShadowCopy, type SpeakOnTrigger, } from "./shadow.js";
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Browser-compatible entry point for the broker SDK.
+ *
+ * Exports only modules with zero Node.js dependencies.
+ * The ConsensusEngine class (needs node:crypto + node:events) is NOT
+ * exported here — only its types and pure helper functions.
+ *
+ * @example
+ * ```ts
+ * import { PROTOCOL_VERSION, type BrokerEvent } from "agent-relay/broker/browser";
+ * ```
+ */
+// Protocol types — pure TypeScript, zero deps
+export { PROTOCOL_VERSION, } from "./protocol.js";
+// Consensus types + pure functions (from the Node-free helpers file)
+export { formatProposalMessage, formatResultMessage, parseVoteCommand, parseProposalCommand, isConsensusCommand, } from "./consensus-helpers.js";
+// Shadow manager — pure in-memory, no I/O deps
+export { ShadowManager, } from "./shadow.js";
+//# sourceMappingURL=browser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,8CAA8C;AAC9C,OAAO,EACL,gBAAgB,GAajB,MAAM,eAAe,CAAC;AAEvB,qEAAqE;AACrE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GAWnB,MAAM,wBAAwB,CAAC;AAEhC,+CAA+C;AAC/C,OAAO,EACL,aAAa,GAKd,MAAM,aAAa,CAAC"}