@contractspec/example.agent-console 3.7.6 → 3.8.2

package/dist/agent/agent.operation.js

@@ -22,7 +22,7 @@ var ToolChoiceEnum = defineEnum("ToolChoice", [
 
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",

package/dist/agent/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Agent domain - AI agent configuration and management.
  */
+export { AgentEntity, AgentStatusEntityEnum, AgentToolEntity, ModelProviderEntityEnum, } from './agent.entity';
 export { AgentStatusEnum, ModelProviderEnum, ToolChoiceEnum, } from './agent.enum';
+export { AgentCreatedEvent, AgentToolAssignedEvent, AgentToolRemovedEvent, AgentUpdatedEvent, } from './agent.event';
+export { type AgentSummary, type AgentToolRef, type AgentWithTools, type GetAgentInput, type ListAgentsInput, type ListAgentsOutput, mockCreateAgentHandler, mockGetAgentHandler, mockListAgentsHandler, mockUpdateAgentHandler, } from './agent.handler';
+export { AssignToolToAgentCommand, CreateAgentCommand, GetAgentQuery, ListAgentsQuery, RemoveToolFromAgentCommand, UpdateAgentCommand, } from './agent.operation';
+export { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation, } from './agent.presentation';
 export { AgentModel, AgentSummaryModel, AgentToolRefModel, AgentWithToolsModel, CreateAgentInputModel, UpdateAgentInputModel, } from './agent.schema';
-export { CreateAgentCommand, UpdateAgentCommand, GetAgentQuery, ListAgentsQuery, AssignToolToAgentCommand, RemoveToolFromAgentCommand, } from './agent.operation';
-export { AgentCreatedEvent, AgentUpdatedEvent, AgentToolAssignedEvent, AgentToolRemovedEvent, } from './agent.event';
-export { AgentStatusEntityEnum, ModelProviderEntityEnum, AgentEntity, AgentToolEntity, } from './agent.entity';
-export { AgentListPresentation, AgentDetailPresentation, AgentConsoleDashboardPresentation, } from './agent.presentation';
-export { mockListAgentsHandler, mockGetAgentHandler, mockCreateAgentHandler, mockUpdateAgentHandler, type ListAgentsInput, type AgentSummary, type ListAgentsOutput, type GetAgentInput, type AgentToolRef, type AgentWithTools, } from './agent.handler';

package/dist/agent/index.js

@@ -144,7 +144,7 @@ var ToolChoiceEnum = defineEnum("ToolChoice", [
 
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",
@@ -477,78 +477,6 @@ var MOCK_TOOLS = [
   }
 ];
 
-// src/agent/agent.handler.ts
-async function mockListAgentsHandler(input) {
-  const {
-    organizationId,
-    status,
-    modelProvider,
-    search,
-    limit = 20,
-    offset = 0
-  } = input;
-  let filtered = MOCK_AGENTS.filter((a) => a.organizationId === organizationId);
-  if (status)
-    filtered = filtered.filter((a) => a.status === status);
-  if (modelProvider)
-    filtered = filtered.filter((a) => a.modelProvider === modelProvider);
-  if (search) {
-    const q = search.toLowerCase();
-    filtered = filtered.filter((a) => a.name.toLowerCase().includes(q) || a.description?.toLowerCase().includes(q) || a.tags?.some((t) => t.toLowerCase().includes(q)));
-  }
-  const total = filtered.length;
-  const items = filtered.slice(offset, offset + limit).map((a) => ({
-    id: a.id,
-    name: a.name,
-    slug: a.slug,
-    description: a.description,
-    status: a.status,
-    modelProvider: a.modelProvider,
-    modelName: a.modelName,
-    version: a.version,
-    createdAt: a.createdAt
-  }));
-  return { items, total, hasMore: offset + limit < total };
-}
-async function mockGetAgentHandler(input) {
-  const agent = MOCK_AGENTS.find((a) => a.id === input.agentId);
-  if (!agent)
-    throw new Error("AGENT_NOT_FOUND");
-  const result = { ...agent, toolIds: ["tool-1", "tool-2"] };
-  if (input.includeTools) {
-    result.tools = MOCK_TOOLS.slice(0, 2).map((t) => ({
-      id: t.id,
-      name: t.name,
-      slug: t.slug,
-      description: t.description,
-      category: t.category
-    }));
-  }
-  return result;
-}
-async function mockCreateAgentHandler(input) {
-  const exists = MOCK_AGENTS.some((a) => a.organizationId === input.organizationId && a.slug === input.slug);
-  if (exists)
-    throw new Error("SLUG_EXISTS");
-  return {
-    id: `agent-${Date.now()}`,
-    name: input.name,
-    slug: input.slug,
-    status: "DRAFT"
-  };
-}
-async function mockUpdateAgentHandler(input) {
-  const agent = MOCK_AGENTS.find((a) => a.id === input.agentId);
-  if (!agent)
-    throw new Error("AGENT_NOT_FOUND");
-  return {
-    id: agent.id,
-    name: input.name ?? agent.name,
-    status: input.status ?? agent.status,
-    updatedAt: new Date
-  };
-}
-
 // src/agent/agent.schema.ts
 import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var AgentModel = defineSchemaModel2({
@@ -1145,6 +1073,79 @@ var RemoveToolFromAgentCommand = defineCommand({
   }
 });
 
+// src/agent/agent.handler.ts
+var nextMockAgentId = MOCK_AGENTS.length + 1;
+async function mockListAgentsHandler(input) {
+  const {
+    organizationId,
+    status,
+    modelProvider,
+    search,
+    limit = 20,
+    offset = 0
+  } = input;
+  let filtered = MOCK_AGENTS.filter((a) => a.organizationId === organizationId);
+  if (status)
+    filtered = filtered.filter((a) => a.status === status);
+  if (modelProvider)
+    filtered = filtered.filter((a) => a.modelProvider === modelProvider);
+  if (search) {
+    const q = search.toLowerCase();
+    filtered = filtered.filter((a) => a.name.toLowerCase().includes(q) || a.description?.toLowerCase().includes(q) || a.tags?.some((t) => t.toLowerCase().includes(q)));
+  }
+  const total = filtered.length;
+  const items = filtered.slice(offset, offset + limit).map((a) => ({
+    id: a.id,
+    name: a.name,
+    slug: a.slug,
+    description: a.description,
+    status: a.status,
+    modelProvider: a.modelProvider,
+    modelName: a.modelName,
+    version: a.version,
+    createdAt: a.createdAt
+  }));
+  return { items, total, hasMore: offset + limit < total };
+}
+async function mockGetAgentHandler(input) {
+  const agent = MOCK_AGENTS.find((a) => a.id === input.agentId);
+  if (!agent)
+    throw new Error("AGENT_NOT_FOUND");
+  const result = { ...agent, toolIds: ["tool-1", "tool-2"] };
+  if (input.includeTools) {
+    result.tools = MOCK_TOOLS.slice(0, 2).map((t) => ({
+      id: t.id,
+      name: t.name,
+      slug: t.slug,
+      description: t.description,
+      category: t.category
+    }));
+  }
+  return result;
+}
+async function mockCreateAgentHandler(input) {
+  const exists = MOCK_AGENTS.some((a) => a.organizationId === input.organizationId && a.slug === input.slug);
+  if (exists)
+    throw new Error("SLUG_EXISTS");
+  return {
+    id: `agent-${nextMockAgentId++}`,
+    name: input.name,
+    slug: input.slug,
+    status: "DRAFT"
+  };
+}
+async function mockUpdateAgentHandler(input) {
+  const agent = MOCK_AGENTS.find((a) => a.id === input.agentId);
+  if (!agent)
+    throw new Error("AGENT_NOT_FOUND");
+  return {
+    id: agent.id,
+    name: input.name ?? agent.name,
+    status: input.status ?? agent.status,
+    updatedAt: new Date
+  };
+}
+
 // src/agent/agent.presentation.ts
 import {
   definePresentation,

package/dist/agent.feature.js

@@ -1,4 +1,182 @@
 // @bun
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var RUN_LIST_REF = { key: "agent.run.list", version: "1.0.0" };
+var META = {
+  version: "1.0.0",
+  domain: "ai-ops",
+  stability: "experimental",
+  owners: ["@example.agent-console"],
+  tags: ["agent-console", "visualization", "operations"]
+};
+var AgentRunStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "agent-console.visualization.run-status",
+    title: "Run Status Breakdown",
+    description: "Distribution of run outcomes across the current sample.",
+    goal: "Make operational success and failure mix visible at a glance.",
+    context: "Agent operations overview."
+  },
+  source: { primary: RUN_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "status",
+    valueMeasure: "runs",
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      { key: "runs", label: "Runs", dataPath: "runs", format: "number" }
+    ],
+    table: { caption: "Run counts by status." }
+  }
+});
+var AgentRunActivityVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "agent-console.visualization.run-activity",
+    title: "Recent Run Activity",
+    description: "Daily run volume across the current sample.",
+    goal: "Show whether agent activity is rising or slowing down.",
+    context: "Operations trend monitoring."
+  },
+  source: { primary: RUN_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "line",
+    xDimension: "day",
+    yMeasures: ["runs"],
+    dimensions: [{ key: "day", label: "Day", dataPath: "day", type: "time" }],
+    measures: [
+      {
+        key: "runs",
+        label: "Runs",
+        dataPath: "runs",
+        format: "number",
+        color: "#0f766e"
+      }
+    ],
+    table: { caption: "Daily run counts." }
+  }
+});
+var AgentRunEfficiencyVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "agent-console.visualization.run-efficiency",
+    title: "Duration vs Tokens",
+    description: "Scatter chart comparing token consumption and runtime.",
+    goal: "Reveal outlier runs that are slow relative to their token usage.",
+    context: "Operational performance diagnostics."
+  },
+  source: { primary: RUN_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "scatter",
+    xDimension: "totalTokens",
+    yMeasures: ["durationMs"],
+    dimensions: [
+      {
+        key: "totalTokens",
+        label: "Total Tokens",
+        dataPath: "totalTokens",
+        type: "number"
+      }
+    ],
+    measures: [
+      {
+        key: "durationMs",
+        label: "Duration",
+        dataPath: "durationMs",
+        format: "duration",
+        color: "#7c3aed"
+      },
+      {
+        key: "estimatedCostUsd",
+        label: "Cost",
+        dataPath: "estimatedCostUsd",
+        format: "currency"
+      }
+    ],
+    series: [
+      {
+        key: "runs",
+        label: "Runs",
+        measure: "durationMs",
+        type: "scatter",
+        color: "#7c3aed"
+      }
+    ],
+    table: { caption: "Run duration versus token usage." }
+  }
+});
+var AgentVisualizationSpecs = [
+  AgentRunStatusVisualization,
+  AgentRunActivityVisualization,
+  AgentRunEfficiencyVisualization
+];
+var AgentVisualizationRegistry = new VisualizationRegistry([
+  ...AgentVisualizationSpecs
+]);
+var AgentVisualizationRefs = AgentVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+
+// src/visualizations/selectors.ts
+function dayKey(value) {
+  if (!value)
+    return "unknown";
+  return value.toISOString().slice(0, 10);
+}
+function createAgentVisualizationItems(runs) {
+  const statusCounts = new Map;
+  const activityCounts = new Map;
+  for (const run of runs) {
+    statusCounts.set(run.status, (statusCounts.get(run.status) ?? 0) + 1);
+    activityCounts.set(dayKey(run.startedAt ?? run.queuedAt), (activityCounts.get(dayKey(run.startedAt ?? run.queuedAt)) ?? 0) + 1);
+  }
+  return [
+    {
+      key: "run-status",
+      spec: AgentRunStatusVisualization,
+      data: {
+        data: Array.from(statusCounts.entries()).map(([status, count]) => ({
+          status,
+          runs: count
+        }))
+      },
+      title: "Run Status Breakdown",
+      description: "Completed, failed, running, and cancelled runs in the sample.",
+      height: 260
+    },
+    {
+      key: "run-activity",
+      spec: AgentRunActivityVisualization,
+      data: {
+        data: Array.from(activityCounts.entries()).sort(([left], [right]) => left.localeCompare(right)).map(([day, count]) => ({ day, runs: count }))
+      },
+      title: "Recent Run Activity",
+      description: "Daily run volume derived from run start times."
+    },
+    {
+      key: "run-efficiency",
+      spec: AgentRunEfficiencyVisualization,
+      data: {
+        data: runs.filter((run) => typeof run.durationMs === "number").map((run) => ({
+          totalTokens: run.totalTokens,
+          durationMs: run.durationMs ?? 0,
+          estimatedCostUsd: run.estimatedCostUsd
+        }))
+      },
+      title: "Duration vs Tokens",
+      description: "Operational scatter plot for spotting inefficient runs."
+    }
+  ];
+}
 // src/agent.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var AgentConsoleFeature = defineFeature({
@@ -105,6 +283,7 @@ var AgentConsoleFeature = defineFeature({
       targets: ["react", "markdown", "application/json"]
     }
   ],
+  visualizations: AgentVisualizationRefs,
   capabilities: {
     requires: [
       { key: "identity", version: "1.0.0" },

package/dist/browser/agent/agent.event.js

@@ -1,6 +1,6 @@
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",