observability-toolkit 1.3.0 → 1.5.0

package/README.md

@@ -21,10 +21,11 @@ claude mcp add observability-toolkit -- node ~/.claude/mcp-servers/observability
 | `obs_query_traces` | Query traces from local JSONL or SigNoz |
 | `obs_query_metrics` | Query metrics with aggregation support |
 | `obs_query_logs` | Query logs by severity, search text, trace ID |
+| `obs_query_llm_events` | Query LLM events with token usage and duration metrics |
 | `obs_health_check` | Check telemetry system health |
 | `obs_context_stats` | Get context window utilization stats |
 | `obs_get_trace_url` | Get SigNoz trace viewer URL (requires SigNoz) |
-| `obs_setup_claudeignore` | Add telemetry/ to .claudeignore |
+| `obs_setup_claudeignore` | Add entries to .claudeignore (telemetry, test files, coverage) |
 
 ## Configuration
 
@@ -44,8 +45,26 @@ The server works standalone with local JSONL files. SigNoz integration is option
 obs_query_traces({ backend: "local", limit: 10 })
 obs_query_traces({ traceId: "abc123..." })
 obs_query_traces({ serviceName: "claude-code", minDurationMs: 100 })
+obs_query_traces({ attributeFilter: { "agent.source_type": "lazy" } })
 ```
 
+### Filterable Attributes
+
+Use `attributeFilter` to query by span attributes:
+
+| Attribute | Values | Description |
+|-----------|--------|-------------|
+| `agent.type` | string | Agent name (e.g., "Explore", "auto-error-resolver") |
+| `agent.source_type` | `active`, `lazy`, `builtin`, `settings` | Where agent is defined |
+| `agent.category` | string | Agent category (e.g., "error-handling", "code") |
+| `plugin.name` | string | Skill/plugin name |
+| `plugin.source_type` | `active`, `lazy`, `settings` | Where skill is defined |
+| `plugin.category` | string | Skill category |
+| `mcp.server` | string | MCP server name |
+| `mcp.tool` | string | MCP tool name |
+| `builtin.tool` | string | Built-in tool name (Read, Write, Bash, etc.) |
+| `hook.type` | `agent`, `plugin`, `mcp`, `builtin` | Hook handler type |
+
 ### Query logs
 
 ```
@@ -61,6 +80,14 @@ obs_query_metrics({ metricName: "session.context.size" })
 obs_query_metrics({ metricName: "gen_ai.client.token.usage", aggregation: "sum" })
 ```
 
+### Query LLM events
+
+```
+obs_query_llm_events({})
+obs_query_llm_events({ model: "claude-opus-4-5", limit: 10 })
+obs_query_llm_events({ provider: "anthropic", startDate: "2026-01-28" })
+```
+
 ### Health check
 
 ```
@@ -85,17 +112,31 @@ obs_get_trace_url({ traceId: "abc123..." })
 ```
 obs_setup_claudeignore({})
 obs_setup_claudeignore({ dryRun: true })
-obs_setup_claudeignore({ entry: "telemetry/", path: "/path/to/.claudeignore" })
+obs_setup_claudeignore({ includeDefaults: false, entry: "custom/" })
+obs_setup_claudeignore({ entries: ["logs/", "tmp/", "*.bak"] })
 ```
 
+Default entries added when `includeDefaults: true` (default):
+- `telemetry/` - telemetry data
+- `*.test.ts` - TypeScript test files
+- `*.test.js` - JavaScript test files
+- `coverage/` - coverage reports
+
 ## Data Sources
 
 ### Local JSONL (Default)
 
-Reads telemetry data from `~/.claude/telemetry/`:
+Automatically scans multiple telemetry directories:
+- **Global**: `~/.claude/telemetry/` (always checked)
+- **Project-local**: `.claude/telemetry/`, `telemetry/`, `.telemetry/` (checked if they exist in cwd)
+
+This allows querying both global Claude Code telemetry and project-specific telemetry.
+
+File patterns:
 - `traces-YYYY-MM-DD.jsonl` - Trace spans
 - `logs-YYYY-MM-DD.jsonl` - Log records
 - `metrics-YYYY-MM-DD.jsonl` - Metric data points
