context-lens 0.2.1 → 0.3.0

package/dist/core/tokens.d.ts

@@ -1,11 +1,29 @@
 /**
  * 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.
+ * Approximates tokens as `ceil(chars / 4)`. For image content blocks,
+ * uses a fixed per-image estimate instead of stringifying base64 data.
  *
  * @param text - Value to estimate tokens for. Objects are stringified as JSON.
  * @returns Estimated token count (>= 0).
  */
 export declare function estimateTokens(text: unknown): number;
+/**
+ * Rescale all token sub-fields in a ContextInfo so they are internally
+ * consistent with an authoritative total (typically from API usage data).
+ *
+ * Adjusts `systemTokens`, `toolsTokens`, per-message `.tokens`, and
+ * `messagesTokens` proportionally, then applies a rounding residual fix
+ * to `messagesTokens` so the invariant
+ * `totalTokens === systemTokens + toolsTokens + messagesTokens` holds exactly.
+ */
+export declare function rescaleContextTokens(ci: {
+    systemTokens: number;
+    toolsTokens: number;
+    messagesTokens: number;
+    totalTokens: number;
+    messages: {
+        tokens: number;
+    }[];
+}, authoritative: number): void;
 //# sourceMappingURL=tokens.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/core/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAIpD"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/core/tokens.ts"],"names":[],"mappings":"AA8DA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAqBpD;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChC,EACD,aAAa,EAAE,MAAM,GACpB,IAAI,CAyCN"}

package/dist/core/tokens.js

