agent-relay 7.1.1 → 8.0.0

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

@@ -0,0 +1,340 @@
+/**
+ * Type-safe telemetry event definitions.
+ *
+ * Following PostHog naming best practices:
+ * - snake_case for events and properties
+ * - Present tense verbs (spawn, not spawned)
+ * - object_action pattern
+ *
+ * Privacy rules for authors:
+ * - Never capture argument values (file paths, run IDs, task text, tokens, URLs).
+ * - Flag NAMES are fine; flag VALUES are not.
+ * - When an event can fail, prefer `error_class` over `error_message` so we
+ *   don't leak user content or paths. `error_class` is typically the Error
+ *   constructor name (`errorClassName(err)`), but it may also be a stable
+ *   synthetic category tag at non-throw failure sites — for example,
+ *   `'WorkflowNotCompleted'` when a workflow returns `status !== 'completed'`
+ *   without throwing. Stick to PascalCase tags so real Error names and
+ *   synthetic categories share one namespace.
+ */
+/** Source of spawn/release action */
+export type ActionSource = 'human_cli' | 'human_dashboard' | 'agent' | 'protocol';
+/** Component that emitted the telemetry event. */
+export type TelemetryApp = 'cli' | 'broker' | 'sdk' | 'relaycast-server' | 'dashboard' | 'unknown';
+/** User-facing product surface responsible for the event. */
+export type TelemetrySurface = 'cli' | 'broker' | 'sdk' | 'cloud' | 'mcp' | 'dashboard' | 'unknown';
+/**
+ * Reason for agent release.
+ *
+ * This is a loose `string` on purpose — the broker emits both product-level
+ * reasons (`'explicit' | 'crash' | 'timeout' | 'shutdown'`) and broker-local
+ * categories that describe *how* the release arrived (`'ws_command'`,
+ * `'relaycast_release'`, etc.). Keeping the type open lets the schema stay
+ * honest about what actually shows up in PostHog without forcing every new
+ * broker category to be a breaking TS change.
+ *
+ * Known values (non-exhaustive):
+ *   - Canonical: `'explicit'`, `'crash'`, `'timeout'`, `'shutdown'`
+ *   - Broker-local: `'ws_command'`, `'relaycast_release'`
+ */
+export type ReleaseReason = string;
+/**
+ * Common properties attached to every event.
+ *
+ * Version identification:
+ *   - `cli_version` — version of the `agent-relay` CLI, when the event was
+ *     emitted from the CLI process
+ *   - `sdk_version` — version of `@agent-relay/sdk` resolved/bundled with the
+ *     emitter. Populated when the CLI or broker can discover it.
+ *   - `broker_version` — version of the Rust broker binary. Populated when
+ *     emitted from the broker, or when the CLI is propagating broker info.
+ *   - `agent_relay_version` — kept for backward compatibility with existing
+ *     PostHog dashboards. Mirrors whichever component actually emitted the
+ *     event: `cli_version` on CLI-originated events, `broker_version` on
+ *     broker-originated events.
+ */
+export interface CommonProperties {
+    /** Component that emitted the event, e.g. `cli`, `broker`, `sdk`. */
+    app: TelemetryApp | string;
+    /** Product surface responsible for the event, e.g. `cli`, `sdk`, `cloud`. */
+    surface: TelemetrySurface | string;
+    /** Parent harness driving Agent Relay, e.g. `claude-code`, `codex`, `cursor`, or `unknown`. */
+    orchestrator_harness: string;
+    /** Back-compat alias — same value as the emitter's primary version. */
+    agent_relay_version: string;
+    /** `agent-relay` CLI version, if known to the emitter. */
+    cli_version?: string;
+    /** `@agent-relay/sdk` version, if resolvable. */
+    sdk_version?: string;
+    /** `agent-relay-broker` Rust binary version, if known. */
+    broker_version?: string;
+    /** Operating system (e.g., darwin, linux, win32) */
+    os: string;
+    /**
+     * OS release version (e.g. `uname -r` output on unix).
+     * Optional — the broker omits this when detection fails on unusual
+     * platforms, and callers should treat its absence as "unknown".
+     */
+    os_version?: string;
+    /** Node.js version (without 'v' prefix). Absent on broker-originated events. */
+    node_version?: string;
+    /** CPU architecture (e.g., arm64, x64) */
+    arch: string;
+}
+/**
+ * broker_start - Emitted when the broker starts.
+ * No additional properties beyond common props.
+ */
+export type BrokerStartEvent = Record<string, never>;
+/**
+ * broker_stop - Emitted when the broker stops.
+ */
+export interface BrokerStopEvent {
+    /** How long the broker was running, in seconds */
+    uptime_seconds: number;
+    /** Total agents spawned during this session */
+    agent_spawn_count: number;
+}
+/**
+ * broker_start_failed - Emitted when the CLI fails to start or connect to a broker.
+ * Captures the stage so we can tell config problems from port conflicts from
+ * binary-not-found, without leaking paths or args.
+ */
+export interface BrokerStartFailedEvent {
+    /** Coarse phase where we gave up — e.g., 'resolve_binary', 'spawn', 'connect', 'handshake' */
+    stage: string;
+    /** Error constructor name (e.g., 'ENOENT', 'ECONNREFUSED', 'Error') */
+    error_class: string;
+}
+/**
+ * agent_spawn - Emitted when an agent is created.
+ */
+export interface AgentSpawnEvent {
+    /** CLI type (claude, codex, gemini, etc.) */
+    cli: string;
+    /** Where the spawn originated */
+    spawn_source: ActionSource;
+    /** Whether a task was provided */
+    has_task: boolean;
+    /** Whether this is a shadow agent */
+    is_shadow: boolean;
+}
+/**
+ * agent_release - Emitted when an agent is stopped.
+ */
+export interface AgentReleaseEvent {
+    /** CLI type (claude, codex, gemini, etc.) */
+    cli: string;
+    /** Why the agent was released */
+    release_reason: ReleaseReason;
+    /** How long the agent was alive, in seconds */
+    lifetime_seconds: number;
+    /** Where the release originated */
+    release_source: ActionSource;
+}
+/**
+ * agent_crash - Emitted when an agent dies unexpectedly.
+ */
+export interface AgentCrashEvent {
+    /** CLI type (claude, codex, gemini, etc.) */
+    cli: string;
+    /** How long the agent was alive, in seconds */
+    lifetime_seconds: number;
+    /** Exit code if available */
+    exit_code?: number;
+}
+/**
+ * message_send - Emitted when an agent sends a relay message.
+ */
+export interface MessageSendEvent {
+    /** Whether this was a broadcast message */
+    is_broadcast: boolean;
+    /** Whether this message is part of a thread */
+    has_thread: boolean;
+}
+/**
+ * cli_command_run - Emitted before a CLI command's action runs.
+ * Now fires for every command (not just interactive), via a global Commander hook.
+ */
+export interface CliCommandRunEvent {
+    /** Full command path — e.g., 'up', 'cloud login', 'workflows list' */
+    command_name: string;
+    /** Names (not values) of flags/options the user explicitly passed on the CLI */
+    flags_used?: string[];
+    /** True when stdin is a TTY — helps tell interactive vs scripted runs apart */
+    is_tty?: boolean;
+    /** Whether this process appears to be running inside CI */
+    is_ci?: boolean;
+}
+/**
+ * cli_command_complete - Emitted after a CLI command finishes (success or failure).
+ * Pairs with cli_command_run by command_name + same session.
+ */
+export interface CliCommandCompleteEvent {
+    /** Full command path — e.g., 'up', 'cloud login' */
+    command_name: string;
+    /** True if the command ran to completion without throwing / without exit(non-zero) */
+    success: boolean;
+    /** Wall-clock duration in milliseconds */
+    duration_ms: number;
+    /** Exit code if the command or top-level handler requested one */
+    exit_code?: number;
+    /** Error constructor name when success=false (e.g., 'Error', 'CommanderError') */
+    error_class?: string;
+}
+export type WorkflowFileType = 'yaml' | 'ts' | 'py' | 'unknown';
+/**
+ * workflow_run - Emitted when `agent-relay run <file>` finishes (success or failure).
+ * Covers the primary product surface — workflow execution from a local file.
+ */
+export interface WorkflowRunEvent {
+    /** Detected workflow file type */
+    file_type: WorkflowFileType;
+    /** True if --dry-run was passed */
+    is_dry_run: boolean;
+    /** True if --resume was passed */
+    is_resume: boolean;
+    /** True if --start-from was passed */
+    is_start_from: boolean;
+    /** True for .ts/.tsx/.py scripts (as opposed to YAML) */
+    is_script: boolean;
+    /** True if the command completed successfully */
+    success: boolean;
+    /** Wall-clock duration in milliseconds */
+    duration_ms: number;
+    /** Error constructor name on failure */
+    error_class?: string;
+}
+/**
+ * cloud_auth - Emitted for cloud account auth flows (login/logout/whoami/connect).
+ * `action` distinguishes the flow; `provider` is only present for `connect`.
+ */
+export interface CloudAuthEvent {
+    /** Which cloud-auth flow ran */
+    action: 'login' | 'logout' | 'whoami' | 'connect';
+    /** True if the flow completed without throwing */
+    success: boolean;
+    /** Wall-clock duration in milliseconds */
+    duration_ms: number;
+    /** Provider id for `connect` flows (e.g., 'anthropic', 'openai') */
+    provider?: string;
+    /** Error constructor name on failure */
+    error_class?: string;
+}
+/**
+ * cloud_workflow_run - Emitted when `agent-relay cloud run` submits a workflow.
+ */
+export interface CloudWorkflowRunEvent {
+    /** Whether --file-type was explicitly set by the user */
+    has_explicit_file_type: boolean;
+    /** Whether --sync-code was enabled (user or default) */
+    sync_code: boolean;
+    /** True if --json output mode was requested */
+    json_output: boolean;
+    /** True if the run was submitted successfully */
+    success: boolean;
+    /** Wall-clock duration in milliseconds */
+    duration_ms: number;
+    /** Error constructor name on failure */
+    error_class?: string;
+}
+/**
+ * cloud_workflow_schedule - Emitted when `agent-relay cloud schedule` creates a workflow schedule.
+ */
+export interface CloudWorkflowScheduleEvent {
+    /** Schedule trigger type requested by the user */
+    schedule_type: 'cron' | 'once';
+    /** Whether --file-type was explicitly set by the user */
+    has_explicit_file_type: boolean;
+    /** True if --json output mode was requested */
+    json_output: boolean;
+    /** True if the schedule was created successfully */
+    success: boolean;
+    /** Wall-clock duration in milliseconds */
+    duration_ms: number;
+    /** Error constructor name on failure */
+    error_class?: string;
+}
+/**
+ * provider_auth - Emitted for `agent-relay auth <provider>` (SSH-based provider login).
+ */
+export interface ProviderAuthEvent {
+    /** Normalized provider id (e.g., 'anthropic', 'openai', 'google') */
+    provider: string;
+    /** True if auth completed without throwing */
+    success: boolean;
+    /** Wall-clock duration in milliseconds */
+    duration_ms: number;
+    /** Whether the --use-auth-broker flag was set */
+    use_auth_broker: boolean;
+    /** Whether a one-time --token was provided */
+    used_token: boolean;
+    /** Error constructor name on failure */
+    error_class?: string;
+}
+/**
+ * setup_init - Emitted when the first-run init wizard runs.
+ */
+export interface SetupInitEvent {
+    /** True if running inside a cloud workspace (WORKSPACE_ID set) */
+    is_cloud: boolean;
+    /** True if a broker was already running when init started */
+    broker_was_running: boolean;
+    /** True if the user accepted the prompt to start the broker */
+    user_started_broker: boolean;
+    /** True if --yes was passed (non-interactive) */
+    yes_flag: boolean;
+    /** True if --skip-broker was passed */
+    skip_broker: boolean;
+}
+/**
+ * swarm_run - Emitted when an ad-hoc swarm run finishes.
+ */
+export interface SwarmRunEvent {
+    /** Swarm pattern (e.g., 'fan-out', 'competitive', 'pipeline') */
+    pattern: string;
+    /** Number of teams/stages requested */
+    teams: number;
+    /** CLI tool used for workers */
+    cli: string;
+    /** True if --list was passed */
+    is_list: boolean;
+    /** True if --dry-run was passed */
+    is_dry_run: boolean;
+    /** Exit code from the broker process */
+    exit_code: number;
+    /** Wall-clock duration in milliseconds */
+    duration_ms: number;
+}
+/**
+ * bridge_spawn - Emitted when the multi-project bridge is launched.
+ */
+export interface BridgeSpawnEvent {
+    /** Number of projects being bridged */
+    project_count: number;
+    /** CLI tool override if provided (else 'default') */
+    cli: string;
+    /** True if an architect agent was requested */
+    has_architect: boolean;
+}
+export type TelemetryEventName = 'broker_start' | 'broker_stop' | 'broker_start_failed' | 'agent_spawn' | 'agent_release' | 'agent_crash' | 'message_send' | 'cli_command_run' | 'cli_command_complete' | 'workflow_run' | 'cloud_auth' | 'cloud_workflow_run' | 'cloud_workflow_schedule' | 'provider_auth' | 'setup_init' | 'swarm_run' | 'bridge_spawn';
+export interface TelemetryEventMap {
+    broker_start: BrokerStartEvent;
+    broker_stop: BrokerStopEvent;
+    broker_start_failed: BrokerStartFailedEvent;
+    agent_spawn: AgentSpawnEvent;
+    agent_release: AgentReleaseEvent;
+    agent_crash: AgentCrashEvent;
+    message_send: MessageSendEvent;
+    cli_command_run: CliCommandRunEvent;
+    cli_command_complete: CliCommandCompleteEvent;
+    workflow_run: WorkflowRunEvent;
+    cloud_auth: CloudAuthEvent;
+    cloud_workflow_run: CloudWorkflowRunEvent;
+    cloud_workflow_schedule: CloudWorkflowScheduleEvent;
+    provider_auth: ProviderAuthEvent;
+    setup_init: SetupInitEvent;
+    swarm_run: SwarmRunEvent;
+    bridge_spawn: BridgeSpawnEvent;
+}
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/cli/telemetry/events.js

