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 ListAgentsQuery = defineQuery({
16	meta: {
17		key: 'agent-console.agent.list',
18		version: '1.0.0',
19		stability: 'stable',
20		owners: ['@agent-console-team'],
21		tags: ['agent', 'list'],
22		description: 'Lists agents for an organization with optional filtering.',
23		goal: 'Browse and search available agents.',
24		context: 'Agent list/dashboard view.',
25	},
26	io: {
27		input: defineSchemaModel({
28			name: 'ListAgentsInput',
29			fields: {
30				organizationId: {
31					type: ScalarTypeEnum.String_unsecure(),
32					isOptional: false,
33				},
34				status: { type: AgentStatusEnum, isOptional: true },
35				modelProvider: { type: ModelProviderEnum, isOptional: true },
36				search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
37				limit: {
38					type: ScalarTypeEnum.Int_unsecure(),
39					isOptional: true,
40					defaultValue: 20,
41				},
42				offset: {
43					type: ScalarTypeEnum.Int_unsecure(),
44					isOptional: true,
45					defaultValue: 0,
46				},
47			},
48		}),
49		output: defineSchemaModel({
50			name: 'ListAgentsOutput',
51			fields: {
52				items: { type: AgentSummaryModel, isArray: true, isOptional: false },
53				total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
54				hasMore: { type: ScalarTypeEnum.Boolean(), isOptional: false },
55			},
56		}),
57	},
58	policy: { auth: 'user' },
59	acceptance: {
60		scenarios: [
61			{
62				key: 'list-agents-happy-path',
63				given: ['Organization has agents'],
64				when: ['User lists agents'],
65				then: ['Paginated list of agents is returned'],
66			},
67			{
68				key: 'list-agents-filter-by-status',
69				given: ['Organization has agents with mixed statuses'],
70				when: ['User filters by status=active'],
71				then: ['Only active agents are returned'],
72			},
73		],
74		examples: [
75			{
76				key: 'list-basic',
77				input: { organizationId: 'org-123', limit: 10, offset: 0 },
78				output: { items: [], total: 0, hasMore: false },
79			},
80		],
81	},
82});