lattice-orchestrator 0.7.0

package/dist/services/infrastructure/cost-tracker.js

@@ -0,0 +1,423 @@
+/**
+ * CostTracker - Tracks LLM API costs for insights generation.
+ *
+ * Provides:
+ * - Per-call cost logging with session, operation, model, tokens
+ * - Summary queries (today, this week, by operation, by model)
+ * - Cost estimation using current Anthropic pricing
+ *
+ * Design decisions:
+ * - Separate table from session insights for clean separation
+ * - Uses same database file for simplicity
+ * - Costs stored in USD for consistency
+ */
+import Database from 'better-sqlite3';
+import path from 'path';
+import fs from 'fs';
+import { createLogger } from '../infrastructure/logger.js';
+import { CONFIG_DIR } from '../../utils/constants.js';
+// Anthropic pricing as of Jan 2026 (per 1M tokens)
+const PRICING = {
+    // Claude 4.5 models
+    'claude-opus-4-5-20251101': { input: 15.0, output: 75.0 },
+    'claude-opus-4-5': { input: 15.0, output: 75.0 },
+    'claude-sonnet-4-5-20250929': { input: 3.0, output: 15.0 },
+    'claude-sonnet-4-5': { input: 3.0, output: 15.0 },
+    'claude-haiku-4-5-20251001': { input: 0.80, output: 4.0 },
+    'claude-haiku-4-5': { input: 0.80, output: 4.0 },
+};
+// Default pricing for unknown models
+const DEFAULT_PRICING = { input: 3.0, output: 15.0 };
+export class CostTracker {
+    logger;
+    db = null;
+    isInitialized = false;
+    dbPath;
+    configDir;
+    // Prepared statements for performance
+    insertStmt = null;
+    summaryStmt = null;
+    constructor(testDbPath) {
+        this.logger = createLogger('CostTracker');
+        if (testDbPath) {
+            this.configDir = path.dirname(testDbPath);
+            this.dbPath = testDbPath;
+        }
+        else {
+            this.configDir = CONFIG_DIR;
+            this.dbPath = path.join(this.configDir, 'session-info.db');
+        }
+    }
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        try {
+            if (this.dbPath !== ':memory:' && !fs.existsSync(this.configDir)) {
+                fs.mkdirSync(this.configDir, { recursive: true });
+            }
+            this.db = new Database(this.dbPath);
+            this.db.pragma('journal_mode = WAL');
+            // Create llm_costs table
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS llm_costs (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          operation TEXT NOT NULL,
+          model TEXT NOT NULL,
+          input_tokens INTEGER NOT NULL,
+          output_tokens INTEGER NOT NULL,
+          estimated_cost_usd REAL NOT NULL,
+          duration_ms INTEGER NOT NULL,
+          trace_id TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_llm_costs_session ON llm_costs(session_id);
+        CREATE INDEX IF NOT EXISTS idx_llm_costs_created ON llm_costs(created_at);
+        CREATE INDEX IF NOT EXISTS idx_llm_costs_operation ON llm_costs(operation);
+      `);
+            this.prepareStatements();
+            this.isInitialized = true;
+            this.logger.info('Cost tracker initialized');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize cost tracker', { error });
+            throw error;
+        }
+    }
+    prepareStatements() {
+        if (!this.db)
+            return;
+        this.insertStmt = this.db.prepare(`
+      INSERT INTO llm_costs (session_id, operation, model, input_tokens, output_tokens, estimated_cost_usd, duration_ms, trace_id, created_at)
+      VALUES (@sessionId, @operation, @model, @inputTokens, @outputTokens, @estimatedCostUsd, @durationMs, @traceId, datetime('now'))
+    `);
+    }
+    /**
+     * Calculate cost in USD for a given model and token counts.
+     */
+    calculateCost(model, inputTokens, outputTokens) {
+        const pricing = PRICING[model] || DEFAULT_PRICING;
+        const inputCost = (inputTokens / 1_000_000) * pricing.input;
+        const outputCost = (outputTokens / 1_000_000) * pricing.output;
+        return inputCost + outputCost;
+    }
+    /**
+     * Log an LLM API call with its cost.
+     */
+    log(record) {
+        if (!this.isInitialized || !this.insertStmt) {
+            this.logger.warn('Cost tracker not initialized, skipping log');
+            return;
+        }
+        const estimatedCostUsd = this.calculateCost(record.model, record.inputTokens, record.outputTokens);
+        try {
+            this.insertStmt.run({
+                sessionId: record.sessionId,
+                operation: record.operation,
+                model: record.model,
+                inputTokens: record.inputTokens,
+                outputTokens: record.outputTokens,
+                estimatedCostUsd,
+                durationMs: record.durationMs,
+                traceId: record.traceId || null,
+            });
+            this.logger.debug('Cost logged', {
+                sessionId: record.sessionId.slice(0, 8),
+                operation: record.operation,
+                model: record.model.split('-').slice(-2).join('-'), // Just version part
+                tokens: `${record.inputTokens}/${record.outputTokens}`,
+                cost: `$${estimatedCostUsd.toFixed(4)}`,
+                durationMs: record.durationMs,
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to log cost', { error, record });
+        }
+    }
+    /**
+     * Get cost summary for different time periods.
+     */
+    getSummary() {
+        if (!this.isInitialized || !this.db) {
+            return this.emptySummaryResponse();
+        }
+        // Format date for SQLite comparison (must match datetime('now') format: 'YYYY-MM-DD HH:MM:SS')
+        const formatForSQLite = (date) => {
+            const pad = (n) => n.toString().padStart(2, '0');
+            return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())} ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}`;
+        };
+        const now = new Date();
+        const todayStart = formatForSQLite(new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())));
+        const weekStart = formatForSQLite(new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000));
+        const monthStart = formatForSQLite(new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1)));
+        // Helper to query summary for a date range
+        const querySummary = (startDate) => {
+            const sql = startDate
+                ? `SELECT
+             COUNT(*) as calls,
+             COALESCE(SUM(input_tokens), 0) as inputTokens,
+             COALESCE(SUM(output_tokens), 0) as outputTokens,
+             COALESCE(SUM(estimated_cost_usd), 0) as estimatedCostUsd
+           FROM llm_costs
+           WHERE created_at >= ?`
+                : `SELECT
+             COUNT(*) as calls,
+             COALESCE(SUM(input_tokens), 0) as inputTokens,
+             COALESCE(SUM(output_tokens), 0) as outputTokens,
+             COALESCE(SUM(estimated_cost_usd), 0) as estimatedCostUsd
+           FROM llm_costs`;
+            const row = startDate
+                ? this.db.prepare(sql).get(startDate)
+                : this.db.prepare(sql).get();
+            return {
+                calls: row?.calls || 0,
+                inputTokens: row?.inputTokens || 0,
+                outputTokens: row?.outputTokens || 0,
+                totalTokens: (row?.inputTokens || 0) + (row?.outputTokens || 0),
+                estimatedCostUsd: row?.estimatedCostUsd || 0,
+            };
+        };
+        const byOperationRows = this.db.prepare(`
+      SELECT
+        operation,
+        COUNT(*) as calls,
+        COALESCE(SUM(input_tokens), 0) as inputTokens,
+        COALESCE(SUM(output_tokens), 0) as outputTokens,
+        COALESCE(SUM(estimated_cost_usd), 0) as estimatedCostUsd
+      FROM llm_costs
+      GROUP BY operation
+    `).all();
+        const byOperation = {};
+        for (const row of byOperationRows) {
+            byOperation[row.operation] = {
+                calls: row.calls,
+                inputTokens: row.inputTokens,
+                outputTokens: row.outputTokens,
+                totalTokens: row.inputTokens + row.outputTokens,
+                estimatedCostUsd: row.estimatedCostUsd,
+            };
+        }
+        const byModelRows = this.db.prepare(`
+      SELECT
+        model,
+        COUNT(*) as calls,
+        COALESCE(SUM(input_tokens), 0) as inputTokens,
+        COALESCE(SUM(output_tokens), 0) as outputTokens,
+        COALESCE(SUM(estimated_cost_usd), 0) as estimatedCostUsd
+      FROM llm_costs
+      GROUP BY model
+    `).all();
+        const byModel = {};
+        for (const row of byModelRows) {
+            byModel[row.model] = {
+                calls: row.calls,
+                inputTokens: row.inputTokens,
+                outputTokens: row.outputTokens,
+                totalTokens: row.inputTokens + row.outputTokens,
+                estimatedCostUsd: row.estimatedCostUsd,
+            };
+        }
+        const recentCalls = this.db.prepare(`
+      SELECT
+        session_id as sessionId,
+        operation,
+        model,
+        input_tokens as inputTokens,
+        output_tokens as outputTokens,
+        estimated_cost_usd as estimatedCostUsd,
+        duration_ms as durationMs,
+        created_at as createdAt
+      FROM llm_costs
+      ORDER BY created_at DESC
+      LIMIT 20
+    `).all();
+        return {
+            today: querySummary(todayStart),
+            thisWeek: querySummary(weekStart),
+            thisMonth: querySummary(monthStart),
+            allTime: querySummary(),
+            byOperation,
+            byModel,
+            recentCalls,
+        };
+    }
+    /**
+     * Get costs for a specific session.
+     */
+    getSessionCosts(sessionId) {
+        if (!this.isInitialized || !this.db) {
+            return {
+                ...this.emptySummary(),
+                recentCalls: [],
+            };
+        }
+        const summary = this.db.prepare(`
+      SELECT
+        COUNT(*) as calls,
+        COALESCE(SUM(input_tokens), 0) as inputTokens,
+        COALESCE(SUM(output_tokens), 0) as outputTokens,
+        COALESCE(SUM(estimated_cost_usd), 0) as estimatedCostUsd
+      FROM llm_costs
+      WHERE session_id = ?
+    `).get(sessionId);
+        const recentCalls = this.db.prepare(`
+      SELECT
+        operation,
+        model,
+        input_tokens as inputTokens,
+        output_tokens as outputTokens,
+        estimated_cost_usd as estimatedCostUsd,
+        duration_ms as durationMs,
+        created_at as createdAt
+      FROM llm_costs
+      WHERE session_id = ?
+      ORDER BY created_at DESC
+      LIMIT 10
+    `).all(sessionId);
+        return {
+            calls: summary?.calls || 0,
+            inputTokens: summary?.inputTokens || 0,
+            outputTokens: summary?.outputTokens || 0,
+            totalTokens: (summary?.inputTokens || 0) + (summary?.outputTokens || 0),
+            estimatedCostUsd: summary?.estimatedCostUsd || 0,
+            recentCalls,
+        };
+    }
+    /**
+     * Get time-series data for charts.
+     * Returns costs aggregated by time bucket (minute, hour, or day).
+     */
+    getTimeSeries(options = {}) {
+        if (!this.isInitialized || !this.db) {
+            return [];
+        }
+        // Normalize ISO dates to SQLite format (YYYY-MM-DD HH:MM:SS)
+        const normalizeDate = (dateStr) => {
+            if (!dateStr)
+                return undefined;
+            // If it's already in SQLite format (has space, no T), return as-is
+            if (dateStr.includes(' ') && !dateStr.includes('T'))
+                return dateStr;
+            // Convert ISO format to SQLite format
+            const date = new Date(dateStr);
+            const pad = (n) => n.toString().padStart(2, '0');
+            return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())} ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}`;
+        };
+        const { bucket = 'hour', sessionId } = options;
+        const startDate = normalizeDate(options.startDate);
+        const endDate = normalizeDate(options.endDate);
+        // SQLite strftime format based on bucket
+        const formatMap = {
+            minute: '%Y-%m-%d %H:%M',
+            hour: '%Y-%m-%d %H:00',
+            day: '%Y-%m-%d',
+        };
+        const format = formatMap[bucket];
+        // Build WHERE clause
+        const conditions = [];
+        const params = [];
+        if (startDate) {
+            conditions.push('created_at >= ?');
+            params.push(startDate);
+        }
+        if (endDate) {
+            conditions.push('created_at <= ?');
+            params.push(endDate);
+        }
+        if (sessionId) {
+            conditions.push('session_id = ?');
+            params.push(sessionId);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const mainQuery = `
+      SELECT
+        strftime('${format}', created_at) as timestamp,
+        COUNT(*) as calls,
+        COALESCE(SUM(input_tokens), 0) as inputTokens,
+        COALESCE(SUM(output_tokens), 0) as outputTokens,
+        COALESCE(SUM(estimated_cost_usd), 0) as estimatedCostUsd
+      FROM llm_costs
+      ${whereClause}
+      GROUP BY strftime('${format}', created_at)
+      ORDER BY timestamp ASC
+    `;
+        const mainRows = this.db.prepare(mainQuery).all(...params);
+        const opQuery = `
+      SELECT
+        strftime('${format}', created_at) as timestamp,
+        operation,
+        COALESCE(SUM(estimated_cost_usd), 0) as cost
+      FROM llm_costs
+      ${whereClause}
+      GROUP BY strftime('${format}', created_at), operation
+      ORDER BY timestamp ASC
+    `;
+        const opRows = this.db.prepare(opQuery).all(...params);
+        // Build lookup for per-operation costs
+        const opLookup = {};
+        for (const row of opRows) {
+            if (!opLookup[row.timestamp]) {
+                opLookup[row.timestamp] = {};
+            }
+            opLookup[row.timestamp][row.operation] = row.cost;
+        }
+        // Combine results
+        return mainRows.map(row => ({
+            timestamp: row.timestamp,
+            calls: row.calls,
+            inputTokens: row.inputTokens,
+            outputTokens: row.outputTokens,
+            estimatedCostUsd: row.estimatedCostUsd,
+            byOperation: opLookup[row.timestamp] || {},
+        }));
+    }
+    emptySummary() {
+        return {
+            calls: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            totalTokens: 0,
+            estimatedCostUsd: 0,
+        };
+    }
+    emptySummaryResponse() {
+        const empty = this.emptySummary();
+        return {
+            today: empty,
+            thisWeek: empty,
+            thisMonth: empty,
+            allTime: empty,
+            byOperation: {},
+            byModel: {},
+            recentCalls: [],
+        };
+    }
+    /**
+     * Close the database connection.
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            this.isInitialized = false;
+        }
+    }
+}
+// Singleton instance
+let instance = null;
+export function getCostTracker() {
+    if (!instance) {
+        instance = new CostTracker();
+    }
+    return instance;
+}
+// For testing
+export function resetCostTracker() {
+    if (instance) {
+        instance.close();
+        instance = null;
+    }
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/services/infrastructure/cost-tracker.js.map

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

package/dist/services/infrastructure/file-system-service.d.ts

@@ -0,0 +1,61 @@
+import { FileSystemEntry } from '../../types/index.js';
+/**
+ * Service for secure file system operations
+ */
+export declare class FileSystemService {
+    private logger;
+    private maxFileSize;
+    private allowedBasePaths;
+    constructor(maxFileSize?: number, allowedBasePaths?: string[]);
+    /**
+     * List directory contents with security checks
+     */
+    listDirectory(requestedPath: string, recursive?: boolean, respectGitignore?: boolean): Promise<{
+        path: string;
+        entries: FileSystemEntry[];
+        total: number;
+    }>;
+    /**
+     * Read file contents with security checks
+     */
+    readFile(requestedPath: string): Promise<{
+        path: string;
+        content: string;
+        size: number;
+        lastModified: string;
+        encoding: string;
+    }>;
+    /**
+     * Validate and normalize a path to prevent path traversal attacks
+     */
+    private validatePath;
+    /**
+     * Check if content appears to be valid UTF-8 text
+     */
+    private isValidUtf8;
+    /**
+     * List directory contents without recursion
+     */
+    private listDirectoryFlat;
+    /**
+     * List directory contents recursively
+     */
+    private listDirectoryRecursive;
+    /**
+     * Load gitignore patterns from a directory and its parents
+     */
+    private loadGitignore;
+    /**
+     * Check if a directory is a git repository
+     */
+    isGitRepository(dirPath: string): Promise<boolean>;
+    /**
+     * Get current git HEAD commit hash
+     */
+    getCurrentGitHead(dirPath: string): Promise<string | null>;
+    /**
+     * Validate that an executable exists and has executable permissions
+     */
+    validateExecutable(executablePath: string): Promise<void>;
+}
+//# sourceMappingURL=file-system-service.d.ts.map

package/dist/services/infrastructure/file-system-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-service.d.ts","sourceRoot":"","sources":["../../../src/services/infrastructure/file-system-service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMjE;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,WAAW,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE;IAU7D;;OAEG;IACG,aAAa,CACjB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,OAAe,EAC1B,gBAAgB,GAAE,OAAe,GAChC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA6DvE;;OAEG;IACG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA2DvI;;OAEG;YACW,YAAY;IA2E1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;YACW,sBAAsB;IAuCpC;;OAEG;YACW,aAAa;IAuB3B;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxD;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUhE;;OAEG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsChE"}