agent-relay 7.1.1 → 8.0.2

package/dist/cli/lib/broker-connection.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared broker-connection discovery for the attach-style CLI verbs
+ * (`view`, `drive`, `passthrough`).
+ *
+ * Resolution order matches `agent-relay-broker dump-pty` so users don't
+ * have to learn two patterns:
+ *
+ *   1. `--broker-url` / `--api-key` CLI flags
+ *   2. `RELAY_BROKER_URL` / `RELAY_BROKER_API_KEY` environment variables
+ *   3. `<state-dir>/connection.json` (default `.agentworkforce/relay/connection.json`)
+ */
+/** Connection metadata discovered from `connection.json` or CLI/env overrides. */
+export interface BrokerConnection {
+    url: string;
+    apiKey?: string;
+}
+/** Options the caller may have parsed from CLI flags. */
+export interface BrokerConnectionOptions {
+    brokerUrl?: string;
+    apiKey?: string;
+    stateDir?: string;
+}
+/** Injectable bits — tests stub these out instead of touching disk / env. */
+export interface BrokerConnectionDeps {
+    readConnectionFile: (stateDir: string) => unknown;
+    getDefaultStateDir: () => string;
+    env: NodeJS.ProcessEnv;
+}
+/** Read `<state-dir>/connection.json` from disk, returning the parsed JSON or `null`. */
+export declare function readConnectionFileFromDisk(stateDir: string): unknown;
+/** Default state-directory: `.agentworkforce/relay/` under the resolved project root. */
+export declare function defaultStateDir(): string;
+/**
+ * Resolve the broker connection in priority order. Returns `null` when no
+ * source provides a URL — the caller decides how to surface that.
+ */
+export declare function resolveBrokerConnection(options: BrokerConnectionOptions, deps: BrokerConnectionDeps): BrokerConnection | null;
+/** Convert an `http(s)://host:port` base URL to the matching `ws(s)://…/ws`. */
+export declare function toWsUrl(baseUrl: string): string;
+//# sourceMappingURL=broker-connection.d.ts.map

package/dist/cli/lib/broker-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-connection.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/broker-connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,kBAAkB,EAAE,MAAM,MAAM,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,yFAAyF;AACzF,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQpE;AAED,yFAAyF;AACzF,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AA2BD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,GAAG,IAAI,CAmBzB;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/cli/lib/broker-connection.js

@@ -0,0 +1,82 @@
+/**
+ * Shared broker-connection discovery for the attach-style CLI verbs
+ * (`view`, `drive`, `passthrough`).
+ *
+ * Resolution order matches `agent-relay-broker dump-pty` so users don't
+ * have to learn two patterns:
+ *
+ *   1. `--broker-url` / `--api-key` CLI flags
+ *   2. `RELAY_BROKER_URL` / `RELAY_BROKER_API_KEY` environment variables
+ *   3. `<state-dir>/connection.json` (default `.agentworkforce/relay/connection.json`)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { getProjectPaths } from '@agent-relay/config';
+/** Read `<state-dir>/connection.json` from disk, returning the parsed JSON or `null`. */
+export function readConnectionFileFromDisk(stateDir) {
+    const connPath = path.join(stateDir, 'connection.json');
+    try {
+        const raw = fs.readFileSync(connPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Default state-directory: `.agentworkforce/relay/` under the resolved project root. */
+export function defaultStateDir() {
+    const projectRoot = getProjectPaths().projectRoot;
+    return path.join(projectRoot, '.agentworkforce/relay');
+}
+function isStringObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readString(obj, key) {
+    if (!isStringObject(obj))
+        return undefined;
+    const value = obj[key];
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+/**
+ * Trim a possibly-undefined string and treat empty results as
+ * `undefined` so `??` chains correctly fall through to lower-priority
+ * sources. Plain `value?.trim()` would yield `""` for blank inputs,
+ * which is not nullish — that would let an empty `--broker-url` flag
+ * silently override a real `RELAY_BROKER_URL` env var, etc.
+ */
+function trimOrUndefined(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+/**
+ * Resolve the broker connection in priority order. Returns `null` when no
+ * source provides a URL — the caller decides how to surface that.
+ */
+export function resolveBrokerConnection(options, deps) {
+    const explicitUrl = trimOrUndefined(options.brokerUrl);
+    const envUrl = trimOrUndefined(deps.env.RELAY_BROKER_URL);
+    const stateDir = options.stateDir ? path.resolve(options.stateDir) : deps.getDefaultStateDir();
+    const connectionFile = deps.readConnectionFile(stateDir);
+    const fileUrl = readString(connectionFile, 'url');
+    const url = explicitUrl ?? envUrl ?? fileUrl;
+    if (!url)
+        return null;
+    const explicitKey = trimOrUndefined(options.apiKey);
+    const envKey = trimOrUndefined(deps.env.RELAY_BROKER_API_KEY);
+    const fileKey = readString(connectionFile, 'api_key');
+    const apiKey = explicitKey ?? envKey ?? fileKey;
+    return {
+        url: url.replace(/\/+$/, ''),
+        apiKey,
+    };
+}
+/** Convert an `http(s)://host:port` base URL to the matching `ws(s)://…/ws`. */
+export function toWsUrl(baseUrl) {
+    return `${baseUrl.replace(/^http/, 'ws')}/ws`;
+}
+//# sourceMappingURL=broker-connection.js.map

package/dist/cli/lib/broker-connection.js.map

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

package/dist/cli/lib/broker-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/broker-lifecycle.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAA+C,MAAM,qBAAqB,CAAC;AAKzG,KAAK,SAAS,GAAG;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAWF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAwDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAE7E;AAcD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAuBlD;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAU7D;AAED,4BAA4B;AAC5B,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CAQvG;AAwjCD,wBAAsB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgX5F;AAGD,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkHhG;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAkDf"}