@contractspec/example.agent-console 1.46.1 → 1.47.0

package/dist/ui/hooks/useAgentMutations.js

@@ -0,0 +1,124 @@
+import { useCallback, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+
+//#region src/ui/hooks/useAgentMutations.ts
+/**
+* Hook for Agent Console mutations (commands)
+*
+* Uses runtime-local database-backed handlers for:
+* - CreateAgentCommand
+* - UpdateAgentCommand
+*/
+function useAgentMutations(options = {}) {
+	const { handlers, projectId } = useTemplateRuntime();
+	const { agent } = handlers;
+	const [createState, setCreateState] = useState({
+		loading: false,
+		error: null,
+		data: null
+	});
+	const [updateState, setUpdateState] = useState({
+		loading: false,
+		error: null,
+		data: null
+	});
+	/**
+	* Create a new agent
+	*/
+	const createAgent = useCallback(async (input) => {
+		setCreateState({
+			loading: true,
+			error: null,
+			data: null
+		});
+		try {
+			const result = await agent.createAgent(input, {
+				projectId,
+				organizationId: "demo-org"
+			});
+			setCreateState({
+				loading: false,
+				error: null,
+				data: result
+			});
+			options.onSuccess?.();
+			return result;
+		} catch (err) {
+			const error = err instanceof Error ? err : /* @__PURE__ */ new Error("Failed to create agent");
+			setCreateState({
+				loading: false,
+				error,
+				data: null
+			});
+			options.onError?.(error);
+			return null;
+		}
+	}, [
+		agent,
+		projectId,
+		options
+	]);
+	/**
+	* Update an agent (name, status)
+	*/
+	const updateAgent = useCallback(async (input) => {
+		setUpdateState({
+			loading: true,
+			error: null,
+			data: null
+		});
+		try {
+			const result = await agent.updateAgent(input);
+			setUpdateState({
+				loading: false,
+				error: null,
+				data: result
+			});
+			options.onSuccess?.();
+			return result;
+		} catch (err) {
+			const error = err instanceof Error ? err : /* @__PURE__ */ new Error("Failed to update agent");
+			setUpdateState({
+				loading: false,
+				error,
+				data: null
+			});
+			options.onError?.(error);
+			return null;
+		}
+	}, [agent, options]);
+	return {
+		createAgent,
+		updateAgent,
+		activateAgent: useCallback(async (agentId) => {
+			return updateAgent({
+				id: agentId,
+				status: "ACTIVE"
+			});
+		}, [updateAgent]),
+		pauseAgent: useCallback(async (agentId) => {
+			return updateAgent({
+				id: agentId,
+				status: "PAUSED"
+			});
+		}, [updateAgent]),
+		archiveAgent: useCallback(async (agentId) => {
+			return updateAgent({
+				id: agentId,
+				status: "ARCHIVED"
+			});
+		}, [updateAgent]),
+		executeAgent: useCallback(async (input) => {
+			console.log("Execute agent:", input);
+			options.onSuccess?.();
+			return null;
+		}, [options]),
+		createState,
+		updateState,
+		isLoading: createState.loading || updateState.loading
+	};
+}
+
+//#endregion
+export { useAgentMutations };
+//# sourceMappingURL=useAgentMutations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentMutations.js","names":[],"sources":["../../../src/ui/hooks/useAgentMutations.ts"],"sourcesContent":["/**\n * Hook for Agent Console mutations (commands)\n *\n * Uses runtime-local database-backed handlers for:\n * - CreateAgentCommand\n * - UpdateAgentCommand\n */\nimport { useCallback, useState } from 'react';\nimport { useTemplateRuntime } from '@contractspec/lib.example-shared-ui';\nimport type {\n  Agent,\n  CreateAgentInput,\n  UpdateAgentInput,\n  AgentHandlers,\n} from '../../handlers/agent.handlers';\n\nexport interface MutationState<T> {\n  loading: boolean;\n  error: Error | null;\n  data: T | null;\n}\n\nexport interface UseAgentMutationsOptions {\n  onSuccess?: () => void;\n  onError?: (error: Error) => void;\n}\n\nexport function useAgentMutations(options: UseAgentMutationsOptions = {}) {\n  const { handlers, projectId } = useTemplateRuntime<{\n    agent: AgentHandlers;\n  }>();\n  const { agent } = handlers;\n\n  const [createState, setCreateState] = useState<MutationState<Agent>>({\n    loading: false,\n    error: null,\n    data: null,\n  });\n\n  const [updateState, setUpdateState] = useState<MutationState<Agent>>({\n    loading: false,\n    error: null,\n    data: null,\n  });\n\n  /**\n   * Create a new agent\n   */\n  const createAgent = useCallback(\n    async (input: CreateAgentInput): Promise<Agent | null> => {\n      setCreateState({ loading: true, error: null, data: null });\n      try {\n        const result = await agent.createAgent(input, {\n          projectId,\n          organizationId: 'demo-org',\n        });\n        setCreateState({ loading: false, error: null, data: result });\n        options.onSuccess?.();\n        return result;\n      } catch (err) {\n        const error =\n          err instanceof Error ? err : new Error('Failed to create agent');\n        setCreateState({ loading: false, error, data: null });\n        options.onError?.(error);\n        return null;\n      }\n    },\n    [agent, projectId, options]\n  );\n\n  /**\n   * Update an agent (name, status)\n   */\n  const updateAgent = useCallback(\n    async (input: UpdateAgentInput): Promise<Agent | null> => {\n      setUpdateState({ loading: true, error: null, data: null });\n      try {\n        const result = await agent.updateAgent(input);\n        setUpdateState({ loading: false, error: null, data: result });\n        options.onSuccess?.();\n        return result;\n      } catch (err) {\n        const error =\n          err instanceof Error ? err : new Error('Failed to update agent');\n        setUpdateState({ loading: false, error, data: null });\n        options.onError?.(error);\n        return null;\n      }\n    },\n    [agent, options]\n  );\n\n  /**\n   * Activate an agent\n   */\n  const activateAgent = useCallback(\n    async (agentId: string): Promise<Agent | null> => {\n      return updateAgent({ id: agentId, status: 'ACTIVE' });\n    },\n    [updateAgent]\n  );\n\n  /**\n   * Pause an agent\n   */\n  const pauseAgent = useCallback(\n    async (agentId: string): Promise<Agent | null> => {\n      return updateAgent({ id: agentId, status: 'PAUSED' });\n    },\n    [updateAgent]\n  );\n\n  /**\n   * Archive an agent\n   */\n  const archiveAgent = useCallback(\n    async (agentId: string): Promise<Agent | null> => {\n      return updateAgent({ id: agentId, status: 'ARCHIVED' });\n    },\n    [updateAgent]\n  );\n\n  /**\n   * Execute an agent (placeholder - needs run handler)\n   * Note: Execute functionality requires adding createRun/executeRun to agent handlers\n   */\n  const executeAgent = useCallback(\n    async (input: { agentId: string; message: string }): Promise<null> => {\n      // TODO: Implement execute when run creation handler is added to runtime-local\n      console.log('Execute agent:', input);\n      options.onSuccess?.();\n      return null;\n    },\n    [options]\n  );\n\n  return {\n    // Mutations\n    createAgent,\n    updateAgent,\n    activateAgent,\n    pauseAgent,\n    archiveAgent,\n    executeAgent,\n\n    // State\n    createState,\n    updateState,\n\n    // Convenience\n    isLoading: createState.loading || updateState.loading,\n  };\n}\n\n// Re-export types for convenience\nexport type { CreateAgentInput, UpdateAgentInput, Agent };\n"],"mappings":";;;;;;;;;;;AA2BA,SAAgB,kBAAkB,UAAoC,EAAE,EAAE;CACxE,MAAM,EAAE,UAAU,cAAc,oBAE5B;CACJ,MAAM,EAAE,UAAU;CAElB,MAAM,CAAC,aAAa,kBAAkB,SAA+B;EACnE,SAAS;EACT,OAAO;EACP,MAAM;EACP,CAAC;CAEF,MAAM,CAAC,aAAa,kBAAkB,SAA+B;EACnE,SAAS;EACT,OAAO;EACP,MAAM;EACP,CAAC;;;;CAKF,MAAM,cAAc,YAClB,OAAO,UAAmD;AACxD,iBAAe;GAAE,SAAS;GAAM,OAAO;GAAM,MAAM;GAAM,CAAC;AAC1D,MAAI;GACF,MAAM,SAAS,MAAM,MAAM,YAAY,OAAO;IAC5C;IACA,gBAAgB;IACjB,CAAC;AACF,kBAAe;IAAE,SAAS;IAAO,OAAO;IAAM,MAAM;IAAQ,CAAC;AAC7D,WAAQ,aAAa;AACrB,UAAO;WACA,KAAK;GACZ,MAAM,QACJ,eAAe,QAAQ,sBAAM,IAAI,MAAM,yBAAyB;AAClE,kBAAe;IAAE,SAAS;IAAO;IAAO,MAAM;IAAM,CAAC;AACrD,WAAQ,UAAU,MAAM;AACxB,UAAO;;IAGX;EAAC;EAAO;EAAW;EAAQ,CAC5B;;;;CAKD,MAAM,cAAc,YAClB,OAAO,UAAmD;AACxD,iBAAe;GAAE,SAAS;GAAM,OAAO;GAAM,MAAM;GAAM,CAAC;AAC1D,MAAI;GACF,MAAM,SAAS,MAAM,MAAM,YAAY,MAAM;AAC7C,kBAAe;IAAE,SAAS;IAAO,OAAO;IAAM,MAAM;IAAQ,CAAC;AAC7D,WAAQ,aAAa;AACrB,UAAO;WACA,KAAK;GACZ,MAAM,QACJ,eAAe,QAAQ,sBAAM,IAAI,MAAM,yBAAyB;AAClE,kBAAe;IAAE,SAAS;IAAO;IAAO,MAAM;IAAM,CAAC;AACrD,WAAQ,UAAU,MAAM;AACxB,UAAO;;IAGX,CAAC,OAAO,QAAQ,CACjB;AA8CD,QAAO;EAEL;EACA;EACA,eA7CoB,YACpB,OAAO,YAA2C;AAChD,UAAO,YAAY;IAAE,IAAI;IAAS,QAAQ;IAAU,CAAC;KAEvD,CAAC,YAAY,CACd;EAyCC,YApCiB,YACjB,OAAO,YAA2C;AAChD,UAAO,YAAY;IAAE,IAAI;IAAS,QAAQ;IAAU,CAAC;KAEvD,CAAC,YAAY,CACd;EAgCC,cA3BmB,YACnB,OAAO,YAA2C;AAChD,UAAO,YAAY;IAAE,IAAI;IAAS,QAAQ;IAAY,CAAC;KAEzD,CAAC,YAAY,CACd;EAuBC,cAjBmB,YACnB,OAAO,UAA+D;AAEpE,WAAQ,IAAI,kBAAkB,MAAM;AACpC,WAAQ,aAAa;AACrB,UAAO;KAET,CAAC,QAAQ,CACV;EAYC;EACA;EAGA,WAAW,YAAY,WAAW,YAAY;EAC/C"}

package/dist/ui/hooks/useRunList.d.ts

@@ -0,0 +1,24 @@
+import { ListRunsOutput as ListRunsOutput$1, Run as Run$1, RunMetrics as RunMetrics$1 } from "../../handlers/agent.handlers.js";
+
+//#region src/ui/hooks/useRunList.d.ts
+type Run = Run$1;
+type ListRunsOutput = ListRunsOutput$1;
+type RunMetrics = RunMetrics$1;
+interface UseRunListOptions {
+  agentId?: string;
+  status?: Run['status'] | 'all';
+  limit?: number;
+}
+declare function useRunList(options?: UseRunListOptions): {
+  data: ListRunsOutput$1 | null;
+  metrics: RunMetrics$1 | null;
+  loading: boolean;
+  error: Error | null;
+  page: number;
+  refetch: () => Promise<void>;
+  nextPage: () => void;
+  prevPage: () => false | void;
+};
+//#endregion
+export { ListRunsOutput, Run, RunMetrics, UseRunListOptions, useRunList };
+//# sourceMappingURL=useRunList.d.ts.map

package/dist/ui/hooks/useRunList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRunList.d.ts","names":[],"sources":["../../../src/ui/hooks/useRunList.ts"],"sourcesContent":[],"mappings":";;;KAeY,GAAA,GAAM;KACN,cAAA,GAAiB;AADjB,KAEA,UAAA,GAAa,YAFG;AAChB,UAGK,iBAAA,CAHY;EACjB,OAAA,CAAA,EAAA,MAAU;EAEL,MAAA,CAAA,EAEN,GAFM,CAAA,QAAiB,CAAA,GAAA,KAAA;EAMlB,KAAA,CAAA,EAAA,MAAU;;iBAAV,UAAA,WAAoB"}

package/dist/ui/hooks/useRunList.js

@@ -0,0 +1,66 @@
+import { useCallback, useEffect, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+
+//#region src/ui/hooks/useRunList.ts
+/**
+* Hook for fetching and managing run list data
+*
+* Uses runtime-local database-backed handlers.
+*/
+function useRunList(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" ? void 0 : options.status,
+				limit: options.limit ?? 20,
+				offset: (page - 1) * (options.limit ?? 20)
+			}), agent.getRunMetrics({
+				projectId,
+				agentId: options.agentId,
+				startDate: /* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3),
+				endDate: /* @__PURE__ */ new Date()
+			})]);
+			setData(runsResult);
+			setMetrics(metricsResult);
+		} catch (err) {
+			setError(err instanceof Error ? err : /* @__PURE__ */ 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)
+	};
+}
+
+//#endregion
+export { useRunList };
+//# sourceMappingURL=useRunList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRunList.js","names":[],"sources":["../../../src/ui/hooks/useRunList.ts"],"sourcesContent":["/**\n * Hook for fetching and managing run list data\n *\n * Uses runtime-local database-backed handlers.\n */\nimport { useCallback, useEffect, useState } from 'react';\nimport { useTemplateRuntime } from '@contractspec/lib.example-shared-ui';\nimport type {\n  ListRunsOutput as RuntimeListRunsOutput,\n  Run as RuntimeRun,\n  RunMetrics as RuntimeRunMetrics,\n  AgentHandlers,\n} from '../../handlers/agent.handlers';\n\n// Re-export types for convenience\nexport type Run = RuntimeRun;\nexport type ListRunsOutput = RuntimeListRunsOutput;\nexport type RunMetrics = RuntimeRunMetrics;\n\nexport interface UseRunListOptions {\n  agentId?: string;\n  status?: Run['status'] | 'all';\n  limit?: number;\n}\n\nexport function useRunList(options: UseRunListOptions = {}) {\n  const { handlers, projectId } = useTemplateRuntime<{\n    agent: AgentHandlers;\n  }>();\n  const { agent } = handlers;\n\n  const [data, setData] = useState<ListRunsOutput | null>(null);\n  const [metrics, setMetrics] = useState<RunMetrics | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n  const [page, setPage] = useState(1);\n\n  const fetchData = useCallback(async () => {\n    setLoading(true);\n    setError(null);\n\n    try {\n      const [runsResult, metricsResult] = await Promise.all([\n        agent.listRuns({\n          projectId,\n          agentId: options.agentId,\n          status: options.status === 'all' ? undefined : options.status,\n          limit: options.limit ?? 20,\n          offset: (page - 1) * (options.limit ?? 20),\n        }),\n        agent.getRunMetrics({\n          projectId,\n          agentId: options.agentId,\n          startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000), // 30 days ago\n          endDate: new Date(),\n        }),\n      ]);\n      setData(runsResult);\n      setMetrics(metricsResult);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error('Unknown error'));\n    } finally {\n      setLoading(false);\n    }\n  }, [agent, projectId, options.agentId, options.status, options.limit, page]);\n\n  useEffect(() => {\n    fetchData();\n  }, [fetchData]);\n\n  return {\n    data,\n    metrics,\n    loading,\n    error,\n    page,\n    refetch: fetchData,\n    nextPage: () => setPage((p) => p + 1),\n    prevPage: () => page > 1 && setPage((p) => p - 1),\n  };\n}\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,WAAW,UAA6B,EAAE,EAAE;CAC1D,MAAM,EAAE,UAAU,cAAc,oBAE5B;CACJ,MAAM,EAAE,UAAU;CAElB,MAAM,CAAC,MAAM,WAAW,SAAgC,KAAK;CAC7D,MAAM,CAAC,SAAS,cAAc,SAA4B,KAAK;CAC/D,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,CAAC,OAAO,YAAY,SAAuB,KAAK;CACtD,MAAM,CAAC,MAAM,WAAW,SAAS,EAAE;CAEnC,MAAM,YAAY,YAAY,YAAY;AACxC,aAAW,KAAK;AAChB,WAAS,KAAK;AAEd,MAAI;GACF,MAAM,CAAC,YAAY,iBAAiB,MAAM,QAAQ,IAAI,CACpD,MAAM,SAAS;IACb;IACA,SAAS,QAAQ;IACjB,QAAQ,QAAQ,WAAW,QAAQ,SAAY,QAAQ;IACvD,OAAO,QAAQ,SAAS;IACxB,SAAS,OAAO,MAAM,QAAQ,SAAS;IACxC,CAAC,EACF,MAAM,cAAc;IAClB;IACA,SAAS,QAAQ;IACjB,2BAAW,IAAI,KAAK,KAAK,KAAK,GAAG,MAAU,KAAK,KAAK,IAAK;IAC1D,yBAAS,IAAI,MAAM;IACpB,CAAC,CACH,CAAC;AACF,WAAQ,WAAW;AACnB,cAAW,cAAc;WAClB,KAAK;AACZ,YAAS,eAAe,QAAQ,sBAAM,IAAI,MAAM,gBAAgB,CAAC;YACzD;AACR,cAAW,MAAM;;IAElB;EAAC;EAAO;EAAW,QAAQ;EAAS,QAAQ;EAAQ,QAAQ;EAAO;EAAK,CAAC;AAE5E,iBAAgB;AACd,aAAW;IACV,CAAC,UAAU,CAAC;AAEf,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,gBAAgB,SAAS,MAAM,IAAI,EAAE;EACrC,gBAAgB,OAAO,KAAK,SAAS,MAAM,IAAI,EAAE;EAClD"}

