agent-relay 6.0.22 → 6.2.0

package/dist/src/cli/commands/passthrough.js

@@ -0,0 +1,398 @@
+/**
+ * `agent-relay passthrough <name>` — read-write attach in passthrough session.
+ *
+ * The broker auto-injects inbound relay messages into the agent's PTY
+ * while the human also types; both writers race. That's the point —
+ * passthrough is for observe-and-occasionally-nudge sessions
+ * while the broker does its coordination thing. For exclusive
+ * deterministic control with no auto-inject, use `drive` instead.
+ *
+ * On attach, ensures the worker is in `auto_inject` delivery mode (it's the
+ * broker default, but if someone left a `drive` session the worker may
+ * be in `manual_flush` mode — `passthrough` flips it back for the session's
+ * duration and restores the prior mode on detach). On detach, restores
+ * the prior mode and leaves the agent running.
+ *
+ * The session loop (snapshot-on-attach, raw stdin, resize forwarding,
+ * detach keybind, Ctrl+C-as-detach safety alias) mirrors the shape of
+ * `drive.ts` minus the pending-queue UI and `Ctrl+G` flush binding
+ * (there's no queue in passthrough session). `drive.ts` is the more
+ * heavily-commented version of the shared shape; this module
+ * duplicates rather than abstracts because the trimmed surface is
+ * small enough that an extra layer of indirection would cost more
+ * clarity than it saves.
+ */
+import { Buffer } from 'node:buffer';
+import WebSocket from 'ws';
+import { captureAndRenderSnapshot, } from '../lib/attach.js';
+import { defaultStateDir, readConnectionFileFromDisk, resolveBrokerConnection, toWsUrl, } from '../lib/broker-connection.js';
+import { defaultExit, runSignalHandler } from '../lib/exit.js';
+import { getInboundDeliveryMode, resizeWorker, sendInput, setInboundDeliveryMode, } from './drive.js';
+function withDefaults(overrides = {}) {
+    return {
+        readConnectionFile: readConnectionFileFromDisk,
+        getDefaultStateDir: defaultStateDir,
+        env: process.env,
+        createWebSocket: (url, headers) => new WebSocket(url, { headers }),
+        writeChunk: (chunk) => {
+            process.stdout.write(chunk);
+        },
+        onSignal: (signal, handler) => {
+            process.on(signal, () => runSignalHandler(handler));
+        },
+        log: (...args) => console.error(...args),
+        error: (...args) => console.error(...args),
+        exit: defaultExit,
+        fetch: (input, init) => fetch(input, init),
+        captureAndRenderSnapshot,
+        stdin: process.stdin,
+        terminal: {
+            getSize: () => {
+                const stdout = process.stdout;
+                if (!stdout.isTTY)
+                    return null;
+                const rows = stdout.rows;
+                const cols = stdout.columns;
+                if (typeof rows !== 'number' || typeof cols !== 'number')
+                    return null;
+                return { rows, cols };
+            },
+            onResize: (handler) => {
+                process.stdout.on('resize', handler);
+                return () => process.stdout.off('resize', handler);
+            },
+        },
+        ...overrides,
+    };
+}
+/** ----- WS message classification ----- */
+function isStringObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Inspect a single WebSocket frame and classify it relative to the
+ * agent we're following. Non-matching / malformed frames return
+ * `{ kind: 'other' }` so the caller can ignore them cheaply.
+ */
+export function classifyWsEvent(rawMessage, name) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawMessage);
+    }
+    catch {
+        return { kind: 'other' };
+    }
+    if (!isStringObject(parsed))
+        return { kind: 'other' };
+    if (parsed.name !== name)
+        return { kind: 'other' };
+    if (parsed.kind === 'worker_stream') {
+        const chunk = parsed.chunk;
+        if (typeof chunk !== 'string')
+            return { kind: 'other' };
+        return { kind: 'worker_stream', chunk };
+    }
+    return { kind: 'other' };
+}
+/**
+ * Stateful parser for the passthrough client's keybind vocabulary.
+ * Smaller than `drive`'s because there's no queue to flush — no
+ * `Ctrl+G` binding.
+ *
+ * Semantics:
+ *   - `Ctrl+C` (0x03)    → emit `detach`, never forwarded.
+ *   - `Ctrl+B` (0x02)    → swallow, arm the prefix state.
+ *     Next byte:
+ *       - 'd' / 'D' / 0x04 (Ctrl+D) → emit `detach`.
+ *       - '?'                       → emit `toggle_help`.
+ *       - anything else             → forward `Ctrl+B` + the byte so
+ *                                     TUI apps using `Ctrl+B` themselves
+ *                                     aren't deprived.
+ */
+export class PassthroughKeybindParser {
+    pendingPrefix = false;
+    feed(chunk) {
+        const forward = [];
+        const actions = [];
+        for (const byte of chunk) {
+            if (this.pendingPrefix) {
+                this.pendingPrefix = false;
+                if (byte === 0x44 /* 'D' */ || byte === 0x64 /* 'd' */ || byte === 0x04 /* Ctrl+D */) {
+                    actions.push('detach');
+                    continue;
+                }
+                if (byte === 0x3f /* '?' */) {
+                    actions.push('toggle_help');
+                    continue;
+                }
+                forward.push(0x02);
+                forward.push(byte);
+                continue;
+            }
+            if (byte === 0x03 /* Ctrl+C */) {
+                actions.push('detach');
+                continue;
+            }
+            if (byte === 0x02 /* Ctrl+B */) {
+                this.pendingPrefix = true;
+                continue;
+            }
+            forward.push(byte);
+        }
+        return { forward: Buffer.from(forward), actions };
+    }
+    reset() {
+        this.pendingPrefix = false;
+    }
+}
+/** ----- Status line rendering ----- */
+/**
+ * Render the bottom-of-terminal status line for `passthrough`. Same
+ * save/restore-cursor trick as `drive`, no pending counter (there
+ * isn't one in passthrough session).
+ */
+export function renderStatusLine(opts) {
+    const row = Math.max(opts.rows ?? 24, 1);
+    const help = opts.showHelp ? ' | Ctrl+B D detach | Ctrl+B ? hide help' : ' | Ctrl+B D detach';
+    const text = `[passthrough ${opts.name} | delivery=${opts.mode}${help}]`;
+    return `\x1b7\x1b[${row};1H\x1b[2K\x1b[7m${text}\x1b[0m\x1b8`;
+}
+/** ----- Main session runner ----- */
+/**
+ * Open a `passthrough` session. Resolves with the exit code the CLI
+ * should propagate. Cleans up its own stdin raw-mode and best-effort
+ * restores the worker's previous inbound delivery mode on any exit path.
+ */
+export async function runPassthroughSession(agentName, options, deps) {
+    // Normalize once so every downstream broker call, WS-event match,
+    // status-line label, and error message uses the same trimmed value.
+    // Without this a stray space in the raw input turns into a silent
+    // 404 (the broker stores names verbatim).
+    const name = agentName.trim();
+    if (!name) {
+        deps.error('Error: agent name is required');
+        return 1;
+    }
+    const connection = resolveBrokerConnection(options, deps);
+    if (!connection) {
+        deps.error('Error: could not locate broker connection. Pass --broker-url, set RELAY_BROKER_URL, ' +
+            'or run from a directory containing .agent-relay/connection.json.');
+        return 1;
+    }
+    // Remember the worker's prior mode so we can restore on detach.
+    // `null` means we couldn't read it (broker hiccup or worker missing);
+    // we default the restore target to `auto_inject` in that case (which
+    // is also our preferred final state).
+    const previousMode = await getInboundDeliveryMode(connection, name, deps.fetch);
+    // If the worker is in `manual_flush` mode (e.g. someone left a `drive`
+    // session), flip it back to `auto_inject` for the duration of our
+    // session. This matches the verb's intent: `agent-relay passthrough alice`
+    // means "watch alice with auto-inject on". If the worker is already
+    // in `auto_inject` we still issue the PUT — it's idempotent on the
+    // broker and gives us an early hard-failure on missing-agent before
+    // we touch the terminal.
+    const flip = await setInboundDeliveryMode(connection, name, 'auto_inject', deps.fetch);
+    if (!flip.ok) {
+        if (flip.status === 404) {
+            deps.error(`Error: no agent named '${name}'`);
+        }
+        else {
+            deps.error(`Error: could not ensure '${name}' is in passthrough session: ${flip.message ?? 'unknown error'}`);
+        }
+        return 1;
+    }
+    const snapshot = await deps.captureAndRenderSnapshot({ url: connection.url, apiKey: connection.apiKey }, name, { fetch: deps.fetch, writeChunk: deps.writeChunk });
+    switch (snapshot.status) {
+        case 'ok':
+            break;
+        case 'not_found':
+            await setInboundDeliveryMode(connection, name, previousMode ?? 'auto_inject', deps.fetch);
+            deps.error(`Error: ${snapshot.message ?? `no agent named '${name}'`}`);
+            return 1;
+        case 'no_pty':
+            await setInboundDeliveryMode(connection, name, previousMode ?? 'auto_inject', deps.fetch);
+            deps.error(`Error: ${snapshot.message ?? `agent '${name}' has no PTY to attach to`}`);
+            return 1;
+        case 'unavailable':
+        case 'transport_error':
+            deps.log(`[passthrough] could not capture initial screen (${snapshot.message ?? snapshot.status}); streaming live output only`);
+            break;
+    }
+    let showHelp = false;
+    const initialLocalSize = deps.terminal.getSize();
+    let terminalRows = initialLocalSize?.rows ??
+        (typeof snapshot.rows === 'number' && snapshot.rows > 0 ? snapshot.rows : undefined);
+    const paintStatus = () => {
+        deps.writeChunk(renderStatusLine({ name, mode: 'auto_inject', showHelp, rows: terminalRows }));
+    };
+    paintStatus();
+    if (initialLocalSize) {
+        const initialResize = await resizeWorker(connection, name, initialLocalSize.rows, initialLocalSize.cols, deps.fetch);
+        if (!initialResize.ok) {
+            deps.log(`[passthrough] could not sync agent PTY size to local terminal (${initialResize.message ?? 'unknown'}); continuing`);
+        }
+    }
+    const wsUrl = toWsUrl(connection.url);
+    const headers = {};
+    if (connection.apiKey) {
+        headers['X-API-Key'] = connection.apiKey;
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        let rawModeWasSet = false;
+        let unsubscribeResize = null;
+        const parser = new PassthroughKeybindParser();
+        const resizeHandler = () => {
+            const size = deps.terminal.getSize();
+            if (!size)
+                return;
+            terminalRows = size.rows;
+            void resizeWorker(connection, name, size.rows, size.cols, deps.fetch).then((res) => {
+                if (!res.ok) {
+                    deps.log(`[passthrough] resize forward failed: ${res.message ?? 'unknown error'}`);
+                }
+            });
+            paintStatus();
+        };
+        const stdinDataHandler = (chunk) => {
+            const outcome = parser.feed(chunk);
+            if (outcome.forward.length > 0) {
+                void sendInput(connection, name, outcome.forward.toString('utf-8'), deps.fetch).then((res) => {
+                    if (!res.ok) {
+                        deps.log(`[passthrough] input send failed: ${res.message ?? 'unknown error'}`);
+                    }
+                });
+            }
+            for (const action of outcome.actions) {
+                switch (action) {
+                    case 'detach':
+                        finish(0);
+                        return;
+                    case 'toggle_help':
+                        showHelp = !showHelp;
+                        paintStatus();
+                        break;
+                }
+            }
+        };
+        const teardownStdin = () => {
+            try {
+                if (deps.stdin.off) {
+                    deps.stdin.off('data', stdinDataHandler);
+                }
+                else if (deps.stdin.removeListener) {
+                    deps.stdin.removeListener('data', stdinDataHandler);
+                }
+            }
+            catch {
+                // best effort
+            }
+            try {
+                if (rawModeWasSet && typeof deps.stdin.setRawMode === 'function') {
+                    deps.stdin.setRawMode(false);
+                }
+            }
+            catch {
+                // best effort
+            }
+            try {
+                deps.stdin.pause();
+            }
+            catch {
+                // best effort
+            }
+            try {
+                if (unsubscribeResize) {
+                    unsubscribeResize();
+                    unsubscribeResize = null;
+                }
+            }
+            catch {
+                // best effort
+            }
+            rawModeWasSet = false;
+        };
+        const finish = (code) => {
+            if (settled)
+                return;
+            settled = true;
+            teardownStdin();
+            try {
+                socket.close(1000, 'passthrough client exiting');
+            }
+            catch {
+                // best effort
+            }
+            // Restore the worker's previous mode (no-op if it was already
+            // auto-inject, which is the common case).
+            void setInboundDeliveryMode(connection, name, previousMode ?? 'auto_inject', deps.fetch).finally(() => {
+                resolve(code);
+            });
+        };
+        const socket = deps.createWebSocket(wsUrl, headers);
+        deps.onSignal('SIGINT', () => finish(0));
+        deps.onSignal('SIGTERM', () => finish(0));
+        socket.on('open', () => {
+            deps.log(`[passthrough] attached to ${name} via ${connection.url} (Ctrl+B D to detach)`);
+            try {
+                if (typeof deps.stdin.setRawMode === 'function' && deps.stdin.isTTY !== false) {
+                    deps.stdin.setRawMode(true);
+                    rawModeWasSet = true;
+                }
+                deps.stdin.resume();
+                deps.stdin.on('data', stdinDataHandler);
+                unsubscribeResize = deps.terminal.onResize(resizeHandler);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                deps.error(`[passthrough] could not enable raw input mode: ${message}`);
+                finish(1);
+            }
+        });
+        socket.on('message', (data) => {
+            const text = typeof data === 'string' ? data : Buffer.isBuffer(data) ? data.toString('utf-8') : String(data);
+            const event = classifyWsEvent(text, name);
+            switch (event.kind) {
+                case 'worker_stream':
+                    deps.writeChunk(event.chunk);
+                    paintStatus();
+                    break;
+                case 'other':
+                    break;
+            }
+        });
+        socket.on('error', (err) => {
+            deps.error(`[passthrough] WebSocket error: ${err.message}`);
+        });
+        socket.on('close', (code, reason) => {
+            if (settled)
+                return;
+            const reasonText = reason && reason.length > 0 ? reason.toString('utf-8') : '';
+            if (code === 1000 || code === 1005) {
+                finish(0);
+            }
+            else {
+                deps.error(`[passthrough] connection closed (code: ${code}${reasonText ? `, reason: ${reasonText}` : ''})`);
+                finish(1);
+            }
+        });
+    });
+}
+/** Register `agent-relay passthrough <name>` on the supplied commander program. */
+export function registerPassthroughCommands(program, overrides = {}) {
+    const deps = withDefaults(overrides);
+    program
+        .command('passthrough')
+        .description('Watch a running agent in passthrough session: broker auto-injects inbound relay messages while you type alongside (last-writer-wins)')
+        .argument('<name>', 'Agent name to attach to')
+        .option('--broker-url <url>', 'Broker base URL (overrides RELAY_BROKER_URL and connection.json)')
+        .option('--api-key <key>', 'Broker API key (overrides RELAY_BROKER_API_KEY and connection.json)')
+        .option('--state-dir <dir>', 'Directory containing connection.json (default: .agent-relay/)')
+        .action(async (name, options) => {
+        const code = await runPassthroughSession(name, options, deps);
+        if (code !== 0) {
+            deps.exit(code);
+        }
+    });
+}
+//# sourceMappingURL=passthrough.js.map

