context-lens 0.2.0 → 0.2.1

package/dist/core/parse.js

@@ -0,0 +1,349 @@
+import { estimateTokens } from "./tokens.js";
+/**
+ * Parse a single item from the OpenAI Responses API `input` array.
+ *
+ * Maps typed items (function_call, function_call_output, reasoning, output_text, etc.)
+ * to a normalized `ParsedMessage` with a stable `role` and optional `contentBlocks`.
+ */
+function parseResponsesItem(item) {
+    const type = item.type || "";
+    // Standard message with role/content (e.g. {"type":"message","role":"user","content":[...]})
+    if (item.role) {
+        const isSystem = item.role === "system" || item.role === "developer";
+        let content;
+        let contentBlocks = null;
+        if (typeof item.content === "string") {
+            content = item.content;
+        }
+        else if (Array.isArray(item.content)) {
+            contentBlocks = item.content;
+            content = item.content.map((b) => b.text || "").join("\n");
+        }
+        else {
+            content = JSON.stringify(item.content || item);
+        }
+        const tokens = estimateTokens(item.content ?? content);
+        return {
+            message: { role: item.role, content, contentBlocks, tokens },
+            tokens,
+            isSystem,
+            content,
+        };
+    }
+    // function_call → assistant tool_use
+    if (type === "function_call" || type === "custom_tool_call") {
+        const name = item.name || "unknown";
+        const args = item.arguments || "";
+        const content = name +
+            "(" +
+            (typeof args === "string"
+                ? args.slice(0, 200)
+                : JSON.stringify(args).slice(0, 200)) +
+            ")";
+        const tokens = estimateTokens(item);
+        const block = {
+            type: "tool_use",
+            id: item.call_id || "",
+            name,
+            input: typeof args === "string" ? {} : args || {},
+        };
+        return {
+            message: { role: "assistant", content, contentBlocks: [block], tokens },
+            tokens,
+            isSystem: false,
+            content,
+        };
+    }
+    // function_call_output → user tool_result
+    if (type === "function_call_output" || type === "custom_tool_call_output") {
+        const output = typeof item.output === "string"
+            ? item.output
+            : JSON.stringify(item.output || "");
+        const tokens = estimateTokens(output);
+        const block = {
+            type: "tool_result",
+            tool_use_id: item.call_id || "",
+            content: output,
+        };
+        return {
+            message: {
+                role: "user",
+                content: output,
+                contentBlocks: [block],
+                tokens,
+            },
+            tokens,
+            isSystem: false,
+            content: output,
+        };
+    }
+    // reasoning → assistant thinking
+    if (type === "reasoning") {
+        const summary = Array.isArray(item.summary)
+            ? item.summary.map((s) => s.text || "").join("\n")
+            : "";
+        const content = summary || "[reasoning]";
+        const tokens = estimateTokens(item);
+        return {
+            message: {
+                role: "assistant",
+                content,
+                contentBlocks: [{ type: "thinking", thinking: content }],
+                tokens,
+            },
+            tokens,
+            isSystem: false,
+            content,
+        };
+    }
+    // output_text → assistant text
+    if (type === "output_text") {
+        const text = item.text || "";
+        const tokens = estimateTokens(text);
+        return {
+            message: {
+                role: "assistant",
+                content: text,
+                contentBlocks: [{ type: "text", text }],
+                tokens,
+            },
+            tokens,
+            isSystem: false,
+            content: text,
+        };
+    }
+    // input_text → user text
+    if (type === "input_text") {
+        const text = item.text || "";
+        const tokens = estimateTokens(text);
+        return {
+            message: {
+                role: "user",
+                content: text,
+                contentBlocks: [{ type: "text", text }],
+                tokens,
+            },
+            tokens,
+            isSystem: false,
+            content: text,
+        };
+    }
+    // Fallback: serialize the whole item
+    const content = JSON.stringify(item);
+    const tokens = estimateTokens(content);
+    return {
+        message: { role: item.role || "user", content, tokens },
+        tokens,
+        isSystem: false,
+        content,
+    };
+}
+/**
+ * Parse a request body and extract normalized context information.
+ *
+ * This is the core "shape-normalizer" for Context Lens. It supports:
+ * - Anthropic Messages API
+ * - OpenAI Responses API and Chat Completions
+ * - ChatGPT backend schema (Codex subscription traffic)
+ * - Gemini (including Code Assist wrappers)
+ *
+ * @param provider - Provider inferred from routing (anthropic/openai/gemini/chatgpt/unknown).
+ * @param body - Parsed JSON request body.
+ * @param apiFormat - API schema family inferred from routing.
+ * @returns A `ContextInfo` with token estimates and normalized messages/blocks.
+ */
+export function parseContextInfo(provider, body, apiFormat) {
+    const info = {
+        provider,
+        apiFormat,
+        model: body.model || "unknown",
+        systemTokens: 0,
+        toolsTokens: 0,
+        messagesTokens: 0,
+        totalTokens: 0,
+        systemPrompts: [],
+        tools: [],
+        messages: [],
+    };
+    if (provider === "anthropic") {
+        if (body.system) {
+            const systemText = typeof body.system === "string"
+                ? body.system
+                : Array.isArray(body.system)
+                    ? body.system.map((b) => b.text || "").join("\n")
+                    : JSON.stringify(body.system);
+            info.systemPrompts.push({ content: systemText });
+            info.systemTokens = estimateTokens(systemText);
+        }
+        if (body.tools && Array.isArray(body.tools)) {
+            info.tools = body.tools;
+            info.toolsTokens = estimateTokens(JSON.stringify(body.tools));
+        }
+        if (body.messages && Array.isArray(body.messages)) {
+            info.messages = body.messages.map((msg) => {
+                const contentBlocks = Array.isArray(msg.content) ? msg.content : null;
+                return {
+                    role: msg.role,
+                    content: typeof msg.content === "string"
+                        ? msg.content
+                        : JSON.stringify(msg.content),
+                    contentBlocks,
+                    tokens: estimateTokens(msg.content),
+                };
+            });
+            info.messagesTokens = info.messages.reduce((sum, m) => sum + m.tokens, 0);
+        }
+    }
+    else if (apiFormat === "responses" || provider === "chatgpt") {
+        if (body.instructions) {
+            info.systemPrompts.push({ content: body.instructions });
+            info.systemTokens = estimateTokens(body.instructions);
+        }
+        if (body.system) {
+            const systemText = typeof body.system === "string"
+                ? body.system
+                : Array.isArray(body.system)
+                    ? body.system.map((b) => b.text || "").join("\n")
+                    : JSON.stringify(body.system);
+            info.systemPrompts.push({ content: systemText });
+            info.systemTokens += estimateTokens(systemText);
+        }
+        const msgs = body.input || body.messages;
+        if (msgs) {
+            if (typeof msgs === "string") {
+                info.messages.push({
+                    role: "user",
+                    content: msgs,
+                    tokens: estimateTokens(msgs),
+                });
+                info.messagesTokens = estimateTokens(msgs);
+            }
+            else if (Array.isArray(msgs)) {
+                msgs.forEach((item) => {
+                    const parsed = parseResponsesItem(item);
+                    if (parsed.isSystem) {
+                        info.systemPrompts.push({ content: parsed.content });
+                        info.systemTokens += parsed.tokens;
+                    }
+                    else {
+                        info.messages.push(parsed.message);
+                        info.messagesTokens += parsed.tokens;
+                    }
+                });
+            }
+        }
+        if (body.tools && Array.isArray(body.tools)) {
+            info.tools = body.tools;
+            info.toolsTokens = estimateTokens(JSON.stringify(body.tools));
+        }
+    }
+    else if (provider === "gemini" || apiFormat === "gemini") {
+        // Gemini API: contents[], systemInstruction, tools[{functionDeclarations}]
+        // Code Assist wraps everything inside body.request: {contents, systemInstruction, tools, ...}
+        const geminiBody = body.request || body;
+        if (geminiBody.systemInstruction) {
+            const parts = geminiBody.systemInstruction.parts || [];
+            const systemText = parts.map((p) => p.text || "").join("\n");
+            info.systemPrompts.push({ content: systemText });
+            info.systemTokens = estimateTokens(systemText);
+        }
+        if (geminiBody.tools && Array.isArray(geminiBody.tools)) {
+            const allDecls = geminiBody.tools.flatMap((t) => t.functionDeclarations || []);
+            info.tools = allDecls;
+            info.toolsTokens = estimateTokens(JSON.stringify(geminiBody.tools));
+        }
+        if (geminiBody.contents && Array.isArray(geminiBody.contents)) {
+            info.messages = geminiBody.contents.map((turn) => {
+                const role = turn.role || "user";
+                const parts = turn.parts || [];
+                const contentBlocks = [];
+                const textParts = [];
+                for (const part of parts) {
+                    if (part.text) {
+                        textParts.push(part.text);
+                        contentBlocks.push({ type: "text", text: part.text });
+                    }
+                    else if (part.functionCall) {
+                        contentBlocks.push({
+                            type: "tool_use",
+                            id: part.functionCall.id || "",
+                            name: part.functionCall.name || "",
+                            input: part.functionCall.args || {},
+                        });
+                    }
+                    else if (part.functionResponse) {
+                        const resp = part.functionResponse.response;
+                        // Gemini CLI wraps tool output in {output: "..."} or {error: "..."}
+                        const respText = typeof resp === "string"
+                            ? resp
+                            : typeof resp?.output === "string"
+                                ? resp.output
+                                : typeof resp?.error === "string"
+                                    ? resp.error
+                                    : JSON.stringify(resp || "");
+                        contentBlocks.push({
+                            type: "tool_result",
+                            tool_use_id: part.functionResponse.id || "",
+                            content: respText,
+                        });
+                    }
+                    else if (part.inlineData) {
+                        contentBlocks.push({ type: "image" });
+                    }
+                    else if (part.executableCode) {
+                        contentBlocks.push({
+                            type: "text",
+                            text: part.executableCode.code || "",
+                        });
+                    }
+                    else if (part.codeExecutionResult) {
+                        contentBlocks.push({
+                            type: "text",
+                            text: part.codeExecutionResult.output || "",
+                        });
+                    }
+                }
+                const content = textParts.join("\n") || JSON.stringify(parts);
+                const tokens = estimateTokens(turn);
+                return {
+                    role: role === "model" ? "assistant" : role,
+                    content,
+                    contentBlocks,
+                    tokens,
+                };
+            });
+            info.messagesTokens = info.messages.reduce((sum, m) => sum + m.tokens, 0);
+        }
+    }
+    else if (provider === "openai") {
+        if (body.messages && Array.isArray(body.messages)) {
+            body.messages.forEach((msg) => {
+                if (msg.role === "system" || msg.role === "developer") {
+                    info.systemPrompts.push({ content: msg.content });
+                    info.systemTokens += estimateTokens(msg.content);
+                }
+                else {
+                    info.messages.push({
+                        role: msg.role,
+                        content: typeof msg.content === "string"
+                            ? msg.content
+                            : JSON.stringify(msg.content),
+                        tokens: estimateTokens(msg.content),
+                    });
+                    info.messagesTokens += estimateTokens(msg.content);
+                }
+            });
+        }
+        if (body.tools && Array.isArray(body.tools)) {
+            info.tools = body.tools;
+            info.toolsTokens = estimateTokens(JSON.stringify(body.tools));
+        }
+        else if (body.functions && Array.isArray(body.functions)) {
+            info.tools = body.functions;
+            info.toolsTokens = estimateTokens(JSON.stringify(body.functions));
+        }
+    }
+    info.totalTokens = info.systemTokens + info.toolsTokens + info.messagesTokens;
+    return info;
+}
+//# sourceMappingURL=parse.js.map

