@tonyclaw/agent-inspector 3.0.13 → 3.0.15

package/src/proxy/ecosystemRegistry.ts

@@ -5,6 +5,7 @@ import packageJson from "../../package.json";
 import type {
   EcosystemPackage,
   EcosystemPackageState,
+  EcosystemRecipe,
   EcosystemRunnerPreset,
 } from "../lib/ecosystemContract";
 import { npmSpawnCommand } from "./platformCommands";
@@ -106,6 +107,53 @@ export const RUNNER_PRESETS: EcosystemRunnerPreset[] = [
   },
 ];
 
+export const LAB_RECIPES: EcosystemRecipe[] = [
+  {
+    id: "inspector-mcp-smoke",
+    title: "Inspector MCP smoke",
+    stage: "Validate",
+    packageId: "eval-harness",
+    description: "Check that the running Inspector exposes the MCP tools eval-harness expects.",
+    command: "npx @tonyclaw/eval-harness check-inspector-mcp",
+    requiresSession: false,
+    runnable: true,
+  },
+  {
+    id: "session-evidence-smoke",
+    title: "Session evidence smoke",
+    stage: "Capture",
+    packageId: "eval-harness",
+    description:
+      "Create a lightweight Inspector evidence run from the latest captured logs or selected session.",
+    command:
+      'npx @tonyclaw/eval-harness inspector-smoke --title "TonyClaw Lab smoke" --latest-log-limit 5',
+    requiresSession: false,
+    runnable: true,
+  },
+  {
+    id: "runner-presets-json",
+    title: "Runner presets JSON",
+    stage: "Connect",
+    packageId: "eval-harness",
+    description: "Export runner adapter baselines as machine-readable JSON for CI or docs.",
+    command: "npx @tonyclaw/eval-harness runner-presets --format json",
+    requiresSession: false,
+    runnable: true,
+  },
+  {
+    id: "local-smoke-batch",
+    title: "Local smoke batch",
+    stage: "Evaluate",
+    packageId: "eval-harness",
+    description:
+      "Run one short local Jenkins-like evaluation using explicit project/work directories.",
+    command:
+      "npx @tonyclaw/eval-harness run-once --smoke --project-source <project> --work-source <work> --count 1 --parallel 1",
+    requiresSession: false,
+    runnable: false,
+  },
+];
+
 const NPM_TIMEOUT_MS = 4000;
 
 function runNpm(args: readonly string[]): Promise<NpmResult> {
@@ -242,3 +290,7 @@ export async function listEcosystemPackages(): Promise<EcosystemPackage[]> {
 export function findEcosystemPackage(packageId: string): PackageDefinition | null {
   return ECOSYSTEM_PACKAGES.find((definition) => definition.id === packageId) ?? null;
 }
+
+export function findEcosystemRecipe(recipeId: string): EcosystemRecipe | null {
+  return LAB_RECIPES.find((recipe) => recipe.id === recipeId) ?? null;
+}

package/src/proxy/ecosystemTasks.ts

@@ -6,13 +6,14 @@ import type {
   EcosystemTaskAction,
   EcosystemTaskStatus,
 } from "../lib/ecosystemContract";
-import { findEcosystemPackage } from "./ecosystemRegistry";
+import { findEcosystemPackage, findEcosystemRecipe } from "./ecosystemRegistry";
 import { npmCommand, npmSpawnCommand } from "./platformCommands";
 
 const MAX_TASKS = 50;
 const OUTPUT_LIMIT = 40_000;
 const INSTALL_TIMEOUT_MS = 120_000;
 const HELP_TIMEOUT_MS = 30_000;
+const RECIPE_TIMEOUT_MS = 90_000;
 
 const tasks = new Map<string, EcosystemTask>();
 
@@ -47,7 +48,32 @@ function packageActionArgs(action: EcosystemTaskAction, npmName: string): string
       return ["exec", "--yes", npmName, "--", "--help"];
     case "runner-presets":
       return ["exec", "--yes", "@tonyclaw/eval-harness", "--", "runner-presets"];
+    case "recipe":
+      return ["exec", "--yes", npmName, "--", "--help"];
+  }
+}
+
+function recipeActionArgs(recipeId: string): string[] | null {
+  const execPrefix = ["exec", "--yes", "@tonyclaw/eval-harness", "--"];
+  switch (recipeId) {
+    case "inspector-mcp-smoke":
+      return [...execPrefix, "check-inspector-mcp"];
+    case "session-evidence-smoke":
+      return [
+        ...execPrefix,
+        "inspector-smoke",
+        "--title",
+        "TonyClaw Lab smoke",
+        "--latest-log-limit",
+        "5",
+      ];
+    case "runner-presets-json":
+      return [...execPrefix, "runner-presets", "--format", "json"];
+    case "local-smoke-batch":
+      return null;
   }
+
+  return null;
 }
 
 function packageActionTimeout(action: EcosystemTaskAction): number {
@@ -58,6 +84,8 @@ function packageActionTimeout(action: EcosystemTaskAction): number {
     case "help":
     case "runner-presets":
       return HELP_TIMEOUT_MS;
+    case "recipe":
+      return RECIPE_TIMEOUT_MS;
   }
 }
 
