@contractspec/example.agent-console 3.7.6 → 3.8.2

package/dist/visualizations/index.js

@@ -0,0 +1,188 @@
+// @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."
+    }
+  ];
+}
+export {
+  createAgentVisualizationItems,
+  AgentVisualizationSpecs,
+  AgentVisualizationRegistry,
+  AgentVisualizationRefs,
+  AgentRunStatusVisualization,
+  AgentRunEfficiencyVisualization,
+  AgentRunActivityVisualization
+};

package/dist/visualizations/selectors.d.ts

@@ -0,0 +1,3 @@
+import type { VisualizationSurfaceItem } from '@contractspec/lib.design-system';
+import type { Run } from '../ui/hooks/useRunList';
+export declare function createAgentVisualizationItems(runs: Run[]): VisualizationSurfaceItem[];

package/dist/visualizations/selectors.js

@@ -0,0 +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."
+    }
+  ];
+}
+export {
+  createAgentVisualizationItems
+};

package/dist/visualizations/selectors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.agent-console",
-  "version": "3.7.6",
+  "version": "3.8.2",
   "description": "Agent Console example - AI agent orchestration with tools, runs, and logs",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -313,6 +313,13 @@
       "node": "./dist/node/ui/AgentDashboard.js",
       "default": "./dist/ui/AgentDashboard.js"
     },
+    "./ui/AgentDashboard.visualizations": {
+      "types": "./dist/ui/AgentDashboard.visualizations.d.ts",
+      "browser": "./dist/browser/ui/AgentDashboard.visualizations.js",
+      "bun": "./dist/ui/AgentDashboard.visualizations.js",
+      "node": "./dist/node/ui/AgentDashboard.visualizations.js",
+      "default": "./dist/ui/AgentDashboard.visualizations.js"
+    },
     "./ui/AgentRunList": {
       "types": "./dist/ui/AgentRunList.d.ts",
       "browser": "./dist/browser/ui/AgentRunList.js",
@@ -453,6 +460,27 @@
       "node": "./dist/node/ui/views/AgentListView.js",
       "default": "./dist/ui/views/AgentListView.js"
     },
