@codingame/monaco-vscode-xterm-addons-common 28.4.1 → 29.1.0

package/vscode/src/vs/workbench/contrib/chat/common/chatDebugEvents.d.ts

@@ -0,0 +1,58 @@
+import { IChatDebugEvent } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatDebugService";
+/**
+ * Descriptions of each debug event kind for the model. Adding a new event kind
+ * to {@link IChatDebugEvent} without adding an entry here will cause a compile error.
+ */
+export declare const debugEventKindDescriptions: Record<IChatDebugEvent["kind"], string>;
+/**
+ * Formats debug events into a compact log-style summary for context attachment.
+ */
+export declare function formatDebugEventsForContext(events: readonly IChatDebugEvent[]): string;
+/**
+ * Constructs the model description for the debug events attachment,
+ * explaining to the model how to use the resolveDebugEventDetails tool.
+ */
+export declare function getDebugEventsModelDescription(): string;
+/**
+ * Checks whether a debug event matches a single text search term.
+ * Used by both the debug panel filter and the listDebugEvents tool.
+ */
+export declare function debugEventMatchesText(event: IChatDebugEvent, term: string): boolean;
+/**
+ * Parse a `before:YYYY[-MM[-DD[THH[:MM[:SS]]]]]` or `after:…` token from
+ * free-form filter text. Each component after the year is optional.
+ *
+ * For `before:`, the timestamp is rounded **up** to the end of the most
+ * specific unit given (e.g. `before:2026-03` → end-of-March).
+ * For `after:`, the timestamp is the **start** of the most specific unit.
+ */
+export declare function parseTimeToken(text: string, prefix: string): number | undefined;
+/**
+ * Strips `before:…` and `after:…` timestamp tokens from filter text,
+ * returning only the plain text search portion.
+ */
+export declare function stripTimestampTokens(text: string): string;
+/**
+ * Filters debug events by comma-separated text terms and optional
+ * `before:`/`after:` timestamp tokens.
+ *
+ * Terms prefixed with `!` are exclusions; all others are inclusions.
+ * At least one inclusion term must match (if any are present).
+ * Timestamp tokens are parsed and applied as date-range bounds, then
+ * stripped before text matching.
+ */
+export declare function filterDebugEventsByText(events: readonly IChatDebugEvent[], filterText: string): readonly IChatDebugEvent[];
+/**
+ * Description of the text filter syntax for tool schemas and documentation.
+ */
+export declare const debugEventFilterDescription = "Comma-separated text search terms. Prefix a term with ! to exclude it. Matches against event kind, tool names, model names, agent names, categories, event names, and message content. Also supports before:YYYY[-MM[-DD[THH[:MM[:SS]]]]] and after:YYYY[-MM[-DD[THH[:MM[:SS]]]]] to filter by timestamp.";
+export interface DebugEventFilterOptions {
+    readonly kind?: string;
+    readonly filter?: string;
+    readonly limit?: number;
+}
+/**
+ * Applies kind, text, and limit filters to debug events.
+ * Used by the listDebugEvents tool to consolidate all filtering in one place.
+ */
+export declare function filterDebugEvents(events: readonly IChatDebugEvent[], options: DebugEventFilterOptions): readonly IChatDebugEvent[];

package/vscode/src/vs/workbench/contrib/chat/common/chatDebugEvents.js

