claudia-orchestrator 0.1.0

package/dist/services/cost-tracker.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 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
+ */
+export type InsightOperationType = 'GENERATE' | 'PATCH' | 'REFRESH' | 'QUICK_CHECK' | 'MERGE_DECISION' | 'PROPOSITIONS' | 'FAST_PATCH';
+export interface LLMCallRecord {
+    sessionId: string;
+    operation: InsightOperationType;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    traceId?: string;
+}
+export interface CostSummary {
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    estimatedCostUsd: number;
+}
+export interface CostSummaryResponse {
+    today: CostSummary;
+    thisWeek: CostSummary;
+    thisMonth: CostSummary;
+    allTime: CostSummary;
+    byOperation: Record<string, CostSummary>;
+    byModel: Record<string, CostSummary>;
+    recentCalls: Array<{
+        sessionId: string;
+        operation: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        estimatedCostUsd: number;
+        durationMs: number;
+        createdAt: string;
+    }>;
+}
+export declare class CostTracker {
+    private logger;
+    private db;
+    private isInitialized;
+    private dbPath;
+    private configDir;
+    private insertStmt;
+    private summaryStmt;
+    constructor(testDbPath?: string);
+    initialize(): Promise<void>;
+    private prepareStatements;
+    /**
+     * Calculate cost in USD for a given model and token counts.
+     */
+    private calculateCost;
+    /**
+     * Log an LLM API call with its cost.
+     */
+    log(record: LLMCallRecord): void;
+    /**
+     * Get cost summary for different time periods.
+     */
+    getSummary(): CostSummaryResponse;
+    /**
+     * Get costs for a specific session.
+     */
+    getSessionCosts(sessionId: string): CostSummary & {
+        recentCalls: any[];
+    };
+    private emptySummary;
+    private emptySummaryResponse;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+}
+export declare function getCostTracker(): CostTracker;
+export declare function resetCostTracker(): void;
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/services/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/services/cost-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwBH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,CAAC;AAEvI,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,WAAW,EAAE,KAAK,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAG1B,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,WAAW,CAAmC;gBAE1C,UAAU,CAAC,EAAE,MAAM;IAYzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CjC,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAiChC;;OAEG;IACH,UAAU,IAAI,mBAAmB;IAiHjC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG;QAAE,WAAW,EAAE,GAAG,EAAE,CAAA;KAAE;IA2CxE,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd;AAKD,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAGD,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/services/cost-tracker.js

@@ -0,0 +1,335 @@
+/**
+ * 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 './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 },
+    // Legacy models (fallback)
+    'claude-3-haiku-20240307': { input: 0.25, output: 1.25 },
+};
+// 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();
+        }
+        const now = new Date();
+        const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate()).toISOString();
+        const weekStart = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString();
+        const monthStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString();
+        // 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,
+            };
+        };
+        // Query by operation
+        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,
+            };
+        }
+        // Query by model
+        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,
+            };
+        }
+        // Get recent calls for debugging/visibility
+        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,
+        };
+    }
+    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/cost-tracker.js.map

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

package/dist/services/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/file-system-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-service.d.ts","sourceRoot":"","sources":["../../src/services/file-system-service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAY,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAM7D;;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"}