@saptools/cf-inspector 0.3.17 → 0.3.19

package/dist/cli.js

@@ -118,275 +118,6 @@ import { Command } from "commander";
 // src/cli/commands/attach.ts
 import process2 from "process";
 
-// src/pathMapper.ts
-init_types();
-var REGEX_PREFIX = "regex:";
-var REGEX_FLAGS_PATTERN = /^[dgimsuvy]*$/;
-var TS_JS_EXT_PATTERN = /\.(?:ts|js|mts|mjs|cts|cjs)$/i;
-function parseBreakpointSpec(input) {
-  const idx = input.lastIndexOf(":");
-  if (idx <= 0 || idx === input.length - 1) {
-    throw new CfInspectorError(
-      "INVALID_BREAKPOINT",
-      `Breakpoint must be in 'file:line' form, received: "${input}"`
-    );
-  }
-  const file = input.slice(0, idx).trim();
-  const lineRaw = input.slice(idx + 1).trim();
-  const line = Number.parseInt(lineRaw, 10);
-  if (!Number.isInteger(line) || line <= 0 || line.toString() !== lineRaw) {
-    throw new CfInspectorError(
-      "INVALID_BREAKPOINT",
-      `Breakpoint line must be a positive integer, received: "${lineRaw}"`
-    );
-  }
-  if (file.length === 0) {
-    throw new CfInspectorError(
-      "INVALID_BREAKPOINT",
-      `Breakpoint file path is empty in "${input}"`
-    );
-  }
-  return { file, line };
-}
-function parseRemoteRoot(value) {
-  const trimmed = value?.trim();
-  if (trimmed === void 0 || trimmed.length === 0) {
-    return { kind: "none" };
-  }
-  if (trimmed.startsWith(REGEX_PREFIX)) {
-    return toRegex(trimmed.slice(REGEX_PREFIX.length), "");
-  }
-  const slashRegex = parseSlashDelimited(trimmed);
-  if (slashRegex !== void 0) {
-    return toRegex(slashRegex.pattern, slashRegex.flags);
-  }
-  return { kind: "literal", value: stripTrailingSlash(trimmed) };
-}
-function toRegex(pattern, flags) {
-  try {
-    const regex = new RegExp(pattern, flags);
-    return { kind: "regex", pattern, flags, regex };
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    throw new CfInspectorError(
-      "INVALID_REMOTE_ROOT",
-      `Failed to compile remote-root regex "${pattern}" with flags "${flags}": ${message}`
-    );
-  }
-}
-function parseSlashDelimited(value) {
-  if (!value.startsWith("/")) {
-    return void 0;
-  }
-  const closing = findLastUnescapedSlash(value);
-  if (closing <= 0) {
-    return void 0;
-  }
-  const flags = value.slice(closing + 1);
-  if (flags.length === 0 || !REGEX_FLAGS_PATTERN.test(flags)) {
-    return void 0;
-  }
-  return { pattern: value.slice(1, closing), flags };
-}
-function findLastUnescapedSlash(value) {
-  for (let i = value.length - 1; i > 0; i--) {
-    if (value[i] === "/" && !isEscaped(value, i)) {
-      return i;
-    }
-  }
-  return -1;
-}
-function isEscaped(value, idx) {
-  let backslashes = 0;
-  for (let i = idx - 1; i >= 0; i--) {
-    if (value[i] === "\\") {
-      backslashes++;
-    } else {
-      break;
-    }
-  }
-  return backslashes % 2 === 1;
-}
-function stripTrailingSlash(value) {
-  if (value.length > 1 && value.endsWith("/")) {
-    return value.slice(0, -1);
-  }
-  return value;
-}
-function normalizeRegexRootPattern(pattern) {
-  const withoutStartAnchor = pattern.startsWith("^") ? pattern.slice(1) : pattern;
-  const withoutEndAnchor = withoutStartAnchor.endsWith("$") && !isEscaped(withoutStartAnchor, withoutStartAnchor.length - 1) ? withoutStartAnchor.slice(0, -1) : withoutStartAnchor;
-  return stripTrailingSlash(withoutEndAnchor);
-}
-function buildFileUrlRegex(rootPattern, tail) {
-  const separator = rootPattern.endsWith("/") ? "" : "/";
-  return `^file://${rootPattern}${separator}${tail}$`;
-}
-function escapeRegExp(value) {
-  return value.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
-}
-function normalizeRelative(file) {
-  return file.replaceAll(/^[./\\]+/g, "").replaceAll("\\", "/");
-}
-function dropExtension(file) {
-  const match = TS_JS_EXT_PATTERN.exec(file);
-  if (!match) {
-    return { stem: file, matchedExt: false };
-  }
-  return { stem: file.slice(0, match.index), matchedExt: true };
-}
-var EXT_GROUP = String.raw`\.(?:ts|js|mts|mjs|cts|cjs)`;
-var OPTIONAL_EXT_GROUP = String.raw`(?:\.(?:ts|js|mts|mjs|cts|cjs))?`;
-function buildBreakpointUrlRegex(input) {
-  const normalized = normalizeRelative(input.file);
-  const { stem, matchedExt } = dropExtension(normalized);
-  const escapedStem = escapeRegExp(stem);
-  const tail = matchedExt ? `${escapedStem}${EXT_GROUP}` : `${escapedStem}${OPTIONAL_EXT_GROUP}`;
-  switch (input.remoteRoot.kind) {
-    case "none": {
-      return `(?:^|/)${tail}$`;
-    }
-    case "literal": {
-      const escapedRoot = escapeRegExp(input.remoteRoot.value);
-      return buildFileUrlRegex(escapedRoot, tail);
-    }
-    case "regex": {
-      const rootPattern = normalizeRegexRootPattern(input.remoteRoot.pattern);
-      return buildFileUrlRegex(rootPattern, tail);
-    }
-  }
-}
-
-// src/inspector/breakpoints.ts
-init_types();
-
-// src/inspector/conversions.ts
-function asString(value, fallback = "") {
-  return typeof value === "string" ? value : fallback;
-}
-function asNumber(value, fallback = 0) {
-  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
-}
-function toResolvedLocations(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.flatMap((entry) => {
-    if (typeof entry !== "object" || entry === null) {
-      return [];
-    }
-    const candidate = entry;
-    const scriptId = asString(candidate.scriptId);
-    if (scriptId.length === 0) {
-      return [];
-    }
-    const url = typeof candidate.url === "string" ? candidate.url : void 0;
-    const lineNumber = asNumber(candidate.lineNumber);
-    const result = url === void 0 ? { scriptId, lineNumber, columnNumber: asNumber(candidate.columnNumber) } : { scriptId, url, lineNumber, columnNumber: asNumber(candidate.columnNumber) };
-    return [result];
-  });
-}
-function toScopeChain(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.flatMap((entry) => {
-    if (typeof entry !== "object" || entry === null) {
-      return [];
-    }
-    const candidate = entry;
-    const type = asString(candidate.type);
-    if (type.length === 0) {
-      return [];
-    }
-    const objectId = typeof candidate.object?.objectId === "string" ? candidate.object.objectId : void 0;
-    const name = typeof candidate.name === "string" ? candidate.name : void 0;
-    const base = name === void 0 ? { type } : { type, name };
-    return [objectId === void 0 ? base : { ...base, objectId }];
-  });
-}
-function toCallFrames(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.flatMap((entry) => {
-    if (typeof entry !== "object" || entry === null) {
-      return [];
-    }
-    const candidate = entry;
-    const callFrameId = asString(candidate.callFrameId);
-    if (callFrameId.length === 0) {
-      return [];
-    }
-    const url = typeof candidate.url === "string" ? candidate.url : void 0;
-    const base = {
-      callFrameId,
-      functionName: asString(candidate.functionName),
-      lineNumber: asNumber(candidate.location?.lineNumber),
-      columnNumber: asNumber(candidate.location?.columnNumber),
-      scopeChain: toScopeChain(candidate.scopeChain)
-    };
-    return [url === void 0 ? base : { ...base, url }];
-  });
-}
-function toPauseEvent(params, receivedAtMs) {
-  return {
-    reason: asString(params.reason),
-    hitBreakpoints: Array.isArray(params.hitBreakpoints) ? params.hitBreakpoints.filter((id) => typeof id === "string") : [],
-    callFrames: toCallFrames(params.callFrames),
-    receivedAtMs
-  };
-}
-function topFrameLocation(pause) {
-  const top = pause.callFrames[0];
-  if (top === void 0) {
-    return "(no call frame)";
-  }
-  const url = top.url !== void 0 && top.url.length > 0 ? top.url : "(unknown)";
-  return `${url}:${(top.lineNumber + 1).toString()}:${(top.columnNumber + 1).toString()}`;
-}
-function pauseDetail(pause) {
-  return JSON.stringify({
-    reason: pause.reason,
-    hitBreakpoints: pause.hitBreakpoints,
-    topFrame: topFrameLocation(pause)
-  });
-}
-
-// src/inspector/breakpoints.ts
-async function setBreakpoint(session, input) {
-  const remoteRoot = input.remoteRoot ?? { kind: "none" };
-  const urlRegex = buildBreakpointUrlRegex({ file: input.file, remoteRoot });
-  const params = {
-    lineNumber: input.line - 1,
-    urlRegex
-  };
-  if (input.condition !== void 0 && input.condition.length > 0) {
-    params["condition"] = input.condition;
-  }
-  const result = await session.client.send(
-    "Debugger.setBreakpointByUrl",
-    params
-  );
-  const breakpointId = asString(result.breakpointId);
-  if (breakpointId.length === 0) {
-    throw new CfInspectorError(
-      "CDP_REQUEST_FAILED",
-      `setBreakpointByUrl did not return a breakpointId for ${input.file}:${input.line.toString()}`
-    );
-  }
-  return {
-    breakpointId,
-    file: input.file,
-    line: input.line,
-    urlRegex,
-    resolvedLocations: toResolvedLocations(result.locations)
-  };
-}
-async function removeBreakpoint(session, breakpointId) {
-  await session.client.send("Debugger.removeBreakpoint", { breakpointId });
-}
-
 // src/inspector/discovery.ts
 init_types();
 import { request } from "http";
