1import {
2	defineCommand,
3	defineQuery,
4} from '@lssm-tech/lib.contracts-spec/operations';
5import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
6import { GranularityEnum, LogLevelEnum, RunStatusEnum } from './run.enum';
7import {
8	RunInputModel,
9	RunLogModel,
10	RunModel,
11	RunStepModel,
12	RunSummaryModel,
13	TimelineDataPointModel,
14} from './run.schema';
15
16export const CancelRunCommand = defineCommand({
17	meta: {
18		key: 'agent.run.cancel',
19		version: '1.0.0',
20		stability: 'stable',
21		owners: ['@agent-console-team'],
22		tags: ['run', 'cancel'],
23		description: 'Cancels an in-progress agent run.',
24		goal: 'Stop a running agent execution.',
25		context: 'Called when user wants to abort a long-running task.',
26	},
27	io: {
28		input: defineSchemaModel({
29			name: 'CancelRunInput',
30			fields: {
31				runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
32				reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
33			},
34		}),
35		output: defineSchemaModel({
36			name: 'CancelRunOutput',
37			fields: {
38				success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
39				status: { type: RunStatusEnum, isOptional: false },
40			},
41		}),
42		errors: {
43			RUN_NOT_FOUND: {
44				description: 'The specified run does not exist',
45				http: 404,
46				gqlCode: 'RUN_NOT_FOUND',
47				when: 'Run ID is invalid',
48			},
49			RUN_NOT_CANCELLABLE: {
50				description: 'The run cannot be cancelled',
51				http: 400,
52				gqlCode: 'RUN_NOT_CANCELLABLE',
53				when: 'Run is already completed/failed/cancelled',
54			},
55		},
56	},
57	policy: { auth: 'user' },
58	sideEffects: {
59		emits: [
60			{
61				key: 'run.cancelled',
62				version: '1.0.0',
63				stability: 'stable',
64				owners: ['@agent-console-team'],
65				tags: ['run', 'cancelled'],
66				when: 'Run is cancelled',
67				payload: RunSummaryModel,
68			},
69		],
70		audit: ['run.cancelled'],
71	},
72	acceptance: {
73		scenarios: [
74			{
75				key: 'cancel-run-happy-path',
76				given: ['Run exists', 'Run is in progress'],
77				when: ['User cancels run'],
78				then: ['Run is cancelled', 'RunCancelled event is emitted'],
79			},
80			{
81				key: 'cancel-run-already-completed',
82				given: ['Run exists but is already completed'],
83				when: ['User attempts to cancel'],
84				then: ['RUN_NOT_CANCELLABLE error is returned'],
85			},
86		],
87		examples: [
88			{
89				key: 'cancel-basic',
90				input: { runId: 'run-456', reason: 'User requested' },
91				output: { success: true, status: 'cancelled' },
92			},
93		],
94	},
95});