@contractspec/example.agent-console 3.7.6 → 3.8.2

package/src/run/run.presentation.ts

@@ -1,6 +1,6 @@
 import {
-  StabilityEnum,
-  definePresentation,
+	definePresentation,
+	StabilityEnum,
 } from '@contractspec/lib.contracts-spec';
 import { RunSummaryModel } from './run.schema';
 
@@ -8,50 +8,50 @@ import { RunSummaryModel } from './run.schema';
  * Presentation for displaying a list of agent runs.
  */
 export const RunListPresentation = definePresentation({
-  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: StabilityEnum.Experimental,
-  },
-  source: {
-    type: 'component',
-    framework: 'react',
-    componentKey: 'RunListView',
-    props: RunSummaryModel,
-  },
-  targets: ['react', 'markdown', 'application/json'],
-  policy: { flags: ['agent-console.enabled'] },
+	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: StabilityEnum.Experimental,
+	},
+	source: {
+		type: 'component',
+		framework: 'react',
+		componentKey: 'RunListView',
+		props: RunSummaryModel,
+	},
+	targets: ['react', 'markdown', 'application/json'],
+	policy: { flags: ['agent-console.enabled'] },
 });
 
 /**
  * Presentation for run detail view.
  */
 export const RunDetailPresentation = definePresentation({
-  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: StabilityEnum.Experimental,
-  },
-  source: {
-    type: 'component',
-    framework: 'react',
-    componentKey: 'RunDetailView',
-  },
-  targets: ['react', 'markdown'],
-  policy: { flags: ['agent-console.enabled'] },
+	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: StabilityEnum.Experimental,
+	},
+	source: {
+		type: 'component',
+		framework: 'react',
+		componentKey: 'RunDetailView',
+	},
+	targets: ['react', 'markdown'],
+	policy: { flags: ['agent-console.enabled'] },
 });

package/src/run/run.schema.ts

@@ -1,169 +1,169 @@
 import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
-import { RunStatusEnum, RunStepTypeEnum, LogLevelEnum } from './run.enum';
+import { LogLevelEnum, RunStatusEnum, RunStepTypeEnum } from './run.enum';
 
 /**
  * Input data for agent execution.
  */
 export const RunInputModel = defineSchemaModel({
-  name: 'RunInput',
-  description: 'Input data for agent execution',
-  fields: {
-    message: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    context: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-  },
+	name: 'RunInput',
+	description: 'Input data for agent execution',
+	fields: {
+		message: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+		context: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+	},
 });
 
 /**
  * Individual step within a run.
  */
 export const RunStepModel = defineSchemaModel({
-  name: 'RunStep',
-  description: 'Individual step within a run',
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    stepNumber: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    type: { type: RunStepTypeEnum, isOptional: false },
-    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    input: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    status: { type: RunStatusEnum, isOptional: false },
-    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    tokensUsed: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0,
-    },
-    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-  },
+	name: 'RunStep',
+	description: 'Individual step within a run',
+	fields: {
+		id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		stepNumber: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+		type: { type: RunStepTypeEnum, isOptional: false },
+		toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		input: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+		output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+		status: { type: RunStatusEnum, isOptional: false },
+		errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		tokensUsed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false,
+			defaultValue: 0,
+		},
+		durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+		startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+		completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+	},
 });
 
 /**
  * Execution log entry.
  */
 export const RunLogModel = defineSchemaModel({
-  name: 'RunLog',
-  description: 'Execution log entry',
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    level: { type: LogLevelEnum, isOptional: false },
-    message: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    data: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    source: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    spanId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-  },
+	name: 'RunLog',
+	description: 'Execution log entry',
+	fields: {
+		id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		level: { type: LogLevelEnum, isOptional: false },
+		message: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		data: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+		source: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		spanId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+	},
 });
 
 /**
  * Agent reference in a run.
  */
 export const RunAgentRefModel = defineSchemaModel({
-  name: 'RunAgentRef',
-  description: 'Agent reference in a run',
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    modelProvider: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    modelName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'RunAgentRef',
+	description: 'Agent reference in a run',
+	fields: {
+		id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+		modelProvider: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		modelName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 /**
  * Agent execution instance.
  */
 export const RunModel = defineSchemaModel({
-  name: 'Run',
-  description: 'Agent execution instance',
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    input: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
-    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    status: { type: RunStatusEnum, isOptional: false },
-    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    errorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    totalTokens: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0,
-    },
-    promptTokens: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0,
-    },
-    completionTokens: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0,
-    },
-    totalIterations: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 0,
-    },
-    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    estimatedCostUsd: {
-      type: ScalarTypeEnum.Float_unsecure(),
-      isOptional: true,
-    },
-    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    metadata: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    steps: { type: RunStepModel, isArray: true, isOptional: true },
-    logs: { type: RunLogModel, isArray: true, isOptional: true },
-    agent: { type: RunAgentRefModel, isOptional: true },
-  },
+	name: 'Run',
+	description: 'Agent execution instance',
+	fields: {
+		id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		organizationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		input: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
+		output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+		status: { type: RunStatusEnum, isOptional: false },
+		errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		errorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		totalTokens: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false,
+			defaultValue: 0,
+		},
+		promptTokens: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false,
+			defaultValue: 0,
+		},
+		completionTokens: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false,
+			defaultValue: 0,
+		},
+		totalIterations: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false,
+			defaultValue: 0,
+		},
+		durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+		estimatedCostUsd: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true,
+		},
+		queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+		startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+		completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+		metadata: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+		steps: { type: RunStepModel, isArray: true, isOptional: true },
+		logs: { type: RunLogModel, isArray: true, isOptional: true },
+		agent: { type: RunAgentRefModel, isOptional: true },
+	},
 });
 
 /**
  * Summary of a run for list views.
  */
 export const RunSummaryModel = defineSchemaModel({
-  name: 'RunSummary',
-  description: 'Summary of a run for list views',
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    agentName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    status: { type: RunStatusEnum, isOptional: false },
-    totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    estimatedCostUsd: {
-      type: ScalarTypeEnum.Float_unsecure(),
-      isOptional: true,
-    },
-    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-  },
+	name: 'RunSummary',
+	description: 'Summary of a run for list views',
+	fields: {
+		id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		agentName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+		status: { type: RunStatusEnum, isOptional: false },
+		totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+		durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+		estimatedCostUsd: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true,
+		},
+		queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+		completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+	},
 });
 
 /**
  * Timeline data point for metrics.
  */
 export const TimelineDataPointModel = defineSchemaModel({
-  name: 'TimelineDataPoint',
-  description: 'Timeline data point for metrics',
-  fields: {
-    period: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    runs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    tokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    costUsd: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
-    avgDurationMs: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
-  },
+	name: 'TimelineDataPoint',
+	description: 'Timeline data point for metrics',
+	fields: {
+		period: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		runs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+		tokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+		costUsd: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+		avgDurationMs: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+	},
 });

