context-lens 0.2.0 → 0.2.1

package/dist/core/conversation.d.ts

@@ -0,0 +1,54 @@
+import type { ContextInfo, ParsedMessage } from "../types.js";
+/**
+ * Extract readable text from message content.
+ *
+ * This is used for labels/fingerprints where we want the "real" prompt text, not wrappers.
+ * It understands a few common JSON wrappers used by tool APIs.
+ *
+ * @param content - Raw message content (string, often JSON-encoded).
+ * @returns A trimmed text string or `null` if no readable text exists.
+ */
+export declare function extractReadableText(content: string | null | undefined): string | null;
+/**
+ * Extract the working directory from captured content when a tool embeds it.
+ *
+ * Supports:
+ * - Claude Code: "Primary working directory: `/path`"
+ * - Codex: "<cwd>/path</cwd>"
+ * - Generic: "working directory is /path" or "cwd: /path"
+ */
+export declare function extractWorkingDirectory(contextInfo: ContextInfo): string | null;
+/**
+ * For OpenAI Responses-style input arrays, extract the first "real" user prompt.
+ *
+ * Skips boilerplate blocks (AGENTS.md / environment wrappers).
+ */
+export declare function extractUserPrompt(messages: ParsedMessage[]): string | null;
+/**
+ * Extract a stable session identifier when the upstream/tool provides one.
+ *
+ * Supported:
+ * - Anthropic: `metadata.user_id` contains `session_<uuid>`
+ * - Gemini Code Assist: `request.session_id` (uuid)
+ */
+export declare function extractSessionId(rawBody: Record<string, any> | null | undefined): string | null;
+/**
+ * Compute a sub-key to distinguish agents within a session (main vs subagents).
+ *
+ * Currently derived from the first readable user message.
+ */
+export declare function computeAgentKey(contextInfo: ContextInfo): string | null;
+/**
+ * Compute a conversation fingerprint for grouping.
+ *
+ * Priority:
+ * 1. explicit session IDs (most stable)
+ * 2. Responses API chaining (`previous_response_id`)
+ * 3. content hash of system + first prompt
+ */
+export declare function computeFingerprint(contextInfo: ContextInfo, rawBody: Record<string, any> | null | undefined, responseIdToConvo: Map<string, string>): string | null;
+/**
+ * Extract a readable label for a conversation, primarily for UI display.
+ */
+export declare function extractConversationLabel(contextInfo: ContextInfo): string;
+//# sourceMappingURL=conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/core/conversation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,MAAM,GAAG,IAAI,CAuBf;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,GACvB,MAAM,GAAG,IAAI,CAwBf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,GAAG,IAAI,CAmB1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C,MAAM,GAAG,IAAI,CAUf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAcvE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,GAAG,IAAI,CA+Bf;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAgBzE"}

package/dist/core/conversation.js

