@contractspec/example.agent-console 3.7.6 → 3.8.2

package/dist/ui/hooks/index.js

@@ -1,151 +1,350 @@
 // @bun
-// src/ui/hooks/useRunList.ts
-import { useCallback, useEffect, useState } from "react";
+// src/shared/mock-agents.ts
+var MOCK_AGENTS = [
+  {
+    id: "agent-1",
+    organizationId: "demo-org",
+    name: "Customer Support Bot",
+    slug: "customer-support-bot",
+    description: "Handles tier-1 customer inquiries and routes complex issues.",
+    status: "ACTIVE",
+    modelProvider: "OPENAI",
+    modelName: "gpt-4o-mini",
+    modelConfig: { temperature: 0.7 },
+    systemPrompt: "You are a helpful customer support assistant.",
+    toolChoice: "auto",
+    maxIterations: 10,
+    timeoutMs: 120000,
+    version: "1.0.0",
+    tags: ["support", "tier-1"],
+    createdAt: new Date("2024-01-15T10:00:00Z"),
+    updatedAt: new Date("2024-03-20T14:30:00Z")
+  },
+  {
+    id: "agent-2",
+    organizationId: "demo-org",
+    name: "Code Review Assistant",
+    slug: "code-review-assistant",
+    description: "Reviews pull requests and provides actionable feedback.",
+    status: "ACTIVE",
+    modelProvider: "ANTHROPIC",
+    modelName: "claude-sonnet-4-20250514",
+    modelConfig: { temperature: 0.3 },
+    systemPrompt: "You are a code review expert.",
+    toolChoice: "auto",
+    maxIterations: 15,
+    timeoutMs: 180000,
+    version: "2.1.0",
+    tags: ["code", "review", "dev"],
+    createdAt: new Date("2024-02-10T09:00:00Z"),
+    updatedAt: new Date("2024-04-05T11:15:00Z")
+  },
+  {
+    id: "agent-3",
+    organizationId: "demo-org",
+    name: "Data Analyst",
+    slug: "data-analyst",
+    description: "Queries databases and generates insights from data.",
+    status: "PAUSED",
+    modelProvider: "OPENAI",
+    modelName: "gpt-4o",
+    modelConfig: { temperature: 0.5 },
+    systemPrompt: "You are a data analyst expert in SQL and analytics.",
+    toolChoice: "required",
+    maxIterations: 20,
+    timeoutMs: 300000,
+    version: "1.2.0",
+    tags: ["data", "analytics", "sql"],
+    createdAt: new Date("2024-03-01T08:00:00Z"),
+    updatedAt: new Date("2024-04-10T16:45:00Z")
+  },
+  {
+    id: "agent-4",
+    organizationId: "demo-org",
+    name: "Meeting Scheduler",
+    slug: "meeting-scheduler",
+    description: "Schedules meetings and manages calendar conflicts.",
+    status: "DRAFT",
+    modelProvider: "GOOGLE",
+    modelName: "gemini-2.0-flash",
+    modelConfig: { temperature: 0.2 },
+    systemPrompt: "You help schedule and organize meetings efficiently.",
+    toolChoice: "auto",
+    maxIterations: 5,
+    timeoutMs: 60000,
+    version: "0.1.0",
+    tags: ["calendar", "scheduling"],
+    createdAt: new Date("2024-04-01T12:00:00Z"),
+    updatedAt: new Date("2024-04-01T12:00:00Z")
+  }
+];
+
+// src/shared/mock-tools.ts
+var MOCK_TOOLS = [
+  {
+    id: "tool-1",
+    organizationId: "demo-org",
+    name: "Web Search",
+    slug: "web-search",
+    description: "Search the web for real-time information using Brave API.",
+    category: "RETRIEVAL",
+    status: "ACTIVE",
+    parametersSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Search query" },
+        numResults: { type: "number", default: 10 }
+      },
+      required: ["query"]
+    },
+    outputSchema: { type: "array", items: { type: "object" } },
+    implementationType: "http",
+    implementationConfig: {
+      url: "https://api.brave.com/search",
+      method: "GET"
+    },
+    maxInvocationsPerMinute: 60,
+    timeoutMs: 30000,
+    version: "1.0.0",
+    tags: ["search", "web"],
+    createdAt: new Date("2024-01-01T00:00:00Z"),
+    updatedAt: new Date("2024-02-15T10:00:00Z")
+  },
+  {
+    id: "tool-2",
+    organizationId: "demo-org",
+    name: "SQL Query",
+    slug: "sql-query",
+    description: "Execute read-only SQL queries against the data warehouse.",
+    category: "RETRIEVAL",
+    status: "ACTIVE",
+    parametersSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "SQL query" },
+        maxRows: { type: "number", default: 100 }
+      },
+      required: ["query"]
+    },
+    outputSchema: { type: "object" },
+    implementationType: "function",
+    implementationConfig: { handler: "executeSqlQuery" },
+    maxInvocationsPerMinute: 30,
+    timeoutMs: 60000,
+    version: "1.1.0",
+    tags: ["sql", "database"],
+    createdAt: new Date("2024-01-05T00:00:00Z"),
+    updatedAt: new Date("2024-03-10T14:00:00Z")
+  },
+  {
+    id: "tool-3",
+    organizationId: "demo-org",
+    name: "Email Sender",
+    slug: "email-sender",
+    description: "Send emails via SMTP or API.",
+    category: "COMMUNICATION",
+    status: "ACTIVE",
+    parametersSchema: {
+      type: "object",
+      properties: {
+        to: { type: "string" },
+        subject: { type: "string" },
+        body: { type: "string" }
+      },
+      required: ["to", "subject", "body"]
+    },
+    implementationType: "http",
+    implementationConfig: { url: "/api/send-email", method: "POST" },
+    maxInvocationsPerMinute: 10,
+    timeoutMs: 30000,
+    version: "1.0.0",
+    tags: ["email", "communication"],
+    createdAt: new Date("2024-02-01T00:00:00Z"),
+    updatedAt: new Date("2024-02-01T00:00:00Z")
+  },
+  {
+    id: "tool-4",
+    organizationId: "demo-org",
+    name: "GitHub Integration",
+    slug: "github-integration",
+    description: "Interact with GitHub repositories, PRs, and issues.",
+    category: "INTEGRATION",
+    status: "ACTIVE",
+    parametersSchema: {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["list_prs", "get_pr", "create_comment"]
+        },
+        repo: { type: "string" },
+        params: { type: "object" }
+      },
+      required: ["action", "repo"]
+    },
+    implementationType: "http",
+    implementationConfig: { url: "https://api.github.com", auth: "token" },
+    maxInvocationsPerMinute: 100,
+    timeoutMs: 15000,
+    version: "2.0.0",
+    tags: ["github", "integration", "code"],
+    createdAt: new Date("2024-02-20T00:00:00Z"),
+    updatedAt: new Date("2024-04-01T09:00:00Z")
+  },
+  {
+    id: "tool-5",
+    organizationId: "demo-org",
+    name: "Calculator",
+    slug: "calculator",
+    description: "Perform mathematical calculations.",
+    category: "COMPUTATION",
+    status: "ACTIVE",
+    parametersSchema: {
+      type: "object",
+      properties: {
+        expression: {
+          type: "string",
+          description: "Math expression to evaluate"
+        }
+      },
+      required: ["expression"]
+    },
+    outputSchema: {
+      type: "object",
+      properties: { result: { type: "number" } }
+    },
+    implementationType: "function",
+    implementationConfig: { handler: "evaluateMath" },
+    timeoutMs: 5000,
+    version: "1.0.0",
+    tags: ["math", "utility"],
+    createdAt: new Date("2024-01-10T00:00:00Z"),
+    updatedAt: new Date("2024-01-10T00:00:00Z")
+  }
+];
+
+// src/shared/mock-runs.ts
+var MOCK_RUNS = [
+  {
+    id: "run-1",
+    organizationId: "demo-org",
+    projectId: "demo-project",
+    agentId: "agent-1",
+    agentName: "Customer Support Bot",
+    userId: "user-1",
+    sessionId: "session-1",
+    input: { message: "How do I reset my password?", context: {} },
+    output: { response: "You can reset your password by clicking..." },
+    status: "COMPLETED",
+    totalTokens: 1250,
+    promptTokens: 800,
+    completionTokens: 450,
+    totalIterations: 3,
+    durationMs: 4500,
+    estimatedCostUsd: 0.0025,
+    queuedAt: new Date("2024-04-15T10:00:00Z"),
+    startedAt: new Date("2024-04-15T10:00:01Z"),
+    completedAt: new Date("2024-04-15T10:00:05Z"),
+    steps: [],
+    logs: []
+  },
+  {
+    id: "run-2",
+    organizationId: "demo-org",
+    projectId: "demo-project",
+    agentId: "agent-2",
+    agentName: "Code Review Assistant",
+    userId: "user-2",
+    input: { message: "Review PR #123", context: { prNumber: 123 } },
+    status: "IN_PROGRESS",
+    totalTokens: 3500,
+    promptTokens: 3000,
+    completionTokens: 500,
+    totalIterations: 5,
+    queuedAt: new Date("2024-04-15T10:30:00Z"),
+    startedAt: new Date("2024-04-15T10:30:02Z"),
+    steps: [],
+    logs: []
+  },
+  {
+    id: "run-3",
+    organizationId: "demo-org",
+    projectId: "demo-project",
+    agentId: "agent-1",
+    agentName: "Customer Support Bot",
+    userId: "user-1",
+    input: { message: "What are your business hours?" },
+    output: { response: "Our business hours are 9 AM to 5 PM EST..." },
+    status: "COMPLETED",
+    totalTokens: 800,
+    promptTokens: 500,
+    completionTokens: 300,
+    totalIterations: 2,
+    durationMs: 2100,
+    estimatedCostUsd: 0.0012,
+    queuedAt: new Date("2024-04-15T09:00:00Z"),
+    startedAt: new Date("2024-04-15T09:00:01Z"),
+    completedAt: new Date("2024-04-15T09:00:03Z"),
+    steps: [],
+    logs: []
+  },
+  {
+    id: "run-4",
+    organizationId: "demo-org",
+    projectId: "demo-project",
+    agentId: "agent-3",
+    agentName: "Data Analyst",
+    userId: "user-3",
+    input: { message: "Generate sales report for Q1" },
+    status: "FAILED",
+    errorMessage: "Database connection timeout",
+    errorCode: "DB_TIMEOUT",
+    totalTokens: 2000,
+    promptTokens: 1500,
+    completionTokens: 500,
+    totalIterations: 8,
+    durationMs: 45000,
+    queuedAt: new Date("2024-04-14T15:00:00Z"),
+    startedAt: new Date("2024-04-14T15:00:05Z"),
+    completedAt: new Date("2024-04-14T15:00:50Z"),
+    steps: [],
+    logs: []
+  },
+  {
+    id: "run-5",
+    organizationId: "demo-org",
+    projectId: "demo-project",
+    agentId: "agent-2",
+    agentName: "Code Review Assistant",
+    userId: "user-2",
+    input: { message: "Review PR #120" },
+    output: { response: "Code review complete. 3 suggestions..." },
+    status: "COMPLETED",
+    totalTokens: 5200,
+    promptTokens: 4000,
+    completionTokens: 1200,
+    totalIterations: 7,
+    durationMs: 15000,
+    estimatedCostUsd: 0.0156,
+    queuedAt: new Date("2024-04-14T11:00:00Z"),
+    startedAt: new Date("2024-04-14T11:00:03Z"),
+    completedAt: new Date("2024-04-14T11:00:18Z"),
+    steps: [],
+    logs: []
+  }
+];
+
+// src/ui/hooks/useAgentList.ts
 import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
