@tonyclaw/agent-inspector 4.0.1 → 4.0.2

package/src/components/proxy-viewer/liveConnectionState.ts

@@ -1,158 +0,0 @@
-export type LiveConnectionPhase =
-  | "connecting"
-  | "live"
-  | "reconnecting"
-  | "stale"
-  | "offline"
-  | "error";
-
-export type LiveConnectionState = {
-  status: LiveConnectionPhase;
-  lastSuccessAt: number | null;
-  retryCount: number;
-  errorMessage: string | null;
-};
-
-export type LiveConnectionEvent =
-  | { type: "connect-requested" }
-  | { type: "message-received"; at: number }
-  | { type: "connection-lost"; online: boolean; message: string }
-  | { type: "stale-timeout" }
-  | { type: "browser-offline" }
-  | { type: "stop-retrying" }
-  | { type: "recoverable-error"; message: string };
-
-export function createInitialLiveConnectionState(): LiveConnectionState {
-  return {
-    status: "connecting",
-    lastSuccessAt: null,
-    retryCount: 0,
-    errorMessage: null,
-  };
-}
-
-export function reduceLiveConnectionState(
-  state: LiveConnectionState,
-  event: LiveConnectionEvent,
-): LiveConnectionState {
-  switch (event.type) {
-    case "connect-requested":
-      return {
-        ...state,
-        status:
-          state.lastSuccessAt === null
-            ? "connecting"
-            : state.status === "stale"
-              ? "stale"
-              : "reconnecting",
-        errorMessage: null,
-      };
-    case "message-received":
-      return {
-        status: "live",
-        lastSuccessAt: event.at,
-        retryCount: 0,
-        errorMessage: null,
-      };
-    case "connection-lost": {
-      const retryCount = state.retryCount + 1;
-      if (!event.online) {
-        return {
-          ...state,
-          status: "offline",
-          retryCount,
-          errorMessage: "Browser is offline.",
-        };
-      }
-      return {
-        ...state,
-        status: state.lastSuccessAt === null ? "error" : "reconnecting",
-        retryCount,
-        errorMessage: event.message,
-      };
-    }
-    case "stale-timeout":
-      if (state.lastSuccessAt === null || state.status === "live" || state.status === "offline") {
-        return state;
-      }
-      return { ...state, status: "stale" };
-    case "browser-offline":
-      return {
-        ...state,
-        status: "offline",
-        errorMessage: "Browser is offline.",
-      };
-    case "stop-retrying":
-      return {
-        ...state,
-        status: "offline",
-        errorMessage: "Automatic live updates are paused.",
-      };
-    case "recoverable-error":
-      return {
-        ...state,
-        status: "error",
-        errorMessage: event.message,
-      };
-  }
-}
-
-export type LiveEmptyState =
-  | "connecting"
-  | "empty"
-  | "reconnecting"
-  | "stale"
-  | "offline"
-  | "error";
-
-export function resolveLiveEmptyState(state: LiveConnectionState | undefined): LiveEmptyState {
-  if (state === undefined || state.status === "live") return "empty";
-  return state.status;
-}
-
-export type LiveEmptyStateCopy = {
-  title: string;
-  description: string;
-  showConnectionCommands: boolean;
-};
-
-export function getLiveEmptyStateCopy(state: LiveEmptyState): LiveEmptyStateCopy {
-  switch (state) {
-    case "connecting":
-      return {
-        title: "Connecting to the live stream...",
-        description: "Waiting for the first successful initialization before checking for logs.",
-        showConnectionCommands: false,
-      };
-    case "empty":
-      return {
-        title: "No logs captured yet.",
-        description: "Connect an AI coding tool to capture its first request.",
-        showConnectionCommands: true,
-      };
-    case "reconnecting":
-      return {
-        title: "Reconnecting to live updates...",
-        description: "The stream was interrupted. Agent Inspector is retrying automatically.",
-        showConnectionCommands: false,
-      };
-    case "stale":
-      return {
-        title: "Live data is stale.",
-        description: "No logs are hidden; retry the connection to resume live updates.",
-        showConnectionCommands: false,
-      };
-    case "offline":
-      return {
-        title: "Live updates are offline.",
-        description: "Check the browser and Inspector connection, then retry.",
-        showConnectionCommands: false,
-      };
-    case "error":
-      return {
-        title: "Live updates could not initialize.",
-        description: "The error is recoverable. Retry without reloading the page.",
-        showConnectionCommands: false,
-      };
-  }
-}

