@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/platform/state/db.d.ts

@@ -0,0 +1,76 @@
+export interface ToolCallRecord {
+    id: number;
+    tool: string;
+    args: string;
+    result: string;
+    status: 'ok' | 'error';
+    duration_ms: number;
+    tokens: number;
+    timestamp: number;
+}
+export interface TelemetryFilter {
+    tool?: string;
+    status?: 'ok' | 'error';
+    since?: number;
+    until?: number;
+    limit?: number;
+}
+export interface TelemetrySummary {
+    total_calls: number;
+    total_tokens: number;
+    total_errors: number;
+    total_duration_ms: number;
+    by_tool: Record<string, {
+        calls: number;
+        tokens: number;
+        errors: number;
+        avg_duration_ms: number;
+    }>;
+}
+/**
+ * TelemetryDB — in-memory (or file-backed) SQLite telemetry store via sql.js.
+ *
+ * Records tool calls with duration and token usage.
+ * Supports filtered queries, summary aggregation, and JSON/CSV export.
+ */
+export declare class TelemetryDB {
+    private db;
+    private dbPath;
+    private ready;
+    constructor(dbPath?: string);
+    /**
+     * Initialize the WASM SQLite database. Must be called before any other method.
+     */
+    init(): Promise<void>;
+    private createSchema;
+    /**
+     * Record a tool call.
+     */
+    recordToolCall(tool: string, args: Record<string, unknown>, result: Record<string, unknown>, duration: number, tokens: number): void;
+    /**
+     * Query tool call records with optional filters.
+     */
+    query(filter?: TelemetryFilter): ToolCallRecord[];
+    /**
+     * Get a summary of all tool call activity.
+     */
+    getSummary(): TelemetrySummary;
+    /**
+     * Export all records as JSON or CSV.
+     */
+    export(format?: 'json' | 'csv'): string;
+    /**
+     * Persist the database to disk (if a path was provided at construction).
+     * Returns true if saved, false if in-memory-only.
+     */
+    save(): Promise<boolean>;
+    /**
+     * Close the database, freeing WASM memory.
+     */
+    close(): void;
+    get isReady(): boolean;
+    private assertReady;
+    /** Type-safe accessor: call only from methods guarded by assertReady(). */
+    private get _db();
+}
+//# sourceMappingURL=db.d.ts.map

package/dist/_internal/platform/state/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/state/db.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrG;AAiBD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,CAAC,EAAE,MAAM;IAM3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,IAAI;IAiBP;;OAEG;IACH,KAAK,CAAC,MAAM,GAAE,eAAoB,GAAG,cAAc,EAAE;IAuCrD;;OAEG;IACH,UAAU,IAAI,gBAAgB;IA0C9B;;OAEG;IACH,MAAM,CAAC,MAAM,GAAE,MAAM,GAAG,KAAc,GAAG,MAAM;IAe/C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAoB9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,WAAW;IAMnB,2EAA2E;IAC3E,OAAO,KAAK,GAAG,GAEd;CACF"}

package/dist/_internal/platform/state/db.js

