cc-agentic-framework 1.14.1

package/dist/lib/telemetry/exporters/session-file-exporter.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Session File Exporter
+ * Writes telemetry events to session-specific JSONL files
+ *
+ * Each Claude session gets its own log file, making it easy to:
+ * - Distinguish parallel agent runs
+ * - Query all events from a specific session
+ * - Clean up old session logs automatically
+ */
+import { TelemetryEvent, TelemetryExporter, SessionFileExporterConfig } from '../types.js';
+/**
+ * Session File Exporter
+ * Creates one JSONL file per session in the configured directory
+ */
+export declare class SessionFileExporter implements TelemetryExporter {
+    private config;
+    private projectPath;
+    private currentSessionFile;
+    private buffer;
+    private flushTimer;
+    private readonly BUFFER_SIZE;
+    private readonly FLUSH_INTERVAL_MS;
+    private cleanupScheduled;
+    constructor(config: SessionFileExporterConfig, projectPath?: string);
+    /**
+     * Get the sessions directory path
+     */
+    private getSessionsDirectory;
+    /**
+     * Get or create the session file path for the current session
+     */
+    private getSessionFilePath;
+    /**
+     * Export a telemetry event to the session file
+     */
+    export(event: TelemetryEvent): Promise<void>;
+    /**
+     * Flush buffered events to the session file
+     */
+    flush(): Promise<void>;
+    /**
+     * Start automatic flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Schedule cleanup of old session files
+     */
+    private scheduleCleanup;
+    /**
+     * Clean up old session files based on configuration
+     */
+    private cleanupOldSessions;
+    /**
+     * Shutdown the exporter
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get the current session file path (for debugging/testing)
+     */
+    getCurrentSessionFile(): string | null;
+    /**
+     * List all session files in the sessions directory
+     */
+    listSessionFiles(): Promise<string[]>;
+}
+//# sourceMappingURL=session-file-exporter.d.ts.map

package/dist/lib/telemetry/exporters/session-file-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file-exporter.d.ts","sourceRoot":"","sources":["../../../../src/lib/telemetry/exporters/session-file-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAGrB;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IACzC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,yBAAyB,EAAE,WAAW,GAAE,MAAsB;IAelF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;YACW,kBAAkB;IAwEhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B;;OAEG;IACH,qBAAqB,IAAI,MAAM,GAAG,IAAI;IAItC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAQ5C"}

package/dist/lib/telemetry/exporters/session-file-exporter.js

