agent-relay 2.2.24 → 2.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.cjs",
@@ -23,7 +23,47 @@
       "import": "./dist/src/index.js",
       "default": "./dist/index.cjs"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./broker": {
+      "types": "./packages/sdk-ts/dist/index.d.ts",
+      "import": "./packages/sdk-ts/dist/index.js",
+      "default": "./packages/sdk-ts/dist/index.js"
+    },
+    "./broker/client": {
+      "types": "./packages/sdk-ts/dist/client.d.ts",
+      "import": "./packages/sdk-ts/dist/client.js",
+      "default": "./packages/sdk-ts/dist/client.js"
+    },
+    "./broker/protocol": {
+      "types": "./packages/sdk-ts/dist/protocol.d.ts",
+      "import": "./packages/sdk-ts/dist/protocol.js",
+      "default": "./packages/sdk-ts/dist/protocol.js"
+    },
+    "./broker/relay": {
+      "types": "./packages/sdk-ts/dist/relay.d.ts",
+      "import": "./packages/sdk-ts/dist/relay.js",
+      "default": "./packages/sdk-ts/dist/relay.js"
+    },
+    "./broker/logs": {
+      "types": "./packages/sdk-ts/dist/logs.d.ts",
+      "import": "./packages/sdk-ts/dist/logs.js",
+      "default": "./packages/sdk-ts/dist/logs.js"
+    },
+    "./broker/consensus": {
+      "types": "./packages/sdk-ts/dist/consensus.d.ts",
+      "import": "./packages/sdk-ts/dist/consensus.js",
+      "default": "./packages/sdk-ts/dist/consensus.js"
+    },
+    "./broker/shadow": {
+      "types": "./packages/sdk-ts/dist/shadow.d.ts",
+      "import": "./packages/sdk-ts/dist/shadow.js",
+      "default": "./packages/sdk-ts/dist/shadow.js"
+    },
+    "./broker/browser": {
+      "types": "./packages/sdk-ts/dist/browser.d.ts",
+      "import": "./packages/sdk-ts/dist/browser.js",
+      "default": "./packages/sdk-ts/dist/browser.js"
+    }
   },
   "bin": {
     "agent-relay": "dist/src/cli/index.js"
@@ -56,8 +96,8 @@
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
     "build": "npm run clean && npm run build:rust && turbo run build --filter='./packages/*' && tsc",
-    "build:sequential": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:daemon && npm run build:sdk && npm run build:api-types && npm run build:spawner && tsc",
-    "build:workspace": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:daemon && npm run build:sdk && npm run build:api-types && npm run build:spawner && tsc",
+    "build:sequential": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:daemon && npm run build:sdk && npm run build:api-types && npm run build:spawner && npm run build:broker-sdk && tsc",
+    "build:workspace": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:daemon && npm run build:sdk && npm run build:api-types && npm run build:spawner && npm run build:broker-sdk && tsc",
     "build:packages": "turbo run build --filter='./packages/*'",
     "build:packages:watch": "turbo run build --filter='./packages/*' --watch",
     "build:mcp": "cd packages/mcp && npm run build",
@@ -79,6 +119,7 @@
     "build:sdk": "cd packages/sdk && npm run build",
     "build:api-types": "cd packages/api-types && npm run build",
     "build:spawner": "cd packages/spawner && npm run build",
+    "build:broker-sdk": "cd packages/sdk-ts && npm run build",
     "build:telemetry": "cd packages/telemetry && npm run build",
     "build:benchmark": "cd packages/benchmark && npm run build",
     "build:cjs": "node ./scripts/build-cjs.mjs",
@@ -134,23 +175,25 @@
   },
   "homepage": "https://github.com/AgentWorkforce/relay#readme",
   "dependencies": {
-    "@agent-relay/bridge": "2.2.24",
-    "@agent-relay/config": "2.2.24",
-    "@agent-relay/continuity": "2.2.24",
-    "@agent-relay/daemon": "2.2.24",
-    "@agent-relay/hooks": "2.2.24",
-    "@agent-relay/mcp": "2.2.24",
-    "@agent-relay/protocol": "2.2.24",
-    "@agent-relay/resiliency": "2.2.24",
-    "@agent-relay/sdk": "2.2.24",
-    "@agent-relay/spawner": "2.2.24",
-    "@agent-relay/state": "2.2.24",
-    "@agent-relay/storage": "2.2.24",
-    "@agent-relay/telemetry": "2.2.24",
-    "@agent-relay/trajectory": "2.2.24",
-    "@agent-relay/user-directory": "2.2.24",
-    "@agent-relay/utils": "2.2.24",
-    "@agent-relay/wrapper": "2.2.24",
+    "@agent-relay/bridge": "2.3.1",
+    "@agent-relay/config": "2.3.1",
+    "@agent-relay/continuity": "2.3.1",
+    "@agent-relay/daemon": "2.3.1",
+    "@agent-relay/hooks": "2.3.1",
+    "@agent-relay/mcp": "2.3.1",
+    "@agent-relay/protocol": "2.3.1",
+    "@agent-relay/resiliency": "2.3.1",
+    "@agent-relay/sdk": "2.3.1",
+    "@agent-relay/spawner": "2.3.1",
+    "@agent-relay/state": "2.3.1",
+    "@agent-relay/storage": "2.3.1",
+    "@agent-relay/telemetry": "2.3.1",
+    "@agent-relay/trajectory": "2.3.1",
+    "@agent-relay/user-directory": "2.3.1",
+    "@agent-relay/utils": "2.3.1",
+    "@agent-relay/broker-sdk": "2.3.1",
+    "@agent-relay/wrapper": "2.3.1",
+    "@relaycast/sdk": "^0.2.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "agent-trajectories": "^0.3.0",
     "chokidar": "^5.0.0",

package/packages/acp-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/acp-bridge",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "ACP (Agent Client Protocol) bridge for Agent Relay - expose relay agents to ACP-compatible editors like Zed",
   "type": "module",
   "main": "dist/index.js",
@@ -46,7 +46,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/sdk": "2.2.24",
+    "@agent-relay/sdk": "2.3.1",
     "@agentclientprotocol/sdk": "^0.12.0"
   },
   "devDependencies": {

package/packages/api-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/api-types",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Shared API types and Zod schemas for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/benchmark/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/benchmark",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Performance benchmarking for agent swarms, sub-agents, and single agents using Harbor",
   "type": "module",
   "main": "dist/index.js",
@@ -54,14 +54,14 @@
     "directory": "packages/benchmark"
   },
   "dependencies": {
-    "@agent-relay/sdk": "2.2.24",
-    "@agent-relay/protocol": "2.2.24",
-    "@agent-relay/spawner": "2.2.24",
+    "@agent-relay/sdk": "2.3.1",
+    "@agent-relay/protocol": "2.3.1",
+    "@agent-relay/spawner": "2.3.1",
     "commander": "^12.1.0",
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@agent-relay/daemon": "2.2.24",
+    "@agent-relay/daemon": "2.3.1",
     "@types/node": "^22.19.3",
     "typescript": "^5.9.3",
     "vitest": "^3.0.0"

package/packages/bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/bridge",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Multi-project bridge client utilities for Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -22,12 +22,12 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.2.24",
-    "@agent-relay/config": "2.2.24",
-    "@agent-relay/utils": "2.2.24",
-    "@agent-relay/policy": "2.2.24",
-    "@agent-relay/user-directory": "2.2.24",
-    "@agent-relay/wrapper": "2.2.24"
+    "@agent-relay/protocol": "2.3.1",
+    "@agent-relay/config": "2.3.1",
+    "@agent-relay/utils": "2.3.1",
+    "@agent-relay/policy": "2.3.1",
+    "@agent-relay/user-directory": "2.3.1",
+    "@agent-relay/wrapper": "2.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/cli-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/cli-tester",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Manual interactive testing for CLI authentication flows",
   "type": "module",
   "main": "dist/index.js",

package/packages/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/config",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Shared configuration schemas and loaders for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -83,7 +83,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.2.24",
+    "@agent-relay/protocol": "2.3.1",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.1"
   },

