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 GetToolQuery = defineQuery({
15	meta: {
16		key: 'agent.tool.get',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@agent-console-team'],
20		tags: ['tool', 'get'],
21		description: 'Retrieves a tool by its ID.',
22		goal: 'View detailed tool configuration.',
23		context: 'Called when viewing tool details or editing.',
24	},
25	io: {
26		input: defineSchemaModel({
27			name: 'GetToolInput',
28			fields: {
29				toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
30			},
31		}),
32		output: ToolModel,
33		errors: {
34			TOOL_NOT_FOUND: {
35				description: 'The specified tool does not exist',
36				http: 404,
37				gqlCode: 'TOOL_NOT_FOUND',
38				when: 'Tool ID is invalid',
39			},
40		},
41	},
42	policy: { auth: 'user' },
43	acceptance: {
44		scenarios: [
45			{
46				key: 'get-tool-happy-path',
47				given: ['Tool exists'],
48				when: ['User requests tool by ID'],
49				then: ['Tool details are returned'],
50			},
51		],
52		examples: [
53			{
54				key: 'get-basic',
55				input: { toolId: 'tool-123' },
56				output: {
57					id: 'tool-123',
58					name: 'Weather API',
59					status: 'active',
60					category: 'api',
61				},
62			},
63		],
64	},
65});