@@ -0,0 +1,21 @@
+/**
+ * Type-safe telemetry event definitions.
+ *
+ * Following PostHog naming best practices:
+ * - snake_case for events and properties
+ * - Present tense verbs (spawn, not spawned)
+ * - object_action pattern
+ *
+ * Privacy rules for authors:
+ * - Never capture argument values (file paths, run IDs, task text, tokens, URLs).
+ * - Flag NAMES are fine; flag VALUES are not.
+ * - When an event can fail, prefer `error_class` over `error_message` so we
+ *   don't leak user content or paths. `error_class` is typically the Error
+ *   constructor name (`errorClassName(err)`), but it may also be a stable
+ *   synthetic category tag at non-throw failure sites — for example,
+ *   `'WorkflowNotCompleted'` when a workflow returns `status !== 'completed'`
+ *   without throwing. Stick to PascalCase tags so real Error names and
+ *   synthetic categories share one namespace.
+ */
+export {};
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/cli/telemetry/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

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

@@ -0,0 +1,9 @@
+/**
+ * CLI telemetry internals - usage analytics (opt-out via env or CLI)
+ */
+export { initTelemetry, track, shutdown, isEnabled, getDistinctId, getStatus, type InitTelemetryOptions, } from './client.js';
+export { isTelemetryEnabled, enableTelemetry, disableTelemetry, wasNotified, markNotified, loadPrefs, savePrefs, getPrefsPath, isDisabledByEnv, type TelemetryPrefs, } from './config.js';
+export type { CommonProperties, ActionSource, TelemetryApp, TelemetrySurface, ReleaseReason, WorkflowFileType, BrokerStartEvent, BrokerStopEvent, BrokerStartFailedEvent, AgentSpawnEvent, AgentReleaseEvent, AgentCrashEvent, MessageSendEvent, CliCommandRunEvent, CliCommandCompleteEvent, WorkflowRunEvent, CloudAuthEvent, CloudWorkflowRunEvent, ProviderAuthEvent, SetupInitEvent, SwarmRunEvent, BridgeSpawnEvent, TelemetryEventName, TelemetryEventMap, } from './events.js';
+export { loadMachineId, createDistinctId, getMachineIdPath } from './machine-id.js';
+export { ORCHESTRATOR_HARNESS_ENV, UNKNOWN_ORCHESTRATOR_HARNESS, detectOrchestratorHarness, inferHarnessFromCommand, sanitizeOrchestratorHarness, type DetectOrchestratorHarnessOptions, type ProcessInfo, } from './orchestrator-harness.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/telemetry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,aAAa,EACb,KAAK,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,SAAS,EACT,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,gCAAgC,EACrC,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/cli/telemetry/index.js

