1import {
2	defineCommand,
3	defineQuery,
4} from '@lssm-tech/lib.contracts-spec/operations';
5import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
6import { AgentStatusEnum, ModelProviderEnum } from './agent.enum';
7import { AgentCreatedEvent } from './agent.event';
8import {
9	AgentSummaryModel,
10	AgentWithToolsModel,
11	CreateAgentInputModel,
12	UpdateAgentInputModel,
13} from './agent.schema';
14
15export const GetAgentQuery = defineQuery({
16	meta: {
17		key: 'agent-console.agent.get',
18		version: '1.0.0',
19		stability: 'stable',
20		owners: ['@agent-console-team'],
21		tags: ['agent', 'get'],
22		description: 'Retrieves an agent by its ID.',
23		goal: 'View detailed agent configuration.',
24		context: 'Called when viewing agent details or editing.',
25	},
26	io: {
27		input: defineSchemaModel({
28			name: 'GetAgentInput',
29			fields: {
30				agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
31				includeTools: { type: ScalarTypeEnum.Boolean(), isOptional: true },
32			},
33		}),
34		output: AgentWithToolsModel,
35		errors: {
36			AGENT_NOT_FOUND: {
37				description: 'The specified agent does not exist',
38				http: 404,
39				gqlCode: 'AGENT_NOT_FOUND',
40				when: 'Agent ID is invalid',
41			},
42		},
43	},
44	policy: { auth: 'user' },
45	acceptance: {
46		scenarios: [
47			{
48				key: 'get-agent-happy-path',
49				given: ['Agent exists'],
50				when: ['User requests agent by ID'],
51				then: ['Agent details are returned'],
52			},
53			{
54				key: 'get-agent-with-tools',
55				given: ['Agent exists with assigned tools'],
56				when: ['User requests agent with includeTools=true'],
57				then: ['Agent details with tools list are returned'],
58			},
59		],
60		examples: [
61			{
62				key: 'get-basic',
63				input: { agentId: 'agent-123', includeTools: false },
64				output: {
65					id: 'agent-123',
66					name: 'Support Assistant',
67					status: 'active',
68					tools: [],
69				},
70			},
71		],
72	},
73});