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 GetRunLogsQuery = defineQuery({
17	meta: {
18		key: 'agent.run.getLogs',
19		version: '1.0.0',
20		stability: 'stable',
21		owners: ['@agent-console-team'],
22		tags: ['run', 'logs'],
23		description: 'Retrieves all logs for a specific run.',
24		goal: 'Debug and audit run execution.',
25		context: 'Run details page - logs tab.',
26	},
27	io: {
28		input: defineSchemaModel({
29			name: 'GetRunLogsInput',
30			fields: {
31				runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
32				level: { type: LogLevelEnum, isOptional: true },
33				stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
34				limit: {
35					type: ScalarTypeEnum.Int_unsecure(),
36					isOptional: true,
37					defaultValue: 100,
38				},
39				offset: {
40					type: ScalarTypeEnum.Int_unsecure(),
41					isOptional: true,
42					defaultValue: 0,
43				},
44			},
45		}),
46		output: defineSchemaModel({
47			name: 'GetRunLogsOutput',
48			fields: {
49				items: { type: RunLogModel, isArray: true, isOptional: false },
50				total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
51				hasMore: { type: ScalarTypeEnum.Boolean(), isOptional: false },
52			},
53		}),
54	},
55	policy: { auth: 'user' },
56	acceptance: {
57		scenarios: [
58			{
59				key: 'get-run-logs-happy-path',
60				given: ['Run exists with logs'],
61				when: ['User requests logs'],
62				then: ['Paginated logs list is returned'],
63			},
64		],
65		examples: [
66			{
67				key: 'get-logs-filtered',
68				input: { runId: 'run-456', level: 'error', limit: 50 },
69				output: { items: [], total: 0, hasMore: false },
70			},
71		],
72	},
73});