agent-relay 7.1.1 → 8.0.2

package/dist/cli/lib/sdk-client.d.ts

@@ -0,0 +1,20 @@
+import { AgentRelay, type AgentRelayAgent } from '@agent-relay/sdk';
+/** Options shared by the SDK-backed (Relaycast) CLI command groups. */
+export interface SdkClientOptions {
+    workspaceKey?: string;
+    token?: string;
+    baseUrl?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function resolveWorkspaceKey(options?: SdkClientOptions): string;
+export declare function resolveBaseUrl(options?: SdkClientOptions): string | undefined;
+export declare function resolveAgentToken(options?: SdkClientOptions): string | undefined;
+/** Workspace-scoped client (no agent token). */
+export declare function createWorkspaceRelay(options?: SdkClientOptions): AgentRelay;
+/**
+ * Agent-scoped client. When an agent token is available (flag or
+ * `RELAY_AGENT_TOKEN`), operations are attributed to that agent; otherwise the
+ * workspace-scoped client is returned.
+ */
+export declare function createAgentRelay(options?: SdkClientOptions): AgentRelayAgent;
+//# sourceMappingURL=sdk-client.d.ts.map

package/dist/cli/lib/sdk-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-client.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/sdk-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIpE,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAWD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAa1E;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM,GAAG,SAAS,CAEjF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM,GAAG,SAAS,CAEpF;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAOhF"}

package/dist/cli/lib/sdk-client.js

@@ -0,0 +1,44 @@
+import { AgentRelay } from '@agent-relay/sdk';
+import { activeWorkspaceKey } from './workspace-store.js';
+function env(options) {
+    return options.env ?? process.env;
+}
+function trimOrUndefined(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+export function resolveWorkspaceKey(options = {}) {
+    const e = env(options);
+    const key = trimOrUndefined(options.workspaceKey) ??
+        trimOrUndefined(e.RELAY_WORKSPACE_KEY) ??
+        trimOrUndefined(e.RELAY_API_KEY) ??
+        trimOrUndefined(activeWorkspaceKey(e));
+    if (!key) {
+        throw new Error('No workspace key found. Pass --workspace-key, set RELAY_WORKSPACE_KEY, or run `relay workspace set_key <name> <key>`.');
+    }
+    return key;
+}
+export function resolveBaseUrl(options = {}) {
+    return trimOrUndefined(options.baseUrl) ?? trimOrUndefined(env(options).RELAY_BASE_URL);
+}
+export function resolveAgentToken(options = {}) {
+    return trimOrUndefined(options.token) ?? trimOrUndefined(env(options).RELAY_AGENT_TOKEN);
+}
+/** Workspace-scoped client (no agent token). */
+export function createWorkspaceRelay(options = {}) {
+    return new AgentRelay({ workspaceKey: resolveWorkspaceKey(options), baseUrl: resolveBaseUrl(options) });
+}
+/**
+ * Agent-scoped client. When an agent token is available (flag or
+ * `RELAY_AGENT_TOKEN`), operations are attributed to that agent; otherwise the
+ * workspace-scoped client is returned.
+ */
+export function createAgentRelay(options = {}) {
+    const token = resolveAgentToken(options);
+    return new AgentRelay({
+        workspaceKey: resolveWorkspaceKey(options),
+        baseUrl: resolveBaseUrl(options),
+        ...(token ? { agentToken: token } : {}),
+    });
+}
+//# sourceMappingURL=sdk-client.js.map

package/dist/cli/lib/sdk-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-client.js","sourceRoot":"","sources":["../../../src/cli/lib/sdk-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAU1D,SAAS,GAAG,CAAC,OAAyB;IACpC,OAAO,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;AACpC,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAA4B,EAAE;IAChE,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,MAAM,GAAG,GACP,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC;QACrC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACtC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC;QAChC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAA4B,EAAE;IAC3D,OAAO,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAA4B,EAAE;IAC9D,OAAO,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC3F,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,oBAAoB,CAAC,UAA4B,EAAE;IACjE,OAAO,IAAI,UAAU,CAAC,EAAE,YAAY,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC1G,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA4B,EAAE;IAC7D,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,IAAI,UAAU,CAAC;QACpB,YAAY,EAAE,mBAAmB,CAAC,OAAO,CAAC;QAC1C,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;QAChC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/lib/sdk-command.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from 'commander';
+import { AgentRelay, type AgentRelayAgent } from '@agent-relay/sdk';
+import { type SdkClientOptions } from './sdk-client.js';
+type ExitFn = (code: number) => never;
+/** Shared dependencies for the SDK-backed (Relaycast) command groups. */
+export interface SdkCommandDeps {
+    createAgentRelay: (options?: SdkClientOptions) => AgentRelayAgent;
+    createWorkspaceRelay: (options?: SdkClientOptions) => AgentRelayAgent;
+    createWorkspace: (name: string, baseUrl?: string) => Promise<AgentRelay>;
+    log: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    exit: ExitFn;
+}
+export declare function withSdkDefaults(overrides?: Partial<SdkCommandDeps>): SdkCommandDeps;
+/** Add the common workspace/token/base-url options to a command. */
+export declare function addSdkOptions(command: Command): Command;
+export declare function sdkOptionsFromOpts(opts: Record<string, unknown>): SdkClientOptions;
+export declare function printJson(deps: SdkCommandDeps, value: unknown): void;
+/** Run an SDK command body, formatting errors consistently and exiting non-zero. */
+export declare function runSdk(deps: SdkCommandDeps, fn: () => Promise<void>): Promise<void>;
+export {};
+//# sourceMappingURL=sdk-command.d.ts.map

package/dist/cli/lib/sdk-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-command.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/sdk-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,EAA0C,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEhG,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;AAEtC,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,eAAe,CAAC;IAClE,oBAAoB,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,eAAe,CAAC;IACtE,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,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,wBAAgB,eAAe,CAAC,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CAUvF;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQvD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAMlF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEpE;AAED,oFAAoF;AACpF,wBAAsB,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzF"}

package/dist/cli/lib/sdk-command.js

@@ -0,0 +1,42 @@
+import { AgentRelay } from '@agent-relay/sdk';
+import { defaultExit } from './exit.js';
+import { createAgentRelay, createWorkspaceRelay } from './sdk-client.js';
+export function withSdkDefaults(overrides = {}) {
+    return {
+        createAgentRelay,
+        createWorkspaceRelay,
+        createWorkspace: (name, baseUrl) => AgentRelay.createWorkspace({ name, baseUrl }),
+        log: (...args) => console.log(...args),
+        error: (...args) => console.error(...args),
+        exit: defaultExit,
+        ...overrides,
+    };
+}
+/** Add the common workspace/token/base-url options to a command. */
+export function addSdkOptions(command) {
+    return command
+        .option('--workspace-key <key>', 'Workspace key (defaults to RELAY_WORKSPACE_KEY or the active workspace)')
+        .option('--token <token>', 'Agent token (defaults to RELAY_AGENT_TOKEN)')
+        .option('--base-url <url>', 'Override the API base URL (defaults to RELAY_BASE_URL)');
+}
+export function sdkOptionsFromOpts(opts) {
+    return {
+        workspaceKey: opts.workspaceKey,
+        token: opts.token,
+        baseUrl: opts.baseUrl,
+    };
+}
+export function printJson(deps, value) {
+    deps.log(JSON.stringify(value, null, 2));
+}
+/** Run an SDK command body, formatting errors consistently and exiting non-zero. */
+export async function runSdk(deps, fn) {
+    try {
+        await fn();
+    }
+    catch (err) {
+        deps.error(err instanceof Error ? err.message : String(err));
+        deps.exit(1);
+    }
+}
+//# sourceMappingURL=sdk-command.js.map

package/dist/cli/lib/sdk-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-command.js","sourceRoot":"","sources":["../../../src/cli/lib/sdk-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAyB,MAAM,iBAAiB,CAAC;AAchG,MAAM,UAAU,eAAe,CAAC,YAAqC,EAAE;IACrE,OAAO;QACL,gBAAgB;QAChB,oBAAoB;QACpB,eAAe,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACjF,GAAG,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACjD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QACrD,IAAI,EAAE,WAAW;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO;SACX,MAAM,CACL,uBAAuB,EACvB,yEAAyE,CAC1E;SACA,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;SACxE,MAAM,CAAC,kBAAkB,EAAE,wDAAwD,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAkC;QACrD,KAAK,EAAE,IAAI,CAAC,KAA2B;QACvC,OAAO,EAAE,IAAI,CAAC,OAA6B;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAoB,EAAE,KAAc;IAC5D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAoB,EAAE,EAAuB;IACxE,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/cli/lib/telemetry-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-helpers.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/telemetry-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQ/D"}

package/dist/cli/lib/telemetry-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-helpers.js","sourceRoot":"","sources":["../../../src/cli/lib/telemetry-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,OAAO;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC;IACtD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,GAAI,GAA2C,CAAC,WAAW,CAAC;QACtE,OAAO,IAAI,EAAE,IAAI,IAAI,QAAQ,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,GAAG,CAAC;AACpB,CAAC"}

package/dist/cli/lib/workspace-store.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Local store of named workspace keys plus which one is active. Backs the
+ * `relay workspace set_key/switch/list` commands and provides a fallback key
+ * for SDK-backed commands when no env var or flag is supplied.
+ */
+export interface WorkspaceStore {
+    active?: string;
+    workspaces: Record<string, {
+        key: string;
+    }>;
+}
+export declare function workspaceStorePath(env?: NodeJS.ProcessEnv): string;
+export declare function validateWorkspaceName(name: string): string;
+export declare function readWorkspaceStore(env?: NodeJS.ProcessEnv): WorkspaceStore;
+export declare function writeWorkspaceStore(store: WorkspaceStore, env?: NodeJS.ProcessEnv): void;
+export declare function setWorkspaceKey(name: string, key: string, env?: NodeJS.ProcessEnv): WorkspaceStore;
+export declare function switchWorkspace(name: string, env?: NodeJS.ProcessEnv): WorkspaceStore;
+export declare function activeWorkspaceKey(env?: NodeJS.ProcessEnv): string | undefined;
+//# sourceMappingURL=workspace-store.d.ts.map

package/dist/cli/lib/workspace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-store.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/workspace-store.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C;AAID,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG/E;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,CAWvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAKrG;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,cAAc,CAOhB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,CAWlG;AAED,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAG3F"}

package/dist/cli/lib/workspace-store.js

@@ -0,0 +1,63 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const RESERVED_WORKSPACE_NAMES = new Set(['__proto__', 'prototype', 'constructor']);
+export function workspaceStorePath(env = process.env) {
+    const dir = env.AGENT_RELAY_HOME ?? path.join(os.homedir(), '.agentworkforce/relay');
+    return path.join(dir, 'workspaces.json');
+}
+function isNodeError(err) {
+    return err instanceof Error && 'code' in err;
+}
+export function validateWorkspaceName(name) {
+    const trimmed = name.trim();
+    if (!trimmed) {
+        throw new Error('Workspace name is required.');
+    }
+    if (RESERVED_WORKSPACE_NAMES.has(trimmed)) {
+        throw new Error(`Invalid workspace name "${trimmed}".`);
+    }
+    return trimmed;
+}
+export function readWorkspaceStore(env = process.env) {
+    const file = workspaceStorePath(env);
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        return { active: parsed.active, workspaces: parsed.workspaces ?? {} };
+    }
+    catch (err) {
+        if (isNodeError(err) && err.code === 'ENOENT') {
+            return { workspaces: {} };
+        }
+        throw err;
+    }
+}
+export function writeWorkspaceStore(store, env = process.env) {
+    const file = workspaceStorePath(env);
+    fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(file, `${JSON.stringify(store, null, 2)}\n`, { mode: 0o600 });
+    fs.chmodSync(file, 0o600);
+}
+export function setWorkspaceKey(name, key, env = process.env) {
+    const workspaceName = validateWorkspaceName(name);
+    const store = readWorkspaceStore(env);
+    store.workspaces[workspaceName] = { key };
+    store.active ??= workspaceName;
+    writeWorkspaceStore(store, env);
+    return store;
+}
+export function switchWorkspace(name, env = process.env) {
+    const workspaceName = validateWorkspaceName(name);
+    const store = readWorkspaceStore(env);
+    if (!store.workspaces[workspaceName]) {
+        throw new Error(`Unknown workspace "${workspaceName}". Add it with \`relay workspace set_key ${workspaceName} <key>\`.`);
+    }
+    store.active = workspaceName;
+    writeWorkspaceStore(store, env);
+    return store;
+}
+export function activeWorkspaceKey(env = process.env) {
+    const store = readWorkspaceStore(env);
+    return store.active ? store.workspaces[store.active]?.key : undefined;
+}
+//# sourceMappingURL=workspace-store.js.map

package/dist/cli/lib/workspace-store.js.map

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

package/dist/cli/telemetry/client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * PostHog telemetry client singleton.
+ */
+import { getDistinctId } from './config.js';
+import type { CommonProperties, TelemetryEventName, TelemetryEventMap } from './events.js';
+export interface InitTelemetryOptions {
+    /** Whether to show the first-run telemetry notice. Default: true. */
+    showNotice?: boolean;
+    /**
+     * The emitter's own CLI version, e.g. the root `agent-relay` package version.
+     * Pass this explicitly — the fallback auto-detection resolves the *telemetry*
+     * package's `package.json`, not the product's.
+     */
+    cliVersion?: string;
+    /** Resolved `@agent-relay/sdk` version, if known. */
+    sdkVersion?: string;
+    /** `agent-relay-broker` Rust binary version, if known. */
+    brokerVersion?: string;
+    /** Component emitting telemetry, e.g. `cli`, `broker`, or `sdk`. */
+    app?: string;
+    /** Product surface responsible for telemetry, e.g. `cli`, `cloud`, or `sdk`. */
+    surface?: string;
+    /** Parent harness driving Agent Relay, if already detected by the caller. */
+    orchestratorHarness?: string;
+}
+export declare function initTelemetry(options?: InitTelemetryOptions): void;
+export declare function track<E extends TelemetryEventName>(event: E, properties?: TelemetryEventMap[E] & Partial<CommonProperties>): void;
+export declare function shutdown(): Promise<void>;
+export declare function isEnabled(): boolean;
+export { getDistinctId };
+export declare function getStatus(): {
+    enabled: boolean;
+    disabledByEnv: boolean;
+    distinctId: string;
+    notifiedAt: string | undefined;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/cli/telemetry/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/cli/telemetry/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAEL,aAAa,EAKd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA0G3F,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,IAAI,CA4BtE;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,kBAAkB,EAChD,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAC5D,IAAI,CAWN;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAa9C;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,wBAAgB,SAAS,IAAI;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAQA"}

package/dist/cli/telemetry/client.js

@@ -0,0 +1,165 @@
+/**
+ * PostHog telemetry client singleton.
+ */
+import { PostHog } from 'posthog-node';
+import os from 'node:os';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isTelemetryEnabled, getDistinctId, wasNotified, markNotified, isDisabledByEnv, loadPrefs, } from './config.js';
+import { getPostHogConfig } from './posthog-config.js';
+import { detectOrchestratorHarness, UNKNOWN_ORCHESTRATOR_HARNESS } from './orchestrator-harness.js';
+let client = null;
+let commonProps = null;
+let distinctId = null;
+let initialized = false;
+function findPackageJson(startDir) {
+    let dir = startDir;
+    while (dir !== path.dirname(dir)) {
+        const candidate = path.join(dir, 'package.json');
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+/**
+ * Fallback version reader — walks up from the telemetry package's own
+ * `__dirname`. In an installed layout this resolves to the telemetry
+ * package's `package.json`, which is NOT meaningful to the product.
+ * Prefer having the caller pass explicit versions via `initTelemetry()`.
+ */
+function getFallbackVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        const packageJsonPath = findPackageJson(__dirname);
+        if (packageJsonPath) {
+            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            return pkg.version || 'unknown';
+        }
+    }
+    catch {
+        // Fall through
+    }
+    return 'unknown';
+}
+function buildCommonProperties(versions) {
+    // The primary version depends on who's emitting: prefer CLI > broker > SDK
+    // > fallback. This keeps `agent_relay_version` meaningful for existing
+    // dashboards while the typed `cli_version`/`sdk_version`/`broker_version`
+    // fields carry the precise per-component versions.
+    const primary = versions.cliVersion ?? versions.brokerVersion ?? versions.sdkVersion ?? getFallbackVersion();
+    return {
+        app: versions.app ??
+            (versions.cliVersion
+                ? 'cli'
+                : versions.brokerVersion
+                    ? 'broker'
+                    : versions.sdkVersion
+                        ? 'sdk'
+                        : 'unknown'),
+        surface: versions.surface ??
+            (versions.cliVersion
+                ? 'cli'
+                : versions.brokerVersion
+                    ? 'broker'
+                    : versions.sdkVersion
+                        ? 'sdk'
+                        : 'unknown'),
+        orchestrator_harness: versions.orchestratorHarness ?? detectOrchestratorHarness() ?? UNKNOWN_ORCHESTRATOR_HARNESS,
+        agent_relay_version: primary,
+        ...(versions.cliVersion ? { cli_version: versions.cliVersion } : {}),
+        ...(versions.sdkVersion ? { sdk_version: versions.sdkVersion } : {}),
+        ...(versions.brokerVersion ? { broker_version: versions.brokerVersion } : {}),
+        os: process.platform,
+        os_version: os.release(),
+        node_version: process.version.slice(1),
+        arch: process.arch,
+    };
+}
+function showFirstRunNotice() {
+    if (wasNotified())
+        return;
+    if (isDisabledByEnv()) {
+        markNotified();
+        return;
+    }
+    console.log('');
+    console.log('Agent Relay collects usage telemetry to improve the product.');
+    console.log('Run `agent-relay telemetry disable` to opt out.');
+    console.log('Learn more: https://agentrelay.com/telemetry');
+    console.log('');
+    markNotified();
+}
+export function initTelemetry(options = {}) {
+    if (initialized)
+        return;
+    initialized = true;
+    const posthogConfig = getPostHogConfig();
+    if (!posthogConfig)
+        return;
+    if (options.showNotice !== false) {
+        showFirstRunNotice();
+    }
+    if (!isTelemetryEnabled())
+        return;
+    client = new PostHog(posthogConfig.apiKey, {
+        host: posthogConfig.host,
+        flushAt: 10,
+        flushInterval: 10000,
+        disableGeoip: false, // CLI runs on user's machine, so IP is correct for geo
+    });
+    commonProps = buildCommonProperties({
+        cliVersion: options.cliVersion,
+        sdkVersion: options.sdkVersion,
+        brokerVersion: options.brokerVersion,
+        app: options.app,
+        surface: options.surface,
+        orchestratorHarness: options.orchestratorHarness,
+    });
+    distinctId = getDistinctId();
+}
+export function track(event, properties) {
+    if (!client || !commonProps || !distinctId)
+        return;
+    client.capture({
+        distinctId,
+        event,
+        properties: {
+            ...commonProps,
+            ...properties,
+        },
+    });
+}
+export async function shutdown() {
+    if (!client)
+        return;
+    try {
+        await client.shutdown();
+    }
+    catch {
+        // Ignore
+    }
+    finally {
+        client = null;
+        commonProps = null;
+        distinctId = null;
+        initialized = false;
+    }
+}
+export function isEnabled() {
+    return isTelemetryEnabled();
+}
+export { getDistinctId };
+export function getStatus() {
+    const prefs = loadPrefs();
+    return {
+        enabled: isTelemetryEnabled(),
+        disabledByEnv: isDisabledByEnv(),
+        distinctId: prefs.distinctId,
+        notifiedAt: prefs.notifiedAt,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/cli/telemetry/client.js.map

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

package/dist/cli/telemetry/config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Telemetry preference storage (~/.agentworkforce/relay/telemetry.json)
+ */
+export interface TelemetryPrefs {
+    /** Whether telemetry is enabled (default: true) */
+    enabled: boolean;
+    /** ISO timestamp when user was shown the first-run notice */
+    notifiedAt?: string;
+    /** Stable hashed machine identifier used as the PostHog distinctId. */
+    distinctId: string;
+}
+export declare function getPrefsPath(): string;
+export declare function loadPrefs(): TelemetryPrefs;
+export declare function savePrefs(prefs: TelemetryPrefs): void;
+export declare function isDisabledByEnv(): boolean;
+/**
+ * Check if telemetry is enabled.
+ * Order of precedence:
+ * 1. AGENT_RELAY_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 -> disabled
+ * 2. ~/.agentworkforce/relay/telemetry.json -> use stored pref
+ * 3. Default -> enabled
+ */
+export declare function isTelemetryEnabled(): boolean;
+export declare function enableTelemetry(): void;
+export declare function disableTelemetry(): void;
+export declare function markNotified(): void;
+export declare function wasNotified(): boolean;
+export declare function getDistinctId(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/telemetry/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/telemetry/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAgB,SAAS,IAAI,cAAc,CA4B1C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAWrD;AAMD,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAK5C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAInC;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/cli/telemetry/config.js

@@ -0,0 +1,90 @@
+/**
+ * Telemetry preference storage (~/.agentworkforce/relay/telemetry.json)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { createDistinctId } from './machine-id.js';
+export function getPrefsPath() {
+    const configDir = process.env.AGENT_RELAY_DATA_DIR || path.join(os.homedir(), '.agentworkforce/relay');
+    return path.join(configDir, 'telemetry.json');
+}
+export function loadPrefs() {
+    const prefsPath = getPrefsPath();
+    try {
+        if (fs.existsSync(prefsPath)) {
+            const content = fs.readFileSync(prefsPath, 'utf-8');
+            const prefs = JSON.parse(content);
+            const distinctId = prefs.distinctId ?? prefs.anonymousId ?? createDistinctId();
+            const normalized = {
+                enabled: prefs.enabled ?? true,
+                notifiedAt: prefs.notifiedAt,
+                distinctId,
+            };
+            if (prefs.distinctId !== distinctId || prefs.anonymousId !== undefined) {
+                savePrefs(normalized);
+            }
+            return normalized;
+        }
+    }
+    catch {
+        // Fall through to defaults
+    }
+    return {
+        enabled: true,
+        distinctId: createDistinctId(),
+    };
+}
+export function savePrefs(prefs) {
+    const prefsPath = getPrefsPath();
+    const configDir = path.dirname(prefsPath);
+    try {
+        fs.mkdirSync(configDir, { recursive: true });
+        fs.writeFileSync(prefsPath, JSON.stringify(prefs, null, 2), 'utf-8');
+    }
+    catch (err) {
+        // Silently fail - telemetry shouldn't break the app
+        console.error('[telemetry] Failed to save preferences:', err);
+    }
+}
+function isTruthyEnv(value) {
+    return value === '1' || value?.toLowerCase() === 'true';
+}
+export function isDisabledByEnv() {
+    return isTruthyEnv(process.env.AGENT_RELAY_TELEMETRY_DISABLED) || isTruthyEnv(process.env.DO_NOT_TRACK);
+}
+/**
+ * Check if telemetry is enabled.
+ * Order of precedence:
+ * 1. AGENT_RELAY_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 -> disabled
+ * 2. ~/.agentworkforce/relay/telemetry.json -> use stored pref
+ * 3. Default -> enabled
+ */
+export function isTelemetryEnabled() {
+    if (isDisabledByEnv()) {
+        return false;
+    }
+    return loadPrefs().enabled;
+}
+export function enableTelemetry() {
+    const prefs = loadPrefs();
+    prefs.enabled = true;
+    savePrefs(prefs);
+}
+export function disableTelemetry() {
+    const prefs = loadPrefs();
+    prefs.enabled = false;
+    savePrefs(prefs);
+}
+export function markNotified() {
+    const prefs = loadPrefs();
+    prefs.notifiedAt = new Date().toISOString();
+    savePrefs(prefs);
+}
+export function wasNotified() {
+    return loadPrefs().notifiedAt !== undefined;
+}
+export function getDistinctId() {
+    return loadPrefs().distinctId;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/telemetry/config.js.map

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