@@ -0,0 +1,223 @@
+/**
+ * Session File Exporter
+ * Writes telemetry events to session-specific JSONL files
+ *
+ * Each Claude session gets its own log file, making it easy to:
+ * - Distinguish parallel agent runs
+ * - Query all events from a specific session
+ * - Clean up old session logs automatically
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { getSessionId } from '../session-context.js';
+/**
+ * Session File Exporter
+ * Creates one JSONL file per session in the configured directory
+ */
+export class SessionFileExporter {
+    config;
+    projectPath;
+    currentSessionFile = null;
+    buffer = [];
+    flushTimer = null;
+    BUFFER_SIZE = 50;
+    FLUSH_INTERVAL_MS = 500;
+    cleanupScheduled = false;
+    constructor(config, projectPath = process.cwd()) {
+        this.config = config;
+        this.projectPath = projectPath;
+        // Ensure sessions directory exists
+        const sessionsDir = this.getSessionsDirectory();
+        fs.ensureDirSync(sessionsDir);
+        // Start flush timer
+        this.startFlushTimer();
+        // Schedule cleanup of old session files
+        this.scheduleCleanup();
+    }
+    /**
+     * Get the sessions directory path
+     */
+    getSessionsDirectory() {
+        return path.isAbsolute(this.config.directory)
+            ? this.config.directory
+            : path.join(this.projectPath, this.config.directory);
+    }
+    /**
+     * Get or create the session file path for the current session
+     */
+    getSessionFilePath() {
+        const sessionId = getSessionId();
+        if (!sessionId) {
+            return null;
+        }
+        // Cache the file path for the current session
+        if (!this.currentSessionFile) {
+            const sessionsDir = this.getSessionsDirectory();
+            const timestamp = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+            this.currentSessionFile = path.join(sessionsDir, `${sessionId}_${timestamp}.jsonl`);
+        }
+        return this.currentSessionFile;
+    }
+    /**
+     * Export a telemetry event to the session file
+     */
+    async export(event) {
+        try {
+            // Add to buffer
+            this.buffer.push(event);
+            // Flush if buffer is full
+            if (this.buffer.length >= this.BUFFER_SIZE) {
+                await this.flush();
+            }
+        }
+        catch (error) {
+            // Never throw - telemetry failures should not crash the app
+            console.error('Failed to export session telemetry event:', error);
+        }
+    }
+    /**
+     * Flush buffered events to the session file
+     */
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const sessionFile = this.getSessionFilePath();
+        if (!sessionFile) {
+            // No session active, clear buffer and return
+            this.buffer = [];
+            return;
+        }
+        try {
+            // Ensure directory exists
+            await fs.ensureDir(path.dirname(sessionFile));
+            // Write all buffered events as JSONL
+            const lines = this.buffer.map(event => JSON.stringify(event)).join('\n') + '\n';
+            // Append to session file
+            await fs.appendFile(sessionFile, lines, 'utf-8');
+            // Clear buffer
+            this.buffer = [];
+        }
+        catch (error) {
+            console.error('Failed to flush session telemetry events:', error);
+            // Keep buffer to try again later
+        }
+    }
+    /**
+     * Start automatic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            this.flush().catch(error => {
+                console.error('Failed to auto-flush session telemetry:', error);
+            });
+        }, this.FLUSH_INTERVAL_MS);
+    }
+    /**
+     * Schedule cleanup of old session files
+     */
+    scheduleCleanup() {
+        if (this.cleanupScheduled)
+            return;
+        this.cleanupScheduled = true;
+        // Run cleanup after a short delay to not block initialization
+        setTimeout(() => {
+            this.cleanupOldSessions().catch(error => {
+                console.error('Failed to cleanup old session files:', error);
+            });
+        }, 5000);
+    }
+    /**
+     * Clean up old session files based on configuration
+     */
+    async cleanupOldSessions() {
+        try {
+            const sessionsDir = this.getSessionsDirectory();
+            if (!await fs.pathExists(sessionsDir)) {
+                return;
+            }
+            const files = await fs.readdir(sessionsDir);
+            const sessionFiles = files.filter(f => f.endsWith('.jsonl'));
+            if (sessionFiles.length === 0) {
+                return;
+            }
+            // Get file stats
+            const filesWithStats = await Promise.all(sessionFiles.map(async (f) => {
+                const filePath = path.join(sessionsDir, f);
+                try {
+                    const stat = await fs.stat(filePath);
+                    return { name: f, path: filePath, stat };
+                }
+                catch {
+                    return null;
+                }
+            }));
+            const validFiles = filesWithStats.filter((f) => f !== null);
+            // Sort by modification time (oldest first)
+            validFiles.sort((a, b) => a.stat.mtimeMs - b.stat.mtimeMs);
+            const now = Date.now();
+            const maxAgeMs = this.config.maxAgeDays * 24 * 60 * 60 * 1000;
+            const filesToDelete = [];
+            // Mark files for deletion based on age
+            for (const file of validFiles) {
+                const fileAge = now - file.stat.mtimeMs;
+                if (fileAge > maxAgeMs) {
+                    filesToDelete.push(file.path);
+                }
+            }
+            // Also delete if we have too many files (keep newest)
+            const remainingFiles = validFiles.filter(f => !filesToDelete.includes(f.path));
+            if (remainingFiles.length > this.config.maxFiles) {
+                const excessCount = remainingFiles.length - this.config.maxFiles;
+                // remainingFiles is already sorted oldest first
+                for (let i = 0; i < excessCount; i++) {
+                    filesToDelete.push(remainingFiles[i].path);
+                }
+            }
+            // Delete marked files
+            for (const filePath of filesToDelete) {
+                try {
+                    await fs.unlink(filePath);
+                }
+                catch (error) {
+                    console.error(`Failed to delete old session file ${filePath}:`, error);
+                }
+            }
+            if (filesToDelete.length > 0) {
+                console.debug(`Cleaned up ${filesToDelete.length} old session files`);
+            }
+        }
+        catch (error) {
+            console.error('Error during session file cleanup:', error);
+        }
+    }
+    /**
+     * Shutdown the exporter
+     */
+    async shutdown() {
+        // Stop flush timer
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // Flush remaining events
+        await this.flush();
+    }
+    /**
+     * Get the current session file path (for debugging/testing)
+     */
+    getCurrentSessionFile() {
+        return this.currentSessionFile;
+    }
+    /**
+     * List all session files in the sessions directory
+     */
+    async listSessionFiles() {
+        const sessionsDir = this.getSessionsDirectory();
+        if (!await fs.pathExists(sessionsDir)) {
+            return [];
+        }
+        const files = await fs.readdir(sessionsDir);
+        return files.filter(f => f.endsWith('.jsonl')).map(f => path.join(sessionsDir, f));
+    }
+}
+//# sourceMappingURL=session-file-exporter.js.map

