cdp-mcp 0.1.0

package/dist/tools/execution.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { requireSession, requirePaused } from "../session/state.js";
+import { mapCdpToOriginal } from "../sourcemap/store.js";
+import { registerJsonTool } from "./_register.js";
+export function registerExecutionTools(server) {
+    registerJsonTool(server, "resume", "Resume execution. Dispatched to the session that paused (root, worker, OOPIF, …).", undefined, async () => {
+        const s = requirePaused();
+        const sid = s.pause.current().sessionId;
+        await s.client.send("Debugger.resume", undefined, sid);
+        return "resumed";
+    });
+    registerJsonTool(server, "step_over", "Step over the current line. Awaits the next pause (or returns null if execution continues).", { timeout_ms: z.number().int().positive().optional() }, async (input) => stepThen((s, sid) => s.client.send("Debugger.stepOver", undefined, sid), input.timeout_ms));
+    registerJsonTool(server, "step_into", "Step into the next function call.", { timeout_ms: z.number().int().positive().optional() }, async (input) => stepThen((s, sid) => s.client.send("Debugger.stepInto", undefined, sid), input.timeout_ms));
+    registerJsonTool(server, "step_out", "Step out of the current function.", { timeout_ms: z.number().int().positive().optional() }, async (input) => stepThen((s, sid) => s.client.send("Debugger.stepOut", undefined, sid), input.timeout_ms));
+    registerJsonTool(server, "pause", "Pause execution manually at the next statement. By default targets the root page; pass `session_id` (from list_targets or a script's session_id) to pause a specific worker/iframe/service-worker.", {
+        session_id: z.string().nullable().optional().describe("null or omitted = root."),
+    }, async (input) => {
+        const s = requireSession();
+        const sid = input.session_id ?? undefined;
+        await s.client.send("Debugger.pause", undefined, sid);
+        return { paused_session: sid ?? null };
+    });
+    registerJsonTool(server, "wait_for_pause", "Block until the debugger pauses (or times out). Returns the pause reason and a TS-mapped call stack.", { timeout_ms: z.number().int().positive().optional().describe("Default 30000") }, async (input) => {
+        const s = requireSession();
+        const state = await s.pause.waitForPause(input.timeout_ms ?? 30000);
+        return summarizePause(s, state.reason, state.hitBreakpoints, state.data, state.callFrames, state.sessionId);
+    });
+}
+async function stepThen(send, timeoutMs) {
+    const s = requirePaused();
+    // Capture the paused session BEFORE marking resumed — pauseState is cleared
+    // by onResumed and we still need the sessionId to route the step command.
+    const sid = s.pause.current().sessionId;
+    s.pause.onResumed();
+    await send(s, sid);
+    const next = await s.pause.waitForPauseOrResume(timeoutMs ?? 30000);
+    if (!next)
+        return { paused: false, message: "execution did not pause within timeout" };
+    return {
+        paused: true,
+        ...summarizePause(s, next.reason, next.hitBreakpoints, next.data, next.callFrames, next.sessionId),
+    };
+}
+export function summarizePause(s, reason, hitBreakpoints, data, callFrames, sessionId) {
+    const userBreakpointIds = matchUserBreakpoints(s, hitBreakpoints ?? [], sessionId);
+    return {
+        reason,
+        hit_breakpoint_ids: userBreakpointIds,
+        session_id: sessionId ?? null,
+        data: data ?? null,
+        call_stack: callFrames.map((cf, i) => formatFrameForPause(s, cf, i, sessionId)),
+    };
+}
+function formatFrameForPause(s, cf, index, sessionId) {
+    const mapped = mapCdpToOriginal(s.scripts, cf.location, sessionId);
+    const script = s.scripts.get(cf.location.scriptId, sessionId);
+    return {
+        index,
+        frame_id: cf.callFrameId,
+        session_id: sessionId ?? null,
+        function_name: cf.functionName || "(anonymous)",
+        file: mapped?.file ?? script?.url ?? cf.url ?? "<unknown>",
+        line: mapped?.line ?? cf.location.lineNumber + 1,
+        column: mapped?.column ?? cf.location.columnNumber ?? 0,
+        js_url: script?.url,
+        js_line: cf.location.lineNumber + 1,
+        js_column: cf.location.columnNumber ?? 0,
+        scope_types: cf.scopeChain.map((sc) => sc.type),
+        this: cf.this ? { type: cf.this.subtype ?? cf.this.type, preview: cf.this.description ?? "" } : null,
+    };
+}
+/** @internal exported for unit tests; not part of the MCP tool surface. */
+export function matchUserBreakpoints(s, hit, pauseSessionId) {
+    if (!hit.length)
+        return [];
+    const out = [];
+    for (const rec of s.breakpoints.values()) {
+        // Require BOTH cdpId AND sessionId match. setBreakpointByUrl derives
+        // the breakpoint ID from URL/line/column, so two sessions binding the
+        // same script can mint colliding cdpIds. Without the sessionId guard,
+        // a pause in one session would falsely be reported as a hit for
+        // another session's binding. undefined === undefined for root.
+        if (rec.bindings.some((b) => hit.includes(b.cdpId) && b.sessionId === pauseSessionId)) {
+            out.push(rec.id);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=execution.js.map

package/dist/tools/execution.js.map

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

package/dist/tools/inspect.js

@@ -0,0 +1,178 @@
+import { z } from "zod";
+import { requireSession, requirePaused } from "../session/state.js";
+import { mapCdpToOriginal } from "../sourcemap/store.js";
+import { describeRemote, previewRemoteObject } from "../util/format.js";
+import { ToolError } from "../util/errors.js";
+import { registerJsonTool } from "./_register.js";
+// session_id provenance: objectIds, callFrameIds, and scriptIds returned by
+// CDP are scoped per-session (per-target). The inspect tools attach
+// `session_id` to every returned remote-object so the agent can pass it back
+// to get_object_properties and route to the correct Runtime agent.
+export function registerInspectTools(server) {
+    registerJsonTool(server, "get_call_stack", "Get the current call stack with TS-mapped frames. Only valid while paused. Each frame includes the session_id its Runtime/Debugger agent belongs to — pass it through to evaluate/get_object_properties for the right routing.", undefined, async () => {
+        const s = requirePaused();
+        const state = s.pause.current();
+        const sid = state.sessionId;
+        return state.callFrames.map((cf, i) => {
+            const mapped = mapCdpToOriginal(s.scripts, cf.location, sid);
+            const script = s.scripts.get(cf.location.scriptId, sid);
+            return {
+                index: i,
+                frame_id: cf.callFrameId,
+                session_id: sid ?? null,
+                function_name: cf.functionName || "(anonymous)",
+                file: mapped?.file ?? script?.url ?? cf.url ?? "<unknown>",
+                line: mapped?.line ?? cf.location.lineNumber + 1,
+                column: mapped?.column ?? cf.location.columnNumber ?? 0,
+                js_url: script?.url,
+                js_line: cf.location.lineNumber + 1,
+                scope_types: cf.scopeChain.map((sc) => sc.type),
+            };
+        });
+    });
+    registerJsonTool(server, "get_scope", "Return variables visible at a paused frame. Valid only while paused. Each item includes the session_id of the originating Runtime agent — required for follow-on get_object_properties calls when paused in a worker/iframe.", {
+        frame_index: z.number().int().nonnegative().optional().describe("Default 0 (topmost frame)"),
+        scope_type: z
+            .enum(["local", "closure", "global", "block", "catch", "with", "script", "eval", "module"])
+            .optional()
+            .describe("Default: local"),
+        max_props: z.number().int().positive().optional(),
+    }, async (input) => {
+        const s = requirePaused();
+        const state = s.pause.current();
+        const sid = state.sessionId;
+        const idx = input.frame_index ?? 0;
+        const frame = state.callFrames[idx];
+        if (!frame)
+            throw new ToolError("bad_frame", `Frame ${idx} out of range (${state.callFrames.length} frames)`);
+        const targetType = input.scope_type ?? "local";
+        const scope = frame.scopeChain.find((sc) => sc.type === targetType);
+        if (!scope?.object?.objectId) {
+            throw new ToolError("no_scope", `Frame ${idx} has no '${targetType}' scope. Available: ${frame.scopeChain.map((sc) => sc.type).join(", ")}`);
+        }
+        const max = input.max_props ?? 50;
+        const result = await s.client.send("Runtime.getProperties", {
+            objectId: scope.object.objectId,
+            ownProperties: false,
+            accessorPropertiesOnly: false,
+            generatePreview: true,
+        }, sid);
+        const items = (result.result ?? [])
+            .filter((p) => !p.symbol)
+            .slice(0, max)
+            .map((p) => ({
+            name: p.name,
+            ...(p.value ? describeRemote(p.value) : { type: "missing", preview: "(no value)" }),
+            session_id: sid ?? null,
+            writable: p.writable,
+            enumerable: p.enumerable,
+        }));
+        return {
+            frame_index: idx,
+            scope_type: targetType,
+            session_id: sid ?? null,
+            items,
+            truncated: (result.result?.length ?? 0) > max,
+        };
+    });
+    registerJsonTool(server, "evaluate", "Evaluate a JS expression. When the debugger is paused, the expression runs in the paused frame's context via Debugger.evaluateOnCallFrame (top frame by default; override with frame_index). When not paused, runs in the page's Runtime context via Runtime.evaluate. frame_index given while not paused is a not_paused error. Note: while paused the event loop is frozen, so async expressions return the unresolved Promise object rather than awaiting it.", {
+        expression: z.string(),
+        frame_index: z.number().int().nonnegative().optional(),
+        return_by_value: z.boolean().optional(),
+        timeout_ms: z.number().int().positive().optional(),
+    }, async (input) => {
+        const s = requireSession();
+        const paused = s.pause.isPaused();
+        if (input.frame_index !== undefined && !paused) {
+            throw new ToolError("not_paused", "frame_index requires paused state");
+        }
+        if (paused) {
+            const state = s.pause.current();
+            const sid = state.sessionId;
+            const idx = input.frame_index ?? 0;
+            const frame = state.callFrames[idx];
+            if (!frame)
+                throw new ToolError("bad_frame", `Frame ${idx} out of range (${state.callFrames.length} frames)`);
+            const res = await s.client.send("Debugger.evaluateOnCallFrame", {
+                callFrameId: frame.callFrameId,
+                expression: input.expression,
+                returnByValue: !!input.return_by_value,
+                generatePreview: true,
+                throwOnSideEffect: false,
+                ...(input.timeout_ms ? { timeout: input.timeout_ms } : {}),
+            }, sid);
+            return formatEvalResult(res.result, res.exceptionDetails, sid);
+        }
+        const res = await s.client.send("Runtime.evaluate", {
+            expression: input.expression,
+            returnByValue: !!input.return_by_value,
+            generatePreview: true,
+            awaitPromise: true,
+            ...(input.timeout_ms ? { timeout: input.timeout_ms } : {}),
+        });
+        return formatEvalResult(res.result, res.exceptionDetails, undefined);
+    });
+    registerJsonTool(server, "get_object_properties", "Inspect a RemoteObject by ID (from get_scope, evaluate, or a callstack frame). Pass `session_id` from the source response so the call routes to the right Runtime agent — null or omitted means root.", {
+        object_id: z.string(),
+        session_id: z.string().nullable().optional().describe("From get_scope/evaluate/get_call_stack response. null or omitted = root."),
+        own_only: z.boolean().optional().describe("Default true"),
+        max_props: z.number().int().positive().optional(),
+    }, async (input) => {
+        const s = requireSession();
+        // Strict provenance: omitted session_id means root. The previous
+        // "fall back to the paused session" behavior misrouted any
+        // root-minted objectId once a child session was paused — a root
+        // `evaluate` response carries no session_id (JSON drops undefined),
+        // so an agent could not pass it back, and the fallback then
+        // dispatched against the wrong target.
+        // null is the explicit "root" sentinel agents round-trip from responses;
+        // CDP wants undefined for root.
+        const sid = input.session_id ?? undefined;
+        const max = input.max_props ?? 50;
+        const ownProperties = input.own_only ?? true;
+        const result = await s.client.send("Runtime.getProperties", {
+            objectId: input.object_id,
+            ownProperties,
+            accessorPropertiesOnly: false,
+            generatePreview: true,
+        }, sid);
+        return {
+            session_id: sid ?? null,
+            items: (result.result ?? [])
+                .filter((p) => !p.symbol)
+                .slice(0, max)
+                .map((p) => ({
+                name: p.name,
+                ...(p.value ? describeRemote(p.value) : { type: "missing", preview: "(no value)" }),
+                session_id: sid ?? null,
+                writable: p.writable,
+                enumerable: p.enumerable,
+            })),
+            truncated: (result.result?.length ?? 0) > max,
+        };
+    });
+}
+function formatEvalResult(result, exceptionDetails, sessionId) {
+    // Emit session_id as `null` for root (not undefined) so it survives JSON
+    // serialization. Agents need a value to round-trip into
+    // get_object_properties — otherwise a root-evaluate response with no
+    // session_id field has nothing for the agent to pass back, and any
+    // omit-then-default fallback misroutes when a child session is paused.
+    const sid = sessionId ?? null;
+    if (exceptionDetails) {
+        return {
+            error: true,
+            message: exceptionDetails.exception?.description ?? exceptionDetails.text,
+            ...(exceptionDetails.exception?.objectId ? { object_id: exceptionDetails.exception.objectId } : {}),
+            session_id: sid,
+        };
+    }
+    return {
+        type: result.subtype ?? result.type,
+        preview: previewRemoteObject(result),
+        value: "value" in result ? result.value : undefined,
+        ...(result.objectId ? { object_id: result.objectId } : {}),
+        session_id: sid,
+    };
+}
+//# sourceMappingURL=inspect.js.map

package/dist/tools/inspect.js.map

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

package/dist/tools/nav.js

@@ -0,0 +1,136 @@
+import { z } from "zod";
+import { requireSession } from "../session/state.js";
+import { registerJsonTool } from "./_register.js";
+export function registerNavTools(server) {
+    registerJsonTool(server, "navigate", "Navigate the active page to a URL. Waits for the chosen load milestone.", {
+        url: z.string(),
+        wait: z.enum(["load", "domcontentloaded", "networkidle", "none"]).optional()
+            .describe("Default: load"),
+        timeout_ms: z.number().int().positive().optional(),
+    }, async (input) => {
+        const s = requireSession();
+        const wait = input.wait ?? "load";
+        const timeout = input.timeout_ms ?? 30000;
+        const loadPromise = waitForLoad(s.client, wait, timeout);
+        await s.client.send("Page.navigate", { url: input.url });
+        await loadPromise;
+        const { frameTree } = await s.client.send("Page.getFrameTree");
+        return { url: frameTree.frame.url, wait };
+    });
+    registerJsonTool(server, "reload", "Reload the active page.", { hard: z.boolean().optional().describe("Bypass cache") }, async (input) => {
+        const s = requireSession();
+        await s.client.send("Page.reload", { ignoreCache: !!input.hard });
+        return "reloaded";
+    });
+    registerJsonTool(server, "get_url", "Return the current top-frame URL.", undefined, async () => {
+        const s = requireSession();
+        const { frameTree } = await s.client.send("Page.getFrameTree");
+        return { url: frameTree.frame.url };
+    });
+}
+function waitForLoad(client, mode, timeoutMs) {
+    if (mode === "none")
+        return Promise.resolve();
+    // Gate to the root session: top-level navigation completion is only
+    // meaningful for the top frame. Now that the multi-target fix wires
+    // Page.enable + Network.enable for every child session (OOPIFs, workers,
+    // service workers), their events stream through the same root client
+    // tagged with their own eventSessionId. Without this gate, a cross-origin
+    // iframe firing Page.loadEventFired would prematurely settle navigate(),
+    // and an analytics iframe polling /beacon would starve `networkidle`
+    // forever.
+    const isRoot = (esid) => esid === undefined;
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const listeners = [];
+        const off = (api) => {
+            for (const { event, fn } of listeners) {
+                api.removeListener(event, fn);
+            }
+            listeners.length = 0;
+        };
+        const reg = (event, fn) => {
+            client.on(event, fn);
+            listeners.push({ event, fn });
+        };
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            off(client);
+            reject(new Error(`navigate: ${mode} not reached within ${timeoutMs}ms`));
+        }, timeoutMs);
+        let idleTimer = null;
+        const done = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (idleTimer)
+                clearTimeout(idleTimer);
+            off(client);
+            resolve();
+        };
+        if (mode === "load") {
+            reg("Page.loadEventFired", (_p, esid) => {
+                if (isRoot(esid))
+                    done();
+            });
+        }
+        else if (mode === "domcontentloaded") {
+            reg("Page.domContentEventFired", (_p, esid) => {
+                if (isRoot(esid))
+                    done();
+            });
+        }
+        else if (mode === "networkidle") {
+            // Track in-flight root-session requests. The previous version reset
+            // the 500ms idle timer on both requestWillBeSent and loadingFinished
+            // — which meant a slow request that took 600ms to finish would emit
+            // the start event, then 500ms later `done()` fired while the
+            // request was still loading. networkidle resolved while a request
+            // was in flight.
+            //
+            // Correct semantics: idle timer starts ONLY when the in-flight set
+            // is empty, and resets whenever a new request joins.
+            const inFlight = new Set();
+            const armIdleIfEmpty = () => {
+                if (settled)
+                    return;
+                if (idleTimer)
+                    clearTimeout(idleTimer);
+                if (inFlight.size === 0)
+                    idleTimer = setTimeout(done, 500);
+            };
+            reg("Network.requestWillBeSent", (p, esid) => {
+                if (settled || !isRoot(esid))
+                    return;
+                // Skip persistent-connection types: WebSocket and EventSource stay
+                // open until the page navigates away, so they never emit
+                // Network.loadingFinished — tracking them would hold networkidle
+                // forever. Every Vite/Next/Astro dev server opens an HMR WebSocket,
+                // so this was the universal failure mode.
+                if (p.type === "WebSocket" || p.type === "EventSource")
+                    return;
+                inFlight.add(p.requestId);
+                if (idleTimer)
+                    clearTimeout(idleTimer);
+            });
+            reg("Network.loadingFinished", (p, esid) => {
+                if (settled || !isRoot(esid))
+                    return;
+                inFlight.delete(p.requestId);
+                armIdleIfEmpty();
+            });
+            reg("Network.loadingFailed", (p, esid) => {
+                if (settled || !isRoot(esid))
+                    return;
+                inFlight.delete(p.requestId);
+                armIdleIfEmpty();
+            });
+            // Initial arm — if nothing fires, we're already idle.
+            armIdleIfEmpty();
+        }
+    });
+}
+//# sourceMappingURL=nav.js.map