package/dist/src/cli/commands/passthrough.js.map

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

package/dist/src/cli/commands/rm.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `agent-relay rm <name>` — release a spawned agent via the broker's
+ * `DELETE /api/spawned/{name}` route.
+ *
+ * Trivial wrapper. Prints a one-line confirmation on success and a
+ * one-line explanatory error on failure. Connection discovery uses the
+ * shared `resolveBrokerConnection` helper so the same `--broker-url` /
+ * `RELAY_BROKER_URL` / `connection.json` chain works as for `view` /
+ * `drive` / `passthrough`.
+ *
+ * The longer-form `release` command in `agent-management.ts` layers
+ * broker autostart on top of the same SDK client; `rm` is the lighter
+ * "I already have a broker" entry point.
+ */
+import { Command } from 'commander';
+import { type BrokerConnection } from '../lib/broker-connection.js';
+type ExitFn = (code: number) => never;
+export interface RmDependencies {
+    readConnectionFile: (stateDir: string) => unknown;
+    getDefaultStateDir: () => string;
+    env: NodeJS.ProcessEnv;
+    fetch: typeof globalThis.fetch;
+    log: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    exit: ExitFn;
+}
+/** Outcome of `releaseAgent`. Useful for the `--ephemeral` teardown in `run`. */
+export interface ReleaseResult {
+    ok: boolean;
+    status: number;
+    message?: string;
+}
+/**
+ * Release through the SDK client against the resolved broker. Returns a
+ * structured outcome the caller can decide how to surface — `rm` prints
+ * a one-liner, the `--ephemeral` teardown in `run` swallows failures
+ * because the client is already on its way out.
+ */
+export declare function releaseAgent(connection: BrokerConnection, agentName: string, fetchFn: typeof globalThis.fetch): Promise<ReleaseResult>;
+/**
+ * Run the `rm <name>` verb. Resolves with the exit code the CLI should
+ * propagate. Pure — no signal handlers, no event loop hooks.
+ */
+export declare function runRm(agentName: string, options: {
+    brokerUrl?: string;
+    apiKey?: string;
+    stateDir?: string;
+}, deps: RmDependencies): Promise<number>;
+/** Register `agent-relay rm <name>` on the supplied commander program. */
+export declare function registerRmCommands(program: Command, overrides?: Partial<RmDependencies>): void;
+export {};
+//# sourceMappingURL=rm.d.ts.map