@@ -0,0 +1,188 @@
+import { createHash } from "node:crypto";
+/**
+ * Extract readable text from message content.
+ *
+ * This is used for labels/fingerprints where we want the "real" prompt text, not wrappers.
+ * It understands a few common JSON wrappers used by tool APIs.
+ *
+ * @param content - Raw message content (string, often JSON-encoded).
+ * @returns A trimmed text string or `null` if no readable text exists.
+ */
+export function extractReadableText(content) {
+    if (!content)
+        return null;
+    let text = content;
+    try {
+        const parsed = JSON.parse(text);
+        if (Array.isArray(parsed)) {
+            const textBlock = parsed.find((b) => (b.type === "text" &&
+                b.text &&
+                !b.text.startsWith("<system-reminder>")) ||
+                (b.type === "input_text" &&
+                    b.text &&
+                    !b.text.startsWith("#") &&
+                    !b.text.startsWith("<environment")));
+            if (textBlock)
+                text = textBlock.text;
+        }
+    }
+    catch {
+        // Expected: input may not be valid JSON; fall through to raw text
+    }
+    text = text.replace(/\s+/g, " ").trim();
+    return text || null;
+}
+/**
+ * Extract the working directory from captured content when a tool embeds it.
+ *
+ * Supports:
+ * - Claude Code: "Primary working directory: `/path`"
+ * - Codex: "<cwd>/path</cwd>"
+ * - Generic: "working directory is /path" or "cwd: /path"
+ */
+export function extractWorkingDirectory(contextInfo) {
+    const allText = [
+        ...(contextInfo.systemPrompts || []).map((sp) => sp.content),
+        ...(contextInfo.messages || [])
+            .filter((m) => m.role === "user")
+            .map((m) => m.content),
+    ].join("\n");
+    let match = allText.match(/[Pp]rimary working directory[:\s]+[`]?([/~][^\s`\n]+)/);
+    if (match)
+        return match[1];
+    match = allText.match(/<cwd>([^<]+)<\/cwd>/);
+    if (match)
+        return match[1];
+    // Generic: "working directory is /path" or "working directory = /path"
+    match = allText.match(/working directory (?:is |= ?)[`"]?([/~][^\s`"'\n]+)/i);
+    if (match)
+        return match[1];
+    // Generic: "working directory: /path" or "working directory /path"
+    match = allText.match(/working directory[:\s]+[`"]?([/~][^\s`"'\n]+)/i);
+    if (match)
+        return match[1];
+    match = allText.match(/\bcwd[:\s]+[`"]?([/~][^\s`"'\n]+)/);
+    if (match)
+        return match[1];
+    return null;
+}
+/**
+ * For OpenAI Responses-style input arrays, extract the first "real" user prompt.
+ *
+ * Skips boilerplate blocks (AGENTS.md / environment wrappers).
+ */
+export function extractUserPrompt(messages) {
+    for (const m of messages) {
+        if (m.role !== "user" || !m.content)
+            continue;
+        try {
+            const parsed = JSON.parse(m.content);
+            if (Array.isArray(parsed) &&
+                parsed[0] &&
+                parsed[0].type === "input_text") {
+                const text = parsed[0].text || "";
+                if (text.startsWith("#") || text.startsWith("<environment"))
+                    continue;
+                return m.content;
+            }
+        }
+        catch {
+            // Expected: content may not be valid JSON; skip this message
+        }
+    }
+    return null;
+}
+/**
+ * Extract a stable session identifier when the upstream/tool provides one.
+ *
+ * Supported:
+ * - Anthropic: `metadata.user_id` contains `session_<uuid>`
+ * - Gemini Code Assist: `request.session_id` (uuid)
+ */
+export function extractSessionId(rawBody) {
+    const userId = rawBody?.metadata?.user_id;
+    if (userId) {
+        const match = userId.match(/session_([a-f0-9-]+)/);
+        if (match)
+            return match[0];
+    }
+    const geminiSessionId = rawBody?.request?.session_id;
+    if (geminiSessionId && typeof geminiSessionId === "string")
+        return `gemini_${geminiSessionId}`;
+    return null;
+}
+/**
+ * Compute a sub-key to distinguish agents within a session (main vs subagents).
+ *
+ * Currently derived from the first readable user message.
+ */
+export function computeAgentKey(contextInfo) {
+    const userMsgs = (contextInfo.messages || []).filter((m) => m.role === "user");
+    let realText = "";
+    for (const msg of userMsgs) {
+        const t = extractReadableText(msg.content);
+        if (t) {
+            realText = t;
+            break;
+        }
+    }
+    if (!realText)
+        return null;
+    return createHash("sha256").update(realText).digest("hex").slice(0, 12);
+}
+/**
+ * Compute a conversation fingerprint for grouping.
+ *
+ * Priority:
+ * 1. explicit session IDs (most stable)
+ * 2. Responses API chaining (`previous_response_id`)
+ * 3. content hash of system + first prompt
+ */
+export function computeFingerprint(contextInfo, rawBody, responseIdToConvo) {
+    const sessionId = extractSessionId(rawBody);
+    if (sessionId) {
+        return createHash("sha256").update(sessionId).digest("hex").slice(0, 16);
+    }
+    if (rawBody?.previous_response_id && responseIdToConvo) {
+        const existing = responseIdToConvo.get(rawBody.previous_response_id);
+        if (existing)
+            return existing;
+    }
+    const userMsgs = (contextInfo.messages || []).filter((m) => m.role === "user");
+    let promptText;
+    if (contextInfo.apiFormat === "responses" && userMsgs.length > 1) {
+        promptText = extractUserPrompt(userMsgs) || "";
+    }
+    else {
+        const firstUser = userMsgs[0];
+        promptText = firstUser ? firstUser.content : "";
+    }
+    const systemText = (contextInfo.systemPrompts || [])
+        .map((sp) => sp.content)
+        .join("\n");
+    if (!systemText && !promptText)
+        return null;
+    return createHash("sha256")
+        .update(`${systemText}\0${promptText}`)
+        .digest("hex")
+        .slice(0, 16);
+}
+/**
+ * Extract a readable label for a conversation, primarily for UI display.
+ */
+export function extractConversationLabel(contextInfo) {
+    const userMsgs = (contextInfo.messages || []).filter((m) => m.role === "user");
+    if (contextInfo.apiFormat === "responses" && userMsgs.length > 1) {
+        const prompt = extractUserPrompt(userMsgs);
+        const text = extractReadableText(prompt);
+        if (text)
+            return text.length > 80 ? `${text.slice(0, 77)}...` : text;
+    }
+    for (let i = userMsgs.length - 1; i >= 0; i--) {
+        const text = extractReadableText(userMsgs[i].content);
+        if (text)
+            return text.length > 80 ? `${text.slice(0, 77)}...` : text;
+    }
+    return "Unnamed conversation";
+}
+//# sourceMappingURL=conversation.js.map

package/dist/core/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/core/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAkC;IAElC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,IAAI,GAAG,OAAO,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAC3B,CAAC,CAAM,EAAE,EAAE,CACT,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM;gBAChB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;gBAC1C,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY;oBACtB,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBACvB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CACxC,CAAC;YACF,IAAI,SAAS;gBAAE,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;QACvC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;IACD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAwB;IAExB,MAAM,OAAO,GAAG;QACd,GAAG,CAAC,WAAW,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC;QAC5D,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CACvB,uDAAuD,CACxD,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC7C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,uEAAuE;IACvE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC9E,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,mEAAmE;IACnE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACxE,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC3D,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAyB;IACzD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAS;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACrC,IACE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBACrB,MAAM,CAAC,CAAC,CAAC;gBACT,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,EAC/B,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;oBAAE,SAAS;gBACtE,OAAO,CAAC,CAAC,OAAO,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA+C;IAE/C,MAAM,MAAM,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;IAC1C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACnD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,eAAe,GAAG,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC;IACrD,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ;QACxD,OAAO,UAAU,eAAe,EAAE,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAwB;IACtD,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CACzB,CAAC;IACF,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,EAAE,CAAC;YACN,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAwB,EACxB,OAA+C,EAC/C,iBAAsC;IAEtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,OAAO,EAAE,oBAAoB,IAAI,iBAAiB,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACrE,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CACzB,CAAC;IAEF,IAAI,UAAkB,CAAC;IACvB,IAAI,WAAW,CAAC,SAAS,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9B,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,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,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,UAAU,KAAK,UAAU,EAAE,CAAC;SACtC,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAwB;IAC/D,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CACzB,CAAC;IAEF,IAAI,WAAW,CAAC,SAAS,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IACD,OAAO,sBAAsB,CAAC;AAChC,CAAC"}

package/dist/core/models.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Known model context limits (tokens).
+ *
+ * Keys are ordered most-specific-first because `getContextLimit()` does substring matching.
+ */
+export declare const CONTEXT_LIMITS: Record<string, number>;
+/**
+ * Resolve an approximate context window size for a given model string.
+ *
+ * @param model - Model identifier (often includes version suffixes).
+ * @returns Context limit in tokens.
+ */
+export declare function getContextLimit(model: string): number;
+/**
+ * Model pricing: `[inputPerMTok, outputPerMTok]` in USD.
+ *
+ * Keys ordered most-specific-first to avoid substring false matches
+ * (e.g. `gpt-4o-mini` before `gpt-4o`).
+ */
+export declare const MODEL_PRICING: Record<string, [number, number]>;
+/**
+ * Estimate cost in USD for a request/response token pair using `MODEL_PRICING`.
+ *
+ * @param model - Model identifier (substring matched against known keys).
+ * @param inputTokens - Input/prompt tokens.
+ * @param outputTokens - Output/completion tokens.
+ * @returns Cost in USD, rounded to 6 decimals; `null` if the model is unknown.
+ */
+export declare function estimateCost(model: string, inputTokens: number, outputTokens: number): number | null;
+//# sourceMappingURL=models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/core/models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyBjD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CA4B1D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CAWf"}

package/dist/core/models.js

@@ -0,0 +1,96 @@
+/**
+ * Known model context limits (tokens).
+ *
+ * Keys are ordered most-specific-first because `getContextLimit()` does substring matching.
+ */
+export const CONTEXT_LIMITS = {
+    // Anthropic
+    "claude-opus-4": 200000,
+    "claude-sonnet-4": 200000,
+    "claude-haiku-4": 200000,
+    "claude-3-5-sonnet": 200000,
+    "claude-3-5-haiku": 200000,
+    "claude-3-opus": 200000,
+    // OpenAI (specific before generic)
+    "gpt-4o-mini": 128000,
+    "gpt-4o": 128000,
+    "gpt-4-turbo": 128000,
+    "gpt-4": 8192,
+    "gpt-3.5-turbo": 16385,
+    "o4-mini": 200000,
+    "o3-mini": 200000,
+    o3: 200000,
+    "o1-mini": 128000,
+    o1: 200000,
+    // Gemini
+    "gemini-2.5-pro": 1048576,
+    "gemini-2.5-flash": 1048576,
+    "gemini-2.0-flash": 1048576,
+    "gemini-1.5-pro": 2097152,
+    "gemini-1.5-flash": 1048576,
+};
+/**
+ * Resolve an approximate context window size for a given model string.
+ *
+ * @param model - Model identifier (often includes version suffixes).
+ * @returns Context limit in tokens.
+ */
+export function getContextLimit(model) {
+    for (const [key, limit] of Object.entries(CONTEXT_LIMITS)) {
+        if (model.includes(key))
+            return limit;
+    }
+    return 128000; // default fallback
+}
+/**
+ * Model pricing: `[inputPerMTok, outputPerMTok]` in USD.
+ *
+ * Keys ordered most-specific-first to avoid substring false matches
+ * (e.g. `gpt-4o-mini` before `gpt-4o`).
+ */
+export const MODEL_PRICING = {
+    "claude-opus-4": [15, 75],
+    "claude-sonnet-4": [3, 15],
+    "claude-haiku-4": [0.8, 4],
+    "claude-3-5-sonnet": [3, 15],
+    "claude-3-5-haiku": [0.8, 4],
+    "claude-3-opus": [15, 75],
+    "gpt-4o-mini": [0.15, 0.6],
+    "gpt-4o": [2.5, 10],
+    "gpt-4-turbo": [10, 30],
+    "gpt-4": [30, 60],
+    "o4-mini": [1.1, 4.4],
+    "o3-mini": [1.1, 4.4],
+    o3: [10, 40],
+    "o1-mini": [3, 12],
+    o1: [15, 60],
+    // Codex (subscription estimate)
+    "gpt-5.3-codex": [1.75, 14],
+    "gpt-5.2-codex": [1.75, 14],
+    "gpt-5.1-codex-mini": [0.25, 2],
+    "gpt-5.1-codex": [1.25, 10],
+    "gpt-5-codex": [1.25, 10],
+    // Gemini
+    "gemini-2.5-pro": [1.25, 10],
+    "gemini-2.5-flash": [0.15, 0.6],
+    "gemini-2.0-flash": [0.1, 0.4],
+    "gemini-1.5-pro": [1.25, 5],
+    "gemini-1.5-flash": [0.075, 0.3],
+};
+/**
+ * Estimate cost in USD for a request/response token pair using `MODEL_PRICING`.
+ *
+ * @param model - Model identifier (substring matched against known keys).
+ * @param inputTokens - Input/prompt tokens.
+ * @param outputTokens - Output/completion tokens.
+ * @returns Cost in USD, rounded to 6 decimals; `null` if the model is unknown.
+ */
+export function estimateCost(model, inputTokens, outputTokens) {
+    for (const [key, [inp, out]] of Object.entries(MODEL_PRICING)) {
+        if (model.includes(key)) {
+            return (Math.round(((inputTokens * inp + outputTokens * out) / 1_000_000) * 1_000_000) / 1_000_000);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=models.js.map

package/dist/core/models.js.map

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

package/dist/core/parse.d.ts

@@ -0,0 +1,17 @@
+import type { ContextInfo } from "../types.js";
+/**
+ * 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 declare function parseContextInfo(provider: string, body: Record<string, any>, apiFormat: string): ContextInfo;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/core/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,WAAW,EAAiB,MAAM,aAAa,CAAC;AA2J5E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,SAAS,EAAE,MAAM,GAChB,WAAW,CAmMb"}