package/src/run/run.test-spec.ts

@@ -1,55 +1,55 @@
 import { defineTestSpec } from '@contractspec/lib.contracts-spec/tests';
 
 export const runListTest = defineTestSpec({
-  meta: {
-    key: 'test.agent.run.list',
-    version: '1.0.0',
-    owners: ['@agent-console-team'],
-    description: 'Test for listing runs',
-    stability: 'stable',
-    tags: ['test'],
-  },
-  target: {
-    type: 'operation',
-    operation: { key: 'agent.run.list', version: '1.0.0' },
-  },
-  scenarios: [
-    {
-      key: 'success',
-      when: { operation: { key: 'agent.run.list' } },
-      then: [{ type: 'expectOutput', match: {} }],
-    },
-    {
-      key: 'error',
-      when: { operation: { key: 'agent.run.list' } },
-      then: [{ type: 'expectError' }],
-    },
-  ],
+	meta: {
+		key: 'test.agent.run.list',
+		version: '1.0.0',
+		owners: ['@agent-console-team'],
+		description: 'Test for listing runs',
+		stability: 'stable',
+		tags: ['test'],
+	},
+	target: {
+		type: 'operation',
+		operation: { key: 'agent.run.list', version: '1.0.0' },
+	},
+	scenarios: [
+		{
+			key: 'success',
+			when: { operation: { key: 'agent.run.list' } },
+			then: [{ type: 'expectOutput', match: {} }],
+		},
+		{
+			key: 'error',
+			when: { operation: { key: 'agent.run.list' } },
+			then: [{ type: 'expectError' }],
+		},
+	],
 });
 
 export const runGetTest = defineTestSpec({
-  meta: {
-    key: 'test.agent.run.get',
-    version: '1.0.0',
-    owners: ['@agent-console-team'],
-    description: 'Test for getting run',
-    stability: 'stable',
-    tags: ['test'],
-  },
-  target: {
-    type: 'operation',
-    operation: { key: 'agent.run.get', version: '1.0.0' },
-  },
-  scenarios: [
-    {
-      key: 'success',
-      when: { operation: { key: 'agent.run.get' } },
-      then: [{ type: 'expectOutput', match: {} }],
-    },
-    {
-      key: 'error',
-      when: { operation: { key: 'agent.run.get' } },
-      then: [{ type: 'expectError' }],
-    },
-  ],
+	meta: {
+		key: 'test.agent.run.get',
+		version: '1.0.0',
+		owners: ['@agent-console-team'],
+		description: 'Test for getting run',
+		stability: 'stable',
+		tags: ['test'],
+	},
+	target: {
+		type: 'operation',
+		operation: { key: 'agent.run.get', version: '1.0.0' },
+	},
+	scenarios: [
+		{
+			key: 'success',
+			when: { operation: { key: 'agent.run.get' } },
+			then: [{ type: 'expectOutput', match: {} }],
+		},
+		{
+			key: 'error',
+			when: { operation: { key: 'agent.run.get' } },
+			then: [{ type: 'expectError' }],
+		},
+	],
 });