package/src/components/proxy-viewer/log-formats/anthropic.ts

@@ -1,191 +0,0 @@
-import { AnthropicRequestSchema, AnthropicResponseSchema } from "../../../contracts/anthropic";
-import type { AnatomySegment } from "../anatomy/types";
-import { countCharacters, estimateTokens } from "../anatomy/tokenEstimate";
-import { parseRequestTools } from "../requestTools";
-import type { LogFormatAdapter } from "./types";
-import { emptyRequestAnalysis, EMPTY_RESPONSE_ANALYSIS } from "./types";
-
-/**
- * Flatten an Anthropic `content` field to the text used for token
- * estimation. The function never throws: unknown content shapes are
- * treated as empty. We deliberately do NOT use JSON.stringify on the
- * content because base64 image data would dominate the size.
- */
-function contentToText(content: unknown): string {
-  if (typeof content === "string") return content;
-  if (!Array.isArray(content)) return "";
-  const parts: string[] = [];
-  for (const block of content) {
-    if (block === null || typeof block !== "object") continue;
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    const b = block as Record<string, unknown>;
-    const type = b.type;
-    switch (type) {
-      case "text":
-        if (typeof b.text === "string") parts.push(b.text);
-        break;
-      case "thinking":
-      case "think":
-        if (typeof b.thinking === "string") parts.push(b.thinking);
-        break;
-      case "tool_use": {
-        const name = typeof b.name === "string" ? b.name : "";
-        const input = b.input !== undefined ? JSON.stringify(b.input) : "";
-        parts.push(`${name} ${input}`.trim());
-        break;
-      }
-      case "tool_result": {
-        const inner = b.content;
-        if (typeof inner === "string") {
-          parts.push(inner);
-        } else if (Array.isArray(inner)) {
-          for (const item of inner) {
-            if (item !== null && typeof item === "object") {
-              // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-              const t = (item as Record<string, unknown>).text;
-              if (typeof t === "string") parts.push(t);
-            }
-          }
-        }
-        break;
-      }
-      case "image":
-        // Skip base64 payload but record the image type so the segment is not empty.
-        parts.push("[image]");
-        break;
-    }
-  }
-  return parts.join("\n");
-}
-
-/** Flatten an Anthropic `system` value to its text. The API accepts
- * either a string or an array of text blocks. */
-function systemToText(system: unknown): string {
-  if (typeof system === "string") return system;
-  if (!Array.isArray(system)) return "";
-  const parts: string[] = [];
-  for (const block of system) {
-    if (block !== null && typeof block === "object") {
-      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-      const t = (block as { type?: unknown; text?: unknown }).text;
-      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-      const type = (block as { type?: unknown }).type;
-      if (type === "text" && typeof t === "string") parts.push(t);
-    }
-  }
-  return parts.join("\n");
-}
-
-/** Flatten Anthropic `tools` array to its schema text. */
-function toolsToText(tools: unknown): string {
-  if (!Array.isArray(tools)) return "";
-  const parts: string[] = [];
-  for (const tool of tools) {
-    if (tool === null || typeof tool !== "object") continue;
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    const t = tool as { name?: unknown; description?: unknown; input_schema?: unknown };
-    if (typeof t.name === "string") parts.push(t.name);
-    if (typeof t.description === "string") parts.push(t.description);
-    if (t.input_schema !== undefined) parts.push(JSON.stringify(t.input_schema));
-  }
-  return parts.join("\n");
-}
-
-/** Build one segment from a piece of text + a stable label and path. */
-function segment(
-  role: AnatomySegment["role"],
-  label: string,
-  text: string,
-  path: string,
-): AnatomySegment {
-  return {
-    role,
-    label,
-    text,
-    size: estimateTokens(text),
-    characters: countCharacters(text),
-    path,
-  };
-}
-
-export const anthropicLogFormatAdapter: LogFormatAdapter = {
-  format: "anthropic",
-
-  analyzeRequest(rawBody) {
-    if (rawBody === null) return emptyRequestAnalysis(rawBody);
-    try {
-      const parsedBody: unknown = JSON.parse(rawBody);
-      const toolCount = parseRequestTools(parsedBody)?.tools.length ?? null;
-      const result = AnthropicRequestSchema.safeParse(parsedBody);
-      if (!result.success) return emptyRequestAnalysis(rawBody);
-      return {
-        parsed: result.data,
-        comparisonValue: result.data,
-        messageCount: result.data.messages.length,
-        toolCount,
-      };
-    } catch {
-      return emptyRequestAnalysis(rawBody);
-    }
-  },
-
-  analyzeResponse(responseText) {
-    if (responseText === null) return EMPTY_RESPONSE_ANALYSIS;
-    try {
-      let json: unknown = JSON.parse(responseText);
-      if (typeof json === "string") json = JSON.parse(json);
-      const result = AnthropicResponseSchema.safeParse(json);
-      if (!result.success) return EMPTY_RESPONSE_ANALYSIS;
-      const toolNames = result.data.content
-        .filter((block) => block.type === "tool_use")
-        .map((block) => block.name);
-      return {
-        parsed: result.data,
-        toolNames: toolNames.length > 0 ? toolNames : null,
-      };
-    } catch {
-      return EMPTY_RESPONSE_ANALYSIS;
-    }
-  },
-
-  anatomySegments(parsed) {
-    if (parsed === null || typeof parsed !== "object") return null;
-    // We deliberately skip AnthropicRequestSchema validation here:
-    // real Anthropic requests accept `system` as either a string or
-    // an array, and we want the Context view to render even when the
-    // body shape is slightly off-schema (e.g. system: "string" vs
-    // system: [{type:"text",text:"..."}]).
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    const body = parsed as {
-      system?: unknown;
-      messages?: unknown;
-      tools?: unknown;
-    };
-    const segments: AnatomySegment[] = [];
-
-    if (body.system !== undefined) {
-      const text = systemToText(body.system);
-      if (text.length > 0) {
-        segments.push(segment("system", "system", text, "/system"));
-      }
-    }
-
-    if (Array.isArray(body.messages)) {
-      body.messages.forEach((message, index) => {
-        if (message === null || typeof message !== "object") return;
-        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-        const m = message as { role?: unknown; content?: unknown };
-        const role = m.role === "user" || m.role === "assistant" ? m.role : "user";
-        const text = contentToText(m.content);
-        segments.push(segment(role, `[${index}] ${role}`, text, `/messages/${index}`));
-      });
-    }
-
-    if (Array.isArray(body.tools) && body.tools.length > 0) {
-      const text = toolsToText(body.tools);
-      segments.push(segment("tools", "tools", text, "/tools"));
-    }
-
-    return segments.length > 0 ? segments : null;
-  },
-};

