@tonyclaw/agent-inspector 3.0.44 → 3.0.46

package/src/components/ProxyViewer.tsx

@@ -42,8 +42,12 @@ import {
 } from "lucide-react";
 
 import type { CapturedLog } from "../contracts";
-import { exportLogsAsZip, type ExportMode } from "../lib/export-logs";
 import { withBasePath } from "../lib/basePath";
+import { exportLogsAsZip, type ExportMode } from "../lib/export-logs";
+import {
+  subscribeCodingAgentEndpoints,
+  type CodingAgentEndpoints,
+} from "../lib/codingAgentEndpoints";
 import type { ImportLogsResponse } from "../lib/logImportContract";
 import { copyTextToClipboard } from "../lib/clipboard";
 import type { InspectorGroupEvidence, InspectorGroupMember } from "../lib/groupContract";
@@ -1212,7 +1216,7 @@ function SessionContextBar({
       <div className="flex flex-wrap items-center gap-2">
         {showBackLink && (
           <a
-            href="/"
+            href={withBasePath("/")}
             className="bg-white/[0.035] hover:bg-white/[0.065] inline-flex size-8 shrink-0 items-center justify-center rounded-md text-muted-foreground shadow-[inset_0_0_0_1px_rgba(255,255,255,0.06)] transition-colors hover:text-foreground"
             aria-label="Back to all sessions"
             title="Back to all sessions"
@@ -1384,10 +1388,9 @@ export function ProxyViewer({
   const exportRequestIdRef = useRef(0);
   const detailsPanelResizeRef = useRef<DetailsPanelResizeState | null>(null);
   useKeyboardNavigation(logListRef, logListWrapperRef, { pageWide: true });
-  const proxyEndpoint = useMemo(() => {
-    const origin = typeof window === "undefined" ? "http://localhost:9527" : window.location.origin;
-    return `${origin}${withBasePath("/proxy")}`;
-  }, []);
+  const [connectionEndpoints, setConnectionEndpoints] = useState<CodingAgentEndpoints | null>(null);
+
+  useEffect(() => subscribeCodingAgentEndpoints(setConnectionEndpoints), []);
 
   const cancelTransientTasks = useCallback(() => {
     exportRequestIdRef.current += 1;
@@ -2111,7 +2114,7 @@ export function ProxyViewer({
                           )}
                           {hideSessionFilter ? (
                             <a
-                              href="/"
+                              href={withBasePath("/")}
                               className="inline-flex h-8 items-center rounded-md px-3 text-xs text-muted-foreground underline transition-colors hover:text-foreground focus-visible:ring-1 focus-visible:ring-ring focus-visible:outline-none"
                             >
                               Back to all sessions
@@ -2142,15 +2145,22 @@ export function ProxyViewer({
                         Pick a session from the filter panel to load stored logs on demand.
                       </p>
                     )}
-                    {liveEmptyStateCopy.showConnectionCommands && (
+                    {liveEmptyStateCopy.showConnectionCommands && connectionEndpoints !== null && (
                       <>
                         <div className="flex flex-col items-center gap-2">
                           <CopyableCommand
-                            command={`ANTHROPIC_BASE_URL=${proxyEndpoint} <your-tool>`}
+                            command={`ANTHROPIC_BASE_URL=${connectionEndpoints.proxy} <your-tool>`}
+                          />
+                          <CopyableCommand
+                            command={`LLM_BASE_URL=${connectionEndpoints.proxy} opencode`}
+                          />
+                          <CopyableCommand
+                            command={`OPENAI_BASE_URL=${connectionEndpoints.openAiV1} <your-tool>`}
                           />
                           <CopyableCommand
-                            command={`OPENAI_BASE_URL=${proxyEndpoint} <your-tool>`}
+                            command={`base_url = "${connectionEndpoints.openAiV1}"`}
                           />
+                          <CopyableCommand command={`MCP_URL=${connectionEndpoints.mcp}`} />
                         </div>
                         <p className="mx-auto max-w-xl text-xs leading-relaxed text-muted-foreground">
                           Container note: if your AI tool runs in a different container or host than

package/src/components/ProxyViewerContainer.tsx

@@ -2,7 +2,6 @@ import { useState, useEffect, useCallback, useRef, useMemo, useTransition, type
 import { z } from "zod";
 import { CapturedLogSchema, type CapturedLog } from "../contracts";
 import { fetchJson, fetchJsonWithTimeout } from "../lib/apiClient";
-import { withBasePath } from "../lib/basePath";
 import {
   DeleteInspectorGroupsResponseSchema,
   InspectorGroupsListResponseSchema,
@@ -29,6 +28,7 @@ import {
   reduceLiveConnectionState,
 } from "./proxy-viewer/liveConnectionState";
 import { TransientToast, useTransientToast } from "./ui/transient-toast";
+import { openLogsEventSource } from "../ui/logsStreamClient";
 
 type SSEUpdate =
   | {
@@ -134,15 +134,6 @@ const SESSION_MEMBERSHIP_FETCH_TIMEOUT_MS = 10_000;
 const SSE_RECONNECT_DELAY_MS = 3_000;
 const SSE_STALE_AFTER_MS = 10_000;
 
-function buildLogsStreamUrl(sessionId: string | undefined): string {
-  const params = new URLSearchParams({ compact: "1" });
-  if (sessionId !== undefined) {
-    params.set("sessionId", sessionId);
-  }
-  const query = params.toString();
-  return withBasePath(query.length > 0 ? `/api/logs/stream?${query}` : "/api/logs/stream");
-}
-
 function buildSessionLogsPageUrl(
   sessionId: string,
   request: SessionPageRequest,
@@ -396,7 +387,17 @@ export function ProxyViewerContainer({
       reconnectTimeoutRef.current = null;
     }
     setLiveConnection((state) => reduceLiveConnectionState(state, { type: "connect-requested" }));
-    const es = new EventSource(buildLogsStreamUrl(initialSessionId));
+    const es = openLogsEventSource(initialSessionId);
+    if (es === null) {
+      setLiveConnection((state) =>
+        reduceLiveConnectionState(state, {
+          type: "recoverable-error",
+          message: "The browser runtime does not provide a valid log stream endpoint.",
+        }),
+      );
+      showErrorToast("Failed to resolve the live stream endpoint");
+      return;
+    }
     eventSourceRef.current = es;
 
     es.onmessage = (event: MessageEvent) => {

package/src/components/pi-agent/PiAgentPanel.tsx

@@ -12,7 +12,7 @@ import {
   type PiAgentResponseView,
 } from "./piAgentChatLogic";
 import { useProviders } from "../../lib/useProviders";
-import { withBasePath } from "../../lib/basePath";
+import { fetchControl } from "../../lib/apiClient";
 import { dispatchLogFocusRequest } from "../proxy-viewer/logFocus";
 import { AnswerMarkdown } from "../proxy-viewer/AnswerMarkdown";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../ui/select";
@@ -274,7 +274,7 @@ export function PiAgentPanel({
       logLimit: 16,
     };
 
-    void fetch(withBasePath("/api/pi-agent"), {
+    void fetchControl("/api/pi-agent", {
       method: "POST",
       headers: {
         "content-type": "application/json",

package/src/components/providers/ProviderCard.tsx

@@ -11,7 +11,7 @@ import {
   ChevronDown,
   ChevronRight,
 } from "lucide-react";
-import type { ProviderConfig } from "../../proxy/providers";
+import type { ProviderConfig } from "../../lib/providerContract";
 import {
   findProviderModelMetadata,
   providerHasContextMetadata,

package/src/components/providers/ProviderTestResultsView.tsx

@@ -22,7 +22,7 @@ import type {
   ProviderTestResults as TestResults,
   ProviderTestState,
 } from "../../lib/providerTestContract";
-import type { ProviderConfig } from "../../proxy/providers";
+import type { ProviderConfig } from "../../lib/providerContract";
 import { cn } from "../../lib/utils";
 import {
   Dialog,

package/src/components/providers/SettingsDialog.tsx

@@ -10,7 +10,10 @@ import { useProviders } from "../../lib/useProviders";
 import { useStripConfig } from "../../lib/useStripConfig";
 import { copyTextToClipboard } from "../../lib/clipboard";
 import { fetchJsonWithTimeout } from "../../lib/apiClient";
-import { withBasePath } from "../../lib/basePath";
+import {
+  subscribeCodingAgentEndpoints,
+  type CodingAgentEndpoints,
+} from "../../lib/codingAgentEndpoints";
 import {
   MAX_PROVIDER_TEST_TIMEOUT_SECONDS,
   MAX_SLOW_RESPONSE_THRESHOLD_SECONDS,
@@ -329,10 +332,8 @@ function CopyableSetupValue({
 
 function OnboardingSettingsTab(): JSX.Element {
   const [copiedId, setCopiedId] = useState<string | null>(null);
-  const origin = useMemo(() => {
-    if (typeof window === "undefined") return "http://localhost:9527";
-    return window.location.origin;
-  }, []);
+  const [endpoints, setEndpoints] = useState<CodingAgentEndpoints | null>(null);
+  useEffect(() => subscribeCodingAgentEndpoints(setEndpoints), []);
   const values = useMemo(
     () => [
       { id: "status", label: "Check onboarding", value: "agent-inspector onboard --status" },
@@ -364,11 +365,6 @@ function OnboardingSettingsTab(): JSX.Element {
         value: "agent-inspector onboard --status --opencode-only",
       },
       { id: "opencode-verify", label: "OpenCode verify", value: "opencode mcp list" },
-      {
-        id: "opencode-proxy",
-        label: "OpenCode proxy",
-        value: `LLM_BASE_URL=${origin}${withBasePath("/proxy")}`,
-      },
       {
         id: "mimo-config",
         label: "MiMo Code config",
@@ -380,25 +376,34 @@ function OnboardingSettingsTab(): JSX.Element {
         value: "agent-inspector onboard --status --mimo-only",
       },
       { id: "mimo-verify", label: "MiMo Code verify", value: "mimo mcp list" },
-      {
-        id: "mimo-proxy",
-        label: "MiMo Code proxy",
-        value: `OPENAI_BASE_URL=${origin}${withBasePath("/proxy")}`,
-      },
-      { id: "mcp", label: "MCP URL", value: `${origin}${withBasePath("/api/mcp")}` },
-      { id: "proxy", label: "Proxy URL", value: `${origin}${withBasePath("/proxy")}` },
-      {
-        id: "anthropic",
-        label: "Anthropic base",
-        value: `ANTHROPIC_BASE_URL=${origin}${withBasePath("/proxy")}`,
-      },
-      {
-        id: "openai",
-        label: "OpenAI base",
-        value: `OPENAI_BASE_URL=${origin}${withBasePath("/proxy")}`,
-      },
+      ...(endpoints === null
+        ? []
+        : [
+            {
+              id: "opencode-proxy",
+              label: "OpenCode proxy",
+              value: `LLM_BASE_URL=${endpoints.proxy}`,
+            },
+            {
+              id: "mimo-proxy",
+              label: "MiMo Code proxy",
+              value: `OPENAI_BASE_URL=${endpoints.openAiV1}`,
+            },
+            { id: "mcp", label: "MCP URL", value: endpoints.mcp },
+            { id: "proxy", label: "Proxy URL", value: endpoints.proxy },
+            {
+              id: "anthropic",
+              label: "Anthropic base",
+              value: `ANTHROPIC_BASE_URL=${endpoints.proxy}`,
+            },
+            {
+              id: "openai",
+              label: "OpenAI base",
+              value: `OPENAI_BASE_URL=${endpoints.openAiV1}`,
+            },
+          ]),
     ],
-    [origin],
+    [endpoints],
   );
 
   const handleCopy = useCallback((id: string, value: string) => {
@@ -496,111 +501,117 @@ function OnboardingSettingsTab(): JSX.Element {
 
 function McpSettingsTab(): JSX.Element {
   const [copiedId, setCopiedId] = useState<string | null>(null);
-  const origin = useMemo(() => {
-    if (typeof window === "undefined") return "http://localhost:9527";
-    return window.location.origin;
-  }, []);
-  const endpoint = `${origin}${withBasePath("/api/mcp")}`;
+  const [endpoint, setEndpoint] = useState<string | null>(null);
+  useEffect(
+    () =>
+      subscribeCodingAgentEndpoints((endpoints) => {
+        setEndpoint(endpoints?.mcp ?? null);
+      }),
+    [],
+  );
   const values = useMemo(
-    () => [
-      { id: "mcp-url", label: "Streamable HTTP MCP URL", value: endpoint },
-      {
-        id: "stdio",
-        label: "Stdio bridge command",
-        value: `agent-inspector-mcp stdio --url ${endpoint}`,
-      },
-      {
-        id: "doctor",
-        label: "Bridge doctor",
-        value: `agent-inspector-mcp doctor --url ${endpoint}`,
-      },
-      {
-        id: "writes",
-        label: "Enable write tools",
-        value: "AGENT_INSPECTOR_MCP_WRITES=1 agent-inspector",
-      },
-      {
-        id: "capabilities",
-        label: "Capabilities resource",
-        value: "inspector://mcp/capabilities",
-      },
-      {
-        id: "context",
-        label: "Current context resource",
-        value: "inspector://context/current",
-      },
-      {
-        id: "streamable-json",
-        label: "Streamable HTTP JSON",
-        value: JSON.stringify(
-          {
-            mcpServers: {
-              "agent-inspector": {
-                type: "streamableHttp",
-                url: endpoint,
-              },
+    () =>
+      endpoint === null
+        ? []
+        : [
+            { id: "mcp-url", label: "Streamable HTTP MCP URL", value: endpoint },
+            {
+              id: "stdio",
+              label: "Stdio bridge command",
+              value: `agent-inspector-mcp stdio --url ${endpoint}`,
             },
-          },
-          null,
-          2,
-        ),
-      },
-      {
-        id: "stdio-json",
-        label: "Stdio MCP JSON",
-        value: JSON.stringify(
-          {
-            mcpServers: {
-              "agent-inspector": {
-                command: "agent-inspector-mcp",
-                args: ["stdio", "--url", endpoint],
-              },
+            {
+              id: "doctor",
+              label: "Bridge doctor",
+              value: `agent-inspector-mcp doctor --url ${endpoint}`,
             },
-          },
-          null,
-          2,
-        ),
-      },
-      {
-        id: "opencode-local",
-        label: "OpenCode local MCP",
-        value: JSON.stringify(
-          {
-            mcp: {
-              "agent-inspector": {
-                type: "local",
-                command: ["agent-inspector-mcp", "stdio", "--url", endpoint],
-                enabled: true,
-              },
+            {
+              id: "writes",
+              label: "Enable write tools",
+              value: "AGENT_INSPECTOR_MCP_WRITES=1 agent-inspector",
             },
-          },
-          null,
-          2,
-        ),
-      },
-      {
-        id: "mimo-local",
-        label: "MiMo Code local MCP",
-        value: JSON.stringify(
-          {
-            mcp: {
-              "agent-inspector": {
-                type: "local",
-                command: ["agent-inspector-mcp", "stdio", "--url", endpoint],
-                enabled: true,
-              },
+            {
+              id: "capabilities",
+              label: "Capabilities resource",
+              value: "inspector://mcp/capabilities",
             },
-          },
-          null,
-          2,
-        ),
-      },
-      {
-        id: "codex-toml",
-        label: "Codex TOML",
-        value: `[mcp_servers.agent-inspector]\ncommand = "agent-inspector-mcp"\nargs = ["stdio", "--url", "${endpoint}"]`,
-      },
-    ],
+            {
+              id: "context",
+              label: "Current context resource",
+              value: "inspector://context/current",
+            },
+            {
+              id: "streamable-json",
+              label: "Streamable HTTP JSON",
+              value: JSON.stringify(
+                {
+                  mcpServers: {
+                    "agent-inspector": {
+                      type: "streamableHttp",
+                      url: endpoint,
+                    },
+                  },
+                },
+                null,
+                2,
+              ),
+            },
+            {
+              id: "stdio-json",
+              label: "Stdio MCP JSON",
+              value: JSON.stringify(
+                {
+                  mcpServers: {
+                    "agent-inspector": {
+                      command: "agent-inspector-mcp",
+                      args: ["stdio", "--url", endpoint],
+                    },
+                  },
+                },
+                null,
+                2,
+              ),
+            },
+            {
+              id: "opencode-local",
+              label: "OpenCode local MCP",
+              value: JSON.stringify(
+                {
+                  mcp: {
+                    "agent-inspector": {
+                      type: "local",
+                      command: ["agent-inspector-mcp", "stdio", "--url", endpoint],
+                      enabled: true,
+                    },
+                  },
+                },
+                null,
+                2,
+              ),
+            },
+            {
+              id: "mimo-local",
+              label: "MiMo Code local MCP",
+              value: JSON.stringify(
+                {
+                  mcp: {
+                    "agent-inspector": {
+                      type: "local",
+                      command: ["agent-inspector-mcp", "stdio", "--url", endpoint],
+                      enabled: true,
+                    },
+                  },
+                },
+                null,
+                2,
+              ),
+            },
+            {
+              id: "codex-toml",
+              label: "Codex TOML",
+              value: `[mcp_servers.agent-inspector]\ncommand = "agent-inspector-mcp"\nargs = ["stdio", "--url", "${endpoint}"]`,
+            },
+          ],
     [endpoint],
   );
 
@@ -628,18 +639,27 @@ function McpSettingsTab(): JSX.Element {
           host/IP and verify the network path.
         </div>
       </div>
-      <div className="grid gap-2">
-        {values.map((item) => (
-          <CopyableSetupValue
-            key={item.id}
-            id={item.id}
-            label={item.label}
-            value={item.value}
-            copiedId={copiedId}
-            onCopy={handleCopy}
-          />
-        ))}
-      </div>
+      {endpoint === null ? (
+        <div
+          role="alert"
+          className="rounded-md bg-destructive/10 px-3 py-2 text-xs text-destructive"
+        >
+          The browser runtime does not provide a valid agent-facing MCP endpoint.
+        </div>
+      ) : (
+        <div className="grid gap-2">
+          {values.map((item) => (
+            <CopyableSetupValue
+              key={item.id}
+              id={item.id}
+              label={item.label}
+              value={item.value}
+              copiedId={copiedId}
+              onCopy={handleCopy}
+            />
+          ))}
+        </div>
+      )}
     </div>
   );
 }

package/src/components/proxy-viewer/ApplicationBar.tsx

@@ -1,6 +1,7 @@
 import { Maximize2, Minimize2 } from "lucide-react";
 import { type JSX, type ReactNode, useCallback, useEffect, useState } from "react";
 import packageJson from "../../../package.json";
+import { withBasePath } from "../../lib/basePath";
 import { Button } from "../ui/button";
 import { CrabLogo } from "../ui/crab-logo";
 import { INSPECTOR_ICON_TRIGGER_CLASS } from "../ui/icon-trigger";
@@ -78,7 +79,7 @@ export function ApplicationBar({
     >
       <div className="grid min-w-0 grid-cols-[minmax(0,1fr)_auto] items-center gap-x-3 gap-y-2 sm:grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)]">
         <a
-          href="/"
+          href={withBasePath("/")}
           aria-label="Agent Inspector home"
           className="flex min-w-0 items-center gap-2 rounded-md focus-visible:ring-1 focus-visible:ring-ring focus-visible:outline-none"
         >

package/src/components/proxy-viewer/LogEntry.tsx

@@ -11,7 +11,7 @@ import { ApiTimeoutError, fetchJsonWithTimeout } from "../../lib/apiClient";
 import type { TimeDisplayFormat } from "../../lib/runtimeConfig";
 import { cn } from "../../lib/utils";
 import { LazyFeatureBoundary } from "../errors/SafeErrorBoundary";
-import { stripClaudeCodeBillingHeader } from "../../proxy/claudeCodeStrip";
+import { stripClaudeCodeBillingHeader } from "../../lib/claudeCodeStrip";
 import { Button } from "../ui/button";
 import { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from "../ui/tooltip";
 import { useJsonBulkExpansion } from "../ui/json-viewer-bulk";

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

@@ -1,4 +1,4 @@
-import { apiFormatForPath } from "../../../proxy/formats";
+import { apiFormatForPath } from "../../../lib/apiFormat";
 import type { ApiFormat, CapturedLog } from "../../../contracts";
 import { anthropicLogFormatAdapter } from "./anthropic";
 import { openAILogFormatAdapter } from "./openai";

package/src/contracts/index.ts

@@ -2,15 +2,20 @@ export { JsonValueSchema, trustAsJsonValue } from "./json";
 export type { JsonValue } from "./json";
 
 export {
+  CaptureIncompleteReasonSchema,
   CapturedLogSchema,
   LogBodyChunkSchema,
+  LogIdSchema,
   LogBodyPartSchema,
+  parseLogId,
   StreamingChunkSchema,
 } from "./log";
 export type {
   ApiFormat,
+  CaptureIncompleteReason,
   CapturedLog,
   LogBodyChunk,
+  LogId,
   LogBodyPart,
   StreamingChunk,
   TokenUsage,

package/src/contracts/log.ts

@@ -3,6 +3,32 @@ import { JsonValueSchema } from "./json";
 
 export type ApiFormat = "anthropic" | "openai" | "unknown";
 
+/**
+ * Persisted log ID contract. New captures allocate positive IDs, while zero
+ * remains readable for legacy data. Unsafe integers are never valid IDs.
+ */
+export const LogIdSchema = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+
+export type LogId = z.infer<typeof LogIdSchema>;
+
+/** Parse a decimal path/query/header value using the persisted log ID contract. */
+export function parseLogId(value: string): LogId | null {
+  if (!/^\d+$/.test(value)) return null;
+  const result = LogIdSchema.safeParse(Number(value));
+  return result.success ? result.data : null;
+}
+
+export const CaptureIncompleteReasonSchema = z.enum([
+  "capacity-exceeded",
+  "pipeline-closed",
+  "write-failed",
+  "finalize-failed",
+  "upstream-stream-error",
+  "shutdown",
+]);
+
+export type CaptureIncompleteReason = z.infer<typeof CaptureIncompleteReasonSchema>;
+
 /**
  * A single SSE event from a streaming response.
  */
@@ -24,7 +50,7 @@ export const LogBodyPartSchema = z.enum(["request", "response"]);
 export type LogBodyPart = z.infer<typeof LogBodyPartSchema>;
 
 export const LogBodyChunkSchema = z.object({
-  logId: z.number().int().positive(),
+  logId: LogIdSchema,
   part: LogBodyPartSchema,
   text: z.string(),
   offset: z.number().int().nonnegative(),
@@ -39,7 +65,7 @@ export const LogBodyChunkSchema = z.object({
 export type LogBodyChunk = z.infer<typeof LogBodyChunkSchema>;
 
 export const CapturedLogSchema = z.object({
-  id: z.number(),
+  id: LogIdSchema,
   timestamp: z.string(),
   method: z.string(),
   path: z.string(),
@@ -64,7 +90,7 @@ export const CapturedLogSchema = z.object({
   headers: z.record(z.string(), z.string()).optional(),
   apiFormat: z.enum(["anthropic", "openai", "unknown"]).default("unknown"),
   isTest: z.boolean().optional().default(false),
-  replayOfLogId: z.number().nullable().optional(),
+  replayOfLogId: LogIdSchema.nullable().optional(),
   providerName: z.string().nullable().optional(),
   clientPort: z.number().nullable().optional(),
   clientPid: z.number().nullable().optional(),
@@ -75,6 +101,10 @@ export const CapturedLogSchema = z.object({
   rawRequestBodyBytes: z.number().int().nonnegative().nullable().optional(),
   responseTextBytes: z.number().int().nonnegative().nullable().optional(),
   bodyContentMode: z.enum(["full", "compact", "truncated"]).optional(),
+  captureIncomplete: z.boolean().optional(),
+  droppedChunks: z.number().int().nonnegative().optional(),
+  droppedBytes: z.number().int().nonnegative().optional(),
+  captureIncompleteReason: CaptureIncompleteReasonSchema.nullable().optional(),
   warnings: z.array(z.string()).optional(),
   /** Error message from streaming response (e.g., SSE error event) */
   error: z.string().nullable().optional(),

package/src/knowledge/types.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { LogIdSchema } from "../contracts";
 
 export const KnowledgeCandidateTypeSchema = z.enum([
   "episode",
@@ -16,7 +17,7 @@ export type KnowledgeCandidateStatus = z.infer<typeof KnowledgeCandidateStatusSc
 export const KnowledgeEvidenceSchema = z.object({
   source: z.literal("agent-inspector"),
   sessionId: z.string(),
-  logIds: z.array(z.number().int().positive()),
+  logIds: z.array(LogIdSchema),
   project: z.string().nullable(),
   models: z.array(z.string()),
 });
@@ -36,7 +37,7 @@ export const KnowledgeCandidateSchema = z.object({
   tags: z.array(z.string()),
   source: z.literal("agent-inspector"),
   sessionId: z.string(),
-  logIds: z.array(z.number().int().positive()),
+  logIds: z.array(LogIdSchema),
   evidence: KnowledgeEvidenceSchema,
   status: KnowledgeCandidateStatusSchema,
   createdAt: z.string(),