@@ -1,8 +1,65 @@
+/**
+ * Approximate token cost for a single image.
+ *
+ * Anthropic charges based on image dimensions (~1,600 tokens per 512x512 tile).
+ * Since we don't decode image data, we use a conservative flat estimate of 1,600
+ * tokens (one tile). Most screenshots cost 2,000-6,400 tokens, so this slightly
+ * under-counts but is far better than stringifying megabytes of base64.
+ */
+const IMAGE_TOKEN_ESTIMATE = 1_600;
+/**
+ * Return true if the value looks like an image content block.
+ *
+ * Matches Anthropic `{type:"image", source:{type:"base64", data:"..."}}`,
+ * OpenAI `{type:"image_url", image_url:{url:"data:..."}}`,
+ * and Gemini `{inlineData:{...}}` / `{fileData:{...}}`.
+ */
+function isImageBlock(val) {
+    if (!val || typeof val !== "object" || Array.isArray(val))
+        return false;
+    const obj = val;
+    if (obj.type === "image" || obj.type === "image_url")
+        return true;
+    if (obj.inlineData || obj.fileData)
+        return true;
+    return false;
+}
+/**
+ * Strip base64 image data from a value before stringifying for token estimation.
+ *
+ * Walks arrays and recognizes image blocks at any nesting level (top-level content
+ * arrays, tool_result content arrays, Gemini parts). Image blocks are replaced with
+ * a sentinel so the rest of the structure is still counted.
+ */
+function stripImageData(val) {
+    if (!val || typeof val !== "object")
+        return val;
+    if (Array.isArray(val)) {
+        return val.map(stripImageData);
+    }
+    // Image block: return a lightweight placeholder
+    if (isImageBlock(val)) {
+        return {
+            type: val.type || "image",
+            _image: true,
+        };
+    }
+    const obj = val;
+    // tool_result blocks can nest image blocks inside their content array
+    if (obj.type === "tool_result" && Array.isArray(obj.content)) {
+        return { ...obj, content: obj.content.map(stripImageData) };
+    }
+    // Gemini turn: parts array may contain inlineData
+    if (Array.isArray(obj.parts)) {
+        return { ...obj, parts: obj.parts.map(stripImageData) };
+    }
+    return obj;
+}
 /**
  * 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.
+ * Approximates tokens as `ceil(chars / 4)`. For image content blocks,
+ * uses a fixed per-image estimate instead of stringifying base64 data.
  *
  * @param text - Value to estimate tokens for. Objects are stringified as JSON.
  * @returns Estimated token count (>= 0).
@@ -10,7 +67,97 @@
 export function estimateTokens(text) {
     if (!text)
         return 0;
-    const s = typeof text === "object" ? JSON.stringify(text) : String(text);
-    return Math.ceil(s.length / 4);
+    // Fast path: plain strings never contain image data
+    if (typeof text === "string") {
+        return Math.ceil(text.length / 4);
+    }
+    // Single image block
+    if (isImageBlock(text)) {
+        return IMAGE_TOKEN_ESTIMATE;
+    }
+    // Object/array: strip image data, then stringify the rest
+    const cleaned = stripImageData(text);
+    const s = JSON.stringify(cleaned);
+    const baseTokens = Math.ceil(s.length / 4);
+    // Count image blocks and add fixed estimate for each
+    const imageCount = countImages(text);
+    return baseTokens + imageCount * IMAGE_TOKEN_ESTIMATE;
+}
+/**
+ * Count the number of image blocks in a value (recursive).
+ */
+function countImages(val) {
+    if (!val || typeof val !== "object")
+        return 0;
+    if (isImageBlock(val))
+        return 1;
+    if (Array.isArray(val)) {
+        let count = 0;
+        for (const item of val) {
+            count += countImages(item);
+        }
+        return count;
+    }
+    const obj = val;
+    // Check nested content in tool_result blocks
+    if (obj.type === "tool_result" && Array.isArray(obj.content)) {
+        return countImages(obj.content);
+    }
+    // Check Gemini parts
+    if (Array.isArray(obj.parts)) {
+        return countImages(obj.parts);
+    }
+    return 0;
+}
+/**
+ * Rescale all token sub-fields in a ContextInfo so they are internally
+ * consistent with an authoritative total (typically from API usage data).
+ *
+ * Adjusts `systemTokens`, `toolsTokens`, per-message `.tokens`, and
+ * `messagesTokens` proportionally, then applies a rounding residual fix
+ * to `messagesTokens` so the invariant
+ * `totalTokens === systemTokens + toolsTokens + messagesTokens` holds exactly.
+ */
+export function rescaleContextTokens(ci, authoritative) {
+    const estimated = ci.systemTokens + ci.toolsTokens + ci.messagesTokens;
+    if (estimated === 0 || authoritative === 0) {
+        ci.systemTokens = 0;
+        ci.toolsTokens = 0;
+        ci.messagesTokens = 0;
+        ci.totalTokens = authoritative;
+        for (const msg of ci.messages) {
+            msg.tokens = 0;
+        }
+        return;
+    }
+    if (authoritative === estimated) {
+        ci.totalTokens = authoritative;
+        return;
+    }
+    const scale = authoritative / estimated;
+    ci.systemTokens = Math.round(ci.systemTokens * scale);
+    ci.toolsTokens = Math.round(ci.toolsTokens * scale);
+    for (const msg of ci.messages) {
+        msg.tokens = Math.round(msg.tokens * scale);
+    }
+    ci.messagesTokens = ci.messages.reduce((s, m) => s + m.tokens, 0);
+    ci.totalTokens = authoritative;
+    // Fix rounding residual so both invariants hold:
+    //   totalTokens === systemTokens + toolsTokens + messagesTokens
+    //   messagesTokens === sum(msg.tokens)
+    const residual = authoritative - (ci.systemTokens + ci.toolsTokens + ci.messagesTokens);
+    if (residual !== 0) {
+        ci.messagesTokens += residual;
+        // Push the residual into the largest per-message entry (or first if tied)
+        // so sum(msg.tokens) stays equal to messagesTokens.
+        if (ci.messages.length > 0) {
+            let maxIdx = 0;
+            for (let i = 1; i < ci.messages.length; i++) {
+                if (ci.messages[i].tokens > ci.messages[maxIdx].tokens)
+                    maxIdx = i;
+            }
+            ci.messages[maxIdx].tokens += residual;
+        }
+    }
 }
 //# sourceMappingURL=tokens.js.map

