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 CreateToolCommand = defineCommand({
15	meta: {
16		key: 'agent.tool.create',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@agent-console-team'],
20		tags: ['tool', 'create'],
21		description: 'Creates a new AI tool definition.',
22		goal: 'Allow users to define new tools that agents can use.',
23		context: 'Called from the tool builder UI when creating a new tool.',
24	},
25	io: {
26		input: CreateToolInputModel,
27		output: defineSchemaModel({
28			name: 'CreateToolOutput',
29			fields: {
30				id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
31				name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
32				slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
33				status: { type: ToolStatusEnum, isOptional: false },
34			},
35		}),
36		errors: {
37			SLUG_EXISTS: {
38				description: 'A tool with this slug already exists in the organization',
39				http: 409,
40				gqlCode: 'SLUG_EXISTS',
41				when: 'Slug is already taken',
42			},
43		},
44	},
45	policy: { auth: 'user' },
46	sideEffects: {
47		emits: [
48			{
49				key: 'tool.created',
50				version: '1.0.0',
51				stability: 'stable',
52				owners: ['@agent-console-team'],
53				tags: ['tool', 'created'],
54				when: 'Tool is successfully created',
55				payload: ToolSummaryModel,
56			},
57		],
58		audit: ['tool.created'],
59	},
60	acceptance: {
61		scenarios: [
62			{
63				key: 'create-tool-happy-path',
64				given: ['User is authenticated', 'Organization exists'],
65				when: ['User submits valid tool configuration'],
66				then: ['New tool is created', 'ToolCreated event is emitted'],
67			},
68			{
69				key: 'create-tool-slug-conflict',
70				given: ['Tool with same slug exists'],
71				when: ['User submits tool with duplicate slug'],
72				then: ['SLUG_EXISTS error is returned'],
73			},
74		],
75		examples: [
76			{
77				key: 'create-api-tool',
78				input: {
79					name: 'Weather API',
80					slug: 'weather-api',
81					category: 'api',
82					description: 'Fetches weather data',
83				},
84				output: {
85					id: 'tool-123',
86					name: 'Weather API',
87					slug: 'weather-api',
88					status: 'draft',
89				},
90			},
91		],
92	},
93});