@contractspec/example.agent-console 3.7.6 → 3.8.2

package/dist/node/visualizations/index.js

@@ -0,0 +1,187 @@
+// 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/node/visualizations/selectors.js

@@ -0,0 +1,181 @@
+// 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/presentations/index.d.ts

@@ -1,8 +1,6 @@
 /**
  * Agent Console Presentations - re-exports from domain modules for backward compatibility.
  */
-export { AgentListPresentation, AgentDetailPresentation, AgentConsoleDashboardPresentation, } from '../agent/agent.presentation';
-export { RunListPresentation, RunDetailPresentation, } from '../run/run.presentation';
-export { RunDetailPresentation as RunMetricsPresentation } from '../run/run.presentation';
-export { ToolListPresentation, ToolDetailPresentation, } from '../tool/tool.presentation';
-export { ToolListPresentation as ToolRegistryPresentation } from '../tool/tool.presentation';
+export { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation, } from '../agent/agent.presentation';
+export { RunDetailPresentation, RunDetailPresentation as RunMetricsPresentation, RunListPresentation, } from '../run/run.presentation';
+export { ToolDetailPresentation, ToolListPresentation, ToolListPresentation as ToolRegistryPresentation, } from '../tool/tool.presentation';

package/dist/presentations/index.js

@@ -448,55 +448,6 @@ var TimelineDataPointModel = defineSchemaModel2({
   }
 });
 