package/dist/core/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/core/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/core/tokens.ts"],"names":[],"mappings":"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"}

package/dist/core.d.ts

@@ -4,10 +4,12 @@
  * This is intentionally a thin facade: other parts of the codebase import from here,
  * while implementations live in `src/core/*` to keep concerns separated.
  */
-export { computeAgentKey, computeFingerprint, extractConversationLabel, extractReadableText, extractSessionId, extractUserPrompt, extractWorkingDirectory, } from "./core/conversation.js";
+export { computeAgentKey, computeFingerprint, extractConversationLabel, extractReadableText, extractSessionId, extractToolsUsed, extractUserPrompt, extractWorkingDirectory, } from "./core/conversation.js";
+export { computeHealthScore } from "./core/health.js";
 export { estimateCost, getContextLimit, } from "./core/models.js";
 export { parseContextInfo } from "./core/parse.js";
 export { detectApiFormat, detectProvider, extractSource, resolveTargetUrl, } from "./core/routing.js";
+export { scanSecurity } from "./core/security.js";
 export { detectSource } from "./core/source.js";
-export { estimateTokens } from "./core/tokens.js";
+export { estimateTokens, rescaleContextTokens } from "./core/tokens.js";
 //# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core.js

@@ -4,10 +4,12 @@
  * This is intentionally a thin facade: other parts of the codebase import from here,
  * while implementations live in `src/core/*` to keep concerns separated.
  */
-export { computeAgentKey, computeFingerprint, extractConversationLabel, extractReadableText, extractSessionId, extractUserPrompt, extractWorkingDirectory, } from "./core/conversation.js";
+export { computeAgentKey, computeFingerprint, extractConversationLabel, extractReadableText, extractSessionId, extractToolsUsed, extractUserPrompt, extractWorkingDirectory, } from "./core/conversation.js";
+export { computeHealthScore } from "./core/health.js";
 export { estimateCost, getContextLimit, } from "./core/models.js";
 export { parseContextInfo } from "./core/parse.js";
 export { detectApiFormat, detectProvider, extractSource, resolveTargetUrl, } from "./core/routing.js";
+export { scanSecurity } from "./core/security.js";
 export { detectSource } from "./core/source.js";
-export { estimateTokens } from "./core/tokens.js";
+export { estimateTokens, rescaleContextTokens } from "./core/tokens.js";
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lhar/composition.d.ts

@@ -0,0 +1,12 @@
+import type { CompositionEntry } from "../lhar-types.generated.js";
+import type { ContextInfo } from "../types.js";
+export declare function analyzeComposition(contextInfo: ContextInfo, rawBody: Record<string, any> | undefined): CompositionEntry[];
+/**
+ * Normalize composition token counts so their sum equals an authoritative total.
+ *
+ * Scales each entry proportionally and applies a rounding residual fix on the
+ * largest entry so `sum(composition[].tokens) === authoritative` exactly.
+ * Also recomputes `pct` fields.
+ */
+export declare function normalizeComposition(composition: CompositionEntry[], authoritative: number): void;
+//# sourceMappingURL=composition.d.ts.map

package/dist/lhar/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/lhar/composition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GACvC,gBAAgB,EAAE,CAwEpB;AA8KD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,aAAa,EAAE,MAAM,GACpB,IAAI,CAgCN"}

package/dist/lhar/composition.js

