@vybestack/llxprt-code-telemetry 0.10.0-nightly.260613.1adad3b34

package/dist/src/debug/FileOutput.d.ts

@@ -0,0 +1,28 @@
+import type { LogEntry } from './types.js';
+export declare class FileOutput {
+    private static instance;
+    private debugDir;
+    private currentLogFile;
+    private writeQueue;
+    private isWriting;
+    private disposed;
+    private flushTimeout;
+    private maxFileSize;
+    private maxQueueSize;
+    private batchSize;
+    private flushInterval;
+    private debugRunId;
+    private constructor();
+    get runId(): string;
+    static getInstance(): FileOutput;
+    static disposeInstance(): Promise<void>;
+    write(entry: LogEntry): Promise<void>;
+    dispose(): Promise<void>;
+    static resetForTesting(): Promise<void>;
+    private startFlushTimer;
+    private flushQueue;
+    private waitForWriteTurn;
+    private ensureDirectoryExists;
+    private checkFileRotation;
+    private generateLogFileName;
+}

package/dist/src/debug/FileOutput.js

@@ -0,0 +1,190 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P10
+ * @requirement REQ-005
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { LLXPRT_DIR } from '../utils/paths.js';
+const LOG_FILE_DATE_LENGTH = 10;
+export class FileOutput {
+    static instance;
+    debugDir;
+    currentLogFile;
+    writeQueue = [];
+    isWriting = false;
+    disposed = false;
+    flushTimeout = null;
+    maxFileSize = 10 * 1024 * 1024; // 10MB
+    maxQueueSize = 1000;
+    batchSize = 50;
+    flushInterval = 1000; // 1 second
+    debugRunId;
+    constructor() {
+        const home = homedir();
+        // Handle test environments where homedir might not be available
+        this.debugDir = home
+            ? join(home, LLXPRT_DIR, 'debug')
+            : join(process.cwd(), LLXPRT_DIR, 'debug');
+        /* eslint-disable @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: env vars may be empty strings, fall through to pid */
+        this.debugRunId =
+            process.env.LLXPRT_DEBUG_RUN_ID ||
+                process.env.LLXPRT_DEBUG_SESSION_ID ||
+                String(process.pid);
+        /* eslint-enable @typescript-eslint/prefer-nullish-coalescing */
+        this.currentLogFile = this.generateLogFileName();
+    }
+    get runId() {
+        return this.debugRunId;
+    }
+    static getInstance() {
+        FileOutput.instance ??= new FileOutput();
+        return FileOutput.instance;
+    }
+    static async disposeInstance() {
+        if (FileOutput.instance) {
+            await FileOutput.instance.dispose();
+        }
+    }
+    async write(entry) {
+        if (this.disposed) {
+            return;
+        }
+        if (!this.flushTimeout) {
+            this.startFlushTimer();
+        }
+        // Add to queue
+        this.writeQueue.push({
+            entry,
+            timestamp: Date.now(),
+        });
+        // Prevent queue from growing too large
+        if (this.writeQueue.length > this.maxQueueSize) {
+            this.writeQueue = this.writeQueue.slice(-this.maxQueueSize);
+        }
+        // Flush immediately if queue is large or not currently writing
+        if (this.writeQueue.length >= this.batchSize || !this.isWriting) {
+            await this.flushQueue();
+        }
+    }
+    async dispose() {
+        this.disposed = true;
+        if (this.flushTimeout) {
+            clearTimeout(this.flushTimeout);
+            this.flushTimeout = null;
+        }
+        while (this.isWriting) {
+            await this.waitForWriteTurn();
+        }
+        let previousQueueLength = Number.POSITIVE_INFINITY;
+        while (this.writeQueue.length > 0 &&
+            this.writeQueue.length < previousQueueLength) {
+            previousQueueLength = this.writeQueue.length;
+            await this.flushQueue({ allowDisposed: true });
+        }
+        if (FileOutput.instance === this) {
+            FileOutput.instance = undefined;
+        }
+    }
+    static async resetForTesting() {
+        const instance = FileOutput.instance;
+        FileOutput.instance = undefined;
+        if (instance) {
+            await instance.dispose();
+        }
+    }
+    startFlushTimer() {
+        if (this.disposed) {
+            return;
+        }
+        if (this.flushTimeout) {
+            return;
+        }
+        this.flushTimeout = setTimeout(() => {
+            void (async () => {
+                await this.flushQueue();
+                this.flushTimeout = null;
+                if (this.writeQueue.length > 0) {
+                    this.startFlushTimer();
+                }
+            })();
+        }, this.flushInterval);
+    }
+    async flushQueue(options = {}) {
+        if (this.isWriting ||
+            this.writeQueue.length === 0 ||
+            (this.disposed === true && options.allowDisposed !== true)) {
+            return;
+        }
+        this.isWriting = true;
+        let entriesToWrite = [];
+        try {
+            await this.ensureDirectoryExists();
+            await this.checkFileRotation();
+            // Process entries in batches
+            entriesToWrite = this.writeQueue.splice(0, this.batchSize);
+            if (entriesToWrite.length === 0) {
+                return;
+            }
+            // Convert to JSONL format
+            const jsonlData = entriesToWrite.map(({ entry }) => JSON.stringify(entry)).join('\n') +
+                '\n';
+            // Write to file with proper permissions
+            await fs.appendFile(this.currentLogFile, jsonlData, {
+                encoding: 'utf8',
+                mode: 0o600,
+            });
+        }
+        catch (error) {
+            // Gracefully handle errors - don't crash the application
+            console.error('FileOutput: Failed to write log entries:', error);
+            // Put entries back in queue for retry (but limit retries)
+            if (this.writeQueue.length < this.maxQueueSize / 2) {
+                this.writeQueue.unshift(...entriesToWrite);
+            }
+        }
+        finally {
+            this.isWriting = false;
+        }
+    }
+    async waitForWriteTurn() {
+        await new Promise((resolve) => setImmediate(resolve));
+    }
+    async ensureDirectoryExists() {
+        try {
+            await fs.access(this.debugDir);
+        }
+        catch {
+            await fs.mkdir(this.debugDir, {
+                recursive: true,
+                mode: 0o700,
+            });
+        }
+    }
+    async checkFileRotation() {
+        try {
+            const stats = await fs.stat(this.currentLogFile);
+            // Rotate by size
+            if (stats.size >= this.maxFileSize) {
+                this.currentLogFile = this.generateLogFileName();
+                return;
+            }
+            // Rotate by date (daily rotation)
+            const fileDate = new Date(stats.birthtime);
+            const today = new Date();
+            if (fileDate.toDateString() !== today.toDateString()) {
+                this.currentLogFile = this.generateLogFileName();
+            }
+        }
+        catch {
+            // File doesn't exist yet, that's fine
+        }
+    }
+    generateLogFileName() {
+        const now = new Date();
+        const datePart = now.toISOString().slice(0, LOG_FILE_DATE_LENGTH);
+        const timePart = now.toTimeString().slice(0, 8).replace(/:/g, '-');
+        return join(this.debugDir, `llxprt-debug-${this.debugRunId}-${datePart}-${timePart}.jsonl`);
+    }
+}
+//# sourceMappingURL=FileOutput.js.map