-// src/run/run.presentation.ts
-import {
-  StabilityEnum as StabilityEnum2,
-  definePresentation as definePresentation2
-} from "@contractspec/lib.contracts-spec";
-var RunListPresentation = definePresentation2({
-  meta: {
-    key: "agent-console.run.list",
-    version: "1.0.0",
-    title: "Run List",
-    description: "List view of agent runs with status, tokens, and duration info",
-    goal: "Provide an overview of agent execution history and performance.",
-    context: "Run history dashboard.",
-    domain: "agent-console",
-    owners: ["@agent-console-team"],
-    tags: ["run", "list", "dashboard"],
-    stability: StabilityEnum2.Experimental
-  },
-  source: {
-    type: "component",
-    framework: "react",
-    componentKey: "RunListView",
-    props: RunSummaryModel
-  },
-  targets: ["react", "markdown", "application/json"],
-  policy: { flags: ["agent-console.enabled"] }
-});
-var RunDetailPresentation = definePresentation2({
-  meta: {
-    key: "agent-console.run.detail",
-    version: "1.0.0",
-    title: "Run Details",
-    description: "Detailed view of an agent run with steps, logs, and metrics",
-    goal: "Allow users to inspect and debug a specific agent run.",
-    context: "Detailed view of an agent run.",
-    domain: "agent-console",
-    owners: ["@agent-console-team"],
-    tags: ["run", "detail"],
-    stability: StabilityEnum2.Experimental
-  },
-  source: {
-    type: "component",
-    framework: "react",
-    componentKey: "RunDetailView"
-  },
-  targets: ["react", "markdown"],
-  policy: { flags: ["agent-console.enabled"] }
-});
-
 // src/tool/tool.enum.ts
 import { defineEnum as defineEnum3 } from "@contractspec/lib.schema";
 var ToolCategoryEnum = defineEnum3("ToolCategory", [
@@ -633,10 +584,59 @@ var UpdateToolInputModel = defineSchemaModel3({
   }
 });
 
+// src/run/run.presentation.ts
+import {
+  definePresentation as definePresentation2,
+  StabilityEnum as StabilityEnum2
+} from "@contractspec/lib.contracts-spec";
+var RunListPresentation = definePresentation2({
+  meta: {
+    key: "agent-console.run.list",
+    version: "1.0.0",
+    title: "Run List",
+    description: "List view of agent runs with status, tokens, and duration info",
+    goal: "Provide an overview of agent execution history and performance.",
+    context: "Run history dashboard.",
+    domain: "agent-console",
+    owners: ["@agent-console-team"],
+    tags: ["run", "list", "dashboard"],
+    stability: StabilityEnum2.Experimental
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "RunListView",
+    props: RunSummaryModel
+  },
+  targets: ["react", "markdown", "application/json"],
+  policy: { flags: ["agent-console.enabled"] }
+});
+var RunDetailPresentation = definePresentation2({
+  meta: {
+    key: "agent-console.run.detail",
+    version: "1.0.0",
+    title: "Run Details",
+    description: "Detailed view of an agent run with steps, logs, and metrics",
+    goal: "Allow users to inspect and debug a specific agent run.",
+    context: "Detailed view of an agent run.",
+    domain: "agent-console",
+    owners: ["@agent-console-team"],
+    tags: ["run", "detail"],
+    stability: StabilityEnum2.Experimental
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "RunDetailView"
+  },
+  targets: ["react", "markdown"],
+  policy: { flags: ["agent-console.enabled"] }
+});
+
 // src/tool/tool.presentation.ts
 import {
-  StabilityEnum as StabilityEnum3,
-  definePresentation as definePresentation3
+  definePresentation as definePresentation3,
+  StabilityEnum as StabilityEnum3
 } from "@contractspec/lib.contracts-spec";
 var ToolListPresentation = definePresentation3({
   meta: {

package/dist/proof/index.d.ts

@@ -0,0 +1,2 @@
+export * from './meetup-proof.scenario';
+export * from './meetup-proof.suite';

package/dist/proof/meetup-proof.d.ts

@@ -0,0 +1,10 @@
+import { type HarnessReplaySink } from '@contractspec/lib.harness';
+export declare function runAgentConsoleMeetupProof(input?: {
+    projectId?: string;
+    organizationId?: string;
+    replaySink?: HarnessReplaySink;
+}): Promise<{
+    evaluation: import("@contractspec/lib.harness").HarnessScenarioEvaluationResult;
+    replayBundle: never;
+    replayUri: string | undefined;
+}>;

package/dist/proof/meetup-proof.runtime.d.ts

@@ -0,0 +1,22 @@
+import type { HarnessArtifactQuery, HarnessArtifactStore, HarnessExecutionAdapter, HarnessStoredArtifact } from '@contractspec/lib.harness';
+import type { AgentHandlers } from '../handlers/agent.handlers';
+export declare class MemoryArtifactStore implements HarnessArtifactStore {
+    private readonly items;
+    put(artifact: HarnessStoredArtifact): Promise<HarnessStoredArtifact>;
+    get(artifactId: string): Promise<HarnessStoredArtifact | undefined>;
+    list(query?: HarnessArtifactQuery): Promise<HarnessStoredArtifact[]>;
+}
+export declare function createProofNow(): () => Date;
+export declare function createProofIdFactory(prefix: string): () => string;
+export declare function createMeetupEntityIdFactory(): (kind: "agent" | "run") => string;
+interface MeetupExecutionState {
+    agentId: string;
+    runId: string;
+}
+export declare function createMeetupProofAdapter(input: {
+    handlers: AgentHandlers;
+    projectId: string;
+    organizationId: string;
+    state: MeetupExecutionState;
+}): HarnessExecutionAdapter;
+export {};

package/dist/proof/meetup-proof.scenario.d.ts

@@ -0,0 +1,2 @@
+export declare const MEETUP_AGENT_NAME = "Paris Meetup Demo Agent";
+export declare const AGENT_CONSOLE_MEETUP_PROOF_SCENARIO: import("@contractspec/lib.contracts-spec").HarnessScenarioSpec;

package/dist/proof/meetup-proof.suite.d.ts

@@ -0,0 +1 @@
+export declare const AgentConsoleMeetupProofSuite: import("@contractspec/lib.contracts-spec").HarnessSuiteSpec;

package/dist/proof/meetup-proof.test.d.ts

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

package/dist/run/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Run domain - Agent execution and monitoring.
  */
-export { RunStatusEnum, RunStepTypeEnum, LogLevelEnum, GranularityEnum, } from './run.enum';
-export { RunInputModel, RunStepModel, RunLogModel, RunAgentRefModel, RunModel, RunSummaryModel, TimelineDataPointModel, } from './run.schema';
-export { ExecuteAgentCommand, CancelRunCommand, GetRunQuery, ListRunsQuery, GetRunStepsQuery, GetRunLogsQuery, GetRunMetricsQuery, } from './run.operation';
-export { RunStartedEvent, RunCompletedEvent, RunFailedEvent, RunCancelledEvent, ToolInvokedEvent, ToolCompletedEvent, MessageGeneratedEvent, } from './run.event';
-export { RunStatusEntityEnum, RunStepTypeEntityEnum, LogLevelEntityEnum, RunEntity, RunStepEntity, RunLogEntity, } from './run.entity';
-export { RunListPresentation, RunDetailPresentation } from './run.presentation';
-export { mockListRunsHandler, mockGetRunHandler, mockExecuteAgentHandler, mockCancelRunHandler, type ListRunsInput, type RunSummary, type ListRunsOutput, } from './run.handler';
+export { LogLevelEntityEnum, RunEntity, RunLogEntity, RunStatusEntityEnum, RunStepEntity, RunStepTypeEntityEnum, } from './run.entity';
+export { GranularityEnum, LogLevelEnum, RunStatusEnum, RunStepTypeEnum, } from './run.enum';
+export { MessageGeneratedEvent, RunCancelledEvent, RunCompletedEvent, RunFailedEvent, RunStartedEvent, ToolCompletedEvent, ToolInvokedEvent, } from './run.event';
+export { type ListRunsInput, type ListRunsOutput, mockCancelRunHandler, mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler, type RunSummary, } from './run.handler';
+export { CancelRunCommand, ExecuteAgentCommand, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, ListRunsQuery, } from './run.operation';
+export { RunDetailPresentation, RunListPresentation } from './run.presentation';
+export { RunAgentRefModel, RunInputModel, RunLogModel, RunModel, RunStepModel, RunSummaryModel, TimelineDataPointModel, } from './run.schema';