@@ -0,0 +1,220 @@
+import { mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+// ---------------------------------------------------------------------------
+// TelemetryDB
+// ---------------------------------------------------------------------------
+/**
+ * TelemetryDB — in-memory (or file-backed) SQLite telemetry store via sql.js.
+ *
+ * Records tool calls with duration and token usage.
+ * Supports filtered queries, summary aggregation, and JSON/CSV export.
+ */
+export class TelemetryDB {
+    db = null;
+    dbPath = null;
+    ready = false;
+    constructor(dbPath) {
+        if (dbPath) {
+            this.dbPath = dbPath;
+        }
+    }
+    /**
+     * Initialize the WASM SQLite database. Must be called before any other method.
+     */
+    async init() {
+        if (this.ready)
+            return;
+        try {
+            // Dynamic import to avoid top-level WASM load overhead
+            // @ts-ignore — sql.js ships no bundled type declarations
+            const initSqlJs = (await import('sql.js')).default;
+            const SQL = await initSqlJs();
+            if (this.dbPath && existsSync(this.dbPath)) {
+                // Load existing DB from disk
+                const { readFileSync } = await import('node:fs');
+                const data = readFileSync(this.dbPath);
+                this.db = new SQL.Database(data);
+                logger.info('TelemetryDB: loaded from disk', { path: this.dbPath });
+            }
+            else {
+                this.db = new SQL.Database();
+                logger.info('TelemetryDB: initialized in-memory');
+            }
+            this.createSchema();
+            this.ready = true;
+        }
+        catch (err) {
+            logger.error('TelemetryDB: failed to initialize', {
+                error: summarizeError(err),
+            });
+            throw err;
+        }
+    }
+    createSchema() {
+        this._db.run(`
+      CREATE TABLE IF NOT EXISTS tool_calls (
+        id          INTEGER PRIMARY KEY AUTOINCREMENT,
+        tool        TEXT    NOT NULL,
+        args        TEXT    NOT NULL DEFAULT '{}',
+        result      TEXT    NOT NULL DEFAULT '{}',
+        status      TEXT    NOT NULL DEFAULT 'ok',
+        duration_ms INTEGER NOT NULL DEFAULT 0,
+        tokens      INTEGER NOT NULL DEFAULT 0,
+        timestamp   INTEGER NOT NULL
+      )
+    `);
+        this._db.run(`CREATE INDEX IF NOT EXISTS idx_tool ON tool_calls(tool)`);
+        this._db.run(`CREATE INDEX IF NOT EXISTS idx_timestamp ON tool_calls(timestamp)`);
+        this._db.run(`CREATE INDEX IF NOT EXISTS idx_status ON tool_calls(status)`);
+    }
+    /**
+     * Record a tool call.
+     */
+    recordToolCall(tool, args, result, duration, tokens) {
+        this.assertReady();
+        const status = (result.success === false || result.error !== undefined) ? 'error' : 'ok';
+        this._db.run(`INSERT INTO tool_calls (tool, args, result, status, duration_ms, tokens, timestamp)\n        VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            tool,
+            JSON.stringify(args),
+            JSON.stringify(result),
+            status,
+            Math.round(duration),
+            Math.max(0, Math.round(tokens)),
+            Date.now(),
+        ]);
+    }
+    /**
+     * Query tool call records with optional filters.
+     */
+    query(filter = {}) {
+        this.assertReady();
+        const conditions = [];
+        const params = [];
+        if (filter.tool) {
+            conditions.push('tool = ?');
+            params.push(filter.tool);
+        }
+        if (filter.status) {
+            conditions.push('status = ?');
+            params.push(filter.status);
+        }
+        if (filter.since !== undefined) {
+            conditions.push('timestamp >= ?');
+            params.push(filter.since);
+        }
+        if (filter.until !== undefined) {
+            conditions.push('timestamp <= ?');
+            params.push(filter.until);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = filter.limit !== undefined ? `LIMIT ${filter.limit}` : '';
+        const sql = `SELECT * FROM tool_calls ${where} ORDER BY timestamp DESC ${limit}`;
+        const result = this._db.exec(sql, params);
+        if (!result.length)
+            return [];
+        const { columns, values } = result[0];
+        return values.map((row) => {
+            const obj = {};
+            columns.forEach((col, i) => { obj[col] = row[i]; });
+            // Safe cast: the SQL schema defines exactly the columns that
+            // ToolCallRecord expects, so the shape is guaranteed at the DB level.
+            return obj;
+        });
+    }
+    /**
+     * Get a summary of all tool call activity.
+     */
+    getSummary() {
+        this.assertReady();
+        const totalResult = this._db.exec(`SELECT COUNT(*) as total_calls,
+               COALESCE(SUM(tokens), 0) as total_tokens,
+               COALESCE(SUM(CASE WHEN status='error' THEN 1 ELSE 0 END), 0) as total_errors,
+               COALESCE(SUM(duration_ms), 0) as total_duration_ms
+        FROM tool_calls`);
+        let total_calls = 0, total_tokens = 0, total_errors = 0, total_duration_ms = 0;
+        if (totalResult.length > 0) {
+            const row = totalResult[0].values[0];
+            total_calls = row[0] ?? 0;
+            total_tokens = row[1] ?? 0;
+            total_errors = row[2] ?? 0;
+            total_duration_ms = row[3] ?? 0;
+        }
+        const byToolResult = this._db.exec(`SELECT tool,
+               COUNT(*) as calls,
+               COALESCE(SUM(tokens), 0) as tokens,
+               COALESCE(SUM(CASE WHEN status='error' THEN 1 ELSE 0 END), 0) as errors,
+               COALESCE(AVG(duration_ms), 0) as avg_duration_ms
+        FROM tool_calls
+        GROUP BY tool
+        ORDER BY calls DESC`);
+        const by_tool = {};
+        if (byToolResult.length > 0) {
+            for (const row of byToolResult[0].values) {
+                const [tool, calls, tokens, errors, avg_duration_ms] = row;
+                by_tool[tool] = { calls, tokens, errors, avg_duration_ms: Math.round(avg_duration_ms) };
+            }
+        }
+        return { total_calls, total_tokens, total_errors, total_duration_ms, by_tool };
+    }
+    /**
+     * Export all records as JSON or CSV.
+     */
+    export(format = 'json') {
+        this.assertReady();
+        const records = this.query({});
+        if (format === 'csv') {
+            const header = 'id,tool,status,duration_ms,tokens,timestamp';
+            const rows = records.map((r) => `${r.id},${JSON.stringify(r.tool)},${r.status},${r.duration_ms},${r.tokens},${r.timestamp}`);
+            return [header, ...rows].join('\n');
+        }
+        return JSON.stringify(records, null, 2);
+    }
+    /**
+     * Persist the database to disk (if a path was provided at construction).
+     * Returns true if saved, false if in-memory-only.
+     */
+    async save() {
+        this.assertReady();
+        if (!this.dbPath)
+            return false;
+        try {
+            const dir = join(this.dbPath, '..');
+            mkdirSync(dir, { recursive: true });
+            const data = this._db.export();
+            const { writeFileSync } = await import('node:fs');
+            writeFileSync(this.dbPath, Buffer.from(data));
+            logger.info('TelemetryDB: saved to disk', { path: this.dbPath });
+            return true;
+        }
+        catch (err) {
+            logger.error('TelemetryDB: failed to save', {
+                error: summarizeError(err),
+            });
+            return false;
+        }
+    }
+    /**
+     * Close the database, freeing WASM memory.
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            this.ready = false;
+        }
+    }
+    get isReady() {
+        return this.ready;
+    }
+    assertReady() {
+        if (!this.ready || this.db === null) {
+            throw new Error('TelemetryDB: not initialized — call init() first');
+        }
+    }
+    /** Type-safe accessor: call only from methods guarded by assertReady(). */
+    get _db() {
+        return this.db;
+    }
+}

package/dist/_internal/platform/state/file-cache.d.ts

@@ -0,0 +1,97 @@
+/**
+ * A cache entry tracking file read history and content state.
+ */
+export interface CacheEntry {
+    /** SHA-256 hash of the file content at last read/update. */
+    contentHash: string;
+    /** Stored content (only in with_content mode). */
+    content?: string;
+    lineCount: number;
+    byteSize: number;
+    firstReadAt: number;
+    lastReadAt: number;
+    readCount: number;
+    /** Estimated LLM tokens: Math.ceil(byteSize / 4). */
+    tokenEstimate: number;
+    /** Cumulative tokens saved by cache hits. */
+    tokensSaved: number;
+    /** OCC version counter — increments on every external modification. */
+    version: number;
+}
+export interface ConflictInfo {
+    yourVersion: number;
+    currentVersion: number;
+    diffSinceRead?: string;
+}
+export type CacheStatus = 'miss' | 'unchanged' | 'modified';
+/**
+ * FileStateCache — File state tracking with Optimistic Concurrency Control.
+ *
+ * Tracks files that have been read by tools/agents, detects external modifications,
+ * and provides conflict information for OCC workflows.
+ */
+export declare class FileStateCache {
+    private readonly mode;
+    private readonly maxMemoryBytes;
+    private cache;
+    private totalMemBytes;
+    private totalReads;
+    private cacheHits;
+    constructor(options?: {
+        mode?: 'hash_only' | 'with_content';
+        maxMemoryMB?: number;
+    });
+    /**
+     * Look up the current state of a file.
+     *
+     * - miss: file has never been cached
+     * - unchanged: content hash matches what we last saw
+     * - modified: content hash differs (external modification)
+     *
+     * In `with_content` mode, a unified diff is included when status is 'modified'.
+     */
+    lookup(filePath: string): {
+        status: CacheStatus;
+        entry?: CacheEntry;
+        diff?: string;
+    };
+    /**
+     * Record that a file was read or written by a tool/agent.
+     * Creates or updates the cache entry.
+     */
+    update(filePath: string, content: string, metadata?: {
+        tool?: string;
+        agent?: string;
+    }): void;
+    /**
+     * Check for an OCC conflict: has the file been modified since `expectedVersion`?
+     * Returns null if no conflict, or ConflictInfo if the version has advanced.
+     */
+    checkConflict(filePath: string, expectedVersion: number): ConflictInfo | null;
+    /**
+     * Remove a file from the cache.
+     */
+    invalidate(filePath: string): void;
+    /**
+     * Return cache statistics.
+     */
+    getStats(): {
+        uniqueFiles: number;
+        totalReads: number;
+        hitRate: number;
+        tokensSaved: number;
+        memoryMB: number;
+    };
+    /**
+     * Clear all cached entries.
+     */
+    clear(): void;
+    private hash;
+    private evictIfNeeded;
+}
+/**
+ * Generate a simple unified diff between two strings.
+ * Uses line-by-line LCS diff, not the Myers algorithm.
+ */
+export declare function unifiedDiff(oldContent: string, newContent: string, label: string, contextLines?: number): string;
+//# sourceMappingURL=file-cache.d.ts.map

package/dist/_internal/platform/state/file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/state/file-cache.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAW5D;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IASnF;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAiDpF;;;OAGG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI;IAmDP;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAW7E;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAcD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,aAAa;CAYtB;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,MAAM,CAQ3G"}