package/dist/src/debug/FileOutput.js.map

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

package/dist/src/debug/MockConfigurationManager.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P05
+ * @requirement REQ-001,REQ-002
+ * Mock implementation for DebugLogger testing
+ */
+export interface DebugSettings {
+    enabled: boolean;
+    namespaces: string[];
+    level?: string;
+    output?: {
+        target: string;
+        directory?: string;
+    };
+    redactPatterns?: string[];
+}
+export declare class MockConfigurationManager {
+    private static instance;
+    private config;
+    private listeners;
+    static getInstance(): MockConfigurationManager;
+    setEphemeralConfig(config: Partial<DebugSettings>): void;
+    getEffectiveConfig(): DebugSettings;
+    getOutputTarget(): string;
+    getRedactPatterns(): string[];
+    subscribe(listener: () => void): void;
+    unsubscribe(listener: () => void): void;
+    private notifyListeners;
+}

package/dist/src/debug/MockConfigurationManager.js

@@ -0,0 +1,45 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P05
+ * @requirement REQ-001,REQ-002
+ * Mock implementation for DebugLogger testing
+ */
+export class MockConfigurationManager {
+    static instance;
+    config = {
+        enabled: true,
+        namespaces: ['*'],
+        level: 'debug',
+        output: { target: 'file stderr', directory: '~/.llxprt/debug' },
+        redactPatterns: ['apiKey', 'token', 'password'],
+    };
+    listeners = new Set();
+    static getInstance() {
+        MockConfigurationManager.instance ??= new MockConfigurationManager();
+        return MockConfigurationManager.instance;
+    }
+    setEphemeralConfig(config) {
+        this.config = { ...this.config, ...config };
+        this.notifyListeners();
+    }
+    getEffectiveConfig() {
+        return this.config;
+    }
+    getOutputTarget() {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string target should fall back to default
+        return this.config.output?.target || 'file stderr';
+    }
+    getRedactPatterns() {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty array vs undefined - treating undefined as no patterns
+        return this.config.redactPatterns || [];
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+    }
+    unsubscribe(listener) {
+        this.listeners.delete(listener);
+    }
+    notifyListeners() {
+        this.listeners.forEach((listener) => listener());
+    }
+}
+//# sourceMappingURL=MockConfigurationManager.js.map

