@contractspec/example.agent-console 1.57.0 → 1.58.0

package/dist/node/ui/renderers/index.js

@@ -0,0 +1,446 @@
+// src/ui/hooks/useAgentList.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+function useAgentList(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 {
+      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/views/AgentListView.tsx
+import {
+  Button,
+  StatCard,
+  StatCardGroup,
+  EntityCard,
+  StatusChip,
+  LoaderBlock,
+  ErrorState,
+  EmptyState
+} from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function getStatusTone(status) {
+  switch (status) {
+    case "ACTIVE":
+      return "success";
+    case "PAUSED":
+    case "DRAFT":
+      return "warning";
+    case "ARCHIVED":
+      return "neutral";
+    default:
+      return "neutral";
+  }
+}
+function AgentListView() {
+  const { data, loading, error, stats, refetch } = useAgentList();
+  if (loading && !data) {
+    return /* @__PURE__ */ jsxDEV(LoaderBlock, {
+      label: "Loading agents..."
+    }, undefined, false, undefined, this);
+  }
+  if (error) {
+    return /* @__PURE__ */ jsxDEV(ErrorState, {
+      title: "Failed to load agents",
+      description: error.message,
+      onRetry: refetch,
+      retryLabel: "Retry"
+    }, undefined, false, undefined, this);
+  }
+  if (!data?.items.length) {
+    return /* @__PURE__ */ jsxDEV(EmptyState, {
+      title: "No agents yet",
+      description: "Create your first AI agent to get started."
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-6",
+    children: [
+      stats && /* @__PURE__ */ jsxDEV(StatCardGroup, {
+        children: [
+          /* @__PURE__ */ jsxDEV(StatCard, {
+            label: "Total Agents",
+            value: stats.total
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatCard, {
+            label: "Active",
+            value: stats.active
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatCard, {
+            label: "Paused",
+            value: stats.paused
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatCard, {
+            label: "Draft",
+            value: stats.draft
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center justify-between",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "text-lg font-semibold",
+            children: "Agents"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Button, {
+            onPress: () => alert("Create Agent clicked!"),
+            children: "Create Agent"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3",
+        children: data.items.map((agent) => /* @__PURE__ */ jsxDEV(EntityCard, {
+          cardTitle: agent.name,
+          cardSubtitle: agent.modelName,
+          meta: /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-sm",
+            children: agent.description
+          }, undefined, false, undefined, this),
+          chips: /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone: getStatusTone(agent.status),
+            label: agent.status
+          }, undefined, false, undefined, this),
+          footer: /* @__PURE__ */ jsxDEV("span", {
+            className: "text-muted-foreground text-xs",
+            children: [
+              "Created ",
+              agent.createdAt.toLocaleDateString()
+            ]
+          }, undefined, true, undefined, this),
+          onClick: () => alert(`View agent: ${agent.name}`)
+        }, agent.id, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/ui/renderers/agent-list.renderer.tsx
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+var agentListReactRenderer = {
+  target: "react",
+  render: async (desc) => {
+    if (desc.source.type !== "component") {
+      throw new Error("AgentListRenderer: expected component source");
+    }
+    if (desc.source.componentKey !== "AgentListView") {
+      throw new Error(`AgentListRenderer: unknown component ${desc.source.componentKey}`);
+    }
+    return /* @__PURE__ */ jsxDEV2(AgentListView, {}, undefined, false, undefined, this);
+  }
+};
+
+// src/ui/renderers/agent-list.markdown.ts
+import {
+  mockListAgentsHandler
+} from "@contractspec/example.agent-console/handlers";
+var agentListMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "AgentListView") {
+      throw new Error("agentListMarkdownRenderer: not AgentListView");
+    }
+    const data = await mockListAgentsHandler({
+      organizationId: "demo-org",
+      limit: 50,
+      offset: 0
+    });
+    const lines = [
+      `# ${desc.meta.description ?? "Agent List"}`,
+      "",
+      `> ${desc.meta.key} v${desc.meta.version}`,
+      "",
+      `**Total Agents:** ${data.total}`,
+      "",
+      "## Agents",
+      ""
+    ];
+    const byStatus = {};
+    for (const agent of data.items) {
+      const status = agent.status;
+      if (byStatus[status]) {
+        byStatus[status].push(agent);
+      } else {
+        byStatus[status] = [agent];
+      }
+    }
+    for (const [status, agents] of Object.entries(byStatus)) {
+      lines.push(`### ${status} (${agents.length})`);
+      lines.push("");
+      for (const agent of agents) {
+        lines.push(`- **${agent.name}** (${agent.modelProvider}/${agent.modelName})`);
+        if (agent.description) {
+          lines.push(`  > ${agent.description}`);
+        }
+      }
+      lines.push("");
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+
+// src/ui/renderers/run-list.markdown.ts
+import { mockListRunsHandler } from "@contractspec/example.agent-console/handlers";
+function formatDuration(ms) {
+  if (ms < 1000)
+    return `${ms}ms`;
+  if (ms < 60000)
+    return `${(ms / 1000).toFixed(1)}s`;
+  return `${(ms / 60000).toFixed(1)}m`;
+}
+var runListMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "RunListView") {
+      throw new Error("runListMarkdownRenderer: not RunListView");
+    }
+    const data = await mockListRunsHandler({
+      organizationId: "demo-org",
+      limit: 20,
+      offset: 0
+    });
+    const lines = [
+      `# ${desc.meta.description ?? "Agent Runs"}`,
+      "",
+      `> ${desc.meta.key} v${desc.meta.version}`,
+      "",
+      `**Total Runs:** ${data.total}`,
+      "",
+      "## Recent Runs",
+      "",
+      "| ID | Agent | Status | Duration | Tokens | Cost |",
+      "| --- | --- | --- | --- | --- | --- |"
+    ];
+    for (const run of data.items.slice(0, 10)) {
+      lines.push(`| ${run.id.slice(-8)} | ${run.agentName} | ${run.status} | ${run.durationMs ? formatDuration(run.durationMs) : "-"} | ${run.totalTokens} | $${run.estimatedCostUsd?.toFixed(4) ?? "-"} |`);
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+
+// src/ui/renderers/tool-registry.markdown.ts
+import { mockListToolsHandler } from "@contractspec/example.agent-console/handlers";
+var toolRegistryMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "ToolRegistryView") {
+      throw new Error("toolRegistryMarkdownRenderer: not ToolRegistryView");
+    }
+    const data = await mockListToolsHandler({
+      organizationId: "demo-org",
+      limit: 50,
+      offset: 0
+    });
+    const lines = [
+      `# ${desc.meta.description ?? "Tool Registry"}`,
+      "",
+      `> ${desc.meta.key} v${desc.meta.version}`,
+      "",
+      `**Total Tools:** ${data.total}`,
+      ""
+    ];
+    const byCategory = {};
+    for (const tool of data.items) {
+      const cat = tool.category;
+      if (!byCategory[cat])
+        byCategory[cat] = [];
+      byCategory[cat].push(tool);
+    }
+    for (const [category, tools] of Object.entries(byCategory).sort()) {
+      lines.push(`## ${category} (${tools.length})`);
+      lines.push("");
+      for (const tool of tools) {
+        const statusIcon = tool.status === "ACTIVE" ? "✅" : tool.status === "DEPRECATED" ? "⚠️" : "❌";
+        lines.push(`### ${statusIcon} ${tool.name} v${tool.version}`);
+        lines.push("");
+        lines.push(`> \`${tool.id}\``);
+        lines.push("");
+        if (tool.description) {
+          lines.push(tool.description);
+          lines.push("");
+        }
+      }
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+
+// src/ui/renderers/dashboard.markdown.ts
+import {
+  mockListAgentsHandler as mockListAgentsHandler2,
+  mockListRunsHandler as mockListRunsHandler2,
+  mockListToolsHandler as mockListToolsHandler2
+} from "@contractspec/example.agent-console/handlers";
+function formatDuration2(ms) {
+  if (ms < 1000)
+    return `${ms}ms`;
+  if (ms < 60000)
+    return `${(ms / 1000).toFixed(1)}s`;
+  return `${(ms / 60000).toFixed(1)}m`;
+}
+var agentDashboardMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "AgentConsoleDashboard") {
+      throw new Error("agentDashboardMarkdownRenderer: not AgentConsoleDashboard");
+    }
+    const [agentsData, runsData, toolsData] = await Promise.all([
+      mockListAgentsHandler2({
+        organizationId: "demo-org",
+        limit: 100
+      }),
+      mockListRunsHandler2({
+        limit: 100
+      }),
+      mockListToolsHandler2({
+        organizationId: "demo-org",
+        limit: 100
+      })
+    ]);
+    const activeAgents = agentsData.items.filter((a) => a.status === "ACTIVE").length;
+    const completedRuns = runsData.items.filter((r) => r.status === "COMPLETED").length;
+    const failedRuns = runsData.items.filter((r) => r.status === "FAILED").length;
+    const totalTokens = runsData.items.reduce((sum, r) => sum + (r.totalTokens ?? 0), 0);
+    const totalCost = runsData.items.reduce((sum, r) => sum + (r.estimatedCostUsd ?? 0), 0);
+    const activeTools = toolsData.items.filter((t) => t.status === "ACTIVE").length;
+    const lines = [
+      "# Agent Console Dashboard",
+      "",
+      "> AI agent operations overview",
+      "",
+      "## Summary",
+      "",
+      "| Metric | Value |",
+      "|--------|-------|",
+      `| Total Agents | ${agentsData.total} |`,
+      `| Active Agents | ${activeAgents} |`,
+      `| Total Runs | ${runsData.total} |`,
+      `| Completed Runs | ${completedRuns} |`,
+      `| Failed Runs | ${failedRuns} |`,
+      `| Total Tokens | ${totalTokens.toLocaleString()} |`,
+      `| Total Cost | $${totalCost.toFixed(4)} |`,
+      `| Total Tools | ${toolsData.total} |`,
+      `| Active Tools | ${activeTools} |`,
+      "",
+      "## Agents",
+      ""
+    ];
+    if (agentsData.items.length === 0) {
+      lines.push("_No agents configured._");
+    } else {
+      lines.push("| Agent | Model | Status | Description |");
+      lines.push("|-------|-------|--------|-------------|");
+      for (const agent of agentsData.items.slice(0, 5)) {
+        lines.push(`| ${agent.name} | ${agent.modelProvider}/${agent.modelName} | ${agent.status} | ${agent.description ?? "-"} |`);
+      }
+      if (agentsData.items.length > 5) {
+        lines.push(`| ... | ... | ... | _${agentsData.total - 5} more_ |`);
+      }
+    }
+    lines.push("");
+    lines.push("## Recent Runs");
+    lines.push("");
+    if (runsData.items.length === 0) {
+      lines.push("_No runs yet._");
+    } else {
+      lines.push("| Run ID | Agent | Status | Duration | Tokens | Cost |");
+      lines.push("|--------|-------|--------|----------|--------|------|");
+      for (const run of runsData.items.slice(0, 5)) {
+        lines.push(`| ${run.id.slice(-8)} | ${run.agentName} | ${run.status} | ${run.durationMs ? formatDuration2(run.durationMs) : "-"} | ${run.totalTokens ?? 0} | $${(run.estimatedCostUsd ?? 0).toFixed(4)} |`);
+      }
+      if (runsData.items.length > 5) {
+        lines.push(`| ... | ... | ... | ... | ... | _${runsData.total - 5} more_ |`);
+      }
+    }
+    lines.push("");
+    lines.push("## Tools");
+    lines.push("");
+    const toolsByCategory = {};
+    for (const tool of toolsData.items) {
+      const cat = tool.category;
+      if (!toolsByCategory[cat])
+        toolsByCategory[cat] = [];
+      toolsByCategory[cat].push(tool);
+    }
+    if (Object.keys(toolsByCategory).length === 0) {
+      lines.push("_No tools registered._");
+    } else {
+      lines.push("| Category | Tools | Active |");
+      lines.push("|----------|-------|--------|");
+      for (const [category, tools] of Object.entries(toolsByCategory).sort()) {
+        const active = tools.filter((t) => t.status === "ACTIVE").length;
+        lines.push(`| ${category} | ${tools.length} | ${active} |`);
+      }
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+export {
+  toolRegistryMarkdownRenderer,
+  runListMarkdownRenderer,
+  agentListReactRenderer,
+  agentListMarkdownRenderer,
+  agentDashboardMarkdownRenderer
+};

package/dist/node/ui/renderers/run-list.markdown.js

@@ -0,0 +1,45 @@
+// src/ui/renderers/run-list.markdown.ts
+import { mockListRunsHandler } from "@contractspec/example.agent-console/handlers";
+function formatDuration(ms) {
+  if (ms < 1000)
+    return `${ms}ms`;
+  if (ms < 60000)
+    return `${(ms / 1000).toFixed(1)}s`;
+  return `${(ms / 60000).toFixed(1)}m`;
+}
+var runListMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "RunListView") {
+      throw new Error("runListMarkdownRenderer: not RunListView");
+    }
+    const data = await mockListRunsHandler({
+      organizationId: "demo-org",
+      limit: 20,
+      offset: 0
+    });
+    const lines = [
+      `# ${desc.meta.description ?? "Agent Runs"}`,
+      "",
+      `> ${desc.meta.key} v${desc.meta.version}`,
+      "",
+      `**Total Runs:** ${data.total}`,
+      "",
+      "## Recent Runs",
+      "",
+      "| ID | Agent | Status | Duration | Tokens | Cost |",
+      "| --- | --- | --- | --- | --- | --- |"
+    ];
+    for (const run of data.items.slice(0, 10)) {
+      lines.push(`| ${run.id.slice(-8)} | ${run.agentName} | ${run.status} | ${run.durationMs ? formatDuration(run.durationMs) : "-"} | ${run.totalTokens} | $${run.estimatedCostUsd?.toFixed(4) ?? "-"} |`);
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+export {
+  runListMarkdownRenderer
+};

package/dist/node/ui/renderers/tool-registry.markdown.js

@@ -0,0 +1,53 @@
+// src/ui/renderers/tool-registry.markdown.ts
+import { mockListToolsHandler } from "@contractspec/example.agent-console/handlers";
+var toolRegistryMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "ToolRegistryView") {
+      throw new Error("toolRegistryMarkdownRenderer: not ToolRegistryView");
+    }
+    const data = await mockListToolsHandler({
+      organizationId: "demo-org",
+      limit: 50,
+      offset: 0
+    });
+    const lines = [
+      `# ${desc.meta.description ?? "Tool Registry"}`,
+      "",
+      `> ${desc.meta.key} v${desc.meta.version}`,
+      "",
+      `**Total Tools:** ${data.total}`,
+      ""
+    ];
+    const byCategory = {};
+    for (const tool of data.items) {
+      const cat = tool.category;
+      if (!byCategory[cat])
+        byCategory[cat] = [];
+      byCategory[cat].push(tool);
+    }
+    for (const [category, tools] of Object.entries(byCategory).sort()) {
+      lines.push(`## ${category} (${tools.length})`);
+      lines.push("");
+      for (const tool of tools) {
+        const statusIcon = tool.status === "ACTIVE" ? "✅" : tool.status === "DEPRECATED" ? "⚠️" : "❌";
+        lines.push(`### ${statusIcon} ${tool.name} v${tool.version}`);
+        lines.push("");
+        lines.push(`> \`${tool.id}\``);
+        lines.push("");
+        if (tool.description) {
+          lines.push(tool.description);
+          lines.push("");
+        }
+      }
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+export {
+  toolRegistryMarkdownRenderer
+};