package/dist/ui/hooks/useToolList.d.ts

@@ -0,0 +1,40 @@
+import { ListToolsOutput as ListToolsOutput$1, Tool as Tool$1 } from "../../handlers/agent.handlers.js";
+
+//#region src/ui/hooks/useToolList.d.ts
+type Tool = Tool$1;
+type ListToolsOutput = ListToolsOutput$1;
+type ToolCategory = Tool['category'];
+type ToolStatus = Tool['status'];
+interface UseToolListOptions {
+  search?: string;
+  category?: ToolCategory;
+  status?: ToolStatus | 'all';
+  limit?: number;
+}
+declare function useToolList(options?: UseToolListOptions): {
+  data: ListToolsOutput$1 | null;
+  loading: boolean;
+  error: Error | null;
+  stats: {
+    total: number;
+    active: number;
+    deprecated: number;
+    disabled: number;
+    topCategories: {
+      category: string;
+      count: number;
+    }[];
+  } | null;
+  groupedByCategory: Record<string, Tool$1[]> | {};
+  categoryStats: never[] | {
+    category: string;
+    count: number;
+  }[];
+  page: number;
+  refetch: () => Promise<void>;
+  nextPage: () => void;
+  prevPage: () => false | void;
+};
+//#endregion
+export { ListToolsOutput, Tool, ToolCategory, ToolStatus, UseToolListOptions, useToolList };
+//# sourceMappingURL=useToolList.d.ts.map