package/dist/src/debug/MockConfigurationManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockConfigurationManager.js","sourceRoot":"","sources":["../../../src/debug/MockConfigurationManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,MAAM,OAAO,wBAAwB;IAC3B,MAAM,CAAC,QAAQ,CAAuC;IACtD,MAAM,GAAkB;QAC9B,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,CAAC,GAAG,CAAC;QACjB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE;QAC/D,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC;KAChD,CAAC;IACM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAE1C,MAAM,CAAC,WAAW;QAChB,wBAAwB,CAAC,QAAQ,KAAK,IAAI,wBAAwB,EAAE,CAAC;QACrE,OAAO,wBAAwB,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED,kBAAkB,CAAC,MAA8B;QAC/C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAC5C,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,yJAAyJ;QACzJ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,aAAa,CAAC;IACrD,CAAC;IAED,iBAAiB;QACf,sKAAsK;QACtK,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,SAAS,CAAC,QAAoB;QAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,QAAoB;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/src/debug/MockFileOutput.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P05
+ * @requirement REQ-001
+ * Mock implementation for DebugLogger testing
+ */
+export interface LogEntry {
+    timestamp: string;
+    namespace: string;
+    level: string;
+    message: string;
+    args?: unknown[];
+    runId: string;
+    pid: number;
+}
+export declare class MockFileOutput {
+    private static instance;
+    private entries;
+    static getInstance(): MockFileOutput;
+    write(entry: LogEntry): void;
+    getEntries(): LogEntry[];
+    clear(): void;
+}

package/dist/src/debug/MockFileOutput.js

@@ -0,0 +1,23 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P05
+ * @requirement REQ-001
+ * Mock implementation for DebugLogger testing
+ */
+export class MockFileOutput {
+    static instance;
+    entries = [];
+    static getInstance() {
+        MockFileOutput.instance ??= new MockFileOutput();
+        return MockFileOutput.instance;
+    }
+    write(entry) {
+        this.entries.push(entry);
+    }
+    getEntries() {
+        return [...this.entries];
+    }
+    clear() {
+        this.entries = [];
+    }
+}
+//# sourceMappingURL=MockFileOutput.js.map

package/dist/src/debug/MockFileOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockFileOutput.js","sourceRoot":"","sources":["../../../src/debug/MockFileOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,QAAQ,CAA6B;IAC5C,OAAO,GAAe,EAAE,CAAC;IAEjC,MAAM,CAAC,WAAW;QAChB,cAAc,CAAC,QAAQ,KAAK,IAAI,cAAc,EAAE,CAAC;QACjD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAe;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/src/debug/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P03
+ * @requirement REQ-001
+ */
+export * from './types.js';
+export * from './DebugLogger.js';
+export * from './ConfigurationManager.js';
+export * from './FileOutput.js';
+export { MockConfigurationManager } from './MockConfigurationManager.js';
+export { MockFileOutput } from './MockFileOutput.js';