@@ -505,164 +236,93 @@ async function fetchInspectorVersion(host, port, timeoutMs) {
   return { browser, protocolVersion };
 }
 
-// src/inspector/pause.ts
-init_types();
-import { performance } from "perf_hooks";
-function pauseMatches(pause, breakpointIds) {
-  if (breakpointIds === void 0 || breakpointIds.length === 0) {
-    return true;
-  }
-  return pause.hitBreakpoints.some((id) => breakpointIds.includes(id));
-}
-function remainingUntil(deadlineMs) {
-  return Math.max(0, deadlineMs - performance.now());
-}
-function hasResumedSincePause(session, pause) {
-  const pauseAt = pause.receivedAtMs;
-  const resumedAt = session.debuggerState.lastResumedAtMs;
-  return pauseAt !== void 0 && resumedAt !== void 0 && resumedAt >= pauseAt;
-}
-function throwBreakpointTimeout(timeoutMs) {
-  throw new CfInspectorError(
-    "BREAKPOINT_NOT_HIT",
-    `Timed out waiting for matching Debugger.paused after ${timeoutMs.toString()}ms`
-  );
-}
-function throwUnrelatedPauseTimeout(pause, timeoutMs) {
-  throw new CfInspectorError(
-    "UNRELATED_PAUSE_TIMEOUT",
-    `Target stayed paused by another debugger event before this command's breakpoint could hit within ${timeoutMs.toString()}ms`,
-    pauseDetail(pause)
-  );
+// src/cli/output.ts
+import process from "process";
+function writeJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
 }
