@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/core/trace/trace-store.js

@@ -0,0 +1,345 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import {
+  TraceType
+} from "./types.js";
+import { logger } from "../monitoring/logger.js";
+class TraceStore {
+  db;
+  constructor(db) {
+    this.db = db;
+    this.initializeSchema();
+  }
+  /**
+   * Initialize database schema for traces
+   */
+  initializeSchema() {
+    const hasFramesTable = this.db.prepare(
+      `
+      SELECT name FROM sqlite_master 
+      WHERE type='table' AND name='frames'
+    `
+    ).get();
+    if (hasFramesTable) {
+      this.db.exec(`
+        CREATE TABLE IF NOT EXISTS traces (
+          id TEXT PRIMARY KEY,
+          type TEXT NOT NULL,
+          score REAL NOT NULL,
+          summary TEXT NOT NULL,
+          start_time INTEGER NOT NULL,
+          end_time INTEGER NOT NULL,
+          frame_id TEXT,
+          user_id TEXT,
+          files_modified TEXT,
+          errors_encountered TEXT,
+          decisions_recorded TEXT,
+          causal_chain INTEGER,
+          compressed_data TEXT,
+          created_at INTEGER DEFAULT (unixepoch()),
+          FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE SET NULL
+        )
+      `);
+    } else {
+      this.db.exec(`
+        CREATE TABLE IF NOT EXISTS traces (
+          id TEXT PRIMARY KEY,
+          type TEXT NOT NULL,
+          score REAL NOT NULL,
+          summary TEXT NOT NULL,
+          start_time INTEGER NOT NULL,
+          end_time INTEGER NOT NULL,
+          frame_id TEXT,
+          user_id TEXT,
+          files_modified TEXT,
+          errors_encountered TEXT,
+          decisions_recorded TEXT,
+          causal_chain INTEGER,
+          compressed_data TEXT,
+          created_at INTEGER DEFAULT (unixepoch())
+        )
+      `);
+    }
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS tool_calls (
+        id TEXT PRIMARY KEY,
+        trace_id TEXT NOT NULL,
+        tool TEXT NOT NULL,
+        arguments TEXT,
+        timestamp INTEGER NOT NULL,
+        result TEXT,
+        error TEXT,
+        files_affected TEXT,
+        duration INTEGER,
+        sequence_number INTEGER NOT NULL,
+        FOREIGN KEY (trace_id) REFERENCES traces(id) ON DELETE CASCADE
+      )
+    `);
+    this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_traces_type ON traces(type);
+      CREATE INDEX IF NOT EXISTS idx_traces_frame_id ON traces(frame_id);
+      CREATE INDEX IF NOT EXISTS idx_traces_start_time ON traces(start_time);
+      CREATE INDEX IF NOT EXISTS idx_traces_score ON traces(score);
+      CREATE INDEX IF NOT EXISTS idx_tool_calls_trace_id ON tool_calls(trace_id);
+      CREATE INDEX IF NOT EXISTS idx_tool_calls_timestamp ON tool_calls(timestamp);
+    `);
+  }
+  /**
+   * Save a trace to the database
+   */
+  saveTrace(trace) {
+    const traceStmt = this.db.prepare(`
+      INSERT OR REPLACE INTO traces (
+        id, type, score, summary, start_time, end_time,
+        frame_id, user_id, files_modified, errors_encountered,
+        decisions_recorded, causal_chain, compressed_data
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    const toolCallStmt = this.db.prepare(`
+      INSERT OR REPLACE INTO tool_calls (
+        id, trace_id, tool, arguments, timestamp, result,
+        error, files_affected, duration, sequence_number
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    try {
+      this.db.transaction(() => {
+        traceStmt.run(
+          trace.id,
+          trace.type,
+          trace.score,
+          trace.summary,
+          trace.metadata.startTime,
+          trace.metadata.endTime,
+          trace.metadata.frameId || null,
+          trace.metadata.userId || null,
+          JSON.stringify(trace.metadata.filesModified),
+          JSON.stringify(trace.metadata.errorsEncountered),
+          JSON.stringify(trace.metadata.decisionsRecorded),
+          trace.metadata.causalChain ? 1 : 0,
+          trace.compressed ? JSON.stringify(trace.compressed) : null
+        );
+        trace.tools.forEach((tool, index) => {
+          toolCallStmt.run(
+            tool.id,
+            trace.id,
+            tool.tool,
+            tool.arguments ? JSON.stringify(tool.arguments) : null,
+            tool.timestamp,
+            tool.result ? JSON.stringify(tool.result) : null,
+            tool.error || null,
+            tool.filesAffected ? JSON.stringify(tool.filesAffected) : null,
+            tool.duration || null,
+            index
+          );
+        });
+      })();
+      logger.debug(
+        `Saved trace ${trace.id} with ${trace.tools.length} tool calls`
+      );
+    } catch (error) {
+      logger.error(`Failed to save trace ${trace.id}:`, error);
+      throw error;
+    }
+  }
+  /**
+   * Load a trace by ID
+   */
+  getTrace(id) {
+    const traceRow = this.db.prepare(
+      `
+      SELECT * FROM traces WHERE id = ?
+    `
+    ).get(id);
+    if (!traceRow) {
+      return null;
+    }
+    const toolRows = this.db.prepare(
+      `
+      SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+    `
+    ).all(id);
+    return this.rowsToTrace(traceRow, toolRows);
+  }
+  /**
+   * Load all traces
+   */
+  getAllTraces() {
+    const traceRows = this.db.prepare(
+      `
+      SELECT * FROM traces ORDER BY start_time DESC
+    `
+    ).all();
+    return traceRows.map((traceRow) => {
+      const toolRows = this.db.prepare(
+        `
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `
+      ).all(traceRow.id);
+      return this.rowsToTrace(traceRow, toolRows);
+    });
+  }
+  /**
+   * Load traces by type
+   */
+  getTracesByType(type) {
+    const traceRows = this.db.prepare(
+      `
+      SELECT * FROM traces WHERE type = ? ORDER BY start_time DESC
+    `
+    ).all(type);
+    return traceRows.map((traceRow) => {
+      const toolRows = this.db.prepare(
+        `
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `
+      ).all(traceRow.id);
+      return this.rowsToTrace(traceRow, toolRows);
+    });
+  }
+  /**
+   * Load traces by frame
+   */
+  getTracesByFrame(frameId) {
+    const traceRows = this.db.prepare(
+      `
+      SELECT * FROM traces WHERE frame_id = ? ORDER BY start_time DESC
+    `
+    ).all(frameId);
+    return traceRows.map((traceRow) => {
+      const toolRows = this.db.prepare(
+        `
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `
+      ).all(traceRow.id);
+      return this.rowsToTrace(traceRow, toolRows);
+    });
+  }
+  /**
+   * Load high-importance traces
+   */
+  getHighImportanceTraces(minScore = 0.7) {
+    const traceRows = this.db.prepare(
+      `
+      SELECT * FROM traces WHERE score >= ? ORDER BY score DESC, start_time DESC
+    `
+    ).all(minScore);
+    return traceRows.map((traceRow) => {
+      const toolRows = this.db.prepare(
+        `
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `
+      ).all(traceRow.id);
+      return this.rowsToTrace(traceRow, toolRows);
+    });
+  }
+  /**
+   * Load error traces
+   */
+  getErrorTraces() {
+    const traceRows = this.db.prepare(
+      `
+      SELECT * FROM traces 
+      WHERE type = ? OR errors_encountered != '[]'
+      ORDER BY start_time DESC
+    `
+    ).all(TraceType.ERROR_RECOVERY);
+    return traceRows.map((traceRow) => {
+      const toolRows = this.db.prepare(
+        `
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `
+      ).all(traceRow.id);
+      return this.rowsToTrace(traceRow, toolRows);
+    });
+  }
+  /**
+   * Get trace statistics
+   */
+  getStatistics() {
+    const stats = this.db.prepare(
+      `
+      SELECT 
+        COUNT(*) as total,
+        AVG(score) as avg_score,
+        AVG((
+          SELECT COUNT(*) FROM tool_calls WHERE trace_id = traces.id
+        )) as avg_length,
+        SUM(CASE WHEN type = ? OR errors_encountered != '[]' THEN 1 ELSE 0 END) * 100.0 / COUNT(*) as error_rate
+      FROM traces
+    `
+    ).get(TraceType.ERROR_RECOVERY);
+    const typeStats = this.db.prepare(
+      `
+      SELECT type, COUNT(*) as count
+      FROM traces
+      GROUP BY type
+    `
+    ).all();
+    const tracesByType = {};
+    typeStats.forEach((row) => {
+      tracesByType[row.type] = row.count;
+    });
+    return {
+      totalTraces: stats.total || 0,
+      tracesByType,
+      averageScore: stats.avg_score || 0,
+      averageLength: stats.avg_length || 0,
+      errorRate: stats.error_rate || 0
+    };
+  }
+  /**
+   * Delete old traces
+   */
+  deleteOldTraces(olderThanMs) {
+    const cutoff = Date.now() - olderThanMs;
+    const result = this.db.prepare(
+      `
+      DELETE FROM traces WHERE start_time < ?
+    `
+    ).run(cutoff);
+    return result.changes;
+  }
+  /**
+   * Convert database rows to Trace object
+   */
+  rowsToTrace(traceRow, toolRows) {
+    const tools = toolRows.map((row) => ({
+      id: row.id,
+      tool: row.tool,
+      arguments: row.arguments ? JSON.parse(row.arguments) : void 0,
+      timestamp: row.timestamp,
+      result: row.result ? JSON.parse(row.result) : void 0,
+      error: row.error || void 0,
+      filesAffected: row.files_affected ? JSON.parse(row.files_affected) : void 0,
+      duration: row.duration || void 0
+    }));
+    const metadata = {
+      startTime: traceRow.start_time,
+      endTime: traceRow.end_time,
+      frameId: traceRow.frame_id || void 0,
+      userId: traceRow.user_id || void 0,
+      filesModified: JSON.parse(traceRow.files_modified || "[]"),
+      errorsEncountered: JSON.parse(traceRow.errors_encountered || "[]"),
+      decisionsRecorded: JSON.parse(traceRow.decisions_recorded || "[]"),
+      causalChain: traceRow.causal_chain === 1
+    };
+    const trace = {
+      id: traceRow.id,
+      type: traceRow.type,
+      tools,
+      score: traceRow.score,
+      summary: traceRow.summary,
+      metadata
+    };
+    if (traceRow.compressed_data) {
+      trace.compressed = JSON.parse(traceRow.compressed_data);
+    }
+    return trace;
+  }
+}
+export {
+  TraceStore
+};
+//# sourceMappingURL=trace-store.js.map

package/dist/src/core/trace/trace-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/trace/trace-store.ts"],
+  "sourcesContent": ["/**\n * Trace Store - Database persistence for traces\n */\n\nimport Database from 'better-sqlite3';\nimport {\n  Trace,\n  ToolCall,\n  TraceType,\n  TraceMetadata,\n  CompressedTrace,\n  CompressionStrategy,\n} from './types.js';\nimport { logger } from '../monitoring/logger.js';\n\nexport class TraceStore {\n  private db: Database.Database;\n\n  constructor(db: Database.Database) {\n    this.db = db;\n    this.initializeSchema();\n  }\n\n  /**\n   * Initialize database schema for traces\n   */\n  private initializeSchema(): void {\n    // Check if frames table exists (it may not in all contexts)\n    const hasFramesTable = this.db\n      .prepare(\n        `\n      SELECT name FROM sqlite_master \n      WHERE type='table' AND name='frames'\n    `\n      )\n      .get();\n\n    // Create traces table with optional foreign key\n    if (hasFramesTable) {\n      this.db.exec(`\n        CREATE TABLE IF NOT EXISTS traces (\n          id TEXT PRIMARY KEY,\n          type TEXT NOT NULL,\n          score REAL NOT NULL,\n          summary TEXT NOT NULL,\n          start_time INTEGER NOT NULL,\n          end_time INTEGER NOT NULL,\n          frame_id TEXT,\n          user_id TEXT,\n          files_modified TEXT,\n          errors_encountered TEXT,\n          decisions_recorded TEXT,\n          causal_chain INTEGER,\n          compressed_data TEXT,\n          created_at INTEGER DEFAULT (unixepoch()),\n          FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE SET NULL\n        )\n      `);\n    } else {\n      // Create without foreign key constraint\n      this.db.exec(`\n        CREATE TABLE IF NOT EXISTS traces (\n          id TEXT PRIMARY KEY,\n          type TEXT NOT NULL,\n          score REAL NOT NULL,\n          summary TEXT NOT NULL,\n          start_time INTEGER NOT NULL,\n          end_time INTEGER NOT NULL,\n          frame_id TEXT,\n          user_id TEXT,\n          files_modified TEXT,\n          errors_encountered TEXT,\n          decisions_recorded TEXT,\n          causal_chain INTEGER,\n          compressed_data TEXT,\n          created_at INTEGER DEFAULT (unixepoch())\n        )\n      `);\n    }\n\n    // Create tool_calls table\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS tool_calls (\n        id TEXT PRIMARY KEY,\n        trace_id TEXT NOT NULL,\n        tool TEXT NOT NULL,\n        arguments TEXT,\n        timestamp INTEGER NOT NULL,\n        result TEXT,\n        error TEXT,\n        files_affected TEXT,\n        duration INTEGER,\n        sequence_number INTEGER NOT NULL,\n        FOREIGN KEY (trace_id) REFERENCES traces(id) ON DELETE CASCADE\n      )\n    `);\n\n    // Create indexes\n    this.db.exec(`\n      CREATE INDEX IF NOT EXISTS idx_traces_type ON traces(type);\n      CREATE INDEX IF NOT EXISTS idx_traces_frame_id ON traces(frame_id);\n      CREATE INDEX IF NOT EXISTS idx_traces_start_time ON traces(start_time);\n      CREATE INDEX IF NOT EXISTS idx_traces_score ON traces(score);\n      CREATE INDEX IF NOT EXISTS idx_tool_calls_trace_id ON tool_calls(trace_id);\n      CREATE INDEX IF NOT EXISTS idx_tool_calls_timestamp ON tool_calls(timestamp);\n    `);\n  }\n\n  /**\n   * Save a trace to the database\n   */\n  saveTrace(trace: Trace): void {\n    const traceStmt = this.db.prepare(`\n      INSERT OR REPLACE INTO traces (\n        id, type, score, summary, start_time, end_time,\n        frame_id, user_id, files_modified, errors_encountered,\n        decisions_recorded, causal_chain, compressed_data\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n    `);\n\n    const toolCallStmt = this.db.prepare(`\n      INSERT OR REPLACE INTO tool_calls (\n        id, trace_id, tool, arguments, timestamp, result,\n        error, files_affected, duration, sequence_number\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n    `);\n\n    try {\n      this.db.transaction(() => {\n        // Save trace\n        traceStmt.run(\n          trace.id,\n          trace.type,\n          trace.score,\n          trace.summary,\n          trace.metadata.startTime,\n          trace.metadata.endTime,\n          trace.metadata.frameId || null,\n          trace.metadata.userId || null,\n          JSON.stringify(trace.metadata.filesModified),\n          JSON.stringify(trace.metadata.errorsEncountered),\n          JSON.stringify(trace.metadata.decisionsRecorded),\n          trace.metadata.causalChain ? 1 : 0,\n          trace.compressed ? JSON.stringify(trace.compressed) : null\n        );\n\n        // Save tool calls\n        trace.tools.forEach((tool, index) => {\n          toolCallStmt.run(\n            tool.id,\n            trace.id,\n            tool.tool,\n            tool.arguments ? JSON.stringify(tool.arguments) : null,\n            tool.timestamp,\n            tool.result ? JSON.stringify(tool.result) : null,\n            tool.error || null,\n            tool.filesAffected ? JSON.stringify(tool.filesAffected) : null,\n            tool.duration || null,\n            index\n          );\n        });\n      })();\n\n      logger.debug(\n        `Saved trace ${trace.id} with ${trace.tools.length} tool calls`\n      );\n    } catch (error: unknown) {\n      logger.error(`Failed to save trace ${trace.id}:`, error as Error);\n      throw error;\n    }\n  }\n\n  /**\n   * Load a trace by ID\n   */\n  getTrace(id: string): Trace | null {\n    const traceRow = this.db\n      .prepare(\n        `\n      SELECT * FROM traces WHERE id = ?\n    `\n      )\n      .get(id) as any;\n\n    if (!traceRow) {\n      return null;\n    }\n\n    const toolRows = this.db\n      .prepare(\n        `\n      SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number\n    `\n      )\n      .all(id) as any[];\n\n    return this.rowsToTrace(traceRow, toolRows);\n  }\n\n  /**\n   * Load all traces\n   */\n  getAllTraces(): Trace[] {\n    const traceRows = this.db\n      .prepare(\n        `\n      SELECT * FROM traces ORDER BY start_time DESC\n    `\n      )\n      .all() as any[];\n\n    return traceRows.map((traceRow) => {\n      const toolRows = this.db\n        .prepare(\n          `\n        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number\n      `\n        )\n        .all(traceRow.id) as any[];\n\n      return this.rowsToTrace(traceRow, toolRows);\n    });\n  }\n\n  /**\n   * Load traces by type\n   */\n  getTracesByType(type: TraceType): Trace[] {\n    const traceRows = this.db\n      .prepare(\n        `\n      SELECT * FROM traces WHERE type = ? ORDER BY start_time DESC\n    `\n      )\n      .all(type) as any[];\n\n    return traceRows.map((traceRow) => {\n      const toolRows = this.db\n        .prepare(\n          `\n        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number\n      `\n        )\n        .all(traceRow.id) as any[];\n\n      return this.rowsToTrace(traceRow, toolRows);\n    });\n  }\n\n  /**\n   * Load traces by frame\n   */\n  getTracesByFrame(frameId: string): Trace[] {\n    const traceRows = this.db\n      .prepare(\n        `\n      SELECT * FROM traces WHERE frame_id = ? ORDER BY start_time DESC\n    `\n      )\n      .all(frameId) as any[];\n\n    return traceRows.map((traceRow) => {\n      const toolRows = this.db\n        .prepare(\n          `\n        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number\n      `\n        )\n        .all(traceRow.id) as any[];\n\n      return this.rowsToTrace(traceRow, toolRows);\n    });\n  }\n\n  /**\n   * Load high-importance traces\n   */\n  getHighImportanceTraces(minScore: number = 0.7): Trace[] {\n    const traceRows = this.db\n      .prepare(\n        `\n      SELECT * FROM traces WHERE score >= ? ORDER BY score DESC, start_time DESC\n    `\n      )\n      .all(minScore) as any[];\n\n    return traceRows.map((traceRow) => {\n      const toolRows = this.db\n        .prepare(\n          `\n        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number\n      `\n        )\n        .all(traceRow.id) as any[];\n\n      return this.rowsToTrace(traceRow, toolRows);\n    });\n  }\n\n  /**\n   * Load error traces\n   */\n  getErrorTraces(): Trace[] {\n    const traceRows = this.db\n      .prepare(\n        `\n      SELECT * FROM traces \n      WHERE type = ? OR errors_encountered != '[]'\n      ORDER BY start_time DESC\n    `\n      )\n      .all(TraceType.ERROR_RECOVERY) as any[];\n\n    return traceRows.map((traceRow) => {\n      const toolRows = this.db\n        .prepare(\n          `\n        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number\n      `\n        )\n        .all(traceRow.id) as any[];\n\n      return this.rowsToTrace(traceRow, toolRows);\n    });\n  }\n\n  /**\n   * Get trace statistics\n   */\n  getStatistics(): {\n    totalTraces: number;\n    tracesByType: Record<string, number>;\n    averageScore: number;\n    averageLength: number;\n    errorRate: number;\n  } {\n    const stats = this.db\n      .prepare(\n        `\n      SELECT \n        COUNT(*) as total,\n        AVG(score) as avg_score,\n        AVG((\n          SELECT COUNT(*) FROM tool_calls WHERE trace_id = traces.id\n        )) as avg_length,\n        SUM(CASE WHEN type = ? OR errors_encountered != '[]' THEN 1 ELSE 0 END) * 100.0 / COUNT(*) as error_rate\n      FROM traces\n    `\n      )\n      .get(TraceType.ERROR_RECOVERY) as any;\n\n    const typeStats = this.db\n      .prepare(\n        `\n      SELECT type, COUNT(*) as count\n      FROM traces\n      GROUP BY type\n    `\n      )\n      .all() as any[];\n\n    const tracesByType: Record<string, number> = {};\n    typeStats.forEach((row) => {\n      tracesByType[row.type] = row.count;\n    });\n\n    return {\n      totalTraces: stats.total || 0,\n      tracesByType,\n      averageScore: stats.avg_score || 0,\n      averageLength: stats.avg_length || 0,\n      errorRate: stats.error_rate || 0,\n    };\n  }\n\n  /**\n   * Delete old traces\n   */\n  deleteOldTraces(olderThanMs: number): number {\n    const cutoff = Date.now() - olderThanMs;\n    const result = this.db\n      .prepare(\n        `\n      DELETE FROM traces WHERE start_time < ?\n    `\n      )\n      .run(cutoff);\n\n    return result.changes;\n  }\n\n  /**\n   * Convert database rows to Trace object\n   */\n  private rowsToTrace(traceRow: any, toolRows: any[]): Trace {\n    const tools: ToolCall[] = toolRows.map((row) => ({\n      id: row.id,\n      tool: row.tool,\n      arguments: row.arguments ? JSON.parse(row.arguments) : undefined,\n      timestamp: row.timestamp,\n      result: row.result ? JSON.parse(row.result) : undefined,\n      error: row.error || undefined,\n      filesAffected: row.files_affected\n        ? JSON.parse(row.files_affected)\n        : undefined,\n      duration: row.duration || undefined,\n    }));\n\n    const metadata: TraceMetadata = {\n      startTime: traceRow.start_time,\n      endTime: traceRow.end_time,\n      frameId: traceRow.frame_id || undefined,\n      userId: traceRow.user_id || undefined,\n      filesModified: JSON.parse(traceRow.files_modified || '[]'),\n      errorsEncountered: JSON.parse(traceRow.errors_encountered || '[]'),\n      decisionsRecorded: JSON.parse(traceRow.decisions_recorded || '[]'),\n      causalChain: traceRow.causal_chain === 1,\n    };\n\n    const trace: Trace = {\n      id: traceRow.id,\n      type: traceRow.type as TraceType,\n      tools,\n      score: traceRow.score,\n      summary: traceRow.summary,\n      metadata,\n    };\n\n    if (traceRow.compressed_data) {\n      trace.compressed = JSON.parse(traceRow.compressed_data);\n    }\n\n    return trace;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/trace/types.js

@@ -0,0 +1,77 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+var TraceType = /* @__PURE__ */ ((TraceType2) => {
+  TraceType2["SEARCH_DRIVEN"] = "search_driven";
+  TraceType2["ERROR_RECOVERY"] = "error_recovery";
+  TraceType2["FEATURE_IMPLEMENTATION"] = "feature_implementation";
+  TraceType2["REFACTORING"] = "refactoring";
+  TraceType2["TESTING"] = "testing";
+  TraceType2["EXPLORATION"] = "exploration";
+  TraceType2["DEBUGGING"] = "debugging";
+  TraceType2["DOCUMENTATION"] = "documentation";
+  TraceType2["BUILD_DEPLOY"] = "build_deploy";
+  TraceType2["UNKNOWN"] = "unknown";
+  return TraceType2;
+})(TraceType || {});
+const DEFAULT_TRACE_CONFIG = {
+  timeProximityMs: 3e4,
+  // 30 seconds
+  sameDirThreshold: true,
+  causalRelationship: true,
+  maxTraceSize: 50,
+  compressionThreshold: 24
+  // Compress after 24 hours
+};
+const TRACE_PATTERNS = [
+  {
+    pattern: ["search", "grep", "read", "edit"],
+    type: "search_driven" /* SEARCH_DRIVEN */,
+    description: "Search-driven code modification"
+  },
+  {
+    pattern: ["bash", "error", "edit", "bash"],
+    type: "error_recovery" /* ERROR_RECOVERY */,
+    description: "Error recovery sequence"
+  },
+  {
+    pattern: ["write", "edit", "test"],
+    type: "feature_implementation" /* FEATURE_IMPLEMENTATION */,
+    description: "New feature implementation"
+  },
+  {
+    pattern: ["read", "edit", "edit", "test"],
+    type: "refactoring" /* REFACTORING */,
+    description: "Code refactoring"
+  },
+  {
+    pattern: ["test", "bash", "test"],
+    type: "testing" /* TESTING */,
+    description: "Test execution and validation"
+  },
+  {
+    pattern: ["grep", "search", "read"],
+    type: "exploration" /* EXPLORATION */,
+    description: "Codebase exploration"
+  },
+  {
+    pattern: ["bash", "build", "deploy"],
+    type: "build_deploy" /* BUILD_DEPLOY */,
+    description: "Build and deployment"
+  }
+];
+var CompressionStrategy = /* @__PURE__ */ ((CompressionStrategy2) => {
+  CompressionStrategy2["SUMMARY_ONLY"] = "summary_only";
+  CompressionStrategy2["PATTERN_BASED"] = "pattern_based";
+  CompressionStrategy2["SELECTIVE"] = "selective";
+  CompressionStrategy2["FULL_COMPRESSION"] = "full_compression";
+  return CompressionStrategy2;
+})(CompressionStrategy || {});
+export {
+  CompressionStrategy,
+  DEFAULT_TRACE_CONFIG,
+  TRACE_PATTERNS,
+  TraceType
+};
+//# sourceMappingURL=types.js.map

package/dist/src/core/trace/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/trace/types.ts"],
+  "sourcesContent": ["/**\n * Types for Trace Detection and Bundling System\n */\n\nexport interface ToolCall {\n  id: string;\n  tool: string;\n  arguments?: Record<string, any>;\n  timestamp: number;\n  result?: any;\n  error?: string;\n  filesAffected?: string[];\n  duration?: number;\n}\n\nexport interface Trace {\n  id: string;\n  type: TraceType;\n  tools: ToolCall[];\n  score: number;\n  summary: string;\n  compressed?: CompressedTrace;\n  metadata: TraceMetadata;\n}\n\nexport interface CompressedTrace {\n  pattern: string; // e.g., \"search\u2192read\u2192edit\u2192test\"\n  summary: string; // e.g., \"Fixed auth bug via search-driven refactor\"\n  score: number;\n  toolCount: number;\n  duration: number;\n  timestamp: number;\n}\n\nexport interface TraceMetadata {\n  startTime: number;\n  endTime: number;\n  frameId?: string;\n  userId?: string;\n  filesModified: string[];\n  errorsEncountered: string[];\n  decisionsRecorded: string[];\n  causalChain: boolean; // Was this an error\u2192fix\u2192verify chain?\n}\n\nexport enum TraceType {\n  SEARCH_DRIVEN = 'search_driven',\n  ERROR_RECOVERY = 'error_recovery',\n  FEATURE_IMPLEMENTATION = 'feature_implementation',\n  REFACTORING = 'refactoring',\n  TESTING = 'testing',\n  EXPLORATION = 'exploration',\n  DEBUGGING = 'debugging',\n  DOCUMENTATION = 'documentation',\n  BUILD_DEPLOY = 'build_deploy',\n  UNKNOWN = 'unknown',\n}\n\nexport interface TraceBoundaryConfig {\n  timeProximityMs: number; // Max time between tools to be in same trace\n  sameDirThreshold: boolean; // Must operate on same directory?\n  causalRelationship: boolean; // Look for error\u2192fix patterns?\n  maxTraceSize: number; // Max number of tools in one trace\n  compressionThreshold: number; // Compress traces older than X hours\n}\n\nexport const DEFAULT_TRACE_CONFIG: TraceBoundaryConfig = {\n  timeProximityMs: 30000, // 30 seconds\n  sameDirThreshold: true,\n  causalRelationship: true,\n  maxTraceSize: 50,\n  compressionThreshold: 24, // Compress after 24 hours\n};\n\nexport interface TracePattern {\n  pattern: RegExp | string[];\n  type: TraceType;\n  description: string;\n}\n\n// Common patterns for trace type detection\nexport const TRACE_PATTERNS: TracePattern[] = [\n  {\n    pattern: ['search', 'grep', 'read', 'edit'],\n    type: TraceType.SEARCH_DRIVEN,\n    description: 'Search-driven code modification',\n  },\n  {\n    pattern: ['bash', 'error', 'edit', 'bash'],\n    type: TraceType.ERROR_RECOVERY,\n    description: 'Error recovery sequence',\n  },\n  {\n    pattern: ['write', 'edit', 'test'],\n    type: TraceType.FEATURE_IMPLEMENTATION,\n    description: 'New feature implementation',\n  },\n  {\n    pattern: ['read', 'edit', 'edit', 'test'],\n    type: TraceType.REFACTORING,\n    description: 'Code refactoring',\n  },\n  {\n    pattern: ['test', 'bash', 'test'],\n    type: TraceType.TESTING,\n    description: 'Test execution and validation',\n  },\n  {\n    pattern: ['grep', 'search', 'read'],\n    type: TraceType.EXPLORATION,\n    description: 'Codebase exploration',\n  },\n  {\n    pattern: ['bash', 'build', 'deploy'],\n    type: TraceType.BUILD_DEPLOY,\n    description: 'Build and deployment',\n  },\n];\n\nexport interface TraceScoringFactors {\n  toolScores: number[]; // Individual tool scores\n  hasDecisions: boolean;\n  hasErrors: boolean;\n  filesModifiedCount: number;\n  isPermanent: boolean;\n  referenceCount: number;\n}\n\n// Trace compression strategies\nexport enum CompressionStrategy {\n  SUMMARY_ONLY = 'summary_only', // Keep only summary and score\n  PATTERN_BASED = 'pattern_based', // Keep pattern and outcome\n  SELECTIVE = 'selective', // Keep high-score tools only\n  FULL_COMPRESSION = 'full_compression', // Maximum compression\n}\n"],
+  "mappings": ";;;;AA6CO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,4BAAyB;AACzB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,aAAU;AAVA,SAAAA;AAAA,GAAA;AAqBL,MAAM,uBAA4C;AAAA,EACvD,iBAAiB;AAAA;AAAA,EACjB,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,cAAc;AAAA,EACd,sBAAsB;AAAA;AACxB;AASO,MAAM,iBAAiC;AAAA,EAC5C;AAAA,IACE,SAAS,CAAC,UAAU,QAAQ,QAAQ,MAAM;AAAA,IAC1C,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,SAAS,CAAC,QAAQ,SAAS,QAAQ,MAAM;AAAA,IACzC,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,SAAS,CAAC,SAAS,QAAQ,MAAM;AAAA,IACjC,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,SAAS,CAAC,QAAQ,QAAQ,QAAQ,MAAM;AAAA,IACxC,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,SAAS,CAAC,QAAQ,QAAQ,MAAM;AAAA,IAChC,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,SAAS,CAAC,QAAQ,UAAU,MAAM;AAAA,IAClC,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,SAAS,CAAC,QAAQ,SAAS,QAAQ;AAAA,IACnC,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AACF;AAYO,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,kBAAe;AACf,EAAAA,qBAAA,mBAAgB;AAChB,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,sBAAmB;AAJT,SAAAA;AAAA,GAAA;",
+  "names": ["TraceType", "CompressionStrategy"]
+}

package/dist/src/core/types.js

@@ -0,0 +1,5 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/src/core/utils/async-mutex.js

@@ -0,0 +1,114 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+class AsyncMutex {
+  locked = false;
+  waiting = [];
+  lockHolder = null;
+  lockAcquiredAt = 0;
+  lockTimeout;
+  constructor(lockTimeoutMs = 3e5) {
+    this.lockTimeout = lockTimeoutMs;
+  }
+  /**
+   * Acquire the lock. Waits if already locked.
+   * Returns a release function that MUST be called when done.
+   */
+  async acquire(holder) {
+    if (this.locked && this.lockAcquiredAt > 0) {
+      const elapsed = Date.now() - this.lockAcquiredAt;
+      if (elapsed > this.lockTimeout) {
+        console.warn(
+          `[AsyncMutex] Stale lock detected (held by ${this.lockHolder} for ${elapsed}ms), forcing release`
+        );
+        this.forceRelease();
+      }
+    }
+    if (!this.locked) {
+      this.locked = true;
+      this.lockHolder = holder || "unknown";
+      this.lockAcquiredAt = Date.now();
+      return () => this.release();
+    }
+    return new Promise((resolve) => {
+      this.waiting.push(() => {
+        this.locked = true;
+        this.lockHolder = holder || "unknown";
+        this.lockAcquiredAt = Date.now();
+        resolve(() => this.release());
+      });
+    });
+  }
+  /**
+   * Try to acquire the lock without waiting
+   * Returns release function if acquired, null if already locked
+   */
+  tryAcquire(holder) {
+    if (this.locked && this.lockAcquiredAt > 0) {
+      const elapsed = Date.now() - this.lockAcquiredAt;
+      if (elapsed > this.lockTimeout) {
+        console.warn(
+          `[AsyncMutex] Stale lock detected (held by ${this.lockHolder} for ${elapsed}ms), forcing release`
+        );
+        this.forceRelease();
+      }
+    }
+    if (!this.locked) {
+      this.locked = true;
+      this.lockHolder = holder || "unknown";
+      this.lockAcquiredAt = Date.now();
+      return () => this.release();
+    }
+    return null;
+  }
+  release() {
+    const next = this.waiting.shift();
+    if (next) {
+      next();
+    } else {
+      this.locked = false;
+      this.lockHolder = null;
+      this.lockAcquiredAt = 0;
+    }
+  }
+  forceRelease() {
+    this.locked = false;
+    this.lockHolder = null;
+    this.lockAcquiredAt = 0;
+  }
+  /**
+   * Execute a function while holding the lock
+   */
+  async withLock(fn, holder) {
+    const release = await this.acquire(holder);
+    try {
+      return await fn();
+    } finally {
+      release();
+    }
+  }
+  /**
+   * Check if currently locked
+   */
+  isLocked() {
+    return this.locked;
+  }
+  /**
+   * Get current lock status
+   */
+  getStatus() {
+    return {
+      locked: this.locked,
+      holder: this.lockHolder,
+      acquiredAt: this.lockAcquiredAt,
+      waitingCount: this.waiting.length
+    };
+  }
+}
+const syncMutex = new AsyncMutex(3e5);
+export {
+  AsyncMutex,
+  syncMutex
+};
+//# sourceMappingURL=async-mutex.js.map

package/dist/src/core/utils/async-mutex.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/utils/async-mutex.ts"],
+  "sourcesContent": ["/**\n * Simple async mutex implementation for thread-safe operations\n * Prevents race conditions when multiple async operations compete for the same resource\n */\n\nexport class AsyncMutex {\n  private locked = false;\n  private waiting: Array<() => void> = [];\n  private lockHolder: string | null = null;\n  private lockAcquiredAt: number = 0;\n  private readonly lockTimeout: number;\n\n  constructor(lockTimeoutMs: number = 300000) {\n    // Default 5 minute timeout\n    this.lockTimeout = lockTimeoutMs;\n  }\n\n  /**\n   * Acquire the lock. Waits if already locked.\n   * Returns a release function that MUST be called when done.\n   */\n  async acquire(holder?: string): Promise<() => void> {\n    // Check for stale lock (lock timeout)\n    if (this.locked && this.lockAcquiredAt > 0) {\n      const elapsed = Date.now() - this.lockAcquiredAt;\n      if (elapsed > this.lockTimeout) {\n        console.warn(\n          `[AsyncMutex] Stale lock detected (held by ${this.lockHolder} for ${elapsed}ms), forcing release`\n        );\n        this.forceRelease();\n      }\n    }\n\n    if (!this.locked) {\n      this.locked = true;\n      this.lockHolder = holder || 'unknown';\n      this.lockAcquiredAt = Date.now();\n      return () => this.release();\n    }\n\n    // Wait for lock to be released\n    return new Promise((resolve) => {\n      this.waiting.push(() => {\n        this.locked = true;\n        this.lockHolder = holder || 'unknown';\n        this.lockAcquiredAt = Date.now();\n        resolve(() => this.release());\n      });\n    });\n  }\n\n  /**\n   * Try to acquire the lock without waiting\n   * Returns release function if acquired, null if already locked\n   */\n  tryAcquire(holder?: string): (() => void) | null {\n    // Check for stale lock\n    if (this.locked && this.lockAcquiredAt > 0) {\n      const elapsed = Date.now() - this.lockAcquiredAt;\n      if (elapsed > this.lockTimeout) {\n        console.warn(\n          `[AsyncMutex] Stale lock detected (held by ${this.lockHolder} for ${elapsed}ms), forcing release`\n        );\n        this.forceRelease();\n      }\n    }\n\n    if (!this.locked) {\n      this.locked = true;\n      this.lockHolder = holder || 'unknown';\n      this.lockAcquiredAt = Date.now();\n      return () => this.release();\n    }\n    return null;\n  }\n\n  private release(): void {\n    const next = this.waiting.shift();\n    if (next) {\n      next();\n    } else {\n      this.locked = false;\n      this.lockHolder = null;\n      this.lockAcquiredAt = 0;\n    }\n  }\n\n  private forceRelease(): void {\n    this.locked = false;\n    this.lockHolder = null;\n    this.lockAcquiredAt = 0;\n  }\n\n  /**\n   * Execute a function while holding the lock\n   */\n  async withLock<T>(fn: () => Promise<T>, holder?: string): Promise<T> {\n    const release = await this.acquire(holder);\n    try {\n      return await fn();\n    } finally {\n      release();\n    }\n  }\n\n  /**\n   * Check if currently locked\n   */\n  isLocked(): boolean {\n    return this.locked;\n  }\n\n  /**\n   * Get current lock status\n   */\n  getStatus(): {\n    locked: boolean;\n    holder: string | null;\n    acquiredAt: number;\n    waitingCount: number;\n  } {\n    return {\n      locked: this.locked,\n      holder: this.lockHolder,\n      acquiredAt: this.lockAcquiredAt,\n      waitingCount: this.waiting.length,\n    };\n  }\n}\n\n// Singleton instance for sync operations\nexport const syncMutex = new AsyncMutex(300000); // 5 minute timeout\n"],
+  "mappings": ";;;;AAKO,MAAM,WAAW;AAAA,EACd,SAAS;AAAA,EACT,UAA6B,CAAC;AAAA,EAC9B,aAA4B;AAAA,EAC5B,iBAAyB;AAAA,EAChB;AAAA,EAEjB,YAAY,gBAAwB,KAAQ;AAE1C,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAAQ,QAAsC;AAElD,QAAI,KAAK,UAAU,KAAK,iBAAiB,GAAG;AAC1C,YAAM,UAAU,KAAK,IAAI,IAAI,KAAK;AAClC,UAAI,UAAU,KAAK,aAAa;AAC9B,gBAAQ;AAAA,UACN,6CAA6C,KAAK,UAAU,QAAQ,OAAO;AAAA,QAC7E;AACA,aAAK,aAAa;AAAA,MACpB;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ;AAChB,WAAK,SAAS;AACd,WAAK,aAAa,UAAU;AAC5B,WAAK,iBAAiB,KAAK,IAAI;AAC/B,aAAO,MAAM,KAAK,QAAQ;AAAA,IAC5B;AAGA,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,WAAK,QAAQ,KAAK,MAAM;AACtB,aAAK,SAAS;AACd,aAAK,aAAa,UAAU;AAC5B,aAAK,iBAAiB,KAAK,IAAI;AAC/B,gBAAQ,MAAM,KAAK,QAAQ,CAAC;AAAA,MAC9B,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,WAAW,QAAsC;AAE/C,QAAI,KAAK,UAAU,KAAK,iBAAiB,GAAG;AAC1C,YAAM,UAAU,KAAK,IAAI,IAAI,KAAK;AAClC,UAAI,UAAU,KAAK,aAAa;AAC9B,gBAAQ;AAAA,UACN,6CAA6C,KAAK,UAAU,QAAQ,OAAO;AAAA,QAC7E;AACA,aAAK,aAAa;AAAA,MACpB;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ;AAChB,WAAK,SAAS;AACd,WAAK,aAAa,UAAU;AAC5B,WAAK,iBAAiB,KAAK,IAAI;AAC/B,aAAO,MAAM,KAAK,QAAQ;AAAA,IAC5B;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,UAAgB;AACtB,UAAM,OAAO,KAAK,QAAQ,MAAM;AAChC,QAAI,MAAM;AACR,WAAK;AAAA,IACP,OAAO;AACL,WAAK,SAAS;AACd,WAAK,aAAa;AAClB,WAAK,iBAAiB;AAAA,IACxB;AAAA,EACF;AAAA,EAEQ,eAAqB;AAC3B,SAAK,SAAS;AACd,SAAK,aAAa;AAClB,SAAK,iBAAiB;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,SAAY,IAAsB,QAA6B;AACnE,UAAM,UAAU,MAAM,KAAK,QAAQ,MAAM;AACzC,QAAI;AACF,aAAO,MAAM,GAAG;AAAA,IAClB,UAAE;AACA,cAAQ;AAAA,IACV;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,YAKE;AACA,WAAO;AAAA,MACL,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,YAAY,KAAK;AAAA,MACjB,cAAc,KAAK,QAAQ;AAAA,IAC7B;AAAA,EACF;AACF;AAGO,MAAM,YAAY,IAAI,WAAW,GAAM;",
+  "names": []
+}