@contractspec/example.agent-console 3.7.6 → 3.8.2

package/src/agent/index.ts

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

package/src/agent.capability.ts

@@ -1,16 +1,16 @@
 import {
-  defineCapability,
-  StabilityEnum,
+	defineCapability,
+	StabilityEnum,
 } from '@contractspec/lib.contracts-spec';
 
 export const AgentCapability = defineCapability({
-  meta: {
-    key: 'agent',
-    version: '1.0.0',
-    kind: 'ui',
-    stability: StabilityEnum.Experimental,
-    description: 'AI agent management and console capability',
-    owners: ['platform.core'],
-    tags: ['agent', 'ai', 'console'],
-  },
+	meta: {
+		key: 'agent',
+		version: '1.0.0',
+		kind: 'ui',
+		stability: StabilityEnum.Experimental,
+		description: 'AI agent management and console capability',
+		owners: ['platform.core'],
+		tags: ['agent', 'ai', 'console'],
+	},
 });

package/src/agent.feature.ts

@@ -5,154 +5,157 @@
  */
 import type { FeatureModuleSpec } from '@contractspec/lib.contracts-spec';
 import { defineFeature } from '@contractspec/lib.contracts-spec';
+import { AgentVisualizationRefs } from './visualizations';
 
 /**
  * Agent Console feature module that bundles all agent, tool, and run
  * operations, events, and presentations into an installable feature.
  */
 export const AgentConsoleFeature: FeatureModuleSpec = defineFeature({
-  meta: {
-    key: 'agent-console',
-    version: '1.0.0',
-    title: 'AI Agent Console',
-    description: 'AI agent orchestration with tools, runs, and logs management',
-    domain: 'ai-ops',
-    owners: ['@agent-console-team'],
-    tags: ['ai', 'agents', 'orchestration'],
-    stability: 'stable',
-  },
+	meta: {
+		key: 'agent-console',
+		version: '1.0.0',
+		title: 'AI Agent Console',
+		description: 'AI agent orchestration with tools, runs, and logs management',
+		domain: 'ai-ops',
+		owners: ['@agent-console-team'],
+		tags: ['ai', 'agents', 'orchestration'],
+		stability: 'stable',
+	},
 
-  // All contract operations included in this feature
-  operations: [
-    // Agent operations
-    { key: 'agent-console.agent.create', version: '1.0.0' },
-    { key: 'agent-console.agent.update', version: '1.0.0' },
-    { key: 'agent-console.agent.get', version: '1.0.0' },
-    { key: 'agent-console.agent.list', version: '1.0.0' },
-    { key: 'agent-console.agent.assignTool', version: '1.0.0' },
-    { key: 'agent-console.agent.removeTool', version: '1.0.0' },
+	// All contract operations included in this feature
+	operations: [
+		// Agent operations
+		{ key: 'agent-console.agent.create', version: '1.0.0' },
+		{ key: 'agent-console.agent.update', version: '1.0.0' },
+		{ key: 'agent-console.agent.get', version: '1.0.0' },
+		{ key: 'agent-console.agent.list', version: '1.0.0' },
+		{ key: 'agent-console.agent.assignTool', version: '1.0.0' },
+		{ key: 'agent-console.agent.removeTool', version: '1.0.0' },
 
-    // Tool operations
-    { key: 'agent.tool.create', version: '1.0.0' },
-    { key: 'agent.tool.update', version: '1.0.0' },
-    { key: 'agent.tool.get', version: '1.0.0' },
-    { key: 'agent.tool.list', version: '1.0.0' },
-    { key: 'agent.tool.test', version: '1.0.0' },
+		// Tool operations
+		{ key: 'agent.tool.create', version: '1.0.0' },
+		{ key: 'agent.tool.update', version: '1.0.0' },
+		{ key: 'agent.tool.get', version: '1.0.0' },
+		{ key: 'agent.tool.list', version: '1.0.0' },
+		{ key: 'agent.tool.test', version: '1.0.0' },
 
-    // Run operations
-    { key: 'agent.run.execute', version: '1.0.0' },
-    { key: 'agent.run.cancel', version: '1.0.0' },
-    { key: 'agent.run.get', version: '1.0.0' },
-    { key: 'agent.run.list', version: '1.0.0' },
-    { key: 'agent.run.getSteps', version: '1.0.0' },
-    { key: 'agent.run.getLogs', version: '1.0.0' },
-    { key: 'agent.run.getMetrics', version: '1.0.0' },
-  ],
+		// Run operations
+		{ key: 'agent.run.execute', version: '1.0.0' },
+		{ key: 'agent.run.cancel', version: '1.0.0' },
+		{ key: 'agent.run.get', version: '1.0.0' },
+		{ key: 'agent.run.list', version: '1.0.0' },
+		{ key: 'agent.run.getSteps', version: '1.0.0' },
+		{ key: 'agent.run.getLogs', version: '1.0.0' },
+		{ key: 'agent.run.getMetrics', version: '1.0.0' },
+	],
 
-  // Events emitted by this feature
-  events: [
-    // Agent events
-    { key: 'agent-console.agent.created', version: '1.0.0' },
-    { key: 'agent-console.agent.updated', version: '1.0.0' },
-    { key: 'agent-console.agent.toolAssigned', version: '1.0.0' },
-    { key: 'agent-console.agent.toolRemoved', version: '1.0.0' },
+	// Events emitted by this feature
+	events: [
+		// Agent events
+		{ key: 'agent-console.agent.created', version: '1.0.0' },
+		{ key: 'agent-console.agent.updated', version: '1.0.0' },
+		{ key: 'agent-console.agent.toolAssigned', version: '1.0.0' },
+		{ key: 'agent-console.agent.toolRemoved', version: '1.0.0' },
 
-    // Tool events
-    { key: 'agent.tool.created', version: '1.0.0' },
-    { key: 'agent.tool.updated', version: '1.0.0' },
-    { key: 'agent.tool.statusChanged', version: '1.0.0' },
+		// Tool events
+		{ key: 'agent.tool.created', version: '1.0.0' },
+		{ key: 'agent.tool.updated', version: '1.0.0' },
+		{ key: 'agent.tool.statusChanged', version: '1.0.0' },
 
-    // Run events
-    { key: 'agent.run.started', version: '1.0.0' },
-    { key: 'agent.run.completed', version: '1.0.0' },
-    { key: 'agent.run.failed', version: '1.0.0' },
-    { key: 'agent.run.cancelled', version: '1.0.0' },
-    { key: 'agent.run.toolInvoked', version: '1.0.0' },
-    { key: 'agent.run.toolCompleted', version: '1.0.0' },
-    { key: 'agent.run.messageGenerated', version: '1.0.0' },
-  ],
+		// Run events
+		{ key: 'agent.run.started', version: '1.0.0' },
+		{ key: 'agent.run.completed', version: '1.0.0' },
+		{ key: 'agent.run.failed', version: '1.0.0' },
+		{ key: 'agent.run.cancelled', version: '1.0.0' },
+		{ key: 'agent.run.toolInvoked', version: '1.0.0' },
+		{ key: 'agent.run.toolCompleted', version: '1.0.0' },
+		{ key: 'agent.run.messageGenerated', version: '1.0.0' },
+	],
 
-  // Presentations associated with this feature
-  presentations: [
-    { key: 'agent-console.dashboard', version: '1.0.0' },
-    { key: 'agent-console.agent.viewList', version: '1.0.0' },
-    { key: 'agent-console.agent.detail', version: '1.0.0' },
-    { key: 'agent-console.run.list', version: '1.0.0' },
-    { key: 'agent-console.run.detail', version: '1.0.0' },
-    { key: 'agent-console.tool.list', version: '1.0.0' },
-    { key: 'agent-console.tool.detail', version: '1.0.0' },
-  ],
+	// Presentations associated with this feature
+	presentations: [
+		{ key: 'agent-console.dashboard', version: '1.0.0' },
+		{ key: 'agent-console.agent.viewList', version: '1.0.0' },
+		{ key: 'agent-console.agent.detail', version: '1.0.0' },
+		{ key: 'agent-console.run.list', version: '1.0.0' },
+		{ key: 'agent-console.run.detail', version: '1.0.0' },
+		{ key: 'agent-console.tool.list', version: '1.0.0' },
+		{ key: 'agent-console.tool.detail', version: '1.0.0' },
+	],
 
-  // Link operations to their primary presentations
-  opToPresentation: [
-    {
-      op: { key: 'agent-console.agent.list', version: '1.0.0' },
-      pres: { key: 'agent-console.agent.viewList', version: '1.0.0' },
-    },
-    {
-      op: { key: 'agent-console.agent.get', version: '1.0.0' },
-      pres: { key: 'agent-console.agent.detail', version: '1.0.0' },
-    },
-    {
-      op: { key: 'agent.run.list', version: '1.0.0' },
-      pres: { key: 'agent-console.run.list', version: '1.0.0' },
-    },
-    {
-      op: { key: 'agent.run.get', version: '1.0.0' },
-      pres: { key: 'agent-console.run.detail', version: '1.0.0' },
-    },
-    {
-      op: { key: 'agent.tool.list', version: '1.0.0' },
-      pres: { key: 'agent-console.tool.list', version: '1.0.0' },
-    },
-    {
-      op: { key: 'agent.tool.get', version: '1.0.0' },
-      pres: { key: 'agent-console.tool.detail', version: '1.0.0' },
-    },
-  ],
+	// Link operations to their primary presentations
+	opToPresentation: [
+		{
+			op: { key: 'agent-console.agent.list', version: '1.0.0' },
+			pres: { key: 'agent-console.agent.viewList', version: '1.0.0' },
+		},
+		{
+			op: { key: 'agent-console.agent.get', version: '1.0.0' },
+			pres: { key: 'agent-console.agent.detail', version: '1.0.0' },
+		},
+		{
+			op: { key: 'agent.run.list', version: '1.0.0' },
+			pres: { key: 'agent-console.run.list', version: '1.0.0' },
+		},
+		{
+			op: { key: 'agent.run.get', version: '1.0.0' },
+			pres: { key: 'agent-console.run.detail', version: '1.0.0' },
+		},
+		{
+			op: { key: 'agent.tool.list', version: '1.0.0' },
+			pres: { key: 'agent-console.tool.list', version: '1.0.0' },
+		},
+		{
+			op: { key: 'agent.tool.get', version: '1.0.0' },
+			pres: { key: 'agent-console.tool.detail', version: '1.0.0' },
+		},
+	],
 
-  // Target requirements for multi-surface rendering
-  presentationsTargets: [
-    {
-      key: 'agent-console.dashboard',
-      version: '1.0.0',
-      targets: ['react', 'markdown'],
-    },
-    {
-      key: 'agent-console.agent.viewList',
-      version: '1.0.0',
-      targets: ['react', 'markdown', 'application/json'],
-    },
-    {
-      key: 'agent-console.run.list',
-      version: '1.0.0',
-      targets: ['react', 'markdown', 'application/json'],
-    },
-    {
-      key: 'agent-console.tool.list',
-      version: '1.0.0',
-      targets: ['react', 'markdown', 'application/json'],
-    },
-  ],
+	// Target requirements for multi-surface rendering
+	presentationsTargets: [
+		{
+			key: 'agent-console.dashboard',
+			version: '1.0.0',
+			targets: ['react', 'markdown'],
+		},
+		{
+			key: 'agent-console.agent.viewList',
+			version: '1.0.0',
+			targets: ['react', 'markdown', 'application/json'],
+		},
+		{
+			key: 'agent-console.run.list',
+			version: '1.0.0',
+			targets: ['react', 'markdown', 'application/json'],
+		},
+		{
+			key: 'agent-console.tool.list',
+			version: '1.0.0',
+			targets: ['react', 'markdown', 'application/json'],
+		},
+	],
 
-  // Capability requirements
-  capabilities: {
-    requires: [
-      { key: 'identity', version: '1.0.0' },
-      { key: 'audit-trail', version: '1.0.0' },
-      { key: 'jobs', version: '1.0.0' },
-    ],
-    provides: [{ key: 'agent', version: '1.0.0' }],
-  },
+	visualizations: AgentVisualizationRefs,
 
-  telemetry: [{ key: 'agent-console.telemetry', version: '1.0.0' }],
+	// Capability requirements
+	capabilities: {
+		requires: [
+			{ key: 'identity', version: '1.0.0' },
+			{ key: 'audit-trail', version: '1.0.0' },
+			{ key: 'jobs', version: '1.0.0' },
+		],
+		provides: [{ key: 'agent', version: '1.0.0' }],
+	},
 
-  jobs: [{ key: 'agent-console.job.run-execution', version: '1.0.0' }],
+	telemetry: [{ key: 'agent-console.telemetry', version: '1.0.0' }],
 
-  docs: [
-    'docs.examples.agent-console.goal',
-    'docs.examples.agent-console.usage',
-    'docs.examples.agent-console.reference',
-    'docs.examples.agent-console.constraints',
-  ],
+	jobs: [{ key: 'agent-console.job.run-execution', version: '1.0.0' }],
+
+	docs: [
+		'docs.examples.agent-console.goal',
+		'docs.examples.agent-console.usage',
+		'docs.examples.agent-console.reference',
+		'docs.examples.agent-console.constraints',
+	],
 });