package/src/components/proxy-viewer/log-formats/index.ts

@@ -1,23 +0,0 @@
-import { apiFormatForPath } from "../../../lib/apiFormat";
-import type { ApiFormat, CapturedLog } from "../../../contracts";
-import { anthropicLogFormatAdapter } from "./anthropic";
-import { openAILogFormatAdapter } from "./openai";
-import type { LogFormatAdapter } from "./types";
-import { unknownLogFormatAdapter } from "./unknown";
-
-const ADAPTERS: Record<ApiFormat, LogFormatAdapter> = {
-  anthropic: anthropicLogFormatAdapter,
-  openai: openAILogFormatAdapter,
-  unknown: unknownLogFormatAdapter,
-};
-
-export function getLogFormatAdapter(format: ApiFormat): LogFormatAdapter {
-  return ADAPTERS[format];
-}
-
-export function resolveLogFormat(log: Pick<CapturedLog, "path" | "apiFormat">): ApiFormat {
-  const pathFormat = apiFormatForPath(log.path);
-  return pathFormat === "unknown" ? log.apiFormat : pathFormat;
-}
-
-export type { LogFormatAdapter, RequestAnalysis, ResponseAnalysis } from "./types";

package/src/components/proxy-viewer/log-formats/openai.ts

@@ -1,256 +0,0 @@
-import {
-  OpenAIRequestSchema,
-  OpenAIResponsesRequestSchema,
-  parseOpenAIResponsesResponse,
-  parseOpenAIResponse,
-} from "../../../contracts/openai";
-import { safeGetOwnProperty } from "../../../lib/objectUtils";
-import type { AnatomySegment } from "../anatomy/types";
-import { countCharacters, estimateTokens } from "../anatomy/tokenEstimate";
-import { parseRequestTools } from "../requestTools";
-import type { LogFormatAdapter } from "./types";
-import { emptyRequestAnalysis, EMPTY_RESPONSE_ANALYSIS } from "./types";
-
-type OpenAIMessageContent = string | ReadonlyArray<Record<string, unknown>> | null | undefined;
-
-/** Flatten an OpenAI `content` field to its text representation. */
-function contentToText(content: unknown): string {
-  if (typeof content === "string") return content;
-  if (!Array.isArray(content)) return "";
-  const parts: string[] = [];
-  for (const block of content) {
-    if (block === null || typeof block !== "object") continue;
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    const b = block as Record<string, unknown>;
-    const type = b.type;
-    if (
-      (type === "text" || type === "input_text" || type === "output_text") &&
-      typeof b.text === "string"
-    ) {
-      parts.push(b.text);
-    } else if (type === "image_url" || type === "input_image") {
-      parts.push("[image]");
-    }
-  }
-  return parts.join("\n");
-}
-
-/** Flatten an OpenAI message to text — content plus optional tool calls plus optional reasoning. */
-function messageToText(message: Record<string, unknown>): string {
-  const parts: string[] = [];
-  const text = contentToText(message.content);
-  if (text.length > 0) parts.push(text);
-  const reasoning =
-    typeof message.reasoning_content === "string"
-      ? message.reasoning_content
-      : typeof message.thinking === "string"
-        ? message.thinking
-        : typeof message.think === "string"
-          ? message.think
-          : "";
-  if (reasoning.length > 0) parts.push(reasoning);
-  const toolCalls = message.tool_calls;
-  if (Array.isArray(toolCalls)) {
-    for (const call of toolCalls) {
-      if (call === null || typeof call !== "object") continue;
-      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-      const fn = (call as { function?: { name?: unknown; arguments?: unknown } }).function;
-      if (fn === undefined) continue;
-      const name = typeof fn.name === "string" ? fn.name : "";
-      const args = typeof fn.arguments === "string" ? fn.arguments : "";
-      parts.push(`${name} ${args}`.trim());
-    }
-  }
-  return parts.join("\n");
-}
-
-/** Flatten an OpenAI `tools` array to its schema text. */
-function toolsToText(tools: unknown): string {
-  if (!Array.isArray(tools)) return "";
-  const parts: string[] = [];
-  for (const tool of tools) {
-    if (tool === null || typeof tool !== "object") continue;
-    const fn = safeGetOwnProperty(tool, "function");
-    const name = safeGetOwnProperty(fn, "name") ?? safeGetOwnProperty(tool, "name");
-    const description =
-      safeGetOwnProperty(fn, "description") ?? safeGetOwnProperty(tool, "description");
-    const parameters =
-      safeGetOwnProperty(fn, "parameters") ?? safeGetOwnProperty(tool, "parameters");
-    if (typeof name === "string") parts.push(name);
-    if (typeof description === "string") parts.push(description);
-    if (parameters !== undefined) parts.push(JSON.stringify(parameters));
-  }
-  return parts.join("\n");
-}
-
-function countResponsesInput(input: unknown): number | null {
-  if (typeof input === "string") return input.length > 0 ? 1 : 0;
-  if (Array.isArray(input)) return input.length;
-  if (input === undefined || input === null) return null;
-  return 1;
-}
-
-function responsesInputItemToText(input: unknown): string {
-  if (typeof input === "string") return input;
-  const directText = safeGetOwnProperty(input, "text");
-  if (typeof directText === "string") return directText;
-  const contentText = contentToText(safeGetOwnProperty(input, "content"));
-  if (contentText.length > 0) return contentText;
-  const outputText = contentToText(safeGetOwnProperty(input, "output"));
-  if (outputText.length > 0) return outputText;
-  const argumentsText = safeGetOwnProperty(input, "arguments");
-  return typeof argumentsText === "string" ? argumentsText : "";
-}
-
-function responsesInputRole(input: unknown): AnatomySegment["role"] {
-  const role = safeGetOwnProperty(input, "role");
-  if (role === "system" || role === "user" || role === "assistant" || role === "tool") {
-    return role;
-  }
-  const type = safeGetOwnProperty(input, "type");
-  if (type === "function_call_output") return "tool";
-  if (type === "message") return "user";
-  return "user";
-}
-
-function responsesToolNames(response: unknown): string[] {
-  const output = safeGetOwnProperty(response, "output");
-  if (!Array.isArray(output)) return [];
-  const names: string[] = [];
-  for (const item of output) {
-    if (safeGetOwnProperty(item, "type") !== "function_call") continue;
-    const name = safeGetOwnProperty(item, "name");
-    if (typeof name === "string" && name.length > 0) names.push(name);
-  }
-  return names;
-}
-
-function segment(
-  role: AnatomySegment["role"],
-  label: string,
-  text: string,
-  path: string,
-): AnatomySegment {
-  return {
-    role,
-    label,
-    text,
-    size: estimateTokens(text),
-    characters: countCharacters(text),
-    path,
-  };
-}
-
-export const openAILogFormatAdapter: LogFormatAdapter = {
-  format: "openai",
-
-  analyzeRequest(rawBody) {
-    if (rawBody === null) return emptyRequestAnalysis(rawBody);
-    try {
-      const parsedBody: unknown = JSON.parse(rawBody);
-      const toolCount = parseRequestTools(parsedBody)?.tools.length ?? null;
-      const result = OpenAIRequestSchema.safeParse(parsedBody);
-      if (!result.success) {
-        const responsesResult = OpenAIResponsesRequestSchema.safeParse(parsedBody);
-        if (!responsesResult.success) return emptyRequestAnalysis(rawBody);
-        return {
-          parsed: responsesResult.data,
-          comparisonValue: responsesResult.data,
-          messageCount: countResponsesInput(responsesResult.data.input),
-          toolCount,
-        };
-      }
-      return {
-        parsed: result.data,
-        comparisonValue: result.data,
-        messageCount: result.data.messages.length,
-        toolCount,
-      };
-    } catch {
-      return emptyRequestAnalysis(rawBody);
-    }
-  },
-
-  analyzeResponse(responseText) {
-    if (responseText === null) return EMPTY_RESPONSE_ANALYSIS;
-    const parsed = parseOpenAIResponse(responseText);
-    if (parsed === null) {
-      const responsesParsed = parseOpenAIResponsesResponse(responseText);
-      if (responsesParsed === null) return EMPTY_RESPONSE_ANALYSIS;
-      const toolNames = responsesToolNames(responsesParsed);
-      return {
-        parsed: responsesParsed,
-        toolNames: toolNames.length > 0 ? toolNames : null,
-      };
-    }
-    const toolNames =
-      parsed.choices[0]?.message?.tool_calls
-        ?.map((toolCall) => toolCall.function?.name ?? "")
-        .filter((name) => name !== "") ?? [];
-    return {
-      parsed,
-      toolNames: toolNames.length > 0 ? toolNames : null,
-    };
-  },
-
-  anatomySegments(parsed) {
-    if (parsed === null || typeof parsed !== "object") return null;
-    // We deliberately skip OpenAIRequestSchema validation here for the
-    // same reason as the Anthropic adapter: the Context view should
-    // render even when the body shape is slightly off-schema. We only
-    // need the top-level `messages` and `tools` arrays.
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    const body = parsed as {
-      messages?: unknown;
-      input?: unknown;
-      instructions?: unknown;
-      tools?: unknown;
-    };
-    const segments: AnatomySegment[] = [];
-
-    if (typeof body.instructions === "string" && body.instructions.length > 0) {
-      segments.push(segment("system", "instructions", body.instructions, "/instructions"));
-    }
-
-    // Promote a leading role: "system" message into a "system" segment.
-    // Spec: derive system role from a leading role: "system" message, then
-    // a segment per remaining message. We still keep the system message in
-    // the segment list (not skipped) when there is no separate system field
-    // to compare against — the leading role: "system" message IS the system
-    // content for OpenAI Chat Completions. If a separate `system` field
-    // existed and matched the message, we would dedupe, but Chat
-    // Completions has no such field, so we never have to skip.
-    if (Array.isArray(body.messages)) {
-      body.messages.forEach((message, index) => {
-        if (message === null || typeof message !== "object") return;
-        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-        const m = message as { role?: unknown; content?: unknown };
-        const role =
-          m.role === "user" || m.role === "assistant" || m.role === "system" || m.role === "tool"
-            ? m.role
-            : "user";
-        const text = messageToText(m);
-        segments.push(segment(role, `[${index}] ${role}`, text, `/messages/${index}`));
-      });
-    }
-
-    if (!Array.isArray(body.messages)) {
-      if (typeof body.input === "string" && body.input.length > 0) {
-        segments.push(segment("user", "input", body.input, "/input"));
-      } else if (Array.isArray(body.input)) {
-        body.input.forEach((item, index) => {
-          const role = responsesInputRole(item);
-          const text = responsesInputItemToText(item);
-          segments.push(segment(role, `[${index}] ${role}`, text, `/input/${index}`));
-        });
-      }
-    }
-
-    if (Array.isArray(body.tools) && body.tools.length > 0) {
-      const text = toolsToText(body.tools);
-      segments.push(segment("tools", "tools", text, "/tools"));
-    }
-
-    return segments.length > 0 ? segments : null;
-  },
-};

