1import {
2	defineCommand,
3	defineQuery,
4} from '@lssm-tech/lib.contracts-spec/operations';
5import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
6import { AgentStatusEnum, ModelProviderEnum } from './agent.enum';
7import { AgentCreatedEvent } from './agent.event';
8import {
9	AgentSummaryModel,
10	AgentWithToolsModel,
11	CreateAgentInputModel,
12	UpdateAgentInputModel,
13} from './agent.schema';
14
15export const CreateAgentCommand = defineCommand({
16	meta: {
17		key: 'agent-console.agent.create',
18		version: '1.0.0',
19		stability: 'stable',
20		owners: ['@agent-console-team'],
21		tags: ['agent', 'create'],
22		description: 'Creates a new AI agent configuration.',
23		goal: 'Allow users to define new AI agents with specific models and tools.',
24		context: 'Called from the agent builder UI when creating a new agent.',
25	},
26	io: {
27		input: CreateAgentInputModel,
28		output: defineSchemaModel({
29			name: 'CreateAgentOutput',
30			fields: {
31				id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
32				name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
33				slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
34				status: { type: AgentStatusEnum, isOptional: false },
35			},
36		}),
37		errors: {
38			SLUG_EXISTS: {
39				description:
40					'An agent with this slug already exists in the organization',
41				http: 409,
42				gqlCode: 'SLUG_EXISTS',
43				when: 'Slug is already taken',
44			},
45		},
46	},
47	policy: { auth: 'user' },
48	sideEffects: {
49		emits: [
50			{
51				// name: 'agent.created',
52				// version: '1.0.0',
53				// payload: AgentSummaryModel,
54				ref: AgentCreatedEvent.meta,
55				when: 'Agent is successfully created',
56			},
57		],
58		audit: ['agent-console.agent.created'],
59	},
60	acceptance: {
61		scenarios: [
62			{
63				key: 'create-agent-happy-path',
64				given: ['User is authenticated', 'Organization exists'],
65				when: ['User submits valid agent configuration'],
66				then: [
67					'New agent is created with DRAFT status',
68					'AgentCreated event is emitted',
69				],
70			},
71			{
72				key: 'create-agent-slug-conflict',
73				given: ['User is authenticated', 'Agent with same slug exists'],
74				when: ['User submits agent with duplicate slug'],
75				then: ['SLUG_EXISTS error is returned with 409 status'],
76			},
77		],
78		examples: [
79			{
80				key: 'basic-create',
81				input: {
82					name: 'Support Assistant',
83					slug: 'support-assistant',
84					modelProvider: 'openai',
85					modelId: 'gpt-4',
86				},
87				output: {
88					id: 'agent-123',
89					name: 'Support Assistant',
90					slug: 'support-assistant',
91					status: 'draft',
92				},
93			},
94		],
95	},
96});