package/dist/src/debug/index.js

@@ -0,0 +1,11 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P03
+ * @requirement REQ-001
+ */
+export * from './types.js';
+export * from './DebugLogger.js';
+export * from './ConfigurationManager.js';
+export * from './FileOutput.js';
+export { MockConfigurationManager } from './MockConfigurationManager.js';
+export { MockFileOutput } from './MockFileOutput.js';
+//# sourceMappingURL=index.js.map

package/dist/src/debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/debug/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/debug/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @plan PLAN-20250120-DEBUGLOGGING.P03
+ * @requirement REQ-001
+ */
+export interface DebugOutputConfig {
+    target: string;
+    directory?: string;
+}
+export interface DebugSettings {
+    enabled: boolean;
+    namespaces: string[] | Record<string, unknown>;
+    level: string;
+    output: DebugOutputConfig | string;
+    lazyEvaluation: boolean;
+    redactPatterns: string[];
+}
+export interface LogEntry {
+    timestamp: string;
+    namespace: string;
+    level: string;
+    message: string;
+    args?: unknown[];
+    runId: string;
+    pid: number;
+}

package/dist/src/debug/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/debug/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/debug/types.ts"],"names":[],"mappings":""}

package/dist/src/internal/interfaces.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Structural interfaces owned by the telemetry package to avoid
+ * circular dependencies on core. Core's Config structurally satisfies
+ * TelemetryConfig; consumers may also implement TelemetryConfig directly.
+ */
+/**
+ * Minimal config for session-scoped telemetry. Only `getSessionId` is required.
+ */
+export interface SessionConfig {
+    getSessionId(): string;
+}
+/**
+ * Config needed for functions that conditionally log prompts.
+ */
+export interface TelemetryPromptConfig extends SessionConfig {
+    getTelemetryLogPromptsEnabled(): boolean;
+}
+/**
+ * Config for tool-call telemetry (session id + prompt logging).
+ */
+export interface ToolLoggingConfig extends SessionConfig {
+    getTelemetryLogPromptsEnabled(): boolean;
+}
+/**
+ * Full telemetry config. Core's `Config` satisfies this interface structurally.
+ * Adding new methods here is safe as long as the implementing class provides them.
+ */
+export interface TelemetryConfig extends SessionConfig {
+    getTelemetryEnabled(): boolean;
+    getTelemetryLogPromptsEnabled(): boolean;
+    getTelemetryOutfile(): string | undefined;
+    getTelemetryTarget(): string;
+    getTelemetryOtlpEndpoint(): string;
+    getDebugMode(): boolean;
+    getConversationLoggingEnabled(): boolean;
+    getSessionId(): string;
+    getModel(): string;
+    getEmbeddingModel(): string | undefined;
+    getSandbox(): unknown;
+    getCoreTools(): string[] | undefined;
+    getApprovalMode(): string;
+    getContentGeneratorConfig(): ContentGeneratorConfig | undefined;
+    getFileFilteringRespectGitIgnore(): boolean;
+    getMcpServers(): Record<string, unknown> | undefined;
+}
+/**
+ * Subset of content generator config used by StartSessionEvent.
+ */
+export interface ContentGeneratorConfig {
+    model?: string;
+    apiKey?: string;
+    vertexai?: boolean;
+}
+export interface DiffStat {
+    ai_added_lines: number;
+    ai_removed_lines: number;
+    user_added_lines: number;
+    user_removed_lines: number;
+}
+export declare enum ToolConfirmationOutcome {
+    ProceedOnce = "proceed_once",
+    ProceedAlways = "proceed_always",
+    ProceedAlwaysAndSave = "proceed_always_and_save",
+    ProceedAlwaysServer = "proceed_always_server",
+    ProceedAlwaysTool = "proceed_always_tool",
+    ModifyWithEditor = "modify_with_editor",
+    SuggestEdit = "suggest_edit",
+    Cancel = "cancel"
+}
+export interface ToolCallRequest {
+    name: string;
+    args: Record<string, unknown>;
+    callId: string;
+    isClientInitiated: boolean;
+    prompt_id: string;
+    agentId?: string;
+}
+export interface ToolCallError {
+    name?: string;
+    message?: string;
+}
+export interface ToolCallResponse {
+    callId: string;
+    responseParts?: unknown[];
+    resultDisplay?: unknown;
+    error?: ToolCallError;
+    errorType?: string;
+    agentId?: string;
+}
+export interface ToolLike {
+    serverName?: unknown;
+    serverToolName?: unknown;
+    [key: string]: unknown;
+}
+export interface CompletedToolCallShape {
+    status: string;
+    request: ToolCallRequest;
+    response: ToolCallResponse;
+    tool?: ToolLike | unknown;
+    durationMs?: number;
+    outcome?: ToolConfirmationOutcome;
+}
+export declare enum HookEventName {
+    BeforeTool = "BeforeTool",
+    AfterTool = "AfterTool",
+    BeforeAgent = "BeforeAgent",
+    Notification = "Notification",
+    AfterAgent = "AfterAgent",
+    SessionStart = "SessionStart",
+    SessionEnd = "SessionEnd",
+    PreCompress = "PreCompress",
+    BeforeModel = "BeforeModel",
+    AfterModel = "AfterModel",
+    BeforeToolSelection = "BeforeToolSelection"
+}
+export interface HookInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    hook_event_name: string;
+    timestamp: string;
+}
+export interface HookConfig {
+    type: string;
+    command: string;
+    name?: string;
+}
+export interface HookExecutionResult {
+    hookConfig: HookConfig;
+    eventName: HookEventName;
+    success: boolean;
+    output?: Record<string, unknown> | unknown;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+    duration: number;
+    error?: Error;
+}