@@ -0,0 +1,258 @@
+import { estimateTokens } from "../core.js";
+export function analyzeComposition(contextInfo, rawBody) {
+    const counts = new Map();
+    function add(category, tokens) {
+        const existing = counts.get(category);
+        if (existing) {
+            existing.tokens += tokens;
+            existing.count += 1;
+        }
+        else {
+            counts.set(category, { tokens, count: 1 });
+        }
+    }
+    if (!rawBody) {
+        // Fallback to contextInfo aggregates
+        if (contextInfo.systemTokens > 0)
+            add("system_prompt", contextInfo.systemTokens);
+        if (contextInfo.toolsTokens > 0)
+            add("tool_definitions", contextInfo.toolsTokens);
+        if (contextInfo.messagesTokens > 0)
+            add("other", contextInfo.messagesTokens);
+        return buildCompositionArray(counts, contextInfo.totalTokens);
+    }
+    // System prompt(s)
+    if (rawBody.system) {
+        if (typeof rawBody.system === "string") {
+            add("system_prompt", estimateTokens(rawBody.system));
+        }
+        else if (Array.isArray(rawBody.system)) {
+            for (const block of rawBody.system) {
+                // cache_control metadata is negligible; count only the text content
+                add("system_prompt", estimateTokens(block.text || block));
+            }
+        }
+    }
+    // Instructions (OpenAI Responses API / ChatGPT)
+    if (rawBody.instructions) {
+        add("system_prompt", estimateTokens(rawBody.instructions));
+    }
+    // Tool definitions
+    if (rawBody.tools && Array.isArray(rawBody.tools)) {
+        add("tool_definitions", estimateTokens(JSON.stringify(rawBody.tools)));
+    }
+    // Gemini/Code Assist: unwrap .request wrapper if present
+    const geminiBody = rawBody.request || rawBody;
+    // Gemini systemInstruction
+    if (geminiBody.systemInstruction) {
+        const parts = geminiBody.systemInstruction.parts || [];
+        add("system_prompt", estimateTokens(parts.map((p) => p.text || "").join("\n")));
+    }
+    // Gemini contents[] or standard messages[]/input[]
+    const messages = geminiBody.contents || rawBody.messages || rawBody.input;
+    if (Array.isArray(messages)) {
+        for (const msg of messages) {
+            classifyMessage(msg, add);
+        }
+    }
+    else if (typeof messages === "string") {
+        add("user_text", estimateTokens(messages));
+    }
+    const total = Array.from(counts.values()).reduce((s, e) => s + e.tokens, 0);
+    return buildCompositionArray(counts, total);
+}
+function classifyMessage(msg, add) {
+    const type = msg.type || "";
+    // OpenAI Responses API typed items (no role field)
+    if (!msg.role && type) {
+        if (type === "function_call" || type === "custom_tool_call") {
+            add("tool_calls", estimateTokens(msg));
+            return;
+        }
+        if (type === "function_call_output" || type === "custom_tool_call_output") {
+            add("tool_results", estimateTokens(msg.output || ""));
+            return;
+        }
+        if (type === "reasoning") {
+            add("thinking", estimateTokens(msg));
+            return;
+        }
+        if (type === "output_text") {
+            add("assistant_text", estimateTokens(msg.text || ""));
+            return;
+        }
+        if (type === "input_text") {
+            add("user_text", estimateTokens(msg.text || ""));
+            return;
+        }
+    }
+    const role = msg.role || "user";
+    const content = msg.content;
+    // System / developer messages
+    if (role === "system" || role === "developer") {
+        add("system_prompt", estimateTokens(content));
+        return;
+    }
+    // String content
+    if (typeof content === "string") {
+        if (content.includes("<system-reminder>")) {
+            add("system_injections", estimateTokens(content));
+        }
+        else if (role === "assistant") {
+            add("assistant_text", estimateTokens(content));
+        }
+        else {
+            add("user_text", estimateTokens(content));
+        }
+        return;
+    }
+    // Gemini parts array (role + parts instead of role + content)
+    if (msg.parts && Array.isArray(msg.parts)) {
+        for (const part of msg.parts) {
+            classifyGeminiPart(part, role, add);
+        }
+        return;
+    }
+    // Array of content blocks
+    if (Array.isArray(content)) {
+        for (const block of content) {
+            classifyBlock(block, role, add);
+        }
+        return;
+    }
+    // Fallback
+    if (content) {
+        add("other", estimateTokens(content));
+    }
+}
+function classifyBlock(block, role, add) {
+    const type = block.type || "";
+    if (type === "tool_use") {
+        add("tool_calls", estimateTokens(block));
+        return;
+    }
+    if (type === "tool_result") {
+        add("tool_results", estimateTokens(block.content || ""));
+        return;
+    }
+    if (type === "thinking") {
+        add("thinking", estimateTokens(block.thinking || block.text || ""));
+        return;
+    }
+    if (type === "image" || type === "image_url") {
+        add("images", estimateTokens(block)); // estimateTokens handles image blocks with fixed estimate
+        return;
+    }
+    // Text blocks
+    const text = block.text || "";
+    if (type === "text" || type === "input_text" || !type) {
+        if (text.includes("<system-reminder>")) {
+            add("system_injections", estimateTokens(text));
+        }
+        else if (block.cache_control) {
+            // Count text in its natural category only; the cache_control metadata
+            // itself is negligible overhead and should not inflate the total.
+            if (role === "assistant") {
+                add("assistant_text", estimateTokens(text));
+            }
+            else {
+                add("user_text", estimateTokens(text));
+            }
+        }
+        else if (role === "assistant") {
+            add("assistant_text", estimateTokens(text));
+        }
+        else {
+            add("user_text", estimateTokens(text));
+        }
+        return;
+    }
+    add("other", estimateTokens(block));
+}
+function classifyGeminiPart(part, role, add) {
+    if (part.text) {
+        if (role === "model") {
+            add("assistant_text", estimateTokens(part.text));
+        }
+        else {
+            add("user_text", estimateTokens(part.text));
+        }
+        return;
+    }
+    if (part.functionCall) {
+        add("tool_calls", estimateTokens(part.functionCall));
+        return;
+    }
+    if (part.functionResponse) {
+        add("tool_results", estimateTokens(part.functionResponse));
+        return;
+    }
+    if (part.inlineData || part.fileData) {
+        add("images", estimateTokens(part));
+        return;
+    }
+    if (part.executableCode || part.codeExecutionResult) {
+        add("assistant_text", estimateTokens(part));
+        return;
+    }
+    add("other", estimateTokens(part));
+}
+function buildCompositionArray(counts, total) {
+    const result = [];
+    for (const [category, { tokens, count }] of counts) {
+        if (tokens === 0)
+            continue;
+        result.push({
+            category,
+            tokens,
+            pct: total > 0 ? Math.round((tokens / total) * 1000) / 10 : 0,
+            count,
+        });
+    }
+    // Sort by tokens descending
+    result.sort((a, b) => b.tokens - a.tokens);
+    return result;
+}
+/**
+ * Normalize composition token counts so their sum equals an authoritative total.
+ *
+ * Scales each entry proportionally and applies a rounding residual fix on the
+ * largest entry so `sum(composition[].tokens) === authoritative` exactly.
+ * Also recomputes `pct` fields.
+ */
+export function normalizeComposition(composition, authoritative) {
+    if (composition.length === 0)
+        return;
+    const rawSum = composition.reduce((s, c) => s + c.tokens, 0);
+    if (rawSum === 0 || authoritative === 0)
+        return;
+    if (rawSum === authoritative) {
+        // Already matches; just recompute pct for consistency
+        for (const c of composition) {
+            c.pct =
+                authoritative > 0
+                    ? Math.round((c.tokens / authoritative) * 1000) / 10
+                    : 0;
+        }
+        return;
+    }
+    const scale = authoritative / rawSum;
+    let running = 0;
+    for (const c of composition) {
+        c.tokens = Math.round(c.tokens * scale);
+        running += c.tokens;
+    }
+    // Fix rounding residual on the first (largest) entry
+    const residual = authoritative - running;
+    if (residual !== 0) {
+        composition[0].tokens += residual;
+    }
+    // Recompute pct
+    for (const c of composition) {
+        c.pct =
+            authoritative > 0
+                ? Math.round((c.tokens / authoritative) * 1000) / 10
+                : 0;
+    }
+}
+//# sourceMappingURL=composition.js.map

