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 TestToolCommand = defineCommand({
15	meta: {
16		key: 'agent.tool.test',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@agent-console-team'],
20		tags: ['tool', 'test'],
21		description: 'Tests a tool with sample input to verify it works correctly.',
22		goal: 'Validate tool configuration before deployment.',
23		context: 'Tool builder UI - test panel.',
24	},
25	io: {
26		input: defineSchemaModel({
27			name: 'TestToolInput',
28			fields: {
29				toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
30				testInput: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
31			},
32		}),
33		output: defineSchemaModel({
34			name: 'TestToolOutput',
35			fields: {
36				success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
37				output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
38				error: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
39				durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
40			},
41		}),
42		errors: {
43			TOOL_NOT_FOUND: {
44				description: 'The specified tool does not exist',
45				http: 404,
46				gqlCode: 'TOOL_NOT_FOUND',
47				when: 'Tool ID is invalid',
48			},
49			TOOL_EXECUTION_ERROR: {
50				description: 'Tool execution failed',
51				http: 500,
52				gqlCode: 'TOOL_EXECUTION_ERROR',
53				when: 'Tool returns an error',
54			},
55		},
56	},
57	policy: { auth: 'user' },
58	sideEffects: { audit: ['tool.tested'] },
59	acceptance: {
60		scenarios: [
61			{
62				key: 'test-tool-success',
63				given: ['Tool exists', 'Tool is configured correctly'],
64				when: ['User runs test with valid input'],
65				then: ['Tool executes successfully', 'Output is returned'],
66			},
67			{
68				key: 'test-tool-failure',
69				given: ['Tool exists', 'Tool has configuration error'],
70				when: ['User runs test'],
71				then: ['TOOL_EXECUTION_ERROR is returned'],
72			},
73		],
74		examples: [
75			{
76				key: 'test-weather-api',
77				input: { toolId: 'tool-123', testInput: { city: 'Paris' } },
78				output: { success: true, output: { temperature: 22 }, durationMs: 150 },
79			},
80		],
81	},
82});