@tonyclaw/agent-inspector 4.0.1 → 4.0.2

package/src/lib/browserRuntimeResolver.ts

@@ -1,333 +0,0 @@
-import { getConfiguredBasePath } from "./basePath";
-import {
-  BROWSER_RUNTIME_SCHEMA_VERSION,
-  BrowserRuntimeDeploymentSchema,
-  normalizeBrowserRuntimeBasePath,
-  normalizeBrowserRuntimeBaseUrl,
-  type BrowserRuntimeDeployment,
-} from "./browserRuntimeContract";
-
-export const AGENT_INSPECTOR_INJECTED_RUNTIME_GLOBAL = "__AGENT_INSPECTOR_RUNTIME__";
-export const AGENT_INSPECTOR_OPERATOR_RUNTIME_GLOBAL = "__AGENT_INSPECTOR_RUNTIME_CONFIG__";
-export const AGENT_INSPECTOR_RUNTIME_DISCOVERED_EVENT = "agent-inspector:runtime-discovered";
-
-export type BrowserRuntimeSource = "injected" | "operator" | "discovered" | "composed-fallback";
-
-export type BrowserRuntimeComposedFallback = {
-  origin: string;
-  uiBasePath: string;
-};
-
-export type BrowserRuntimeSources = {
-  injected?: unknown;
-  operator?: unknown;
-  composedFallback?: BrowserRuntimeComposedFallback;
-};
-
-export type BrowserRuntimeResolution =
-  | {
-      ok: true;
-      source: BrowserRuntimeSource;
-      runtime: BrowserRuntimeDeployment;
-    }
-  | {
-      ok: false;
-      source: BrowserRuntimeSource | "none";
-      code: "invalid" | "missing";
-      issues: readonly string[];
-    };
-
-let discoveredRuntimeForDocument: BrowserRuntimeDeployment | null = null;
-
-export function resetBrowserRuntimeDiscoveryForTests(): void {
-  discoveredRuntimeForDocument = null;
-}
-
-function readGlobalValue(name: string): unknown {
-  const descriptor = Object.getOwnPropertyDescriptor(globalThis, name);
-  const value: unknown = descriptor?.value;
-  if (
-    typeof value === "object" &&
-    value !== null &&
-    !Array.isArray(value) &&
-    Object.keys(value).length === 0
-  ) {
-    return undefined;
-  }
-  return value;
-}
-
-export function readBrowserRuntimeSources(): Pick<BrowserRuntimeSources, "injected" | "operator"> {
-  return {
-    injected: readGlobalValue(AGENT_INSPECTOR_INJECTED_RUNTIME_GLOBAL),
-    operator: readGlobalValue(AGENT_INSPECTOR_OPERATOR_RUNTIME_GLOBAL),
-  };
-}
-
-function formatIssues(error: {
-  issues: readonly { path: PropertyKey[]; message: string }[];
-}): string[] {
-  return error.issues.map((issue) => {
-    const path = issue.path.map(String).join(".");
-    return path.length === 0 ? issue.message : `${path}: ${issue.message}`;
-  });
-}
-
-function validateRuntime(source: BrowserRuntimeSource, value: unknown): BrowserRuntimeResolution {
-  const parsed = BrowserRuntimeDeploymentSchema.safeParse(value);
-  if (parsed.success) {
-    return { ok: true, source, runtime: parsed.data };
-  }
-  return {
-    ok: false,
-    source,
-    code: "invalid",
-    issues: formatIssues(parsed.error),
-  };
-}
-
-function parseRuntimeBaseUrl(value: string): URL | null {
-  try {
-    return new URL(value);
-  } catch {
-    return null;
-  }
-}
-
-function isLoopbackHostname(hostname: string): boolean {
-  const normalized = hostname.toLowerCase();
-  return (
-    normalized === "localhost" ||
-    normalized === "127.0.0.1" ||
-    normalized === "::1" ||
-    normalized === "[::1]"
-  );
-}
-
-function sameLoopbackEndpoint(left: URL, right: URL): boolean {
-  return (
-    left.protocol === right.protocol &&
-    left.port === right.port &&
-    isLoopbackHostname(left.hostname) &&
-    isLoopbackHostname(right.hostname)
-  );
-}
-
-function runtimeBasePathFromUrl(url: URL): string | null {
-  return normalizeBrowserRuntimeBasePath(url.pathname);
-}
-
-function rewriteLoopbackBaseUrlToDocumentOrigin(baseUrl: string, uiBasePath: string): string {
-  if (typeof globalThis.location === "undefined") return baseUrl;
-  const documentOrigin = normalizeBrowserRuntimeBaseUrl(globalThis.location.origin);
-  if (documentOrigin === null) return baseUrl;
-
-  const parsedBase = parseRuntimeBaseUrl(baseUrl);
-  const parsedDocument = parseRuntimeBaseUrl(documentOrigin);
-  if (parsedBase === null || parsedDocument === null) return baseUrl;
-  if (!sameLoopbackEndpoint(parsedBase, parsedDocument)) return baseUrl;
-
-  const normalizedUiBasePath = normalizeBrowserRuntimeBasePath(uiBasePath);
-  const normalizedRuntimeBasePath = runtimeBasePathFromUrl(parsedBase);
-  if (
-    normalizedUiBasePath === null ||
-    normalizedRuntimeBasePath === null ||
-    normalizedUiBasePath !== normalizedRuntimeBasePath
-  ) {
-    return baseUrl;
-  }
-
-  return normalizedUiBasePath === "/"
-    ? parsedDocument.origin
-    : `${parsedDocument.origin}${normalizedUiBasePath}`;
-}
-
-function preferDocumentLoopbackRuntime(
-  runtime: BrowserRuntimeDeployment,
-): BrowserRuntimeDeployment {
-  return {
-    ...runtime,
-    control: {
-      baseUrl: rewriteLoopbackBaseUrlToDocumentOrigin(runtime.control.baseUrl, runtime.ui.basePath),
-    },
-    agent: {
-      baseUrl: rewriteLoopbackBaseUrlToDocumentOrigin(runtime.agent.baseUrl, runtime.ui.basePath),
-    },
-  };
-}
-
-function fallbackRuntime(fallback: BrowserRuntimeComposedFallback): unknown {
-  const normalizedOrigin = normalizeBrowserRuntimeBaseUrl(fallback.origin);
-  const normalizedBasePath = normalizeBrowserRuntimeBasePath(
-    fallback.uiBasePath.length === 0 ? "/" : fallback.uiBasePath,
-  );
-  if (
-    normalizedOrigin === null ||
-    normalizedBasePath === null ||
-    normalizedOrigin !== new URL(normalizedOrigin).origin
-  ) {
-    return null;
-  }
-
-  const baseUrl =
-    normalizedBasePath === "/" ? normalizedOrigin : `${normalizedOrigin}${normalizedBasePath}`;
-  return {
-    schemaVersion: BROWSER_RUNTIME_SCHEMA_VERSION,
-    deploymentMode: "composed",
-    ui: { basePath: normalizedBasePath },
-    control: { baseUrl },
-    agent: { baseUrl },
-    capabilities: {
-      rest: true,
-      sse: true,
-      proxy: true,
-      mcp: true,
-    },
-  };
-}
-
-export function resolveBrowserRuntime(sources: BrowserRuntimeSources): BrowserRuntimeResolution {
-  if (sources.injected !== undefined) {
-    return validateRuntime("injected", sources.injected);
-  }
-  if (sources.operator !== undefined) {
-    return validateRuntime("operator", sources.operator);
-  }
-  if (sources.composedFallback !== undefined) {
-    return validateRuntime("composed-fallback", fallbackRuntime(sources.composedFallback));
-  }
-  return {
-    ok: false,
-    source: "none",
-    code: "missing",
-    issues: ["No injected, operator, or explicit composed runtime configuration is available."],
-  };
-}
-
-function configuredBrowserRuntimeForDocument(): BrowserRuntimeResolution | null {
-  const sources = readBrowserRuntimeSources();
-  if (sources.injected !== undefined || sources.operator !== undefined) {
-    return resolveBrowserRuntime(sources);
-  }
-  return null;
-}
-
-export function acceptBrowserRuntimeDiscovery(
-  expectedFallback: BrowserRuntimeDeployment,
-  value: unknown,
-): BrowserRuntimeResolution {
-  const discovered = validateRuntime("discovered", value);
-  if (!discovered.ok) return discovered;
-  const normalizedRuntime = preferDocumentLoopbackRuntime(discovered.runtime);
-  if (
-    normalizedRuntime.control.baseUrl !== expectedFallback.control.baseUrl ||
-    normalizedRuntime.ui.basePath !== expectedFallback.ui.basePath
-  ) {
-    return {
-      ok: false,
-      source: "discovered",
-      code: "invalid",
-      issues: ["Backend discovery does not match the same-origin fallback control surface."],
-    };
-  }
-  discoveredRuntimeForDocument = normalizedRuntime;
-  if (typeof globalThis.dispatchEvent === "function" && typeof globalThis.Event === "function") {
-    globalThis.dispatchEvent(new Event(AGENT_INSPECTOR_RUNTIME_DISCOVERED_EVENT));
-  }
-  return { ok: true, source: "discovered", runtime: normalizedRuntime };
-}
-
-export function resolveVerifiedBrowserRuntimeForDocument(): BrowserRuntimeResolution {
-  const configured = configuredBrowserRuntimeForDocument();
-  if (configured !== null) {
-    return configured.ok
-      ? { ...configured, runtime: preferDocumentLoopbackRuntime(configured.runtime) }
-      : configured;
-  }
-  if (discoveredRuntimeForDocument !== null) {
-    const discovered = validateRuntime("discovered", discoveredRuntimeForDocument);
-    return discovered.ok
-      ? { ...discovered, runtime: preferDocumentLoopbackRuntime(discovered.runtime) }
-      : discovered;
-  }
-  return {
-    ok: false,
-    source: "none",
-    code: "missing",
-    issues: ["The same-origin backend discovery response has not been validated."],
-  };
-}
-
-export function resolveBrowserRuntimeForDocument(): BrowserRuntimeResolution {
-  const configured = configuredBrowserRuntimeForDocument();
-  if (configured !== null) {
-    return configured.ok
-      ? { ...configured, runtime: preferDocumentLoopbackRuntime(configured.runtime) }
-      : configured;
-  }
-  if (discoveredRuntimeForDocument !== null) {
-    const discovered = validateRuntime("discovered", discoveredRuntimeForDocument);
-    return discovered.ok
-      ? { ...discovered, runtime: preferDocumentLoopbackRuntime(discovered.runtime) }
-      : discovered;
-  }
-  if (typeof globalThis.location === "undefined") return resolveBrowserRuntime({});
-  return resolveBrowserRuntime({
-    composedFallback: {
-      origin: globalThis.location.origin,
-      uiBasePath: getConfiguredBasePath(),
-    },
-  });
-}
-
-function hasControlCharacter(value: string): boolean {
-  return [...value].some((character) => {
-    const code = character.charCodeAt(0);
-    return code < 32 || code === 127;
-  });
-}
-
-function normalizeLogicalRuntimePath(value: string): string | null {
-  if (
-    value.trim() !== value ||
-    !value.startsWith("/") ||
-    value.startsWith("//") ||
-    value.includes("#") ||
-    value.includes("\\") ||
-    hasControlCharacter(value)
-  ) {
-    return null;
-  }
-
-  const queryIndex = value.indexOf("?");
-  const pathname = queryIndex < 0 ? value : value.slice(0, queryIndex);
-  const segments = pathname.split("/");
-  if (
-    segments.some(
-      (segment) => segment === "." || segment === ".." || /%(?:2e|2f|5c)/iu.test(segment),
-    )
-  ) {
-    return null;
-  }
-  return value === "/" ? "" : value;
-}
-
-function buildRuntimeUrl(baseUrl: string, logicalPath: string): string | null {
-  const path = normalizeLogicalRuntimePath(logicalPath);
-  if (path === null) return null;
-  return `${baseUrl}${path}`;
-}
-
-export function buildControlRuntimeUrl(
-  runtime: BrowserRuntimeDeployment,
-  logicalPath: string,
-): string | null {
-  return buildRuntimeUrl(runtime.control.baseUrl, logicalPath);
-}
-
-export function buildAgentRuntimeUrl(
-  runtime: BrowserRuntimeDeployment,
-  logicalPath: string,
-): string | null {
-  return buildRuntimeUrl(runtime.agent.baseUrl, logicalPath);
-}