package/src/docs/agent-console.docblock.ts

@@ -2,15 +2,15 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const agentConsoleDocBlocks: DocBlock[] = [
-  {
-    id: 'docs.examples.agent-console.goal',
-    title: 'Agent Console — Goal',
-    summary: 'AI agent ops console: tools, agents, runs, logs, and metrics.',
-    kind: 'goal',
-    visibility: 'public',
-    route: '/docs/examples/agent-console/goal',
-    tags: ['ai', 'agents', 'goal'],
-    body: `## Why it matters
+	{
+		id: 'docs.examples.agent-console.goal',
+		title: 'Agent Console — Goal',
+		summary: 'AI agent ops console: tools, agents, runs, logs, and metrics.',
+		kind: 'goal',
+		visibility: 'public',
+		route: '/docs/examples/agent-console/goal',
+		tags: ['ai', 'agents', 'goal'],
+		body: `## Why it matters
 - Provides a regenerable agent operations surface with tool registry and run history.
 - Prevents drift between tool schemas, agent configs, and execution logs.
 
@@ -21,39 +21,41 @@ const agentConsoleDocBlocks: DocBlock[] = [
 ## Success criteria
 - Tool/agent/run specs regenerate UI/API/events cleanly.
 - Logs/metrics stay aligned and PII is scoped.`,
-  },
-  {
-    id: 'docs.examples.agent-console.usage',
-    title: 'Agent Console — Usage',
-    summary: 'How to operate, extend, and regenerate the agent console safely.',
-    kind: 'usage',
-    visibility: 'public',
-    route: '/docs/examples/agent-console/usage',
-    tags: ['ai', 'agents', 'usage'],
-    body: `## Setup
-1) Seed (if available) or create tools and agents; define run configs.
-2) Configure Notifications for run completion/failure; Audit for changes.
+	},
+	{
+		id: 'docs.examples.agent-console.usage',
+		title: 'Agent Console — Usage',
+		summary: 'How to operate, extend, and regenerate the agent console safely.',
+		kind: 'usage',
+		visibility: 'public',
+		route: '/docs/examples/agent-console/usage',
+		tags: ['ai', 'agents', 'usage'],
+		body: `## Canonical walkthrough
+1) Open the default sandbox route at \`/sandbox\` or \`/sandbox?template=agent-console\`.
+2) Inspect seeded agents, tools, runs, and metrics from the deterministic demo runtime.
+3) Create an agent, activate it, execute a run, and confirm the metrics update.
+4) Generate or inspect the replay proof at \`packages/examples/agent-console/proofs/agent-console-meetup.replay.json\`.
 
 ## Extend & regenerate
-1) Adjust tool schemas (inputs/outputs), agent configs, run metrics in spec.
+1) Adjust tool schemas (inputs/outputs), agent configs, and run metrics in spec.
 2) Regenerate to sync UI/API/events/logs; mark PII paths for run payloads.
-3) Use Feature Flags to gate risky tools or execution policies.
+3) Keep the demo runtime deterministic unless you are explicitly validating live providers.
 
 ## Guardrails
 - Emit events for run lifecycle; store logs with redaction where needed.
 - Enforce tool input validation; avoid unsafe arbitrary code exec in handlers.
-- Keep tenant/user scoping explicit for ops data.`,
-  },
-  {
-    id: 'docs.examples.agent-console.reference',
-    title: 'Agent Console — Reference',
-    summary:
-      'Entities, contracts, events, and presentations for the agent console.',
-    kind: 'reference',
-    visibility: 'public',
-    route: '/docs/examples/agent-console',
-    tags: ['ai', 'agents', 'reference'],
-    body: `## Entities
+- Keep tenant/user scoping explicit for ops data and keep meetup demos offline-safe by default.`,
+	},
+	{
+		id: 'docs.examples.agent-console.reference',
+		title: 'Agent Console — Reference',
+		summary:
+			'Entities, contracts, events, and presentations for the agent console.',
+		kind: 'reference',
+		visibility: 'public',
+		route: '/docs/examples/agent-console',
+		tags: ['ai', 'agents', 'reference'],
+		body: `## Entities
 - Tool, Agent, AgentTool, Run, RunStep, RunLog, RunMetric.
 
 ## Contracts
@@ -63,22 +65,23 @@ const agentConsoleDocBlocks: DocBlock[] = [
 - tool.created, agent.created, run.started/completed/failed, tool.invoked.
 
 ## Presentations
-- Tool registry, agent list/detail, run list/detail, metrics dashboards.
+- Tool registry, agent list/detail, run list/detail, metrics dashboards, and a server-mode shared table for run history.
 
 ## Notes
 - Keep tool schemas explicit; enforce validation in spec.
-- Use Audit Trail for agent/run changes; Notifications for run outcomes.`,
-  },
-  {
-    id: 'docs.examples.agent-console.constraints',
-    title: 'Agent Console — Constraints & Safety',
-    summary:
-      'Internal guardrails for tool/agent/run safety, PII, and regeneration.',
-    kind: 'reference',
-    visibility: 'internal',
-    route: '/docs/examples/agent-console/constraints',
-    tags: ['ai', 'agents', 'constraints', 'internal'],
-    body: `## Constraints
+- Use the seeded demo runtime for sandbox and markdown walkthroughs.
+- Generate a replay bundle before demos or talks so the walkthrough has proof output ready.`,
+	},
+	{
+		id: 'docs.examples.agent-console.constraints',
+		title: 'Agent Console — Constraints & Safety',
+		summary:
+			'Internal guardrails for tool/agent/run safety, PII, and regeneration.',
+		kind: 'reference',
+		visibility: 'internal',
+		route: '/docs/examples/agent-console/constraints',
+		tags: ['ai', 'agents', 'constraints', 'internal'],
+		body: `## Constraints
 - Tool schemas (inputs/outputs) must be explicit in spec; no arbitrary untyped payloads.
 - Events to emit: tool.created, agent.created, run.started/completed/failed, tool.invoked.
 - Regeneration must not loosen execution policies or logging without explicit spec diff.
@@ -91,7 +94,7 @@ const agentConsoleDocBlocks: DocBlock[] = [
 - Add fixtures for tool schema changes and run lifecycle.
 - Ensure Audit/Notifications remain wired for runs; metrics collection unchanged.
 - Use Feature Flags to gate risky tools; default safe/off.`,
-  },
+	},
 ];
 
 registerDocBlocks(agentConsoleDocBlocks);