@@ -0,0 +1,8 @@
+/**
+ * CLI telemetry internals - usage analytics (opt-out via env or CLI)
+ */
+export { initTelemetry, track, shutdown, isEnabled, getDistinctId, getStatus, } from './client.js';
+export { isTelemetryEnabled, enableTelemetry, disableTelemetry, wasNotified, markNotified, loadPrefs, savePrefs, getPrefsPath, isDisabledByEnv, } from './config.js';
+export { loadMachineId, createDistinctId, getMachineIdPath } from './machine-id.js';
+export { ORCHESTRATOR_HARNESS_ENV, UNKNOWN_ORCHESTRATOR_HARNESS, detectOrchestratorHarness, inferHarnessFromCommand, sanitizeOrchestratorHarness, } from './orchestrator-harness.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/telemetry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,aAAa,EACb,KAAK,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,SAAS,GAEV,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,eAAe,GAEhB,MAAM,aAAa,CAAC;AA6BrB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,GAG5B,MAAM,2BAA2B,CAAC"}

package/dist/cli/telemetry/machine-id.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Machine ID utilities for stable telemetry identity.
+ * Uses existing machine-id file at ~/.local/share/agentworkforce/relay/machine-id
+ */
+export declare function getMachineIdPath(): string;
+/**
+ * Load or generate machine ID using atomic file creation to avoid race conditions.
+ */
+export declare function loadMachineId(): string;
+/** SHA256 hash of machine ID, truncated to 16 chars */
+export declare function createDistinctId(): string;
+//# sourceMappingURL=machine-id.d.ts.map

