@agent-relay/sdk 3.2.22 → 4.0.1

package/README.md

@@ -80,11 +80,18 @@ For direct broker control:
 ```ts
 import { AgentRelayClient } from '@agent-relay/sdk';
 
-const client = await AgentRelayClient.start({
-  binaryPath: '/path/to/agent-relay-broker', // optional, auto-detected
+// Spawn a local broker and connect over HTTP/WS
+const client = await AgentRelayClient.spawn({
+  cwd: '/my/project',
   channels: ['general'],
 });
 
+// Or connect to an already-running broker (reads connection.json)
+// const client = AgentRelayClient.connect({ cwd: '/my/project' });
+
+// Or connect to a remote broker directly
+// const client = new AgentRelayClient({ baseUrl: 'http://...', apiKey: 'br_...' });
+
 await client.spawnPty({
   name: 'Worker1',
   cli: 'claude',
@@ -104,7 +111,7 @@ Use provider-first spawn helpers and set `transport` when you want headless mode
 ```ts
 import { AgentRelayClient } from '@agent-relay/sdk';
 
-const client = await AgentRelayClient.start({
+const client = await AgentRelayClient.spawn({
   channels: ['general'],
 });
 

package/dist/broker-path.d.ts

@@ -9,9 +9,10 @@
  * Resolve the agent-relay-broker binary path.
  *
  * Search order:
- *   1. SDK's bin/ directory (resolved via createRequire or import.meta.url)
+ *   1. SDK's bin/ directory (resolved via CJS globals, createRequire, or import.meta.url)
  *   2. Platform-specific name (agent-relay-broker-{platform}-{arch}) in bin/
- *   3. PATH lookup via `which` / `where`
+ *   3. Common Cargo development paths (target/release and target/debug)
+ *   4. PATH lookup via `which` / `where`
  *
  * @returns Absolute path to the broker binary, or null if not found
  */

package/dist/broker-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broker-path.d.ts","sourceRoot":"","sources":["../src/broker-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CA+CnD"}
+{"version":3,"file":"broker-path.d.ts","sourceRoot":"","sources":["../src/broker-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuHH;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CA2CnD"}

package/dist/broker-path.js

@@ -6,61 +6,148 @@
  *   const binPath = getBrokerBinaryPath();
  */
 import { existsSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { execSync } from 'node:child_process';
+import { join, dirname, resolve } from 'node:path';
+import { execFileSync } from 'node:child_process';
 import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 const BROKER_NAME = 'agent-relay-broker';
+function addUniquePath(paths, candidate) {
+    if (!candidate || paths.includes(candidate)) {
+        return;
+    }
+    paths.push(candidate);
+}
+function getImportMetaUrl() {
+    try {
+        return import.meta.url;
+    }
+    catch {
+        return null;
+    }
+}
+function getCurrentModuleDir() {
+    if (typeof __dirname === 'string' && __dirname) {
+        return __dirname;
+    }
+    if (typeof __filename === 'string' && __filename) {
+        return dirname(__filename);
+    }
+    const importMetaUrl = getImportMetaUrl();
+    if (!importMetaUrl) {
+        return null;
+    }
+    try {
+        return dirname(fileURLToPath(importMetaUrl));
+    }
+    catch {
+        return null;
+    }
+}
+function getCurrentModuleReference() {
+    if (typeof __filename === 'string' && __filename) {
+        return __filename;
+    }
+    if (typeof __dirname === 'string' && __dirname) {
+        return join(__dirname, 'broker-path.js');
+    }
+    return getImportMetaUrl();
+}
+function getSdkBinDirs() {
+    const binDirs = [];
+    const currentModuleDir = getCurrentModuleDir();
+    if (currentModuleDir) {
+        addUniquePath(binDirs, resolve(currentModuleDir, '..', 'bin'));
+    }
+    const currentModuleReference = getCurrentModuleReference();
+    if (currentModuleReference) {
+        try {
+            const sdkEntry = createRequire(currentModuleReference).resolve('@agent-relay/sdk');
+            addUniquePath(binDirs, resolve(dirname(sdkEntry), '..', 'bin'));
+        }
+        catch {
+            // Continue with other resolution strategies.
+        }
+    }
+    const importMetaUrl = getImportMetaUrl();
+    if (importMetaUrl) {
+        try {
+            addUniquePath(binDirs, resolve(dirname(fileURLToPath(importMetaUrl)), '..', 'bin'));
+        }
+        catch {
+            // Continue with other resolution strategies.
+        }
+    }
+    return binDirs;
+}
+function getDevelopmentBinaryPaths(ext, binDirs) {
+    const binaryPaths = [];
+    const repoRoots = new Set();
+    const addRepoRoot = (candidate) => {
+        if (!candidate) {
+            return;
+        }
+        const repoRoot = resolve(candidate);
+        if (repoRoots.has(repoRoot)) {
+            return;
+        }
+        repoRoots.add(repoRoot);
+        addUniquePath(binaryPaths, join(repoRoot, 'target', 'release', `${BROKER_NAME}${ext}`));
+        addUniquePath(binaryPaths, join(repoRoot, 'target', 'debug', `${BROKER_NAME}${ext}`));
+    };
+    addRepoRoot(process.cwd());
+    const currentModuleDir = getCurrentModuleDir();
+    if (currentModuleDir) {
+        addRepoRoot(resolve(currentModuleDir, '..', '..', '..'));
+    }
+    for (const binDir of binDirs) {
+        addRepoRoot(resolve(binDir, '..', '..', '..'));
+    }
+    return binaryPaths;
+}
 /**
  * Resolve the agent-relay-broker binary path.
  *
  * Search order:
- *   1. SDK's bin/ directory (resolved via createRequire or import.meta.url)
+ *   1. SDK's bin/ directory (resolved via CJS globals, createRequire, or import.meta.url)
  *   2. Platform-specific name (agent-relay-broker-{platform}-{arch}) in bin/
- *   3. PATH lookup via `which` / `where`
+ *   3. Common Cargo development paths (target/release and target/debug)
+ *   4. PATH lookup via `which` / `where`
  *
  * @returns Absolute path to the broker binary, or null if not found
  */
 export function getBrokerBinaryPath() {
-    let binDir = null;
-    try {
-        // Use createRequire for ESM-compatible require.resolve
-        const esmRequire = createRequire(import.meta.url);
-        const sdkEntry = esmRequire.resolve('@agent-relay/sdk');
-        binDir = join(dirname(sdkEntry), '..', 'bin');
-    }
-    catch {
-        try {
-            // Fallback: derive from import.meta.url
-            binDir = join(dirname(dirname(fileURLToPath(import.meta.url))), 'bin');
-        }
-        catch {
-            // Neither method worked
-        }
-    }
-    if (!binDir)
-        return null;
     const ext = process.platform === 'win32' ? '.exe' : '';
+    const binDirs = getSdkBinDirs();
+    const platformSpecific = `${BROKER_NAME}-${process.platform}-${process.arch}${ext}`;
     // 1. Exact name in bin/
-    const exactPath = join(binDir, `${BROKER_NAME}${ext}`);
-    if (existsSync(exactPath)) {
-        return exactPath;
+    for (const binDir of binDirs) {
+        const exactPath = join(binDir, `${BROKER_NAME}${ext}`);
+        if (existsSync(exactPath)) {
+            return exactPath;
+        }
     }
     // 2. Platform-specific name in bin/
-    const platformSpecific = `${BROKER_NAME}-${process.platform}-${process.arch}${ext}`;
-    const platformPath = join(binDir, platformSpecific);
-    if (existsSync(platformPath)) {
-        return platformPath;
+    for (const binDir of binDirs) {
+        const platformPath = join(binDir, platformSpecific);
+        if (existsSync(platformPath)) {
+            return platformPath;
+        }
+    }
+    // 3. Common development paths for local Cargo builds.
+    for (const developmentPath of getDevelopmentBinaryPaths(ext, binDirs)) {
+        if (existsSync(developmentPath)) {
+            return developmentPath;
+        }
     }
-    // 3. PATH lookup
+    // 4. PATH lookup
     try {
         const cmd = process.platform === 'win32' ? 'where' : 'which';
-        const result = execSync(`${cmd} ${BROKER_NAME}`, {
+        const result = execFileSync(cmd, [BROKER_NAME], {
             encoding: 'utf-8',
             stdio: ['pipe', 'pipe', 'pipe'],
         }).trim();
         if (result) {
-            return result.split('\n')[0].trim();
+            return result.split(/\r?\n/u)[0].trim();
         }
     }
     catch {

package/dist/broker-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"broker-path.js","sourceRoot":"","sources":["../src/broker-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,uDAAuD;QACvD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACxD,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,wCAAwC;YACxC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvD,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;IACvD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,oCAAoC;IACpC,MAAM,gBAAgB,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;IACpF,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,GAAG,IAAI,WAAW,EAAE,EAAE;YAC/C,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"broker-path.js","sourceRoot":"","sources":["../src/broker-path.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -1,116 +1,100 @@
-import { type AgentRuntime, type BrokerEvent, type BrokerStats, type BrokerStatus, type CrashInsightsResponse, type HeadlessProvider, type ProtocolError, type RestartPolicy, type MessageInjectionMode } from './protocol.js';
+/**
+ * AgentRelayClient — single client for communicating with an agent-relay broker
+ * over HTTP/WS. Works identically for local and remote brokers.
+ *
+ * Usage:
+ *   // Remote broker (Daytona sandbox, cloud, etc.)
+ *   const client = new AgentRelayClient({ baseUrl, apiKey });
+ *
+ *   // Local broker (spawn and connect)
+ *   const client = await AgentRelayClient.spawn({ cwd: '/my/project' });
+ */
+import type { AgentRuntime, BrokerEvent, BrokerStats, BrokerStatus, CrashInsightsResponse, HeadlessProvider } from './protocol.js';
+import type { SpawnPtyInput, SpawnProviderInput, SendMessageInput, ListAgent } from './types.js';
 export interface AgentRelayClientOptions {
+    baseUrl: string;
+    apiKey?: string;
+    /** Timeout in ms for HTTP requests. Default: 30000. */
+    requestTimeoutMs?: number;
+}
+export interface AgentRelayBrokerInitArgs {
+    /** Optional HTTP API port for dashboard proxy (0 = disabled). */
+    apiPort?: number;
+    /** Bind address for the HTTP API. Defaults to 127.0.0.1 in the broker. */
+    apiBind?: string;
+    /** Enable persistence for broker state under the working directory. */
+    persist?: boolean;
+    /** Override the directory used for broker state files. */
+    stateDir?: string;
+}
+export interface AgentRelaySpawnOptions {
+    /** Path to the agent-relay-broker binary. Auto-resolved if omitted. */
     binaryPath?: string;
-    binaryArgs?: string[];
+    /** Structured options mapped to the broker's Rust `init` CLI flags. */
+    binaryArgs?: AgentRelayBrokerInitArgs;
+    /** Broker name. Defaults to cwd basename. */
     brokerName?: string;
+    /** Default channels for spawned agents. */
     channels?: string[];
+    /** Working directory for the broker process. */
     cwd?: string;
+    /** Environment variables for the broker process. */
     env?: NodeJS.ProcessEnv;
+    /** Forward broker stderr to this callback. */
+    onStderr?: (line: string) => void;
+    /** Timeout in ms to wait for broker to become ready. Default: 15000. */
+    startupTimeoutMs?: number;
+    /** Timeout in ms for HTTP requests to the broker. Default: 30000. */
     requestTimeoutMs?: number;
-    shutdownTimeoutMs?: number;
-    clientName?: string;
-    clientVersion?: string;
 }
-export interface SpawnPtyInput {
-    name: string;
-    cli: string;
-    args?: string[];
-    channels?: string[];
-    task?: string;
-    model?: string;
-    cwd?: string;
-    team?: string;
-    shadowOf?: string;
-    shadowMode?: string;
-    /** Silence duration in seconds before emitting agent_idle (0 = disabled, default: 30). */
-    idleThresholdSecs?: number;
-    /** Auto-restart policy for crashed agents. */
-    restartPolicy?: RestartPolicy;
-    /** Name of a previously released agent whose continuity context should be injected. */
-    continueFrom?: string;
-    /** When true, skip injecting the relay MCP configuration and protocol prompt into the spawned agent.
-     *  Useful for minor tasks where relay messaging is not needed, saving tokens. */
-    skipRelayPrompt?: boolean;
-}
-export interface SpawnHeadlessInput {
-    name: string;
-    provider: HeadlessProvider;
-    args?: string[];
-    channels?: string[];
-    task?: string;
-    /** When true, skip injecting the relay MCP configuration and protocol prompt into the spawned agent.
-     *  Useful for minor tasks where relay messaging is not needed, saving tokens. */
-    skipRelayPrompt?: boolean;
-}
-export type AgentTransport = 'pty' | 'headless';
-export interface SpawnProviderInput {
-    name: string;
-    provider: string;
-    transport?: AgentTransport;
-    args?: string[];
-    channels?: string[];
-    task?: string;
-    model?: string;
-    cwd?: string;
-    team?: string;
-    shadowOf?: string;
-    shadowMode?: string;
-    idleThresholdSecs?: number;
-    restartPolicy?: RestartPolicy;
-    continueFrom?: string;
-    /** When true, skip injecting the relay MCP configuration and protocol prompt into the spawned agent.
-     *  Useful for minor tasks where relay messaging is not needed, saving tokens. */
-    skipRelayPrompt?: boolean;
-}
-export interface SendMessageInput {
-    to: string;
-    text: string;
-    from?: string;
-    threadId?: string;
-    workspaceId?: string;
-    workspaceAlias?: string;
-    priority?: number;
-    data?: Record<string, unknown>;
-    mode?: MessageInjectionMode;
-}
-export interface ListAgent {
-    name: string;
-    runtime: AgentRuntime;
-    provider?: HeadlessProvider;
-    cli?: string;
-    model?: string;
-    team?: string;
-    channels: string[];
-    parent?: string;
-    pid?: number;
-}
-export declare class AgentRelayProtocolError extends Error {
-    code: string;
-    retryable: boolean;
-    data?: unknown;
-    constructor(payload: ProtocolError);
-}
-export declare class AgentRelayProcessError extends Error {
-    constructor(message: string);
+export interface SessionInfo {
+    broker_version: string;
+    protocol_version: number;
+    workspace_key?: string;
+    default_workspace_id?: string;
+    mode: string;
+    uptime_secs: number;
 }
 export declare class AgentRelayClient {
-    private readonly options;
-    private child?;
-    private stdoutRl?;
-    private stderrRl?;
-    private lastStderrLine?;
-    private requestSeq;
-    private pending;
-    private startingPromise?;
-    private eventListeners;
-    private stderrListeners;
-    private eventBuffer;
-    private maxBufferSize;
-    private exitPromise?;
-    /** The workspace key returned by the broker in its hello_ack response. */
+    private readonly transport;
+    /** Set after spawn() — the managed child process. */
+    private child;
+    /** Lease renewal timer (only for spawned brokers). */
+    private leaseTimer;
     workspaceKey?: string;
-    constructor(options?: AgentRelayClientOptions);
-    static start(options?: AgentRelayClientOptions): Promise<AgentRelayClient>;
+    constructor(options: AgentRelayClientOptions);
+    /**
+     * Connect to an already-running broker by reading its connection file.
+     *
+     * The broker writes `connection.json` to its data directory ({cwd}/.agent-relay/
+     * in persist mode). This method reads that file to get the URL and API key.
+     *
+     * @param cwd — project directory (default: process.cwd())
+     * @param connectionPath — explicit path to connection.json (overrides cwd)
+     */
+    static connect(options?: {
+        cwd?: string;
+        connectionPath?: string;
+    }): AgentRelayClient;
+    /**
+     * Spawn a local broker process and return a connected client.
+     *
+     * 1. Generates a random API key
+     * 2. Spawns the broker binary (attached)
+     * 3. Parses the API port from stdout
+     * 4. Connects HTTP/WS transport
+     * 5. Fetches session metadata
+     * 6. Starts event stream + lease renewal
+     */
+    static spawn(options?: AgentRelaySpawnOptions): Promise<AgentRelayClient>;
+    /** PID of the managed broker process, if spawned locally. */
+    get brokerPid(): number | undefined;
+    getSession(): Promise<SessionInfo>;
+    healthCheck(): Promise<{
+        service: string;
+    }>;
+    connectEvents(sinceSeq?: number): void;
+    disconnectEvents(): void;
     onEvent(listener: (event: BrokerEvent) => void): () => void;
     queryEvents(filter?: {
         kind?: string;
@@ -119,29 +103,22 @@ export declare class AgentRelayClient {
         limit?: number;
     }): BrokerEvent[];
     getLastEvent(kind: string, name?: string): BrokerEvent | undefined;
-    onBrokerStderr(listener: (line: string) => void): () => void;
-    get brokerPid(): number | undefined;
-    start(): Promise<void>;
-    /**
-     * Pre-register a batch of agents with Relaycast before their steps execute.
-     * The broker warms its token cache in parallel; subsequent spawn_agent calls
-     * hit the cache rather than waiting on individual HTTP registrations.
-     * Fire-and-forget from the caller's perspective — broker responds immediately
-     * and registers in the background.
-     */
-    preflightAgents(agents: Array<{
-        name: string;
-        cli: string | AgentRuntime;
-    }>): Promise<void>;
     spawnPty(input: SpawnPtyInput): Promise<{
         name: string;
         runtime: AgentRuntime;
     }>;
-    spawnHeadless(input: SpawnHeadlessInput): Promise<{
+    spawnProvider(input: SpawnProviderInput): Promise<{
         name: string;
         runtime: AgentRuntime;
     }>;
-    spawnProvider(input: SpawnProviderInput): Promise<{
+    spawnHeadless(input: {
+        name: string;
+        provider: HeadlessProvider;
+        args?: string[];
+        channels?: string[];
+        task?: string;
+        skipRelayPrompt?: boolean;
+    }): Promise<{
         name: string;
         runtime: AgentRuntime;
     }>;
@@ -156,17 +133,20 @@ export declare class AgentRelayClient {
     release(name: string, reason?: string): Promise<{
         name: string;
     }>;
+    listAgents(): Promise<ListAgent[]>;
     sendInput(name: string, data: string): Promise<{
         name: string;
         bytes_written: number;
     }>;
-    subscribeChannels(name: string, channels: string[]): Promise<void>;
-    unsubscribeChannels(name: string, channels: string[]): Promise<void>;
     resizePty(name: string, rows: number, cols: number): Promise<{
         name: string;
         rows: number;
         cols: number;
     }>;
+    sendMessage(input: SendMessageInput): Promise<{
+        event_id: string;
+        targets: string[];
+    }>;
     setModel(name: string, model: string, opts?: {
         timeoutMs?: number;
     }): Promise<{
@@ -174,6 +154,8 @@ export declare class AgentRelayClient {
         model: string;
         success: boolean;
     }>;
+    subscribeChannels(name: string, channels: string[]): Promise<void>;
+    unsubscribeChannels(name: string, channels: string[]): Promise<void>;
     getMetrics(agent?: string): Promise<{
         agents: Array<{
             name: string;
@@ -183,89 +165,29 @@ export declare class AgentRelayClient {
         }>;
         broker?: BrokerStats;
     }>;
+    getStatus(): Promise<BrokerStatus>;
     getCrashInsights(): Promise<CrashInsightsResponse>;
-    sendMessage(input: SendMessageInput): Promise<{
-        event_id: string;
-        targets: string[];
+    preflight(agents: Array<{
+        name: string;
+        cli: string;
+    }>): Promise<{
+        queued: number;
+    }>;
+    renewLease(): Promise<{
+        renewed: boolean;
+        expires_in_secs: number;
     }>;
-    listAgents(): Promise<ListAgent[]>;
-    getStatus(): Promise<BrokerStatus>;
-    shutdown(): Promise<void>;
-    waitForExit(): Promise<void>;
-    private startInternal;
-    private disposeProcessHandles;
-    private failAllPending;
-    private handleStdoutLine;
-    private requestHello;
-    private requestOk;
-    private sendRequest;
-}
-export interface HttpAgentRelayClientOptions {
-    port: number;
-    apiKey?: string;
-}
-export interface DiscoverAndConnectOptions {
-    cwd?: string;
-    apiKey?: string;
-    /** Auto-start the broker if not running (default: false). */
-    autoStart?: boolean;
-    /**
-     * Path to the broker binary for auto-start.
-     * If not provided, the SDK resolves it automatically via standard install locations
-     * (~/.agent-relay/bin, bundled platform binary, or Cargo release build).
-     * Only used when `autoStart: true`.
-     */
-    brokerBinaryPath?: string;
-}
-export declare class HttpAgentRelayClient {
-    private readonly port;
-    private readonly apiKey?;
-    constructor(options: HttpAgentRelayClientOptions);
-    /**
-     * Connect to an already-running broker on the given port.
-     */
-    static connectHttp(port: number, options?: {
-        apiKey?: string;
-    }): Promise<HttpAgentRelayClient>;
     /**
-     * Discover a running broker for the current project and connect to it.
-     * Reads the broker PID file, verifies the process is alive, scans ports
-     * for the HTTP API, and returns a connected client.
+     * Shut down and clean up.
+     * - For spawned brokers (via .spawn()): sends POST /api/shutdown to kill the broker, waits for exit.
+     * - For connected brokers (via .connect() or constructor): just disconnects the transport.
+     *   Does NOT kill the broker — the caller doesn't own it.
      */
-    static discoverAndConnect(options?: DiscoverAndConnectOptions): Promise<HttpAgentRelayClient>;
-    private static scanForBrokerPort;
-    private request;
-    private static extractErrorMessage;
-    healthCheck(): Promise<{
-        service: string;
-    }>;
-    /** No-op — broker is already running. */
-    start(): Promise<void>;
-    /** No-op — don't kill an externally-managed broker. */
     shutdown(): Promise<void>;
-    spawnPty(input: SpawnPtyInput): Promise<{
-        name: string;
-        runtime: AgentRuntime;
-    }>;
-    sendMessage(input: SendMessageInput): Promise<{
-        event_id: string;
-        targets: string[];
-    }>;
-    listAgents(): Promise<ListAgent[]>;
-    release(name: string, reason?: string): Promise<{
-        name: string;
-    }>;
-    subscribeChannels(_name: string, _channels: string[]): Promise<void>;
-    unsubscribeChannels(_name: string, _channels: string[]): Promise<void>;
-    setModel(name: string, model: string, opts?: {
-        timeoutMs?: number;
-    }): Promise<{
-        name: string;
-        model: string;
-        success: boolean;
-    }>;
+    /** Disconnect without shutting down the broker. Alias for cases where the intent is clear. */
+    disconnect(): void;
     getConfig(): Promise<{
-        workspace_key?: string;
+        workspaceKey?: string;
     }>;
 }
 //# sourceMappingURL=client.d.ts.map