cdp-mcp 0.2.1 → 0.4.0

package/dist/tools/execution.js

@@ -1,89 +0,0 @@
-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

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

package/dist/tools/forms.d.ts

@@ -1,8 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * Form-driving tools (issue #12 items 1, 2, 3, 6). Each LocatorSpec-driven tool
- * resolves its target through the shared in-page locator runtime (the same
- * `findElements`/visibility semantics as `locate`), mutates it, and dispatches
- * `input`/`change` so app frameworks observe the change.
- */
-export declare function registerFormTools(server: McpServer): void;

package/dist/tools/forms.js

@@ -1,256 +0,0 @@
-import { z } from "zod";
-import { requireSession } from "../session/state.js";
-import { ToolError } from "../util/errors.js";
-import { registerJsonTool } from "./_register.js";
-import { locatorShape } from "../locator.js";
-import { normalizeLocator, locatorHelpersScript, mutationHelpersScript, } from "./_locator_runtime.js";
-/**
- * Form-driving tools (issue #12 items 1, 2, 3, 6). Each LocatorSpec-driven tool
- * resolves its target through the shared in-page locator runtime (the same
- * `findElements`/visibility semantics as `locate`), mutates it, and dispatches
- * `input`/`change` so app frameworks observe the change.
- */
-export function registerFormTools(server) {
-    registerJsonTool(server, "select_option", "Set the value of a native <select> located by LocatorSpec. Match options by option_value, option_label, and/or option_index (named distinctly from the locator's own fields). Dispatches input + change. For <select multiple>, pass multiple:true to select every match. Returns status:\"selected\" with the resolved option(s).", {
-        ...locatorShape,
-        option_value: z
-            .union([z.string(), z.array(z.string())])
-            .optional()
-            .describe("Option value attribute(s) to select."),
-        option_label: z
-            .union([z.string(), z.array(z.string())])
-            .optional()
-            .describe("Visible option label/text to select."),
-        option_index: z
-            .union([z.number().int().nonnegative(), z.array(z.number().int().nonnegative())])
-            .optional()
-            .describe("Zero-based option index(es) to select."),
-        multiple: z.boolean().optional().describe("Select every match in a <select multiple> (default false: first match only)."),
-        session_id: z.string().optional().describe("Target a worker/iframe session; omit for the root page."),
-    }, async (input) => {
-        const values = toArray(input.option_value);
-        const labels = toArray(input.option_label);
-        const indexes = toArray(input.option_index);
-        if (values.length === 0 && labels.length === 0 && indexes.length === 0) {
-            throw new ToolError("missing_arg", "select_option requires one of option_value, option_label, or option_index");
-        }
-        const locator = normalizeLocator(input);
-        const body = String.raw `
-        if (!(el instanceof HTMLSelectElement)) return { ok: false, error: "element is not a <select>", code: "wrong_element" };
-        const wantValues = ${JSON.stringify(values)};
-        const wantLabels = ${JSON.stringify(labels)};
-        const wantIndexes = ${JSON.stringify(indexes)};
-        const allowMultiple = ${JSON.stringify(!!input.multiple)} && el.multiple;
-        const optionLabel = (opt) => (opt.label || opt.textContent || "").trim();
-        const isMatch = (opt, i) => wantValues.includes(opt.value) || wantLabels.includes(optionLabel(opt)) || wantIndexes.includes(i);
-        const options = Array.from(el.options);
-        const selected = [];
-        if (allowMultiple) {
-          // Decide matches before mutating: a zero-match select_option must
-          // leave the existing selection untouched (and fall through to the
-          // not_found return below) rather than deselect every option and
-          // report an error without firing events. On a real match the
-          // non-matches are cleared, giving multi-select replace semantics.
-          const matched = options.map((opt, i) => isMatch(opt, i));
-          if (matched.some(Boolean)) {
-            options.forEach((opt, i) => {
-              opt.selected = matched[i];
-              if (matched[i]) selected.push({ value: opt.value, label: optionLabel(opt), index: i });
-            });
-          }
-        } else {
-          for (let i = 0; i < options.length; i++) {
-            if (isMatch(options[i], i)) {
-              el.value = options[i].value;
-              selected.push({ value: options[i].value, label: optionLabel(options[i]), index: i });
-              break;
-            }
-          }
-        }
-        if (selected.length === 0) return { ok: false, error: "no <option> matched the requested value/label/index", code: "not_found" };
-        fireEvents(el, ["input", "change"]);
-        return { ok: true, selected, multiple: el.multiple, count };
-      `;
-        const v = await runMutation(locator, body, input.session_id);
-        if (!v.ok)
-            throw new ToolError(v.code ?? "not_found", v.error ?? "select_option failed");
-        return { status: "selected", selected: v.selected, multiple: v.multiple, count: v.count };
-    });
-    registerToggle(server, "check");
-    registerToggle(server, "uncheck");
-    registerJsonTool(server, "fill", "Set an input, textarea, or contenteditable element (located by LocatorSpec) to exactly the given value, replacing any existing contents. Dispatches input + change. Use this (not type_text) when you need the field to end up equal to a specific value.", {
-        ...locatorShape,
-        value: z.string().describe("The exact value the field should contain afterwards (replaces existing contents)."),
-        session_id: z.string().optional().describe("Target a worker/iframe session; omit for the root page."),
-    }, async (input) => {
-        const locator = normalizeLocator(input);
-        const body = String.raw `
-        // fill writes free text, so restrict to text-like controls. Many other
-        // elements expose a "value" property whose meaning is not "the text the
-        // user sees" — <select> (the selected option), checkbox/radio (the
-        // submitted value, not the checked state), and button/submit/reset/file/
-        // image/range/color inputs — so editing them via fill would be surprising.
-        // Those get a structured wrong_element; use select_option / check / uncheck.
-        const NON_TEXT_INPUT_TYPES = ["button", "submit", "reset", "checkbox", "radio", "file", "image", "range", "color"];
-        const isTextInput = el instanceof HTMLInputElement && !NON_TEXT_INPUT_TYPES.includes((el.getAttribute("type") || "text").toLowerCase());
-        const fillable = el.isContentEditable || el instanceof HTMLTextAreaElement || isTextInput;
-        if (!fillable) {
-          const tag = el.tagName.toLowerCase();
-          const detail = el instanceof HTMLInputElement ? "<input type=" + (el.getAttribute("type") || "text") + ">" : "<" + tag + ">";
-          return { ok: false, error: "element is not fillable — fill targets a text <input>, <textarea>, or contenteditable, got " + detail, code: "wrong_element" };
-        }
-        const value = ${JSON.stringify(input.value)};
-        el.focus();
-        if (!("value" in el) && el.isContentEditable) { el.textContent = value; }
-        else { el.value = value; }
-        fireEvents(el, ["input", "change"]);
-        return { ok: true, tag: el.tagName.toLowerCase(), count };
-      `;
-        const v = await runMutation(locator, body, input.session_id);
-        if (!v.ok)
-            throw new ToolError(v.code ?? "not_found", v.error ?? "fill failed");
-        return { status: "filled", value_length: input.value.length, tag: v.tag, count: v.count };
-    });
-    registerJsonTool(server, "suggest_locator", "Given a starting element (by node_id or CSS selector), return ranked LocatorSpec candidates (role+name → text → test-id → label → placeholder → name → CSS fallback), each annotated with how many elements it currently matches (1 = unambiguous) and whether it resolves back to the target. Useful for validating/normalising a locator before driving with it.", {
-        node_id: z.number().int().positive().optional().describe("DOM nodeId from query_selector/locate."),
-        selector: z.string().optional().describe("CSS selector for the starting element (alternative to node_id)."),
-        session_id: z.string().optional().describe("Target a worker/iframe session; omit for the root page."),
-    }, async (input) => {
-        const s = requireSession();
-        if (input.node_id === undefined && !input.selector) {
-            throw new ToolError("missing_arg", "node_id or selector required");
-        }
-        let value;
-        if (input.selector && input.node_id === undefined) {
-            const expression = `(() => {
-          ${locatorHelpersScript()}${suggestDefScript()}
-          let el;
-          try {
-            el = document.querySelector(${JSON.stringify(input.selector)});
-          } catch (e) {
-            return { ok: false, error: "Invalid CSS selector " + ${JSON.stringify(input.selector)} + ": " + e.message, code: "invalid_selector" };
-          }
-          if (!el) return { ok: false, error: "no element matches selector", code: "not_found" };
-          return suggest(el);
-        })()`;
-            const res = await s.client.send("Runtime.evaluate", { expression, returnByValue: true }, input.session_id);
-            value = res.result.value;
-        }
-        else {
-            const resolved = await s.client.send("DOM.resolveNode", { nodeId: input.node_id }, input.session_id);
-            const objectId = resolved.object?.objectId;
-            if (!objectId)
-                throw new ToolError("not_found", `could not resolve node ${input.node_id}`);
-            const functionDeclaration = `function() {
-          ${locatorHelpersScript()}${suggestDefScript()}
-          return suggest(this);
-        }`;
-            const res = await s.client.send("Runtime.callFunctionOn", { objectId, functionDeclaration, returnByValue: true }, input.session_id);
-            value = res.result.value;
-        }
-        if (!value || !value.ok)
-            throw new ToolError(value?.code ?? "not_found", value?.error ?? "suggest_locator failed");
-        return { candidates: value.candidates, recommended: value.recommended };
-    });
-}
-function toArray(x) {
-    if (x === undefined)
-        return [];
-    return Array.isArray(x) ? x : [x];
-}
-/**
- * Resolve `locator` to a single element in the page and run `body` against it.
- * `body` is JS that runs with `el` (the resolved element), `count` (total
- * matches), and `fireEvents(el, types)` in scope, and must `return` a
- * `{ ok, ... }` object (with an optional `code` on failure).
- */
-async function runMutation(locator, body, sessionId) {
-    const s = requireSession();
-    const expression = `(() => {
-    const spec = ${JSON.stringify(locator)};
-    ${locatorHelpersScript()}${mutationHelpersScript()}
-    const resolved = resolveOne(spec);
-    if (!resolved.ok) return { ok: false, error: resolved.error, code: resolved.code ?? "not_found" };
-    const el = resolved.el;
-    const count = resolved.count;
-    ${body}
-  })()`;
-    const res = await s.client.send("Runtime.evaluate", { expression, returnByValue: true }, sessionId);
-    return res.result.value;
-}
-function registerToggle(server, name) {
-    const wantChecked = name === "check";
-    const description = name === "check"
-        ? "Ensure a checkbox or radio (located by LocatorSpec) is checked. Idempotent: returns status:\"already-checked\" with no events if it already is, else sets it and dispatches input + change."
-        : "Ensure a checkbox or radio (located by LocatorSpec) is unchecked. Idempotent: returns status:\"already-unchecked\" with no events if it already is, else clears it and dispatches input + change.";
-    registerJsonTool(server, name, description, { ...locatorShape, session_id: z.string().optional().describe("Target a worker/iframe session; omit for the root page.") }, async (input) => {
-        const locator = normalizeLocator(input);
-        const body = String.raw `
-        if (!(el instanceof HTMLInputElement) || (el.type !== "checkbox" && el.type !== "radio"))
-          return { ok: false, error: "element is not a checkbox or radio", code: "wrong_element" };
-        if (el.checked === ${JSON.stringify(wantChecked)}) return { ok: true, changed: false, checked: el.checked, count };
-        el.checked = ${JSON.stringify(wantChecked)};
-        fireEvents(el, ["input", "change"]);
-        return { ok: true, changed: true, checked: el.checked, count };
-      `;
-        const v = await runMutation(locator, body, input.session_id);
-        if (!v.ok)
-            throw new ToolError(v.code ?? "not_found", v.error ?? `${name} failed`);
-        const status = wantChecked
-            ? v.changed
-                ? "checked"
-                : "already-checked"
-            : v.changed
-                ? "unchecked"
-                : "already-unchecked";
-        return { status, checked: v.checked, count: v.count };
-    });
-}
-/**
- * In-page `suggest(el)` definition. Compose after `locatorHelpersScript()` (it
- * relies on `implicitRole`/`accessibleName`/`labelText`/`textOf`/`cssPath`/
- * `findElements`). Builds ranked candidates and re-runs `findElements` per
- * candidate so the reported match counts are exactly what `locate` would produce.
- */
-function suggestDefScript() {
-    return String.raw `
-    const suggest = (el) => {
-      const role = implicitRole(el);
-      const name = accessibleName(el);
-      const text = textOf(el);
-      const testId = el.getAttribute("data-testid") || el.getAttribute("data-test-id") || el.getAttribute("data-test");
-      const label = labelText(el);
-      const placeholder = el.getAttribute("placeholder");
-      const nameAttr = el.getAttribute("name");
-      const cands = [];
-      if (role && name) cands.push({ by: "role", role, name });
-      if (text && text.length <= 80) cands.push({ by: "text", text });
-      if (testId) cands.push({ by: "test_id", test_id: testId });
-      if (label) cands.push({ by: "label", label });
-      if (placeholder) cands.push({ by: "placeholder", placeholder });
-      if (nameAttr) cands.push({ by: "name", name: nameAttr });
-      cands.push({ by: "css", css: cssPath(el) });
-      // findElements role/text both scan "body *"; cache it once since we call per candidate.
-      const bodyEls = Array.from(document.querySelectorAll("body *"));
-      const resolveMatches = (locator) => {
-        if (locator.by === "text") return bodyEls.filter((e) => leafTextMatches(e, locator.text || locator.name, !!locator.exact));
-        if (locator.by === "role") return bodyEls.filter((e) => implicitRole(e) === lower(locator.role) && matchesText(accessibleName(e), locator.name, !!locator.exact));
-        const found = findElements(locator);
-        return found.ok ? found.elements : [];
-      };
-      const annotated = cands.map((locator) => {
-        const els = resolveMatches(locator);
-        return {
-          locator,
-          match_count: els.length,
-          unambiguous: els.length === 1,
-          resolves_to_target: els.indexOf(el) !== -1,
-        };
-      });
-      let recommended = annotated.findIndex((c) => c.unambiguous && c.resolves_to_target);
-      if (recommended < 0) recommended = annotated.findIndex((c) => c.resolves_to_target);
-      return { ok: true, candidates: annotated, recommended: recommended < 0 ? null : recommended };
-    };
-  `;
-}
-//# sourceMappingURL=forms.js.map

package/dist/tools/forms.js.map

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

package/dist/tools/inspect.d.ts

@@ -1,2 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerInspectTools(server: McpServer): void;

package/dist/tools/inspect.js

@@ -1,178 +0,0 @@
-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

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

package/dist/tools/nav.d.ts

@@ -1,2 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerNavTools(server: McpServer): void;