package/dist/src/cli/commands/rm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rm.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/rm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AAIrC,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;AAEtC,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,kBAAkB,EAAE,MAAM,MAAM,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAeD,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,UAAU,CAAC,KAAK,GAC/B,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED;;;GAGG;AACH,wBAAsB,KAAK,CACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACnE,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,IAAI,CAgBlG"}

package/dist/src/cli/commands/rm.js

@@ -0,0 +1,96 @@
+/**
+ * `agent-relay rm <name>` — release a spawned agent via the broker's
+ * `DELETE /api/spawned/{name}` route.
+ *
+ * Trivial wrapper. Prints a one-line confirmation on success and a
+ * one-line explanatory error on failure. Connection discovery uses the
+ * shared `resolveBrokerConnection` helper so the same `--broker-url` /
+ * `RELAY_BROKER_URL` / `connection.json` chain works as for `view` /
+ * `drive` / `passthrough`.
+ *
+ * The longer-form `release` command in `agent-management.ts` layers
+ * broker autostart on top of the same SDK client; `rm` is the lighter
+ * "I already have a broker" entry point.
+ */
+import { defaultStateDir, readConnectionFileFromDisk, resolveBrokerConnection, } from '../lib/broker-connection.js';
+import { defaultExit } from '../lib/exit.js';
+import { createBrokerClient, mapBrokerSdkFailure } from '../lib/sdk-client.js';
+function withDefaults(overrides = {}) {
+    return {
+        readConnectionFile: readConnectionFileFromDisk,
+        getDefaultStateDir: defaultStateDir,
+        env: process.env,
+        fetch: (input, init) => fetch(input, init),
+        log: (...args) => console.log(...args),
+        error: (...args) => console.error(...args),
+        exit: defaultExit,
+        ...overrides,
+    };
+}
+/**
+ * Release through the SDK client against the resolved broker. Returns a
+ * structured outcome the caller can decide how to surface — `rm` prints
+ * a one-liner, the `--ephemeral` teardown in `run` swallows failures
+ * because the client is already on its way out.
+ */
+export async function releaseAgent(connection, agentName, fetchFn) {
+    try {
+        await createBrokerClient(connection, fetchFn).release(agentName);
+        return { ok: true, status: 200 };
+    }
+    catch (err) {
+        const failure = mapBrokerSdkFailure(err);
+        return { ok: false, status: failure.status, message: failure.message };
+    }
+}
+/**
+ * Run the `rm <name>` verb. Resolves with the exit code the CLI should
+ * propagate. Pure — no signal handlers, no event loop hooks.
+ */
+export async function runRm(agentName, options, deps) {
+    // Normalize once so lookups, error messages, and the success log all
+    // see the same trimmed name. Without this a stray space turns into a
+    // 404 (broker registers names verbatim) and the error message echoes
+    // the raw input, which makes debugging quoting issues painful.
+    const name = agentName.trim();
+    if (!name) {
+        deps.error('Error: agent name is required');
+        return 1;
+    }
+    const connection = resolveBrokerConnection(options, deps);
+    if (!connection) {
+        deps.error('Error: could not locate broker connection. Pass --broker-url, set RELAY_BROKER_URL, ' +
+            'or run from a directory containing .agent-relay/connection.json.');
+        return 1;
+    }
+    const result = await releaseAgent(connection, name, deps.fetch);
+    if (!result.ok) {
+        if (result.status === 404) {
+            deps.error(`Error: no agent named '${name}'`);
+        }
+        else {
+            deps.error(`Error: could not release '${name}': ${result.message ?? 'unknown error'}`);
+        }
+        return 1;
+    }
+    deps.log(`Released agent: ${name}`);
+    return 0;
+}
+/** Register `agent-relay rm <name>` on the supplied commander program. */
+export function registerRmCommands(program, overrides = {}) {
+    const deps = withDefaults(overrides);
+    program
+        .command('rm')
+        .description('Release a running agent via the broker (no terminal required)')
+        .argument('<name>', 'Agent name to release')
+        .option('--broker-url <url>', 'Broker base URL (overrides RELAY_BROKER_URL and connection.json)')
+        .option('--api-key <key>', 'Broker API key (overrides RELAY_BROKER_API_KEY and connection.json)')
+        .option('--state-dir <dir>', 'Directory containing connection.json (default: .agent-relay/)')
+        .action(async (name, options) => {
+        const code = await runRm(name, options, deps);
+        if (code !== 0) {
+            deps.exit(code);
+        }
+    });
+}
+//# sourceMappingURL=rm.js.map

package/dist/src/cli/commands/rm.js.map

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