package/dist/src/internal/interfaces.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// ---------------------------------------------------------------------------
+// ToolConfirmationOutcome — structural equivalent
+// ---------------------------------------------------------------------------
+export var ToolConfirmationOutcome;
+(function (ToolConfirmationOutcome) {
+    ToolConfirmationOutcome["ProceedOnce"] = "proceed_once";
+    ToolConfirmationOutcome["ProceedAlways"] = "proceed_always";
+    ToolConfirmationOutcome["ProceedAlwaysAndSave"] = "proceed_always_and_save";
+    ToolConfirmationOutcome["ProceedAlwaysServer"] = "proceed_always_server";
+    ToolConfirmationOutcome["ProceedAlwaysTool"] = "proceed_always_tool";
+    ToolConfirmationOutcome["ModifyWithEditor"] = "modify_with_editor";
+    ToolConfirmationOutcome["SuggestEdit"] = "suggest_edit";
+    ToolConfirmationOutcome["Cancel"] = "cancel";
+})(ToolConfirmationOutcome || (ToolConfirmationOutcome = {}));
+// ---------------------------------------------------------------------------
+// Hook types — structural equivalents for HookCallEvent
+// ---------------------------------------------------------------------------
+export var HookEventName;
+(function (HookEventName) {
+    HookEventName["BeforeTool"] = "BeforeTool";
+    HookEventName["AfterTool"] = "AfterTool";
+    HookEventName["BeforeAgent"] = "BeforeAgent";
+    HookEventName["Notification"] = "Notification";
+    HookEventName["AfterAgent"] = "AfterAgent";
+    HookEventName["SessionStart"] = "SessionStart";
+    HookEventName["SessionEnd"] = "SessionEnd";
+    HookEventName["PreCompress"] = "PreCompress";
+    HookEventName["BeforeModel"] = "BeforeModel";
+    HookEventName["AfterModel"] = "AfterModel";
+    HookEventName["BeforeToolSelection"] = "BeforeToolSelection";
+})(HookEventName || (HookEventName = {}));
+//# sourceMappingURL=interfaces.js.map

