@contractspec/example.agent-console 3.7.6 → 3.8.2

package/dist/browser/ui/hooks/useAgentList.js

@@ -1,6 +1,6 @@
 // src/ui/hooks/useAgentList.ts
-import { useCallback, useEffect, useMemo, useState } from "react";
 import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+import { useCallback, useEffect, useMemo, useState } from "react";
 function useAgentList(options = {}) {
   const { handlers, projectId } = useTemplateRuntime();
   const { agent } = handlers;

package/dist/browser/ui/hooks/useAgentMutations.js

@@ -1,6 +1,438 @@
+// 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/useAgentMutations.ts
-import { useCallback, useState } from "react";
 import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+import { useCallback, useState } 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 } = useTemplateRuntime();
   const { agent } = handlers;
@@ -24,16 +456,16 @@ function useAgentMutations(options = {}) {
     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 = useCallback(async (input) => {
@@ -44,10 +476,10 @@ 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 = useCallback(async (agentId) => {
@@ -65,16 +497,19 @@ function useAgentMutations(options = {}) {
       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 {

package/dist/browser/ui/hooks/useRunList.js

@@ -1,6 +1,6 @@
 // src/ui/hooks/useRunList.ts
-import { useCallback, useEffect, useState } from "react";
 import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+import { useCallback, useEffect, useState } from "react";
 function useRunList(options = {}) {
   const { handlers, projectId } = useTemplateRuntime();
   const { agent } = handlers;
@@ -8,7 +8,10 @@ function useRunList(options = {}) {
   const [metrics, setMetrics] = useState(null);
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState(null);
-  const [page, setPage] = useState(1);
+  const [internalPageIndex, setInternalPageIndex] = useState(0);
+  const pageSize = options.pageSize ?? options.limit ?? 20;
+  const pageIndex = options.pageIndex ?? internalPageIndex;
+  const [sort] = options.sorting ?? [];
   const fetchData = useCallback(async () => {
     setLoading(true);
     setError(null);
@@ -18,14 +21,14 @@ function useRunList(options = {}) {
           projectId,
           agentId: options.agentId,
           status: options.status === "all" ? undefined : options.status,
-          limit: options.limit ?? 20,
-          offset: (page - 1) * (options.limit ?? 20)
+          sortBy: sort?.id,
+          sortDirection: sort ? sort.desc ? "desc" : "asc" : undefined,
+          limit: pageSize,
+          offset: pageIndex * pageSize
         }),
         agent.getRunMetrics({
           projectId,
-          agentId: options.agentId,
-          startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000),
-          endDate: new Date
+          agentId: options.agentId
         })
       ]);
       setData(runsResult);
@@ -35,19 +38,31 @@ function useRunList(options = {}) {
     } finally {
       setLoading(false);
     }
-  }, [agent, projectId, options.agentId, options.status, options.limit, page]);
+  }, [
+    agent,
+    pageIndex,
+    pageSize,
+    projectId,
+    options.agentId,
+    options.status,
+    sort?.desc,
+    sort?.id
+  ]);
   useEffect(() => {
     fetchData();
   }, [fetchData]);
+  const hasControlledPagination = options.pageIndex !== undefined;
   return {
     data,
     metrics,
     loading,
     error,
-    page,
+    page: pageIndex + 1,
+    pageIndex,
+    pageSize,
     refetch: fetchData,
-    nextPage: () => setPage((p) => p + 1),
-    prevPage: () => page > 1 && setPage((p) => p - 1)
+    nextPage: hasControlledPagination ? undefined : () => setInternalPageIndex((current) => current + 1),
+    prevPage: hasControlledPagination ? undefined : () => setInternalPageIndex((current) => Math.max(0, current - 1))
   };
 }
 export {

package/dist/browser/ui/hooks/useToolList.js

@@ -1,6 +1,6 @@
 // src/ui/hooks/useToolList.ts
-import { useCallback, useEffect, useMemo, useState } from "react";
 import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+import { useCallback, useEffect, useMemo, useState } from "react";
 function useToolList(options = {}) {
   const { handlers, projectId } = useTemplateRuntime();
   const { agent } = handlers;