@timmeck/brain-core 2.36.37 → 2.36.39

package/dist/llm/middleware.js.map

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

package/dist/llm/structured-output.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Structured LLM Output — Typed ContentBlocks statt nur `{ text: string }`
+ *
+ * Inspiriert von LangChain's structured output parsing.
+ * Ermöglicht es, LLM-Antworten in typisierte Blöcke zu zerlegen:
+ * Text, Reasoning, Tool Calls, Citations, JSON.
+ */
+export interface TextBlock {
+    type: 'text';
+    content: string;
+}
+export interface ReasoningBlock {
+    type: 'reasoning';
+    content: string;
+}
+export interface ToolCallBlock {
+    type: 'tool_call';
+    toolName: string;
+    args: Record<string, unknown>;
+}
+export interface CitationBlock {
+    type: 'citation';
+    source: string;
+    quote: string;
+}
+export interface JsonBlock {
+    type: 'json';
+    data: unknown;
+}
+export type ContentBlock = TextBlock | ReasoningBlock | ToolCallBlock | CitationBlock | JsonBlock;
+export interface StructuredLLMResponse {
+    /** Full raw text (for backwards-compat) */
+    text: string;
+    /** Parsed content blocks */
+    blocks: ContentBlock[];
+    /** Token usage */
+    tokensUsed: number;
+    inputTokens: number;
+    outputTokens: number;
+    cached: boolean;
+    model: string;
+    durationMs: number;
+    provider: string;
+}
+/**
+ * Parse raw LLM output into structured ContentBlocks.
+ *
+ * Erkennt:
+ * - <thinking>...</thinking> → ReasoningBlock
+ * - <tool_call>{"name":"...","args":{...}}</tool_call> → ToolCallBlock
+ * - <citation source="...">...</citation> → CitationBlock
+ * - ```json ... ``` → JsonBlock
+ * - Alles andere → TextBlock
+ */
+export declare function parseStructuredOutput(raw: string): ContentBlock[];
+/**
+ * Extrahiert JSON aus einer LLM-Antwort.
+ * Versucht zuerst die gesamte Antwort als JSON zu parsen,
+ * dann sucht es nach ```json Code-Blöcken.
+ */
+export declare function extractJson<T = unknown>(raw: string): T | null;
+/**
+ * Validate parsed JSON against a simple schema (key presence check).
+ * Returns the data if valid, null otherwise.
+ */
+export declare function validateJsonSchema<T = unknown>(data: unknown, requiredKeys: string[]): T | null;
+/** Get all blocks of a specific type */
+export declare function getBlocks<T extends ContentBlock['type']>(blocks: ContentBlock[], type: T): Extract<ContentBlock, {
+    type: T;
+}>[];
+/** Get combined text from all TextBlocks */
+export declare function getTextContent(blocks: ContentBlock[]): string;
+/** Get all tool calls */
+export declare function getToolCalls(blocks: ContentBlock[]): ToolCallBlock[];
+/** Check if response contains reasoning */
+export declare function hasReasoning(blocks: ContentBlock[]): boolean;

package/dist/llm/structured-output.js