-async function waitForUnmatchedPauseToResume(session, pause, deadlineMs, timeoutMs) {
-  if (hasResumedSincePause(session, pause)) {
-    return;
-  }
-  const remainingMs = remainingUntil(deadlineMs);
-  if (remainingMs <= 0) {
-    throwUnrelatedPauseTimeout(pause, timeoutMs);
+function writeHumanSnapshot(snapshot) {
+  const pausedDuration = snapshot.pausedDurationMs === null ? "unknown" : `${snapshot.pausedDurationMs.toFixed(1)}ms`;
+  const lines = [];
+  lines.push(
+    `Snapshot @ ${snapshot.capturedAt}`,
+    `  reason:  ${snapshot.reason}`,
+    `  paused:  ${pausedDuration}`
+  );
+  if (snapshot.topFrame) {
+    appendFrameLines(lines, snapshot);
   }
-  try {
-    await session.client.waitFor("Debugger.resumed", { timeoutMs: remainingMs });
-    session.debuggerState.lastResumedAtMs = performance.now();
-  } catch (err) {
-    if (err instanceof CfInspectorError && err.code === "BREAKPOINT_NOT_HIT") {
-      throwUnrelatedPauseTimeout(pause, timeoutMs);
+  if (snapshot.captures.length > 0) {
+    lines.push("  captures:");
+    for (const capture of snapshot.captures) {
+      const detail = capture.error ?? capture.value ?? "undefined";
+      lines.push(`    ${capture.expression} = ${detail}`);
     }
-    throw err;
   }
+  process.stdout.write(`${lines.join("\n")}
+`);
 }
-async function handleUnmatchedPause(session, pause, options, deadlineMs) {
-  if (options.unmatchedPausePolicy === "fail") {
-    throw new CfInspectorError(
-      "UNRELATED_PAUSE",
-      "Target paused before this command's breakpoint was reached",
-      pauseDetail(pause)
-    );
+function appendFrameLines(lines, snapshot) {
+  const frame = snapshot.topFrame;
+  if (frame === void 0) {
+    return;
   }
-  if (hasResumedSincePause(session, pause)) {
+  const fnName = frame.functionName.length === 0 ? "(anonymous)" : frame.functionName;
+  const sourceUrl = frame.url !== void 0 && frame.url.length > 0 ? frame.url : "(unknown)";
+  lines.push(
+    `  frame:   ${fnName} ${sourceUrl}:${frame.line.toString()}:${frame.column.toString()}`
+  );
+  if (frame.scopes === void 0) {
     return;
   }
-  options.onUnmatchedPause?.(pause);
-  await waitForUnmatchedPauseToResume(session, pause, deadlineMs, options.timeoutMs);
-}
-async function waitForPause(session, options) {
-  const deadlineMs = performance.now() + options.timeoutMs;
-  const buffer = session.pauseBuffer;
-  while (buffer.length > 0 || remainingUntil(deadlineMs) > 0) {
-    while (buffer.length > 0) {
-      const buffered = buffer.shift();
-      if (buffered === void 0) {
-        continue;
-      }
-      if (pauseMatches(buffered, options.breakpointIds)) {
-        return buffered;
-      }
-      await handleUnmatchedPause(session, buffered, options, deadlineMs);
-    }
-    const pause = await waitForLivePause(session, options, deadlineMs);
-    if (pauseMatches(pause, options.breakpointIds)) {
-      return pause;
+  for (const scope of frame.scopes) {
+    lines.push(`  scope ${scope.type} (${scope.variables.length.toString()} vars):`);
+    for (const variable of scope.variables) {
+      lines.push(`    ${variable.name} = ${variable.value}`);
     }
-    await handleUnmatchedPause(session, pause, options, deadlineMs);
   }
-  throwBreakpointTimeout(options.timeoutMs);
 }
-async function waitForLivePause(session, options, deadlineMs) {
-  const remainingMs = remainingUntil(deadlineMs);
-  if (remainingMs <= 0) {
-    throwBreakpointTimeout(options.timeoutMs);
-  }
-  session.pauseWaitGate.active = true;
-  let receivedAtMs;
-  let params;
-  try {
-    params = await session.client.waitFor("Debugger.paused", {
-      timeoutMs: remainingMs,
-      predicate: () => {
-        receivedAtMs = performance.now();
-        return true;
-      }
-    });
-  } finally {
-    session.pauseWaitGate.active = false;
+function writeLogEvent(event, json) {
+  if (json) {
+    process.stdout.write(`${JSON.stringify(event)}
+`);
+    return;
   }
-  return toPauseEvent(params, receivedAtMs ?? performance.now());
-}
-
-// src/inspector/runtime.ts
-init_types();
-async function resume(session) {
-  await session.client.send("Debugger.resume");
-}
-async function evaluateOnFrame(session, callFrameId, expression) {
-  return await session.client.send("Debugger.evaluateOnCallFrame", {
-    callFrameId,
-    expression,
-    returnByValue: false,
-    generatePreview: true,
-    silent: true
-  });
-}
-async function evaluateGlobal(session, expression) {
-  return await session.client.send("Runtime.evaluate", {
-    expression,
-    returnByValue: false,
-    generatePreview: true,
-    silent: true
-  });
-}
-function listScripts(session) {
-  return [...session.scripts.values()];
-}
-async function validateExpression(session, expression) {
-  const result = await session.client.send("Runtime.compileScript", {
-    expression,
-    sourceURL: "<cf-inspector-validate>",
-    persistScript: false
-  });
-  if (result.exceptionDetails === void 0) {
+  if (event.error !== void 0) {
+    process.stdout.write(`[${event.ts}] ${event.at} !err ${event.error}
+`);
     return;
   }
-  const description = typeof result.exceptionDetails.exception?.description === "string" ? result.exceptionDetails.exception.description : typeof result.exceptionDetails.text === "string" ? result.exceptionDetails.text : "expression failed to compile";
-  throw new CfInspectorError("INVALID_EXPRESSION", description);
+  process.stdout.write(`[${event.ts}] ${event.at} ${event.value ?? ""}
+`);
 }
-async function getProperties(session, objectId) {
-  const result = await session.client.send("Runtime.getProperties", {
-    objectId,
-    ownProperties: true,
-    accessorPropertiesOnly: false,
-    generatePreview: true
-  });
-  if (!Array.isArray(result.result)) {
-    return [];
-  }
-  return result.result;
+
+// src/cf/tunnel.ts
+import { startDebugger } from "@saptools/cf-debugger";
+async function openCfTunnel(target) {
+  const opts = {
+    region: target.region,
+    org: target.org,
+    space: target.space,
+    app: target.app,
+    ...target.tunnelReadyTimeoutMs === void 0 ? {} : { tunnelReadyTimeoutMs: target.tunnelReadyTimeoutMs },
+    ...target.preferredPort === void 0 ? {} : { preferredPort: target.preferredPort },
+    ...target.verbose === void 0 ? {} : { verbose: target.verbose },
+    ...target.signal === void 0 ? {} : { signal: target.signal }
+  };
+  const handle = await startDebugger(opts);
+  return {
+    localPort: handle.session.localPort,
+    handle,
+    dispose: async () => {
+      await handle.dispose();
+    }
+  };
 }
 
 // src/inspector/session.ts
-import { performance as performance2 } from "perf_hooks";
+import { performance } from "perf_hooks";
 
 // src/cdp/client.ts
 init_types();
@@ -888,7 +548,116 @@ var CdpClient = class _CdpClient {
 };
 
 // src/inspector/session.ts
-init_types();
+init_types();
+
+// src/inspector/conversions.ts
+function asString(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNumber(value, fallback = 0) {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function nonEmptyString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function toResolvedLocations(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.flatMap((entry) => {
+    if (typeof entry !== "object" || entry === null) {
+      return [];
+    }
+    const candidate = entry;
+    const scriptId = asString(candidate.scriptId);
+    if (scriptId.length === 0) {
+      return [];
+    }
+    const url = typeof candidate.url === "string" ? candidate.url : void 0;
+    const lineNumber = asNumber(candidate.lineNumber);
+    const result = url === void 0 ? { scriptId, lineNumber, columnNumber: asNumber(candidate.columnNumber) } : { scriptId, url, lineNumber, columnNumber: asNumber(candidate.columnNumber) };
+    return [result];
+  });
+}
+function toScopeChain(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.flatMap((entry) => {
+    if (typeof entry !== "object" || entry === null) {
+      return [];
+    }
+    const candidate = entry;
+    const type = asString(candidate.type);
+    if (type.length === 0) {
+      return [];
+    }
+    const objectId = typeof candidate.object?.objectId === "string" ? candidate.object.objectId : void 0;
+    const name = typeof candidate.name === "string" ? candidate.name : void 0;
+    const base = name === void 0 ? { type } : { type, name };
+    return [objectId === void 0 ? base : { ...base, objectId }];
+  });
+}
+function resolveCallFrameUrl(frame, scripts) {
+  const direct = nonEmptyString(frame.url);
+  if (direct !== void 0) {
+    return direct;
+  }
+  const scriptId = nonEmptyString(frame.location?.scriptId);
+  if (scriptId === void 0) {
+    return void 0;
+  }
+  return nonEmptyString(scripts?.get(scriptId)?.url);
+}
+function toCallFrames(value, scripts) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.flatMap((entry) => {
+    if (typeof entry !== "object" || entry === null) {
+      return [];
+    }
+    const candidate = entry;
+    const callFrameId = asString(candidate.callFrameId);
+    if (callFrameId.length === 0) {
+      return [];
+    }
+    const url = resolveCallFrameUrl(candidate, scripts);
+    const base = {
+      callFrameId,
+      functionName: asString(candidate.functionName),
+      lineNumber: asNumber(candidate.location?.lineNumber),
+      columnNumber: asNumber(candidate.location?.columnNumber),
+      scopeChain: toScopeChain(candidate.scopeChain)
+    };
+    return [url === void 0 ? base : { ...base, url }];
+  });
+}
+function toPauseEvent(params, receivedAtMs, scripts) {
+  return {
+    reason: asString(params.reason),
+    hitBreakpoints: Array.isArray(params.hitBreakpoints) ? params.hitBreakpoints.filter((id) => typeof id === "string") : [],
+    callFrames: toCallFrames(params.callFrames, scripts),
+    receivedAtMs
+  };
+}
+function topFrameLocation(pause) {
+  const top = pause.callFrames[0];
+  if (top === void 0) {
+    return "(no call frame)";
+  }
+  const url = top.url !== void 0 && top.url.length > 0 ? top.url : "(unknown)";
+  return `${url}:${(top.lineNumber + 1).toString()}:${(top.columnNumber + 1).toString()}`;
+}
+function pauseDetail(pause) {
+  return JSON.stringify({
+    reason: pause.reason,
+    hitBreakpoints: pause.hitBreakpoints,
+    topFrame: topFrameLocation(pause)
+  });
+}
+
+// src/inspector/session.ts
 var DEFAULT_CONNECT_TIMEOUT_MS = 5e3;
 var DEFAULT_HOST = "127.0.0.1";
 var PAUSE_BUFFER_LIMIT = 32;
@@ -922,14 +691,14 @@ async function connectInspector(options) {
       return;
     }
     const params = raw;
-    const event = toPauseEvent(params, performance2.now());
+    const event = toPauseEvent(params, performance.now(), scripts);
     if (pauseBuffer.length >= PAUSE_BUFFER_LIMIT) {
       pauseBuffer.shift();
     }
     pauseBuffer.push(event);
   });
   client.on("Debugger.resumed", () => {
-    debuggerState.lastResumedAtMs = performance2.now();
+    debuggerState.lastResumedAtMs = performance.now();
   });
   await client.send("Runtime.enable");
   await client.send("Debugger.enable");
@@ -950,91 +719,6 @@ async function connectInspector(options) {
   };
 }
 
-// src/cli/output.ts
-import process from "process";
-function writeJson(value) {
-  process.stdout.write(`${JSON.stringify(value, null, 2)}
-`);
-}
-function writeHumanSnapshot(snapshot) {
-  const pausedDuration = snapshot.pausedDurationMs === null ? "unknown" : `${snapshot.pausedDurationMs.toFixed(1)}ms`;
-  const lines = [];
-  lines.push(
-    `Snapshot @ ${snapshot.capturedAt}`,
-    `  reason:  ${snapshot.reason}`,
-    `  paused:  ${pausedDuration}`
-  );
-  if (snapshot.topFrame) {
-    appendFrameLines(lines, snapshot);
-  }
-  if (snapshot.captures.length > 0) {
-    lines.push("  captures:");
-    for (const capture of snapshot.captures) {
-      const detail = capture.error ?? capture.value ?? "undefined";
-      lines.push(`    ${capture.expression} = ${detail}`);
-    }
-  }
-  process.stdout.write(`${lines.join("\n")}
-`);
-}
-function appendFrameLines(lines, snapshot) {
-  const frame = snapshot.topFrame;
-  if (frame === void 0) {
-    return;
-  }
-  const fnName = frame.functionName.length === 0 ? "(anonymous)" : frame.functionName;
-  const sourceUrl = frame.url !== void 0 && frame.url.length > 0 ? frame.url : "(unknown)";
-  lines.push(
-    `  frame:   ${fnName} ${sourceUrl}:${frame.line.toString()}:${frame.column.toString()}`
-  );
-  if (frame.scopes === void 0) {
-    return;
-  }
-  for (const scope of frame.scopes) {
-    lines.push(`  scope ${scope.type} (${scope.variables.length.toString()} vars):`);
-    for (const variable of scope.variables) {
-      lines.push(`    ${variable.name} = ${variable.value}`);
-    }
-  }
-}
-function writeLogEvent(event, json) {
-  if (json) {
-    process.stdout.write(`${JSON.stringify(event)}
-`);
-    return;
-  }
-  if (event.error !== void 0) {
-    process.stdout.write(`[${event.ts}] ${event.at} !err ${event.error}
-`);
-    return;
-  }
-  process.stdout.write(`[${event.ts}] ${event.at} ${event.value ?? ""}
-`);
-}
-
-// src/cf/tunnel.ts
-import { startDebugger } from "@saptools/cf-debugger";
-async function openCfTunnel(target) {
-  const opts = {
-    region: target.region,
-    org: target.org,
-    space: target.space,
-    app: target.app,
-    ...target.tunnelReadyTimeoutMs === void 0 ? {} : { tunnelReadyTimeoutMs: target.tunnelReadyTimeoutMs },
-    ...target.preferredPort === void 0 ? {} : { preferredPort: target.preferredPort },
-    ...target.verbose === void 0 ? {} : { verbose: target.verbose },
-    ...target.signal === void 0 ? {} : { signal: target.signal }
-  };
-  const handle = await startDebugger(opts);
-  return {
-    localPort: handle.session.localPort,
-    handle,
-    dispose: async () => {
-      await handle.dispose();
-    }
-  };
-}
-
 // src/cli/target.ts
 init_types();
 
@@ -1134,67 +818,293 @@ async function handleAttach(opts) {
     await tunnel.dispose();
   }
 }
-
-// src/cli/commands/eval.ts
-import process3 from "process";
-async function handleEval(opts) {
-  const target = resolveTarget(opts);
-  const result = await withSession(target, async (session) => {
-    return await evaluateGlobal(session, opts.expr);
-  });
-  if (opts.json) {
-    writeJson(result);
-    if (result.exceptionDetails !== void 0) {
-      process3.exitCode = 1;
+
+// src/cli/commands/eval.ts
+import process3 from "process";
+
+// src/inspector/runtime.ts
+init_types();
+async function resume(session) {
+  await session.client.send("Debugger.resume");
+}
+async function evaluateOnFrame(session, callFrameId, expression) {
+  return await session.client.send("Debugger.evaluateOnCallFrame", {
+    callFrameId,
+    expression,
+    returnByValue: false,
+    generatePreview: true,
+    silent: true
+  });
+}
+async function evaluateGlobal(session, expression) {
+  return await session.client.send("Runtime.evaluate", {
+    expression,
+    returnByValue: false,
+    generatePreview: true,
+    silent: true
+  });
+}
+function listScripts(session) {
+  return [...session.scripts.values()];
+}
+async function validateExpression(session, expression) {
+  const result = await session.client.send("Runtime.compileScript", {
+    expression,
+    sourceURL: "<cf-inspector-validate>",
+    persistScript: false
+  });
+  if (result.exceptionDetails === void 0) {
+    return;
+  }
+  const description = typeof result.exceptionDetails.exception?.description === "string" ? result.exceptionDetails.exception.description : typeof result.exceptionDetails.text === "string" ? result.exceptionDetails.text : "expression failed to compile";
+  throw new CfInspectorError("INVALID_EXPRESSION", description);
+}
+async function getProperties(session, objectId) {
+  const result = await session.client.send("Runtime.getProperties", {
+    objectId,
+    ownProperties: true,
+    accessorPropertiesOnly: false,
+    generatePreview: true
+  });
+  if (!Array.isArray(result.result)) {
+    return [];
+  }
+  return result.result;
+}
+
+// src/cli/commands/eval.ts
+async function handleEval(opts) {
+  const target = resolveTarget(opts);
+  const result = await withSession(target, async (session) => {
+    return await evaluateGlobal(session, opts.expr);
+  });
+  if (opts.json) {
+    writeJson(result);
+    if (result.exceptionDetails !== void 0) {
+      process3.exitCode = 1;
+    }
+    return;
+  }
+  writeHumanEvalResult(result);
+}
+function writeHumanEvalResult(result) {
+  if (result.exceptionDetails !== void 0) {
+    const detail = typeof result.exceptionDetails.exception?.description === "string" ? result.exceptionDetails.exception.description : typeof result.exceptionDetails.text === "string" ? result.exceptionDetails.text : "evaluation failed";
+    process3.stderr.write(`${detail}
+`);
+    process3.exitCode = 1;
+    return;
+  }
+  const inner = result.result;
+  if (inner === void 0) {
+    process3.stdout.write("\n");
+    return;
+  }
+  if (typeof inner.value === "string") {
+    process3.stdout.write(`${inner.value}
+`);
+    return;
+  }
+  if (typeof inner.description === "string") {
+    process3.stdout.write(`${inner.description}
+`);
+    return;
+  }
+  process3.stdout.write(`${JSON.stringify(inner.value)}
+`);
+}
+
+// src/cli/commands/listScripts.ts
+import process4 from "process";
+async function handleListScripts(opts) {
+  const target = resolveTarget(opts);
+  const scripts = await withSession(target, (session) => Promise.resolve(listScripts(session)));
+  if (opts.json) {
+    writeJson(scripts);
+    return;
+  }
+  for (const script of scripts) {
+    process4.stdout.write(`${script.scriptId}	${script.url}
+`);
+  }
+}
+
+// src/cli/commands/log.ts
+import process6 from "process";
+
+// src/pathMapper.ts
+init_types();
+var REGEX_PREFIX = "regex:";
+var REGEX_FLAGS_PATTERN = /^[dgimsuvy]*$/;
+var TS_JS_EXT_PATTERN = /\.(?:ts|js|mts|mjs|cts|cjs)$/i;
+function parseBreakpointSpec(input) {
+  const idx = input.lastIndexOf(":");
+  if (idx <= 0 || idx === input.length - 1) {
+    throw new CfInspectorError(
+      "INVALID_BREAKPOINT",
+      `Breakpoint must be in 'file:line' form, received: "${input}"`
+    );
+  }
+  const file = input.slice(0, idx).trim();
+  const lineRaw = input.slice(idx + 1).trim();
+  const line = Number.parseInt(lineRaw, 10);
+  if (!Number.isInteger(line) || line <= 0 || line.toString() !== lineRaw) {
+    throw new CfInspectorError(
+      "INVALID_BREAKPOINT",
+      `Breakpoint line must be a positive integer, received: "${lineRaw}"`
+    );
+  }
+  if (file.length === 0) {
+    throw new CfInspectorError(
+      "INVALID_BREAKPOINT",
+      `Breakpoint file path is empty in "${input}"`
+    );
+  }
+  return { file, line };
+}
+function parseRemoteRoot(value) {
+  const trimmed = value?.trim();
+  if (trimmed === void 0 || trimmed.length === 0) {
+    return { kind: "none" };
+  }
+  if (trimmed.startsWith(REGEX_PREFIX)) {
+    return toRegex(trimmed.slice(REGEX_PREFIX.length), "");
+  }
+  const slashRegex = parseSlashDelimited(trimmed);
+  if (slashRegex !== void 0) {
+    return toRegex(slashRegex.pattern, slashRegex.flags);
+  }
+  return { kind: "literal", value: stripTrailingSlash(trimmed) };
+}
+function toRegex(pattern, flags) {
+  try {
+    const regex = new RegExp(pattern, flags);
+    return { kind: "regex", pattern, flags, regex };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new CfInspectorError(
+      "INVALID_REMOTE_ROOT",
+      `Failed to compile remote-root regex "${pattern}" with flags "${flags}": ${message}`
+    );
+  }
+}
+function parseSlashDelimited(value) {
+  if (!value.startsWith("/")) {
+    return void 0;
+  }
+  const closing = findLastUnescapedSlash(value);
+  if (closing <= 0) {
+    return void 0;
+  }
+  const flags = value.slice(closing + 1);
+  if (flags.length === 0 || !REGEX_FLAGS_PATTERN.test(flags)) {
+    return void 0;
+  }
+  return { pattern: value.slice(1, closing), flags };
+}
+function findLastUnescapedSlash(value) {
+  for (let i = value.length - 1; i > 0; i--) {
+    if (value[i] === "/" && !isEscaped(value, i)) {
+      return i;
     }
-    return;
   }
-  writeHumanEvalResult(result);
+  return -1;
 }
-function writeHumanEvalResult(result) {
-  if (result.exceptionDetails !== void 0) {
-    const detail = typeof result.exceptionDetails.exception?.description === "string" ? result.exceptionDetails.exception.description : typeof result.exceptionDetails.text === "string" ? result.exceptionDetails.text : "evaluation failed";
-    process3.stderr.write(`${detail}
-`);
-    process3.exitCode = 1;
-    return;
+function isEscaped(value, idx) {
+  let backslashes = 0;
+  for (let i = idx - 1; i >= 0; i--) {
+    if (value[i] === "\\") {
+      backslashes++;
+    } else {
+      break;
+    }
   }
-  const inner = result.result;
-  if (inner === void 0) {
-    process3.stdout.write("\n");
-    return;
+  return backslashes % 2 === 1;
+}
+function stripTrailingSlash(value) {
+  if (value.length > 1 && value.endsWith("/")) {
+    return value.slice(0, -1);
   }
-  if (typeof inner.value === "string") {
-    process3.stdout.write(`${inner.value}
-`);
-    return;
+  return value;
+}
+function normalizeRegexRootPattern(pattern) {
+  const withoutStartAnchor = pattern.startsWith("^") ? pattern.slice(1) : pattern;
+  const withoutEndAnchor = withoutStartAnchor.endsWith("$") && !isEscaped(withoutStartAnchor, withoutStartAnchor.length - 1) ? withoutStartAnchor.slice(0, -1) : withoutStartAnchor;
+  return stripTrailingSlash(withoutEndAnchor);
+}
+function buildFileUrlRegex(rootPattern, tail) {
+  const separator = rootPattern.endsWith("/") ? "" : "/";
+  return `^file://${rootPattern}${separator}${tail}$`;
+}
+function escapeRegExp(value) {
+  return value.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
+}
+function normalizeRelative(file) {
+  return file.replaceAll(/^[./\\]+/g, "").replaceAll("\\", "/");
+}
+function dropExtension(file) {
+  const match = TS_JS_EXT_PATTERN.exec(file);
+  if (!match) {
+    return { stem: file, matchedExt: false };
   }
-  if (typeof inner.description === "string") {
-    process3.stdout.write(`${inner.description}
-`);
-    return;
+  return { stem: file.slice(0, match.index), matchedExt: true };
+}
+var EXT_GROUP = String.raw`\.(?:ts|js|mts|mjs|cts|cjs)`;
+var OPTIONAL_EXT_GROUP = String.raw`(?:\.(?:ts|js|mts|mjs|cts|cjs))?`;
+function buildBreakpointUrlRegex(input) {
+  const normalized = normalizeRelative(input.file);
+  const { stem, matchedExt } = dropExtension(normalized);
+  const escapedStem = escapeRegExp(stem);
+  const tail = matchedExt ? `${escapedStem}${EXT_GROUP}` : `${escapedStem}${OPTIONAL_EXT_GROUP}`;
+  switch (input.remoteRoot.kind) {
+    case "none": {
+      return `(?:^|/)${tail}$`;
+    }
+    case "literal": {
+      const escapedRoot = escapeRegExp(input.remoteRoot.value);
+      return buildFileUrlRegex(escapedRoot, tail);
+    }
+    case "regex": {
+      const rootPattern = normalizeRegexRootPattern(input.remoteRoot.pattern);
+      return buildFileUrlRegex(rootPattern, tail);
+    }
   }
-  process3.stdout.write(`${JSON.stringify(inner.value)}
-`);
 }
 
-// src/cli/commands/listScripts.ts
-import process4 from "process";
-async function handleListScripts(opts) {
-  const target = resolveTarget(opts);
-  const scripts = await withSession(target, (session) => Promise.resolve(listScripts(session)));
-  if (opts.json) {
-    writeJson(scripts);
-    return;
+// src/inspector/breakpoints.ts
+init_types();
+async function setBreakpoint(session, input) {
+  const remoteRoot = input.remoteRoot ?? { kind: "none" };
+  const urlRegex = buildBreakpointUrlRegex({ file: input.file, remoteRoot });
+  const params = {
+    lineNumber: input.line - 1,
+    urlRegex
+  };
+  if (input.condition !== void 0 && input.condition.length > 0) {
+    params["condition"] = input.condition;
   }
-  for (const script of scripts) {
-    process4.stdout.write(`${script.scriptId}	${script.url}
-`);
+  const result = await session.client.send(
+    "Debugger.setBreakpointByUrl",
+    params
+  );
+  const breakpointId = asString(result.breakpointId);
+  if (breakpointId.length === 0) {
+    throw new CfInspectorError(
+      "CDP_REQUEST_FAILED",
+      `setBreakpointByUrl did not return a breakpointId for ${input.file}:${input.line.toString()}`
+    );
   }
+  return {
+    breakpointId,
+    file: input.file,
+    line: input.line,
+    urlRegex,
+    resolvedLocations: toResolvedLocations(result.locations)
+  };
+}
+async function removeBreakpoint(session, breakpointId) {
+  await session.client.send("Debugger.removeBreakpoint", { breakpointId });
 }
-
-// src/cli/commands/log.ts
-import process6 from "process";
 
 // src/logpoint/condition.ts
 import { randomBytes } from "crypto";
@@ -1447,6 +1357,112 @@ function writeLogSummary(stoppedReason, emitted, json) {
 import { performance as performance3 } from "perf_hooks";
 import process7 from "process";
 
+// src/inspector/pause.ts
+init_types();
+import { performance as performance2 } from "perf_hooks";
+function pauseMatches(pause, breakpointIds) {
+  if (breakpointIds === void 0 || breakpointIds.length === 0) {
+    return true;
+  }
+  return pause.hitBreakpoints.some((id) => breakpointIds.includes(id));
+}
+function remainingUntil(deadlineMs) {
+  return Math.max(0, deadlineMs - performance2.now());
+}
+function hasResumedSincePause(session, pause) {
+  const pauseAt = pause.receivedAtMs;
+  const resumedAt = session.debuggerState.lastResumedAtMs;
+  return pauseAt !== void 0 && resumedAt !== void 0 && resumedAt >= pauseAt;
+}
+function throwBreakpointTimeout(timeoutMs) {
+  throw new CfInspectorError(
+    "BREAKPOINT_NOT_HIT",
+    `Timed out waiting for matching Debugger.paused after ${timeoutMs.toString()}ms`
+  );
+}
+function throwUnrelatedPauseTimeout(pause, timeoutMs) {
+  throw new CfInspectorError(
+    "UNRELATED_PAUSE_TIMEOUT",
+    `Target stayed paused by another debugger event before this command's breakpoint could hit within ${timeoutMs.toString()}ms`,
+    pauseDetail(pause)
+  );
+}
+async function waitForUnmatchedPauseToResume(session, pause, deadlineMs, timeoutMs) {
+  if (hasResumedSincePause(session, pause)) {
+    return;
+  }
+  const remainingMs = remainingUntil(deadlineMs);
+  if (remainingMs <= 0) {
+    throwUnrelatedPauseTimeout(pause, timeoutMs);
+  }
+  try {
+    await session.client.waitFor("Debugger.resumed", { timeoutMs: remainingMs });
+    session.debuggerState.lastResumedAtMs = performance2.now();
+  } catch (err) {
+    if (err instanceof CfInspectorError && err.code === "BREAKPOINT_NOT_HIT") {
+      throwUnrelatedPauseTimeout(pause, timeoutMs);
+    }
+    throw err;
+  }
+}
+async function handleUnmatchedPause(session, pause, options, deadlineMs) {
+  if (options.unmatchedPausePolicy === "fail") {
+    throw new CfInspectorError(
+      "UNRELATED_PAUSE",
+      "Target paused before this command's breakpoint was reached",
+      pauseDetail(pause)
+    );
+  }
+  if (hasResumedSincePause(session, pause)) {
+    return;
+  }
+  options.onUnmatchedPause?.(pause);
+  await waitForUnmatchedPauseToResume(session, pause, deadlineMs, options.timeoutMs);
+}
+async function waitForPause(session, options) {
+  const deadlineMs = performance2.now() + options.timeoutMs;
+  const buffer = session.pauseBuffer;
+  while (buffer.length > 0 || remainingUntil(deadlineMs) > 0) {
+    while (buffer.length > 0) {
+      const buffered = buffer.shift();
+      if (buffered === void 0) {
+        continue;
+      }
+      if (pauseMatches(buffered, options.breakpointIds)) {
+        return buffered;
+      }
+      await handleUnmatchedPause(session, buffered, options, deadlineMs);
+    }
+    const pause = await waitForLivePause(session, options, deadlineMs);
+    if (pauseMatches(pause, options.breakpointIds)) {
+      return pause;
+    }
+    await handleUnmatchedPause(session, pause, options, deadlineMs);
+  }
+  throwBreakpointTimeout(options.timeoutMs);
+}
+async function waitForLivePause(session, options, deadlineMs) {
+  const remainingMs = remainingUntil(deadlineMs);
+  if (remainingMs <= 0) {
+    throwBreakpointTimeout(options.timeoutMs);
+  }
+  session.pauseWaitGate.active = true;
+  let receivedAtMs;
+  let params;
+  try {
+    params = await session.client.waitFor("Debugger.paused", {
+      timeoutMs: remainingMs,
+      predicate: () => {
+        receivedAtMs = performance2.now();
+        return true;
+      }
+    });
+  } finally {
+    session.pauseWaitGate.active = false;
+  }
+  return toPauseEvent(params, receivedAtMs ?? performance2.now(), session.scripts);
+}
+
 // src/snapshot/values.ts
 init_types();
 var DEFAULT_MAX_VALUE_LENGTH = 4096;