package/dist/ui/hooks/useToolList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolList.d.ts","names":[],"sources":["../../../src/ui/hooks/useToolList.ts"],"sourcesContent":[],"mappings":";;;KAcY,IAAA,GAAO;KACP,eAAA,GAAkB;AADlB,KAGA,YAAA,GAAe,IAHG,CAAA,UAAA,CAAA;AAClB,KAGA,UAAA,GAAa,IAHE,CAAA,QAAG,CAAA;AAElB,UAGK,kBAAA,CAHU;EACf,MAAA,CAAA,EAAA,MAAU;EAEL,QAAA,CAAA,EAEJ,YAFsB;EAOnB,MAAA,CAAA,EAJL,UAIgB,GAAA,KAAA;EAAU,KAAA,CAAA,EAAA,MAAA;;iBAArB,WAAA,WAAqB"}

package/dist/ui/hooks/useToolList.js

@@ -0,0 +1,96 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+
+//#region src/ui/hooks/useToolList.ts
+/**
+* Hook for fetching and managing tool list data
+*
+* Uses runtime-local database-backed handlers.
+*/
+function useToolList(options = {}) {
+	const { handlers, projectId } = useTemplateRuntime();
+	const { agent } = handlers;
+	const [data, setData] = 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 {
+			setData(await agent.listTools({
+				projectId,
+				search: options.search,
+				category: options.category,
+				status: options.status === "all" ? void 0 : options.status,
+				limit: options.limit ?? 50,
+				offset: (page - 1) * (options.limit ?? 50)
+			}));
+		} catch (err) {
+			setError(err instanceof Error ? err : /* @__PURE__ */ new Error("Unknown error"));
+		} finally {
+			setLoading(false);
+		}
+	}, [
+		agent,
+		projectId,
+		options.search,
+		options.category,
+		options.status,
+		options.limit,
+		page
+	]);
+	useEffect(() => {
+		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)
+	};
+}
+
+//#endregion
+export { useToolList };
+//# sourceMappingURL=useToolList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useToolList.js","names":[],"sources":["../../../src/ui/hooks/useToolList.ts"],"sourcesContent":["/**\n * Hook for fetching and managing tool list data\n *\n * Uses runtime-local database-backed handlers.\n */\nimport { useCallback, useEffect, useMemo, useState } from 'react';\nimport { useTemplateRuntime } from '@contractspec/lib.example-shared-ui';\nimport type {\n  ListToolsOutput as RuntimeListToolsOutput,\n  Tool as RuntimeTool,\n  AgentHandlers,\n} from '../../handlers/agent.handlers';\n\n// Re-export types for convenience\nexport type Tool = RuntimeTool;\nexport type ListToolsOutput = RuntimeListToolsOutput;\n\nexport type ToolCategory = Tool['category'];\nexport type ToolStatus = Tool['status'];\n\nexport interface UseToolListOptions {\n  search?: string;\n  category?: ToolCategory;\n  status?: ToolStatus | 'all';\n  limit?: number;\n}\n\nexport function useToolList(options: UseToolListOptions = {}) {\n  const { handlers, projectId } = useTemplateRuntime<{\n    agent: AgentHandlers;\n  }>();\n  const { agent } = handlers;\n\n  const [data, setData] = useState<ListToolsOutput | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n  const [page, setPage] = useState(1);\n\n  const fetchData = useCallback(async () => {\n    setLoading(true);\n    setError(null);\n\n    try {\n      const result = await agent.listTools({\n        projectId,\n        search: options.search,\n        category: options.category,\n        status: options.status === 'all' ? undefined : options.status,\n        limit: options.limit ?? 50,\n        offset: (page - 1) * (options.limit ?? 50),\n      });\n      setData(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error('Unknown error'));\n    } finally {\n      setLoading(false);\n    }\n  }, [\n    agent,\n    projectId,\n    options.search,\n    options.category,\n    options.status,\n    options.limit,\n    page,\n  ]);\n\n  useEffect(() => {\n    fetchData();\n  }, [fetchData]);\n\n  // Calculate stats and grouping\n  const { stats, groupedByCategory, categoryStats } = useMemo(() => {\n    if (!data) return { stats: null, groupedByCategory: {}, categoryStats: [] };\n    const items = data.items;\n\n    const active = items.filter((t) => t.status === 'ACTIVE').length;\n    const deprecated = items.filter((t) => t.status === 'DEPRECATED').length;\n    const disabled = items.filter((t) => t.status === 'DISABLED').length;\n\n    // Group by category\n    const grouped: Record<string, Tool[]> = {};\n    const byCategory: Record<string, number> = {};\n\n    items.forEach((t) => {\n      const cat = t.category;\n      if (!grouped[cat]) grouped[cat] = [];\n      grouped[cat].push(t);\n      byCategory[cat] = (byCategory[cat] || 0) + 1;\n    });\n\n    // Category stats sorted by count\n    const catStats = Object.entries(byCategory)\n      .map(([category, count]) => ({ category, count }))\n      .sort((a, b) => b.count - a.count);\n\n    return {\n      stats: {\n        total: data.total,\n        active,\n        deprecated,\n        disabled,\n        topCategories: catStats.slice(0, 5),\n      },\n      groupedByCategory: grouped,\n      categoryStats: catStats,\n    };\n  }, [data]);\n\n  return {\n    data,\n    loading,\n    error,\n    stats,\n    groupedByCategory,\n    categoryStats,\n    page,\n    refetch: fetchData,\n    nextPage: () => setPage((p) => p + 1),\n    prevPage: () => page > 1 && setPage((p) => p - 1),\n  };\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgB,YAAY,UAA8B,EAAE,EAAE;CAC5D,MAAM,EAAE,UAAU,cAAc,oBAE5B;CACJ,MAAM,EAAE,UAAU;CAElB,MAAM,CAAC,MAAM,WAAW,SAAiC,KAAK;CAC9D,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,CAAC,OAAO,YAAY,SAAuB,KAAK;CACtD,MAAM,CAAC,MAAM,WAAW,SAAS,EAAE;CAEnC,MAAM,YAAY,YAAY,YAAY;AACxC,aAAW,KAAK;AAChB,WAAS,KAAK;AAEd,MAAI;AASF,WARe,MAAM,MAAM,UAAU;IACnC;IACA,QAAQ,QAAQ;IAChB,UAAU,QAAQ;IAClB,QAAQ,QAAQ,WAAW,QAAQ,SAAY,QAAQ;IACvD,OAAO,QAAQ,SAAS;IACxB,SAAS,OAAO,MAAM,QAAQ,SAAS;IACxC,CAAC,CACa;WACR,KAAK;AACZ,YAAS,eAAe,QAAQ,sBAAM,IAAI,MAAM,gBAAgB,CAAC;YACzD;AACR,cAAW,MAAM;;IAElB;EACD;EACA;EACA,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR;EACD,CAAC;AAEF,iBAAgB;AACd,aAAW;IACV,CAAC,UAAU,CAAC;CAGf,MAAM,EAAE,OAAO,mBAAmB,kBAAkB,cAAc;AAChE,MAAI,CAAC,KAAM,QAAO;GAAE,OAAO;GAAM,mBAAmB,EAAE;GAAE,eAAe,EAAE;GAAE;EAC3E,MAAM,QAAQ,KAAK;EAEnB,MAAM,SAAS,MAAM,QAAQ,MAAM,EAAE,WAAW,SAAS,CAAC;EAC1D,MAAM,aAAa,MAAM,QAAQ,MAAM,EAAE,WAAW,aAAa,CAAC;EAClE,MAAM,WAAW,MAAM,QAAQ,MAAM,EAAE,WAAW,WAAW,CAAC;EAG9D,MAAM,UAAkC,EAAE;EAC1C,MAAM,aAAqC,EAAE;AAE7C,QAAM,SAAS,MAAM;GACnB,MAAM,MAAM,EAAE;AACd,OAAI,CAAC,QAAQ,KAAM,SAAQ,OAAO,EAAE;AACpC,WAAQ,KAAK,KAAK,EAAE;AACpB,cAAW,QAAQ,WAAW,QAAQ,KAAK;IAC3C;EAGF,MAAM,WAAW,OAAO,QAAQ,WAAW,CACxC,KAAK,CAAC,UAAU,YAAY;GAAE;GAAU;GAAO,EAAE,CACjD,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM;AAEpC,SAAO;GACL,OAAO;IACL,OAAO,KAAK;IACZ;IACA;IACA;IACA,eAAe,SAAS,MAAM,GAAG,EAAE;IACpC;GACD,mBAAmB;GACnB,eAAe;GAChB;IACA,CAAC,KAAK,CAAC;AAEV,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,gBAAgB,SAAS,MAAM,IAAI,EAAE;EACrC,gBAAgB,OAAO,KAAK,SAAS,MAAM,IAAI,EAAE;EAClD"}