+- `llm-events-YYYY-MM-DD.jsonl` - LLM events
 
 ### SigNoz Cloud (Optional)
 
@@ -112,7 +153,15 @@ Use `backend: "signoz"` in queries to explicitly use SigNoz, or `backend: "auto"
 cd ~/.claude/mcp-servers/observability-toolkit
 npm install
 npm run build
+npm test     # 617 tests
 npm run start
 ```
 
+## Documentation
+
+- [ROADMAP.md](docs/ROADMAP.md) - Improvement roadmap with priorities
+- [code-review.md](docs/code-review.md) - Code review findings
+- [security-audit.md](docs/security-audit.md) - Security audit report
+- [observability-audit.md](docs/observability-audit.md) - Observability best practices audit
+
 

package/dist/backends/index.d.ts

@@ -1,6 +1,25 @@
 /**
  * Backend interface for telemetry data sources
  */
+/**
+ * InstrumentationScope identifies the library/module that produced the telemetry
+ * https://opentelemetry.io/docs/specs/otel/common/
+ */
+export interface InstrumentationScope {
+    name: string;
+    version?: string;
+    schemaUrl?: string;
+}
+/**
+ * SpanLink connects a span to another span in the same or different trace.
+ * Used for batch processing, fan-out operations, or causal relationships.
+ * https://opentelemetry.io/docs/concepts/signals/traces/#span-links
+ */
+export interface SpanLink {
+    traceId: string;
+    spanId: string;
+    attributes?: Record<string, unknown>;
+}
 export interface TraceSpan {
     traceId: string;
     spanId: string;
@@ -14,51 +33,135 @@ export interface TraceSpan {
         code: number;
         message?: string;
     };
+    /** Human-readable status code: 'UNSET' (0), 'OK' (1), 'ERROR' (2) */
+    statusCode?: 'UNSET' | 'OK' | 'ERROR';
     attributes?: Record<string, unknown>;
     events?: Array<{
         name: string;
         timestamp: number;
         attributes?: Record<string, unknown>;
     }>;
+    /** SpanLinks connect this span to other spans in the same or different traces */
+    links?: SpanLink[];
+    /** InstrumentationScope identifies the library/module that produced this span */
+    instrumentationScope?: InstrumentationScope;
 }
 export interface LogRecord {
     timestamp: string;
     severity: string;
+    severityNumber?: number;
     body: string;
     traceId?: string;
     spanId?: string;
     attributes?: Record<string, unknown>;
+    /** InstrumentationScope identifies the library/module that produced this log */
+    instrumentationScope?: InstrumentationScope;
+    /** Extracted field values from JSON log body */
+    extractedFields?: Record<string, unknown>;
+}
+export interface HistogramBucket {
+    le: number;
+    count: number;
 }