package/dist/lhar/composition.js.map

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

package/dist/lhar/export.d.ts

@@ -0,0 +1,5 @@
+import type { LharJsonWrapper } from "../lhar-types.generated.js";
+import type { CapturedEntry, Conversation, PrivacyLevel } from "../types.js";
+export declare function toLharJsonl(entries: CapturedEntry[], conversations: Map<string, Conversation>, privacy?: PrivacyLevel): string;
+export declare function toLharJson(entries: CapturedEntry[], conversations: Map<string, Conversation>, privacy?: PrivacyLevel): LharJsonWrapper;
+//# sourceMappingURL=export.d.ts.map

package/dist/lhar/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/lhar/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY7E,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EAAE,EACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACxC,OAAO,GAAE,YAAyB,GACjC,MAAM,CAmCR;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EAAE,EACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACxC,OAAO,GAAE,YAAyB,GACjC,eAAe,CAwCjB"}

package/dist/lhar/export.js

@@ -0,0 +1,59 @@
+import { VERSION } from "../version.generated.js";
+import { buildLharRecord, buildSessionLine, traceIdFromConversation, } from "./record.js";
+const COLLECTOR_NAME = "context-lens";
+const COLLECTOR_VERSION = VERSION;
+const LHAR_VERSION = "0.1.0";
+export function toLharJsonl(entries, conversations, privacy = "standard") {
+    // Sort oldest-first for JSONL
+    const sorted = [...entries].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    const lines = [];
+    const emittedSessions = new Set();
+    for (const entry of sorted) {
+        const record = buildLharRecord(entry, entries, privacy);
+        // Emit session preamble on first occurrence of each trace_id
+        if (!emittedSessions.has(record.trace_id)) {
+            emittedSessions.add(record.trace_id);
+            const convo = entry.conversationId
+                ? conversations.get(entry.conversationId)
+                : undefined;
+            if (convo) {
+                lines.push(JSON.stringify(buildSessionLine(entry.conversationId, convo, record.gen_ai.request.model)));
+            }
+        }
+        lines.push(JSON.stringify(record));
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function toLharJson(entries, conversations, privacy = "standard") {
+    const sorted = [...entries].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    const records = sorted.map((entry) => buildLharRecord(entry, entries, privacy));
+    // Build sessions from conversations map
+    const sessions = [];
+    const seenTraces = new Set();
+    for (const record of records) {
+        if (!seenTraces.has(record.trace_id)) {
+            seenTraces.add(record.trace_id);
+            const convo = record.trace_id
+                ? Array.from(conversations.values()).find((c) => traceIdFromConversation(c.id) === record.trace_id)
+                : undefined;
+            sessions.push({
+                trace_id: record.trace_id,
+                started_at: convo?.firstSeen || record.timestamp,
+                tool: record.source.tool,
+                model: record.gen_ai.request.model,
+            });
+        }
+    }
+    return {
+        lhar: {
+            version: LHAR_VERSION,
+            creator: {
+                name: COLLECTOR_NAME,
+                version: COLLECTOR_VERSION,
+            },
+            sessions,
+            entries: records,
+        },
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/lhar/export.js.map

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

package/dist/lhar/record.d.ts

@@ -0,0 +1,6 @@
+import type { LharRecord, LharSessionLine } from "../lhar-types.generated.js";
+import type { CapturedEntry, Conversation, PrivacyLevel } from "../types.js";
+export declare function traceIdFromConversation(conversationId: string | null): string;
+export declare function buildLharRecord(entry: CapturedEntry, prevEntries: CapturedEntry[], privacy?: PrivacyLevel): LharRecord;
+export declare function buildSessionLine(conversationId: string, conversation: Conversation, model: string): LharSessionLine;
+//# sourceMappingURL=record.d.ts.map

package/dist/lhar/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/lhar/record.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY7E,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI7E;AA2BD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,aAAa,EAAE,EAC5B,OAAO,GAAE,YAAyB,GACjC,UAAU,CAqMZ;AAED,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,MAAM,GACZ,eAAe,CAQjB"}