@codemieai/code 0.0.14 → 0.0.16

package/dist/analytics/remote-submission/lock-manager.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Lock Manager - File-Based Locking for Concurrency Control
+ *
+ * Implements file-based locking to ensure only one RemoteAnalyticsSubmitter
+ * runs at a time across multiple concurrent proxy instances.
+ *
+ * Features:
+ * - Exclusive lock acquisition with retries
+ * - Stale lock detection and recovery
+ * - Process liveness checking
+ * - Heartbeat to prevent false stale detection
+ * - Graceful cleanup on exit signals
+ */
+/**
+ * Lock Manager
+ */
+export declare class LockManager {
+    private lockPath;
+    private lockInfo;
+    private heartbeatTimer;
+    constructor(analyticsDir?: string);
+    /**
+     * Ensure analytics directory exists
+     */
+    private ensureDir;
+    /**
+     * Check if a process is alive
+     */
+    private isProcessAlive;
+    /**
+     * Read lock file
+     */
+    private readLock;
+    /**
+     * Write lock file
+     */
+    private writeLock;
+    /**
+     * Remove lock file
+     */
+    private removeLock;
+    /**
+     * Check if lock is stale (old or process dead)
+     */
+    private isLockStale;
+    /**
+     * Start heartbeat to refresh lock timestamp
+     */
+    private startHeartbeat;
+    /**
+     * Stop heartbeat
+     */
+    private stopHeartbeat;
+    /**
+     * Acquire lock with retry
+     *
+     * @param name Lock name (for logging)
+     * @param maxRetries Maximum number of retries
+     * @returns true if lock acquired, false if failed
+     */
+    acquire(name: string, maxRetries?: number): Promise<boolean>;
+    /**
+     * Release lock
+     */
+    release(): Promise<void>;
+    /**
+     * Setup exit handlers to release lock on process termination
+     */
+    private setupExitHandlers;
+}
+//# sourceMappingURL=lock-manager.d.ts.map

package/dist/analytics/remote-submission/lock-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../../src/analytics/remote-submission/lock-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,cAAc,CAA+B;gBAEzC,YAAY,CAAC,EAAE,MAAM;IAKjC;;OAEG;YACW,SAAS;IAOvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;YACW,QAAQ;IActB;;OAEG;YACW,SAAS;IAMvB;;OAEG;YACW,UAAU;IAUxB;;OAEG;YACW,WAAW;IAezB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAyE7D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/analytics/remote-submission/lock-manager.js