package/dist/cli/telemetry/machine-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-id.d.ts","sourceRoot":"","sources":["../../../src/cli/telemetry/machine-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAsCtC;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC"}

package/dist/cli/telemetry/machine-id.js

@@ -0,0 +1,54 @@
+/**
+ * Machine ID utilities for stable telemetry identity.
+ * Uses existing machine-id file at ~/.local/share/agentworkforce/relay/machine-id
+ */
+import { createHash, randomBytes } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+export function getMachineIdPath() {
+    const dataDir = process.env.AGENT_RELAY_DATA_DIR || path.join(os.homedir(), '.local', 'share', 'agentworkforce', 'relay');
+    return path.join(dataDir, 'machine-id');
+}
+/**
+ * Load or generate machine ID using atomic file creation to avoid race conditions.
+ */
+export function loadMachineId() {
+    const machineIdPath = getMachineIdPath();
+    try {
+        return fs.readFileSync(machineIdPath, 'utf-8').trim();
+    }
+    catch (readErr) {
+        if (readErr.code !== 'ENOENT') {
+            return `${os.hostname()}-${Date.now().toString(36)}`;
+        }
+        try {
+            const dataDir = path.dirname(machineIdPath);
+            fs.mkdirSync(dataDir, { recursive: true });
+            const machineId = `${os.hostname()}-${randomBytes(8).toString('hex')}`;
+            // O_CREAT | O_EXCL fails if file exists - prevents race condition
+            const fd = fs.openSync(machineIdPath, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY, 0o600);
+            fs.writeSync(fd, machineId);
+            fs.closeSync(fd);
+            return machineId;
+        }
+        catch (writeErr) {
+            // Another process created the file first
+            if (writeErr.code === 'EEXIST') {
+                try {
+                    return fs.readFileSync(machineIdPath, 'utf-8').trim();
+                }
+                catch {
+                    // Fall through
+                }
+            }
+            return `${os.hostname()}-${Date.now().toString(36)}`;
+        }
+    }
+}
+/** SHA256 hash of machine ID, truncated to 16 chars */
+export function createDistinctId() {
+    const machineId = loadMachineId();
+    return createHash('sha256').update(machineId).digest('hex').substring(0, 16);
+}
+//# sourceMappingURL=machine-id.js.map

