1import {
2	defineCommand,
3	defineQuery,
4} from '@lssm-tech/lib.contracts-spec/operations';
5import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
6import { ToolCategoryEnum, ToolStatusEnum } from './tool.enum';
7import {
8	CreateToolInputModel,
9	ToolModel,
10	ToolSummaryModel,
11	UpdateToolInputModel,
12} from './tool.schema';
13
14export const ListToolsQuery = defineQuery({
15	meta: {
16		key: 'agent.tool.list',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@agent-console-team'],
20		tags: ['tool', 'list'],
21		description: 'Lists tools for an organization with optional filtering.',
22		goal: 'Browse and search available tools.',
23		context: 'Tool list/dashboard view.',
24	},
25	io: {
26		input: defineSchemaModel({
27			name: 'ListToolsInput',
28			fields: {
29				organizationId: {
30					type: ScalarTypeEnum.String_unsecure(),
31					isOptional: false,
32				},
33				category: { type: ToolCategoryEnum, isOptional: true },
34				status: { type: ToolStatusEnum, isOptional: true },
35				search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
36				limit: {
37					type: ScalarTypeEnum.Int_unsecure(),
38					isOptional: true,
39					defaultValue: 20,
40				},
41				offset: {
42					type: ScalarTypeEnum.Int_unsecure(),
43					isOptional: true,
44					defaultValue: 0,
45				},
46			},
47		}),
48		output: defineSchemaModel({
49			name: 'ListToolsOutput',
50			fields: {
51				items: { type: ToolSummaryModel, isArray: true, isOptional: false },
52				total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
53				hasMore: { type: ScalarTypeEnum.Boolean(), isOptional: false },
54			},
55		}),
56	},
57	policy: { auth: 'user' },
58	acceptance: {
59		scenarios: [
60			{
61				key: 'list-tools-happy-path',
62				given: ['Organization has tools'],
63				when: ['User lists tools'],
64				then: ['Paginated list of tools is returned'],
65			},
66		],
67		examples: [
68			{
69				key: 'list-by-category',
70				input: { organizationId: 'org-123', category: 'api', limit: 10 },
71				output: { items: [], total: 0, hasMore: false },
72			},
73		],
74	},
75});