1/**
2 * Agent Console Feature Module Specification
3 *
4 * Defines the feature module for agent orchestration capabilities.
5 */
6import type { FeatureModuleSpec } from '@lssm-tech/lib.contracts-spec';
7import { defineFeature } from '@lssm-tech/lib.contracts-spec';
8import { AgentVisualizationRefs } from './visualizations';
9
10/**
11 * Agent Console feature module that bundles all agent, tool, and run
12 * operations, events, and presentations into an installable feature.
13 */
14export const AgentConsoleFeature: FeatureModuleSpec = defineFeature({
15	meta: {
16		key: 'agent-console',
17		version: '1.0.0',
18		title: 'AI Agent Console',
19		description: 'AI agent orchestration with tools, runs, and logs management',
20		domain: 'ai-ops',
21		owners: ['@agent-console-team'],
22		tags: ['ai', 'agents', 'orchestration'],
23		stability: 'stable',
24	},
25
26	// All contract operations included in this feature
27	operations: [
28		// Agent operations
29		{ key: 'agent-console.agent.create', version: '1.0.0' },
30		{ key: 'agent-console.agent.update', version: '1.0.0' },
31		{ key: 'agent-console.agent.get', version: '1.0.0' },
32		{ key: 'agent-console.agent.list', version: '1.0.0' },
33		{ key: 'agent-console.agent.assignTool', version: '1.0.0' },
34		{ key: 'agent-console.agent.removeTool', version: '1.0.0' },
35
36		// Tool operations
37		{ key: 'agent.tool.create', version: '1.0.0' },
38		{ key: 'agent.tool.update', version: '1.0.0' },
39		{ key: 'agent.tool.get', version: '1.0.0' },
40		{ key: 'agent.tool.list', version: '1.0.0' },
41		{ key: 'agent.tool.test', version: '1.0.0' },
42
43		// Run operations
44		{ key: 'agent.run.execute', version: '1.0.0' },
45		{ key: 'agent.run.cancel', version: '1.0.0' },
46		{ key: 'agent.run.get', version: '1.0.0' },
47		{ key: 'agent.run.list', version: '1.0.0' },
48		{ key: 'agent.run.getSteps', version: '1.0.0' },
49		{ key: 'agent.run.getLogs', version: '1.0.0' },
50		{ key: 'agent.run.getMetrics', version: '1.0.0' },
51	],
52
53	// Events emitted by this feature
54	events: [
55		// Agent events
56		{ key: 'agent-console.agent.created', version: '1.0.0' },
57		{ key: 'agent-console.agent.updated', version: '1.0.0' },
58		{ key: 'agent-console.agent.toolAssigned', version: '1.0.0' },
59		{ key: 'agent-console.agent.toolRemoved', version: '1.0.0' },
60
61		// Tool events
62		{ key: 'agent.tool.created', version: '1.0.0' },
63		{ key: 'agent.tool.updated', version: '1.0.0' },
64		{ key: 'agent.tool.statusChanged', version: '1.0.0' },
65
66		// Run events
67		{ key: 'agent.run.started', version: '1.0.0' },
68		{ key: 'agent.run.completed', version: '1.0.0' },
69		{ key: 'agent.run.failed', version: '1.0.0' },
70		{ key: 'agent.run.cancelled', version: '1.0.0' },
71		{ key: 'agent.run.toolInvoked', version: '1.0.0' },
72		{ key: 'agent.run.toolCompleted', version: '1.0.0' },
73		{ key: 'agent.run.messageGenerated', version: '1.0.0' },
74	],
75
76	// Presentations associated with this feature
77	presentations: [
78		{ key: 'agent-console.dashboard', version: '1.0.0' },
79		{ key: 'agent-console.agent.viewList', version: '1.0.0' },
80		{ key: 'agent-console.agent.detail', version: '1.0.0' },
81		{ key: 'agent-console.run.list', version: '1.0.0' },
82		{ key: 'agent-console.run.detail', version: '1.0.0' },
83		{ key: 'agent-console.tool.list', version: '1.0.0' },
84		{ key: 'agent-console.tool.detail', version: '1.0.0' },
85	],
86
87	// Link operations to their primary presentations
88	opToPresentation: [
89		{
90			op: { key: 'agent-console.agent.list', version: '1.0.0' },
91			pres: { key: 'agent-console.agent.viewList', version: '1.0.0' },
92		},
93		{
94			op: { key: 'agent-console.agent.get', version: '1.0.0' },
95			pres: { key: 'agent-console.agent.detail', version: '1.0.0' },
96		},
97		{
98			op: { key: 'agent.run.list', version: '1.0.0' },
99			pres: { key: 'agent-console.run.list', version: '1.0.0' },
100		},
101		{
102			op: { key: 'agent.run.get', version: '1.0.0' },
103			pres: { key: 'agent-console.run.detail', version: '1.0.0' },
104		},
105		{
106			op: { key: 'agent.tool.list', version: '1.0.0' },
107			pres: { key: 'agent-console.tool.list', version: '1.0.0' },
108		},
109		{
110			op: { key: 'agent.tool.get', version: '1.0.0' },
111			pres: { key: 'agent-console.tool.detail', version: '1.0.0' },
112		},
113	],
114
115	// Target requirements for multi-surface rendering
116	presentationsTargets: [
117		{
118			key: 'agent-console.dashboard',
119			version: '1.0.0',
120			targets: ['react', 'markdown'],
121		},
122		{
123			key: 'agent-console.agent.viewList',
124			version: '1.0.0',
125			targets: ['react', 'markdown', 'application/json'],
126		},
127		{
128			key: 'agent-console.run.list',
129			version: '1.0.0',
130			targets: ['react', 'markdown', 'application/json'],
131		},
132		{
133			key: 'agent-console.tool.list',
134			version: '1.0.0',
135			targets: ['react', 'markdown', 'application/json'],
136		},
137	],
138
139	visualizations: AgentVisualizationRefs,
140
141	// Capability requirements
142	capabilities: {
143		requires: [
144			{ key: 'identity', version: '1.0.0' },
145			{ key: 'audit-trail', version: '1.0.0' },
146			{ key: 'jobs', version: '1.0.0' },
147		],
148		provides: [{ key: 'agent', version: '1.0.0' }],
149	},
150
151	telemetry: [{ key: 'agent-console.telemetry', version: '1.0.0' }],
152
153	jobs: [{ key: 'agent-console.job.run-execution', version: '1.0.0' }],
154
155	docs: [
156		'docs.examples.agent-console.goal',
157		'docs.examples.agent-console.usage',
158		'docs.examples.agent-console.reference',
159		'docs.examples.agent-console.constraints',
160	],
161});
162