package/dist/src/internal/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/internal/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4EH,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,CAAN,IAAY,uBASX;AATD,WAAY,uBAAuB;IACjC,uDAA4B,CAAA;IAC5B,2DAAgC,CAAA;IAChC,2EAAgD,CAAA;IAChD,wEAA6C,CAAA;IAC7C,oEAAyC,CAAA;IACzC,kEAAuC,CAAA;IACvC,uDAA4B,CAAA;IAC5B,4CAAiB,CAAA;AACnB,CAAC,EATW,uBAAuB,KAAvB,uBAAuB,QASlC;AA4CD,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,0CAAyB,CAAA;IACzB,wCAAuB,CAAA;IACvB,4CAA2B,CAAA;IAC3B,8CAA6B,CAAA;IAC7B,0CAAyB,CAAA;IACzB,8CAA6B,CAAA;IAC7B,0CAAyB,CAAA;IACzB,4CAA2B,CAAA;IAC3B,4CAA2B,CAAA;IAC3B,0CAAyB,CAAA;IACzB,4DAA2C,CAAA;AAC7C,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB"}

package/dist/src/telemetry/constants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const SERVICE_NAME = "llxprt-code";
+export declare const EVENT_USER_PROMPT = "llxprt_code.user_prompt";
+export declare const EVENT_TOOL_CALL = "llxprt_code.tool_call";
+export declare const EVENT_HOOK_CALL = "llxprt_code.hook_call";
+export declare const EVENT_API_REQUEST = "llxprt_code.api_request";
+export declare const EVENT_API_ERROR = "llxprt_code.api_error";
+export declare const EVENT_API_RESPONSE = "llxprt_code.api_response";
+export declare const EVENT_CLI_CONFIG = "llxprt_code.config";
+export declare const EVENT_NEXT_SPEAKER_CHECK = "llxprt_code.next_speaker_check";
+export declare const EVENT_SLASH_COMMAND = "llxprt_code.slash_command";
+export declare const EVENT_CONVERSATION_REQUEST = "llxprt_code.conversation_request";
+export declare const EVENT_CONVERSATION_RESPONSE = "llxprt_code.conversation_response";
+export declare const EVENT_ENHANCED_CONVERSATION_RESPONSE = "llxprt_code.enhanced_conversation_response";
+export declare const EVENT_PROVIDER_SWITCH = "llxprt_code.provider_switch";
+export declare const EVENT_PROVIDER_CAPABILITY = "llxprt_code.provider_capability";
+export declare const EVENT_TOOL_OUTPUT_TRUNCATED = "llxprt_code.tool_output_truncated";
+export declare const EVENT_FILE_OPERATION = "llxprt_code.file_operation";
+export declare const EVENT_MALFORMED_JSON_RESPONSE = "llxprt_code.malformed_json_response";
+export declare const EVENT_MODEL_ROUTING = "llxprt_code.model_routing";
+export declare const EVENT_EXTENSION_INSTALL = "llxprt_code.extension_install";
+export declare const EVENT_EXTENSION_UNINSTALL = "llxprt_code.extension_uninstall";
+export declare const EVENT_EXTENSION_ENABLE = "llxprt_code.extension_enable";
+export declare const EVENT_EXTENSION_DISABLE = "llxprt_code.extension_disable";
+export declare const METRIC_TOOL_CALL_COUNT = "llxprt_code.tool.call.count";
+export declare const METRIC_TOOL_CALL_LATENCY = "llxprt_code.tool.call.latency";
+export declare const METRIC_API_REQUEST_COUNT = "llxprt_code.api.request.count";
+export declare const METRIC_API_REQUEST_LATENCY = "llxprt_code.api.request.latency";
+export declare const METRIC_TOKEN_USAGE = "llxprt_code.token.usage";
+export declare const METRIC_SESSION_COUNT = "llxprt_code.session.count";
+export declare const METRIC_FILE_OPERATION_COUNT = "llxprt_code.file.operation.count";