package/src/lib/chunkLoadRecovery.ts

@@ -1,83 +0,0 @@
-const CHUNK_LOAD_RELOAD_AT_KEY = "agent-inspector.chunkLoadReloadAt";
-const CHUNK_LOAD_RELOAD_WINDOW_MS = 15_000;
-
-const CHUNK_LOAD_FAILURE_PATTERNS = [
-  "failed to fetch dynamically imported module",
-  "failed to load module script",
-  "importing a module script failed",
-  "error loading dynamically imported module",
-  "loading chunk",
-  "unable to preload css",
-];
-
-function messageFromReason(reason: unknown): string {
-  if (reason instanceof Error) {
-    return reason.message;
-  }
-
-  if (typeof reason === "string") {
-    return reason;
-  }
-
-  return "";
-}
-
-function isChunkLoadFailureMessage(message: string): boolean {
-  const normalizedMessage = message.toLowerCase();
-  return CHUNK_LOAD_FAILURE_PATTERNS.some((pattern) => normalizedMessage.includes(pattern));
-}
-
-function readLastReloadAt(): number {
-  const storedValue = window.sessionStorage.getItem(CHUNK_LOAD_RELOAD_AT_KEY);
-  if (storedValue === null) {
-    return 0;
-  }
-
-  const parsedValue = Number(storedValue);
-  return Number.isFinite(parsedValue) ? parsedValue : 0;
-}
-
-function reloadOnceForChunkFailure(): void {
-  const now = Date.now();
-  const lastReloadAt = readLastReloadAt();
-  if (now - lastReloadAt < CHUNK_LOAD_RELOAD_WINDOW_MS) {
-    return;
-  }
-
-  window.sessionStorage.setItem(CHUNK_LOAD_RELOAD_AT_KEY, String(now));
-  window.location.reload();
-}
-
-export function installChunkLoadRecovery(): () => void {
-  if (typeof window === "undefined") {
-    return () => {};
-  }
-
-  const handleUnhandledRejection = (event: PromiseRejectionEvent): void => {
-    const message = messageFromReason(event.reason);
-    if (!isChunkLoadFailureMessage(message)) {
-      return;
-    }
-
-    event.preventDefault();
-    reloadOnceForChunkFailure();
-  };
-
-  const handleError = (event: ErrorEvent): void => {
-    const message = event.message !== "" ? event.message : messageFromReason(event.error);
-    if (!isChunkLoadFailureMessage(message)) {
-      return;
-    }
-
-    event.preventDefault();
-    reloadOnceForChunkFailure();
-  };
-
-  window.addEventListener("unhandledrejection", handleUnhandledRejection);
-  window.addEventListener("error", handleError);
-
-  return () => {
-    window.removeEventListener("unhandledrejection", handleUnhandledRejection);
-    window.removeEventListener("error", handleError);
-  };
-}