+export interface HistogramData {
+    buckets: HistogramBucket[];
+    sum: number;
+    count: number;
+}
+/**
+ * Exemplar links a metric data point to a specific trace span.
+ * Useful for debugging high latency, errors, or other notable measurements.
+ * https://opentelemetry.io/docs/specs/otel/metrics/data-model/#exemplars
+ */
+export interface Exemplar {
+    timestamp: string;
+    value: number;
+    traceId?: string;
+    spanId?: string;
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Aggregation temporality for metrics
+ * https://opentelemetry.io/docs/specs/otel/metrics/data-model/#temporality
+ *
+ * - UNSPECIFIED: Temporality is unknown or not applicable
+ * - DELTA: Values represent change since last report (e.g., requests in the last minute)
+ * - CUMULATIVE: Values represent total since start (e.g., total requests since process start)
+ */
+export type AggregationTemporality = 'UNSPECIFIED' | 'DELTA' | 'CUMULATIVE';
 export interface MetricDataPoint {
     timestamp: string;
     name: string;
     value: number;
     unit?: string;
     attributes?: Record<string, unknown>;
+    histogram?: HistogramData;
+    exemplars?: Exemplar[];
+    aggregationTemporality?: AggregationTemporality;
 }
 export interface QueryOptions {
     startDate?: string;
     endDate?: string;
     limit?: number;
     offset?: number;
+    cursor?: string;
+}
+/**
+ * Paginated result wrapper for cursor-based pagination
+ */
+export interface PaginatedResult<T> {
+    data: T[];
+    nextCursor?: string;
+    hasMore: boolean;
+}
+export interface NumericFilterCondition {
+    attribute: string;
+    operator: 'gt' | 'gte' | 'lt' | 'lte' | 'eq';
+    value: number;
 }
 export interface TraceQueryOptions extends QueryOptions {
     traceId?: string;
     serviceName?: string;
     spanName?: string;
+    /** Filter spans by name using regex pattern */
+    spanNameRegex?: string;
     minDurationMs?: number;
     maxDurationMs?: number;
     attributeFilter?: Record<string, string | number | boolean>;
+    /** Exclude spans matching this name (substring match) */
+    excludeSpanName?: string;
+    /** Only include spans where these attributes exist */
+    attributeExists?: string[];
+    /** Exclude spans where these attributes exist */
+    attributeNotExists?: string[];
+    /** Numeric comparison filters for attributes */
+    numericFilter?: NumericFilterCondition[];
 }
 export interface LogQueryOptions extends QueryOptions {
     severity?: string;
     search?: string;
     traceId?: string;
+    /** Exclude logs containing this text (case-insensitive) */
+    excludeSearch?: string;
+    /** Only include logs where these attributes exist */
+    attributeExists?: string[];
+    /** Exclude logs where these attributes exist */
+    attributeNotExists?: string[];
+    /** Numeric comparison filters for attributes */
+    numericFilter?: NumericFilterCondition[];
+    /** Multiple search terms for boolean search */
+    searchTerms?: string[];
+    /** Boolean operator for searchTerms: 'AND' (all must match) or 'OR' (any can match). Defaults to 'AND' */
+    searchOperator?: 'AND' | 'OR';
+    /** JSON paths to extract from log body (e.g., ['user.id', 'request.method']) */
+    extractFields?: string[];
 }
 export interface MetricQueryOptions extends QueryOptions {
     metricName?: string;
-    aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
+    aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count' | 'p50' | 'p95' | 'p99' | 'rate';
     groupBy?: string[];
+    /** Time bucket size for grouping (e.g., '1m', '5m', '1h', '1d') */
+    timeBucket?: string;
 }
 export interface LLMEvent {
     timestamp: string;
@@ -71,6 +174,7 @@ export interface LLMEventQueryOptions extends QueryOptions {
     provider?: string;
     search?: string;
 }
+export type { OTLPTraceExport, OTLPLogExport, OTLPMetricExport, } from '../lib/otlp-export.js';
 export interface TelemetryBackend {
     name: string;
     queryTraces(options: TraceQueryOptions): Promise<TraceSpan[]>;
@@ -81,5 +185,8 @@ export interface TelemetryBackend {
         status: 'ok' | 'error';
         message?: string;
     }>;
+    exportTracesOTLP?(options: TraceQueryOptions): Promise<import('../lib/otlp-export.js').OTLPTraceExport>;
+    exportLogsOTLP?(options: LogQueryOptions): Promise<import('../lib/otlp-export.js').OTLPLogExport>;
+    exportMetricsOTLP?(options: MetricQueryOptions): Promise<import('../lib/otlp-export.js').OTLPMetricExport>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/backends/index.d.ts.map

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

package/dist/backends/local-jsonl-boolean-search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local-jsonl-boolean-search.test.d.ts.map

package/dist/backends/local-jsonl-boolean-search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-jsonl-boolean-search.test.d.ts","sourceRoot":"","sources":["../../src/backends/local-jsonl-boolean-search.test.ts"],"names":[],"mappings":""}

package/dist/backends/local-jsonl-boolean-search.test.js

@@ -0,0 +1,154 @@
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import * as assert from 'node:assert';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { LocalJsonlBackend } from './local-jsonl.js';
+/**
+ * Test utilities for creating temp test fixtures
+ */
+function createTempDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'local-jsonl-boolean-test-'));
+}
+function removeTempDir(dir) {
+    try {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+}
+function writeJsonlFile(filePath, data) {
+    const content = data.map(item => JSON.stringify(item)).join('\n');
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+function getTestDate() {
+    return new Date().toISOString().split('T')[0];
+}
+describe('LocalJsonlBackend Boolean Search', () => {
+    let tempDir;
+    let backend;
+    beforeEach(() => {
+        tempDir = createTempDir();
+        backend = new LocalJsonlBackend(tempDir);
+    });
+    afterEach(() => {
+        removeTempDir(tempDir);
+    });
+    describe('queryLogs with searchTerms', () => {
+        it('should filter logs with searchTerms AND operator (all terms must match)', async () => {
+            const today = getTestDate();
+            const mockLogs = [
+                { timestamp: '2026-01-28T10:00:00Z', body: 'Connection timeout error' },
+                { timestamp: '2026-01-28T10:01:00Z', body: 'Database query failed' },
+                { timestamp: '2026-01-28T10:02:00Z', body: 'Connection reset by peer' },
+                { timestamp: '2026-01-28T10:03:00Z', body: 'Timeout occurred during connection' },
+            ];
+            writeJsonlFile(path.join(tempDir, `logs-${today}.jsonl`), mockLogs);
+            const results = await backend.queryLogs({
+                searchTerms: ['connection', 'timeout'],
+                searchOperator: 'AND',
+            });
+            assert.strictEqual(results.length, 2);
+            assert.ok(results.every(l => l.body.toLowerCase().includes('connection') &&
+                l.body.toLowerCase().includes('timeout')));
+        });
+        it('should filter logs with searchTerms OR operator (any term can match)', async () => {
+            const today = getTestDate();
+            const mockLogs = [
+                { timestamp: '2026-01-28T10:00:00Z', body: 'Connection timeout error' },
+                { timestamp: '2026-01-28T10:01:00Z', body: 'Database query failed' },
+                { timestamp: '2026-01-28T10:02:00Z', body: 'Authentication error' },
+                { timestamp: '2026-01-28T10:03:00Z', body: 'Timeout occurred' },
+            ];
+            writeJsonlFile(path.join(tempDir, `logs-${today}.jsonl`), mockLogs);
+            const results = await backend.queryLogs({
+                searchTerms: ['connection', 'timeout'],
+                searchOperator: 'OR',
+            });
+            assert.strictEqual(results.length, 2);
+            assert.ok(results.every(l => l.body.toLowerCase().includes('connection') ||
+                l.body.toLowerCase().includes('timeout')));
+        });
+        it('should default to AND operator when searchOperator is not specified', async () => {
+            const today = getTestDate();
+            const mockLogs = [
+                { timestamp: '2026-01-28T10:00:00Z', body: 'Error during database connection' },
+                { timestamp: '2026-01-28T10:01:00Z', body: 'Error occurred' },
+                { timestamp: '2026-01-28T10:02:00Z', body: 'Database query successful' },
+                { timestamp: '2026-01-28T10:03:00Z', body: 'Connection error in database' },
+            ];
+            writeJsonlFile(path.join(tempDir, `logs-${today}.jsonl`), mockLogs);
+            // searchOperator defaults to 'AND'
+            const results = await backend.queryLogs({
+                searchTerms: ['error', 'database'],
+            });
+            assert.strictEqual(results.length, 2);
+            assert.ok(results.every(l => l.body.toLowerCase().includes('error') &&
+                l.body.toLowerCase().includes('database')));
+        });
+        it('should handle searchTerms with case-insensitive matching', async () => {
+            const today = getTestDate();
+            const mockLogs = [
+                { timestamp: '2026-01-28T10:00:00Z', body: 'ERROR: Connection FAILED' },
+                { timestamp: '2026-01-28T10:01:00Z', body: 'Warning: Process started' },
+                { timestamp: '2026-01-28T10:02:00Z', body: 'connection failed with error' },
+            ];
+            writeJsonlFile(path.join(tempDir, `logs-${today}.jsonl`), mockLogs);
+            const results = await backend.queryLogs({
+                searchTerms: ['ERROR', 'FAILED'],
+                searchOperator: 'AND',
+            });
+            assert.strictEqual(results.length, 2);
+        });
+        it('should handle empty searchTerms array', async () => {
+            const today = getTestDate();
+            const mockLogs = [
+                { timestamp: '2026-01-28T10:00:00Z', body: 'Log message 1' },
+                { timestamp: '2026-01-28T10:01:00Z', body: 'Log message 2' },
+            ];
+            writeJsonlFile(path.join(tempDir, `logs-${today}.jsonl`), mockLogs);
+            // Empty array should not filter anything
+            const results = await backend.queryLogs({
+                searchTerms: [],
+            });
+            assert.strictEqual(results.length, 2);
+        });
+        it('should combine search and searchTerms filters', async () => {
+            const today = getTestDate();
+            const mockLogs = [
+                { timestamp: '2026-01-28T10:00:00Z', body: 'Connection error timeout' },
+                { timestamp: '2026-01-28T10:01:00Z', body: 'Connection timeout' },
+                { timestamp: '2026-01-28T10:02:00Z', body: 'Database error timeout' },
+                { timestamp: '2026-01-28T10:03:00Z', body: 'Connection established' },
+            ];
+            writeJsonlFile(path.join(tempDir, `logs-${today}.jsonl`), mockLogs);
+            // Both single search and searchTerms should apply
+            const results = await backend.queryLogs({
+                search: 'connection',
+                searchTerms: ['error', 'timeout'],
+                searchOperator: 'OR',
+            });
+            // Must contain 'connection' AND (contain 'error' OR 'timeout')
+            assert.strictEqual(results.length, 2);
+            assert.ok(results.every(l => l.body.toLowerCase().includes('connection') &&
+                (l.body.toLowerCase().includes('error') || l.body.toLowerCase().includes('timeout'))));
+        });
+        it('should handle single searchTerm as AND operator', async () => {
+            const today = getTestDate();
+            const mockLogs = [
+                { timestamp: '2026-01-28T10:00:00Z', body: 'Error occurred' },
+                { timestamp: '2026-01-28T10:01:00Z', body: 'Warning: Process started' },
+                { timestamp: '2026-01-28T10:02:00Z', body: 'Error: Connection failed' },
+            ];
+            writeJsonlFile(path.join(tempDir, `logs-${today}.jsonl`), mockLogs);
+            const results = await backend.queryLogs({
+                searchTerms: ['error'],
+                searchOperator: 'AND',
+            });
+            assert.strictEqual(results.length, 2);
+            assert.ok(results.every(l => l.body.toLowerCase().includes('error')));
+        });
+    });
+});
+//# sourceMappingURL=local-jsonl-boolean-search.test.js.map

package/dist/backends/local-jsonl-boolean-search.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-jsonl-boolean-search.test.js","sourceRoot":"","sources":["../../src/backends/local-jsonl-boolean-search.test.ts"],"names":[],"mappings":"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"}

package/dist/backends/local-jsonl.d.ts

@@ -4,19 +4,90 @@
  * The local telemetry files use a flat JSONL format where each line is a complete
  * span or log record, not the batched OpenTelemetry export format.
  */
-import { TelemetryBackend, TraceSpan, LogRecord, MetricDataPoint, LLMEvent, TraceQueryOptions, LogQueryOptions, MetricQueryOptions, LLMEventQueryOptions } from './index.js';
+import { TelemetryBackend, TraceSpan, LogRecord, MetricDataPoint, LLMEvent, TraceQueryOptions, LogQueryOptions, MetricQueryOptions, LLMEventQueryOptions, OTLPTraceExport, OTLPLogExport, OTLPMetricExport } from './index.js';
 export declare class LocalJsonlBackend implements TelemetryBackend {
     name: string;
     private telemetryDir;
-    constructor(telemetryDir?: string);
+    private traceCache;
+    private logCache;
+    private metricCache;
+    private llmEventCache;
+    private useIndexes;
+    constructor(telemetryDir?: string, useIndexes?: boolean);
+    /**
+     * Clear all query caches
+     */
+    clearCache(): void;
+    /**
+     * Try to use an index for a file, returning matching line numbers or null if full scan needed
+     */
+    private tryUseIndex;
     queryTraces(options: TraceQueryOptions): Promise<TraceSpan[]>;
     queryLogs(options: LogQueryOptions): Promise<LogRecord[]>;
     queryMetrics(options: MetricQueryOptions): Promise<MetricDataPoint[]>;
     private aggregate;
+    private calculatePercentile;
+    /**
+     * Calculate rate of change per second.
+     * Rate = (last_value - first_value) / duration_in_seconds
+     * Edge cases: single value returns 0, same timestamp returns 0
+     */
+    private calculateRate;
     queryLLMEvents(options: LLMEventQueryOptions): Promise<LLMEvent[]>;
     healthCheck(): Promise<{
         status: 'ok' | 'error';
         message?: string;
     }>;
+    /**
+     * Export traces in OTLP JSON format
+     */
+    exportTracesOTLP(options: TraceQueryOptions): Promise<OTLPTraceExport>;
+    /**
+     * Export logs in OTLP JSON format
+     */
+    exportLogsOTLP(options: LogQueryOptions): Promise<OTLPLogExport>;
+    /**
+     * Export metrics in OTLP JSON format
+     */
+    exportMetricsOTLP(options: MetricQueryOptions): Promise<OTLPMetricExport>;
+}
+/**
+ * Multi-directory backend that queries all telemetry directories
+ * (global ~/.claude/telemetry + local project directories)
+ */
+export declare class MultiDirectoryBackend implements TelemetryBackend {
+    name: string;
+    private backends;
+    private directories;
+    constructor(cwd?: string, useIndexes?: boolean);
+    getDirectories(): Array<{
+        path: string;
+        source: 'global' | 'local';
+    }>;
+    queryTraces(options: TraceQueryOptions): Promise<TraceSpan[]>;
+    queryLogs(options: LogQueryOptions): Promise<LogRecord[]>;
+    queryMetrics(options: MetricQueryOptions): Promise<MetricDataPoint[]>;
+    queryLLMEvents(options: LLMEventQueryOptions): Promise<LLMEvent[]>;
+    healthCheck(): Promise<{
+        status: 'ok' | 'error';
+        message?: string;
+        directories?: Array<{
+            path: string;
+            source: string;
+            status: string;
+        }>;
+    }>;
+    /**
+     * Export traces in OTLP JSON format
+     */
+    exportTracesOTLP(options: TraceQueryOptions): Promise<OTLPTraceExport>;
+    /**
+     * Export logs in OTLP JSON format
+     */
+    exportLogsOTLP(options: LogQueryOptions): Promise<OTLPLogExport>;
+    /**
+     * Export metrics in OTLP JSON format
+     */
+    exportMetricsOTLP(options: MetricQueryOptions): Promise<OTLPMetricExport>;
 }
 //# sourceMappingURL=local-jsonl.d.ts.map

package/dist/backends/local-jsonl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-jsonl.d.ts","sourceRoot":"","sources":["../../src/backends/local-jsonl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA8KpB,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,IAAI,SAAiB;IACrB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAI3B,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoD7D,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoCzD,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyC3E,OAAO,CAAC,SAAS;IAyDX,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAiDlE,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CA6B3E"}
+{"version":3,"file":"local-jsonl.d.ts","sourceRoot":"","sources":["../../src/backends/local-jsonl.ts"],"names":[],"mappings":"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"}