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 GetRunQuery = defineQuery({
17	meta: {
18		key: 'agent.run.get',
19		version: '1.0.0',
20		stability: 'stable',
21		owners: ['@agent-console-team'],
22		tags: ['run', 'get'],
23		description: 'Retrieves a run by its ID with optional details.',
24		goal: 'View detailed run information.',
25		context: 'Run details page or monitoring.',
26	},
27	io: {
28		input: defineSchemaModel({
29			name: 'GetRunInput',
30			fields: {
31				runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
32				includeSteps: { type: ScalarTypeEnum.Boolean(), isOptional: true },
33				includeLogs: { type: ScalarTypeEnum.Boolean(), isOptional: true },
34			},
35		}),
36		output: RunModel,
37		errors: {
38			RUN_NOT_FOUND: {
39				description: 'The specified run does not exist',
40				http: 404,
41				gqlCode: 'RUN_NOT_FOUND',
42				when: 'Run ID is invalid',
43			},
44		},
45	},
46	policy: { auth: 'user' },
47	acceptance: {
48		scenarios: [
49			{
50				key: 'get-run-happy-path',
51				given: ['Run exists'],
52				when: ['User requests run by ID'],
53				then: ['Run details are returned'],
54			},
55		],
56		examples: [
57			{
58				key: 'get-with-steps',
59				input: { runId: 'run-456', includeSteps: true, includeLogs: false },
60				output: { id: 'run-456', status: 'completed', steps: [] },
61			},
62		],
63	},
64});