package/dist/core/parse.js.map

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

package/dist/core/routing.d.ts

@@ -0,0 +1,47 @@
+import type { ApiFormat, ExtractSourceResult, ParsedUrl, Provider, ResolveTargetResult, Upstreams } from "../types.js";
+/**
+ * URL path segments that represent API resources rather than "source tool" prefixes.
+ *
+ * Example: `/v1/messages` should not treat `v1` as a source tag.
+ */
+export declare const API_PATH_SEGMENTS: Set<string>;
+/**
+ * Infer provider based on request path + headers.
+ *
+ * This is used for routing (choosing which upstream base URL to use) and parsing.
+ */
+export declare function detectProvider(pathname: string, headers: Record<string, string | undefined>): Provider;
+/**
+ * Infer the API "format" (schema family) from the request path.
+ *
+ * This is distinct from provider: e.g. OpenAI can be `responses` or `chat-completions`.
+ */
+export declare function detectApiFormat(pathname: string): ApiFormat;
+/**
+ * Classify an incoming request into `{ provider, apiFormat }`.
+ *
+ * Keep all path/format heuristics in one place to avoid drift between
+ * routing decisions and parsing decisions.
+ */
+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' }`.
+ *
+ * This tag is used for attribution in the UI/LHAR and for per-tool grouping.
+ */
+export declare function extractSource(pathname: string): ExtractSourceResult;
+/**
+ * Determine the final upstream target URL for a request.
+ *
+ * @param parsedUrl - Path + query extracted from the incoming request.
+ * @param headers - Headers used for detection and optional override.
+ * @param upstreams - Base URLs for each provider.
+ * @returns `{ targetUrl, provider }`.
+ */
+export declare function resolveTargetUrl(parsedUrl: ParsedUrl, headers: Record<string, string | undefined>, upstreams: Upstreams): ResolveTargetResult;
+//# sourceMappingURL=routing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/core/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACV,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAW5B,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC1C,QAAQ,CAEV;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAE3D;AAED;;;;;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;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAqBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC3C,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAsBrB"}

