OSS-first docs
These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.
Retrieves all steps for a specific run.
Goal
View step-by-step execution details.
Context
Run details page - steps tab.
Source Definition
import {
defineCommand,
defineQuery,
} from '@lssm-tech/lib.contracts-spec/operations';
import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
import { GranularityEnum, LogLevelEnum, RunStatusEnum } from './run.enum';
import {
RunInputModel,
RunLogModel,
RunModel,
RunStepModel,
RunSummaryModel,
TimelineDataPointModel,
} from './run.schema';
export const GetRunStepsQuery = defineQuery({
meta: {
key: 'agent.run.getSteps',
version: '1.0.0',
stability: 'stable',
owners: ['@agent-console-team'],
tags: ['run', 'steps'],
description: 'Retrieves all steps for a specific run.',
goal: 'View step-by-step execution details.',
context: 'Run details page - steps tab.',
},
io: {
input: defineSchemaModel({
name: 'GetRunStepsInput',
fields: {
runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
},
}),
output: defineSchemaModel({
name: 'GetRunStepsOutput',
fields: {
steps: { type: RunStepModel, isArray: true, isOptional: false },
},
}),
},
policy: { auth: 'user' },
acceptance: {
scenarios: [
{
key: 'get-run-steps-happy-path',
given: ['Run exists with steps'],
when: ['User requests steps'],
then: ['Steps list is returned'],
},
],
examples: [
{
key: 'get-steps-basic',
input: { runId: 'run-456' },
output: { steps: [] },
},
],
},
});