@codingame/monaco-vscode-chat-service-override 31.0.0 → 32.0.0

package/vscode/src/vs/workbench/contrib/chat/browser/chatDebug/chatCustomizationDiscoveryRenderer.js

@@ -134,14 +134,14 @@ function renderCustomizationDiscoveryContent(
     const container = $("div.chat-debug-file-list");
     container.tabIndex = 0;
     const capitalizedType = content.discoveryType.charAt(0).toUpperCase() + content.discoveryType.slice(1);
-    append(container, $("div.chat-debug-file-list-title", undefined, ( localize(5849, "{0} Discovery Results", capitalizedType))));
-    append(container, $("div.chat-debug-file-list-summary", undefined, ( localize(5850, "Total files: {0}", content.files.length))));
+    append(container, $("div.chat-debug-file-list-title", undefined, ( localize(5975, "{0} Discovery Results", capitalizedType))));
+    append(container, $("div.chat-debug-file-list-summary", undefined, ( localize(5976, "Total files: {0}", content.files.length))));
     const loaded = content.files.filter(f => f.status === "loaded");
     if (loaded.length > 0) {
         const section = append(container, $("div.chat-debug-file-list-section"));
         append(
             section,
-            $("div.chat-debug-file-list-section-title", undefined, ( localize(5851, "Loaded ({0})", loaded.length)))
+            $("div.chat-debug-file-list-section-title", undefined, ( localize(5977, "Loaded ({0})", loaded.length)))
         );
         const groups = ( new Map());
         for (const file of loaded) {
@@ -155,7 +155,7 @@ function renderCustomizationDiscoveryContent(
         }
         const listEl = append(section, $("div.chat-debug-file-list-rows"));
         listEl.setAttribute("role", "list");
-        listEl.setAttribute("aria-label", ( localize(5852, "Loaded files")));
+        listEl.setAttribute("aria-label", ( localize(5978, "Loaded files")));
         const rows = [];
         for (const [locationLabel, files] of groups) {
             const groupHeader = append(listEl, $("div.chat-debug-file-list-group-header"));
@@ -168,7 +168,7 @@ function renderCustomizationDiscoveryContent(
                 link.textContent = locationLabel;
                 link.tabIndex = -1;
                 disposables.add(
-                    hoverService.setupManagedHover(getDefaultHoverDelegate("element"), link, ( localize(5853, "Open {0} in Extensions", firstFile.extensionId)))
+                    hoverService.setupManagedHover(getDefaultHoverDelegate("element"), link, ( localize(5979, "Open {0} in Extensions", firstFile.extensionId)))
                 );
                 disposables.add(addDisposableListener(link, EventType.CLICK, e => {
                     e.preventDefault();
@@ -224,11 +224,11 @@ function renderCustomizationDiscoveryContent(
         const section = append(container, $("div.chat-debug-file-list-section"));
         append(
             section,
-            $("div.chat-debug-file-list-section-title", undefined, ( localize(5854, "Skipped ({0})", skipped.length)))
+            $("div.chat-debug-file-list-section-title", undefined, ( localize(5980, "Skipped ({0})", skipped.length)))
         );
         const groups = ( new Map());
         for (const file of skipped) {
-            const key = file.skipReason ?? ( localize(5855, "unknown"));
+            const key = file.skipReason ?? ( localize(5981, "unknown"));
             let group = groups.get(key);
             if (!group) {
                 group = [];
@@ -238,7 +238,7 @@ function renderCustomizationDiscoveryContent(
         }
         const listEl = append(section, $("div.chat-debug-file-list-rows"));
         listEl.setAttribute("role", "list");
-        listEl.setAttribute("aria-label", ( localize(5856, "Skipped files")));
+        listEl.setAttribute("aria-label", ( localize(5982, "Skipped files")));
         const rows = [];
         for (const [reasonLabel, files] of groups) {
             const groupHeader = append(listEl, $("div.chat-debug-file-list-group-header"));
@@ -260,7 +260,7 @@ function renderCustomizationDiscoveryContent(
                     if (detail) {
                         detail += ", ";
                     }
-                    detail += ( localize(5857, "duplicate of {0}", file.duplicateOf.path));
+                    detail += ( localize(5983, "duplicate of {0}", file.duplicateOf.path));
                 }
                 row.appendChild(createInlineFileLink(
                     file.uri,
@@ -299,13 +299,13 @@ function renderCustomizationDiscoveryContent(
         const chevron = append(header, $("span.chat-debug-message-section-chevron"));
         append(
             header,
-            $("span.chat-debug-message-section-title", undefined, ( localize(5858, "Sources ({0})", content.sourceFolders.length)))
+            $("span.chat-debug-message-section-title", undefined, ( localize(5984, "Sources ({0})", content.sourceFolders.length)))
         );
         const settingsKey = getSettingsKeyForDiscoveryType(content.discoveryType);
         if (settingsKey) {
             const gearBtn = disposables.add(( new Button(header, {
-                title: ( localize(5859, "Configure locations")),
-                ariaLabel: ( localize(5860, "Configure locations")),
+                title: ( localize(5985, "Configure locations")),
+                ariaLabel: ( localize(5986, "Configure locations")),
                 hoverDelegate: getDefaultHoverDelegate("mouse")
             })));
             gearBtn.icon = Codicon.settingsGear;
@@ -334,13 +334,13 @@ function renderCustomizationDiscoveryContent(
         const contentEl = append(sectionEl, $("div.chat-debug-source-folder-content"));
         contentEl.tabIndex = 0;
         contentEl.setAttribute("role", "region");
-        contentEl.setAttribute("aria-label", ( localize(5861, "Source folders")));
+        contentEl.setAttribute("aria-label", ( localize(5987, "Source folders")));
         const capitalizedType = content.discoveryType.charAt(0).toUpperCase() + content.discoveryType.slice(1);
         const sourcesCaption = capitalizedType.endsWith("s") ? capitalizedType : capitalizedType + "s";
         append(
             contentEl,
             $("div.chat-debug-source-folder-note", undefined, ( localize(
-                5862,
+                5988,
                 "{0} were discovered by checking the following sources in order:",
                 sourcesCaption
             )))
@@ -368,13 +368,13 @@ function renderCustomizationDiscoveryContent(
 function fileListToPlainText(content) {
     const lines = [];
     const capitalizedType = content.discoveryType.charAt(0).toUpperCase() + content.discoveryType.slice(1);
-    lines.push(( localize(5863, "{0} Discovery Results", capitalizedType)));
-    lines.push(( localize(5864, "Total files: {0}", content.files.length)));
+    lines.push(( localize(5989, "{0} Discovery Results", capitalizedType)));
+    lines.push(( localize(5990, "Total files: {0}", content.files.length)));
     lines.push("");
     const loaded = content.files.filter(f => f.status === "loaded");
     const skipped = content.files.filter(f => f.status === "skipped");
     if (loaded.length > 0) {
-        lines.push(( localize(5865, "Loaded ({0})", loaded.length)));
+        lines.push(( localize(5991, "Loaded ({0})", loaded.length)));
         const groups = ( new Map());
         for (const f of loaded) {
             const parentDir = content.discoveryType === "skill" ? dirname(dirname(f.uri)) : dirname(f.uri);
@@ -396,10 +396,10 @@ function fileListToPlainText(content) {
         lines.push("");
     }
     if (skipped.length > 0) {
-        lines.push(( localize(5866, "Skipped ({0})", skipped.length)));
+        lines.push(( localize(5992, "Skipped ({0})", skipped.length)));
         const skippedGroups = ( new Map());
         for (const f of skipped) {
-            const key = f.skipReason ?? ( localize(5867, "unknown"));
+            const key = f.skipReason ?? ( localize(5993, "unknown"));
             let group = skippedGroups.get(key);
             if (!group) {
                 group = [];
@@ -418,7 +418,7 @@ function fileListToPlainText(content) {
                         parts.push(f.errorMessage);
                     }
                     if (f.duplicateOf) {
-                        parts.push(( localize(5868, "duplicate of {0}", f.duplicateOf.path)));
+                        parts.push(( localize(5994, "duplicate of {0}", f.duplicateOf.path)));
                     }
                     detail += ` (${parts.join(", ")})`;
                 }
@@ -428,7 +428,7 @@ function fileListToPlainText(content) {
     }
     if (content.sourceFolders && content.sourceFolders.length > 0) {
         lines.push("");
-        lines.push(( localize(5869, "Sources ({0})", content.sourceFolders.length)));
+        lines.push(( localize(5995, "Sources ({0})", content.sourceFolders.length)));
         for (const folder of content.sourceFolders) {
             lines.push(`  ${folder.uri.path}`);
         }
@@ -438,17 +438,17 @@ function fileListToPlainText(content) {
 function getCategorySectionTitle(category, count) {
     switch (category) {
     case "applying":
-        return localize(5870, "Instructions ({0})", count);
+        return localize(5996, "Instructions ({0})", count);
     case "referenced":
-        return localize(5871, "Referenced ({0})", count);
+        return localize(5997, "Referenced ({0})", count);
     case "skill":
-        return localize(5872, "Skills ({0})", count);
+        return localize(5998, "Skills ({0})", count);
     case "custom-agent":
-        return localize(5873, "Agents ({0})", count);
+        return localize(5999, "Agents ({0})", count);
     case "hook":
-        return localize(5874, "Hooks ({0})", count);
+        return localize(6000, "Hooks ({0})", count);
     case "skipped":
-        return localize(5875, "Skipped ({0})", count);
+        return localize(6001, "Skipped ({0})", count);
     }
 }
 function renderCustomizationSummaryContent(
@@ -464,11 +464,11 @@ function renderCustomizationSummaryContent(
     const container = $("div.chat-debug-customization-summary");
     container.tabIndex = 0;
     const mainSection = append(container, $("div.chat-debug-file-list"));
-    append(mainSection, $("div.chat-debug-file-list-title", undefined, ( localize(5876, "Customization Resolution Results"))));
+    append(mainSection, $("div.chat-debug-file-list-title", undefined, ( localize(6002, "Customization Resolution Results"))));
     append(
         mainSection,
         $("div.chat-debug-file-list-summary", undefined, ( localize(
-            5877,
+            6003,
             "{0} instructions, {1} skills, {2} agents, {3} hooks, {4} skipped in {5}ms",
             content.counts.instructions,
             content.counts.skills,
@@ -614,7 +614,7 @@ function renderCustomizationSummaryContent(
     if (content.resolutionLogs.length === 0) {
         append(
             mainSection,
-            $("div.chat-debug-file-list-summary", undefined, ( localize(5878, "No resolution logs")))
+            $("div.chat-debug-file-list-summary", undefined, ( localize(6004, "No resolution logs")))
         );
     }
     return {
@@ -624,9 +624,9 @@ function renderCustomizationSummaryContent(
 }
 function customizationSummaryToPlainText(content) {
     const lines = [];
-    lines.push(( localize(5879, "Customization Resolution Results")));
+    lines.push(( localize(6005, "Customization Resolution Results")));
     lines.push(( localize(
-        5880,
+        6006,
         "{0} instructions, {1} skills, {2} agents, {3} hooks, {4} skipped in {5}ms",
         content.counts.instructions,
         content.counts.skills,

package/vscode/src/vs/workbench/contrib/chat/browser/chatDebug/chatDebugCacheDiff.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Pure helpers used by the Cache Explorer to compare two model-turn requests
+ * (A and B) and identify where the prompt prefix diverges.
+ *
+ * The engine works on the {@link IChatDebugEventModelTurnContent.sections}
+ * "Input Messages" section, which is a JSON-stringified array of
+ *   `[{ role, name?, parts: [{ type: 'text', content, name? }, ...] }]`
+ * matching the OpenTelemetry GenAI semantic convention used by
+ * `chatParticipantTelemetry.ts`.
+ *
+ * All functions are pure — no DOM, no services — so they can be unit tested
+ * in isolation.
+ */
+/**
+ * A normalized request message used by the diff engine.
+ */
+export interface INormalizedMessage {
+    readonly role: string;
+    readonly name?: string;
+    /** Concatenation of all `text` parts in the message. */
+    readonly text: string;
+    /** Character length of `text` as a UTF-16 code unit count (`text.length`). */
+    readonly charLength: number;
+}
+/** Classification of a single signature token when comparing A and B. */
+export declare enum CacheDiffKind {
+    /** Same role+name and same charLength in both A and B. */
+    Identical = "identical",
+    /** Same role+name and same charLength but different content. */
+    ContentDrift = "contentDrift",
+    /** Same role+name but different charLength. */
+    LengthChange = "lengthChange",
+    /** Position exists only in A. */
+    OnlyInA = "onlyInA",
+    /** Position exists only in B. */
+    OnlyInB = "onlyInB"
+}
+/**
+ * A single token in the side-by-side prompt signature.
+ *
+ * The signature is computed by zipping A's and B's normalized messages
+ * positionally and classifying each index independently. The first
+ * divergence is what breaks the prompt cache, but later positions can
+ * still be reported as {@link CacheDiffKind.Identical} if their content
+ * happens to match \u2014 we surface per-position truth here and let the
+ * UI decide how to interpret it (the cache-break marker, summary copy,
+ * and "Where the cache broke" line all key off the *first* divergent
+ * index, not the last).
+ */
+export interface ICacheSignatureToken {
+    readonly index: number;
+    readonly kind: CacheDiffKind;
+    readonly aRole?: string;
+    readonly aName?: string;
+    readonly aCharLength?: number;
+    readonly bRole?: string;
+    readonly bName?: string;
+    readonly bCharLength?: number;
+}
+/**
+ * The first place where A and B's prompt prefix diverges. Anything after
+ * this index cannot be served from the prompt cache.
+ */
+export interface ICacheBreak {
+    readonly index: number;
+    readonly kind: Exclude<CacheDiffKind, CacheDiffKind.Identical>;
+}
+/**
+ * A single drifting component (e.g. a message at index N).
+ */
+export interface IComponentDrift {
+    readonly name: string;
+    readonly role?: string;
+    readonly status: CacheDiffKind;
+    readonly aSize: number;
+    readonly bSize: number;
+}
+/**
+ * Aggregate result of comparing two requests.
+ */
+export interface ICacheDiffResult {
+    readonly signature: readonly ICacheSignatureToken[];
+    readonly break: ICacheBreak | undefined;
+    readonly drift: readonly IComponentDrift[];
+    /**
+     * Counts of identical / drift / one-sided positions across the whole
+     * signature. Useful for the summary pills.
+     */
+    readonly counts: {
+        readonly identical: number;
+        readonly contentDrift: number;
+        readonly lengthChange: number;
+        readonly onlyInA: number;
+        readonly onlyInB: number;
+    };
+}
+/**
+ * Parse a JSON-encoded `inputMessages` payload into normalized messages.
+ *
+ * Returns an empty array on any parse error so callers can render a clear
+ * empty-state without try/catch boilerplate.
+ */
+export declare function parseInputMessages(inputMessagesJson: string | undefined): readonly INormalizedMessage[];
+/**
+ * Compute the per-position diff between two normalized message arrays.
+ *
+ * The algorithm is intentionally simple (positional zip) rather than a full
+ * Myers diff: prompt caches are prefix-based, so the moment two messages at
+ * the same index diverge in role, length, or content the cache breaks.
+ * Reporting that first divergence is far more useful than computing a
+ * minimum edit script.
+ */
+export declare function diffPromptSignature(a: readonly INormalizedMessage[], b: readonly INormalizedMessage[]): ICacheDiffResult;
+/**
+ * Add a "system" drift entry to the report when the system instructions
+ * differ between the two requests. Inserted at the canonical
+ * {@link PREFIX_COMPONENT_ORDER} position regardless of what's already in
+ * the drift list.
+ */
+export declare function appendSystemDrift(drift: IComponentDrift[], aSystem: string | undefined, bSystem: string | undefined): IComponentDrift[];
+/**
+ * Add a "tools" drift entry to the report when the tool definitions catalog
+ * differs between the two requests. The catalog is part of the cache key on
+ * every model provider, so a change here \u2014 even a pure reorder \u2014 can break
+ * the prompt cache. We intentionally do not normalize (sort, hash, parse)
+ * the JSON: providers vary in how they hash the catalog, so the safest
+ * stance is to surface any byte-level change and let the user judge.
+ *
+ * Inserted at the canonical {@link PREFIX_COMPONENT_ORDER} position so the
+ * order is always `[system, tools, ...messages]` regardless of call order
+ * relative to {@link appendSystemDrift}.
+ */
+export declare function appendToolsDrift(drift: IComponentDrift[], aTools: string | undefined, bTools: string | undefined): IComponentDrift[];
+/**
+ * Format a normalized message into a single-line `role[-name]:bytes` token,
+ * matching the convention used by the existing `promptTypes` telemetry.
+ */
+export declare function formatSignatureToken(token: ICacheSignatureToken): string;

package/vscode/src/vs/workbench/contrib/chat/browser/chatDebug/chatDebugCacheDiff.js

@@ -0,0 +1,221 @@
+
+
+var CacheDiffKind;
+(function (CacheDiffKind) {
+    CacheDiffKind["Identical"] = "identical";
+    CacheDiffKind["ContentDrift"] = "contentDrift";
+    CacheDiffKind["LengthChange"] = "lengthChange";
+    CacheDiffKind["OnlyInA"] = "onlyInA";
+    CacheDiffKind["OnlyInB"] = "onlyInB";
+})(CacheDiffKind || (CacheDiffKind = {}));
+function parseInputMessages(inputMessagesJson) {
+    if (!inputMessagesJson) {
+        return [];
+    }
+    let raw;
+    try {
+        raw = JSON.parse(inputMessagesJson);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    const out = [];
+    for (const m of raw) {
+        if (!m || typeof m !== 'object') {
+            continue;
+        }
+        let role = typeof m.role === 'string' ? m.role : 'unknown';
+        const name = typeof m.name === 'string' ? m.name : undefined;
+        let text = '';
+        let hasToolResponse = false;
+        let hasToolCall = false;
+        let hasToolSearchOutput = false;
+        let hasText = false;
+        if (Array.isArray(m.parts)) {
+            for (const p of m.parts) {
+                if (!p || typeof p !== 'object') {
+                    continue;
+                }
+                switch (p.type) {
+                    case undefined:
+                    case 'text':
+                    case 'reasoning':
+                        if (typeof p.content === 'string') {
+                            text += p.content;
+                            hasText = true;
+                        }
+                        break;
+                    case 'tool_call_response':
+                    case 'tool_result':
+                        if (typeof p.response === 'string') {
+                            text += p.response;
+                        }
+                        else if (p.response !== undefined) {
+                            text += stableStringify(p.response);
+                        }
+                        else if (typeof p.content === 'string') {
+                            text += p.content;
+                        }
+                        else if (p.content !== undefined) {
+                            text += stableStringify(p.content);
+                        }
+                        hasToolResponse = true;
+                        break;
+                    case 'tool_call':
+                        if (p.name) {
+                            text += `call:${p.name}`;
+                        }
+                        if (p.arguments !== undefined) {
+                            text += stableStringify(p.arguments);
+                        }
+                        hasToolCall = true;
+                        break;
+                    case 'tool_search_output':
+                        text += stableStringify({
+                            id: p.id,
+                            status: p.status,
+                            tools: p.tools,
+                        });
+                        hasToolSearchOutput = true;
+                        break;
+                }
+            }
+        }
+        if (hasToolSearchOutput && !hasText) {
+            role = 'tool_search';
+        }
+        else if (hasToolResponse && !hasText) {
+            role = 'tool';
+        }
+        else if (hasToolCall && !hasText && role === 'assistant') {
+            role = 'assistant';
+        }
+        if (text.length === 0 && role === 'unknown') {
+            text = stableStringify(m);
+        }
+        out.push({ role, name, text, charLength: text.length });
+    }
+    return out;
+}
+function stableStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function messagesEqual(a, b) {
+    return a.role === b.role && a.name === b.name && a.charLength === b.charLength && a.text === b.text;
+}
+function diffPromptSignature(a, b) {
+    const signature = [];
+    const drift = [];
+    const counts = { identical: 0, contentDrift: 0, lengthChange: 0, onlyInA: 0, onlyInB: 0 };
+    let breakResult;
+    let broken = false;
+    const max = Math.max(a.length, b.length);
+    for (let i = 0; i < max; i++) {
+        const ai = a[i];
+        const bi = b[i];
+        if (ai && !bi) {
+            counts.onlyInA++;
+            signature.push({ index: i, kind: CacheDiffKind.OnlyInA, aRole: ai.role, aName: ai.name, aCharLength: ai.charLength });
+            drift.push({ name: `messages[${i}]`, role: ai.role, status: CacheDiffKind.OnlyInA, aSize: ai.charLength, bSize: 0 });
+            if (!broken) {
+                broken = true;
+                breakResult = { index: i, kind: CacheDiffKind.OnlyInA };
+            }
+            continue;
+        }
+        if (bi && !ai) {
+            counts.onlyInB++;
+            signature.push({ index: i, kind: CacheDiffKind.OnlyInB, bRole: bi.role, bName: bi.name, bCharLength: bi.charLength });
+            drift.push({ name: `messages[${i}]`, role: bi.role, status: CacheDiffKind.OnlyInB, aSize: 0, bSize: bi.charLength });
+            if (!broken) {
+                broken = true;
+                breakResult = { index: i, kind: CacheDiffKind.OnlyInB };
+            }
+            continue;
+        }
+        if (!ai || !bi) {
+            continue;
+        }
+        if (messagesEqual(ai, bi)) {
+            counts.identical++;
+            signature.push({
+                index: i, kind: CacheDiffKind.Identical,
+                aRole: ai.role, aName: ai.name, aCharLength: ai.charLength,
+                bRole: bi.role, bName: bi.name, bCharLength: bi.charLength,
+            });
+            continue;
+        }
+        const kind = ai.charLength === bi.charLength ? CacheDiffKind.ContentDrift : CacheDiffKind.LengthChange;
+        if (kind === CacheDiffKind.ContentDrift) {
+            counts.contentDrift++;
+        }
+        else {
+            counts.lengthChange++;
+        }
+        signature.push({
+            index: i, kind,
+            aRole: ai.role, aName: ai.name, aCharLength: ai.charLength,
+            bRole: bi.role, bName: bi.name, bCharLength: bi.charLength,
+        });
+        drift.push({ name: `messages[${i}]`, role: ai.role, status: kind, aSize: ai.charLength, bSize: bi.charLength });
+        if (!broken) {
+            broken = true;
+            breakResult = { index: i, kind };
+        }
+    }
+    return { signature, break: breakResult, drift, counts };
+}
+const PREFIX_COMPONENT_ORDER = ['system', 'tools'];
+function insertPrefixComponent(drift, entry) {
+    const prefixEntries = [];
+    const rest = [];
+    for (const d of drift) {
+        if (PREFIX_COMPONENT_ORDER.includes(d.name)) {
+            if (d.name !== entry.name) {
+                prefixEntries.push(d);
+            }
+        }
+        else {
+            rest.push(d);
+        }
+    }
+    prefixEntries.push(entry);
+    prefixEntries.sort((a, b) => PREFIX_COMPONENT_ORDER.indexOf(a.name) - PREFIX_COMPONENT_ORDER.indexOf(b.name));
+    return [...prefixEntries, ...rest];
+}
+function classifyStringDrift(a, b) {
+    if (a === b) {
+        return undefined;
+    }
+    if (!a) {
+        return CacheDiffKind.OnlyInB;
+    }
+    if (!b) {
+        return CacheDiffKind.OnlyInA;
+    }
+    return a.length === b.length ? CacheDiffKind.ContentDrift : CacheDiffKind.LengthChange;
+}
+function appendSystemDrift(drift, aSystem, bSystem) {
+    const status = classifyStringDrift(aSystem, bSystem);
+    if (status === undefined) {
+        return drift;
+    }
+    return insertPrefixComponent(drift, { name: 'system', status, aSize: aSystem?.length ?? 0, bSize: bSystem?.length ?? 0 });
+}
+function appendToolsDrift(drift, aTools, bTools) {
+    const status = classifyStringDrift(aTools, bTools);
+    if (status === undefined) {
+        return drift;
+    }
+    return insertPrefixComponent(drift, { name: 'tools', status, aSize: aTools?.length ?? 0, bSize: bTools?.length ?? 0 });
+}
+
+export { CacheDiffKind, appendSystemDrift, appendToolsDrift, diffPromptSignature, parseInputMessages };

package/vscode/src/vs/workbench/contrib/chat/browser/chatDebug/chatDebugCacheExplorerView.d.ts

@@ -0,0 +1,84 @@
+import { Disposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
+import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
+import { IChatDebugService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatDebugService.service";
+import { IChatService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatService/chatService.service";
+/**
+ * Navigation events fired by the Cache Explorer breadcrumb.
+ */
+export declare enum CacheExplorerNavigation {
+    Home = "home",
+    Overview = "overview"
+}
+/**
+ * Cache Explorer view — the third entry under "Explore Trace Data". Shows a
+ * left rail of model turns with their cache hit %, plus a side-by-side prompt
+ * signature diff that pinpoints where the prefix breaks.
+ *
+ * v1 reads {@link IChatDebugEventModelTurnContent} from the in-memory chat
+ * debug service via {@link IChatDebugService.resolveEvent}. Content may be
+ * truncated by the OTel attribute cap; the file-logger backed full-fidelity
+ * provider is a follow-up.
+ */
+export declare class ChatDebugCacheExplorerView extends Disposable {
+    private readonly chatService;
+    private readonly chatDebugService;
+    private readonly _onNavigate;
+    readonly onNavigate: import("@codingame/monaco-vscode-api/vscode/vs/base/common/event").Event<CacheExplorerNavigation>;
+    readonly container: HTMLElement;
+    private readonly breadcrumbWidget;
+    private readonly rail;
+    private readonly railList;
+    private readonly content;
+    private readonly sash;
+    private railWidth;
+    private readonly loadDisposables;
+    private readonly refreshScheduler;
+    private currentSessionResource;
+    private modelTurns;
+    /** Selected turn (B side). A is computed as `selectedIndex - 1`. -1 = no explicit selection yet. */
+    private selectedIndex;
+    /**
+     * Monotonically-increasing render token. Each call to {@link render}
+     * captures the current value, then re-checks it after each await; if a
+     * newer render has started in the meantime, the older one bails out
+     * before mutating the DOM. Avoids races where a slow model-turn
+     * resolve from one session writes into another's panel.
+     */
+    private renderToken;
+    /** Cache of resolved model-turn content keyed by event id. */
+    private readonly resolvedCache;
+    /** Components currently expanded (by component name). */
+    private readonly openComponents;
+    /** Rail groups currently collapsed (by group key — the parent event id). */
+    private readonly collapsedGroups;
+    constructor(parent: HTMLElement, chatService: IChatService, chatDebugService: IChatDebugService);
+    setSession(sessionResource: URI): void;
+    show(): void;
+    hide(): void;
+    refresh(): void;
+    updateBreadcrumb(): void;
+    private render;
+    private resolveSide;
+    private renderRail;
+    private renderTitleRow;
+    private renderSummary;
+    private renderSideCard;
+    /**
+     * Render the summary cards alone when there is no prior turn to diff
+     * against (e.g. the first request in a brand-new session). The OTel-
+     * reported cache hit is still useful here — the system prompt and tool
+     * definitions can already be cached from previous sessions.
+     */
+    private renderSingleSummary;
+    private appendKv;
+    private renderSignature;
+    /**
+     * Render the per-key request-options table. Shows every cache-keying
+     * option captured from the model provider request body, with a column
+     * for the previous turn and one for the current turn. Rows whose
+     * values differ are highlighted.
+     */
+    private renderRequestOptions;
+    private renderComponents;
+    private renderComponentDiff;
+}