@@ -0,0 +1,135 @@
+
+
+const debugEventKindDescriptions = {
+    generic: "- generic (category: \"discovery\"): File discovery for instructions, skills, agents, hooks. Resolving returns a fileList with full file paths, load status, skip reasons, and source folders. Always resolve these for questions about customization files.\n" + "- generic (other): Miscellaneous logs. Resolving returns additional text details.",
+    toolCall: "- toolCall: A tool invocation. Resolving returns tool name, input, output, status, and duration.",
+    modelTurn: "- modelTurn: An LLM round-trip. Resolving returns model name, token usage, timing, errors, and prompt sections.",
+    subagentInvocation: "- subagentInvocation: A sub-agent spawn. Resolving returns agent name, status, duration, and counts.",
+    userMessage: "- userMessage: The full prompt sent to the model. Resolving returns the complete message and all prompt sections (system prompt, instructions, context). Essential for understanding what the model received.",
+    agentResponse: "- agentResponse: The model's response. Resolving returns the full response text and sections."
+};
+function formatDebugEventsForContext(events) {
+    const lines = [];
+    for (const event of events) {
+        const ts = event.created.toISOString();
+        const id = event.id ? ` [id=${event.id}]` : "";
+        switch (event.kind) {
+        case "generic":
+            lines.push(
+                `[${ts}]${id} ${event.level >= 3 ? "ERROR" : event.level >= 2 ? "WARN" : "INFO"}: ${event.name}${event.details ? " - " + event.details : ""}${event.category ? " (category: " + event.category + ")" : ""}`
+            );
+            break;
+        case "toolCall":
+            lines.push(
+                `[${ts}]${id} TOOL_CALL: ${event.toolName}${event.result ? " result=" + event.result : ""}${event.durationInMillis !== undefined ? " duration=" + event.durationInMillis + "ms" : ""}`
+            );
+            break;
+        case "modelTurn":
+            lines.push(
+                `[${ts}]${id} MODEL_TURN: ${event.requestName ?? "unknown"}${event.model ? " model=" + event.model : ""}${event.inputTokens !== undefined ? " tokens(in=" + event.inputTokens + ",out=" + (event.outputTokens ?? "?") + ")" : ""}${event.durationInMillis !== undefined ? " duration=" + event.durationInMillis + "ms" : ""}`
+            );
+            break;
+        case "subagentInvocation":
+            lines.push(
+                `[${ts}]${id} SUBAGENT: ${event.agentName}${event.status ? " status=" + event.status : ""}${event.durationInMillis !== undefined ? " duration=" + event.durationInMillis + "ms" : ""}`
+            );
+            break;
+        case "userMessage":
+            lines.push(
+                `[${ts}]${id} USER_MESSAGE: ${event.message.substring(0, 200)}${event.message.length > 200 ? "..." : ""} (${event.sections.length} sections)`
+            );
+            break;
+        case "agentResponse":
+            lines.push(
+                `[${ts}]${id} AGENT_RESPONSE: ${event.message.substring(0, 200)}${event.message.length > 200 ? "..." : ""} (${event.sections.length} sections)`
+            );
+            break;
+        }
+    }
+    return lines.join("\n");
+}
+function getDebugEventsModelDescription() {
+    return "These are the debug event logs from the current chat conversation. Analyze them to help answer the user's troubleshooting question.\n" + "\n" + "CRITICAL INSTRUCTION: You MUST call the resolveDebugEventDetails tool on relevant events BEFORE answering. The log lines below are only summaries — they do NOT contain the actual data (file paths, prompt content, tool I/O, etc.). The real information is only available by resolving events. Never answer based solely on the summary lines. Always resolve first, then answer.\n" + "\n" + "Call resolveDebugEventDetails in parallel on all events that could be relevant to the user's question. When in doubt, resolve more events rather than fewer.\n" + "\n" + "IMPORTANT: Do NOT mention event IDs, tool resolution steps, or internal debug mechanics in your response. The user does not know about debug events or event IDs. Present your findings directly and naturally, as if you simply know the answer. Never say things like \"I need to resolve events\" or show event IDs.\n" + "\n" + "Event types and what resolving them returns:\n" + ( Object.values(debugEventKindDescriptions)).join("\n");
+}
+function debugEventMatchesText(event, term) {
+    if (event.kind.toLowerCase().includes(term)) {
+        return true;
+    }
+    switch (event.kind) {
+    case "toolCall":
+        return event.toolName.toLowerCase().includes(term) || (event.input?.toLowerCase().includes(term) ?? false) || (event.output?.toLowerCase().includes(term) ?? false);
+    case "modelTurn":
+        return (event.model?.toLowerCase().includes(term) ?? false) || (event.requestName?.toLowerCase().includes(term) ?? false);
+    case "generic":
+        return event.name.toLowerCase().includes(term) || (event.details?.toLowerCase().includes(term) ?? false) || (event.category?.toLowerCase().includes(term) ?? false);
+    case "subagentInvocation":
+        return event.agentName.toLowerCase().includes(term) || (event.description?.toLowerCase().includes(term) ?? false);
+    case "userMessage":
+    case "agentResponse":
+        return event.message.toLowerCase().includes(term) || ( event.sections.some(
+            s => s.name.toLowerCase().includes(term) || s.content.toLowerCase().includes(term)
+        ));
+    }
+}
+const timestampTokenPattern = /\b(?:before|after):\d{4}(?:-\d{2}(?:-\d{2}(?:t\d{1,2}(?::\d{2}(?::\d{2})?)?)?)?)?(\b|$)/g;
+function parseTimeToken(text, prefix) {
+    const regex = ( new RegExp(
+        `${prefix}:(\\d{4})(?:-(\\d{2})(?:-(\\d{2})(?:t(\\d{1,2})(?::(\\d{2})(?::(\\d{2}))?)?)?)?)?(?!\\w)`
+    ));
+    const m = regex.exec(text);
+    if (!m) {
+        return undefined;
+    }
+    const year = parseInt(m[1], 10);
+    const month = m[2] !== undefined ? parseInt(m[2], 10) - 1 : undefined;
+    const day = m[3] !== undefined ? parseInt(m[3], 10) : undefined;
+    const hour = m[4] !== undefined ? parseInt(m[4], 10) : undefined;
+    const minute = m[5] !== undefined ? parseInt(m[5], 10) : undefined;
+    const second = m[6] !== undefined ? parseInt(m[6], 10) : undefined;
+    if (prefix === "before") {
+        if (second !== undefined) {
+            return ( new Date(year, month, day, hour, minute, second, 999)).getTime();
+        } else if (minute !== undefined) {
+            return ( new Date(year, month, day, hour, minute, 59, 999)).getTime();
+        } else if (hour !== undefined) {
+            return ( new Date(year, month, day, hour, 59, 59, 999)).getTime();
+        } else if (day !== undefined) {
+            return ( new Date(year, month, day, 23, 59, 59, 999)).getTime();
+        } else if (month !== undefined) {
+            return ( new Date(year, month + 1, 0, 23, 59, 59, 999)).getTime();
+        } else {
+            return ( new Date(year, 11, 31, 23, 59, 59, 999)).getTime();
+        }
+    } else {
+        return ( new Date(year, month ?? 0, day ?? 1, hour ?? 0, minute ?? 0, second ?? 0, 0)).getTime();
+    }
+}
+function stripTimestampTokens(text) {
+    return text.replace(timestampTokenPattern, "").trim();
+}
+function filterDebugEventsByText(events, filterText) {
+    const beforeTimestamp = parseTimeToken(filterText, "before");
+    const afterTimestamp = parseTimeToken(filterText, "after");
+    const textOnly = stripTimestampTokens(filterText);
+    const terms = textOnly.split(/\s*,\s*/).filter(t => t.length > 0);
+    const includeTerms = ( terms.filter(t => !t.startsWith("!")).map(t => t.trim()));
+    const excludeTerms = ( terms.filter(t => t.startsWith("!")).map(t => t.slice(1).trim())).filter(t => t.length > 0);
+    return events.filter(e => {
+        const time = e.created.getTime();
+        if (beforeTimestamp !== undefined && time > beforeTimestamp) {
+            return false;
+        }
+        if (afterTimestamp !== undefined && time < afterTimestamp) {
+            return false;
+        }
+        if (( excludeTerms.some(term => debugEventMatchesText(e, term)))) {
+            return false;
+        }
+        if (includeTerms.length > 0) {
+            return ( includeTerms.some(term => debugEventMatchesText(e, term)));
+        }
+        return true;
+    });
+}
+
+export { debugEventKindDescriptions, debugEventMatchesText, filterDebugEventsByText, formatDebugEventsForContext, getDebugEventsModelDescription, parseTimeToken, stripTimestampTokens };