-function useRunList(options = {}) {
+import { useCallback, useEffect, useMemo, useState } from "react";
+function useAgentList(options = {}) {
   const { handlers, projectId } = useTemplateRuntime();
   const { agent } = handlers;
   const [data, setData] = useState(null);
-  const [metrics, setMetrics] = useState(null);
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState(null);
   const [page, setPage] = useState(1);
   const fetchData = useCallback(async () => {
-    setLoading(true);
-    setError(null);
-    try {
-      const [runsResult, metricsResult] = await Promise.all([
-        agent.listRuns({
-          projectId,
-          agentId: options.agentId,
-          status: options.status === "all" ? undefined : options.status,
-          limit: options.limit ?? 20,
-          offset: (page - 1) * (options.limit ?? 20)
-        }),
-        agent.getRunMetrics({
-          projectId,
-          agentId: options.agentId,
-          startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000),
-          endDate: new Date
-        })
-      ]);
-      setData(runsResult);
-      setMetrics(metricsResult);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Unknown error"));
-    } finally {
-      setLoading(false);
-    }
-  }, [agent, projectId, options.agentId, options.status, options.limit, page]);
-  useEffect(() => {
-    fetchData();
-  }, [fetchData]);
-  return {
-    data,
-    metrics,
-    loading,
-    error,
-    page,
-    refetch: fetchData,
-    nextPage: () => setPage((p) => p + 1),
-    prevPage: () => page > 1 && setPage((p) => p - 1)
-  };
-}
-
-// src/ui/hooks/useToolList.ts
-import { useCallback as useCallback2, useEffect as useEffect2, useMemo, useState as useState2 } from "react";
-import { useTemplateRuntime as useTemplateRuntime2 } from "@contractspec/lib.example-shared-ui";
-function useToolList(options = {}) {
-  const { handlers, projectId } = useTemplateRuntime2();
-  const { agent } = handlers;
-  const [data, setData] = useState2(null);
-  const [loading, setLoading] = useState2(true);
-  const [error, setError] = useState2(null);
-  const [page, setPage] = useState2(1);
-  const fetchData = useCallback2(async () => {
-    setLoading(true);
-    setError(null);
-    try {
-      const result = await agent.listTools({
-        projectId,
-        search: options.search,
-        category: options.category,
-        status: options.status === "all" ? undefined : options.status,
-        limit: options.limit ?? 50,
-        offset: (page - 1) * (options.limit ?? 50)
-      });
-      setData(result);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Unknown error"));
-    } finally {
-      setLoading(false);
-    }
-  }, [
-    agent,
-    projectId,
-    options.search,
-    options.category,
-    options.status,
-    options.limit,
-    page
-  ]);
-  useEffect2(() => {
-    fetchData();
-  }, [fetchData]);
-  const { stats, groupedByCategory, categoryStats } = useMemo(() => {
-    if (!data)
-      return { stats: null, groupedByCategory: {}, categoryStats: [] };
-    const items = data.items;
-    const active = items.filter((t) => t.status === "ACTIVE").length;
-    const deprecated = items.filter((t) => t.status === "DEPRECATED").length;
-    const disabled = items.filter((t) => t.status === "DISABLED").length;
-    const grouped = {};
-    const byCategory = {};
-    items.forEach((t) => {
-      const cat = t.category;
-      if (!grouped[cat])
-        grouped[cat] = [];
-      grouped[cat].push(t);
-      byCategory[cat] = (byCategory[cat] || 0) + 1;
-    });
-    const catStats = Object.entries(byCategory).map(([category, count]) => ({ category, count })).sort((a, b) => b.count - a.count);
-    return {
-      stats: {
-        total: data.total,
-        active,
-        deprecated,
-        disabled,
-        topCategories: catStats.slice(0, 5)
-      },
-      groupedByCategory: grouped,
-      categoryStats: catStats
-    };
-  }, [data]);
-  return {
-    data,
-    loading,
-    error,
-    stats,
-    groupedByCategory,
-    categoryStats,
-    page,
-    refetch: fetchData,
-    nextPage: () => setPage((p) => p + 1),
-    prevPage: () => page > 1 && setPage((p) => p - 1)
-  };
-}
-
-// src/ui/hooks/useAgentList.ts
-import { useCallback as useCallback3, useEffect as useEffect3, useMemo as useMemo2, useState as useState3 } from "react";
-import { useTemplateRuntime as useTemplateRuntime3 } from "@contractspec/lib.example-shared-ui";
-function useAgentList(options = {}) {
-  const { handlers, projectId } = useTemplateRuntime3();
-  const { agent } = handlers;
-  const [data, setData] = useState3(null);
-  const [loading, setLoading] = useState3(true);
-  const [error, setError] = useState3(null);
-  const [page, setPage] = useState3(1);
-  const fetchData = useCallback3(async () => {
     setLoading(true);
     setError(null);
     try {
@@ -163,10 +362,10 @@ function useAgentList(options = {}) {
       setLoading(false);
     }
   }, [agent, projectId, options.search, options.status, options.limit, page]);
-  useEffect3(() => {
+  useEffect(() => {
     fetchData();
   }, [fetchData]);
-  const stats = useMemo2(() => {
+  const stats = useMemo(() => {
     if (!data)
       return null;
     return {
@@ -189,44 +388,141 @@ function useAgentList(options = {}) {
 }
 
 // src/ui/hooks/useAgentMutations.ts
-import { useCallback as useCallback4, useState as useState4 } from "react";
-import { useTemplateRuntime as useTemplateRuntime4 } from "@contractspec/lib.example-shared-ui";
+import { useTemplateRuntime as useTemplateRuntime2 } from "@contractspec/lib.example-shared-ui";
+import { useCallback as useCallback2, useState as useState2 } from "react";
+
+// src/shared/demo-runtime-seed.ts
+var AGENT_CONSOLE_DEMO_ORGANIZATION_ID = "demo-org";
+var AGENT_CONSOLE_DEMO_PROJECT_ID = "agent-console-demo";
+function slugify(name) {
+  return name.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function cloneAgent(agent) {
+  return { ...agent };
+}
+function cloneTool(tool) {
+  return { ...tool };
+}
+function cloneRun(run) {
+  return { ...run };
+}
+function createDefaultNow() {
+  let tick = 0;
+  const base = Date.parse("2026-03-20T09:00:00.000Z");
+  return () => new Date(base + tick++ * 60000);
+}
+function normalizeProvider(provider) {
+  return provider.toLowerCase();
+}
+function normalizeRunStatus(status) {
+  return status === "IN_PROGRESS" ? "RUNNING" : status;
+}
+function createSeedState(projectId, organizationId) {
+  const agents = MOCK_AGENTS.map((agent) => ({
+    id: agent.id,
+    projectId,
+    organizationId,
+    name: agent.name,
+    slug: agent.slug,
+    description: agent.description,
+    modelProvider: normalizeProvider(agent.modelProvider),
+    modelName: agent.modelName,
+    systemPrompt: agent.systemPrompt,
+    temperature: typeof agent.modelConfig?.temperature === "number" ? agent.modelConfig.temperature : 0.4,
+    maxTokens: 8192,
+    status: agent.status,
+    createdAt: agent.createdAt,
+    updatedAt: agent.updatedAt
+  }));
+  const tools = MOCK_TOOLS.map((tool) => ({
+    id: tool.id,
+    projectId,
+    organizationId,
+    name: tool.name,
+    description: tool.description,
+    version: tool.version,
+    category: tool.category,
+    status: tool.status,
+    inputSchema: JSON.stringify(tool.parametersSchema),
+    outputSchema: tool.outputSchema ? JSON.stringify(tool.outputSchema) : undefined,
+    endpoint: typeof tool.implementationConfig?.url === "string" ? tool.implementationConfig.url : undefined,
+    createdAt: tool.createdAt,
+    updatedAt: tool.updatedAt
+  }));
+  const agentNames = new Map(agents.map((agent) => [agent.id, agent.name]));
+  const runs = MOCK_RUNS.map((run) => ({
+    id: run.id,
+    projectId,
+    agentId: run.agentId,
+    agentName: agentNames.get(run.agentId) ?? run.agentName ?? "Unknown agent",
+    status: normalizeRunStatus(run.status),
+    input: JSON.stringify(run.input),
+    output: run.output ? JSON.stringify(run.output) : undefined,
+    totalTokens: run.totalTokens,
+    promptTokens: run.promptTokens,
+    completionTokens: run.completionTokens,
+    estimatedCostUsd: run.estimatedCostUsd ?? 0,
+    durationMs: run.durationMs,
+    errorMessage: run.errorMessage,
+    queuedAt: run.queuedAt,
+    startedAt: run.startedAt,
+    completedAt: run.completedAt
+  }));
+  return { agents, tools, runs };
+}
+function summarizeRunMetrics(runs) {
+  const totalRuns = runs.length;
+  const completedRuns = runs.filter((run) => run.status === "COMPLETED").length;
+  const completedDurations = runs.map((run) => run.durationMs).filter((duration) => typeof duration === "number");
+  return {
+    totalRuns,
+    successRate: totalRuns === 0 ? 0 : completedRuns / totalRuns,
+    averageDurationMs: completedDurations.length === 0 ? 0 : Math.round(completedDurations.reduce((sum, duration) => sum + duration, 0) / completedDurations.length),
+    totalTokens: runs.reduce((sum, run) => sum + run.totalTokens, 0),
+    totalCostUsd: runs.reduce((sum, run) => sum + run.estimatedCostUsd, 0)
+  };
+}
+
+// src/ui/hooks/useAgentMutations.ts
+function normalizeMutationError(error, fallbackMessage) {
+  return error instanceof Error ? error : new Error(fallbackMessage);
+}
 function useAgentMutations(options = {}) {
-  const { handlers, projectId } = useTemplateRuntime4();
+  const { handlers, projectId } = useTemplateRuntime2();
   const { agent } = handlers;
-  const [createState, setCreateState] = useState4({
+  const [createState, setCreateState] = useState2({
     loading: false,
     error: null,
     data: null
   });
-  const [updateState, setUpdateState] = useState4({
+  const [updateState, setUpdateState] = useState2({
     loading: false,
     error: null,
     data: null
   });
-  const [executeState, setExecuteState] = useState4({
+  const [executeState, setExecuteState] = useState2({
     loading: false,
     error: null,
     data: null
   });
-  const createAgent = useCallback4(async (input) => {
+  const createAgent = useCallback2(async (input) => {
     setCreateState({ loading: true, error: null, data: null });
     try {
       const result = await agent.createAgent(input, {
         projectId,
-        organizationId: "demo-org"
+        organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID
       });
       setCreateState({ loading: false, error: null, data: result });
       options.onSuccess?.();
       return result;
     } catch (err) {
-      const error = err instanceof Error ? err : new Error("Failed to create agent");
+      const error = normalizeMutationError(err, "Failed to create agent");
       setCreateState({ loading: false, error, data: null });
       options.onError?.(error);
-      return null;
+      throw error;
     }
   }, [agent, projectId, options]);
-  const updateAgent = useCallback4(async (input) => {
+  const updateAgent = useCallback2(async (input) => {
     setUpdateState({ loading: true, error: null, data: null });
     try {
       const result = await agent.updateAgent(input);
@@ -234,37 +530,40 @@ function useAgentMutations(options = {}) {
       options.onSuccess?.();
       return result;
     } catch (err) {
-      const error = err instanceof Error ? err : new Error("Failed to update agent");
+      const error = normalizeMutationError(err, "Failed to update agent");
       setUpdateState({ loading: false, error, data: null });
       options.onError?.(error);
-      return null;
+      throw error;
     }
   }, [agent, options]);
-  const activateAgent = useCallback4(async (agentId) => {
+  const activateAgent = useCallback2(async (agentId) => {
     return updateAgent({ id: agentId, status: "ACTIVE" });
   }, [updateAgent]);
-  const pauseAgent = useCallback4(async (agentId) => {
+  const pauseAgent = useCallback2(async (agentId) => {
     return updateAgent({ id: agentId, status: "PAUSED" });
   }, [updateAgent]);
-  const archiveAgent = useCallback4(async (agentId) => {
+  const archiveAgent = useCallback2(async (agentId) => {
     return updateAgent({ id: agentId, status: "ARCHIVED" });
   }, [updateAgent]);
-  const executeAgent = useCallback4(async (input) => {
+  const executeAgent = useCallback2(async (input) => {
     setExecuteState({ loading: true, error: null, data: null });
     try {
       const result = await agent.executeAgent({
         agentId: input.agentId,
         message: input.message,
-        context: { projectId, organizationId: "demo-org" }
+        context: {
+          projectId,
+          organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID
+        }
       });
       setExecuteState({ loading: false, error: null, data: result });
       options.onSuccess?.();
       return result;
     } catch (err) {
-      const error = err instanceof Error ? err : new Error("Failed to execute agent");
+      const error = normalizeMutationError(err, "Failed to execute agent");
       setExecuteState({ loading: false, error, data: null });
       options.onError?.(error);
-      return null;
+      throw error;
     }
   }, [agent, projectId, options]);
   return {
@@ -281,6 +580,157 @@ function useAgentMutations(options = {}) {
   };
 }
 
+// src/ui/hooks/useRunList.ts
+import { useTemplateRuntime as useTemplateRuntime3 } from "@contractspec/lib.example-shared-ui";
+import { useCallback as useCallback3, useEffect as useEffect2, useState as useState3 } from "react";
+function useRunList(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime3();
+  const { agent } = handlers;
+  const [data, setData] = useState3(null);
+  const [metrics, setMetrics] = useState3(null);
+  const [loading, setLoading] = useState3(true);
+  const [error, setError] = useState3(null);
+  const [internalPageIndex, setInternalPageIndex] = useState3(0);
+  const pageSize = options.pageSize ?? options.limit ?? 20;
+  const pageIndex = options.pageIndex ?? internalPageIndex;
+  const [sort] = options.sorting ?? [];
+  const fetchData = useCallback3(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const [runsResult, metricsResult] = await Promise.all([
+        agent.listRuns({
+          projectId,
+          agentId: options.agentId,
+          status: options.status === "all" ? undefined : options.status,
+          sortBy: sort?.id,
+          sortDirection: sort ? sort.desc ? "desc" : "asc" : undefined,
+          limit: pageSize,
+          offset: pageIndex * pageSize
+        }),
+        agent.getRunMetrics({
+          projectId,
+          agentId: options.agentId
+        })
+      ]);
+      setData(runsResult);
+      setMetrics(metricsResult);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setLoading(false);
+    }
+  }, [
+    agent,
+    pageIndex,
+    pageSize,
+    projectId,
+    options.agentId,
+    options.status,
+    sort?.desc,
+    sort?.id
+  ]);
+  useEffect2(() => {
+    fetchData();
+  }, [fetchData]);
+  const hasControlledPagination = options.pageIndex !== undefined;
+  return {
+    data,
+    metrics,
+    loading,
+    error,
+    page: pageIndex + 1,
+    pageIndex,
+    pageSize,
+    refetch: fetchData,
+    nextPage: hasControlledPagination ? undefined : () => setInternalPageIndex((current) => current + 1),
+    prevPage: hasControlledPagination ? undefined : () => setInternalPageIndex((current) => Math.max(0, current - 1))
+  };
+}
+
+// src/ui/hooks/useToolList.ts
+import { useTemplateRuntime as useTemplateRuntime4 } from "@contractspec/lib.example-shared-ui";
+import { useCallback as useCallback4, useEffect as useEffect3, useMemo as useMemo2, useState as useState4 } from "react";
+function useToolList(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime4();
+  const { agent } = handlers;
+  const [data, setData] = useState4(null);
+  const [loading, setLoading] = useState4(true);
+  const [error, setError] = useState4(null);
+  const [page, setPage] = useState4(1);
+  const fetchData = useCallback4(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await agent.listTools({
+        projectId,
+        search: options.search,
+        category: options.category,
+        status: options.status === "all" ? undefined : options.status,
+        limit: options.limit ?? 50,
+        offset: (page - 1) * (options.limit ?? 50)
+      });
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setLoading(false);
+    }
+  }, [
+    agent,
+    projectId,
+    options.search,
+    options.category,
+    options.status,
+    options.limit,
+    page
+  ]);
+  useEffect3(() => {
+    fetchData();
+  }, [fetchData]);
+  const { stats, groupedByCategory, categoryStats } = useMemo2(() => {
+    if (!data)
+      return { stats: null, groupedByCategory: {}, categoryStats: [] };
+    const items = data.items;
+    const active = items.filter((t) => t.status === "ACTIVE").length;
+    const deprecated = items.filter((t) => t.status === "DEPRECATED").length;
+    const disabled = items.filter((t) => t.status === "DISABLED").length;
+    const grouped = {};
+    const byCategory = {};
+    items.forEach((t) => {
+      const cat = t.category;
+      if (!grouped[cat])
+        grouped[cat] = [];
+      grouped[cat].push(t);
+      byCategory[cat] = (byCategory[cat] || 0) + 1;
+    });
+    const catStats = Object.entries(byCategory).map(([category, count]) => ({ category, count })).sort((a, b) => b.count - a.count);
+    return {
+      stats: {
+        total: data.total,
+        active,
+        deprecated,
+        disabled,
+        topCategories: catStats.slice(0, 5)
+      },
+      groupedByCategory: grouped,
+      categoryStats: catStats
+    };
+  }, [data]);
+  return {
+    data,
+    loading,
+    error,
+    stats,
+    groupedByCategory,
+    categoryStats,
+    page,
+    refetch: fetchData,
+    nextPage: () => setPage((p) => p + 1),
+    prevPage: () => page > 1 && setPage((p) => p - 1)
+  };
+}
+
 // src/ui/hooks/index.ts
 "use client";
 export {