+    "./ui/views/run-data-table.columns": {
+      "types": "./dist/ui/views/run-data-table.columns.d.ts",
+      "browser": "./dist/browser/ui/views/run-data-table.columns.js",
+      "bun": "./dist/ui/views/run-data-table.columns.js",
+      "node": "./dist/node/ui/views/run-data-table.columns.js",
+      "default": "./dist/ui/views/run-data-table.columns.js"
+    },
+    "./ui/views/run-list.shared": {
+      "types": "./dist/ui/views/run-list.shared.d.ts",
+      "browser": "./dist/browser/ui/views/run-list.shared.js",
+      "bun": "./dist/ui/views/run-list.shared.js",
+      "node": "./dist/node/ui/views/run-list.shared.js",
+      "default": "./dist/ui/views/run-list.shared.js"
+    },
+    "./ui/views/RunDataTable": {
+      "types": "./dist/ui/views/RunDataTable.d.ts",
+      "browser": "./dist/browser/ui/views/RunDataTable.js",
+      "bun": "./dist/ui/views/RunDataTable.js",
+      "node": "./dist/node/ui/views/RunDataTable.js",
+      "default": "./dist/ui/views/RunDataTable.js"
+    },
     "./ui/views/RunListView": {
       "types": "./dist/ui/views/RunListView.d.ts",
       "browser": "./dist/browser/ui/views/RunListView.js",
@@ -466,6 +494,27 @@
       "bun": "./dist/ui/views/ToolRegistryView.js",
       "node": "./dist/node/ui/views/ToolRegistryView.js",
       "default": "./dist/ui/views/ToolRegistryView.js"
+    },
+    "./visualizations": {
+      "types": "./dist/visualizations/index.d.ts",
+      "browser": "./dist/browser/visualizations/index.js",
+      "bun": "./dist/visualizations/index.js",
+      "node": "./dist/node/visualizations/index.js",
+      "default": "./dist/visualizations/index.js"
+    },
+    "./visualizations/catalog": {
+      "types": "./dist/visualizations/catalog.d.ts",
+      "browser": "./dist/browser/visualizations/catalog.js",
+      "bun": "./dist/visualizations/catalog.js",
+      "node": "./dist/node/visualizations/catalog.js",
+      "default": "./dist/visualizations/catalog.js"
+    },
+    "./visualizations/selectors": {
+      "types": "./dist/visualizations/selectors.d.ts",
+      "browser": "./dist/browser/visualizations/selectors.js",
+      "bun": "./dist/visualizations/selectors.js",
+      "node": "./dist/node/visualizations/selectors.js",
+      "default": "./dist/visualizations/selectors.js"
     }
   },
   "scripts": {
@@ -477,27 +526,31 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
-    "test": "bun test --pass-with-no-tests",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
+    "test": "bun test",
+    "proof": "bun ../../../scripts/generate-agent-console-meetup-proof.ts",
+    "preflight": "bun run build && bun run typecheck && bun run test && bun ../../../scripts/check-agent-console-meetup-policy.ts && bun run proof",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "3.7.6",
-    "@contractspec/lib.contracts-spec": "3.7.6",
-    "@contractspec/lib.example-shared-ui": "6.0.6",
-    "@contractspec/lib.design-system": "3.7.6",
-    "@contractspec/lib.runtime-sandbox": "2.7.6",
+    "@contractspec/lib.schema": "3.7.8",
+    "@contractspec/lib.contracts-spec": "4.1.2",
+    "@contractspec/lib.example-shared-ui": "6.0.10",
+    "@contractspec/lib.design-system": "3.8.3",
+    "@contractspec/lib.runtime-sandbox": "2.7.9",
     "react": "19.2.0",
     "react-dom": "19.2.0"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.6",
-    "typescript": "^5.9.3",
+    "@contractspec/lib.harness": "0.2.3",
+    "@contractspec/tool.bun": "3.7.8",
+    "@contractspec/tool.typescript": "3.7.8",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.2",
-    "@contractspec/tool.bun": "3.7.6"
+    "happy-dom": "^20.8.4",
+    "typescript": "^5.9.3"
   },
   "publishConfig": {
     "exports": {
@@ -809,6 +862,13 @@
         "node": "./dist/node/ui/AgentDashboard.js",
         "default": "./dist/ui/AgentDashboard.js"
       },
+      "./ui/AgentDashboard.visualizations": {
+        "types": "./dist/ui/AgentDashboard.visualizations.d.ts",
+        "browser": "./dist/browser/ui/AgentDashboard.visualizations.js",
+        "bun": "./dist/ui/AgentDashboard.visualizations.js",
+        "node": "./dist/node/ui/AgentDashboard.visualizations.js",
+        "default": "./dist/ui/AgentDashboard.visualizations.js"
+      },
       "./ui/AgentRunList": {
         "types": "./dist/ui/AgentRunList.d.ts",
         "browser": "./dist/browser/ui/AgentRunList.js",
@@ -949,6 +1009,27 @@
         "node": "./dist/node/ui/views/AgentListView.js",
         "default": "./dist/ui/views/AgentListView.js"
       },
+      "./ui/views/run-data-table.columns": {
+        "types": "./dist/ui/views/run-data-table.columns.d.ts",
+        "browser": "./dist/browser/ui/views/run-data-table.columns.js",
+        "bun": "./dist/ui/views/run-data-table.columns.js",
+        "node": "./dist/node/ui/views/run-data-table.columns.js",
+        "default": "./dist/ui/views/run-data-table.columns.js"
+      },
+      "./ui/views/run-list.shared": {
+        "types": "./dist/ui/views/run-list.shared.d.ts",
+        "browser": "./dist/browser/ui/views/run-list.shared.js",
+        "bun": "./dist/ui/views/run-list.shared.js",
+        "node": "./dist/node/ui/views/run-list.shared.js",
+        "default": "./dist/ui/views/run-list.shared.js"
+      },
+      "./ui/views/RunDataTable": {
+        "types": "./dist/ui/views/RunDataTable.d.ts",
+        "browser": "./dist/browser/ui/views/RunDataTable.js",
+        "bun": "./dist/ui/views/RunDataTable.js",
+        "node": "./dist/node/ui/views/RunDataTable.js",
+        "default": "./dist/ui/views/RunDataTable.js"
+      },
       "./ui/views/RunListView": {
         "types": "./dist/ui/views/RunListView.d.ts",
         "browser": "./dist/browser/ui/views/RunListView.js",
@@ -962,6 +1043,27 @@
         "bun": "./dist/ui/views/ToolRegistryView.js",
         "node": "./dist/node/ui/views/ToolRegistryView.js",
         "default": "./dist/ui/views/ToolRegistryView.js"
+      },
+      "./visualizations": {
+        "types": "./dist/visualizations/index.d.ts",
+        "browser": "./dist/browser/visualizations/index.js",
+        "bun": "./dist/visualizations/index.js",
+        "node": "./dist/node/visualizations/index.js",
+        "default": "./dist/visualizations/index.js"
+      },
+      "./visualizations/catalog": {
+        "types": "./dist/visualizations/catalog.d.ts",
+        "browser": "./dist/browser/visualizations/catalog.js",
+        "bun": "./dist/visualizations/catalog.js",
+        "node": "./dist/node/visualizations/catalog.js",
+        "default": "./dist/visualizations/catalog.js"
+      },
+      "./visualizations/selectors": {
+        "types": "./dist/visualizations/selectors.d.ts",
+        "browser": "./dist/browser/visualizations/selectors.js",
+        "bun": "./dist/visualizations/selectors.js",
+        "node": "./dist/node/visualizations/selectors.js",
+        "default": "./dist/visualizations/selectors.js"
       }
     },
     "registry": "https://registry.npmjs.org/",