package/dist/ui/index.d.ts

@@ -0,0 +1,24 @@
+import { CreateAgentInput, UpdateAgentInput } from "../handlers/agent.handlers.js";
+import { AgentDashboard } from "./AgentDashboard.js";
+import { RunListView } from "./views/RunListView.js";
+import "./AgentRunList.js";
+import { ToolRegistryView } from "./views/ToolRegistryView.js";
+import "./AgentToolRegistry.js";
+import { AgentListView } from "./views/AgentListView.js";
+import "./views/index.js";
+import { CreateAgentModal } from "./modals/CreateAgentModal.js";
+import { UseAgentListOptions, useAgentList } from "./hooks/useAgentList.js";
+import { AgentActionsModal } from "./modals/AgentActionsModal.js";
+import "./modals/index.js";
+import { UseRunListOptions, useRunList } from "./hooks/useRunList.js";
+import { UseToolListOptions, useToolList } from "./hooks/useToolList.js";
+import { UseAgentMutationsOptions, useAgentMutations } from "./hooks/useAgentMutations.js";
+import "./hooks/index.js";
+import { agentListReactRenderer } from "./renderers/agent-list.renderer.js";
+import { agentListMarkdownRenderer } from "./renderers/agent-list.markdown.js";
+import { runListMarkdownRenderer } from "./renderers/run-list.markdown.js";
+import { toolRegistryMarkdownRenderer } from "./renderers/tool-registry.markdown.js";
+import { agentDashboardMarkdownRenderer } from "./renderers/dashboard.markdown.js";
+import "./renderers/index.js";
+import { agentConsoleDemoOverlay, agentConsoleOverlays, agentConsoleReadOnlyOverlay } from "./overlays/demo-overlays.js";
+export { AgentActionsModal, AgentDashboard, AgentListView, RunListView as AgentRunList, ToolRegistryView as AgentToolRegistry, CreateAgentInput, CreateAgentModal, RunListView, ToolRegistryView, UpdateAgentInput, UseAgentListOptions, UseAgentMutationsOptions, UseRunListOptions, UseToolListOptions, agentConsoleDemoOverlay, agentConsoleOverlays, agentConsoleReadOnlyOverlay, agentDashboardMarkdownRenderer, agentListMarkdownRenderer, agentListReactRenderer, runListMarkdownRenderer, toolRegistryMarkdownRenderer, useAgentList, useAgentMutations, useRunList, useToolList };