package/vscode/src/vs/workbench/contrib/terminal/browser/xterm/decorationAddon.js

@@ -410,7 +410,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
         })];
     }
     _getContextMenuActions() {
-        const label = ( localize(13201, "Toggle Visibility"));
+        const label = ( localize(13450, "Toggle Visibility"));
         return [{
             class: undefined,
             tooltip: label,
@@ -433,7 +433,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
             actions.push(attachToChatAction, ( new Separator()));
         }
         if (command.command !== "") {
-            const labelRun = ( localize(13202, "Rerun Command"));
+            const labelRun = ( localize(13451, "Rerun Command"));
             actions.push({
                 class: undefined,
                 tooltip: labelRun,
@@ -446,11 +446,11 @@ let DecorationAddon = class DecorationAddon extends Disposable {
                     }
                     if (!command.isTrusted) {
                         const shouldRun = await ( new Promise(r => {
-                            this._notificationService.prompt(Severity.Info, ( localize(13203, "Do you want to run the command: {0}", command.command)), [{
-                                label: ( localize(13204, "Yes")),
+                            this._notificationService.prompt(Severity.Info, ( localize(13452, "Do you want to run the command: {0}", command.command)), [{
+                                label: ( localize(13453, "Yes")),
                                 run: () => r(true)
                             }, {
-                                label: ( localize(13205, "No")),
+                                label: ( localize(13454, "No")),
                                 run: () => r(false)
                             }]);
                         }));
@@ -464,7 +464,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
                 }
             });
             actions.push(( new Separator()));
-            const labelCopy = ( localize(13206, "Copy Command"));
+            const labelCopy = ( localize(13455, "Copy Command"));
             actions.push({
                 class: undefined,
                 tooltip: labelCopy,
@@ -475,7 +475,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
             });
         }
         if (command.hasOutput()) {
-            const labelCopyCommandAndOutput = ( localize(13207, "Copy Command and Output"));
+            const labelCopyCommandAndOutput = ( localize(13456, "Copy Command and Output"));
             actions.push({
                 class: undefined,
                 tooltip: labelCopyCommandAndOutput,
@@ -489,7 +489,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
                     }
                 }
             });
-            const labelText = ( localize(13208, "Copy Output"));
+            const labelText = ( localize(13457, "Copy Output"));
             actions.push({
                 class: undefined,
                 tooltip: labelText,
@@ -503,7 +503,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
                     }
                 }
             });
-            const labelHtml = ( localize(13209, "Copy Output as HTML"));
+            const labelHtml = ( localize(13458, "Copy Output as HTML"));
             actions.push({
                 class: undefined,
                 tooltip: labelHtml,
@@ -518,7 +518,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
         if (actions.length > 0) {
             actions.push(( new Separator()));
         }
-        const labelRunRecent = ( localize(13210, "Run Recent Command"));
+        const labelRunRecent = ( localize(13459, "Run Recent Command"));
         actions.push({
             class: undefined,
             tooltip: labelRunRecent,
@@ -527,7 +527,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
             enabled: true,
             run: () => this._commandService.executeCommand("workbench.action.terminal.runRecentCommand")
         });
-        const labelGoToRecent = ( localize(13211, "Go To Recent Directory"));
+        const labelGoToRecent = ( localize(13460, "Go To Recent Directory"));
         actions.push({
             class: undefined,
             tooltip: labelRunRecent,
@@ -537,7 +537,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
             run: () => this._commandService.executeCommand("workbench.action.terminal.goToRecentDirectory")
         });
         actions.push(( new Separator()));
-        const labelAbout = ( localize(13212, "Learn About Shell Integration"));
+        const labelAbout = ( localize(13461, "Learn About Shell Integration"));
         actions.push({
             class: undefined,
             tooltip: labelAbout,
@@ -553,7 +553,7 @@ let DecorationAddon = class DecorationAddon extends Disposable {
         if (!chatIsEnabled) {
             return undefined;
         }
-        const labelAttachToChat = ( localize(13213, "Attach To Chat"));
+        const labelAttachToChat = ( localize(13462, "Attach To Chat"));
         return {
             class: undefined,
             tooltip: labelAttachToChat,
@@ -595,14 +595,14 @@ let DecorationAddon = class DecorationAddon extends Disposable {
         quickPick.hideInput = true;
         quickPick.hideCheckAll = true;
         quickPick.canSelectMany = true;
-        quickPick.title = ( localize(13214, "Toggle visibility"));
+        quickPick.title = ( localize(13463, "Toggle visibility"));
         const configValue = this._configurationService.getValue(TerminalSettingId.ShellIntegrationDecorationsEnabled);
         const gutterIcon = {
-            label: ( localize(13215, "Gutter command decorations")),
+            label: ( localize(13464, "Gutter command decorations")),
             picked: configValue !== "never" && configValue !== "overviewRuler"
         };
         const overviewRulerIcon = {
-            label: ( localize(13216, "Overview ruler command decorations")),
+            label: ( localize(13465, "Overview ruler command decorations")),
             picked: configValue !== "never" && configValue !== "gutter"
         };
         quickPick.items = [gutterIcon, overviewRulerIcon];

package/vscode/src/vs/workbench/contrib/terminal/browser/xterm/xtermTerminal.d.ts

@@ -92,6 +92,7 @@ export declare class XtermTerminal extends Disposable implements IXtermTerminal,
     } | undefined;
     get isStdinDisabled(): boolean;
     get isGpuAccelerated(): boolean;
+    get isImageAddonLoaded(): boolean;
     private readonly _onDidRequestRunCommand;
     readonly onDidRequestRunCommand: Event<{
         command: ITerminalCommand;

package/vscode/src/vs/workbench/contrib/terminal/browser/xterm/xtermTerminal.js

@@ -43,6 +43,7 @@ import '@codingame/monaco-vscode-api/vscode/vs/platform/theme/common/colors/sear
 import { XtermAddonImporter } from './xtermAddonImporter.js';
 import { equals } from '@codingame/monaco-vscode-api/vscode/vs/base/common/objects';
 import { isNumber } from '@codingame/monaco-vscode-api/vscode/vs/base/common/types';
+import { clamp } from '@codingame/monaco-vscode-api/vscode/vs/base/common/numbers';
 
 var XtermTerminal_1;
 var RenderConstants;
@@ -102,6 +103,9 @@ let XtermTerminal = class XtermTerminal extends Disposable {
     get isGpuAccelerated() {
         return !!this._webglAddon;
     }
+    get isImageAddonLoaded() {
+        return !!this._imageAddon;
+    }
     get markTracker() {
         return this._markNavigationAddon;
     }
@@ -746,7 +750,7 @@ let XtermTerminal = class XtermTerminal extends Disposable {
                 await this._clipboardService.writeText(this.raw.getSelection());
             }
         } else {
-            this._notificationService.warn(( localize(13227, "The terminal has no selection to copy")));
+            this._notificationService.warn(( localize(13476, "The terminal has no selection to copy")));
         }
     }
     _setCursorBlink(blink) {
@@ -845,6 +849,10 @@ let XtermTerminal = class XtermTerminal extends Disposable {
                 const AddonCtor = await this._xtermAddonLoader.importAddon("image");
                 this._imageAddon = ( new AddonCtor());
                 this.raw.loadAddon(this._imageAddon);
+                this._telemetryService.publicLog2("terminal/imageAddonActivated");
+                this._register(this._imageAddon.onImageAdded(() => {
+                    this._telemetryService.publicLog2("terminal/imageAdded");
+                }));
             }
         } else {
             try {
@@ -871,16 +879,24 @@ let XtermTerminal = class XtermTerminal extends Disposable {
             this._serializeAddon = ( new Addon());
             this.raw.loadAddon(this._serializeAddon);
         }
+        const lastLine = this.raw.buffer.active.length - 1;
+        if (lastLine < 0) {
+            return "";
+        }
         const hasValidEndMarker = isNumber(endMarker?.line);
-        const start = isNumber(startMarker?.line) && startMarker?.line > -1 ? startMarker.line : 0;
+        const start = clamp(
+            isNumber(startMarker?.line) && startMarker.line > -1 ? startMarker.line : 0,
+            0,
+            lastLine
+        );
         let end = hasValidEndMarker ? endMarker.line : this.raw.buffer.active.length - 1;
         if (skipLastLine && hasValidEndMarker) {
             end = end - 1;
         }
-        end = Math.max(end, start);
+        end = clamp(Math.max(end, start), start, lastLine);
         return this._serializeAddon.serialize({
             range: {
-                start: startMarker?.line ?? 0,
+                start,
                 end
             }
         });