@@ -101,6 +129,7 @@ export function startEcosystemTask(
     id: randomUUID(),
     packageId: definition.id,
     npmName: definition.npmName,
+    recipeId: null,
     action,
     status: "queued",
     command: taskCommand(args),
@@ -151,3 +180,68 @@ export function startEcosystemTask(
 
   return task;
 }
+
+export function startEcosystemRecipeTask(recipeId: string): EcosystemTask | null {
+  const recipe = findEcosystemRecipe(recipeId);
+  if (recipe === null) return null;
+  if (!recipe.runnable) return null;
+  const definition = findEcosystemPackage(recipe.packageId);
+  if (definition === null) return null;
+  const args = recipeActionArgs(recipe.id);
+  if (args === null) return null;
+
+  const task: EcosystemTask = {
+    id: randomUUID(),
+    packageId: definition.id,
+    npmName: definition.npmName,
+    recipeId: recipe.id,
+    action: "recipe",
+    status: "queued",
+    command: taskCommand(args),
+    output: "",
+    createdAt: nowIso(),
+    startedAt: null,
+    finishedAt: null,
+    exitCode: null,
+    error: null,
+  };
+  rememberTask(task);
+
+  const spawnCommand = npmSpawnCommand(args);
+  const child = spawn(spawnCommand.command, spawnCommand.args, {
+    windowsHide: true,
+    shell: false,
+    stdio: ["ignore", "pipe", "pipe"],
+  });
+  const timeout = setTimeout(() => {
+    child.kill();
+    appendTaskOutput(task, `\nTimed out after ${String(RECIPE_TIMEOUT_MS / 1000)}s.\n`);
+  }, RECIPE_TIMEOUT_MS);
+
+  task.status = "running";
+  task.startedAt = nowIso();
+  appendTaskOutput(task, `$ ${task.command}\n`);
+
+  child.stdout.on("data", (chunk: Buffer) => {
+    appendTaskOutput(task, chunk.toString("utf8"));
+  });
+  child.stderr.on("data", (chunk: Buffer) => {
+    appendTaskOutput(task, chunk.toString("utf8"));
+  });
+  child.on("error", (error) => {
+    clearTimeout(timeout);
+    appendTaskOutput(task, `\n${error.message}\n`);
+    completeTask(task, "failed", null, error.message);
+  });
+  child.on("close", (code) => {
+    clearTimeout(timeout);
+    if (task.status === "failed") return;
+    if (code === 0) {
+      completeTask(task, "succeeded", code, null);
+      return;
+    }
+    completeTask(task, "failed", code, `Command exited with code ${String(code ?? "unknown")}`);
+  });
+
+  return task;
+}

package/src/proxy/formats/openai/codexMetadata.ts

@@ -0,0 +1,61 @@
+type CodexClientMetadata = {
+  sessionId: string | null;
+  threadId: string | null;
+  turnId: string | null;
+  installationId: string | null;
+  windowId: string | null;
+};
+
+const EMPTY_CODEX_CLIENT_METADATA: CodexClientMetadata = {
+  sessionId: null,
+  threadId: null,
+  turnId: null,
+  installationId: null,
+  windowId: null,
+};
+
+function readObjectField(value: unknown, field: string): unknown {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return undefined;
+  return Object.getOwnPropertyDescriptor(value, field)?.value;
+}
+
+function readStringField(value: unknown, field: string): string | null {
+  const fieldValue = readObjectField(value, field);
+  return typeof fieldValue === "string" && fieldValue.length > 0 ? fieldValue : null;
+}
+
+function parseNestedTurnMetadata(value: unknown): unknown {
+  if (typeof value !== "string" || value.length === 0) return null;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return null;
+  }
+}
+
+export function extractCodexClientMetadata(rawRequest: unknown): CodexClientMetadata {
+  const clientMetadata = readObjectField(rawRequest, "client_metadata");
+  if (clientMetadata === undefined) return EMPTY_CODEX_CLIENT_METADATA;
+
+  const turnMetadata = parseNestedTurnMetadata(
+    readObjectField(clientMetadata, "x-codex-turn-metadata"),
+  );
+
+  return {
+    sessionId:
+      readStringField(clientMetadata, "session_id") ?? readStringField(turnMetadata, "session_id"),
+    threadId:
+      readStringField(clientMetadata, "thread_id") ?? readStringField(turnMetadata, "thread_id"),
+    turnId: readStringField(clientMetadata, "turn_id") ?? readStringField(turnMetadata, "turn_id"),
+    installationId:
+      readStringField(clientMetadata, "x-codex-installation-id") ??
+      readStringField(turnMetadata, "installation_id"),
+    windowId:
+      readStringField(clientMetadata, "x-codex-window-id") ??
+      readStringField(turnMetadata, "window_id"),
+  };
+}
+
+export function extractCodexSessionId(rawRequest: unknown): string | null {
+  return extractCodexClientMetadata(rawRequest).sessionId;
+}