package/dist/ui/index.js

@@ -0,0 +1,24 @@
+import { useRunList } from "./hooks/useRunList.js";
+import { RunListView } from "./views/RunListView.js";
+import { useToolList } from "./hooks/useToolList.js";
+import { ToolRegistryView } from "./views/ToolRegistryView.js";
+import { useAgentList } from "./hooks/useAgentList.js";
+import { useAgentMutations } from "./hooks/useAgentMutations.js";
+import { CreateAgentModal } from "./modals/CreateAgentModal.js";
+import { AgentActionsModal } from "./modals/AgentActionsModal.js";
+import { AgentDashboard } from "./AgentDashboard.js";
+import "./AgentRunList.js";
+import "./AgentToolRegistry.js";
+import { AgentListView } from "./views/AgentListView.js";
+import "./views/index.js";
+import "./modals/index.js";
+import "./hooks/index.js";
+import { agentListReactRenderer } from "./renderers/agent-list.renderer.js";
+import { agentListMarkdownRenderer } from "./renderers/agent-list.markdown.js";
+import { runListMarkdownRenderer } from "./renderers/run-list.markdown.js";
+import { toolRegistryMarkdownRenderer } from "./renderers/tool-registry.markdown.js";
+import { agentDashboardMarkdownRenderer } from "./renderers/dashboard.markdown.js";
+import "./renderers/index.js";
+import { agentConsoleDemoOverlay, agentConsoleOverlays, agentConsoleReadOnlyOverlay } from "./overlays/demo-overlays.js";
+
+export { AgentActionsModal, AgentDashboard, AgentListView, RunListView as AgentRunList, ToolRegistryView as AgentToolRegistry, CreateAgentModal, RunListView, ToolRegistryView, agentConsoleDemoOverlay, agentConsoleOverlays, agentConsoleReadOnlyOverlay, agentDashboardMarkdownRenderer, agentListMarkdownRenderer, agentListReactRenderer, runListMarkdownRenderer, toolRegistryMarkdownRenderer, useAgentList, useAgentMutations, useRunList, useToolList };

