dexto 1.1.4 → 1.1.6

package/dist/analytics/index.d.ts

@@ -0,0 +1,37 @@
+import { AnalyticsEventName, AnalyticsEventPayload, CliCommandEndEvent, CliCommandStartEvent } from './events.js';
+interface InitOptions {
+    appVersion: string;
+}
+/**
+ * Initialize the analytics client for the CLI.
+ *
+ * - Respects DEXTO_ANALYTICS_DISABLED.
+ * - Creates/loads the anonymous distinctId and a per-process session_id.
+ * - Emits a dexto_session_start event for each process run.
+ */
+export declare function initAnalytics(opts: InitOptions): Promise<void>;
+/**
+ * Capture a single analytics event with optional properties.
+ * Automatically enriches events with base context (app/os/node/session).
+ */
+export declare function capture<Name extends AnalyticsEventName>(event: Name, properties?: AnalyticsEventPayload<Name>): void;
+/**
+ * Attempt a graceful shutdown of the analytics client, flushing queued events.
+ */
+export declare function shutdownAnalytics(): Promise<void>;
+/**
+ * Mark the start of a command for timing and emit a lightweight start event.
+ * Adds local counters as a coarse diagnostic aid.
+ */
+export declare function onCommandStart(name: string, extra?: Partial<Omit<CliCommandStartEvent, 'name' | 'phase'>>): Promise<void>;
+/**
+ * Mark the end of a command and emit a completion event with success/failure
+ * and measured duration. Accepts optional extra properties.
+ */
+export declare function onCommandEnd(name: string, success: boolean, extra?: Partial<Omit<CliCommandEndEvent, 'name' | 'phase' | 'success' | 'durationMs'>>): Promise<void>;
+/**
+ * Whether analytics are currently enabled for this process.
+ */
+export declare function getEnabled(): boolean;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EAErB,kBAAkB,EAClB,oBAAoB,EACvB,MAAM,aAAa,CAAC;AAErB,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAqBD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCpE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,SAAS,kBAAkB,EACnD,KAAK,EAAE,IAAI,EACX,UAAU,GAAE,qBAAqB,CAAC,IAAI,CAAqC,GAC5E,IAAI,CAWN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAM,GAClE,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,CAAM,GAC3F,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}

package/dist/analytics/index.js

