@contractspec/example.agent-console 3.7.5 → 3.7.7

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

@@ -11,148 +11,148 @@ import { defineFeature } from '@contractspec/lib.contracts-spec';
  * 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' }],
-  },
+	// 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' }],
+	},
 
-  telemetry: [{ key: 'agent-console.telemetry', version: '1.0.0' }],
+	telemetry: [{ key: 'agent-console.telemetry', version: '1.0.0' }],
 
-  jobs: [{ key: 'agent-console.job.run-execution', version: '1.0.0' }],
+	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',
-  ],
+	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,16 +21,16 @@ 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
+	},
+	{
+		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.
 
@@ -43,17 +43,17 @@ const agentConsoleDocBlocks: DocBlock[] = [
 - 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
+	},
+	{
+		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
@@ -68,17 +68,17 @@ const agentConsoleDocBlocks: DocBlock[] = [
 ## 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
+	},
+	{
+		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 +91,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.ts

@@ -1,41 +1,41 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'agent-console',
-    version: '1.0.0',
-    title: 'Agent Console',
-    description:
-      'AI agent ops console: tools, agents, runs, logs, and metrics (spec-first, regenerable).',
-    kind: 'template',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['ai', 'agents', 'tools', 'orchestration'],
-  },
-  docs: {
-    rootDocId: 'docs.examples.agent-console.reference',
-    goalDocId: 'docs.examples.agent-console.goal',
-    usageDocId: 'docs.examples.agent-console.usage',
-    constraintsDocId: 'docs.examples.agent-console.constraints',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.agent-console',
-    feature: './feature',
-    contracts: './contracts',
-    presentations: './presentations',
-    handlers: './handlers',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: {
-      enabled: true,
-      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],
-    },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'agent-console',
+		version: '1.0.0',
+		title: 'Agent Console',
+		description:
+			'AI agent ops console: tools, agents, runs, logs, and metrics (spec-first, regenerable).',
+		kind: 'template',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['ai', 'agents', 'tools', 'orchestration'],
+	},
+	docs: {
+		rootDocId: 'docs.examples.agent-console.reference',
+		goalDocId: 'docs.examples.agent-console.goal',
+		usageDocId: 'docs.examples.agent-console.usage',
+		constraintsDocId: 'docs.examples.agent-console.constraints',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.agent-console',
+		feature: './feature',
+		contracts: './contracts',
+		presentations: './presentations',
+		handlers: './handlers',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],
+		},
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;