package/dist/lib/telemetry/exporters/session-file-exporter.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * Telemetry Module
+ * Public API for framework telemetry
+ */
+export type { TelemetryEvent, TelemetryEventType, TelemetryLevel, TelemetryConfig, TelemetryExporter, TelemetrySpan, SpanAttributes, DiscoveryEvent, SyncEvent, CLIEvent, IntegrationEvent, ValidationEvent, MCPEvent, AgentEvent, JsonFileExporterConfig, SessionFileExporterConfig, OtelExporterConfig, ConsoleExporterConfig, InstrumentationConfig, SessionConfig, SessionContext } from './types.js';
+export { loadTelemetryConfig, getDefaultConfig } from './config.js';
+export { TelemetryManager, getTelemetry } from './telemetry-manager.js';
+export { initSession, getSessionContext, getSessionId, hasActiveSession, generateSessionId, generateCorrelationId, createChildSession, setCorrelationId, clearCorrelationId, withCorrelation, runWithSession, runWithSessionAsync, resetSessionContext } from './session-context.js';
+export { JsonFileExporter } from './exporters/json-file-exporter.js';
+export { SessionFileExporter } from './exporters/session-file-exporter.js';
+export { OtelExporter } from './exporters/otel-exporter.js';
+export { ConsoleExporter } from './exporters/console-exporter.js';
+export { recordMCPOperation, withMCPTelemetry, recordMCPToolCall, recordMCPGatewayOperation } from './instrumentation/mcp-instrumentation.js';
+export type { TokenExtractor, CostExtractor } from './instrumentation/mcp-instrumentation.js';
+import type { TelemetryEvent, SpanAttributes, TelemetrySpan } from './types.js';
+/**
+ * Record a telemetry event
+ */
+export declare function recordEvent(event: Partial<TelemetryEvent>): Promise<void>;
+/**
+ * Start a telemetry span
+ */
+export declare function startSpan(name: string, attributes?: SpanAttributes): TelemetrySpan;
+/**
+ * Wrap a function with automatic telemetry
+ */
+export declare function withTelemetry<T>(name: string, fn: () => Promise<T>, attributes?: SpanAttributes): Promise<T>;
+/**
+ * Check if telemetry is enabled
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Check if a specific instrumentation is enabled
+ */
+export declare function isInstrumentationEnabled(type: 'discovery' | 'sync' | 'cli' | 'mcp'): boolean;
+/**
+ * Get current session ID (convenience function)
+ */
+export declare function getCurrentSessionId(): string | undefined;
+/**
+ * Check if session tracking is enabled and active
+ */
+export declare function isSessionEnabled(): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,UAAU,EACV,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGxE,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,cAAc,EACd,aAAa,EACd,MAAM,0CAA0C,CAAC;AAIlD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhF;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,aAAa,CAGlF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAG5C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GACzC,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAGxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C"}

package/dist/lib/telemetry/index.js