package/src/lib/claudeCodeStrip.ts

@@ -1,98 +0,0 @@
-import { isPlainRecord, safeGetOwnProperty } from "./objectUtils";
-
-/**
- * Claude Code (and similar Anthropic SDK-based clients) prepend a synthetic
- * text block to the `system` array that looks like an HTTP header:
- *
- *   x-anthropic-billing-header: cc_version=2.1.92.61c; cc_entrypoint=cli; cch=00000;
- *
- * The `cch` field is a per-request cache-hint value. When this block is
- * forwarded verbatim to a third-party model, the system prompt prefix
- * changes on every request, which kills prefix-cache hit rates and wastes
- * input tokens.
- *
- * This browser-safe module contains only the pure request transformation so
- * the proxy and UI preview can share it without coupling the UI to the proxy.
- */
-
-const BILLING_HEADER_PREFIX = "x-anthropic-billing-header:";
-
-type StripResult = {
-  /** The new request body. Equal to input when no change was made. */
-  body: string;
-  /** Number of billing-header text blocks removed. */
-  removed: number;
-};
-
-/**
- * Returns true if the given text looks like the synthetic billing-header
- * block that Claude Code injects. Whitespace at the start is tolerated and
- * the match is case-insensitive on the header name.
- */
-export function isClaudeCodeBillingHeaderBlock(text: string): boolean {
-  const trimmed = text.trimStart();
-  return trimmed.toLowerCase().startsWith(BILLING_HEADER_PREFIX);
-}
-
-function isObjectWithSystem(value: unknown): value is { system?: unknown[] } {
-  if (!isPlainRecord(value)) return false;
-  return Object.prototype.hasOwnProperty.call(value, "system");
-}
-
-function isBillingHeaderTextBlock(block: unknown): boolean {
-  if (!isPlainRecord(block)) return false;
-  const typeVal = safeGetOwnProperty(block, "type");
-  const textVal = safeGetOwnProperty(block, "text");
-  if (typeof typeVal !== "string" || typeVal !== "text") return false;
-  if (typeof textVal !== "string") return false;
-  return isClaudeCodeBillingHeaderBlock(textVal);
-}
-
-/**
- * Inspects the request body and, if it is an Anthropic-format request whose
- * `system` array contains one or more Claude Code billing-header text blocks,
- * returns a new body with those blocks removed. The original string is
- * returned unchanged when no edit is needed so callers can avoid
- * re-serializing.
- */
-export function stripClaudeCodeBillingHeader(rawBody: string): StripResult {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(rawBody);
-  } catch {
-    return { body: rawBody, removed: 0 };
-  }
-
-  if (!isObjectWithSystem(parsed)) {
-    return { body: rawBody, removed: 0 };
-  }
-
-  const system = parsed.system;
-
-  if (!Array.isArray(system) || system.length === 0) {
-    return { body: rawBody, removed: 0 };
-  }
-
-  const kept: unknown[] = [];
-  let removed = 0;
-
-  for (const block of system) {
-    if (isBillingHeaderTextBlock(block)) {
-      removed += 1;
-      continue;
-    }
-    kept.push(block);
-  }
-
-  if (removed === 0) {
-    return { body: rawBody, removed: 0 };
-  }
-
-  if (kept.length === 0) {
-    delete parsed.system;
-  } else {
-    parsed.system = kept;
-  }
-
-  return { body: JSON.stringify(parsed), removed };
-}