@@ -0,0 +1,145 @@
+// packages/cli/src/analytics/index.ts
+import { PostHog } from 'posthog-node';
+import os from 'os';
+import { isAnalyticsDisabled, DEFAULT_POSTHOG_HOST, DEFAULT_POSTHOG_KEY } from './constants.js';
+import { loadState, saveState } from './state.js';
+import { getExecutionContext } from '@dexto/core';
+import { randomUUID } from 'crypto';
+let client = null;
+let enabled = false;
+let state = null;
+let sessionId = null;
+let appVersion = null;
+function baseProps() {
+    return {
+        app: 'dexto',
+        app_version: appVersion || 'unknown',
+        node_version: process.version,
+        os_platform: os.platform(),
+        os_release: os.release(),
+        os_arch: os.arch(),
+        execution_context: getExecutionContext(),
+        session_id: sessionId,
+    };
+}
+/**
+ * Initialize the analytics client for the CLI.
+ *
+ * - Respects DEXTO_ANALYTICS_DISABLED.
+ * - Creates/loads the anonymous distinctId and a per-process session_id.
+ * - Emits a dexto_session_start event for each process run.
+ */
+export async function initAnalytics(opts) {
+    if (enabled || client)
+        return; // idempotent
+    if (isAnalyticsDisabled()) {
+        enabled = false;
+        return;
+    }
+    // Load or create state
+    state = await loadState();
+    sessionId = randomUUID();
+    appVersion = opts.appVersion;
+    const key = process.env.DEXTO_POSTHOG_KEY ?? DEFAULT_POSTHOG_KEY;
+    const host = process.env.DEXTO_POSTHOG_HOST ?? DEFAULT_POSTHOG_HOST;
+    if (typeof key !== 'string' || !/^phc_[A-Za-z0-9]+/.test(key) || !host) {
+        enabled = false;
+        return;
+    }
+    client = new PostHog(key, {
+        host,
+        flushAt: 1,
+        flushInterval: 0,
+        disableGeoip: false,
+    });
+    enabled = true;
+    process.on('exit', () => {
+        try {
+            client?.flush?.();
+        }
+        catch {
+            // Ignore flush errors: analytics should never block process exit.
+        }
+    });
+    capture('dexto_session_start', {});
+}
+/**
+ * Capture a single analytics event with optional properties.
+ * Automatically enriches events with base context (app/os/node/session).
+ */
+export function capture(event, properties = {}) {
+    if (!enabled || !client || !state)
+        return;
+    try {
+        client.capture({
+            distinctId: state.distinctId,
+            event,
+            properties: { ...baseProps(), ...properties },
+        });
+    }
+    catch {
+        // swallow
+    }
+}
+/**
+ * Attempt a graceful shutdown of the analytics client, flushing queued events.
+ */
+export async function shutdownAnalytics() {
+    if (client) {
+        try {
+            await client.shutdown();
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+const timers = new Map();
+/**
+ * Mark the start of a command for timing and emit a lightweight start event.
+ * Adds local counters as a coarse diagnostic aid.
+ */
+export async function onCommandStart(name, extra = {}) {
+    if (!enabled)
+        return;
+    timers.set(name, Date.now());
+    if (state) {
+        await saveState(state);
+    }
+    const payload = {
+        name,
+        phase: 'start',
+        ...extra,
+    };
+    capture('dexto_cli_command', payload);
+}
+/**
+ * Mark the end of a command and emit a completion event with success/failure
+ * and measured duration. Accepts optional extra properties.
+ */
+export async function onCommandEnd(name, success, extra = {}) {
+    if (!enabled)
+        return;
+    const start = timers.get(name) ?? Date.now();
+    const durationMs = Date.now() - start;
+    timers.delete(name);
+    const payload = {
+        name,
+        phase: 'end',
+        success,
+        durationMs,
+        ...extra,
+    };
+    capture('dexto_cli_command', payload);
+    if (state) {
+        state.commandRunCounts = state.commandRunCounts || {};
+        state.commandRunCounts[name] = (state.commandRunCounts[name] || 0) + 1;
+        await saveState(state);
+    }
+}
+/**
+ * Whether analytics are currently enabled for this process.
+ */
+export function getEnabled() {
+    return enabled;
+}

package/dist/analytics/state.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shape of the persisted analytics state written to
+ * ~/.dexto/telemetry/state.json.
+ *
+ * - distinctId: Anonymous ID (UUID) for grouping events by machine.
+ * - createdAt: ISO timestamp when the state was first created.
+ * - commandRunCounts: Local counters per command for coarse diagnostics.
+ */
+export interface AnalyticsState {
+    distinctId: string;
+    createdAt: string;
+    commandRunCounts?: Record<string, number>;
+}
+/**
+ * Load the persisted analytics state, creating a new file if missing.
+ * Returns a valid state object with defaults populated.
+ */
+export declare function loadState(): Promise<AnalyticsState>;
+/**
+ * Persist the analytics state to ~/.dexto/telemetry/state.json.
+ */
+export declare function saveState(state: AnalyticsState): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/analytics/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/analytics/state.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAKD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAqBzD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE"}

package/dist/analytics/state.js

@@ -0,0 +1,74 @@
+// packages/cli/src/analytics/state.ts
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import os from 'os';
+import { randomUUID, createHash } from 'crypto';
+import { createRequire } from 'module';
+const requireCJS = createRequire(import.meta.url);
+// node-machine-id is CommonJS; import via createRequire to avoid ESM interop issues
+const { machineIdSync } = requireCJS('node-machine-id');
+import { getDextoGlobalPath } from '@dexto/core';
+const STATE_DIR = getDextoGlobalPath('telemetry');
+const STATE_FILE = path.join(STATE_DIR, 'state.json');
+/**
+ * Load the persisted analytics state, creating a new file if missing.
+ * Returns a valid state object with defaults populated.
+ */
+export async function loadState() {
+    try {
+        const content = await fs.readFile(STATE_FILE, 'utf8');
+        const parsed = JSON.parse(content);
+        // Validate minimal shape
+        if (!parsed.distinctId)
+            throw new Error('invalid state');
+        return {
+            distinctId: parsed.distinctId,
+            createdAt: parsed.createdAt || new Date().toISOString(),
+            commandRunCounts: parsed.commandRunCounts ?? {},
+        };
+    }
+    catch {
+        await fs.mkdir(STATE_DIR, { recursive: true });
+        const state = {
+            distinctId: computeDistinctId(),
+            createdAt: new Date().toISOString(),
+            commandRunCounts: {},
+        };
+        await saveState(state);
+        return state;
+    }
+}
+/**
+ * Persist the analytics state to ~/.dexto/telemetry/state.json.
+ */
+export async function saveState(state) {
+    await fs.mkdir(STATE_DIR, { recursive: true });
+    await fs.writeFile(STATE_FILE, JSON.stringify(state, null, 2), 'utf8');
+}
+/**
+ * Compute a stable, privacy‑safe machine identifier so identity
+ * survives ~/.dexto deletion by default.
+ *
+ * Strategy:
+ * - Prefer node-machine-id (hashed), which abstracts platform differences.
+ * - Fallback to a salted/hashed hostname.
+ * - As a last resort, generate a random UUID.
+ */
+function computeDistinctId() {
+    try {
+        // machineIdSync(true) returns a hashed, stable identifier
+        const id = machineIdSync(true);
+        if (typeof id === 'string' && id.length > 0)
+            return `DEXTO-${id}`;
+    }
+    catch {
+        // fall through to hostname hash
+    }
+    // Fallback: hash hostname to avoid exposing raw value
+    const hostname = os.hostname() || 'unknown-host';
+    const digest = createHash('sha256').update(hostname).digest('hex');
+    if (digest)
+        return `DEXTO-${digest.slice(0, 32)}`;
+    // Last resort
+    return `DEXTO-${randomUUID()}`;
+}

package/dist/analytics/wrapper.d.ts

@@ -0,0 +1,11 @@
+export declare function withAnalytics<A extends unknown[], R = unknown>(commandName: string, handler: (...args: A) => Promise<R> | R, opts?: {
+    timeoutMs?: number;
+}): (...args: A) => Promise<R>;
+export declare class ExitSignal extends Error {
+    code: number;
+    reason?: string | undefined;
+    commandName?: string | undefined;
+    constructor(code?: number, reason?: string, commandName?: string);
+}
+export declare function safeExit(commandName: string, code?: number, reason?: string): never;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/analytics/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/analytics/wrapper.ts"],"names":[],"mappings":"AAkDA,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,EAC1D,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACvC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CA+D5B;AAED,qBAAa,UAAW,SAAQ,KAAK;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBACrB,IAAI,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAOtE;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAEtF"}

package/dist/analytics/wrapper.js

@@ -0,0 +1,125 @@
+// packages/cli/src/analytics/wrapper.ts
+import { onCommandStart, onCommandEnd, capture } from './index.js';
+import { COMMAND_TIMEOUT_MS } from './constants.js';
+function sanitizeOptions(obj) {
+    const redactedKeys = /key|token|secret|password|api[_-]?key|authorization|auth/i;
+    const truncate = (s, max = 256) => (s.length > max ? s.slice(0, max) + '…' : s);
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (typeof v === 'string') {
+            out[k] = redactedKeys.test(k) ? '[REDACTED]' : truncate(v);
+        }
+        else if (Array.isArray(v)) {
+            out[k] = { type: 'array', length: v.length };
+        }
+        else if (typeof v === 'number' || typeof v === 'boolean' || v === null) {
+            out[k] = v;
+        }
+        else if (typeof v === 'object' && v) {
+            out[k] = { type: 'object' };
+        }
+        else {
+            out[k] = String(v ?? 'unknown');
+        }
+    }
+    return out;
+}
+function buildArgsPayload(args) {
+    const meta = {
+        argTypes: args.map((a) => (Array.isArray(a) ? 'array' : typeof a)),
+    };
+    if (args.length > 0 && Array.isArray(args[0])) {
+        const list = args[0].map((x) => String(x));
+        const trimmed = list.map((s) => (s.length > 512 ? s.slice(0, 512) + '…' : s)).slice(0, 10);
+        meta.positionalRaw = trimmed;
+        meta.positionalCount = list.length;
+    }
+    const last = args[args.length - 1];
+    if (last && typeof last === 'object' && !Array.isArray(last)) {
+        meta.optionKeys = Object.keys(last);
+        meta.options = sanitizeOptions(last);
+    }
+    return meta;
+}
+export function withAnalytics(commandName, handler, opts) {
+    const timeoutMs = opts?.timeoutMs ?? COMMAND_TIMEOUT_MS;
+    return async (...args) => {
+        const argsMeta = buildArgsPayload(args);
+        await onCommandStart(commandName, { args: argsMeta });
+        const timeout = timeoutMs > 0
+            ? (() => {
+                const t = setTimeout(() => {
+                    try {
+                        const payload = {
+                            name: commandName,
+                            phase: 'timeout',
+                            timeoutMs,
+                            args: argsMeta,
+                        };
+                        capture('dexto_cli_command', payload);
+                    }
+                    catch {
+                        // Timeout instrumentation is best-effort.
+                    }
+                }, timeoutMs);
+                // Prevent timeout from keeping process alive
+                t.unref();
+                return t;
+            })()
+            : null;
+        try {
+            const result = await handler(...args);
+            const success = (typeof process.exitCode === 'number' ? process.exitCode : 0) === 0;
+            await onCommandEnd(commandName, success, { args: argsMeta });
+            return result;
+        }
+        catch (err) {
+            if (err instanceof ExitSignal) {
+                process.exitCode = err.code ?? 0;
+                try {
+                    const endMeta = { args: argsMeta };
+                    if (typeof err.reason === 'string') {
+                        endMeta.reason = err.reason;
+                    }
+                    if (err.commandName) {
+                        endMeta.command = err.commandName;
+                    }
+                    await onCommandEnd(commandName, err.code === 0, endMeta);
+                }
+                catch {
+                    // Ignore analytics errors when propagating ExitSignal.
+                }
+                return undefined;
+            }
+            try {
+                await onCommandEnd(commandName, false, {
+                    error: err instanceof Error ? err.message : String(err),
+                    args: argsMeta,
+                });
+            }
+            catch {
+                // Ignore analytics errors when recording failures.
+            }
+            throw err;
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+        }
+    };
+}
+export class ExitSignal extends Error {
+    code;
+    reason;
+    commandName;
+    constructor(code = 0, reason, commandName) {
+        super('ExitSignal');
+        this.name = 'ExitSignal';
+        this.code = code;
+        this.reason = reason;
+        this.commandName = commandName;
+    }
+}
+export function safeExit(commandName, code = 0, reason) {
+    throw new ExitSignal(code, reason, commandName);
+}

package/dist/cli/cli.d.ts

@@ -1,4 +1,9 @@
 import { DextoAgent } from '@dexto/core';
+/**
+ * Find and load the most recent session based on lastActivity.
+ * This provides better UX than always loading the "default" session.
+ */
+export declare function loadMostRecentSession(agent: DextoAgent): Promise<void>;
 /**
  * Run the AI CLI with the given LLM service
  * @param agent Dexto agent instance

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

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA6HzC;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,iBAkHjD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCvF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC5E;AAgFD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,iBAoHjD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CvF"}

package/dist/cli/cli.js

@@ -7,11 +7,13 @@ import { executeCommand } from './commands/interactive-commands/commands.js';
 import { getDextoPath } from '@dexto/core';
 import { registerGracefulShutdown } from '../utils/graceful-shutdown.js';
 import { DextoRuntimeError, DextoValidationError, ErrorScope, LLMErrorCode } from '@dexto/core';
+import { capture } from '../analytics/index.js';
+import { safeExit } from '../analytics/wrapper.js';
 /**
  * Find and load the most recent session based on lastActivity.
  * This provides better UX than always loading the "default" session.
  */
-async function loadMostRecentSession(agent) {
+export async function loadMostRecentSession(agent) {
     try {
         const sessionIds = await agent.listSessions();
         if (sessionIds.length === 0) {
@@ -46,7 +48,7 @@ async function loadMostRecentSession(agent) {
  * @param agent The DextoAgent instance providing access to all required services
  */
 async function _initCli(agent) {
-    await loadMostRecentSession(agent);
+    // Note: Session loading is now handled by the main CLI logic, not here
     registerGracefulShutdown(agent);
     // Gather startup information
     const llmConfig = agent.getCurrentLLMConfig();
@@ -147,6 +149,8 @@ export async function startAiCli(agent) {
             }
             else {
                 // Handle regular prompt - pass to AI
+                const llm = agent.getCurrentLLMConfig();
+                capture('dexto_prompt', { mode: 'cli', provider: llm.provider, model: llm.model });
                 return false;
             }
         }
@@ -211,7 +215,7 @@ export async function startAiCli(agent) {
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : 'Unknown error';
         logger.error(`Error during CLI initialization: ${errorMessage}`);
-        process.exit(1); // Exit with error code if CLI setup fails
+        safeExit('main', 1); // Exit with error code if CLI setup fails
     }
 }
 /**
@@ -237,6 +241,8 @@ export async function startHeadlessCli(agent, prompt) {
             // Execute the task as a regular AI prompt
             // uncomment if we need to reset conversation for headless mode
             // await agent.resetConversation();
+            const llm = agent.getCurrentLLMConfig();
+            capture('dexto_prompt', { mode: 'headless', provider: llm.provider, model: llm.model });
             await agent.run(prompt);
         }
     }
@@ -256,6 +262,6 @@ export async function startHeadlessCli(agent, prompt) {
         else {
             logger.error(`Error in processing input: ${error instanceof Error ? error.message : String(error)}`);
         }
-        process.exit(1); // Exit with error code if headless execution fails
+        safeExit('main', 1); // Exit with error code if headless execution fails
     }
 }

package/dist/cli/commands/{interactive-commands/session/helpers → helpers}/formatters.d.ts

@@ -2,7 +2,7 @@
  * Session Formatting Utilities
  *
  * This module contains formatting functions for session-related CLI output.
- * Extracted from commands.ts as part of CLI refactoring to improve code organization.
+ * Shared between interactive and non-interactive session commands.
  */
 import type { SessionMetadata, InternalMessage } from '@dexto/core';
 /**

package/dist/cli/commands/helpers/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/helpers/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,EAC1B,SAAS,GAAE,OAAe,GAC3B,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8DpF"}

package/dist/cli/commands/{interactive-commands/session/helpers → helpers}/formatters.js

@@ -2,7 +2,7 @@
  * Session Formatting Utilities
  *
  * This module contains formatting functions for session-related CLI output.
- * Extracted from commands.ts as part of CLI refactoring to improve code organization.
+ * Shared between interactive and non-interactive session commands.
  */
 import chalk from 'chalk';
 /**

package/dist/cli/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;EAOb,CAAC;AAEd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAuC1E,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAoEf"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;EAOb,CAAC;AAEd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAwC1E,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAsHf"}

package/dist/cli/commands/install.js

@@ -3,6 +3,7 @@ import { existsSync } from 'fs';
 import path from 'path';
 import { z } from 'zod';
 import { getAgentRegistry, getDextoGlobalPath } from '@dexto/core';
+import { capture } from '../../analytics/index.js';
 // Zod schema for install command validation
 const InstallCommandSchema = z
     .object({
@@ -37,6 +38,7 @@ function validateInstallCommand(agents, options) {
     }
     return validated;
 }
+// TODO: move registry code into CLI and move dexto_install_agent metric into registry
 export async function handleInstallCommand(agents, options) {
     // Validate command with Zod
     const validated = validateInstallCommand(agents, options);
@@ -54,6 +56,9 @@ export async function handleInstallCommand(agents, options) {
     let successCount = 0;
     let errorCount = 0;
     const errors = [];
+    const installed = [];
+    const skipped = [];
+    const failed = [];
     // Install each agent
     for (const agentName of agentsToInstall) {
         try {
@@ -63,21 +68,70 @@ export async function handleInstallCommand(agents, options) {
             const installedPath = path.join(globalAgentsDir, agentName);
             if (existsSync(installedPath) && !validated.force) {
                 console.log(`⏭️  ${agentName} already installed (use --force to reinstall)`);
-                successCount++;
+                skipped.push(agentName);
+                // Per-agent analytics for skipped install
+                capture('dexto_install_agent', {
+                    agent: agentName,
+                    status: 'skipped',
+                    reason: 'already_installed',
+                    force: validated.force,
+                    injectPreferences: validated.injectPreferences,
+                });
                 continue;
             }
             await registry.installAgent(agentName, validated.injectPreferences);
             successCount++;
             console.log(`✅ ${agentName} installed successfully`);
+            installed.push(agentName);
+            // Per-agent analytics for successful install
+            try {
+                capture('dexto_install_agent', {
+                    agent: agentName,
+                    status: 'installed',
+                    force: validated.force,
+                    injectPreferences: validated.injectPreferences,
+                });
+            }
+            catch {
+                // Analytics failures should not block CLI execution.
+            }
         }
         catch (error) {
             errorCount++;
             const errorMsg = `Failed to install ${agentName}: ${error instanceof Error ? error.message : String(error)}`;
             errors.push(errorMsg);
+            failed.push(agentName);
             console.error(`❌ ${errorMsg}`);
+            // Per-agent analytics for failed install
+            try {
+                capture('dexto_install_agent', {
+                    agent: agentName,
+                    status: 'failed',
+                    error_message: error instanceof Error ? error.message : String(error),
+                    force: validated.force,
+                    injectPreferences: validated.injectPreferences,
+                });
+            }
+            catch {
+                // Analytics failures should not block CLI execution.
+            }
         }
     }
-    // For single agent operations, throw error if it failed
+    // Emit analytics for both single- and multi-agent cases
+    try {
+        capture('dexto_install', {
+            requested: agentsToInstall,
+            installed,
+            skipped,
+            failed,
+            successCount,
+            errorCount,
+        });
+    }
+    catch {
+        // Analytics failures should not block CLI execution.
+    }
+    // For single agent operations, throw error if it failed (after emitting analytics)
     if (agentsToInstall.length === 1) {
         if (errorCount > 0) {
             throw new Error(errors[0]);

package/dist/cli/commands/interactive-commands/session/index.d.ts

@@ -12,6 +12,6 @@
  * - Formatter utilities from helpers (re-exported for convenience)
  */
 export { sessionCommand, historyCommand, searchCommand } from './session-commands.js';
-export { formatSessionInfo, formatHistoryMessage } from './helpers/formatters.js';
+export { formatSessionInfo, formatHistoryMessage } from '../../helpers/formatters.js';
 export declare const sessionCommands: import("../command-parser.js").CommandDefinition[];
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/interactive-commands/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIlF,eAAO,MAAM,eAAe,oDAAkD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAItF,eAAO,MAAM,eAAe,oDAAkD,CAAC"}

package/dist/cli/commands/interactive-commands/session/index.js

@@ -12,7 +12,7 @@
  * - Formatter utilities from helpers (re-exported for convenience)
  */
 export { sessionCommand, historyCommand, searchCommand } from './session-commands.js';
-export { formatSessionInfo, formatHistoryMessage } from './helpers/formatters.js';
+export { formatSessionInfo, formatHistoryMessage } from '../../helpers/formatters.js';
 // Export all session commands as a convenient array
 import { sessionCommand, historyCommand, searchCommand } from './session-commands.js';
 export const sessionCommands = [sessionCommand, historyCommand, searchCommand];

package/dist/cli/commands/interactive-commands/session/session-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-commands.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/session/session-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAsCzD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,iBAgQ5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,iBAwB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,iBA+H3B,CAAC"}
+{"version":3,"file":"session-commands.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/session/session-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAwCzD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,iBA0L5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,iBAwB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,iBA+H3B,CAAC"}