@@ -0,0 +1,238 @@
+/**
+ * Lock Manager - File-Based Locking for Concurrency Control
+ *
+ * Implements file-based locking to ensure only one RemoteAnalyticsSubmitter
+ * runs at a time across multiple concurrent proxy instances.
+ *
+ * Features:
+ * - Exclusive lock acquisition with retries
+ * - Stale lock detection and recovery
+ * - Process liveness checking
+ * - Heartbeat to prevent false stale detection
+ * - Graceful cleanup on exit signals
+ */
+import { readFile, writeFile, unlink, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, hostname } from 'node:os';
+import { logger } from '../../utils/logger.js';
+const LOCK_TIMEOUT = 5 * 60 * 1000; // 5 minutes
+const RETRY_DELAY = 2000; // 2 seconds
+const HEARTBEAT_INTERVAL = 30 * 1000; // 30 seconds
+/**
+ * Lock Manager
+ */
+export class LockManager {
+    lockPath;
+    lockInfo = null;
+    heartbeatTimer = null;
+    constructor(analyticsDir) {
+        const baseDir = analyticsDir || join(homedir(), '.codemie', 'analytics');
+        this.lockPath = join(baseDir, '.lock');
+    }
+    /**
+     * Ensure analytics directory exists
+     */
+    async ensureDir() {
+        const dir = join(this.lockPath, '..');
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+        }
+    }
+    /**
+     * Check if a process is alive
+     */
+    isProcessAlive(pid) {
+        try {
+            // kill(pid, 0) doesn't actually kill, just checks if process exists
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Read lock file
+     */
+    async readLock() {
+        if (!existsSync(this.lockPath)) {
+            return null;
+        }
+        try {
+            const content = await readFile(this.lockPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            logger.debug(`Failed to read lock file: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Write lock file
+     */
+    async writeLock(lockInfo) {
+        await this.ensureDir();
+        const content = JSON.stringify(lockInfo, null, 2);
+        await writeFile(this.lockPath, content, 'utf-8');
+    }
+    /**
+     * Remove lock file
+     */
+    async removeLock() {
+        if (existsSync(this.lockPath)) {
+            try {
+                await unlink(this.lockPath);
+            }
+            catch (error) {
+                logger.debug(`Failed to remove lock: ${error}`);
+            }
+        }
+    }
+    /**
+     * Check if lock is stale (old or process dead)
+     */
+    async isLockStale(lockInfo) {
+        // Check age
+        const age = Date.now() - new Date(lockInfo.timestamp).getTime();
+        if (age > LOCK_TIMEOUT) {
+            return true;
+        }
+        // Check if process is alive
+        if (!this.isProcessAlive(lockInfo.pid)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Start heartbeat to refresh lock timestamp
+     */
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(async () => {
+            if (this.lockInfo) {
+                this.lockInfo.timestamp = new Date().toISOString();
+                try {
+                    await this.writeLock(this.lockInfo);
+                }
+                catch (error) {
+                    logger.debug(`Heartbeat failed: ${error}`);
+                }
+            }
+        }, HEARTBEAT_INTERVAL);
+        // Ensure heartbeat doesn't prevent process exit
+        this.heartbeatTimer.unref();
+    }
+    /**
+     * Stop heartbeat
+     */
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    /**
+     * Acquire lock with retry
+     *
+     * @param name Lock name (for logging)
+     * @param maxRetries Maximum number of retries
+     * @returns true if lock acquired, false if failed
+     */
+    async acquire(name, maxRetries = 3) {
+        let attempts = 0;
+        while (attempts < maxRetries) {
+            attempts++;
+            // Check existing lock
+            const existingLock = await this.readLock();
+            if (existingLock) {
+                // Check if stale
+                if (await this.isLockStale(existingLock)) {
+                    logger.debug(`Removing stale lock from ${existingLock.agent} (PID ${existingLock.pid})`);
+                    await this.removeLock();
+                }
+                else {
+                    // Lock is valid, wait and retry
+                    if (attempts < maxRetries) {
+                        logger.debug(`Lock held by ${existingLock.agent} (PID ${existingLock.pid}), ` +
+                            `waiting ${RETRY_DELAY}ms (attempt ${attempts}/${maxRetries})`);
+                        await new Promise(resolve => setTimeout(resolve, RETRY_DELAY));
+                        continue;
+                    }
+                    else {
+                        logger.debug(`Could not acquire lock after ${maxRetries} attempts`);
+                        return false;
+                    }
+                }
+            }
+            // Try to acquire lock
+            this.lockInfo = {
+                pid: process.pid,
+                timestamp: new Date().toISOString(),
+                hostname: hostname(),
+                agent: name
+            };
+            try {
+                await this.writeLock(this.lockInfo);
+                // Verify we own the lock (race condition check)
+                const verifyLock = await this.readLock();
+                if (verifyLock?.pid === process.pid) {
+                    logger.debug(`Lock acquired by ${name} (PID ${process.pid})`);
+                    this.startHeartbeat();
+                    this.setupExitHandlers();
+                    return true;
+                }
+                else {
+                    // Someone else got the lock first
+                    this.lockInfo = null;
+                    if (attempts < maxRetries) {
+                        await new Promise(resolve => setTimeout(resolve, RETRY_DELAY));
+                        continue;
+                    }
+                    else {
+                        return false;
+                    }
+                }
+            }
+            catch (error) {
+                logger.debug(`Failed to acquire lock: ${error}`);
+                this.lockInfo = null;
+                if (attempts < maxRetries) {
+                    await new Promise(resolve => setTimeout(resolve, RETRY_DELAY));
+                    continue;
+                }
+                else {
+                    return false;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Release lock
+     */
+    async release() {
+        this.stopHeartbeat();
+        if (this.lockInfo) {
+            // Verify we still own the lock
+            const currentLock = await this.readLock();
+            if (currentLock?.pid === process.pid) {
+                await this.removeLock();
+                logger.debug(`Lock released by ${this.lockInfo.agent} (PID ${process.pid})`);
+            }
+            this.lockInfo = null;
+        }
+    }
+    /**
+     * Setup exit handlers to release lock on process termination
+     */
+    setupExitHandlers() {
+        const cleanup = async () => {
+            await this.release();
+        };
+        // Handle various exit signals
+        process.once('SIGINT', cleanup);
+        process.once('SIGTERM', cleanup);
+        process.once('exit', cleanup);
+    }
+}
+//# sourceMappingURL=lock-manager.js.map

package/dist/analytics/remote-submission/lock-manager.js.map

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

package/dist/analytics/remote-submission/metric-transformer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Metric Transformer - Backend-Aligned Pattern
+ *
+ * Transforms CodemieSession raw events into backend-aligned metric payloads
+ * generating only session-level aggregation metrics:
+ * - codemie_coding_agent_usage_total (session aggregation)
+ */
+import type { CodemieSession, CodemieMessage, CodemieToolCall, CodemieFileModification } from '../aggregation/types.js';
+import type { MetricPayload } from './types.js';
+/**
+ * Create session aggregation metric
+ * Only called when session ends (explicit endTime or timeout)
+ */
+export declare function createSessionMetric(session: CodemieSession, rawData: {
+    messages: CodemieMessage[];
+    toolCalls: CodemieToolCall[];
+    fileModifications: CodemieFileModification[];
+}, options: {
+    exitReason: string;
+}): MetricPayload;
+//# sourceMappingURL=metric-transformer.d.ts.map

package/dist/analytics/remote-submission/metric-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-transformer.d.ts","sourceRoot":"","sources":["../../../src/analytics/remote-submission/metric-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,YAAY,CAAC;AA+BpB;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE;IACP,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,iBAAiB,EAAE,uBAAuB,EAAE,CAAC;CAC9C,EACD,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,aAAa,CAoDf"}

package/dist/analytics/remote-submission/metric-transformer.js

@@ -0,0 +1,82 @@
+/**
+ * Metric Transformer - Backend-Aligned Pattern
+ *
+ * Transforms CodemieSession raw events into backend-aligned metric payloads
+ * generating only session-level aggregation metrics:
+ * - codemie_coding_agent_usage_total (session aggregation)
+ */
+import { sep } from 'node:path';
+/**
+ * Helper: Normalize project path to relative format (cross-platform)
+ * "/Users/John_Doe/repos/codemie-ai/codemie-code" -> "codemie-ai/codemie-code"
+ * "C:\Users\John_Doe\repos\codemie-ai\codemie-code" -> "codemie-ai/codemie-code"
+ */
+function normalizeProjectPath(fullPath) {
+    // Split by platform-specific separator
+    const parts = fullPath.split(sep);
+    // Get last 2 parts (organization/project) and join with forward slash
+    return parts.slice(-2).join('/');
+}
+/**
+ * Helper: Estimate API requests from messages
+ * Heuristic: Usually 1-2 API calls per assistant message
+ */
+function estimateAPIRequests(session) {
+    return Math.ceil(session.assistantMessageCount * 1.5);
+}
+/**
+ * Helper: Calculate total execution time from tool calls
+ */
+function calculateTotalExecutionTime(toolCalls) {
+    return toolCalls.reduce((sum, tc) => sum + (tc.durationMs || 0), 0);
+}
+/**
+ * Create session aggregation metric
+ * Only called when session ends (explicit endTime or timeout)
+ */
+export function createSessionMetric(session, rawData, options) {
+    const sessionAttributes = {
+        // Base context (no tool_type for session metric)
+        agent: session.agent,
+        agent_version: session.agentVersion,
+        llm_model: session.model,
+        project: normalizeProjectPath(session.projectPath),
+        session_id: session.sessionId,
+        // Context (only include if available)
+        ...(session.projectHash && { projectHash: session.projectHash }),
+        ...(session.gitBranch && { gitBranch: session.gitBranch }),
+        ...(session.gitCommit && { gitCommit: session.gitCommit }),
+        // Interaction tracking
+        total_user_prompts: session.userPromptCount,
+        total_ai_requests: estimateAPIRequests(session),
+        total_ai_responses: session.assistantMessageCount,
+        total_tool_calls: session.toolCallCount,
+        successful_tool_calls: session.successfulToolCalls,
+        failed_tool_calls: session.failedToolCalls,
+        // Token totals
+        total_input_tokens: session.tokens.input,
+        total_output_tokens: session.tokens.output,
+        total_cache_read_input_tokens: session.tokens.cacheRead,
+        // Code totals
+        files_created: session.fileStats?.filesCreated || 0,
+        files_modified: session.fileStats?.filesModified || 0,
+        files_deleted: session.fileStats?.filesDeleted || 0,
+        total_lines_added: session.fileStats?.totalLinesAdded || 0,
+        total_lines_removed: session.fileStats?.totalLinesRemoved || 0,
+        // Performance
+        session_duration_ms: session.durationMs || 0,
+        ...(rawData.toolCalls.some(tc => tc.durationMs) && {
+            total_execution_time: calculateTotalExecutionTime(rawData.toolCalls)
+        }),
+        // Status
+        exit_reason: options.exitReason,
+        had_errors: session.hadErrors,
+        count: 1,
+    };
+    return {
+        metric_name: 'codemie_coding_agent_usage_total',
+        attributes: sessionAttributes,
+        time: (session.endTime || new Date()).toISOString(),
+    };
+}
+//# sourceMappingURL=metric-transformer.js.map

package/dist/analytics/remote-submission/metric-transformer.js.map

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

package/dist/analytics/remote-submission/submitter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Remote Analytics Submitter
+ *
+ * Orchestrates periodic submission of analytics metrics to /v1/metrics endpoint.
+ * Handles event-level tracking, concurrency control, and backend-aligned metrics.
+ *
+ * Key Features:
+ * - 5-minute submission interval
+ * - Event-level tracking (message IDs, tool call IDs)
+ * - Multi-terminal safety via file locking
+ * - Inactivity-based session end detection
+ * - Backend-aligned metric transformation (3+1 pattern)
+ */
+import type { RemoteSubmissionConfig } from './types.js';
+/**
+ * Remote Analytics Submitter
+ */
+export declare class RemoteAnalyticsSubmitter {
+    private config;
+    private cursorManager;
+    private lockManager;
+    private intervalTimer;
+    private isRunning;
+    constructor(config: RemoteSubmissionConfig);
+    /**
+     * Start periodic submission
+     */
+    start(): void;
+    /**
+     * Stop periodic submission
+     */
+    stop(): void;
+    /**
+     * Main submission cycle
+     */
+    private submitCycle;
+    /**
+     * Process all external agents
+     */
+    private processExternalAgents;
+    /**
+     * Process single agent
+     */
+    private processAgent;
+    /**
+     * Process single session
+     */
+    private processSession;
+    /**
+     * Determine session status based on activity
+     */
+    private determineSessionStatus;
+    /**
+     * Get last activity time from session
+     */
+    private getLastActivityTime;
+    /**
+     * Maybe submit session metric based on status
+     */
+    private maybeSubmitSessionMetric;
+    /**
+     * Submit batch of metrics - writes to local file and/or remote endpoint
+     */
+    private submitBatch;
+    /**
+     * Write metrics to local JSONL file
+     */
+    private writeMetricsToLocalFile;
+    /**
+     * Submit metrics to remote /v1/metrics endpoint
+     * Note: Caller should verify baseUrl and cookies are set before calling
+     */
+    private submitToRemote;
+    /**
+     * Create batches from metrics
+     */
+    private createBatches;
+}
+//# sourceMappingURL=submitter.d.ts.map

package/dist/analytics/remote-submission/submitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submitter.d.ts","sourceRoot":"","sources":["../../../src/analytics/remote-submission/submitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,KAAK,EACV,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,sBAAsB;IAM1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAuBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;YACW,WAAW;IAsCzB;;OAEG;YACW,qBAAqB;IA4BnC;;OAEG;YACW,YAAY;IAoB1B;;OAEG;YACW,cAAc;IAyF5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkC9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;YACW,wBAAwB;IAgDtC;;OAEG;YACW,WAAW;IAiBzB;;OAEG;YACW,uBAAuB;IAyBrC;;;OAGG;YACW,cAAc;IA2B5B;;OAEG;IACH,OAAO,CAAC,aAAa;CAOtB"}