@vforsh/argus-watcher 0.1.9 → 0.1.11

package/dist/buffer/NetBuffer.d.ts

@@ -1,23 +1,43 @@
-import type { NetworkRequestSummary } from '@vforsh/argus-core';
-export type NetFilters = {
-    grep?: string;
-    sinceTs?: number;
+import type { NetworkRequestDetail, NetworkRequestSummary } from '@vforsh/argus-core';
+import { type NetFilters } from '../net/filtering.js';
+type StoredNetRecord = {
+    summary: NetworkRequestSummary;
+    detail: NetworkRequestDetail;
+    bodySessionId: string | null;
 };
-/** In-memory ring buffer for network request summaries with long-poll waiters. */
+export type NetBufferRecord = StoredNetRecord;
+/** In-memory ring buffer for network request summaries plus per-request detail records. */
 export declare class NetBuffer {
     private readonly maxSize;
     private events;
     private nextId;
-    private waiters;
     constructor(maxSize: number);
-    /** Add a network summary and return the stored entry with id. */
-    add(event: Omit<NetworkRequestSummary, 'id'>): NetworkRequestSummary;
+    /** Add a network summary/detail pair and return the stored detail record with id. */
+    add(record: {
+        summary: Omit<NetworkRequestSummary, 'id'>;
+        detail: Omit<NetworkRequestDetail, 'id'>;
+        /**
+         * Child-session owner for lazy CDP body reads.
+         * Null means the request belongs to the root page session.
+         */
+        bodySessionId?: string | null;
+    }): NetworkRequestDetail;
     /** List events after the given id, respecting filters and limit. */
     listAfter(after: number, filters: NetFilters, limit: number): NetworkRequestSummary[];
     /** List buffered events without an `after` cursor. */
     list(filters: NetFilters, limit?: number): NetworkRequestSummary[];
-    /** Wait for events after an id or timeout. */
-    waitForAfter(after: number, filters: NetFilters, limit: number, timeoutMs: number): Promise<NetworkRequestSummary[]>;
+    /** List detailed request records after the given id, respecting filters and limit. */
+    listDetailsAfter(after: number, filters: NetFilters, limit: number): NetworkRequestDetail[];
+    /** Retrieve one buffered request by Argus numeric id. */
+    getById(id: number): NetworkRequestDetail | null;
+    /** Retrieve the most recent buffered request by CDP request id. */
+    getByRequestId(requestId: string): NetworkRequestDetail | null;
+    /** Retrieve the full stored record by Argus numeric id. */
+    getRecordById(id: number): NetBufferRecord | null;
+    /** Retrieve the most recent full stored record by CDP request id. */
+    getRecordByRequestId(requestId: string): NetBufferRecord | null;
+    private findRecordById;
+    private findRecordByRequestId;
     /** Get buffer size and id boundaries. */
     getStats(): {
         size: number;
@@ -25,7 +45,11 @@ export declare class NetBuffer {
         minId: number | null;
         maxId: number | null;
     };
+    /** Clear buffered network events and return the number removed. */
+    clear(): number;
     private trim;
-    private flushWaiters;
+    private listMatchingSummaries;
+    private listMatchingDetails;
 }
+export {};
 //# sourceMappingURL=NetBuffer.d.ts.map

package/dist/buffer/NetBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetBuffer.d.ts","sourceRoot":"","sources":["../../src/buffer/NetBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE/D,MAAM,MAAM,UAAU,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAUD,kFAAkF;AAClF,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,MAAM;IAI3B,iEAAiE;IACjE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,GAAG,qBAAqB;IAQpE,oEAAoE;IACpE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAKrF,sDAAsD;IACtD,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,SAAe,GAAG,qBAAqB,EAAE;IAKxE,8CAA8C;IAC9C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAgBpH,yCAAyC;IACzC,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAavF,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,YAAY;CAiBpB"}
+{"version":3,"file":"NetBuffer.d.ts","sourceRoot":"","sources":["../../src/buffer/NetBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACrF,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAExE,KAAK,eAAe,GAAG;IACtB,OAAO,EAAE,qBAAqB,CAAA;IAC9B,MAAM,EAAE,oBAAoB,CAAA;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,CAAA;AAE7C,2FAA2F;AAC3F,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAI;gBAEN,OAAO,EAAE,MAAM;IAI3B,qFAAqF;IACrF,GAAG,CAAC,MAAM,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAA;QAC1C,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAA;QACxC;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7B,GAAG,oBAAoB;IAYxB,oEAAoE;IACpE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAIrF,sDAAsD;IACtD,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,SAAe,GAAG,qBAAqB,EAAE;IAIxE,sFAAsF;IACtF,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAI3F,yDAAyD;IACzD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIhD,mEAAmE;IACnE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAI9D,2DAA2D;IAC3D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAIjD,qEAAqE;IACrE,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAI/D,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,qBAAqB;IAU7B,yCAAyC;IACzC,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAavF,mEAAmE;IACnE,KAAK,IAAI,MAAM;IAMf,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,mBAAmB;CAM3B"}

package/dist/buffer/NetBuffer.js

@@ -1,43 +1,63 @@
-/** In-memory ring buffer for network request summaries with long-poll waiters. */
+import { matchesNetFilters } from '../net/filtering.js';
+/** In-memory ring buffer for network request summaries plus per-request detail records. */
 export class NetBuffer {
     maxSize;
     events = [];
     nextId = 1;
-    waiters = [];
     constructor(maxSize) {
         this.maxSize = maxSize;
     }
-    /** Add a network summary and return the stored entry with id. */
-    add(event) {
-        const entry = { ...event, id: this.nextId++ };
-        this.events.push(entry);
+    /** Add a network summary/detail pair and return the stored detail record with id. */
+    add(record) {
+        const id = this.nextId++;
+        const stored = {
+            summary: { ...record.summary, id },
+            detail: { ...record.detail, id },
+            bodySessionId: record.bodySessionId ?? null,
+        };
+        this.events.push(stored);
         this.trim();
-        this.flushWaiters();
-        return entry;
+        return stored.detail;
     }
     /** List events after the given id, respecting filters and limit. */
     listAfter(after, filters, limit) {
-        const filtered = this.events.filter((event) => event.id > after && matchesFilters(event, filters));
-        return filtered.slice(0, limit);
+        return this.listMatchingSummaries(limit, (event) => event.summary.id > after && matchesNetFilters(event.summary, filters));
     }
     /** List buffered events without an `after` cursor. */
     list(filters, limit = this.maxSize) {
-        const filtered = this.events.filter((event) => matchesFilters(event, filters));
-        return filtered.slice(0, limit);
-    }
-    /** Wait for events after an id or timeout. */
-    waitForAfter(after, filters, limit, timeoutMs) {
-        const immediate = this.listAfter(after, filters, limit);
-        if (immediate.length > 0) {
-            return Promise.resolve(immediate);
+        return this.listMatchingSummaries(limit, (event) => matchesNetFilters(event.summary, filters));
+    }
+    /** List detailed request records after the given id, respecting filters and limit. */
+    listDetailsAfter(after, filters, limit) {
+        return this.listMatchingDetails(limit, (event) => event.summary.id > after && matchesNetFilters(event.summary, filters));
+    }
+    /** Retrieve one buffered request by Argus numeric id. */
+    getById(id) {
+        return this.findRecordById(id)?.detail ?? null;
+    }
+    /** Retrieve the most recent buffered request by CDP request id. */
+    getByRequestId(requestId) {
+        return this.findRecordByRequestId(requestId)?.detail ?? null;
+    }
+    /** Retrieve the full stored record by Argus numeric id. */
+    getRecordById(id) {
+        return this.findRecordById(id);
+    }
+    /** Retrieve the most recent full stored record by CDP request id. */
+    getRecordByRequestId(requestId) {
+        return this.findRecordByRequestId(requestId);
+    }
+    findRecordById(id) {
+        return this.events.find((event) => event.detail.id === id) ?? null;
+    }
+    findRecordByRequestId(requestId) {
+        for (let index = this.events.length - 1; index >= 0; index -= 1) {
+            const current = this.events[index];
+            if (current?.detail.requestId === requestId) {
+                return current;
+            }
         }
-        return new Promise((resolve) => {
-            const timer = setTimeout(() => {
-                this.waiters = this.waiters.filter((waiter) => waiter.timer !== timer);
-                resolve([]);
-            }, timeoutMs);
-            this.waiters.push({ after, filters, limit, resolve, timer });
-        });
+        return null;
     }
     /** Get buffer size and id boundaries. */
     getStats() {
@@ -47,44 +67,33 @@ export class NetBuffer {
         return {
             size: this.maxSize,
             count: this.events.length,
-            minId: this.events[0]?.id ?? null,
-            maxId: this.events[this.events.length - 1]?.id ?? null,
+            minId: this.events[0]?.summary.id ?? null,
+            maxId: this.events[this.events.length - 1]?.summary.id ?? null,
         };
     }
+    /** Clear buffered network events and return the number removed. */
+    clear() {
+        const cleared = this.events.length;
+        this.events = [];
+        return cleared;
+    }
     trim() {
         if (this.events.length <= this.maxSize) {
             return;
         }
         this.events = this.events.slice(this.events.length - this.maxSize);
     }
-    flushWaiters() {
-        if (this.waiters.length === 0) {
-            return;
-        }
-        const remaining = [];
-        for (const waiter of this.waiters) {
-            const events = this.listAfter(waiter.after, waiter.filters, waiter.limit);
-            if (events.length > 0) {
-                clearTimeout(waiter.timer);
-                waiter.resolve(events);
-                continue;
-            }
-            remaining.push(waiter);
-        }
-        this.waiters = remaining;
+    listMatchingSummaries(limit, match) {
+        return this.events
+            .filter(match)
+            .slice(0, limit)
+            .map((event) => event.summary);
     }
-}
-const matchesFilters = (event, filters) => {
-    if (filters.sinceTs && event.ts < filters.sinceTs) {
-        return false;
-    }
-    if (filters.grep) {
-        const haystack = event.url.toLowerCase();
-        const needle = filters.grep.toLowerCase();
-        if (!haystack.includes(needle)) {
-            return false;
-        }
+    listMatchingDetails(limit, match) {
+        return this.events
+            .filter(match)
+            .slice(0, limit)
+            .map((event) => event.detail);
     }
-    return true;
-};
+}
 //# sourceMappingURL=NetBuffer.js.map

package/dist/buffer/NetBuffer.js.map

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

package/dist/buffer/RealtimeNetBuffer.d.ts

@@ -0,0 +1,31 @@
+import type { NetSseSummary, NetWebSocketDetail, NetWebSocketFramePreview, NetWebSocketSummary } from '@vforsh/argus-core';
+import { type NetFilters } from '../net/filtering.js';
+/** Bounded store for realtime network records: WebSocket connections and SSE streams. */
+export declare class RealtimeNetBuffer {
+    private readonly maxSize;
+    private webSockets;
+    private sseStreams;
+    private nextWebSocketId;
+    private nextSseId;
+    constructor(maxSize: number);
+    upsertWebSocket(requestId: string, patch: WebSocketPatch): NetWebSocketDetail;
+    addWebSocketFrame(requestId: string, frame: NetWebSocketFramePreview): void;
+    listWebSocketsAfter(after: number, filters: NetFilters, limit: number): NetWebSocketSummary[];
+    getWebSocketById(id: number): NetWebSocketDetail | null;
+    getWebSocketByRequestId(requestId: string): NetWebSocketDetail | null;
+    upsertSse(requestId: string, patch: SsePatch): NetSseSummary;
+    recordSseEvent(requestId: string, event: {
+        eventId: string | null;
+        eventName: string | null;
+        dataPreview: string | null;
+    }): void;
+    listSseAfter(after: number, filters: NetFilters, limit: number): NetSseSummary[];
+    clear(): number;
+    private findWebSocketByRequestId;
+    private trimWebSockets;
+    private trimSse;
+}
+type WebSocketPatch = Partial<Pick<NetWebSocketDetail, 'url' | 'documentUrl' | 'frameId' | 'state' | 'status' | 'statusText' | 'createdAt' | 'openedAt' | 'closedAt' | 'closeCode' | 'closeReason' | 'errorText' | 'requestHeaders' | 'responseHeaders'>>;
+type SsePatch = Partial<Pick<NetSseSummary, 'url' | 'method' | 'documentUrl' | 'frameId' | 'status' | 'statusText' | 'mimeType' | 'state' | 'openedAt' | 'closedAt' | 'encodedDataLength' | 'eventCount' | 'lastEventId' | 'lastEventName' | 'lastDataPreview' | 'errorText'>>;
+export {};
+//# sourceMappingURL=RealtimeNetBuffer.d.ts.map

package/dist/buffer/RealtimeNetBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeNetBuffer.d.ts","sourceRoot":"","sources":["../../src/buffer/RealtimeNetBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC1H,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIxE,yFAAyF;AACzF,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,eAAe,CAAI;IAC3B,OAAO,CAAC,SAAS,CAAI;gBAET,OAAO,EAAE,MAAM;IAI3B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,kBAAkB;IAuC7E,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,GAAG,IAAI;IAqB3E,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAO7F,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAIvD,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAIrE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,aAAa;IAqC5D,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAYhI,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;IAOhF,KAAK,IAAI,MAAM;IAOf,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,OAAO;CAKf;AAED,KAAK,cAAc,GAAG,OAAO,CAC5B,IAAI,CACH,kBAAkB,EAChB,KAAK,GACL,aAAa,GACb,SAAS,GACT,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,WAAW,GACX,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,iBAAiB,CACnB,CACD,CAAA;AAED,KAAK,QAAQ,GAAG,OAAO,CACtB,IAAI,CACH,aAAa,EACX,KAAK,GACL,QAAQ,GACR,aAAa,GACb,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,OAAO,GACP,UAAU,GACV,UAAU,GACV,mBAAmB,GACnB,YAAY,GACZ,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,WAAW,CACb,CACD,CAAA"}

package/dist/buffer/RealtimeNetBuffer.js

@@ -0,0 +1,190 @@
+import { matchesNetFilters } from '../net/filtering.js';
+const RECENT_FRAME_LIMIT = 20;
+/** Bounded store for realtime network records: WebSocket connections and SSE streams. */
+export class RealtimeNetBuffer {
+    maxSize;
+    webSockets = [];
+    sseStreams = [];
+    nextWebSocketId = 1;
+    nextSseId = 1;
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+    }
+    upsertWebSocket(requestId, patch) {
+        const existing = this.findWebSocketByRequestId(requestId);
+        if (existing) {
+            applyWebSocketPatch(existing, patch);
+            return existing;
+        }
+        const createdAt = patch.createdAt ?? Date.now();
+        const detail = {
+            id: this.nextWebSocketId++,
+            ts: Date.now(),
+            requestId,
+            url: patch.url ?? '',
+            documentUrl: patch.documentUrl ?? null,
+            frameId: patch.frameId ?? null,
+            state: patch.state ?? 'created',
+            status: patch.status ?? null,
+            statusText: patch.statusText ?? null,
+            createdAt,
+            openedAt: patch.openedAt ?? null,
+            closedAt: patch.closedAt ?? null,
+            durationMs: null,
+            sentFrames: 0,
+            receivedFrames: 0,
+            sentBytes: 0,
+            receivedBytes: 0,
+            closeCode: patch.closeCode ?? null,
+            closeReason: patch.closeReason ?? null,
+            errorText: patch.errorText ?? null,
+            requestHeaders: patch.requestHeaders,
+            responseHeaders: patch.responseHeaders,
+            recentFrames: [],
+        };
+        applyWebSocketPatch(detail, patch);
+        this.webSockets.push(detail);
+        this.trimWebSockets();
+        return detail;
+    }
+    addWebSocketFrame(requestId, frame) {
+        const stored = this.findWebSocketByRequestId(requestId);
+        if (!stored) {
+            return;
+        }
+        if (frame.direction === 'sent') {
+            stored.sentFrames += 1;
+            stored.sentBytes += frame.payloadLength;
+        }
+        else {
+            stored.receivedFrames += 1;
+            stored.receivedBytes += frame.payloadLength;
+        }
+        stored.recentFrames.push(frame);
+        if (stored.recentFrames.length > RECENT_FRAME_LIMIT) {
+            stored.recentFrames = stored.recentFrames.slice(stored.recentFrames.length - RECENT_FRAME_LIMIT);
+        }
+        stored.ts = Date.now();
+    }
+    listWebSocketsAfter(after, filters, limit) {
+        return this.webSockets
+            .filter((connection) => connection.id > after && matchesNetFilters(toFilterableRequest(connection, 'WebSocket'), filters))
+            .slice(0, limit)
+            .map(toWebSocketSummary);
+    }
+    getWebSocketById(id) {
+        return this.webSockets.find((connection) => connection.id === id) ?? null;
+    }
+    getWebSocketByRequestId(requestId) {
+        return this.findWebSocketByRequestId(requestId);
+    }
+    upsertSse(requestId, patch) {
+        const existing = this.sseStreams.find((stream) => stream.requestId === requestId);
+        if (existing) {
+            const { openedAt: _openedAt, ...nextPatch } = patch;
+            applySsePatch(existing, nextPatch);
+            return existing;
+        }
+        const openedAt = patch.openedAt ?? Date.now();
+        const stream = {
+            id: this.nextSseId++,
+            ts: Date.now(),
+            requestId,
+            url: patch.url ?? '',
+            method: patch.method ?? 'GET',
+            documentUrl: patch.documentUrl ?? null,
+            frameId: patch.frameId ?? null,
+            status: patch.status ?? null,
+            statusText: patch.statusText ?? null,
+            mimeType: patch.mimeType ?? null,
+            state: patch.state ?? 'open',
+            openedAt,
+            closedAt: patch.closedAt ?? null,
+            durationMs: null,
+            encodedDataLength: patch.encodedDataLength ?? null,
+            eventCount: 0,
+            lastEventId: null,
+            lastEventName: null,
+            lastDataPreview: null,
+            errorText: patch.errorText ?? null,
+        };
+        applySsePatch(stream, patch);
+        this.sseStreams.push(stream);
+        this.trimSse();
+        return stream;
+    }
+    recordSseEvent(requestId, event) {
+        const stream = this.sseStreams.find((candidate) => candidate.requestId === requestId);
+        if (!stream) {
+            return;
+        }
+        stream.eventCount += 1;
+        stream.lastEventId = event.eventId;
+        stream.lastEventName = event.eventName;
+        stream.lastDataPreview = event.dataPreview;
+        stream.ts = Date.now();
+    }
+    listSseAfter(after, filters, limit) {
+        return this.sseStreams
+            .filter((stream) => stream.id > after && matchesNetFilters(toFilterableRequest(stream, 'EventSource'), filters))
+            .slice(0, limit)
+            .map((stream) => stream);
+    }
+    clear() {
+        const cleared = this.webSockets.length + this.sseStreams.length;
+        this.webSockets = [];
+        this.sseStreams = [];
+        return cleared;
+    }
+    findWebSocketByRequestId(requestId) {
+        return this.webSockets.find((connection) => connection.requestId === requestId) ?? null;
+    }
+    trimWebSockets() {
+        if (this.webSockets.length > this.maxSize) {
+            this.webSockets = this.webSockets.slice(this.webSockets.length - this.maxSize);
+        }
+    }
+    trimSse() {
+        if (this.sseStreams.length > this.maxSize) {
+            this.sseStreams = this.sseStreams.slice(this.sseStreams.length - this.maxSize);
+        }
+    }
+}
+const applyWebSocketPatch = (detail, patch) => {
+    for (const [key, value] of Object.entries(patch)) {
+        if (value !== undefined) {
+            ;
+            detail[key] = value;
+        }
+    }
+    detail.ts = Date.now();
+    detail.durationMs = detail.closedAt != null ? Math.max(0, detail.closedAt - detail.createdAt) : null;
+};
+const toWebSocketSummary = ({ recentFrames: _recentFrames, requestHeaders: _requestHeaders, responseHeaders: _responseHeaders, ...summary }) => summary;
+const applySsePatch = (stream, patch) => {
+    for (const [key, value] of Object.entries(patch)) {
+        if (value !== undefined) {
+            ;
+            stream[key] = value;
+        }
+    }
+    stream.ts = Date.now();
+    stream.durationMs = stream.closedAt != null ? Math.max(0, stream.closedAt - stream.openedAt) : null;
+};
+const toFilterableRequest = (record, resourceType) => ({
+    id: record.id,
+    ts: record.ts,
+    requestId: record.requestId,
+    url: record.url,
+    method: record.method ?? 'GET',
+    documentUrl: record.documentUrl,
+    requestHeaders: undefined,
+    resourceType,
+    mimeType: record.mimeType ?? null,
+    frameId: record.frameId,
+    status: record.status,
+    encodedDataLength: record.encodedDataLength ?? null,
+    errorText: record.errorText ?? null,
+    durationMs: record.durationMs,
+});
+//# sourceMappingURL=RealtimeNetBuffer.js.map

package/dist/buffer/RealtimeNetBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeNetBuffer.js","sourceRoot":"","sources":["../../src/buffer/RealtimeNetBuffer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAmB,MAAM,qBAAqB,CAAA;AAExE,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAE7B,yFAAyF;AACzF,MAAM,OAAO,iBAAiB;IACZ,OAAO,CAAQ;IACxB,UAAU,GAAyB,EAAE,CAAA;IACrC,UAAU,GAAoB,EAAE,CAAA;IAChC,eAAe,GAAG,CAAC,CAAA;IACnB,SAAS,GAAG,CAAC,CAAA;IAErB,YAAY,OAAe;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;IAED,eAAe,CAAC,SAAiB,EAAE,KAAqB;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAA;QACzD,IAAI,QAAQ,EAAE,CAAC;YACd,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YACpC,OAAO,QAAQ,CAAA;QAChB,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;QAC/C,MAAM,MAAM,GAAuB;YAClC,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE;YAC1B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,SAAS;YACT,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;YACtC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;YAC/B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;YACpC,SAAS;YACT,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,CAAC;YACb,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;YACtC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,YAAY,EAAE,EAAE;SAChB,CAAA;QACD,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAA;QACrB,OAAO,MAAM,CAAA;IACd,CAAC;IAED,iBAAiB,CAAC,SAAiB,EAAE,KAA+B;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAA;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAM;QACP,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAChC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;YACtB,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,aAAa,CAAA;QACxC,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,cAAc,IAAI,CAAC,CAAA;YAC1B,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,CAAA;QAC5C,CAAC;QAED,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACrD,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAA;QACjG,CAAC;QACD,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACvB,CAAC;IAED,mBAAmB,CAAC,KAAa,EAAE,OAAmB,EAAE,KAAa;QACpE,OAAO,IAAI,CAAC,UAAU;aACpB,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,KAAK,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;aACzH,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,kBAAkB,CAAC,CAAA;IAC1B,CAAC;IAED,gBAAgB,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAA;IAC1E,CAAC;IAED,uBAAuB,CAAC,SAAiB;QACxC,OAAO,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAChD,CAAC;IAED,SAAS,CAAC,SAAiB,EAAE,KAAe;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAA;QACjF,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAA;YACnD,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YAClC,OAAO,QAAQ,CAAA;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;QAC7C,MAAM,MAAM,GAAkB;YAC7B,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE;YACpB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,SAAS;YACT,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK;YAC7B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;YACtC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM;YAC5B,QAAQ;YACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;YAClD,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,IAAI;YACnB,eAAe,EAAE,IAAI;YACrB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;SAClC,CAAA;QACD,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5B,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,OAAO,MAAM,CAAA;IACd,CAAC;IAED,cAAc,CAAC,SAAiB,EAAE,KAAuF;QACxH,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,CAAA;QACrF,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAM;QACP,CAAC;QACD,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;QACtB,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAA;QAClC,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,SAAS,CAAA;QACtC,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,WAAW,CAAA;QAC1C,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACvB,CAAC;IAED,YAAY,CAAC,KAAa,EAAE,OAAmB,EAAE,KAAa;QAC7D,OAAO,IAAI,CAAC,UAAU;aACpB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;aAC/G,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAA;QAC/D,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;QACpB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;QACpB,OAAO,OAAO,CAAA;IACf,CAAC;IAEO,wBAAwB,CAAC,SAAiB;QACjD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI,IAAI,CAAA;IACxF,CAAC;IAEO,cAAc;QACrB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/E,CAAC;IACF,CAAC;IAEO,OAAO;QACd,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/E,CAAC;IACF,CAAC;CACD;AA4CD,MAAM,mBAAmB,GAAG,CAAC,MAA0B,EAAE,KAAqB,EAAQ,EAAE;IACvF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,CAAC;YAAC,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAClD,CAAC;IACF,CAAC;IACD,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACrG,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,EAC3B,YAAY,EAAE,aAAa,EAC3B,cAAc,EAAE,eAAe,EAC/B,eAAe,EAAE,gBAAgB,EACjC,GAAG,OAAO,EACU,EAAuB,EAAE,CAAC,OAAO,CAAA;AAEtD,MAAM,aAAa,GAAG,CAAC,MAAqB,EAAE,KAAe,EAAQ,EAAE;IACtE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,CAAC;YAAC,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAClD,CAAC;IACF,CAAC;IACD,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACpG,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAC3B,MAKC,EACD,YAAoB,EACnB,EAAE,CAAC,CAAC;IACL,EAAE,EAAE,MAAM,CAAC,EAAE;IACb,EAAE,EAAE,MAAM,CAAC,EAAE;IACb,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,KAAK;IAC9B,WAAW,EAAE,MAAM,CAAC,WAAW;IAC/B,cAAc,EAAE,SAAS;IACzB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;IACjC,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,IAAI;IACnD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;IACnC,UAAU,EAAE,MAAM,CAAC,UAAU;CAC7B,CAAC,CAAA"}

package/dist/cdp/accessibility.d.ts

@@ -1,10 +1,18 @@
 import type { SnapshotResponse } from '@vforsh/argus-core';
 import type { CdpSessionHandle } from './connection.js';
+import type { ElementRefRegistry } from './elementRefs.js';
 export type FetchSnapshotOptions = {
     selector?: string;
     depth?: number;
     interactive?: boolean;
 };
+export type AccessibleElementRecord = {
+    backendNodeId: number;
+    ref: string;
+    role: string;
+    name: string;
+    value?: string;
+};
 /**
  * Fetch an accessibility tree snapshot.
  *
@@ -14,5 +22,8 @@ export type FetchSnapshotOptions = {
  * 4. Reconstruct flat array into nested tree
  * 5. Apply filters (skip ignored, flatten generic, interactive-only, depth)
  */
-export declare const fetchAccessibilitySnapshot: (session: CdpSessionHandle, options: FetchSnapshotOptions) => Promise<SnapshotResponse>;
+export declare const fetchAccessibilitySnapshot: (session: CdpSessionHandle, options: FetchSnapshotOptions, elementRefs: ElementRefRegistry) => Promise<SnapshotResponse>;
+export declare const listAccessibleElements: (session: CdpSessionHandle, elementRefs: ElementRefRegistry, options?: {
+    selector?: string;
+}) => Promise<AccessibleElementRecord[]>;
 //# sourceMappingURL=accessibility.d.ts.map

package/dist/cdp/accessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/cdp/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAoCvD,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AA6ED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAU,SAAS,gBAAgB,EAAE,SAAS,oBAAoB,KAAG,OAAO,CAAC,gBAAgB,CAmEnI,CAAA"}
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/cdp/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAqC1D,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACrC,aAAa,EAAE,MAAM,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AA6ED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACtC,SAAS,gBAAgB,EACzB,SAAS,oBAAoB,EAC7B,aAAa,kBAAkB,KAC7B,OAAO,CAAC,gBAAgB,CAe1B,CAAA;AAED,eAAO,MAAM,sBAAsB,GAClC,SAAS,gBAAgB,EACzB,aAAa,kBAAkB,EAC/B,UAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,KACjC,OAAO,CAAC,uBAAuB,EAAE,CAGnC,CAAA"}