@@ -0,0 +1,69 @@
+/**
+ * Telemetry Module
+ * Public API for framework telemetry
+ */
+// Export configuration
+export { loadTelemetryConfig, getDefaultConfig } from './config.js';
+// Export telemetry manager
+export { TelemetryManager, getTelemetry } from './telemetry-manager.js';
+// Export session context utilities
+export { initSession, getSessionContext, getSessionId, hasActiveSession, generateSessionId, generateCorrelationId, createChildSession, setCorrelationId, clearCorrelationId, withCorrelation, runWithSession, runWithSessionAsync, resetSessionContext } from './session-context.js';
+// Export exporters
+export { JsonFileExporter } from './exporters/json-file-exporter.js';
+export { SessionFileExporter } from './exporters/session-file-exporter.js';
+export { OtelExporter } from './exporters/otel-exporter.js';
+export { ConsoleExporter } from './exporters/console-exporter.js';
+// Export MCP instrumentation
+export { recordMCPOperation, withMCPTelemetry, recordMCPToolCall, recordMCPGatewayOperation } from './instrumentation/mcp-instrumentation.js';
+// Convenience functions
+import { getTelemetry } from './telemetry-manager.js';
+/**
+ * Record a telemetry event
+ */
+export async function recordEvent(event) {
+    const telemetry = getTelemetry();
+    await telemetry.recordEvent(event);
+}
+/**
+ * Start a telemetry span
+ */
+export function startSpan(name, attributes) {
+    const telemetry = getTelemetry();
+    return telemetry.startSpan(name, attributes);
+}
+/**
+ * Wrap a function with automatic telemetry
+ */
+export async function withTelemetry(name, fn, attributes) {
+    const telemetry = getTelemetry();
+    return telemetry.withTelemetry(name, fn, attributes);
+}
+/**
+ * Check if telemetry is enabled
+ */
+export function isTelemetryEnabled() {
+    const telemetry = getTelemetry();
+    return telemetry.isEnabled();
+}
+/**
+ * Check if a specific instrumentation is enabled
+ */
+export function isInstrumentationEnabled(type) {
+    const telemetry = getTelemetry();
+    return telemetry.isInstrumentationEnabled(type);
+}
+/**
+ * Get current session ID (convenience function)
+ */
+export function getCurrentSessionId() {
+    const telemetry = getTelemetry();
+    return telemetry.getSessionId();
+}
+/**
+ * Check if session tracking is enabled and active
+ */
+export function isSessionEnabled() {
+    const telemetry = getTelemetry();
+    return telemetry.isSessionEnabled();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,uBAAuB;AACvB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAExE,mCAAmC;AACnC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,6BAA6B;AAC7B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAMlD,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAA8B;IAC9D,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAA2B;IACjE,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,EAAoB,EACpB,UAA2B;IAE3B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,SAAS,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAA0C;IAE1C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,YAAY,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,gBAAgB,EAAE,CAAC;AACtC,CAAC"}

package/dist/lib/telemetry/instrumentation/cli-instrumentation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CLI Command Instrumentation Helpers
+ * Helper functions for instrumenting CLI commands
+ */
+/**
+ * Record a CLI command execution
+ */
+export declare function recordCLICommand(command: string, subcommand: string | undefined, options: Record<string, unknown>, result: Record<string, unknown> | undefined, durationMs: number, success?: boolean, error?: Error): Promise<void>;
+/**
+ * Wrap a CLI command function with automatic telemetry
+ */
+export declare function withCLITelemetry<T>(command: string, subcommand: string | undefined, options: Record<string, unknown>, fn: () => Promise<T>): Promise<T>;
+/**
+ * Record a sync command
+ */
+export declare function recordSyncCommand(options: Record<string, unknown>, skillsSynced: number, agentsSynced: number, errors: number, durationMs: number): Promise<void>;
+/**
+ * Record a validate command
+ */
+export declare function recordValidateCommand(options: Record<string, unknown>, validationResults: Record<string, unknown>, durationMs: number, success: boolean): Promise<void>;
+/**
+ * Record an init command
+ */
+export declare function recordInitCommand(projectName: string, modules: string[], durationMs: number, success: boolean): Promise<void>;
+//# sourceMappingURL=cli-instrumentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-instrumentation.d.ts","sourceRoot":"","sources":["../../../../src/lib/telemetry/instrumentation/cli-instrumentation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAc,EACvB,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAkCZ;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/lib/telemetry/instrumentation/cli-instrumentation.js

@@ -0,0 +1,83 @@
+/**
+ * CLI Command Instrumentation Helpers
+ * Helper functions for instrumenting CLI commands
+ */
+import { getTelemetry } from '../telemetry-manager.js';
+/**
+ * Record a CLI command execution
+ */
+export async function recordCLICommand(command, subcommand, options, result, durationMs, success = true, error) {
+    const telemetry = getTelemetry();
+    if (!telemetry.isInstrumentationEnabled('cli')) {
+        return;
+    }
+    const event = {
+        event_type: 'cli',
+        operation: subcommand ? `${command}_${subcommand}` : command,
+        command,
+        subcommand,
+        options,
+        result,
+        success,
+        duration_ms: durationMs
+    };
+    if (error) {
+        event.error = {
+            message: error.message,
+            stack: error.stack
+        };
+    }
+    await telemetry.recordEvent(event);
+}
+/**
+ * Wrap a CLI command function with automatic telemetry
+ */
+export async function withCLITelemetry(command, subcommand, options, fn) {
+    const startTime = Date.now();
+    let result;
+    let success = true;
+    let error;
+    try {
+        result = await fn();
+        return result;
+    }
+    catch (err) {
+        success = false;
+        error = err;
+        throw err;
+    }
+    finally {
+        const durationMs = Date.now() - startTime;
+        // Extract result data if it's an object
+        const resultData = result && typeof result === 'object'
+            ? result
+            : undefined;
+        // Record telemetry asynchronously (don't await)
+        recordCLICommand(command, subcommand, options, resultData, durationMs, success, error).catch(() => {
+            // Ignore telemetry errors
+        });
+    }
+}
+/**
+ * Record a sync command
+ */
+export async function recordSyncCommand(options, skillsSynced, agentsSynced, errors, durationMs) {
+    await recordCLICommand('sync', undefined, options, {
+        skills_synced: skillsSynced,
+        agents_synced: agentsSynced,
+        errors
+    }, durationMs, errors === 0);
+}
+/**
+ * Record a validate command
+ */
+export async function recordValidateCommand(options, validationResults, durationMs, success) {
+    await recordCLICommand('validate', undefined, options, validationResults, durationMs, success);
+}
+/**
+ * Record an init command
+ */
+export async function recordInitCommand(projectName, modules, durationMs, success) {
+    await recordCLICommand('init', undefined, { project: projectName, modules }, { modules_installed: modules.length }, durationMs, success);
+}
+//# sourceMappingURL=cli-instrumentation.js.map

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

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

package/dist/lib/telemetry/instrumentation/discovery-instrumentation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Discovery Engine Instrumentation Helpers
+ * Helper functions for instrumenting discovery engine operations
+ */
+/**
+ * Record a discovery operation
+ */
+export declare function recordDiscoveryOperation(agentId: string, moduleId: string, capabilitiesRequested: string[], skillsDiscovered: Array<{
+    skillId: string;
+    module: string;
+    source: string;
+}>, unfulfilledCapabilities: string[], durationMs: number, variant?: 'full' | 'slim', cacheHit?: boolean): Promise<void>;
+/**
+ * Record a module loading operation
+ */
+export declare function recordModuleLoad(moduleCount: number, durationMs: number, success?: boolean): Promise<void>;
+/**
+ * Record capability map building
+ */
+export declare function recordCapabilityMapBuild(capabilityCount: number, durationMs: number): Promise<void>;
+//# sourceMappingURL=discovery-instrumentation.d.ts.map

package/dist/lib/telemetry/instrumentation/discovery-instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-instrumentation.d.ts","sourceRoot":"","sources":["../../../../src/lib/telemetry/instrumentation/discovery-instrumentation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,qBAAqB,EAAE,MAAM,EAAE,EAC/B,gBAAgB,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5E,uBAAuB,EAAE,MAAM,EAAE,EACjC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EACzB,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/lib/telemetry/instrumentation/discovery-instrumentation.js

@@ -0,0 +1,78 @@
+/**
+ * Discovery Engine Instrumentation Helpers
+ * Helper functions for instrumenting discovery engine operations
+ */
+import { getTelemetry } from '../telemetry-manager.js';
+/**
+ * Record a discovery operation
+ */
+export async function recordDiscoveryOperation(agentId, moduleId, capabilitiesRequested, skillsDiscovered, unfulfilledCapabilities, durationMs, variant, cacheHit) {
+    const telemetry = getTelemetry();
+    if (!telemetry.isInstrumentationEnabled('discovery')) {
+        return;
+    }
+    const event = {
+        event_type: 'discovery',
+        operation: 'discover_skills',
+        agent_id: agentId,
+        module_id: moduleId,
+        variant,
+        capabilities_requested: capabilitiesRequested,
+        skills_discovered: skillsDiscovered.map(s => ({
+            skill_id: s.skillId,
+            module: s.module,
+            source: s.source
+        })),
+        unfulfilled_capabilities: unfulfilledCapabilities,
+        discovery_duration_ms: durationMs,
+        cache_hit: cacheHit,
+        success: true,
+        duration_ms: durationMs
+    };
+    await telemetry.recordEvent(event);
+}
+/**
+ * Record a module loading operation
+ */
+export async function recordModuleLoad(moduleCount, durationMs, success = true) {
+    const telemetry = getTelemetry();
+    if (!telemetry.isInstrumentationEnabled('discovery')) {
+        return;
+    }
+    const event = {
+        event_type: 'discovery',
+        operation: 'load_modules',
+        agent_id: 'system',
+        module_id: 'core',
+        capabilities_requested: [],
+        skills_discovered: [],
+        unfulfilled_capabilities: [],
+        discovery_duration_ms: durationMs,
+        success,
+        duration_ms: durationMs
+    };
+    await telemetry.recordEvent(event);
+}
+/**
+ * Record capability map building
+ */
+export async function recordCapabilityMapBuild(capabilityCount, durationMs) {
+    const telemetry = getTelemetry();
+    if (!telemetry.isInstrumentationEnabled('discovery')) {
+        return;
+    }
+    const event = {
+        event_type: 'discovery',
+        operation: 'build_capability_map',
+        agent_id: 'system',
+        module_id: 'core',
+        capabilities_requested: [],
+        skills_discovered: [],
+        unfulfilled_capabilities: [],
+        discovery_duration_ms: durationMs,
+        success: true,
+        duration_ms: durationMs
+    };
+    await telemetry.recordEvent(event);
+}
+//# sourceMappingURL=discovery-instrumentation.js.map

package/dist/lib/telemetry/instrumentation/discovery-instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-instrumentation.js","sourceRoot":"","sources":["../../../../src/lib/telemetry/instrumentation/discovery-instrumentation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAe,EACf,QAAgB,EAChB,qBAA+B,EAC/B,gBAA4E,EAC5E,uBAAiC,EACjC,UAAkB,EAClB,OAAyB,EACzB,QAAkB;IAElB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAA4B;QACrC,UAAU,EAAE,WAAW;QACvB,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,QAAQ;QACnB,OAAO;QACP,sBAAsB,EAAE,qBAAqB;QAC7C,iBAAiB,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5C,QAAQ,EAAE,CAAC,CAAC,OAAO;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;QACH,wBAAwB,EAAE,uBAAuB;QACjD,qBAAqB,EAAE,UAAU;QACjC,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,UAAU;KACxB,CAAC;IAEF,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,UAAkB,EAClB,UAAmB,IAAI;IAEvB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,UAAU,EAAE,WAAoB;QAChC,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,MAAM;QACjB,sBAAsB,EAAE,EAAE;QAC1B,iBAAiB,EAAE,EAAE;QACrB,wBAAwB,EAAE,EAAE;QAC5B,qBAAqB,EAAE,UAAU;QACjC,OAAO;QACP,WAAW,EAAE,UAAU;KACxB,CAAC;IAEF,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,eAAuB,EACvB,UAAkB;IAElB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,UAAU,EAAE,WAAoB;QAChC,SAAS,EAAE,sBAAsB;QACjC,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,MAAM;QACjB,sBAAsB,EAAE,EAAE;QAC1B,iBAAiB,EAAE,EAAE;QACrB,wBAAwB,EAAE,EAAE;QAC5B,qBAAqB,EAAE,UAAU;QACjC,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,UAAU;KACxB,CAAC;IAEF,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC"}