package/src/lib/clipboard.ts

@@ -1,67 +0,0 @@
-function restoreSelection(selection: Selection | null, ranges: readonly Range[]): void {
-  if (selection === null) return;
-  selection.removeAllRanges();
-  for (const range of ranges) {
-    selection.addRange(range);
-  }
-}
-
-function readSelectionRanges(selection: Selection | null): Range[] {
-  if (selection === null) return [];
-  const ranges: Range[] = [];
-  for (let index = 0; index < selection.rangeCount; index++) {
-    ranges.push(selection.getRangeAt(index));
-  }
-  return ranges;
-}
-
-function copyWithTextareaFallback(text: string): boolean {
-  if (typeof document === "undefined") return false;
-
-  const activeElement = document.activeElement;
-  const selection = document.getSelection();
-  const ranges = readSelectionRanges(selection);
-  const textarea = document.createElement("textarea");
-
-  textarea.value = text;
-  textarea.setAttribute("readonly", "");
-  textarea.style.position = "fixed";
-  textarea.style.top = "0";
-  textarea.style.left = "-9999px";
-  textarea.style.opacity = "0";
-
-  document.body.appendChild(textarea);
-  textarea.focus();
-  textarea.select();
-  textarea.setSelectionRange(0, text.length);
-
-  let copied = false;
-  try {
-    copied = document.execCommand("copy");
-  } catch {
-    // Keep the false default.
-  } finally {
-    document.body.removeChild(textarea);
-    restoreSelection(selection, ranges);
-    if (typeof HTMLElement !== "undefined" && activeElement instanceof HTMLElement) {
-      activeElement.focus({ preventScroll: true });
-    }
-  }
-
-  return copied;
-}
-
-export async function copyTextToClipboard(text: string): Promise<boolean> {
-  const clipboard = globalThis.navigator?.clipboard;
-  if (clipboard !== undefined) {
-    try {
-      await clipboard.writeText(text);
-      return true;
-    } catch {
-      // Fall back below. Some embedded browsers expose Clipboard API but reject
-      // writes outside a secure context or without an explicit permission grant.
-    }
-  }
-
-  return copyWithTextareaFallback(text);
-}