package/dist/tools/nav.js.map

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

package/dist/tools/network.js

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { requireSession } from "../session/state.js";
+import { truncate } from "../util/format.js";
+import { registerJsonTool } from "./_register.js";
+export function registerNetworkTools(server) {
+    registerJsonTool(server, "get_network_requests", "Query buffered network requests. Paginate with `since`. Bodies are NOT included — fetch via get_request_body/get_response_body.", {
+        since: z.number().int().nonnegative().optional(),
+        status: z.number().int().optional(),
+        type: z.string().optional().describe("e.g. Fetch, XHR, Document, Script"),
+        url_match: z.string().optional().describe("Substring filter"),
+        finished: z.boolean().optional().describe("If true, only return entries whose lifecycle has completed (loaded OR failed — also check the `failure` field before calling get_response_body)"),
+        limit: z.number().int().positive().optional(),
+    }, async (input) => {
+        const s = requireSession();
+        const match = input.url_match;
+        const items = s.network.query({
+            since: input.since ?? 0,
+            limit: input.limit ?? 50,
+            filter: (e) => {
+                if (input.status !== undefined && e.status !== input.status)
+                    return false;
+                if (input.type && e.resourceType !== input.type)
+                    return false;
+                if (match && !e.url.includes(match))
+                    return false;
+                if (input.finished === true && !e.finished)
+                    return false;
+                if (input.finished === false && e.finished)
+                    return false;
+                return true;
+            },
+        });
+        return {
+            cursor: items.length ? items[items.length - 1].seq : input.since ?? 0,
+            items: items.map((e) => ({
+                seq: e.seq,
+                request_id: e.requestId,
+                // session_id is required to disambiguate when fetching the body —
+                // CDP requestIds are per-Network-agent, so two iframes can both
+                // emit requestId="123", and the root↔child case has the same
+                // collision risk. Emit `null` for root (rather than undefined) so
+                // the field survives JSON serialization and agents can round-trip
+                // it back to get_request_body / get_response_body.
+                session_id: e.sessionId ?? null,
+                ts: e.ts,
+                method: e.method,
+                url: e.url,
+                type: e.resourceType,
+                status: e.status,
+                status_text: e.statusText,
+                mime_type: e.mimeType,
+                from_cache: e.fromCache,
+                finished: !!e.finished,
+                duration_ms: e.durationMs,
+                failure: e.failureReason,
+            })),
+        };
+    });
+    registerJsonTool(server, "get_request_body", "Fetch the request body for a request ID. Often empty for GETs. Pass `session_id` from the get_network_requests item to disambiguate when child sessions have colliding request_ids. `null` = root.", {
+        request_id: z.string(),
+        session_id: z.string().nullable().optional().describe("From get_network_requests. null or omitted = root."),
+        max_chars: z.number().int().positive().optional(),
+    }, async (input) => {
+        const s = requireSession();
+        const max = input.max_chars ?? 4000;
+        // Normalize null→undefined for CDP. After normalization, sid is the
+        // session the agent intends (undefined = root, string = child).
+        const sid = input.session_id ?? undefined;
+        const entry = findEntry(s, input.request_id, sid);
+        try {
+            const r = await s.client.send("Network.getRequestPostData", { requestId: input.request_id }, sid ?? entry?.sessionId);
+            const body = r.postData ?? "";
+            return {
+                request_id: input.request_id,
+                body: truncate(body, max),
+                truncated_at: body.length > max ? max : null,
+                total_length: body.length,
+            };
+        }
+        catch (e) {
+            return { request_id: input.request_id, body: null, error: String(e) };
+        }
+    });
+    registerJsonTool(server, "get_response_body", "Fetch the response body for a request ID. Only safe when `finished: true` AND `failure` is absent in get_network_requests — failed requests are also `finished: true` but have no body. Pass `session_id` from the get_network_requests item to disambiguate cross-session request_id collisions. Binary payloads (base64_encoded=true) are returned as a clean base64 string — call Buffer.from(body, 'base64') to get raw bytes. Server does NOT decode binary to UTF-8 (which would corrupt PNGs/fonts/wasm/etc.) and does NOT truncate base64 bodies (truncation appended text characters that were inside the base64 alphabet, silently corrupting the tail bytes).", {
+        request_id: z.string(),
+        session_id: z.string().nullable().optional().describe("From get_network_requests. null or omitted = root."),
+        max_chars: z.number().int().positive().optional().describe("Only applied to TEXT responses; base64 payloads are returned in full"),
+    }, async (input) => {
+        const s = requireSession();
+        const max = input.max_chars ?? 4000;
+        const sid = input.session_id ?? undefined;
+        const entry = findEntry(s, input.request_id, sid);
+        try {
+            const r = await s.client.send("Network.getResponseBody", { requestId: input.request_id }, sid ?? entry?.sessionId);
+            const body = r.body;
+            // Text path: truncate freely. Base64 path: NEVER truncate — the old
+            // truncate() suffix "…(+N chars)" contains characters (digits, letters,
+            // `+`) that Node's lenient base64 decoder happily consumes as extra
+            // bytes, silently corrupting the tail of any binary response.
+            // Callers wanting more than the default should pass max_chars; for
+            // binary they get the whole thing.
+            if (r.base64Encoded) {
+                return {
+                    request_id: input.request_id,
+                    base64_encoded: true,
+                    body,
+                    truncated_at: null,
+                    total_length: body.length,
+                };
+            }
+            return {
+                request_id: input.request_id,
+                base64_encoded: false,
+                body: truncate(body, max),
+                truncated_at: body.length > max ? max : null,
+                total_length: body.length,
+            };
+        }
+        catch (e) {
+            return { request_id: input.request_id, body: null, error: String(e) };
+        }
+    });
+}
+// Find the most-recent entry matching (requestId, sessionId). Strict match:
+// omitted session_id means "root" (sessionId === undefined). The earlier
+// permissive fallback (omitted matches any) created a root↔child collision
+// hole — get_network_requests emits session_id:null for root entries
+// (because JSON drops undefined), agents had no value to pass back, and the
+// permissive filter then picked the most-recent matching requestId which
+// could be a child entry, routing the body fetch to the wrong agent.
+function findEntry(s, requestId, sessionId) {
+    return s.network.query({
+        filter: (e) => e.requestId === requestId && (e.sessionId ?? undefined) === sessionId,
+        limit: 1,
+    }).pop();
+}
+//# sourceMappingURL=network.js.map

package/dist/tools/network.js.map

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