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 ListRunsQuery = defineQuery({
17	meta: {
18		key: 'agent.run.list',
19		version: '1.0.0',
20		stability: 'stable',
21		owners: ['@agent-console-team'],
22		tags: ['run', 'list'],
23		description: 'Lists runs with optional filtering.',
24		goal: 'Browse and search run history.',
25		context: 'Run history/dashboard view.',
26	},
27	io: {
28		input: defineSchemaModel({
29			name: 'ListRunsInput',
30			fields: {
31				organizationId: {
32					type: ScalarTypeEnum.String_unsecure(),
33					isOptional: true,
34				},
35				agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
36				userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
37				sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
38				status: { type: RunStatusEnum, isOptional: true },
39				startDate: { type: ScalarTypeEnum.DateTime(), isOptional: true },
40				endDate: { type: ScalarTypeEnum.DateTime(), isOptional: true },
41				limit: {
42					type: ScalarTypeEnum.Int_unsecure(),
43					isOptional: true,
44					defaultValue: 20,
45				},
46				offset: {
47					type: ScalarTypeEnum.Int_unsecure(),
48					isOptional: true,
49					defaultValue: 0,
50				},
51			},
52		}),
53		output: defineSchemaModel({
54			name: 'ListRunsOutput',
55			fields: {
56				items: { type: RunSummaryModel, isArray: true, isOptional: false },
57				total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
58				hasMore: { type: ScalarTypeEnum.Boolean(), isOptional: false },
59			},
60		}),
61	},
62	policy: { auth: 'user' },
63	acceptance: {
64		scenarios: [
65			{
66				key: 'list-runs-happy-path',
67				given: ['Organization has runs'],
68				when: ['User lists runs'],
69				then: ['Paginated list of runs is returned'],
70			},
71		],
72		examples: [
73			{
74				key: 'list-by-agent',
75				input: { agentId: 'agent-123', limit: 20, offset: 0 },
76				output: { items: [], total: 0, hasMore: false },
77			},
78		],
79	},
80});