@contractspec/example.agent-console 3.7.5 → 3.7.7

package/dist/ui/views/index.js

@@ -1,16 +1,69 @@
 // @bun
-// src/ui/hooks/useRunList.ts
-import { useCallback, useEffect, useState } from "react";
+// 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 result = await agent.listAgents({
+        projectId,
+        search: options.search,
+        status: options.status === "all" ? undefined : options.status,
+        limit: options.limit ?? 20,
+        offset: (page - 1) * (options.limit ?? 20)
+      });
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setLoading(false);
+    }
+  }, [agent, projectId, options.search, options.status, options.limit, page]);
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+  const stats = useMemo(() => {
+    if (!data)
+      return null;
+    return {
+      total: data.total,
+      active: data.items.filter((a) => a.status === "ACTIVE").length,
+      paused: data.items.filter((a) => a.status === "PAUSED").length,
+      draft: data.items.filter((a) => a.status === "DRAFT").length
+    };
+  }, [data]);
+  return {
+    data,
+    loading,
+    error,
+    stats,
+    page,
+    refetch: fetchData,
+    nextPage: () => setPage((p) => p + 1),
+    prevPage: () => page > 1 && setPage((p) => p - 1)
+  };
+}
+
+// src/ui/hooks/useRunList.ts
+import { useTemplateRuntime as useTemplateRuntime2 } from "@contractspec/lib.example-shared-ui";
+import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+function useRunList(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime2();
+  const { agent } = handlers;
+  const [data, setData] = useState2(null);
+  const [metrics, setMetrics] = 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 {
@@ -37,7 +90,7 @@ function useRunList(options = {}) {
       setLoading(false);
     }
   }, [agent, projectId, options.agentId, options.status, options.limit, page]);
