context-lens 0.3.2 → 0.4.1

package/dist/proxy/routing.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Request routing for the proxy.
+ *
+ * Detects which LLM provider a request targets, extracts source tool tags,
+ * and resolves the upstream URL. Zero external dependencies.
+ */
+export type Provider = "anthropic" | "openai" | "chatgpt" | "gemini" | "unknown";
+export type ApiFormat = "anthropic-messages" | "chatgpt-backend" | "responses" | "chat-completions" | "gemini" | "raw" | "unknown";
+export interface Upstreams {
+    openai: string;
+    anthropic: string;
+    chatgpt: string;
+    gemini: string;
+    geminiCodeAssist: string;
+}
+export interface ExtractSourceResult {
+    source: string | null;
+    cleanPath: string;
+}
+export interface ResolveTargetResult {
+    targetUrl: string;
+    provider: Provider;
+}
+/**
+ * Classify an incoming request into `{ provider, apiFormat }`.
+ *
+ * All path/format heuristics live here to avoid drift between
+ * routing and detection.
+ */
+export declare function classifyRequest(pathname: string, headers: Record<string, string | undefined>): {
+    provider: Provider;
+    apiFormat: ApiFormat;
+};
+/**
+ * Extract a "source tool" tag from a request path.
+ *
+ * Example: `/claude/v1/messages` => `{ source: 'claude', cleanPath: '/v1/messages' }`.
+ */
+export declare function extractSource(pathname: string): ExtractSourceResult;
+/**
+ * Determine the final upstream target URL for a request.
+ */
+export declare function resolveTargetUrl(pathname: string, search: string | null, headers: Record<string, string | undefined>, upstreams: Upstreams): ResolveTargetResult;
+//# sourceMappingURL=routing.d.ts.map

package/dist/proxy/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/proxy/routing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,SAAS,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,WAAW,GACX,kBAAkB,GAClB,QAAQ,GACR,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAsBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC1C;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAiC9C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAmBnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC3C,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAsBrB"}

package/dist/proxy/routing.js

