@tonyclaw/agent-inspector 4.0.1 → 4.0.2

package/src/lib/uiScale.ts

@@ -1,117 +0,0 @@
-export type UiScalePreference = "auto" | "100" | "125" | "150";
-
-export type UiScaleEnvironment = {
-  viewportWidth: number;
-  screenWidth: number;
-  devicePixelRatio: number;
-};
-
-export const UI_SCALE_STORAGE_KEY = "agent-inspector.uiScale";
-export const UI_SCALE_AUTO_MAX_DPR = 1.25;
-export const UI_SCALE_AUTO_MEDIUM_WIDTH = 2200;
-export const UI_SCALE_AUTO_LARGE_WIDTH = 3000;
-export const UI_SCALE_MINIMUM_COMPACT_FONT_SIZE = 12;
-
-function positiveFinite(value: number, fallback: number): number {
-  return Number.isFinite(value) && value > 0 ? value : fallback;
-}
-
-export function normalizeUiScalePreference(value: string | null): UiScalePreference {
-  switch (value) {
-    case "auto":
-      return "auto";
-    case "100":
-      return "100";
-    case "125":
-      return "125";
-    case "150":
-      return "150";
-    case null:
-      return "auto";
-    default:
-      return "auto";
-  }
-}
-
-export function resolveUiScale(
-  preference: UiScalePreference,
-  environment: UiScaleEnvironment,
-): number {
-  switch (preference) {
-    case "100":
-      return 1;
-    case "125":
-      return 1.25;
-    case "150":
-      return 1.5;
-    case "auto": {
-      const viewportWidth = positiveFinite(environment.viewportWidth, 1280);
-      const screenWidth = positiveFinite(environment.screenWidth, viewportWidth);
-      const devicePixelRatio = positiveFinite(environment.devicePixelRatio, 1);
-      const availableWidth = Math.min(viewportWidth, screenWidth);
-
-      // High-DPI laptops already receive operating-system scaling. Auto only
-      // enlarges spacious low-DPI desktop layouts, where dense telemetry is
-      // otherwise physically small.
-      if (devicePixelRatio > UI_SCALE_AUTO_MAX_DPR) return 1;
-      if (availableWidth >= UI_SCALE_AUTO_LARGE_WIDTH) return 1.25;
-      if (availableWidth >= UI_SCALE_AUTO_MEDIUM_WIDTH) return 1.125;
-      return 1;
-    }
-  }
-}
-
-export function formatUiScale(scale: number): string {
-  return `${Math.round(scale * 100)}%`;
-}
-
-export function resolveCompactFontSize(baseSize: number, scale: number): number {
-  return Math.max(UI_SCALE_MINIMUM_COMPACT_FONT_SIZE, baseSize * scale);
-}
-
-export function readUiScaleEnvironment(): UiScaleEnvironment {
-  if (typeof window === "undefined") {
-    return { viewportWidth: 1280, screenWidth: 1280, devicePixelRatio: 1 };
-  }
-  const screenWidth =
-    typeof window.screen === "undefined" ? window.innerWidth : window.screen.availWidth;
-  return {
-    viewportWidth: window.innerWidth,
-    screenWidth,
-    devicePixelRatio: window.devicePixelRatio,
-  };
-}
-
-export function applyUiScalePreference(preference: UiScalePreference): number {
-  const scale = resolveUiScale(preference, readUiScaleEnvironment());
-  if (typeof document === "undefined") return scale;
-
-  const root = document.documentElement;
-  root.dataset.uiScale = preference;
-  root.dataset.uiScaleResolved = String(Math.round(scale * 100));
-  root.style.setProperty("--inspector-ui-scale", String(scale));
-  root.style.setProperty("--inspector-root-font-size", `${String(16 * scale)}px`);
-  root.style.setProperty("--inspector-font-9", `${String(resolveCompactFontSize(9, scale))}px`);
-  root.style.setProperty("--inspector-font-10", `${String(resolveCompactFontSize(10, scale))}px`);
-  root.style.setProperty("--inspector-font-11", `${String(resolveCompactFontSize(11, scale))}px`);
-  root.style.setProperty("--inspector-font-13", `${String(13 * scale)}px`);
-  return scale;
-}
-
-export function readStoredUiScalePreference(): UiScalePreference {
-  if (typeof window === "undefined") return "auto";
-  try {
-    return normalizeUiScalePreference(window.localStorage.getItem(UI_SCALE_STORAGE_KEY));
-  } catch {
-    return "auto";
-  }
-}
-
-export function persistUiScalePreference(preference: UiScalePreference): void {
-  if (typeof window === "undefined") return;
-  try {
-    window.localStorage.setItem(UI_SCALE_STORAGE_KEY, preference);
-  } catch {
-    // Local storage can be unavailable in hardened browser contexts.
-  }
-}