@@ -0,0 +1,153 @@
+/**
+ * Structured LLM Output — Typed ContentBlocks statt nur `{ text: string }`
+ *
+ * Inspiriert von LangChain's structured output parsing.
+ * Ermöglicht es, LLM-Antworten in typisierte Blöcke zu zerlegen:
+ * Text, Reasoning, Tool Calls, Citations, JSON.
+ */
+// ── Parsing ─────────────────────────────────────────────
+/**
+ * Parse raw LLM output into structured ContentBlocks.
+ *
+ * Erkennt:
+ * - <thinking>...</thinking> → ReasoningBlock
+ * - <tool_call>{"name":"...","args":{...}}</tool_call> → ToolCallBlock
+ * - <citation source="...">...</citation> → CitationBlock
+ * - ```json ... ``` → JsonBlock
+ * - Alles andere → TextBlock
+ */
+export function parseStructuredOutput(raw) {
+    if (!raw || raw.trim().length === 0)
+        return [];
+    const blocks = [];
+    let remaining = raw;
+    // Regex patterns for structured sections
+    const patterns = [
+        {
+            // <thinking>...</thinking>
+            regex: /<thinking>([\s\S]*?)<\/thinking>/,
+            handler: (m) => ({ type: 'reasoning', content: m[1].trim() }),
+        },
+        {
+            // <tool_call>{"name":"x","args":{...}}</tool_call>
+            regex: /<tool_call>([\s\S]*?)<\/tool_call>/,
+            handler: (m) => {
+                try {
+                    const parsed = JSON.parse(m[1].trim());
+                    return {
+                        type: 'tool_call',
+                        toolName: parsed.name ?? parsed.tool ?? 'unknown',
+                        args: parsed.args ?? parsed.arguments ?? parsed.input ?? {},
+                    };
+                }
+                catch {
+                    return { type: 'text', content: m[0] };
+                }
+            },
+        },
+        {
+            // <citation source="...">...</citation>
+            regex: /<citation\s+source="([^"]*)">([\s\S]*?)<\/citation>/,
+            handler: (m) => ({ type: 'citation', source: m[1], quote: m[2].trim() }),
+        },
+        {
+            // ```json ... ```
+            regex: /```json\s*\n([\s\S]*?)\n```/,
+            handler: (m) => {
+                try {
+                    return { type: 'json', data: JSON.parse(m[1].trim()) };
+                }
+                catch {
+                    return { type: 'text', content: m[0] };
+                }
+            },
+        },
+    ];
+    while (remaining.length > 0) {
+        // Find the earliest matching pattern
+        let earliest = null;
+        for (const p of patterns) {
+            const match = remaining.match(p.regex);
+            if (match && match.index !== undefined) {
+                if (!earliest || match.index < earliest.index) {
+                    earliest = { index: match.index, match, handler: p.handler };
+                }
+            }
+        }
+        if (!earliest) {
+            // No more patterns found — rest is text
+            const trimmed = remaining.trim();
+            if (trimmed.length > 0) {
+                blocks.push({ type: 'text', content: trimmed });
+            }
+            break;
+        }
+        // Text before the match
+        const before = remaining.slice(0, earliest.index).trim();
+        if (before.length > 0) {
+            blocks.push({ type: 'text', content: before });
+        }
+        // The matched block
+        blocks.push(earliest.handler(earliest.match));
+        // Continue after the match
+        remaining = remaining.slice(earliest.index + earliest.match[0].length);
+    }
+    return blocks;
+}
+// ── JSON Mode Helper ────────────────────────────────────
+/**
+ * Extrahiert JSON aus einer LLM-Antwort.
+ * Versucht zuerst die gesamte Antwort als JSON zu parsen,
+ * dann sucht es nach ```json Code-Blöcken.
+ */
+export function extractJson(raw) {
+    // Try full string
+    try {
+        return JSON.parse(raw.trim());
+    }
+    catch {
+        // Try code block
+        const match = raw.match(/```(?:json)?\s*\n([\s\S]*?)\n```/);
+        if (match) {
+            try {
+                return JSON.parse(match[1].trim());
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Validate parsed JSON against a simple schema (key presence check).
+ * Returns the data if valid, null otherwise.
+ */
+export function validateJsonSchema(data, requiredKeys) {
+    if (!data || typeof data !== 'object')
+        return null;
+    const obj = data;
+    for (const key of requiredKeys) {
+        if (!(key in obj))
+            return null;
+    }
+    return data;
+}
+// ── Block Helpers ────────────────────────────────────────
+/** Get all blocks of a specific type */
+export function getBlocks(blocks, type) {
+    return blocks.filter((b) => b.type === type);
+}
+/** Get combined text from all TextBlocks */
+export function getTextContent(blocks) {
+    return getBlocks(blocks, 'text').map(b => b.content).join('\n\n');
+}
+/** Get all tool calls */
+export function getToolCalls(blocks) {
+    return getBlocks(blocks, 'tool_call');
+}
+/** Check if response contains reasoning */
+export function hasReasoning(blocks) {
+    return blocks.some(b => b.type === 'reasoning');
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/llm/structured-output.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,2 @@
+export { TraceCollector, runTraceMigration } from './trace-collector.js';
+export type { Trace, Span, TraceTree, TraceStats, TraceListOptions, TraceCollectorStatus, } from './trace-collector.js';

package/dist/observability/index.js

@@ -0,0 +1,2 @@
+export { TraceCollector, runTraceMigration } from './trace-collector.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/observability/trace-collector.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Trace Collector — Observability für das Brain Ecosystem
+ *
+ * Inspiriert von OpenTelemetry / LangSmith Tracing.
+ * Erfasst Spans (Arbeitseinheiten) in hierarchischen Traces,
+ * speichert sie in SQLite und berechnet Latenz-Statistiken.
+ *
+ * Usage:
+ * ```typescript
+ * const traceId = collector.startTrace('research-cycle');
+ * const spanId = collector.startSpan(traceId, 'llm-call', { template: 'explain' });
+ * // ... do work ...
+ * collector.endSpan(spanId, { tokens: 150, cost: 0.001 });
+ * collector.endTrace(traceId);
+ * ```
+ */
+import type Database from 'better-sqlite3';
+export interface Trace {
+    id: string;
+    name: string;
+    status: 'running' | 'completed' | 'error';
+    startedAt: number;
+    endedAt: number | null;
+    durationMs: number | null;
+    spanCount: number;
+    totalTokens: number;
+    totalCost: number;
+    metadata: Record<string, unknown>;
+    error?: string;
+}
+export interface Span {
+    id: string;
+    traceId: string;
+    parentSpanId: string | null;
+    name: string;
+    status: 'running' | 'completed' | 'error';
+    startedAt: number;
+    endedAt: number | null;
+    durationMs: number | null;
+    tokens: number;
+    cost: number;
+    metadata: Record<string, unknown>;
+    error?: string;
+}
+export interface TraceTree {
+    trace: Trace;
+    spans: Span[];
+}
+export interface TraceStats {
+    totalTraces: number;
+    totalSpans: number;
+    totalTokens: number;
+    totalCost: number;
+    avgDurationMs: number;
+    p50DurationMs: number;
+    p99DurationMs: number;
+    tracesByName: Record<string, number>;
+    activeTraces: number;
+}
+export interface TraceListOptions {
+    limit?: number;
+    offset?: number;
+    name?: string;
+    status?: 'running' | 'completed' | 'error';
+    since?: number;
+}
+export interface TraceCollectorStatus {
+    totalTraces: number;
+    activeTraces: number;
+    totalSpans: number;
+    totalTokens: number;
+    totalCost: number;
+}
+export declare function runTraceMigration(db: Database.Database): void;
+export declare class TraceCollector {
+    private db;
+    private readonly log;
+    private stmtInsertTrace;
+    private stmtInsertSpan;
+    private stmtEndTrace;
+    private stmtEndSpan;
+    private stmtUpdateTraceStats;
+    constructor(db: Database.Database);
+    /** Start a new trace. Returns trace ID. */
+    startTrace(name: string, metadata?: Record<string, unknown>): string;
+    /** End a trace (complete or error). */
+    endTrace(traceId: string, error?: string): void;
+    /** Start a span within a trace. Returns span ID. */
+    startSpan(traceId: string, name: string, options?: {
+        parentSpanId?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    /** End a span with optional results. */
+    endSpan(spanId: string, result?: {
+        tokens?: number;
+        cost?: number;
+        error?: string;
+    }): void;
+    /** Get a single trace with all its spans. */
+    getTrace(traceId: string): TraceTree | null;
+    /** List traces with optional filters. */
+    listTraces(options?: TraceListOptions): Trace[];
+    /** Get aggregate statistics. */
+    getStats(): TraceStats;
+    /** Get collector status (lightweight). */
+    getStatus(): TraceCollectorStatus;
+    /** Delete traces older than maxAgeDays. Returns number pruned. */
+    prune(maxAgeDays?: number): number;
+    private mapTrace;
+    private mapSpan;
+}

package/dist/observability/trace-collector.js

@@ -0,0 +1,303 @@
+/**
+ * Trace Collector — Observability für das Brain Ecosystem
+ *
+ * Inspiriert von OpenTelemetry / LangSmith Tracing.
+ * Erfasst Spans (Arbeitseinheiten) in hierarchischen Traces,
+ * speichert sie in SQLite und berechnet Latenz-Statistiken.
+ *
+ * Usage:
+ * ```typescript
+ * const traceId = collector.startTrace('research-cycle');
+ * const spanId = collector.startSpan(traceId, 'llm-call', { template: 'explain' });
+ * // ... do work ...
+ * collector.endSpan(spanId, { tokens: 150, cost: 0.001 });
+ * collector.endTrace(traceId);
+ * ```
+ */
+import { randomUUID } from 'node:crypto';
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runTraceMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS workflow_traces (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'running',
+      started_at INTEGER NOT NULL,
+      ended_at INTEGER,
+      duration_ms INTEGER,
+      span_count INTEGER NOT NULL DEFAULT 0,
+      total_tokens INTEGER NOT NULL DEFAULT 0,
+      total_cost REAL NOT NULL DEFAULT 0,
+      metadata TEXT DEFAULT '{}',
+      error TEXT,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_traces_name ON workflow_traces(name);
+    CREATE INDEX IF NOT EXISTS idx_traces_status ON workflow_traces(status);
+    CREATE INDEX IF NOT EXISTS idx_traces_started ON workflow_traces(started_at);
+
+    CREATE TABLE IF NOT EXISTS trace_spans (
+      id TEXT PRIMARY KEY,
+      trace_id TEXT NOT NULL,
+      parent_span_id TEXT,
+      name TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'running',
+      started_at INTEGER NOT NULL,
+      ended_at INTEGER,
+      duration_ms INTEGER,
+      tokens INTEGER NOT NULL DEFAULT 0,
+      cost REAL NOT NULL DEFAULT 0,
+      metadata TEXT DEFAULT '{}',
+      error TEXT,
+      FOREIGN KEY (trace_id) REFERENCES workflow_traces(id) ON DELETE CASCADE
+    );
+    CREATE INDEX IF NOT EXISTS idx_spans_trace ON trace_spans(trace_id);
+    CREATE INDEX IF NOT EXISTS idx_spans_parent ON trace_spans(parent_span_id);
+  `);
+}
+// ── Collector ───────────────────────────────────────────
+export class TraceCollector {
+    db;
+    log = getLogger();
+    stmtInsertTrace;
+    stmtInsertSpan;
+    stmtEndTrace;
+    stmtEndSpan;
+    stmtUpdateTraceStats;
+    constructor(db) {
+        this.db = db;
+        runTraceMigration(db);
+        this.stmtInsertTrace = db.prepare(`INSERT INTO workflow_traces (id, name, status, started_at, metadata)
+       VALUES (?, ?, 'running', ?, ?)`);
+        this.stmtInsertSpan = db.prepare(`INSERT INTO trace_spans (id, trace_id, parent_span_id, name, status, started_at, metadata)
+       VALUES (?, ?, ?, ?, 'running', ?, ?)`);
+        this.stmtEndTrace = db.prepare(`UPDATE workflow_traces SET status = ?, ended_at = ?, duration_ms = ?, error = ?
+       WHERE id = ?`);
+        this.stmtEndSpan = db.prepare(`UPDATE trace_spans SET status = ?, ended_at = ?, duration_ms = ?, tokens = ?, cost = ?, error = ?
+       WHERE id = ?`);
+        this.stmtUpdateTraceStats = db.prepare(`UPDATE workflow_traces SET
+         span_count = (SELECT COUNT(*) FROM trace_spans WHERE trace_id = ?),
+         total_tokens = (SELECT COALESCE(SUM(tokens), 0) FROM trace_spans WHERE trace_id = ?),
+         total_cost = (SELECT COALESCE(SUM(cost), 0) FROM trace_spans WHERE trace_id = ?)
+       WHERE id = ?`);
+        this.log.debug('[TraceCollector] Initialized');
+    }
+    // ── Trace Lifecycle ─────────────────────────────────
+    /** Start a new trace. Returns trace ID. */
+    startTrace(name, metadata = {}) {
+        const id = randomUUID();
+        const now = Date.now();
+        try {
+            this.stmtInsertTrace.run(id, name, now, JSON.stringify(metadata));
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to start trace: ${e.message}`);
+        }
+        return id;
+    }
+    /** End a trace (complete or error). */
+    endTrace(traceId, error) {
+        const now = Date.now();
+        try {
+            const trace = this.db.prepare('SELECT started_at FROM workflow_traces WHERE id = ?').get(traceId);
+            const duration = trace ? now - trace.started_at : 0;
+            const status = error ? 'error' : 'completed';
+            // Update aggregate stats from spans
+            this.stmtUpdateTraceStats.run(traceId, traceId, traceId, traceId);
+            this.stmtEndTrace.run(status, now, duration, error ?? null, traceId);
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to end trace: ${e.message}`);
+        }
+    }
+    // ── Span Lifecycle ──────────────────────────────────
+    /** Start a span within a trace. Returns span ID. */
+    startSpan(traceId, name, options) {
+        const id = randomUUID();
+        const now = Date.now();
+        try {
+            this.stmtInsertSpan.run(id, traceId, options?.parentSpanId ?? null, name, now, JSON.stringify(options?.metadata ?? {}));
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to start span: ${e.message}`);
+        }
+        return id;
+    }
+    /** End a span with optional results. */
+    endSpan(spanId, result) {
+        const now = Date.now();
+        try {
+            const span = this.db.prepare('SELECT started_at FROM trace_spans WHERE id = ?').get(spanId);
+            const duration = span ? now - span.started_at : 0;
+            const status = result?.error ? 'error' : 'completed';
+            this.stmtEndSpan.run(status, now, duration, result?.tokens ?? 0, result?.cost ?? 0, result?.error ?? null, spanId);
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to end span: ${e.message}`);
+        }
+    }
+    // ── Queries ─────────────────────────────────────────
+    /** Get a single trace with all its spans. */
+    getTrace(traceId) {
+        try {
+            const row = this.db.prepare('SELECT * FROM workflow_traces WHERE id = ?').get(traceId);
+            if (!row)
+                return null;
+            const spans = this.db.prepare('SELECT * FROM trace_spans WHERE trace_id = ? ORDER BY started_at').all(traceId);
+            return {
+                trace: this.mapTrace(row),
+                spans: spans.map(s => this.mapSpan(s)),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List traces with optional filters. */
+    listTraces(options = {}) {
+        const { limit = 50, offset = 0, name, status, since } = options;
+        try {
+            const conditions = [];
+            const params = [];
+            if (name) {
+                conditions.push('name = ?');
+                params.push(name);
+            }
+            if (status) {
+                conditions.push('status = ?');
+                params.push(status);
+            }
+            if (since) {
+                conditions.push('started_at >= ?');
+                params.push(since);
+            }
+            const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+            const sql = `SELECT * FROM workflow_traces ${where} ORDER BY started_at DESC LIMIT ? OFFSET ?`;
+            params.push(limit, offset);
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map(r => this.mapTrace(r));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Get aggregate statistics. */
+    getStats() {
+        try {
+            const totals = this.db.prepare(`
+        SELECT
+          COUNT(*) as total_traces,
+          COALESCE(SUM(span_count), 0) as total_spans,
+          COALESCE(SUM(total_tokens), 0) as total_tokens,
+          COALESCE(SUM(total_cost), 0) as total_cost,
+          COALESCE(AVG(duration_ms), 0) as avg_duration
+        FROM workflow_traces
+        WHERE status != 'running'
+      `).get();
+            const active = this.db.prepare("SELECT COUNT(*) as count FROM workflow_traces WHERE status = 'running'").get();
+            // P50 / P99 from completed traces
+            const durations = this.db.prepare("SELECT duration_ms FROM workflow_traces WHERE status = 'completed' AND duration_ms IS NOT NULL ORDER BY duration_ms").all();
+            const p50 = durations.length > 0
+                ? durations[Math.floor(durations.length * 0.5)]?.duration_ms ?? 0
+                : 0;
+            const p99 = durations.length > 0
+                ? durations[Math.floor(durations.length * 0.99)]?.duration_ms ?? 0
+                : 0;
+            // Traces by name
+            const byName = this.db.prepare('SELECT name, COUNT(*) as count FROM workflow_traces GROUP BY name').all();
+            const tracesByName = {};
+            for (const row of byName) {
+                tracesByName[row.name] = row.count;
+            }
+            return {
+                totalTraces: totals.total_traces ?? 0,
+                totalSpans: totals.total_spans ?? 0,
+                totalTokens: totals.total_tokens ?? 0,
+                totalCost: totals.total_cost ?? 0,
+                avgDurationMs: Math.round(totals.avg_duration ?? 0),
+                p50DurationMs: p50,
+                p99DurationMs: p99,
+                tracesByName,
+                activeTraces: active.count,
+            };
+        }
+        catch {
+            return {
+                totalTraces: 0, totalSpans: 0, totalTokens: 0, totalCost: 0,
+                avgDurationMs: 0, p50DurationMs: 0, p99DurationMs: 0,
+                tracesByName: {}, activeTraces: 0,
+            };
+        }
+    }
+    /** Get collector status (lightweight). */
+    getStatus() {
+        try {
+            const row = this.db.prepare(`
+        SELECT
+          COUNT(*) as total,
+          SUM(CASE WHEN status = 'running' THEN 1 ELSE 0 END) as active,
+          COALESCE(SUM(span_count), 0) as spans,
+          COALESCE(SUM(total_tokens), 0) as tokens,
+          COALESCE(SUM(total_cost), 0) as cost
+        FROM workflow_traces
+      `).get();
+            return {
+                totalTraces: row.total ?? 0,
+                activeTraces: row.active ?? 0,
+                totalSpans: row.spans ?? 0,
+                totalTokens: row.tokens ?? 0,
+                totalCost: row.cost ?? 0,
+            };
+        }
+        catch {
+            return { totalTraces: 0, activeTraces: 0, totalSpans: 0, totalTokens: 0, totalCost: 0 };
+        }
+    }
+    /** Delete traces older than maxAgeDays. Returns number pruned. */
+    prune(maxAgeDays = 30) {
+        try {
+            const cutoff = Date.now() - maxAgeDays * 86_400_000;
+            // Delete spans first (FK constraint)
+            this.db.prepare('DELETE FROM trace_spans WHERE trace_id IN (SELECT id FROM workflow_traces WHERE started_at < ? AND status != ?)').run(cutoff, 'running');
+            const result = this.db.prepare('DELETE FROM workflow_traces WHERE started_at < ? AND status != ?').run(cutoff, 'running');
+            return result.changes;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ── Private ─────────────────────────────────────────
+    mapTrace(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            status: row.status,
+            startedAt: row.started_at,
+            endedAt: row.ended_at,
+            durationMs: row.duration_ms,
+            spanCount: row.span_count,
+            totalTokens: row.total_tokens,
+            totalCost: row.total_cost,
+            metadata: JSON.parse(row.metadata || '{}'),
+            error: row.error,
+        };
+    }
+    mapSpan(row) {
+        return {
+            id: row.id,
+            traceId: row.trace_id,
+            parentSpanId: row.parent_span_id,
+            name: row.name,
+            status: row.status,
+            startedAt: row.started_at,
+            endedAt: row.ended_at,
+            durationMs: row.duration_ms,
+            tokens: row.tokens,
+            cost: row.cost,
+            metadata: JSON.parse(row.metadata || '{}'),
+            error: row.error,
+        };
+    }
+}
+//# sourceMappingURL=trace-collector.js.map