Debug Panel: Import cap and large file optimizations (#300949)

* import cap and large file optimizations

* feedback updates
This commit is contained in:
Vijay Upadya
2026-03-11 21:34:11 -07:00
committed by GitHub
parent 8ca4fb20bf
commit c7e08526a6
5 changed files with 216 additions and 71 deletions

View File

@@ -3,24 +3,94 @@
* Licensed under the MIT License. See License.txt in the project root for license information.
*--------------------------------------------------------------------------------------------*/
import { timeout } from '../../../../base/common/async.js';
import { CancellationToken, CancellationTokenSource } from '../../../../base/common/cancellation.js';
import { Emitter, Event } from '../../../../base/common/event.js';
import { onUnexpectedError } from '../../../../base/common/errors.js';
import { Disposable, IDisposable, toDisposable } from '../../../../base/common/lifecycle.js';
import { ResourceMap } from '../../../../base/common/map.js';
import { extUri } from '../../../../base/common/resources.js';
import { URI } from '../../../../base/common/uri.js';
import { ChatDebugLogLevel, IChatDebugEvent, IChatDebugLogProvider, IChatDebugResolvedEventContent, IChatDebugService } from './chatDebugService.js';
import { LocalChatSessionUri } from './model/chatUri.js';
/**
* Per-session circular buffer for debug events.
* Stores up to `capacity` events using a ring buffer.
*/
class SessionEventBuffer {
private readonly _buffer: (IChatDebugEvent | undefined)[];
private _head = 0;
private _size = 0;
constructor(readonly capacity: number) {
this._buffer = new Array(capacity);
}
get size(): number {
return this._size;
}
push(event: IChatDebugEvent): void {
const idx = (this._head + this._size) % this.capacity;
this._buffer[idx] = event;
if (this._size < this.capacity) {
this._size++;
} else {
this._head = (this._head + 1) % this.capacity;
}
}
/** Return events in insertion order. */
toArray(): IChatDebugEvent[] {
const result: IChatDebugEvent[] = [];
for (let i = 0; i < this._size; i++) {
const event = this._buffer[(this._head + i) % this.capacity];
if (event) {
result.push(event);
}
}
return result;
}
/** Remove events matching the predicate and compact in-place. */
removeWhere(predicate: (event: IChatDebugEvent) => boolean): void {
let write = 0;
for (let i = 0; i < this._size; i++) {
const idx = (this._head + i) % this.capacity;
const event = this._buffer[idx];
if (event && predicate(event)) {
continue;
}
if (write !== i) {
const writeIdx = (this._head + write) % this.capacity;
this._buffer[writeIdx] = event;
}
write++;
}
for (let i = write; i < this._size; i++) {
this._buffer[(this._head + i) % this.capacity] = undefined;
}
this._size = write;
}
clear(): void {
this._buffer.fill(undefined);
this._head = 0;
this._size = 0;
}
}
export class ChatDebugServiceImpl extends Disposable implements IChatDebugService {
declare readonly _serviceBrand: undefined;
private static readonly MAX_EVENTS = 10_000;
static readonly MAX_EVENTS_PER_SESSION = 10_000;
static readonly MAX_SESSIONS = 5;
// Circular buffer: fixed-size array with head/size tracking for O(1) append.
private readonly _buffer: (IChatDebugEvent | undefined)[] = new Array(ChatDebugServiceImpl.MAX_EVENTS);
private _head = 0; // index of the oldest element
private _size = 0; // number of elements currently stored
/** Per-session event buffers. Ordered from oldest to newest session (LRU). */
private readonly _sessionBuffers = new ResourceMap<SessionEventBuffer>();
/** Ordered list of session URIs for LRU eviction. */
private readonly _sessionOrder: URI[] = [];
private readonly _onDidAddEvent = this._register(new Emitter<IChatDebugEvent>());
readonly onDidAddEvent: Event<IChatDebugEvent> = this._onDidAddEvent.event;
@@ -65,13 +135,25 @@ export class ChatDebugServiceImpl extends Disposable implements IChatDebugServic
}
addEvent(event: IChatDebugEvent): void {
const idx = (this._head + this._size) % ChatDebugServiceImpl.MAX_EVENTS;
this._buffer[idx] = event;
if (this._size < ChatDebugServiceImpl.MAX_EVENTS) {
this._size++;
let buffer = this._sessionBuffers.get(event.sessionResource);
if (!buffer) {
// Evict least-recently-used session if we are at the session cap.
if (this._sessionOrder.length >= ChatDebugServiceImpl.MAX_SESSIONS) {
const evicted = this._sessionOrder.shift()!;
this._evictSession(evicted);
}
buffer = new SessionEventBuffer(ChatDebugServiceImpl.MAX_EVENTS_PER_SESSION);
this._sessionBuffers.set(event.sessionResource, buffer);
this._sessionOrder.push(event.sessionResource);
} else {
this._head = (this._head + 1) % ChatDebugServiceImpl.MAX_EVENTS;
// Move to end of LRU order so actively-used sessions are not evicted.
const idx = this._sessionOrder.findIndex(u => extUri.isEqual(u, event.sessionResource));
if (idx !== -1 && idx !== this._sessionOrder.length - 1) {
this._sessionOrder.splice(idx, 1);
this._sessionOrder.push(event.sessionResource);
}
}
buffer.push(event);
this._onDidAddEvent.fire(event);
}
@@ -81,15 +163,14 @@ export class ChatDebugServiceImpl extends Disposable implements IChatDebugServic
}
getEvents(sessionResource?: URI): readonly IChatDebugEvent[] {
const result: IChatDebugEvent[] = [];
const key = sessionResource?.toString();
for (let i = 0; i < this._size; i++) {
const event = this._buffer[(this._head + i) % ChatDebugServiceImpl.MAX_EVENTS];
if (!event) {
continue;
}
if (!key || event.sessionResource.toString() === key) {
result.push(event);
let result: IChatDebugEvent[];
if (sessionResource) {
const buffer = this._sessionBuffers.get(sessionResource);
result = buffer ? buffer.toArray() : [];
} else {
result = [];
for (const buffer of this._sessionBuffers.values()) {
result.push(...buffer.toArray());
}
}
result.sort((a, b) => a.created.getTime() - b.created.getTime());
@@ -97,26 +178,29 @@ export class ChatDebugServiceImpl extends Disposable implements IChatDebugServic
}
getSessionResources(): readonly URI[] {
const seen = new ResourceMap<boolean>();
const result: URI[] = [];
for (let i = 0; i < this._size; i++) {
const event = this._buffer[(this._head + i) % ChatDebugServiceImpl.MAX_EVENTS];
if (!event) {
continue;
}
if (!seen.has(event.sessionResource)) {
seen.set(event.sessionResource, true);
result.push(event.sessionResource);
}
}
return result;
return [...this._sessionOrder];
}
clear(): void {
this._buffer.fill(undefined);
this._head = 0;
this._size = 0;
this._sessionBuffers.clear();
this._sessionOrder.length = 0;
this._debugDataAttachedSessions.clear();
this._importedSessions.clear();
this._importedSessionTitles.clear();
}
/** Remove all ancillary state for an evicted session. */
private _evictSession(sessionResource: URI): void {
this._sessionBuffers.delete(sessionResource);
this._importedSessions.delete(sessionResource);
this._importedSessionTitles.delete(sessionResource);
this._debugDataAttachedSessions.delete(sessionResource);
const cts = this._invocationCts.get(sessionResource);
if (cts) {
cts.cancel();
cts.dispose();
this._invocationCts.delete(sessionResource);
}
}
registerProvider(provider: IChatDebugLogProvider): IDisposable {
@@ -180,11 +264,21 @@ export class ChatDebugServiceImpl extends Disposable implements IChatDebugServic
try {
const events = await provider.provideChatDebugLog(sessionResource, token);
if (events) {
for (const event of events) {
// Yield to the event loop periodically so the UI stays
// responsive when a provider returns a large batch of events
// (e.g. importing a multi-MB log file).
const BATCH_SIZE = 500;
for (let i = 0; i < events.length; i++) {
if (token.isCancellationRequested) {
break;
}
this.addProviderEvent({
...event,
sessionResource: event.sessionResource ?? sessionResource,
...events[i],
sessionResource: events[i].sessionResource ?? sessionResource,
});
if (i > 0 && i % BATCH_SIZE === 0) {
await timeout(0);
}
}
}
} catch (err) {
@@ -203,26 +297,10 @@ export class ChatDebugServiceImpl extends Disposable implements IChatDebugServic
}
private _clearProviderEvents(sessionResource: URI): void {
const key = sessionResource.toString();
// Compact the ring buffer in-place, removing matching provider events.
let write = 0;
for (let i = 0; i < this._size; i++) {
const idx = (this._head + i) % ChatDebugServiceImpl.MAX_EVENTS;
const event = this._buffer[idx];
if (event && this._providerEvents.has(event) && event.sessionResource.toString() === key) {
continue; // skip — this event is removed
}
if (write !== i) {
const writeIdx = (this._head + write) % ChatDebugServiceImpl.MAX_EVENTS;
this._buffer[writeIdx] = event;
}
write++;
const buffer = this._sessionBuffers.get(sessionResource);
if (buffer) {
buffer.removeWhere(event => this._providerEvents.has(event));
}
// Clear trailing slots and update size
for (let i = write; i < this._size; i++) {
this._buffer[(this._head + i) % ChatDebugServiceImpl.MAX_EVENTS] = undefined;
}
this._size = write;
this._onDidClearProviderEvents.fire(sessionResource);
}
@@ -304,6 +382,8 @@ export class ChatDebugServiceImpl extends Disposable implements IChatDebugServic
cts.dispose();
}
this._invocationCts.clear();
this.clear();
this._providers.clear();
super.dispose();
}
}