package/src/seeders/index.ts

@@ -1,29 +1,29 @@
 import type { DatabasePort } from '@contractspec/lib.runtime-sandbox';
 
 export async function seedAgentConsole(params: {
-  projectId: string;
-  db: DatabasePort;
+	projectId: string;
+	db: DatabasePort;
 }) {
-  const { projectId, db } = params;
+	const { projectId, db } = params;
 
-  const existing = await db.query(
-    `SELECT COUNT(*) as count FROM agent_definition WHERE "projectId" = $1`,
-    [projectId]
-  );
-  if ((existing.rows[0]?.count as number) > 0) return;
+	const existing = await db.query(
+		`SELECT COUNT(*) as count FROM agent_definition WHERE "projectId" = $1`,
+		[projectId]
+	);
+	if ((existing.rows[0]?.count as number) > 0) return;
 
-  await db.execute(
-    `INSERT INTO agent_definition (id, "projectId", "organizationId", name, description, "modelProvider", "modelName", status)
+	await db.execute(
+		`INSERT INTO agent_definition (id, "projectId", "organizationId", name, description, "modelProvider", "modelName", status)
      VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,
-    [
-      'agent_1',
-      projectId,
-      'org_demo',
-      'Demo Agent',
-      'A demo AI agent',
-      'openai',
-      'gpt-4',
-      'ACTIVE',
-    ]
-  );
+		[
+			'agent_1',
+			projectId,
+			'org_demo',
+			'Demo Agent',
+			'A demo AI agent',
+			'openai',
+			'gpt-4',
+			'ACTIVE',
+		]
+	);
 }

package/src/shared/demo-dashboard-data.ts

@@ -0,0 +1,58 @@
+import type { AgentHandlers } from '../handlers/agent.handlers';
+import { createAgentConsoleDemoHandlers } from './demo-runtime';
+import {
+	AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
+	AGENT_CONSOLE_DEMO_PROJECT_ID,
+} from './demo-runtime-seed';
+
+export interface AgentConsoleDashboardData {
+	agents: Awaited<ReturnType<AgentHandlers['listAgents']>>['items'];
+	runs: Awaited<ReturnType<AgentHandlers['listRuns']>>['items'];
+	tools: Awaited<ReturnType<AgentHandlers['listTools']>>['items'];
+	summary: {
+		totalAgents: number;
+		totalRuns: number;
+		totalTools: number;
+	};
+}
+
+export async function getAgentConsoleDashboardData(
+	handlers: AgentHandlers,
+	params: { projectId: string; organizationId?: string }
+): Promise<AgentConsoleDashboardData> {
+	const organizationId =
+		params.organizationId ?? AGENT_CONSOLE_DEMO_ORGANIZATION_ID;
+	const [agentsResult, runsResult, toolsResult] = await Promise.all([
+		handlers.listAgents({
+			projectId: params.projectId,
+			organizationId,
+			limit: 10,
+		}),
+		handlers.listRuns({ projectId: params.projectId, limit: 10 }),
+		handlers.listTools({
+			projectId: params.projectId,
+			organizationId,
+			limit: 10,
+		}),
+	]);
+
+	return {
+		agents: agentsResult.items,
+		runs: runsResult.items,
+		tools: toolsResult.items,
+		summary: {
+			totalAgents: agentsResult.total,
+			totalRuns: runsResult.total,
+			totalTools: toolsResult.total,
+		},
+	};
+}
+
+export async function getFallbackAgentConsoleDashboardData() {
+	const handlers = createAgentConsoleDemoHandlers({
+		projectId: AGENT_CONSOLE_DEMO_PROJECT_ID,
+	});
+	return getAgentConsoleDashboardData(handlers, {
+		projectId: AGENT_CONSOLE_DEMO_PROJECT_ID,
+	});
+}