package/src/proxy/formats/openai/handler.ts

@@ -7,6 +7,7 @@ import {
   parseOpenAIResponse,
 } from "./schemas";
 import { extractOpenAIStream } from "./stream";
+import { extractCodexSessionId } from "./codexMetadata";
 
 function emptyTokens(): TokenUsage {
   return {
@@ -17,6 +18,11 @@ function emptyTokens(): TokenUsage {
   };
 }
 
+function headerSessionId(headers: Headers | undefined): string | null {
+  if (headers === undefined) return null;
+  return headers.get("x-agent-inspector-session-id") ?? headers.get("x-session-affinity");
+}
+
 export const OpenAIFormatHandler: FormatHandler = {
   format: "openai",
 
@@ -27,14 +33,14 @@ export const OpenAIFormatHandler: FormatHandler = {
       if (result.success) {
         return {
           model: result.data.model,
-          sessionId: headers?.get("x-session-affinity") ?? null,
+          sessionId: extractCodexSessionId(json) ?? headerSessionId(headers),
         };
       }
       const responsesResult = OpenAIResponsesRequestSchema.safeParse(json);
       if (responsesResult.success) {
         return {
           model: responsesResult.data.model,
-          sessionId: headers?.get("x-session-affinity") ?? null,
+          sessionId: extractCodexSessionId(json) ?? headerSessionId(headers),
         };
       }
       return null;

package/src/routes/api/ecosystem.packages.ts

@@ -1,5 +1,5 @@
 import { createFileRoute } from "@tanstack/react-router";
-import { listEcosystemPackages, RUNNER_PRESETS } from "../../proxy/ecosystemRegistry";
+import { LAB_RECIPES, listEcosystemPackages, RUNNER_PRESETS } from "../../proxy/ecosystemRegistry";
 
 export const Route = createFileRoute("/api/ecosystem/packages")({
   server: {
@@ -9,6 +9,7 @@ export const Route = createFileRoute("/api/ecosystem/packages")({
           checkedAt: new Date().toISOString(),
           packages: await listEcosystemPackages(),
           runnerPresets: RUNNER_PRESETS,
+          recipes: LAB_RECIPES,
         });
       },
     },

package/src/routes/api/ecosystem.recipes.$recipeId.run.ts

@@ -0,0 +1,16 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { startEcosystemRecipeTask } from "../../proxy/ecosystemTasks";
+
+export const Route = createFileRoute("/api/ecosystem/recipes/$recipeId/run")({
+  server: {
+    handlers: {
+      POST: ({ params }: { params: { recipeId: string } }) => {
+        const task = startEcosystemRecipeTask(params.recipeId);
+        if (task === null) {
+          return Response.json({ error: "Unknown ecosystem recipe" }, { status: 404 });
+        }
+        return Response.json({ task });
+      },
+    },
+  },
+});

package/styles/globals.css

@@ -44,6 +44,8 @@
   --animate-crab-appear: crab-appear 300ms ease-out;
   --animate-crab-settle: crab-settle 400ms ease-in-out;
   --animate-crab-piano-pop: crab-piano-pop 400ms cubic-bezier(0.34, 1.56, 0.64, 1) backwards;
+  --animate-crab-short-leg-body: crab-short-leg-body 720ms ease-in-out infinite;
+  --animate-crab-short-leg-step: crab-short-leg-step 360ms ease-in-out infinite;
 }
 
 :root {
@@ -165,10 +167,42 @@
   }
 }
 
+@keyframes crab-short-leg-body {
+  0%,
+  100% {
+    transform: translateY(0) rotate(-1deg);
+  }
+  25% {
+    transform: translateY(1px) rotate(1.5deg);
+  }
+  50% {
+    transform: translateY(-1px) rotate(-1.5deg);
+  }
+  75% {
+    transform: translateY(1px) rotate(1deg);
+  }
+}
+
+@keyframes crab-short-leg-step {
+  0%,
+  100% {
+    transform: translateY(0) scaleY(0.72) rotate(var(--crab-leg-rest, 0deg));
+    opacity: 0.42;
+  }
+  50% {
+    transform: translateY(3px) scaleY(1.15) rotate(var(--crab-leg-step, 0deg));
+    opacity: 0.9;
+  }
+}
+
 @media (prefers-reduced-motion: reduce) {
   .animate-crab-piano-pop {
     animation: none !important;
   }
+  .floating-crab-body,
+  .floating-crab-leg {
+    animation: none !important;
+  }
 }
 
 [data-deep-link-highlight="true"] {
@@ -205,6 +239,26 @@
 }
 
 @layer utilities {
+  .floating-crab-body {
+    animation: var(--animate-crab-short-leg-body);
+    transform-origin: 50% 74%;
+  }
+
+  .floating-crab-leg {
+    animation: var(--animate-crab-short-leg-step);
+    transform-origin: 50% 0%;
+  }
+
+  .floating-crab-leg-left {
+    --crab-leg-rest: -10deg;
+    --crab-leg-step: 14deg;
+  }
+
+  .floating-crab-leg-right {
+    --crab-leg-rest: 10deg;
+    --crab-leg-step: -14deg;
+  }
+
   .inspector-scrollbar {
     scrollbar-color: color-mix(in srgb, var(--muted-foreground) 32%, transparent) transparent;
     scrollbar-width: thin;