package/packages/continuity/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/continuity",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Session continuity manager for Relay (ledgers, handoffs, resume)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/memory": "2.2.24"
+    "@agent-relay/memory": "2.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/daemon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/daemon",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Relay daemon server - agent coordination and message routing",
   "type": "module",
   "main": "dist/index.js",
@@ -22,17 +22,17 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.2.24",
-    "@agent-relay/config": "2.2.24",
-    "@agent-relay/storage": "2.2.24",
-    "@agent-relay/bridge": "2.2.24",
-    "@agent-relay/utils": "2.2.24",
-    "@agent-relay/policy": "2.2.24",
-    "@agent-relay/memory": "2.2.24",
-    "@agent-relay/resiliency": "2.2.24",
-    "@agent-relay/user-directory": "2.2.24",
-    "@agent-relay/wrapper": "2.2.24",
-    "@agent-relay/telemetry": "2.2.24",
+    "@agent-relay/protocol": "2.3.1",
+    "@agent-relay/config": "2.3.1",
+    "@agent-relay/storage": "2.3.1",
+    "@agent-relay/bridge": "2.3.1",
+    "@agent-relay/utils": "2.3.1",
+    "@agent-relay/policy": "2.3.1",
+    "@agent-relay/memory": "2.3.1",
+    "@agent-relay/resiliency": "2.3.1",
+    "@agent-relay/user-directory": "2.3.1",
+    "@agent-relay/wrapper": "2.3.1",
+    "@agent-relay/telemetry": "2.3.1",
     "ws": "^8.18.3",
     "pg": "^8.16.3",
     "uuid": "^10.0.0"

package/packages/hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/hooks",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "description": "Hook emitter, registry, and trajectory hooks for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -37,9 +37,9 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.2.24",
-    "@agent-relay/config": "2.2.24",
-    "@agent-relay/trajectory": "2.2.24"
+    "@agent-relay/protocol": "2.3.1",
+    "@agent-relay/config": "2.3.1",
+    "@agent-relay/trajectory": "2.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/mcp",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "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.24",
-    "@agent-relay/protocol": "2.2.24",
-    "@agent-relay/utils": "2.2.24",
+    "@agent-relay/config": "2.3.1",
+    "@agent-relay/protocol": "2.3.1",
+    "@agent-relay/utils": "2.3.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "smol-toml": "^1.6.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agent-relay/sdk": "2.2.24",
+    "@agent-relay/sdk": "2.3.1",
     "@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.24",
+  "version": "2.3.1",
   "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.24"
+    "@agent-relay/hooks": "2.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/policy",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "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.24"
+    "@agent-relay/config": "2.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/protocol",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "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.24",
+  "version": "2.3.1",
   "description": "Health monitoring, logging, metrics, and crash resilience utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.2.24",
+  "version": "2.3.1",
   "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.24",
-    "@agent-relay/utils": "2.2.24"
+    "@agent-relay/protocol": "2.3.1",
+    "@agent-relay/utils": "2.3.1"
   },
   "engines": {
     "node": ">=18.0.0"

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":""}