package/src/lib/unknown.ts

@@ -1,27 +0,0 @@
-/**
- * Shared helpers for traversing values of type `unknown` without resorting to
- * type assertions. The project's ESLint rules forbid `as` casts and non-null
- * assertions, so every safe property read goes through these helpers.
- */
-
-/** True if `value` is a non-array, non-null object. */
-export function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-/**
- * Safely read an own property of `value`, returning `undefined` for any
- * non-object input (including arrays, null, primitives). Uses
- * `getOwnPropertyDescriptor` so that `__proto__` keys cannot be reached.
- */
-export function readProperty(value: unknown, name: string): unknown {
-  if (!isRecord(value)) return undefined;
-  const descriptor = Object.getOwnPropertyDescriptor(value, name);
-  return descriptor === undefined ? undefined : descriptor.value;
-}
-
-/** Byte length of a UTF-8 string, or `null` if the string is null. */
-export function textByteLength(value: string | null): number | null {
-  if (value === null) return null;
-  return new TextEncoder().encode(value).byteLength;
-}

package/src/lib/upstreamUrl.ts

@@ -1,150 +0,0 @@
-export const PATH_V1_CHAT_COMPLETIONS = "/v1/chat/completions";
-export const PATH_V1_RESPONSES = "/v1/responses";
-export const PATH_V1_MESSAGES = "/v1/messages";
-
-export type UpstreamUrlDiagnostic = {
-  severity: "info" | "warning";
-  message: string;
-};
-
-export type UpstreamUrlPreviewOptions = {
-  providerName?: string;
-};
-
-export type UpstreamUrlPreview = {
-  finalUrl: string;
-  diagnostics: UpstreamUrlDiagnostic[];
-};
-
-export function buildUpstreamUrl(upstreamBase: string, normalizedPath: string): string {
-  const base = upstreamBase.endsWith("/") ? upstreamBase.slice(0, -1) : upstreamBase;
-  const endpointPath = endpointPathFor(normalizedPath);
-  const queryIndex = normalizedPath.indexOf("?");
-  const search = queryIndex >= 0 ? normalizedPath.slice(queryIndex) : "";
-
-  // Some providers expose a format-specific URL as the exact endpoint rather
-  // than a base URL. Keep existing configs with exact endpoints compatible.
-  if (endpointPath !== "" && base.endsWith(endpointPath)) {
-    return base + search;
-  }
-
-  if (isZhipuVersionedOpenAIBase(base) && isVersionedChatCompletionsPath(normalizedPath)) {
-    return base + normalizedPath.slice(3);
-  }
-
-  // Many OpenAI-compatible base URLs already include /v1. Avoid producing /v1/v1.
-  if (base.endsWith("/v1") && normalizedPath.startsWith("/v1/")) {
-    return base + normalizedPath.slice(3);
-  }
-  return base + normalizedPath;
-}
-
-export function previewUpstreamUrl(
-  upstreamBase: string,
-  normalizedPath: string,
-  options: UpstreamUrlPreviewOptions = {},
-): UpstreamUrlPreview {
-  const base = upstreamBase.trim().replace(/\/+$/, "");
-  const endpointPath = endpointPathFor(normalizedPath);
-  const finalUrl = buildUpstreamUrl(base, normalizedPath);
-  const diagnostics: UpstreamUrlDiagnostic[] = [];
-  const exactEndpoint = endpointPath !== "" && base.endsWith(endpointPath);
-
-  if (exactEndpoint) {
-    diagnostics.push({
-      severity: "info",
-      message: "This already includes the exact endpoint; no duplicate suffix will be appended.",
-    });
-  } else if (isZhipuVersionedOpenAIBase(base) && isVersionedChatCompletionsPath(normalizedPath)) {
-    diagnostics.push({
-      severity: "info",
-      message: "Zhipu bases already include the API version; only /chat/completions is appended.",
-    });
-  } else if (base.endsWith("/v1") && normalizedPath.startsWith("/v1/")) {
-    diagnostics.push({
-      severity: "info",
-      message: "Base URL already ends with /v1; the suffix will not repeat /v1.",
-    });
-  }
-
-  if (isResponsesPath(endpointPath) && baseEndsWithChatEndpoint(base)) {
-    diagnostics.push({
-      severity: "warning",
-      message: "This looks like a Chat Completions endpoint, so Responses would append after it.",
-    });
-  }
-
-  if (isChatCompletionsPath(endpointPath) && baseEndsWithResponsesEndpoint(base)) {
-    diagnostics.push({
-      severity: "warning",
-      message: "This looks like a Responses endpoint, so Chat Completions would append after it.",
-    });
-  }
-
-  if (isResponsesPath(endpointPath) && isLikelyDeepSeekBase(base, options.providerName)) {
-    diagnostics.push({
-      severity: "warning",
-      message: "DeepSeek's official API does not currently expose OpenAI Responses.",
-    });
-  }
-
-  return { finalUrl, diagnostics };
-}
-
-function endpointPathFor(normalizedPath: string): string {
-  return normalizedPath.split("?")[0] ?? normalizedPath;
-}
-
-function isVersionedChatCompletionsPath(normalizedPath: string): boolean {
-  return (
-    normalizedPath === PATH_V1_CHAT_COMPLETIONS ||
-    normalizedPath.startsWith(`${PATH_V1_CHAT_COMPLETIONS}?`) ||
-    normalizedPath.startsWith(`${PATH_V1_CHAT_COMPLETIONS}/`)
-  );
-}
-
-function isChatCompletionsPath(endpointPath: string): boolean {
-  return (
-    endpointPath === PATH_V1_CHAT_COMPLETIONS ||
-    endpointPath.startsWith(`${PATH_V1_CHAT_COMPLETIONS}/`)
-  );
-}
-
-function isResponsesPath(endpointPath: string): boolean {
-  return endpointPath === PATH_V1_RESPONSES || endpointPath.startsWith(`${PATH_V1_RESPONSES}/`);
-}
-
-function baseEndsWithChatEndpoint(base: string): boolean {
-  const normalized = base.toLowerCase();
-  return normalized.endsWith("/chat/completions");
-}
-
-function baseEndsWithResponsesEndpoint(base: string): boolean {
-  const normalized = base.toLowerCase();
-  return normalized.endsWith("/responses");
-}
-
-function isLikelyDeepSeekBase(base: string, providerName: string | undefined): boolean {
-  const provider = providerName?.toLowerCase();
-  if (provider !== undefined && provider.includes("deepseek")) return true;
-
-  try {
-    const parsed = new URL(base);
-    return parsed.hostname.toLowerCase().includes("deepseek");
-  } catch {
-    return base.toLowerCase().includes("deepseek");
-  }
-}
-
-function isZhipuVersionedOpenAIBase(base: string): boolean {
-  try {
-    const parsed = new URL(base);
-    const path = parsed.pathname.replace(/\/+$/, "");
-    return (
-      parsed.hostname === "open.bigmodel.cn" &&
-      (path === "/api/paas/v4" || path === "/api/coding/paas/v4")
-    );
-  } catch {
-    return false;
-  }
-}