-  useEffect(() => {
+  useEffect2(() => {
     fetchData();
   }, [fetchData]);
   return {
@@ -54,12 +107,12 @@ function useRunList(options = {}) {
 
 // src/ui/views/RunListView.tsx
 import {
-  StatCard,
-  StatCardGroup,
-  StatusChip,
   EmptyState,
+  ErrorState,
   LoaderBlock,
-  ErrorState
+  StatCard,
+  StatCardGroup,
+  StatusChip
 } from "@contractspec/lib.design-system";
 import { jsxDEV } from "react/jsx-dev-runtime";
 "use client";
@@ -144,45 +197,45 @@ function RunListView({ agentId, onRunClick }) {
         ]
       }, undefined, true, undefined, this),
       /* @__PURE__ */ jsxDEV("div", {
-        className: "border-border rounded-lg border",
+        className: "rounded-lg border border-border",
         children: /* @__PURE__ */ jsxDEV("table", {
           className: "w-full",
           children: [
             /* @__PURE__ */ jsxDEV("thead", {
-              className: "border-border bg-muted/30 border-b",
+              className: "border-border border-b bg-muted/30",
               children: /* @__PURE__ */ jsxDEV("tr", {
                 children: [
                   /* @__PURE__ */ jsxDEV("th", {
-                    className: "text-muted-foreground px-4 py-3 text-left text-sm font-medium",
+                    className: "px-4 py-3 text-left font-medium text-muted-foreground text-sm",
                     children: "Run"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV("th", {
-                    className: "text-muted-foreground px-4 py-3 text-left text-sm font-medium",
+                    className: "px-4 py-3 text-left font-medium text-muted-foreground text-sm",
                     children: "Agent"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV("th", {
-                    className: "text-muted-foreground px-4 py-3 text-left text-sm font-medium",
+                    className: "px-4 py-3 text-left font-medium text-muted-foreground text-sm",
                     children: "Status"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV("th", {
-                    className: "text-muted-foreground px-4 py-3 text-right text-sm font-medium",
+                    className: "px-4 py-3 text-right font-medium text-muted-foreground text-sm",
                     children: "Tokens"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV("th", {
-                    className: "text-muted-foreground px-4 py-3 text-right text-sm font-medium",
+                    className: "px-4 py-3 text-right font-medium text-muted-foreground text-sm",
                     children: "Duration"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV("th", {
-                    className: "text-muted-foreground px-4 py-3 text-right text-sm font-medium",
+                    className: "px-4 py-3 text-right font-medium text-muted-foreground text-sm",
                     children: "Cost"
                   }, undefined, false, undefined, this)
                 ]
               }, undefined, true, undefined, this)
             }, undefined, false, undefined, this),
             /* @__PURE__ */ jsxDEV("tbody", {
-              className: "divide-border divide-y",
+              className: "divide-y divide-border",
               children: data.items.map((run) => /* @__PURE__ */ jsxDEV("tr", {
-                className: "hover:bg-muted/50 cursor-pointer transition-colors",
+                className: "cursor-pointer transition-colors hover:bg-muted/50",
                 onClick: () => onRunClick?.(run.id),
                 children: [
                   /* @__PURE__ */ jsxDEV("td", {
@@ -231,7 +284,7 @@ function RunListView({ agentId, onRunClick }) {
         }, undefined, true, undefined, this)
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsxDEV("div", {
-        className: "text-muted-foreground text-center text-sm",
+        className: "text-center text-muted-foreground text-sm",
         children: [
           "Showing ",
           data.items.length,
@@ -245,16 +298,16 @@ function RunListView({ agentId, onRunClick }) {
 }
 
 // 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";
+import { useTemplateRuntime as useTemplateRuntime3 } from "@contractspec/lib.example-shared-ui";
+import { useCallback as useCallback3, useEffect as useEffect3, useMemo as useMemo2, useState as useState3 } from "react";
 function useToolList(options = {}) {
-  const { handlers, projectId } = useTemplateRuntime2();
+  const { handlers, projectId } = useTemplateRuntime3();
   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 () => {
+  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 {
@@ -281,10 +334,10 @@ function useToolList(options = {}) {
     options.limit,
     page
   ]);
-  useEffect2(() => {
+  useEffect3(() => {
     fetchData();
   }, [fetchData]);
-  const { stats, groupedByCategory, categoryStats } = useMemo(() => {
+  const { stats, groupedByCategory, categoryStats } = useMemo2(() => {
     if (!data)
       return { stats: null, groupedByCategory: {}, categoryStats: [] };
     const items = data.items;
@@ -329,14 +382,14 @@ function useToolList(options = {}) {
 
 // src/ui/views/ToolRegistryView.tsx
 import {
-  StatCard as StatCard2,
-  StatCardGroup as StatCardGroup2,
-  StatusChip as StatusChip2,
-  EntityCard,
+  Button,
   EmptyState as EmptyState2,
-  LoaderBlock as LoaderBlock2,
+  EntityCard,
   ErrorState as ErrorState2,
-  Button
+  LoaderBlock as LoaderBlock2,
+  StatCard as StatCard2,
+  StatCardGroup as StatCardGroup2,
+  StatusChip as StatusChip2
 } from "@contractspec/lib.design-system";
 import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
 "use client";
@@ -416,11 +469,11 @@ function ToolRegistryView({
                 children: categoryIcons[category]
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV2("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: category
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV2("span", {
-                className: "bg-muted text-muted-foreground rounded-full px-2 py-0.5 text-xs",
+                className: "rounded-full bg-muted px-2 py-0.5 text-muted-foreground text-xs",
                 children: tools.length
               }, undefined, false, undefined, this)
             ]
@@ -451,69 +504,16 @@ function ToolRegistryView({
   }, undefined, true, undefined, this);
 }
 
-// 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 {
-      const result = await agent.listAgents({
-        projectId,
-        search: options.search,
-        status: options.status === "all" ? undefined : options.status,
-        limit: options.limit ?? 20,
-        offset: (page - 1) * (options.limit ?? 20)
-      });
-      setData(result);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Unknown error"));
-    } finally {
-      setLoading(false);
-    }
-  }, [agent, projectId, options.search, options.status, options.limit, page]);
-  useEffect3(() => {
-    fetchData();
-  }, [fetchData]);
-  const stats = useMemo2(() => {
-    if (!data)
-      return null;
-    return {
-      total: data.total,
-      active: data.items.filter((a) => a.status === "ACTIVE").length,
-      paused: data.items.filter((a) => a.status === "PAUSED").length,
-      draft: data.items.filter((a) => a.status === "DRAFT").length
-    };
-  }, [data]);
-  return {
-    data,
-    loading,
-    error,
-    stats,
-    page,
-    refetch: fetchData,
-    nextPage: () => setPage((p) => p + 1),
-    prevPage: () => page > 1 && setPage((p) => p - 1)
-  };
-}
-
 // src/ui/views/AgentListView.tsx
 import {
   Button as Button2,
-  StatCard as StatCard3,
-  StatCardGroup as StatCardGroup3,
+  EmptyState as EmptyState3,
   EntityCard as EntityCard2,
-  StatusChip as StatusChip3,
-  LoaderBlock as LoaderBlock3,
   ErrorState as ErrorState3,
-  EmptyState as EmptyState3
+  LoaderBlock as LoaderBlock3,
+  StatCard as StatCard3,
+  StatCardGroup as StatCardGroup3,
+  StatusChip as StatusChip3
 } from "@contractspec/lib.design-system";
 import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
 "use client";
@@ -578,7 +578,7 @@ function AgentListView() {
         className: "flex items-center justify-between",
         children: [
           /* @__PURE__ */ jsxDEV3("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "Agents"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV3(Button2, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.agent-console",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "description": "Agent Console example - AI agent orchestration with tools, runs, and logs",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -477,27 +477,27 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test --pass-with-no-tests",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "3.7.5",
-    "@contractspec/lib.contracts-spec": "3.7.5",
-    "@contractspec/lib.example-shared-ui": "6.0.5",
-    "@contractspec/lib.design-system": "3.7.5",
-    "@contractspec/lib.runtime-sandbox": "2.7.5",
+    "@contractspec/lib.schema": "3.7.6",
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.example-shared-ui": "6.0.7",
+    "@contractspec/lib.design-system": "3.8.0",
+    "@contractspec/lib.runtime-sandbox": "2.7.6",
     "react": "19.2.0",
     "react-dom": "19.2.0"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
     "typescript": "^5.9.3",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.2",
-    "@contractspec/tool.bun": "3.7.5"
+    "@contractspec/tool.bun": "3.7.6"
   },
   "publishConfig": {
     "exports": {

package/src/agent/agent.entity.ts

@@ -1,137 +1,137 @@
 import {
-  defineEntity,
-  defineEntityEnum,
-  field,
-  index,
+	defineEntity,
+	defineEntityEnum,
+	field,
+	index,
 } from '@contractspec/lib.schema';
 
 /**
  * Agent status for lifecycle management.
  */
 export const AgentStatusEntityEnum = defineEntityEnum({
-  name: 'AgentStatus',
-  values: ['DRAFT', 'ACTIVE', 'PAUSED', 'ARCHIVED'],
-  description: 'Lifecycle status of the agent',
+	name: 'AgentStatus',
+	values: ['DRAFT', 'ACTIVE', 'PAUSED', 'ARCHIVED'],
+	description: 'Lifecycle status of the agent',
 });
 
 /**
  * Agent model provider.
  */
 export const ModelProviderEntityEnum = defineEntityEnum({
-  name: 'ModelProvider',
-  values: ['OPENAI', 'ANTHROPIC', 'GOOGLE', 'MISTRAL', 'CUSTOM'],
-  description: 'AI model provider',
+	name: 'ModelProvider',
+	values: ['OPENAI', 'ANTHROPIC', 'GOOGLE', 'MISTRAL', 'CUSTOM'],
+	description: 'AI model provider',
 });
 
 /**
  * Agent entity - Represents an AI agent configuration.
  */
 export const AgentEntity = defineEntity({
-  name: 'Agent',
-  schema: 'agent_console',
-  description:
-    'Represents an AI agent configuration with assigned tools and parameters.',
-  fields: {
-    id: field.id(),
-    organizationId: field.string({
-      description: 'Organization that owns this agent',
-    }),
-    name: field.string({ description: 'Agent name (1-100 chars)' }),
-    slug: field.string({
-      description: 'URL-safe identifier (lowercase, numbers, hyphens)',
-    }),
-    description: field.string({
-      isOptional: true,
-      description: 'Agent description (max 1000 chars)',
-    }),
-    status: field.enum('AgentStatus', { default: 'DRAFT' }),
-    modelProvider: field.enum('ModelProvider', { default: 'OPENAI' }),
-    modelName: field.string({
-      description: "Model identifier: 'gpt-4', 'claude-3-opus', etc.",
-    }),
-    modelConfig: field.json({
-      isOptional: true,
-      description: 'Model parameters: temperature, max_tokens, etc.',
-    }),
-    systemPrompt: field.string({ description: 'System prompt for the agent' }),
-    userPromptTemplate: field.string({
-      isOptional: true,
-      description: 'Template for user prompts',
-    }),
-    toolIds: field.string({
-      isArray: true,
-      isOptional: true,
-      description: 'IDs of assigned tools',
-    }),
-    toolChoice: field.string({
-      default: 'auto',
-      description: "Tool selection mode: 'auto', 'required', 'none'",
-    }),
-    maxIterations: field.int({
-      default: 10,
-      description: 'Maximum iterations per run',
-    }),
-    maxTokensPerRun: field.int({
-      isOptional: true,
-      description: 'Maximum tokens per run',
-    }),
-    timeoutMs: field.int({
-      default: 120000,
-      description: 'Execution timeout in milliseconds',
-    }),
-    version: field.string({ default: '1.0.0', description: 'Agent version' }),
-    tags: field.string({
-      isArray: true,
-      isOptional: true,
-      description: 'Tags for categorization',
-    }),
-    createdAt: field.createdAt(),
-    updatedAt: field.updatedAt(),
-    createdById: field.string({
-      isOptional: true,
-      description: 'User who created this agent',
-    }),
-    tools: field.hasMany('Tool', {
-      description: 'Tools assigned to this agent',
-    }),
-  },
-  indexes: [
-    index.unique(['organizationId', 'slug']),
-    index.on(['organizationId', 'status']),
-    index.on(['modelProvider', 'modelName']),
-  ],
-  enums: [AgentStatusEntityEnum, ModelProviderEntityEnum],
+	name: 'Agent',
+	schema: 'agent_console',
+	description:
+		'Represents an AI agent configuration with assigned tools and parameters.',
+	fields: {
+		id: field.id(),
+		organizationId: field.string({
+			description: 'Organization that owns this agent',
+		}),
+		name: field.string({ description: 'Agent name (1-100 chars)' }),
+		slug: field.string({
+			description: 'URL-safe identifier (lowercase, numbers, hyphens)',
+		}),
+		description: field.string({
+			isOptional: true,
+			description: 'Agent description (max 1000 chars)',
+		}),
+		status: field.enum('AgentStatus', { default: 'DRAFT' }),
+		modelProvider: field.enum('ModelProvider', { default: 'OPENAI' }),
+		modelName: field.string({
+			description: "Model identifier: 'gpt-4', 'claude-3-opus', etc.",
+		}),
+		modelConfig: field.json({
+			isOptional: true,
+			description: 'Model parameters: temperature, max_tokens, etc.',
+		}),
+		systemPrompt: field.string({ description: 'System prompt for the agent' }),
+		userPromptTemplate: field.string({
+			isOptional: true,
+			description: 'Template for user prompts',
+		}),
+		toolIds: field.string({
+			isArray: true,
+			isOptional: true,
+			description: 'IDs of assigned tools',
+		}),
+		toolChoice: field.string({
+			default: 'auto',
+			description: "Tool selection mode: 'auto', 'required', 'none'",
+		}),
+		maxIterations: field.int({
+			default: 10,
+			description: 'Maximum iterations per run',
+		}),
+		maxTokensPerRun: field.int({
+			isOptional: true,
+			description: 'Maximum tokens per run',
+		}),
+		timeoutMs: field.int({
+			default: 120000,
+			description: 'Execution timeout in milliseconds',
+		}),
+		version: field.string({ default: '1.0.0', description: 'Agent version' }),
+		tags: field.string({
+			isArray: true,
+			isOptional: true,
+			description: 'Tags for categorization',
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		createdById: field.string({
+			isOptional: true,
+			description: 'User who created this agent',
+		}),
+		tools: field.hasMany('Tool', {
+			description: 'Tools assigned to this agent',
+		}),
+	},
+	indexes: [
+		index.unique(['organizationId', 'slug']),
+		index.on(['organizationId', 'status']),
+		index.on(['modelProvider', 'modelName']),
+	],
+	enums: [AgentStatusEntityEnum, ModelProviderEntityEnum],
 });
 
 /**
  * AgentTool join entity - Links agents to their assigned tools.
  */
 export const AgentToolEntity = defineEntity({
-  name: 'AgentTool',
-  schema: 'agent_console',
-  description: 'Links an agent to its assigned tools with configuration.',
-  fields: {
-    id: field.id(),
-    agentId: field.foreignKey({ description: 'Agent ID' }),
-    toolId: field.foreignKey({ description: 'Tool ID' }),
-    config: field.json({
-      isOptional: true,
-      description: 'Tool-specific configuration for this agent',
-    }),
-    order: field.int({
-      default: 0,
-      description: 'Order of tool in agent tool list',
-    }),
-    isEnabled: field.boolean({
-      default: true,
-      description: 'Whether tool is enabled for this agent',
-    }),
-    createdAt: field.createdAt(),
-    agent: field.belongsTo('Agent', ['agentId'], ['id']),
-    tool: field.belongsTo('Tool', ['toolId'], ['id']),
-  },
-  indexes: [
-    index.unique(['agentId', 'toolId']),
-    index.on(['agentId', 'order']),
-  ],
+	name: 'AgentTool',
+	schema: 'agent_console',
+	description: 'Links an agent to its assigned tools with configuration.',
+	fields: {
+		id: field.id(),
+		agentId: field.foreignKey({ description: 'Agent ID' }),
+		toolId: field.foreignKey({ description: 'Tool ID' }),
+		config: field.json({
+			isOptional: true,
+			description: 'Tool-specific configuration for this agent',
+		}),
+		order: field.int({
+			default: 0,
+			description: 'Order of tool in agent tool list',
+		}),
+		isEnabled: field.boolean({
+			default: true,
+			description: 'Whether tool is enabled for this agent',
+		}),
+		createdAt: field.createdAt(),
+		agent: field.belongsTo('Agent', ['agentId'], ['id']),
+		tool: field.belongsTo('Tool', ['toolId'], ['id']),
+	},
+	indexes: [
+		index.unique(['agentId', 'toolId']),
+		index.on(['agentId', 'order']),
+	],
 });

package/src/agent/agent.enum.ts

@@ -4,28 +4,28 @@ import { defineEnum } from '@contractspec/lib.schema';
  * Agent status enum.
  */
 export const AgentStatusEnum = defineEnum('AgentStatus', [
-  'DRAFT',
-  'ACTIVE',
-  'PAUSED',
-  'ARCHIVED',
+	'DRAFT',
+	'ACTIVE',
+	'PAUSED',
+	'ARCHIVED',
 ]);
 
 /**
  * Model provider enum.
  */
 export const ModelProviderEnum = defineEnum('ModelProvider', [
-  'OPENAI',
-  'ANTHROPIC',
-  'GOOGLE',
-  'MISTRAL',
-  'CUSTOM',
+	'OPENAI',
+	'ANTHROPIC',
+	'GOOGLE',
+	'MISTRAL',
+	'CUSTOM',
 ]);
 
 /**
  * Tool choice mode enum.
  */
 export const ToolChoiceEnum = defineEnum('ToolChoice', [
-  'auto',
-  'required',
-  'none',
+	'auto',
+	'required',
+	'none',
 ]);