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 UpdateToolCommand = defineCommand({
15	meta: {
16		key: 'agent.tool.update',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@agent-console-team'],
20		tags: ['tool', 'update'],
21		description: 'Updates an existing AI tool definition.',
22		goal: 'Allow users to modify tool settings and configuration.',
23		context: 'Called from the tool settings UI.',
24	},
25	io: {
26		input: UpdateToolInputModel,
27		output: defineSchemaModel({
28			name: 'UpdateToolOutput',
29			fields: {
30				id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
31				name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
32				status: { type: ToolStatusEnum, isOptional: false },
33				updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
34			},
35		}),
36		errors: {
37			TOOL_NOT_FOUND: {
38				description: 'The specified tool does not exist',
39				http: 404,
40				gqlCode: 'TOOL_NOT_FOUND',
41				when: 'Tool ID is invalid',
42			},
43		},
44	},
45	policy: { auth: 'user' },
46	sideEffects: {
47		emits: [
48			{
49				key: 'tool.updated',
50				version: '1.0.0',
51				stability: 'stable',
52				owners: ['@agent-console-team'],
53				tags: ['tool', 'updated'],
54				when: 'Tool is updated',
55				payload: ToolSummaryModel,
56			},
57		],
58		audit: ['tool.updated'],
59	},
60	acceptance: {
61		scenarios: [
62			{
63				key: 'update-tool-happy-path',
64				given: ['Tool exists', 'User owns the tool'],
65				when: ['User submits updated configuration'],
66				then: ['Tool is updated', 'ToolUpdated event is emitted'],
67			},
68		],
69		examples: [
70			{
71				key: 'update-description',
72				input: { toolId: 'tool-123', description: 'Updated weather API tool' },
73				output: {
74					id: 'tool-123',
75					name: 'Weather API',
76					status: 'draft',
77					updatedAt: '2025-01-01T00:00:00Z',
78				},
79			},
80		],
81	},
82});