package/src/lib/useAlerts.ts

@@ -1,82 +0,0 @@
-import useSWR, { type SWRResponse } from "swr";
-import {
-  AlertListResponseSchema,
-  AlertSummarySchema,
-  type AlertCategory,
-  type AlertListResponse,
-  type AlertSeverity,
-  type AlertSource,
-  type AlertSummary,
-} from "./alertContract";
-import { fetchJsonWithTimeout } from "./apiClient";
-
-const ALERT_SUMMARY_FETCH_TIMEOUT_MS = 8_000;
-const ALERT_LIST_FETCH_TIMEOUT_MS = 10_000;
-
-export type AlertListFilters = {
-  severity?: AlertSeverity;
-  category?: AlertCategory;
-  source?: AlertSource;
-  limit?: number;
-};
-
-type UseAlertsResult = {
-  alerts: AlertListResponse["alerts"];
-  total: number;
-  summary: AlertSummary | null;
-  isLoading: boolean;
-  error: Error | undefined;
-  mutate: SWRResponse<AlertListResponse, Error>["mutate"];
-};
-
-type UseAlertSummaryResult = {
-  summary: AlertSummary | null;
-  isLoading: boolean;
-  error: Error | undefined;
-  mutate: SWRResponse<AlertSummary, Error>["mutate"];
-};
-
-function alertsPath(filters: AlertListFilters): string {
-  const params = new URLSearchParams();
-  if (filters.severity !== undefined) params.set("severity", filters.severity);
-  if (filters.category !== undefined) params.set("category", filters.category);
-  if (filters.source !== undefined) params.set("source", filters.source);
-  if (filters.limit !== undefined) params.set("limit", String(filters.limit));
-  const query = params.toString();
-  return query.length > 0 ? `/api/alerts?${query}` : "/api/alerts";
-}
-
-export function useAlerts(filters: AlertListFilters, enabled: boolean): UseAlertsResult {
-  const response: SWRResponse<AlertListResponse, Error> = useSWR<AlertListResponse, Error>(
-    enabled ? alertsPath(filters) : null,
-    (url: string) =>
-      fetchJsonWithTimeout(url, AlertListResponseSchema, ALERT_LIST_FETCH_TIMEOUT_MS),
-  );
-
-  return {
-    alerts: response.data?.alerts ?? [],
-    total: response.data?.total ?? 0,
-    summary: response.data?.summary ?? null,
-    isLoading: response.isLoading,
-    error: response.error,
-    mutate: response.mutate,
-  };
-}
-
-export function useAlertSummary(): UseAlertSummaryResult {
-  const response: SWRResponse<AlertSummary, Error> = useSWR<AlertSummary, Error>(
-    "/api/alerts/summary",
-    (url: string) => fetchJsonWithTimeout(url, AlertSummarySchema, ALERT_SUMMARY_FETCH_TIMEOUT_MS),
-    {
-      refreshInterval: 5_000,
-      revalidateOnFocus: true,
-    },
-  );
-
-  return {
-    summary: response.data ?? null,
-    isLoading: response.isLoading,
-    error: response.error,
-    mutate: response.mutate,
-  };
-}