package/dist/cli/telemetry/machine-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-id.js","sourceRoot":"","sources":["../../../src/cli/telemetry/machine-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC5G,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,OAAgB,EAAE,CAAC;QAC1B,IAAK,OAAiC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzD,OAAO,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC5C,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3C,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAEvE,kEAAkE;YAClE,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CACpB,aAAa,EACb,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAClE,KAAK,CACN,CAAC;YACF,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC5B,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAEjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,QAAiB,EAAE,CAAC;YAC3B,yCAAyC;YACzC,IAAK,QAAkC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1D,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxD,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe;gBACjB,CAAC;YACH,CAAC;YACD,OAAO,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/cli/telemetry/orchestrator-harness.d.ts

@@ -0,0 +1,17 @@
+export declare const UNKNOWN_ORCHESTRATOR_HARNESS = "unknown";
+export declare const ORCHESTRATOR_HARNESS_ENV = "AGENT_RELAY_ORCHESTRATOR_HARNESS";
+export interface ProcessInfo {
+    pid: number;
+    ppid?: number;
+    command?: string;
+}
+export interface DetectOrchestratorHarnessOptions {
+    env?: NodeJS.ProcessEnv;
+    startPid?: number;
+    maxDepth?: number;
+    processLookup?: (pid: number) => ProcessInfo | undefined;
+}
+export declare function sanitizeOrchestratorHarness(raw: string | undefined): string | undefined;
+export declare function inferHarnessFromCommand(command: string | undefined): string | undefined;
+export declare function detectOrchestratorHarness(options?: DetectOrchestratorHarnessOptions): string;
+//# sourceMappingURL=orchestrator-harness.d.ts.map