package/src/components/proxy-viewer/log-formats/types.ts

@@ -1,40 +0,0 @@
-import type { ApiFormat } from "../../../contracts";
-import type { AnatomySegment } from "../anatomy/types";
-
-export type RequestAnalysis = {
-  parsed: unknown | null;
-  comparisonValue: unknown;
-  messageCount: number | null;
-  toolCount: number | null;
-};
-
-export type ResponseAnalysis = {
-  parsed: unknown | null;
-  toolNames: string[] | null;
-};
-
-export type LogFormatAdapter = {
-  readonly format: ApiFormat;
-  analyzeRequest(rawBody: string | null): RequestAnalysis;
-  analyzeResponse(responseText: string | null): ResponseAnalysis;
-  /**
-   * Derive the ordered list of segments shown in the Context tab for a
-   * parsed request body. Returns `null` when the body is `null` or fails
-   * the format's schema (e.g. unknown format).
-   */
-  anatomySegments(parsed: unknown): AnatomySegment[] | null;
-};
-
-export function emptyRequestAnalysis(rawBody: string | null): RequestAnalysis {
-  return {
-    parsed: null,
-    comparisonValue: rawBody,
-    messageCount: null,
-    toolCount: null,
-  };
-}
-
-export const EMPTY_RESPONSE_ANALYSIS: ResponseAnalysis = {
-  parsed: null,
-  toolNames: null,
-};

package/src/components/proxy-viewer/log-formats/unknown.ts

@@ -1,18 +0,0 @@
-import type { LogFormatAdapter } from "./types";
-import { emptyRequestAnalysis, EMPTY_RESPONSE_ANALYSIS } from "./types";
-
-export const unknownLogFormatAdapter: LogFormatAdapter = {
-  format: "unknown",
-
-  analyzeRequest(rawBody) {
-    return emptyRequestAnalysis(rawBody);
-  },
-
-  analyzeResponse() {
-    return EMPTY_RESPONSE_ANALYSIS;
-  },
-
-  anatomySegments() {
-    return null;
-  },
-};