package/src/lib/codingAgentEndpoints.ts

@@ -1,54 +0,0 @@
-import { appendBasePathToOrigin } from "./basePath";
-import type { BrowserRuntimeDeployment } from "./browserRuntimeContract";
-import {
-  AGENT_INSPECTOR_RUNTIME_DISCOVERED_EVENT,
-  buildAgentRuntimeUrl,
-  resolveVerifiedBrowserRuntimeForDocument,
-} from "./browserRuntimeResolver";
-
-export type CodingAgentEndpoints = {
-  proxy: string;
-  openAiV1: string;
-  mcp: string;
-};
-
-/** Derive the public protocol endpoints shown to coding agents from one Inspector origin. */
-export function deriveCodingAgentEndpoints(origin: string, basePath: string): CodingAgentEndpoints {
-  return {
-    proxy: appendBasePathToOrigin(origin, "/proxy", basePath),
-    openAiV1: appendBasePathToOrigin(origin, "/proxy/v1", basePath),
-    mcp: appendBasePathToOrigin(origin, "/api/mcp", basePath),
-  };
-}
-
-/** Derive copyable Coding Agent endpoints exclusively from the agent-facing runtime surface. */
-export function deriveCodingAgentEndpointsFromRuntime(
-  runtime: BrowserRuntimeDeployment,
-): CodingAgentEndpoints | null {
-  const proxy = buildAgentRuntimeUrl(runtime, "/proxy");
-  const openAiV1 = buildAgentRuntimeUrl(runtime, "/proxy/v1");
-  const mcp = buildAgentRuntimeUrl(runtime, "/api/mcp");
-  if (proxy === null || openAiV1 === null || mcp === null) return null;
-  return { proxy, openAiV1, mcp };
-}
-
-export function resolveCodingAgentEndpointsForDocument(): CodingAgentEndpoints | null {
-  const runtime = resolveVerifiedBrowserRuntimeForDocument();
-  if (!runtime.ok) return null;
-  return deriveCodingAgentEndpointsFromRuntime(runtime.runtime);
-}
-
-export function subscribeCodingAgentEndpoints(
-  listener: (endpoints: CodingAgentEndpoints | null) => void,
-): () => void {
-  const update = (): void => listener(resolveCodingAgentEndpointsForDocument());
-  update();
-  if (
-    typeof globalThis.addEventListener !== "function" ||
-    typeof globalThis.removeEventListener !== "function"
-  ) {
-    return () => undefined;
-  }
-  globalThis.addEventListener(AGENT_INSPECTOR_RUNTIME_DISCOVERED_EVENT, update);
-  return () => globalThis.removeEventListener(AGENT_INSPECTOR_RUNTIME_DISCOVERED_EVENT, update);
-}