@@ -0,0 +1,114 @@
+/**
+ * Request routing for the proxy.
+ *
+ * Detects which LLM provider a request targets, extracts source tool tags,
+ * and resolves the upstream URL. Zero external dependencies.
+ */
+// --- Implementation ---
+/**
+ * URL path segments that represent API resources rather than "source tool" prefixes.
+ *
+ * Example: `/v1/messages` should not treat `v1` as a source tag.
+ */
+const API_PATH_SEGMENTS = new Set([
+    "v1",
+    "v1beta",
+    "v1alpha",
+    "v1internal",
+    "responses",
+    "chat",
+    "models",
+    "embeddings",
+    "backend-api",
+    "api",
+]);
+/**
+ * Classify an incoming request into `{ provider, apiFormat }`.
+ *
+ * All path/format heuristics live here to avoid drift between
+ * routing and detection.
+ */
+export function classifyRequest(pathname, headers) {
+    // ChatGPT backend traffic (Codex subscription)
+    if (pathname.match(/^\/(api|backend-api)\//))
+        return { provider: "chatgpt", apiFormat: "chatgpt-backend" };
+    // Anthropic Messages API
+    if (pathname.includes("/v1/messages"))
+        return { provider: "anthropic", apiFormat: "anthropic-messages" };
+    if (pathname.includes("/v1/complete"))
+        return { provider: "anthropic", apiFormat: "unknown" };
+    if (headers["anthropic-version"])
+        return { provider: "anthropic", apiFormat: "unknown" };
+    // Gemini: must come BEFORE openai catch-all (which matches /models/)
+    const isGeminiPath = pathname.includes(":generateContent") ||
+        pathname.includes(":streamGenerateContent") ||
+        pathname.match(/\/v1(beta|alpha)\/models\//) ||
+        pathname.includes("/v1internal:");
+    if (isGeminiPath || headers["x-goog-api-key"])
+        return { provider: "gemini", apiFormat: "gemini" };
+    // OpenAI
+    if (pathname.includes("/responses"))
+        return { provider: "openai", apiFormat: "responses" };
+    if (pathname.includes("/chat/completions"))
+        return { provider: "openai", apiFormat: "chat-completions" };
+    if (pathname.match(/\/(models|embeddings)/))
+        return { provider: "openai", apiFormat: "unknown" };
+    if (headers.authorization?.startsWith("Bearer sk-"))
+        return { provider: "openai", apiFormat: "unknown" };
+    return { provider: "unknown", apiFormat: "unknown" };
+}
+/**
+ * Extract a "source tool" tag from a request path.
+ *
+ * Example: `/claude/v1/messages` => `{ source: 'claude', cleanPath: '/v1/messages' }`.
+ */
+export function extractSource(pathname) {
+    const match = pathname.match(/^\/([^/]+)(\/.*)?$/);
+    if (match?.[2] && !API_PATH_SEGMENTS.has(match[1])) {
+        let decoded = match[1];
+        try {
+            decoded = decodeURIComponent(match[1]);
+        }
+        catch {
+            decoded = match[1];
+        }
+        if (decoded.includes("/") ||
+            decoded.includes("\\") ||
+            decoded.includes("..")) {
+            return { source: null, cleanPath: pathname };
+        }
+        return { source: decoded, cleanPath: match[2] || "/" };
+    }
+    return { source: null, cleanPath: pathname };
+}
+/**
+ * Determine the final upstream target URL for a request.
+ */
+export function resolveTargetUrl(pathname, search, headers, upstreams) {
+    const provider = classifyRequest(pathname, headers).provider;
+    const qs = search || "";
+    let targetUrl = headers["x-target-url"];
+    if (!targetUrl) {
+        if (provider === "chatgpt") {
+            targetUrl = upstreams.chatgpt + pathname + qs;
+        }
+        else if (provider === "anthropic") {
+            targetUrl = upstreams.anthropic + pathname + qs;
+        }
+        else if (provider === "gemini") {
+            const isCodeAssist = pathname.includes("/v1internal");
+            targetUrl =
+                (isCodeAssist ? upstreams.geminiCodeAssist : upstreams.gemini) +
+                    pathname +
+                    qs;
+        }
+        else {
+            targetUrl = upstreams.openai + pathname + qs;
+        }
+    }
+    else if (!targetUrl.startsWith("http")) {
+        targetUrl = targetUrl + pathname + qs;
+    }
+    return { targetUrl, provider };
+}
+//# sourceMappingURL=routing.js.map

package/dist/proxy/routing.js.map

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

package/dist/proxy/server.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * Context Lens Proxy — standalone entry point.
+ *
+ * A minimal HTTP proxy that forwards LLM API requests to their upstream
+ * providers and writes raw captures to disk for analysis.
+ *
+ * ZERO DEPENDENCIES CONSTRAINT
+ * ============================
+ * This proxy (everything under src/proxy/) must stay zero external
+ * dependencies. Only Node.js built-in modules (node:http, node:https,
+ * node:fs, node:path, node:os, node:url) are allowed. No npm packages.
+ *
+ * Why: users route their API keys through this proxy. Keeping the code
+ * small and dependency-free means the entire proxy can be audited by
+ * reading a single directory. No transitive supply-chain risk.
+ *
+ * The analysis server, CLI, and web UI are separate processes that
+ * communicate via capture files on disk, and those are free to use
+ * whatever dependencies they need.
+ *
+ * Capture files are written to CONTEXT_LENS_CAPTURE_DIR (default:
+ * ~/.context-lens/captures/) as atomic JSON files. A separate analysis
+ * server watches that directory and provides the web UI.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/proxy/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/proxy/server.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * Context Lens Proxy — standalone entry point.
+ *
+ * A minimal HTTP proxy that forwards LLM API requests to their upstream
+ * providers and writes raw captures to disk for analysis.
+ *
+ * ZERO DEPENDENCIES CONSTRAINT
+ * ============================
+ * This proxy (everything under src/proxy/) must stay zero external
+ * dependencies. Only Node.js built-in modules (node:http, node:https,
+ * node:fs, node:path, node:os, node:url) are allowed. No npm packages.
+ *
+ * Why: users route their API keys through this proxy. Keeping the code
+ * small and dependency-free means the entire proxy can be audited by
+ * reading a single directory. No transitive supply-chain risk.
+ *
+ * The analysis server, CLI, and web UI are separate processes that
+ * communicate via capture files on disk, and those are free to use
+ * whatever dependencies they need.
+ *
+ * Capture files are written to CONTEXT_LENS_CAPTURE_DIR (default:
+ * ~/.context-lens/captures/) as atomic JSON files. A separate analysis
+ * server watches that directory and provides the web UI.
+ */
+import http from "node:http";
+import { createCaptureWriter } from "./capture.js";
+import { loadProxyConfig } from "./config.js";
+import { createProxyHandler } from "./forward.js";
+const config = loadProxyConfig();
+const captureWriter = createCaptureWriter(config.captureDir);
+const server = http.createServer(createProxyHandler({
+    upstreams: config.upstreams,
+    allowTargetOverride: config.allowTargetOverride,
+    onCapture: (capture) => {
+        captureWriter.write(capture);
+    },
+}));
+server.on("error", (err) => {
+    if (err.code === "EADDRINUSE") {
+        console.log(`🔍 Context Lens Proxy already running on port ${config.port}`);
+        process.exit(0);
+    }
+    throw err;
+});
+server.listen(config.port, config.bindHost, () => {
+    console.log(`🔍 Context Lens Proxy running on http://${config.bindHost}:${config.port}`);
+    console.log(`📁 Captures → ${config.captureDir}`);
+    if (!process.env.CONTEXT_LENS_CLI) {
+        console.log(`\nUpstream: OpenAI → ${config.upstreams.openai}`);
+        console.log(`         Anthropic → ${config.upstreams.anthropic}`);
+        console.log(`         Gemini → ${config.upstreams.gemini}`);
+    }
+});
+//# sourceMappingURL=server.js.map

package/dist/proxy/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;AACjC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAE7D,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,kBAAkB,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;IAC/C,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACrB,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;IAChD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,iDAAiD,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,GAAG,CAAC;AACZ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE;IAC/C,OAAO,CAAC,GAAG,CACT,2CAA2C,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAC5E,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,328 @@
+/**
+ * Valibot schemas for runtime validation of persisted and ingested data.
+ *
+ * These schemas validate data at trust boundaries:
+ * - State file (state.jsonl) loaded from disk
+ * - Ingest API (POST /api/ingest) from mitmproxy addon
+ * - Capture files from the proxy
+ *
+ * The TypeScript interfaces in types.ts remain the source of truth for
+ * in-memory types. These schemas validate external data before it enters
+ * the system.
+ */
+import * as v from "valibot";
+export declare const ConversationLineSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"conversation", undefined>;
+    readonly data: v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly label: v.StringSchema<undefined>;
+        readonly source: v.StringSchema<undefined>;
+        readonly workingDirectory: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly firstSeen: v.StringSchema<undefined>;
+        readonly sessionId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+}, undefined>;
+/**
+ * Schema for an entry line in state.jsonl.
+ *
+ * Uses looseObject for `response` because the compacted response shape
+ * varies (streaming chunks, raw markers, parsed usage objects). We only
+ * need the usage fields to survive; the rest is best-effort.
+ */
+export declare const EntryLineSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"entry", undefined>;
+    readonly data: v.ObjectSchema<{
+        readonly id: v.NumberSchema<undefined>;
+        readonly timestamp: v.StringSchema<undefined>;
+        readonly contextInfo: v.ObjectSchema<{
+            readonly provider: v.StringSchema<undefined>;
+            readonly apiFormat: v.StringSchema<undefined>;
+            readonly model: v.StringSchema<undefined>;
+            readonly systemTokens: v.NumberSchema<undefined>;
+            readonly toolsTokens: v.NumberSchema<undefined>;
+            readonly messagesTokens: v.NumberSchema<undefined>;
+            readonly totalTokens: v.NumberSchema<undefined>;
+            readonly systemPrompts: v.ArraySchema<v.ObjectSchema<{
+                readonly content: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly tools: v.ArraySchema<v.UnknownSchema, undefined>;
+            readonly messages: v.ArraySchema<v.ObjectSchema<{
+                readonly role: v.StringSchema<undefined>;
+                readonly content: v.StringSchema<undefined>;
+                readonly contentBlocks: v.OptionalSchema<v.NullableSchema<v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"text", undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"tool_use", undefined>;
+                    readonly id: v.StringSchema<undefined>;
+                    readonly name: v.StringSchema<undefined>;
+                    readonly input: v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"tool_result", undefined>;
+                    readonly tool_use_id: v.StringSchema<undefined>;
+                    readonly content: v.UnionSchema<[v.StringSchema<undefined>, v.ArraySchema<v.LooseObjectSchema<{
+                        readonly type: v.StringSchema<undefined>;
+                    }, undefined>, undefined>], undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"image", undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"input_text", undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                }, undefined>, v.LooseObjectSchema<{
+                    readonly type: v.StringSchema<undefined>;
+                }, undefined>], undefined>, undefined>, undefined>, undefined>;
+                readonly tokens: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+        }, undefined>;
+        readonly response: v.UnknownSchema;
+        readonly contextLimit: v.NumberSchema<undefined>;
+        readonly source: v.StringSchema<undefined>;
+        readonly conversationId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly agentKey: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly agentLabel: v.StringSchema<undefined>;
+        readonly httpStatus: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly timings: v.NullableSchema<v.ObjectSchema<{
+            readonly send_ms: v.NumberSchema<undefined>;
+            readonly wait_ms: v.NumberSchema<undefined>;
+            readonly receive_ms: v.NumberSchema<undefined>;
+            readonly total_ms: v.NumberSchema<undefined>;
+            readonly tokens_per_second: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly requestBytes: v.NumberSchema<undefined>;
+        readonly responseBytes: v.NumberSchema<undefined>;
+        readonly targetUrl: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly composition: v.ArraySchema<v.ObjectSchema<{
+            readonly category: v.PicklistSchema<["system_prompt", "tool_definitions", "tool_results", "tool_calls", "assistant_text", "user_text", "thinking", "system_injections", "images", "cache_markers", "other"], undefined>;
+            readonly tokens: v.NumberSchema<undefined>;
+            readonly pct: v.NumberSchema<undefined>;
+            readonly count: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly costUsd: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly healthScore: v.NullableSchema<v.ObjectSchema<{
+            readonly overall: v.NumberSchema<undefined>;
+            readonly rating: v.PicklistSchema<["good", "needs-work", "poor"], undefined>;
+            readonly audits: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly name: v.StringSchema<undefined>;
+                readonly score: v.NumberSchema<undefined>;
+                readonly weight: v.NumberSchema<undefined>;
+                readonly description: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly securityAlerts: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly messageIndex: v.NumberSchema<undefined>;
+            readonly role: v.StringSchema<undefined>;
+            readonly toolName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly severity: v.PicklistSchema<["high", "medium", "info"], undefined>;
+            readonly pattern: v.StringSchema<undefined>;
+            readonly match: v.StringSchema<undefined>;
+            readonly offset: v.NumberSchema<undefined>;
+            readonly length: v.NumberSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly usage: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+            readonly cacheReadTokens: v.NumberSchema<undefined>;
+            readonly cacheWriteTokens: v.NumberSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly responseModel: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly stopReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+}, undefined>;
+/**
+ * A single line in state.jsonl is either a conversation or an entry.
+ */
+export declare const StateLineSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"conversation", undefined>;
+    readonly data: v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly label: v.StringSchema<undefined>;
+        readonly source: v.StringSchema<undefined>;
+        readonly workingDirectory: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly firstSeen: v.StringSchema<undefined>;
+        readonly sessionId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"entry", undefined>;
+    readonly data: v.ObjectSchema<{
+        readonly id: v.NumberSchema<undefined>;
+        readonly timestamp: v.StringSchema<undefined>;
+        readonly contextInfo: v.ObjectSchema<{
+            readonly provider: v.StringSchema<undefined>;
+            readonly apiFormat: v.StringSchema<undefined>;
+            readonly model: v.StringSchema<undefined>;
+            readonly systemTokens: v.NumberSchema<undefined>;
+            readonly toolsTokens: v.NumberSchema<undefined>;
+            readonly messagesTokens: v.NumberSchema<undefined>;
+            readonly totalTokens: v.NumberSchema<undefined>;
+            readonly systemPrompts: v.ArraySchema<v.ObjectSchema<{
+                readonly content: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+            readonly tools: v.ArraySchema<v.UnknownSchema, undefined>;
+            readonly messages: v.ArraySchema<v.ObjectSchema<{
+                readonly role: v.StringSchema<undefined>;
+                readonly content: v.StringSchema<undefined>;
+                readonly contentBlocks: v.OptionalSchema<v.NullableSchema<v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"text", undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"tool_use", undefined>;
+                    readonly id: v.StringSchema<undefined>;
+                    readonly name: v.StringSchema<undefined>;
+                    readonly input: v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"tool_result", undefined>;
+                    readonly tool_use_id: v.StringSchema<undefined>;
+                    readonly content: v.UnionSchema<[v.StringSchema<undefined>, v.ArraySchema<v.LooseObjectSchema<{
+                        readonly type: v.StringSchema<undefined>;
+                    }, undefined>, undefined>], undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"image", undefined>;
+                }, undefined>, v.ObjectSchema<{
+                    readonly type: v.LiteralSchema<"input_text", undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                }, undefined>, v.LooseObjectSchema<{
+                    readonly type: v.StringSchema<undefined>;
+                }, undefined>], undefined>, undefined>, undefined>, undefined>;
+                readonly tokens: v.NumberSchema<undefined>;
+            }, undefined>, undefined>;
+        }, undefined>;
+        readonly response: v.UnknownSchema;
+        readonly contextLimit: v.NumberSchema<undefined>;
+        readonly source: v.StringSchema<undefined>;
+        readonly conversationId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly agentKey: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly agentLabel: v.StringSchema<undefined>;
+        readonly httpStatus: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly timings: v.NullableSchema<v.ObjectSchema<{
+            readonly send_ms: v.NumberSchema<undefined>;
+            readonly wait_ms: v.NumberSchema<undefined>;
+            readonly receive_ms: v.NumberSchema<undefined>;
+            readonly total_ms: v.NumberSchema<undefined>;
+            readonly tokens_per_second: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly requestBytes: v.NumberSchema<undefined>;
+        readonly responseBytes: v.NumberSchema<undefined>;
+        readonly targetUrl: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly composition: v.ArraySchema<v.ObjectSchema<{
+            readonly category: v.PicklistSchema<["system_prompt", "tool_definitions", "tool_results", "tool_calls", "assistant_text", "user_text", "thinking", "system_injections", "images", "cache_markers", "other"], undefined>;
+            readonly tokens: v.NumberSchema<undefined>;
+            readonly pct: v.NumberSchema<undefined>;
+            readonly count: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly costUsd: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly healthScore: v.NullableSchema<v.ObjectSchema<{
+            readonly overall: v.NumberSchema<undefined>;
+            readonly rating: v.PicklistSchema<["good", "needs-work", "poor"], undefined>;
+            readonly audits: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly name: v.StringSchema<undefined>;
+                readonly score: v.NumberSchema<undefined>;
+                readonly weight: v.NumberSchema<undefined>;
+                readonly description: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly securityAlerts: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly messageIndex: v.NumberSchema<undefined>;
+            readonly role: v.StringSchema<undefined>;
+            readonly toolName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly severity: v.PicklistSchema<["high", "medium", "info"], undefined>;
+            readonly pattern: v.StringSchema<undefined>;
+            readonly match: v.StringSchema<undefined>;
+            readonly offset: v.NumberSchema<undefined>;
+            readonly length: v.NumberSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly usage: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+            readonly cacheReadTokens: v.NumberSchema<undefined>;
+            readonly cacheWriteTokens: v.NumberSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly responseModel: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly stopReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+/**
+ * Legacy ingest format (provider + body + response).
+ */
+export declare const IngestLegacyPayloadSchema: v.ObjectSchema<{
+    readonly provider: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly apiFormat: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly source: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly body: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, {}>;
+    readonly response: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, {}>;
+}, undefined>;
+/**
+ * Capture-format ingest (same shape as proxy CaptureData).
+ * Sent by the mitmproxy addon. Includes headers, timings, streaming body.
+ */
+export declare const IngestCapturePayloadSchema: v.ObjectSchema<{
+    readonly timestamp: v.StringSchema<undefined>;
+    readonly method: v.OptionalSchema<v.StringSchema<undefined>, "POST">;
+    readonly path: v.StringSchema<undefined>;
+    readonly source: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, "unknown">;
+    readonly provider: v.StringSchema<undefined>;
+    readonly apiFormat: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly targetUrl: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    readonly requestHeaders: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, {}>;
+    readonly requestBody: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, null>;
+    readonly requestBytes: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    readonly responseStatus: v.OptionalSchema<v.NumberSchema<undefined>, 200>;
+    readonly responseHeaders: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, {}>;
+    readonly responseBody: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    readonly responseIsStreaming: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    readonly responseBytes: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    readonly timings: v.OptionalSchema<v.ObjectSchema<{
+        readonly send_ms: v.NumberSchema<undefined>;
+        readonly wait_ms: v.NumberSchema<undefined>;
+        readonly receive_ms: v.NumberSchema<undefined>;
+        readonly total_ms: v.NumberSchema<undefined>;
+    }, undefined>, {
+        readonly send_ms: 0;
+        readonly wait_ms: 0;
+        readonly receive_ms: 0;
+        readonly total_ms: 0;
+    }>;
+}, undefined>;
+/**
+ * Union: accept either capture-format or legacy format.
+ */
+export declare const IngestPayloadSchema: v.UnionSchema<[v.ObjectSchema<{
+    readonly timestamp: v.StringSchema<undefined>;
+    readonly method: v.OptionalSchema<v.StringSchema<undefined>, "POST">;
+    readonly path: v.StringSchema<undefined>;
+    readonly source: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, "unknown">;
+    readonly provider: v.StringSchema<undefined>;
+    readonly apiFormat: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly targetUrl: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    readonly requestHeaders: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, {}>;
+    readonly requestBody: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, null>;
+    readonly requestBytes: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    readonly responseStatus: v.OptionalSchema<v.NumberSchema<undefined>, 200>;
+    readonly responseHeaders: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, {}>;
+    readonly responseBody: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    readonly responseIsStreaming: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    readonly responseBytes: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    readonly timings: v.OptionalSchema<v.ObjectSchema<{
+        readonly send_ms: v.NumberSchema<undefined>;
+        readonly wait_ms: v.NumberSchema<undefined>;
+        readonly receive_ms: v.NumberSchema<undefined>;
+        readonly total_ms: v.NumberSchema<undefined>;
+    }, undefined>, {
+        readonly send_ms: 0;
+        readonly wait_ms: 0;
+        readonly receive_ms: 0;
+        readonly total_ms: 0;
+    }>;
+}, undefined>, v.ObjectSchema<{
+    readonly provider: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly apiFormat: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly source: v.OptionalSchema<v.StringSchema<undefined>, "unknown">;
+    readonly body: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, {}>;
+    readonly response: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, {}>;
+}, undefined>], undefined>;
+export type StateLineData = v.InferOutput<typeof StateLineSchema>;
+export type ConversationLineData = v.InferOutput<typeof ConversationLineSchema>;
+export type EntryLineData = v.InferOutput<typeof EntryLineSchema>;
+export type IngestPayloadData = v.InferOutput<typeof IngestPayloadSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAqK7B,eAAO,MAAM,sBAAsB;;;;;;;;;;aAUjC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAyB1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAG1B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;aAMpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;aAyBrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAG9B,CAAC;AAMH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AAClE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC"}