package/dist/cli/telemetry/orchestrator-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-harness.d.ts","sourceRoot":"","sources":["../../../src/cli/telemetry/orchestrator-harness.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,4BAA4B,YAAY,CAAC;AACtD,eAAO,MAAM,wBAAwB,qCAAqC,CAAC;AAU3E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gCAAgC;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;CAC1D;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMvF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBvF;AA2BD,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,gCAAqC,GAAG,MAAM,CAyBhG"}

package/dist/cli/telemetry/orchestrator-harness.js

@@ -0,0 +1,106 @@
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+export const UNKNOWN_ORCHESTRATOR_HARNESS = 'unknown';
+export const ORCHESTRATOR_HARNESS_ENV = 'AGENT_RELAY_ORCHESTRATOR_HARNESS';
+const HARNESS_MAX_LENGTH = 120;
+const HARNESS_ALLOWED = /^[a-z0-9 ._\-/():=;,+]+$/i;
+const EXPLICIT_HARNESS_ENV_KEYS = [
+    ORCHESTRATOR_HARNESS_ENV,
+    'RELAYCAST_HARNESS',
+    'X_RELAYCAST_HARNESS',
+];
+export function sanitizeOrchestratorHarness(raw) {
+    if (!raw)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    if (!HARNESS_ALLOWED.test(trimmed))
+        return undefined;
+    return trimmed.slice(0, HARNESS_MAX_LENGTH).toLowerCase();
+}
+export function inferHarnessFromCommand(command) {
+    if (!command)
+        return undefined;
+    const lower = command.toLowerCase();
+    const normalized = lower.replace(/\\/g, '/');
+    const base = path.basename(normalized).replace(/\.(exe|cmd|bat)$/i, '');
+    if (base === 'claude' || lower.includes('claude-code'))
+        return 'claude-code';
+    if (base === 'codex' || normalized.includes('/codex'))
+        return 'codex';
+    if (base === 'cursor' || base === 'cursor-agent' || lower.includes('cursor'))
+        return 'cursor';
+    if (base === 'gemini' || base === 'gemini-cli' || lower.includes('gemini-cli'))
+        return 'gemini-cli';
+    if (base === 'aider' || lower.includes('aider'))
+        return 'aider';
+    if (base === 'opencode' || lower.includes('opencode'))
+        return 'opencode';
+    if (base === 'goose' || lower.includes('goose'))
+        return 'goose';
+    if (base === 'droid' || lower.includes('droid'))
+        return 'droid';
+    if (base === 'amp' || normalized.includes('/amp'))
+        return 'amp';
+    if (lower.includes('copilot'))
+        return 'github-copilot';
+    if (base === 'zed' || lower.includes('zed'))
+        return 'zed';
+    return undefined;
+}
+function lookupProcessInfo(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return undefined;
+    if (process.platform === 'win32')
+        return undefined;
+    try {
+        const result = spawnSync('ps', ['-o', 'ppid=', '-o', 'comm=', '-p', String(pid)], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 1000,
+        });
+        if (result.status !== 0)
+            return undefined;
+        const line = result.stdout.trim();
+        if (!line)
+            return undefined;
+        const match = line.match(/^(\d+)\s+(.+)$/);
+        if (!match)
+            return undefined;
+        return {
+            pid,
+            ppid: Number.parseInt(match[1], 10),
+            command: match[2].trim(),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function detectOrchestratorHarness(options = {}) {
+    const env = options.env ?? process.env;
+    for (const key of EXPLICIT_HARNESS_ENV_KEYS) {
+        const value = sanitizeOrchestratorHarness(env[key]);
+        if (value)
+            return value;
+    }
+    const lookup = options.processLookup ?? lookupProcessInfo;
+    let pid = options.startPid ?? process.ppid;
+    const maxDepth = Math.max(1, options.maxDepth ?? 8);
+    const seen = new Set();
+    for (let depth = 0; depth < maxDepth; depth += 1) {
+        if (!Number.isInteger(pid) || pid <= 0 || seen.has(pid))
+            break;
+        seen.add(pid);
+        const info = lookup(pid);
+        const harness = inferHarnessFromCommand(info?.command);
+        if (harness)
+            return harness;
+        if (!info?.ppid || info.ppid === pid)
+            break;
+        pid = info.ppid;
+    }
+    return UNKNOWN_ORCHESTRATOR_HARNESS;
+}
+//# sourceMappingURL=orchestrator-harness.js.map

package/dist/cli/telemetry/orchestrator-harness.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * PostHog configuration.
+ *
+ * Environment variables (read at runtime):
+ *   AGENT_RELAY_POSTHOG_KEY - PostHog write key. Set by published-artifact
+ *                              builds via GitHub Actions secret. When unset,
+ *                              telemetry runs as a no-op so forks, local dev,
+ *                              and CI test runs don't pollute the production
+ *                              project.
+ *   POSTHOG_API_KEY         - Per-process override (mainly for local
+ *                              debugging or staging). Wins over
+ *                              `AGENT_RELAY_POSTHOG_KEY` when set.
+ *   POSTHOG_HOST            - Override host URL. Defaults to the hosted
+ *                              Agent Relay ingestion proxy.
+ *
+ * Key selection order:
+ *   1. POSTHOG_API_KEY (process override, any environment)
+ *   2. AGENT_RELAY_POSTHOG_KEY (release-time injection)
+ *   3. None → returns `null` and `initTelemetry()` becomes a no-op.
+ */
+export declare function getPostHogConfig(): {
+    apiKey: string;
+    host: string;
+} | null;
+//# sourceMappingURL=posthog-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-config.d.ts","sourceRoot":"","sources":["../../../src/cli/telemetry/posthog-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAWH,wBAAgB,gBAAgB,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiB1E"}