package/dist/ui/modals/AgentActionsModal.d.ts

@@ -0,0 +1,27 @@
+import { Agent } from "../hooks/useAgentList.js";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
+
+//#region src/ui/modals/AgentActionsModal.d.ts
+interface AgentActionsModalProps {
+  isOpen: boolean;
+  agent: Agent | null;
+  onClose: () => void;
+  onActivate: (agentId: string) => Promise<void>;
+  onPause: (agentId: string) => Promise<void>;
+  onArchive: (agentId: string) => Promise<void>;
+  onExecute: (agentId: string, message: string) => Promise<void>;
+  isLoading?: boolean;
+}
+declare function AgentActionsModal({
+  isOpen,
+  agent,
+  onClose,
+  onActivate,
+  onPause,
+  onArchive,
+  onExecute,
+  isLoading
+}: AgentActionsModalProps): react_jsx_runtime3.JSX.Element | null;
+//#endregion
+export { AgentActionsModal };
+//# sourceMappingURL=AgentActionsModal.d.ts.map

package/dist/ui/modals/AgentActionsModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentActionsModal.d.ts","names":[],"sources":["../../../src/ui/modals/AgentActionsModal.tsx"],"sourcesContent":[],"mappings":";;;;UAaU,sBAAA;;SAED;EAFC,OAAA,EAAA,GAAA,GAAA,IAAA;EAED,UAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAE0B,OAF1B,CAAA,IAAA,CAAA;EAE0B,OAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GACH,OADG,CAAA,IAAA,CAAA;EACH,SAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GACE,OADF,CAAA,IAAA,CAAA;EACE,SAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,EAAA,GACiB,OADjB,CAAA,IAAA,CAAA;EACiB,SAAA,CAAA,EAAA,OAAA;;AAmBnC,iBAAA,iBAAA,CAAiB;EAAA,MAAA;EAAA,KAAA;EAAA,OAAA;EAAA,UAAA;EAAA,OAAA;EAAA,SAAA;EAAA,SAAA;EAAA;AAAA,CAAA,EAS9B,sBAT8B,CAAA,EASR,kBAAA,CAAA,GAAA,CAAA,OAAA,GATQ,IAAA"}