package/dist/core/routing.js

@@ -0,0 +1,132 @@
+/**
+ * URL path segments that represent API resources rather than "source tool" prefixes.
+ *
+ * Example: `/v1/messages` should not treat `v1` as a source tag.
+ */
+export const API_PATH_SEGMENTS = new Set([
+    "v1",
+    "v1beta",
+    "v1alpha",
+    "v1internal",
+    "responses",
+    "chat",
+    "models",
+    "embeddings",
+    "backend-api",
+    "api",
+]);
+/**
+ * Infer provider based on request path + headers.
+ *
+ * This is used for routing (choosing which upstream base URL to use) and parsing.
+ */
+export function detectProvider(pathname, headers) {
+    return classifyRequest(pathname, headers).provider;
+}
+/**
+ * Infer the API "format" (schema family) from the request path.
+ *
+ * This is distinct from provider: e.g. OpenAI can be `responses` or `chat-completions`.
+ */
+export function detectApiFormat(pathname) {
+    return classifyRequest(pathname, {}).apiFormat;
+}
+/**
+ * Classify an incoming request into `{ provider, apiFormat }`.
+ *
+ * Keep all path/format heuristics in one place to avoid drift between
+ * routing decisions and parsing decisions.
+ */
+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' }`.
+ *
+ * This tag is used for attribution in the UI/LHAR and for per-tool grouping.
+ */
+export function extractSource(pathname) {
+    const match = pathname.match(/^\/([^/]+)(\/.*)?$/);
+    if (match?.[2] && !API_PATH_SEGMENTS.has(match[1])) {
+        // `decodeURIComponent` may introduce `/` via `%2f` (path traversal) or throw on bad encodings.
+        // Treat suspicious/invalid tags as "no source tag" and route the request normally.
+        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.
+ *
+ * @param parsedUrl - Path + query extracted from the incoming request.
+ * @param headers - Headers used for detection and optional override.
+ * @param upstreams - Base URLs for each provider.
+ * @returns `{ targetUrl, provider }`.
+ */
+export function resolveTargetUrl(parsedUrl, headers, upstreams) {
+    const provider = classifyRequest(parsedUrl.pathname, headers).provider;
+    const search = parsedUrl.search || "";
+    let targetUrl = headers["x-target-url"];
+    if (!targetUrl) {
+        if (provider === "chatgpt") {
+            targetUrl = upstreams.chatgpt + parsedUrl.pathname + search;
+        }
+        else if (provider === "anthropic") {
+            targetUrl = upstreams.anthropic + parsedUrl.pathname + search;
+        }
+        else if (provider === "gemini") {
+            const isCodeAssist = parsedUrl.pathname.includes("/v1internal");
+            targetUrl =
+                (isCodeAssist ? upstreams.geminiCodeAssist : upstreams.gemini) +
+                    parsedUrl.pathname +
+                    search;
+        }
+        else {
+            targetUrl = upstreams.openai + parsedUrl.pathname + search;
+        }
+    }
+    else if (!targetUrl.startsWith("http")) {
+        targetUrl = targetUrl + parsedUrl.pathname + search;
+    }
+    return { targetUrl, provider };
+}
+//# sourceMappingURL=routing.js.map

package/dist/core/routing.js.map

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

package/dist/core/source.d.ts

@@ -0,0 +1,22 @@
+import type { ContextInfo, HeaderSignature, SourceSignature } from "../types.js";
+/**
+ * Header signatures used to infer which CLI/tool produced a request.
+ *
+ * This is best-effort: many tools do not have stable identifiers.
+ */
+export declare const HEADER_SIGNATURES: HeaderSignature[];
+/**
+ * System-prompt signatures used as a fallback when headers are missing/ambiguous.
+ */
+export declare const SOURCE_SIGNATURES: SourceSignature[];
+/**
+ * Infer a human-friendly "source tool" label (claude/codex/gemini/aider/...) for attribution.
+ *
+ * Priority:
+ * 1. explicit source tag if provided and not `"unknown"`
+ * 2. request header signatures
+ * 3. system prompt signatures
+ * 4. fallback to `"unknown"`
+ */
+export declare function detectSource(contextInfo: ContextInfo, source: string | null, headers?: Record<string, string>): string;
+//# sourceMappingURL=source.d.ts.map

package/dist/core/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/core/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAK9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAK9C,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CA0BR"}

package/dist/core/source.js

@@ -0,0 +1,56 @@
+/**
+ * Header signatures used to infer which CLI/tool produced a request.
+ *
+ * This is best-effort: many tools do not have stable identifiers.
+ */
+export const HEADER_SIGNATURES = [
+    { header: "user-agent", pattern: /^claude-cli\//, source: "claude" },
+    { header: "user-agent", pattern: /aider/i, source: "aider" },
+    { header: "user-agent", pattern: /kimi/i, source: "kimi" },
+    { header: "user-agent", pattern: /^GeminiCLI\//, source: "gemini" },
+];
+/**
+ * System-prompt signatures used as a fallback when headers are missing/ambiguous.
+ */
+export const SOURCE_SIGNATURES = [
+    { pattern: "Act as an expert software developer", source: "aider" },
+    { pattern: "You are Claude Code", source: "claude" },
+    { pattern: "You are Kimi Code CLI", source: "kimi" },
+    { pattern: "operating inside pi, a coding agent harness", source: "pi" },
+];
+/**
+ * Infer a human-friendly "source tool" label (claude/codex/gemini/aider/...) for attribution.
+ *
+ * Priority:
+ * 1. explicit source tag if provided and not `"unknown"`
+ * 2. request header signatures
+ * 3. system prompt signatures
+ * 4. fallback to `"unknown"`
+ */
+export function detectSource(contextInfo, source, headers) {
+    if (source && source !== "unknown")
+        return source;
+    // Primary: check request headers
+    if (headers) {
+        for (const sig of HEADER_SIGNATURES) {
+            const val = headers[sig.header];
+            if (!val)
+                continue;
+            if (sig.pattern instanceof RegExp
+                ? sig.pattern.test(val)
+                : val.includes(sig.pattern)) {
+                return sig.source;
+            }
+        }
+    }
+    // Fallback: check system prompt content
+    const systemText = (contextInfo.systemPrompts || [])
+        .map((sp) => sp.content)
+        .join("\n");
+    for (const sig of SOURCE_SIGNATURES) {
+        if (systemText.includes(sig.pattern))
+            return sig.source;
+    }
+    return source || "unknown";
+}
+//# sourceMappingURL=source.js.map

package/dist/core/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/core/source.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE;IACpE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IAC5D,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;IAC1D,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE;CACpE,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,EAAE,OAAO,EAAE,qCAAqC,EAAE,MAAM,EAAE,OAAO,EAAE;IACnE,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAE;IACpD,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,EAAE;IACpD,EAAE,OAAO,EAAE,6CAA6C,EAAE,MAAM,EAAE,IAAI,EAAE;CACzE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAwB,EACxB,MAAqB,EACrB,OAAgC;IAEhC,IAAI,MAAM,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAElD,iCAAiC;IACjC,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,IACE,GAAG,CAAC,OAAO,YAAY,MAAM;gBAC3B,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;gBACvB,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAC7B,CAAC;gBACD,OAAO,GAAG,CAAC,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,UAAU,GAAG,CAAC,WAAW,CAAC,aAAa,IAAI,EAAE,CAAC;SACjD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC;SACvB,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,IAAI,SAAS,CAAC;AAC7B,CAAC"}

package/dist/core/tokens.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Lightweight token estimator used throughout Context Lens.
+ *
+ * This is intentionally simple and model-agnostic: we approximate tokens as `ceil(chars / 4)`.
+ * It is good enough for rough context utilization and relative comparisons.
+ *
+ * @param text - Value to estimate tokens for. Objects are stringified as JSON.
+ * @returns Estimated token count (>= 0).
+ */
+export declare function estimateTokens(text: unknown): number;
+//# sourceMappingURL=tokens.d.ts.map