@codingame/monaco-vscode-chat-service-override 36.2.7 → 37.0.0

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

@@ -5,14 +5,18 @@ import { IFileService } from "@codingame/monaco-vscode-api/vscode/vs/platform/fi
 import { ILogService } from "@codingame/monaco-vscode-api/vscode/vs/platform/log/common/log.service";
 import { IAgentHostService } from "@codingame/monaco-vscode-api/vscode/vs/platform/agentHost/common/agentService.service";
 import { IRemoteAgentHostService } from "@codingame/monaco-vscode-api/vscode/vs/platform/agentHost/common/remoteAgentHostService.service";
+import { type Customization } from "@codingame/monaco-vscode-api/vscode/vs/platform/agentHost/common/state/sessionState";
 import { IWorkbenchContribution } from "@codingame/monaco-vscode-api/vscode/vs/workbench/common/contributions";
+import { IWorkbenchEnvironmentService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/environment/common/environmentService.service";
 import { IPathService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/path/common/pathService.service";
 import { IChatDebugEvent, IChatDebugResolvedEventContent } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatDebugService";
 import { IChatDebugService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatDebugService.service";
+import { IAgentHostCustomizationService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/agentSessions/agentHost/agentHostCustomizationService.service";
+import { type IAgentHostUsageRecord } from "./agentHostUsageSidecar.js";
 /**
  * One record in an Agent Host Copilot CLI `events.jsonl` stream. The CLI
  * writes a line-delimited JSON log of the session under
- * `~/.copilot/session-state/<id>/events.jsonl`. Every record shares the same
+ * `<COPILOT_HOME>/session-state/<id>/events.jsonl`. Every record shares the same
  * envelope. Note that `parentId` is **not** a logical parent: the SDK defines
  * it as the chronologically preceding event in the session (a flat linked chain
  * over every event), not the user → model-turn → tool-call hierarchy. The
@@ -45,19 +49,49 @@ export declare class AgentHostChatDebugContribution extends Disposable implement
     private readonly _agentHostService;
     private readonly _configurationService;
     private readonly _logService;
+    private readonly _environmentService;
+    private readonly _customizationService;
     static readonly ID = "workbench.contrib.agentHostChatDebug";
     /** Resolved (expanded) detail for each emitted event id. */
     private readonly _resolved;
     /** Guards against concurrent/overlapping session discovery scans. */
     private _discovering;
+    /** True once the lazy fetcher has run at least once (i.e. the panel has been opened). */
+    private _hasFetchedOnce;
     /** Watches the currently-viewed session's events.jsonl for live refresh. */
     private readonly _liveRefresh;
     private _watchedSessionKey;
-    constructor(_chatDebugService: IChatDebugService, _fileService: IFileService, _pathService: IPathService, _remoteAgentHostService: IRemoteAgentHostService, _agentHostService: IAgentHostService, _configurationService: IConfigurationService, _logService: ILogService);
     /**
-     * Runs {@link _discoverLocalSessions} when file logging is enabled,
-     * guarding against overlapping scans. Safe to call repeatedly:
-     * {@link IChatDebugService.addAvailableSessionResources} dedupes by URI.
+     * Incremental-read cache for the actively-viewed session's `events.jsonl`.
+     * The CLI appends to the file, so each live refresh reads only the bytes
+     * added since the last read and parses just the new lines, avoiding an
+     * O(N) whole-file re-read + re-parse on every change. Bounded to a single
+     * session (the one being viewed) and released when that session ends.
+     */
+    private _liveRead;
+    /**
+     * Size-gated cache for the actively-viewed session's usage sidecar. The
+     * sidecar is read on every live tick, but is append-only, so we re-read and
+     * re-parse it only when its byte size changed since the last read (most
+     * ticks — tool progress, etc. — add no usage records). Bounded to a single
+     * session and released when that session ends.
+     */
+    private _usageRead;
+    constructor(_chatDebugService: IChatDebugService, _fileService: IFileService, _pathService: IPathService, _remoteAgentHostService: IRemoteAgentHostService, _agentHostService: IAgentHostService, _configurationService: IConfigurationService, _logService: ILogService, _environmentService: IWorkbenchEnvironmentService, _customizationService: IAgentHostCustomizationService);
+    /**
+     * Lazy fetcher registered with {@link IChatDebugService}. Invoked (at most
+     * once) when the home view first requests the available session list, so no
+     * disk scan happens until the panel is opened. Returns nothing when file
+     * logging is disabled.
+     */
+    private _fetchLocalSessions;
+    /**
+     * Runs {@link _discoverLocalSessions} when file logging is enabled and adds
+     * the results to the available-sessions list, guarding against overlapping
+     * scans. Used for the re-scan when logging is enabled after the panel has
+     * already loaded once (the initial load goes through {@link _fetchLocalSessions}).
+     * Safe to call repeatedly: {@link IChatDebugService.addAvailableSessionResources}
+     * dedupes by URI.
      */
     private _maybeDiscoverLocalSessions;
     private _resolveEventsUri;
@@ -82,7 +116,51 @@ export declare class AgentHostChatDebugContribution extends Disposable implement
      * Only AIU is reliable live; input/cache need the shutdown summary (F1).
      */
     private _getLiveUsageTotals;
+    /**
+     * Reads the client-local usage sidecar for a session (exact per-request
+     * token metrics captured live). Returns `undefined` when the session has no
+     * sidecar (e.g. it ran before capture shipped), so the converter falls back
+     * to the session.shutdown summary / live totals.
+     */
+    private _readUsageRecords;
+    /**
+     * Reads the client-local customization snapshot for a session (the last
+     * loaded skills/hooks/agents/MCP captured live). Used as a fallback for
+     * historical/closed sessions, where the live customization service has no
+     * active state subscription and returns nothing. Returns `undefined` when no
+     * snapshot exists (e.g. the session ran before capture shipped).
+     */
+    private _readCustomizationsSnapshot;
     private _provideChatDebugLog;
+    /**
+     * Reads the session's `events.jsonl` into parsed records, reading only the
+     * bytes appended since the last read for the actively-viewed session.
+     *
+     * The Copilot CLI appends to `events.jsonl` line-by-line from a separate
+     * process, so a live session is an append-only stream. Rather than
+     * re-reading and re-`JSON.parse`-ing the whole (potentially multi-MB) file
+     * on every change — which is O(N) per tick and O(N^2) over a long session —
+     * we cache the parsed records plus the byte offset consumed so far and read
+     * only the new tail. A full read is used on first view, a cache miss, or
+     * when the file shrank (rotation/truncation).
+     *
+     * Byte offsets are only ever advanced to a newline boundary (`\n` is a
+     * single byte that never appears inside a multi-byte UTF-8 sequence), so a
+     * tail read never starts mid-codepoint; any trailing partial line is kept
+     * as `pendingBytes` and prepended to the next read.
+     *
+     * Returns `undefined` when the file does not exist yet or cannot be read.
+     */
+    /**
+     * The configured in-memory event cap for agent host sessions (see
+     * {@link AgentHostAgentDebugLogMaxEventsSettingId}). The raw record cache is
+     * trimmed to this many entries so a long-running session does not retain an
+     * unbounded array, matching the capped public event buffer.
+     */
+    private _maxRecordsInMemory;
+    /** Trims `records` in place to the most recent {@link _maxRecordsInMemory} entries. */
+    private _capRecordsInMemory;
+    private _readEventRecords;
     private _discoverLocalSessions;
 }
 /**
@@ -105,7 +183,16 @@ export declare class AgentHostChatDebugContribution extends Disposable implement
  * `tool.execution_start` and `tool.execution_complete` records share a
  * `toolCallId` and are merged into a single tool-call event.
  */
-export declare function convertAgentHostEventsToDebugEvents(records: readonly IAgentHostEventRecord[], sessionResource: URI, fallbackUsageTotals?: ISessionUsageTotals): {
+export declare function convertAgentHostEventsToDebugEvents(records: readonly IAgentHostEventRecord[], sessionResource: URI, fallbackUsageTotals?: ISessionUsageTotals, usageRecords?: readonly IAgentHostUsageRecord[], customizations?: readonly Customization[]): {
+    readonly events: IChatDebugEvent[];
+    readonly resolved: Map<string, IChatDebugResolvedEventContent>;
+};
+/**
+ * Builds the customization discovery + summary debug events for a session from
+ * its loaded {@link Customization}s. Ids are deterministic (per session + type)
+ * so repeated live refreshes replace rather than duplicate them.
+ */
+export declare function buildCustomizationDebugEvents(customizations: readonly Customization[], sessionResource: URI, parentEventId: string | undefined, created: Date): {
     readonly events: IChatDebugEvent[];
     readonly resolved: Map<string, IChatDebugResolvedEventContent>;
 };