package/src/example.test.ts

@@ -0,0 +1,75 @@
+import { describe, expect, test } from 'bun:test';
+import { AgentConsoleFeature } from './agent.feature';
+import example from './example';
+import {
+	AGENT_CONSOLE_MEETUP_PROOF_SCENARIO,
+	AgentConsoleMeetupProofSuite,
+} from './proof';
+import {
+	AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
+	AGENT_CONSOLE_DEMO_PROJECT_ID,
+	createAgentConsoleDemoHandlers,
+} from './shared';
+
+describe('@contractspec/example.agent-console', () => {
+	test('publishes meetup-ready example metadata', () => {
+		expect(example.meta.key).toBe('agent-console');
+		expect(example.entrypoints.packageName).toBe(
+			'@contractspec/example.agent-console'
+		);
+		expect(example.surfaces.templates).toBe(true);
+		expect(example.surfaces.sandbox?.enabled).toBe(true);
+		expect(AgentConsoleFeature.meta.key).toBe(example.meta.key);
+	});
+
+	test('exports the canonical harness scenario and suite', () => {
+		expect(AGENT_CONSOLE_MEETUP_PROOF_SCENARIO.meta.key).toBe(
+			'agent-console.meetup.proof'
+		);
+		expect(AgentConsoleMeetupProofSuite.scenarios).toEqual([
+			{
+				scenario: {
+					key: AGENT_CONSOLE_MEETUP_PROOF_SCENARIO.meta.key,
+					version: AGENT_CONSOLE_MEETUP_PROOF_SCENARIO.meta.version,
+				},
+				required: true,
+				weight: 1,
+			},
+		]);
+	});
+
+	test('serves the seeded agent-console happy path', async () => {
+		const handlers = createAgentConsoleDemoHandlers({
+			projectId: AGENT_CONSOLE_DEMO_PROJECT_ID,
+			organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
+			now: (() => {
+				let tick = 0;
+				const base = Date.parse('2026-03-20T09:00:00.000Z');
+
+				return () => new Date(base + tick++ * 60_000);
+			})(),
+		});
+
+		const agents = await handlers.listAgents({
+			projectId: AGENT_CONSOLE_DEMO_PROJECT_ID,
+			organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
+			limit: 3,
+		});
+		expect(agents.total).toBeGreaterThan(0);
+
+		const activeAgent = agents.items.find((agent) => agent.status === 'ACTIVE');
+		expect(activeAgent).toBeDefined();
+
+		const run = await handlers.executeAgent({
+			agentId: activeAgent!.id,
+			message: 'Summarize the current autonomous agent status.',
+			context: {
+				projectId: AGENT_CONSOLE_DEMO_PROJECT_ID,
+				organizationId: AGENT_CONSOLE_DEMO_ORGANIZATION_ID,
+			},
+		});
+		expect(run.status).toBe('COMPLETED');
+		expect(run.output).toContain(activeAgent!.name);
+		expect(run.totalTokens).toBeGreaterThan(0);
+	});
+});