package/src/lib/useGroupEvidence.ts

@@ -1,37 +0,0 @@
-import useSWR, { type SWRResponse } from "swr";
-import {
-  GroupEvidenceReadResponseSchema,
-  type GroupEvidenceReadResponse,
-  type InspectorGroup,
-} from "./groupContract";
-import { fetchJsonWithTimeout } from "./apiClient";
-
-const GROUP_EVIDENCE_FETCH_TIMEOUT_MS = 12_000;
-
-type UseGroupEvidenceResult = {
-  evidenceResponse: GroupEvidenceReadResponse | null;
-  isLoading: boolean;
-  error: Error | undefined;
-  mutate: SWRResponse<GroupEvidenceReadResponse, Error>["mutate"];
-};
-
-function evidenceKey(group: InspectorGroup | null): string | null {
-  if (group === null || group.evidence === null) return null;
-  return `/api/groups/${encodeURIComponent(group.id)}/evidence`;
-}
-
-export function useGroupEvidence(group: InspectorGroup | null): UseGroupEvidenceResult {
-  const response: SWRResponse<GroupEvidenceReadResponse, Error> = useSWR<
-    GroupEvidenceReadResponse,
-    Error
-  >(evidenceKey(group), (url: string) =>
-    fetchJsonWithTimeout(url, GroupEvidenceReadResponseSchema, GROUP_EVIDENCE_FETCH_TIMEOUT_MS),
-  );
-
-  return {
-    evidenceResponse: response.data ?? null,
-    isLoading: response.isLoading,
-    error: response.error,
-    mutate: response.mutate,
-  };
-}

package/src/lib/useGroups.ts

@@ -1,32 +0,0 @@
-import useSWR, { type SWRResponse } from "swr";
-import {
-  InspectorGroupsListResponseSchema,
-  type InspectorGroup,
-  type InspectorGroupsListResponse,
-} from "./groupContract";
-import { fetchJsonWithTimeout } from "./apiClient";
-
-const GROUPS_FETCH_TIMEOUT_MS = 8_000;
-
-type UseGroupsResult = {
-  groups: InspectorGroup[];
-  isLoading: boolean;
-  error: Error | undefined;
-  mutate: SWRResponse<InspectorGroupsListResponse, Error>["mutate"];
-};
-
-export function useGroups(): UseGroupsResult {
-  const response: SWRResponse<InspectorGroupsListResponse, Error> = useSWR<
-    InspectorGroupsListResponse,
-    Error
-  >("/api/groups", (url: string) =>
-    fetchJsonWithTimeout(url, InspectorGroupsListResponseSchema, GROUPS_FETCH_TIMEOUT_MS),
-  );
-
-  return {
-    groups: response.data?.groups ?? [],
-    isLoading: response.isLoading,
-    error: response.error,
-    mutate: response.mutate,
-  };
-}

package/src/lib/useOnboarding.ts

@@ -1,93 +0,0 @@
-import useSWR, { type SWRResponse, useSWRConfig } from "swr";
-import { fetchJson } from "./apiClient";
-import {
-  DEFAULT_CAPTURE_MODE,
-  DEFAULT_PROVIDER_TEST_TIMEOUT_SECONDS,
-  DEFAULT_SLOW_RESPONSE_THRESHOLD_SECONDS,
-  DEFAULT_TIME_DISPLAY_FORMAT,
-  RuntimeConfigSchema,
-  type CaptureMode,
-  type RuntimeConfig,
-} from "./runtimeConfig";
-
-export const ONBOARDING_SWR_KEY = "/api/config";
-
-type RuntimeConfigPatch = Partial<Omit<RuntimeConfig, "captureMode">>;
-
-async function fetcher(url: string): Promise<RuntimeConfig> {
-  return fetchJson(
-    url,
-    RuntimeConfigSchema,
-    undefined,
-    (response) => `Failed to fetch ${url}: ${response.status}`,
-  );
-}
-
-async function patchRuntimeConfig(patch: RuntimeConfigPatch): Promise<RuntimeConfig> {
-  return fetchJson(
-    ONBOARDING_SWR_KEY,
-    RuntimeConfigSchema,
-    {
-      method: "PATCH",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify(patch),
-    },
-    (response) => `PATCH failed with status ${response.status}`,
-  );
-}
-
-export type UseOnboarding = {
-  hasSeenOnboarding: boolean;
-  captureMode: CaptureMode;
-  isLoading: boolean;
-  markSeen: () => Promise<void>;
-};
-
-/**
- * Hook for the first-launch onboarding banner. The server's
- * `hasSeenOnboarding` flag is the source of truth — set to `true` on
- * dismissal and persisted in the server config file so it survives
- * across browser sessions.
- *
- * `hasSeenOnboarding` defaults to `false` until the SWR fetch resolves,
- * which means the banner shows briefly on first load. That is
- * acceptable: the fetch is local and resolves within milliseconds.
- */
-export function useOnboarding(): UseOnboarding {
-  const response: SWRResponse<RuntimeConfig, Error> = useSWR<RuntimeConfig, Error>(
-    ONBOARDING_SWR_KEY,
-    fetcher,
-    {
-      revalidateOnFocus: false,
-      revalidateIfStale: false,
-    },
-  );
-  const { mutate: globalMutate } = useSWRConfig();
-
-  const hasSeenOnboarding = response.data?.hasSeenOnboarding ?? false;
-  const captureMode = response.data?.captureMode ?? DEFAULT_CAPTURE_MODE;
-
-  const markSeen = async (): Promise<void> => {
-    await globalMutate(ONBOARDING_SWR_KEY, patchRuntimeConfig({ hasSeenOnboarding: true }), {
-      optimisticData: {
-        stripClaudeCodeBillingHeader: response.data?.stripClaudeCodeBillingHeader ?? false,
-        hasSeenOnboarding: true,
-        slowResponseThresholdSeconds:
-          response.data?.slowResponseThresholdSeconds ?? DEFAULT_SLOW_RESPONSE_THRESHOLD_SECONDS,
-        providerTestTimeoutSeconds:
-          response.data?.providerTestTimeoutSeconds ?? DEFAULT_PROVIDER_TEST_TIMEOUT_SECONDS,
-        timeDisplayFormat: response.data?.timeDisplayFormat ?? DEFAULT_TIME_DISPLAY_FORMAT,
-        captureMode,
-      },
-      rollbackOnError: true,
-      revalidate: false,
-    });
-  };
-
-  return {
-    hasSeenOnboarding,
-    captureMode,
-    isLoading: response.isLoading,
-    markSeen,
-  };
-}

package/src/lib/useProviders.ts

@@ -1,30 +0,0 @@
-import useSWR, { type SWRResponse } from "swr";
-import { fetchJson } from "./apiClient";
-import { RedactedProviderDtoSchema, type RedactedProviderDto } from "./providerContract";
-
-async function fetcher(url: string): Promise<RedactedProviderDto[]> {
-  return fetchJson(
-    url,
-    RedactedProviderDtoSchema.array(),
-    undefined,
-    (response) => `Failed to fetch ${url}: ${response.status}`,
-  );
-}
-
-export function useProviders() {
-  const response: SWRResponse<RedactedProviderDto[], Error> = useSWR<RedactedProviderDto[], Error>(
-    "/api/providers",
-    fetcher,
-    {
-      revalidateOnFocus: false,
-      revalidateIfStale: false,
-    },
-  );
-
-  return {
-    providers: response.data ?? [],
-    isLoading: response.isLoading,
-    isError: response.error,
-    mutate: response.mutate,
-  };
-}