@lostgradient/cinder 0.9.0 → 0.12.0

package/src/components/run-step-timeline/run-step-timeline.schema.ts

@@ -15,412 +15,994 @@ const schema = {
     steps: {
       type: 'array',
       items: {
-        type: 'object',
-        properties: {
-          id: {
-            type: 'string',
-            description: 'Stable identity; used as the keyed list identity.',
-          },
-          label: {
-            type: 'string',
-            description: 'Display label for this step.',
-          },
-          status: {
-            enum: [
-              'pending',
-              'running',
-              'succeeded',
-              'failed',
-              'cancelled',
-              'skipped',
-              'retrying',
-              'waiting_approval',
-            ],
-            description: 'Generic execution state.',
-          },
-          startTime: {
-            type: 'string',
-            description: 'ISO datetime string for when this step started.',
-          },
-          endTime: {
-            type: 'string',
-            description: 'ISO datetime string for when this step ended.',
-          },
-          duration: {
-            type: 'string',
-            description: 'Human-readable duration string, e.g. "1m 23s".',
-          },
-          attemptCount: {
-            type: 'number',
-            description: 'Number of attempts made so far, including any retries.',
-          },
-          actionsCount: {
-            type: 'number',
-            description: 'Number of actions associated with this step.',
-          },
-          progress: {
-            type: 'number',
-            description: 'Optional determinate progress value between 0 and `progressMax`.',
-          },
-          progressMax: {
-            type: 'number',
-            description: 'Maximum value for the progress bar. Defaults to 100.',
-          },
-          details: {
-            type: 'array',
-            items: {
-              type: 'object',
-              properties: {
-                id: {
-                  type: 'string',
-                  description: 'Stable identity for this detail panel.',
-                },
-                label: {
-                  type: 'string',
-                  description: 'Trigger label rendered on the Collapsible header.',
-                },
-                content: {
-                  type: 'string',
-                  description: 'Pre-formatted content shown inside the panel.',
-                },
-              },
-              additionalProperties: false,
-              required: ['content', 'id', 'label'],
-            },
-            description: 'Expandable detail panels (logs, payloads, errors) shown inline.',
-          },
-          link: {
+        anyOf: [
+          {
             type: 'object',
             properties: {
-              href: {
+              id: {
                 type: 'string',
-                description: 'Destination URL for the step link.',
+                description: 'Stable identity; used as the keyed list identity.',
               },
               label: {
                 type: 'string',
-                description: 'Visible text for the step link.',
+                description: 'Display label for this step.',
               },
-            },
-            additionalProperties: false,
-            required: ['href', 'label'],
-            description: 'Optional link to logs, traces, or a step detail route.',
-          },
-          children: {
-            type: 'array',
-            items: {
-              type: 'object',
-              properties: {
-                id: {
-                  type: 'string',
-                  description: 'Stable identity; used as the keyed list identity.',
-                },
-                label: {
-                  type: 'string',
-                  description: 'Display label for this step.',
-                },
-                status: {
-                  enum: [
-                    'pending',
-                    'running',
-                    'succeeded',
-                    'failed',
-                    'cancelled',
-                    'skipped',
-                    'retrying',
-                    'waiting_approval',
-                  ],
-                  description: 'Generic execution state.',
-                },
-                startTime: {
-                  type: 'string',
-                  description: 'ISO datetime string for when this step started.',
-                },
-                endTime: {
-                  type: 'string',
-                  description: 'ISO datetime string for when this step ended.',
-                },
-                duration: {
-                  type: 'string',
-                  description: 'Human-readable duration string, e.g. "1m 23s".',
-                },
-                attemptCount: {
-                  type: 'number',
-                  description: 'Number of attempts made so far, including any retries.',
-                },
-                actionsCount: {
-                  type: 'number',
-                  description: 'Number of actions associated with this step.',
-                },
-                progress: {
-                  type: 'number',
-                  description: 'Optional determinate progress value between 0 and `progressMax`.',
-                },
-                progressMax: {
-                  type: 'number',
-                  description: 'Maximum value for the progress bar. Defaults to 100.',
-                },
-                details: {
-                  type: 'array',
-                  items: {
-                    type: 'object',
-                    properties: {
-                      id: {
-                        type: 'string',
-                        description: 'Stable identity for this detail panel.',
-                      },
-                      label: {
-                        type: 'string',
-                        description: 'Trigger label rendered on the Collapsible header.',
-                      },
-                      content: {
-                        type: 'string',
-                        description: 'Pre-formatted content shown inside the panel.',
-                      },
-                    },
-                    additionalProperties: false,
-                    required: ['content', 'id', 'label'],
-                  },
-                  description: 'Expandable detail panels (logs, payloads, errors) shown inline.',
-                },
-                link: {
+              status: {
+                enum: [
+                  'pending',
+                  'running',
+                  'succeeded',
+                  'failed',
+                  'cancelled',
+                  'skipped',
+                  'retrying',
+                  'waiting_approval',
+                ],
+                description: 'Generic execution state.',
+              },
+              startTime: {
+                type: 'string',
+                description: 'ISO datetime string for when this step started.',
+              },
+              endTime: {
+                type: 'string',
+                description: 'ISO datetime string for when this step ended.',
+              },
+              duration: {
+                type: 'string',
+                description: 'Human-readable duration string, e.g. "1m 23s".',
+              },
+              attemptCount: {
+                type: 'number',
+                description: 'Number of attempts made so far, including any retries.',
+              },
+              actionsCount: {
+                type: 'number',
+                description: 'Number of actions associated with this step.',
+              },
+              progress: {
+                type: 'number',
+                description: 'Optional determinate progress value between 0 and `progressMax`.',
+              },
+              progressMax: {
+                type: 'number',
+                description: 'Maximum value for the progress bar. Defaults to 100.',
+              },
+              details: {
+                type: 'array',
+                items: {
                   type: 'object',
                   properties: {
-                    href: {
+                    id: {
                       type: 'string',
-                      description: 'Destination URL for the step link.',
+                      description: 'Stable identity for this detail panel.',
                     },
                     label: {
                       type: 'string',
-                      description: 'Visible text for the step link.',
+                      description: 'Trigger label rendered on the Collapsible header.',
+                    },
+                    content: {
+                      type: 'string',
+                      description: 'Pre-formatted content shown inside the panel.',
                     },
                   },
                   additionalProperties: false,
-                  required: ['href', 'label'],
-                  description: 'Optional link to logs, traces, or a step detail route.',
+                  required: ['content', 'id', 'label'],
                 },
-                children: {
-                  type: 'array',
-                  items: {
-                    type: 'object',
-                    properties: {
-                      id: {
-                        type: 'string',
-                        description: 'Stable identity; used as the keyed list identity.',
-                      },
-                      label: {
-                        type: 'string',
-                        description: 'Display label for this step.',
-                      },
-                      status: {
-                        enum: [
-                          'pending',
-                          'running',
-                          'succeeded',
-                          'failed',
-                          'cancelled',
-                          'skipped',
-                          'retrying',
-                          'waiting_approval',
-                        ],
-                        description: 'Generic execution state.',
-                      },
-                      startTime: {
-                        type: 'string',
-                        description: 'ISO datetime string for when this step started.',
-                      },
-                      endTime: {
-                        type: 'string',
-                        description: 'ISO datetime string for when this step ended.',
-                      },
-                      duration: {
-                        type: 'string',
-                        description: 'Human-readable duration string, e.g. "1m 23s".',
-                      },
-                      attemptCount: {
-                        type: 'number',
-                        description: 'Number of attempts made so far, including any retries.',
-                      },
-                      actionsCount: {
-                        type: 'number',
-                        description: 'Number of actions associated with this step.',
-                      },
-                      progress: {
-                        type: 'number',
-                        description:
-                          'Optional determinate progress value between 0 and `progressMax`.',
-                      },
-                      progressMax: {
-                        type: 'number',
-                        description: 'Maximum value for the progress bar. Defaults to 100.',
-                      },
-                      details: {
-                        type: 'array',
-                        items: {
-                          type: 'object',
-                          properties: {
-                            id: {
-                              type: 'string',
-                              description: 'Stable identity for this detail panel.',
-                            },
-                            label: {
-                              type: 'string',
-                              description: 'Trigger label rendered on the Collapsible header.',
-                            },
-                            content: {
-                              type: 'string',
-                              description: 'Pre-formatted content shown inside the panel.',
-                            },
-                          },
-                          additionalProperties: false,
-                          required: ['content', 'id', 'label'],
-                        },
-                        description:
-                          'Expandable detail panels (logs, payloads, errors) shown inline.',
-                      },
-                      link: {
+                description: 'Expandable detail panels (logs, payloads, errors) shown inline.',
+              },
+              link: {
+                type: 'object',
+                properties: {
+                  href: {
+                    type: 'string',
+                    description: 'Destination URL for the step link.',
+                  },
+                  label: {
+                    type: 'string',
+                    description: 'Visible text for the step link.',
+                  },
+                },
+                additionalProperties: false,
+                required: ['href', 'label'],
+                description: 'Optional link to logs, traces, or a step detail route.',
+              },
+              rewound: {
+                type: 'boolean',
+                description:
+                  'Marks a step that was speculatively executed and then unwound (rolled back).',
+              },
+              compensates: {
+                type: 'string',
+                description: 'Id of the forward step that this step compensates (reverses).',
+              },
+              children: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  properties: {
+                    id: {
+                      type: 'string',
+                      description: 'Stable identity; used as the keyed list identity.',
+                    },
+                    label: {
+                      type: 'string',
+                      description: 'Display label for this step.',
+                    },
+                    status: {
+                      enum: [
+                        'pending',
+                        'running',
+                        'succeeded',
+                        'failed',
+                        'cancelled',
+                        'skipped',
+                        'retrying',
+                        'waiting_approval',
+                      ],
+                      description: 'Generic execution state.',
+                    },
+                    startTime: {
+                      type: 'string',
+                      description: 'ISO datetime string for when this step started.',
+                    },
+                    endTime: {
+                      type: 'string',
+                      description: 'ISO datetime string for when this step ended.',
+                    },
+                    duration: {
+                      type: 'string',
+                      description: 'Human-readable duration string, e.g. "1m 23s".',
+                    },
+                    attemptCount: {
+                      type: 'number',
+                      description: 'Number of attempts made so far, including any retries.',
+                    },
+                    actionsCount: {
+                      type: 'number',
+                      description: 'Number of actions associated with this step.',
+                    },
+                    progress: {
+                      type: 'number',
+                      description:
+                        'Optional determinate progress value between 0 and `progressMax`.',
+                    },
+                    progressMax: {
+                      type: 'number',
+                      description: 'Maximum value for the progress bar. Defaults to 100.',
+                    },
+                    details: {
+                      type: 'array',
+                      items: {
                         type: 'object',
                         properties: {
-                          href: {
+                          id: {
                             type: 'string',
-                            description: 'Destination URL for the step link.',
+                            description: 'Stable identity for this detail panel.',
                           },
                           label: {
                             type: 'string',
-                            description: 'Visible text for the step link.',
+                            description: 'Trigger label rendered on the Collapsible header.',
+                          },
+                          content: {
+                            type: 'string',
+                            description: 'Pre-formatted content shown inside the panel.',
                           },
                         },
                         additionalProperties: false,
-                        required: ['href', 'label'],
-                        description: 'Optional link to logs, traces, or a step detail route.',
+                        required: ['content', 'id', 'label'],
                       },
-                      children: {
-                        type: 'array',
-                        items: {
-                          type: 'object',
-                          properties: {
-                            id: {
-                              type: 'string',
-                              description: 'Stable identity; used as the keyed list identity.',
-                            },
-                            label: {
-                              type: 'string',
-                              description: 'Display label for this step.',
-                            },
-                            status: {
-                              enum: [
-                                'pending',
-                                'running',
-                                'succeeded',
-                                'failed',
-                                'cancelled',
-                                'skipped',
-                                'retrying',
-                                'waiting_approval',
-                              ],
-                              description: 'Generic execution state.',
-                            },
-                            startTime: {
-                              type: 'string',
-                              description: 'ISO datetime string for when this step started.',
-                            },
-                            endTime: {
-                              type: 'string',
-                              description: 'ISO datetime string for when this step ended.',
-                            },
-                            duration: {
-                              type: 'string',
-                              description: 'Human-readable duration string, e.g. "1m 23s".',
-                            },
-                            attemptCount: {
-                              type: 'number',
-                              description: 'Number of attempts made so far, including any retries.',
-                            },
-                            actionsCount: {
-                              type: 'number',
-                              description: 'Number of actions associated with this step.',
-                            },
-                            progress: {
-                              type: 'number',
-                              description:
-                                'Optional determinate progress value between 0 and `progressMax`.',
+                      description:
+                        'Expandable detail panels (logs, payloads, errors) shown inline.',
+                    },
+                    link: {
+                      type: 'object',
+                      properties: {
+                        href: {
+                          type: 'string',
+                          description: 'Destination URL for the step link.',
+                        },
+                        label: {
+                          type: 'string',
+                          description: 'Visible text for the step link.',
+                        },
+                      },
+                      additionalProperties: false,
+                      required: ['href', 'label'],
+                      description: 'Optional link to logs, traces, or a step detail route.',
+                    },
+                    rewound: {
+                      type: 'boolean',
+                      description:
+                        'Marks a step that was speculatively executed and then unwound (rolled back).',
+                    },
+                    compensates: {
+                      type: 'string',
+                      description: 'Id of the forward step that this step compensates (reverses).',
+                    },
+                    children: {
+                      type: 'array',
+                      items: {
+                        type: 'object',
+                        properties: {
+                          id: {
+                            type: 'string',
+                            description: 'Stable identity; used as the keyed list identity.',
+                          },
+                          label: {
+                            type: 'string',
+                            description: 'Display label for this step.',
+                          },
+                          status: {
+                            enum: [
+                              'pending',
+                              'running',
+                              'succeeded',
+                              'failed',
+                              'cancelled',
+                              'skipped',
+                              'retrying',
+                              'waiting_approval',
+                            ],
+                            description: 'Generic execution state.',
+                          },
+                          startTime: {
+                            type: 'string',
+                            description: 'ISO datetime string for when this step started.',
+                          },
+                          endTime: {
+                            type: 'string',
+                            description: 'ISO datetime string for when this step ended.',
+                          },
+                          duration: {
+                            type: 'string',
+                            description: 'Human-readable duration string, e.g. "1m 23s".',
+                          },
+                          attemptCount: {
+                            type: 'number',
+                            description: 'Number of attempts made so far, including any retries.',
+                          },
+                          actionsCount: {
+                            type: 'number',
+                            description: 'Number of actions associated with this step.',
+                          },
+                          progress: {
+                            type: 'number',
+                            description:
+                              'Optional determinate progress value between 0 and `progressMax`.',
+                          },
+                          progressMax: {
+                            type: 'number',
+                            description: 'Maximum value for the progress bar. Defaults to 100.',
+                          },
+                          details: {
+                            type: 'array',
+                            items: {
+                              type: 'object',
+                              properties: {
+                                id: {
+                                  type: 'string',
+                                  description: 'Stable identity for this detail panel.',
+                                },
+                                label: {
+                                  type: 'string',
+                                  description: 'Trigger label rendered on the Collapsible header.',
+                                },
+                                content: {
+                                  type: 'string',
+                                  description: 'Pre-formatted content shown inside the panel.',
+                                },
+                              },
+                              additionalProperties: false,
+                              required: ['content', 'id', 'label'],
                             },
-                            progressMax: {
-                              type: 'number',
-                              description: 'Maximum value for the progress bar. Defaults to 100.',
+                            description:
+                              'Expandable detail panels (logs, payloads, errors) shown inline.',
+                          },
+                          link: {
+                            type: 'object',
+                            properties: {
+                              href: {
+                                type: 'string',
+                                description: 'Destination URL for the step link.',
+                              },
+                              label: {
+                                type: 'string',
+                                description: 'Visible text for the step link.',
+                              },
                             },
-                            details: {
-                              type: 'array',
-                              items: {
-                                type: 'object',
-                                properties: {
-                                  id: {
-                                    type: 'string',
-                                    description: 'Stable identity for this detail panel.',
+                            additionalProperties: false,
+                            required: ['href', 'label'],
+                            description: 'Optional link to logs, traces, or a step detail route.',
+                          },
+                          rewound: {
+                            type: 'boolean',
+                            description:
+                              'Marks a step that was speculatively executed and then unwound (rolled back).',
+                          },
+                          compensates: {
+                            type: 'string',
+                            description:
+                              'Id of the forward step that this step compensates (reverses).',
+                          },
+                          children: {
+                            type: 'array',
+                            items: {
+                              type: 'object',
+                              properties: {
+                                id: {
+                                  type: 'string',
+                                  description: 'Stable identity; used as the keyed list identity.',
+                                },
+                                label: {
+                                  type: 'string',
+                                  description: 'Display label for this step.',
+                                },
+                                status: {
+                                  enum: [
+                                    'pending',
+                                    'running',
+                                    'succeeded',
+                                    'failed',
+                                    'cancelled',
+                                    'skipped',
+                                    'retrying',
+                                    'waiting_approval',
+                                  ],
+                                  description: 'Generic execution state.',
+                                },
+                                startTime: {
+                                  type: 'string',
+                                  description: 'ISO datetime string for when this step started.',
+                                },
+                                endTime: {
+                                  type: 'string',
+                                  description: 'ISO datetime string for when this step ended.',
+                                },
+                                duration: {
+                                  type: 'string',
+                                  description: 'Human-readable duration string, e.g. "1m 23s".',
+                                },
+                                attemptCount: {
+                                  type: 'number',
+                                  description:
+                                    'Number of attempts made so far, including any retries.',
+                                },
+                                actionsCount: {
+                                  type: 'number',
+                                  description: 'Number of actions associated with this step.',
+                                },
+                                progress: {
+                                  type: 'number',
+                                  description:
+                                    'Optional determinate progress value between 0 and `progressMax`.',
+                                },
+                                progressMax: {
+                                  type: 'number',
+                                  description:
+                                    'Maximum value for the progress bar. Defaults to 100.',
+                                },
+                                details: {
+                                  type: 'array',
+                                  items: {
+                                    type: 'object',
+                                    properties: {
+                                      id: {
+                                        type: 'string',
+                                        description: 'Stable identity for this detail panel.',
+                                      },
+                                      label: {
+                                        type: 'string',
+                                        description:
+                                          'Trigger label rendered on the Collapsible header.',
+                                      },
+                                      content: {
+                                        type: 'string',
+                                        description:
+                                          'Pre-formatted content shown inside the panel.',
+                                      },
+                                    },
+                                    additionalProperties: false,
+                                    required: ['content', 'id', 'label'],
                                   },
-                                  label: {
-                                    type: 'string',
-                                    description:
-                                      'Trigger label rendered on the Collapsible header.',
+                                  description:
+                                    'Expandable detail panels (logs, payloads, errors) shown inline.',
+                                },
+                                link: {
+                                  type: 'object',
+                                  properties: {
+                                    href: {
+                                      type: 'string',
+                                      description: 'Destination URL for the step link.',
+                                    },
+                                    label: {
+                                      type: 'string',
+                                      description: 'Visible text for the step link.',
+                                    },
                                   },
-                                  content: {
-                                    type: 'string',
-                                    description: 'Pre-formatted content shown inside the panel.',
+                                  additionalProperties: false,
+                                  required: ['href', 'label'],
+                                  description:
+                                    'Optional link to logs, traces, or a step detail route.',
+                                },
+                                rewound: {
+                                  type: 'boolean',
+                                  description:
+                                    'Marks a step that was speculatively executed and then unwound (rolled back).',
+                                },
+                                compensates: {
+                                  type: 'string',
+                                  description:
+                                    'Id of the forward step that this step compensates (reverses).',
+                                },
+                                children: {
+                                  type: 'array',
+                                  items: {
+                                    type: 'object',
+                                    additionalProperties: true,
                                   },
+                                  description:
+                                    'Descendants beyond the rendered depth cap; summarized as a depth-limit row.',
                                 },
-                                additionalProperties: false,
-                                required: ['content', 'id', 'label'],
                               },
-                              description:
-                                'Expandable detail panels (logs, payloads, errors) shown inline.',
+                              additionalProperties: false,
+                              required: ['id', 'label', 'status'],
                             },
-                            link: {
+                            description: 'Nested child-workflow steps rendered at depth 3.',
+                          },
+                        },
+                        additionalProperties: false,
+                        required: ['id', 'label', 'status'],
+                      },
+                      description: 'Nested child-workflow steps rendered at depth 2.',
+                    },
+                  },
+                  additionalProperties: false,
+                  required: ['id', 'label', 'status'],
+                },
+                description: 'Schema-bounded nested child-workflow steps.',
+              },
+            },
+            additionalProperties: false,
+            required: ['id', 'label', 'status'],
+          },
+          {
+            type: 'object',
+            properties: {
+              kind: {
+                const: 'branch',
+                description: 'Discriminator identifying a branch-group entry.',
+              },
+              id: {
+                type: 'string',
+                description: 'Stable identity; used as the keyed list identity.',
+              },
+              label: {
+                type: 'string',
+                description: 'Display label for the branch group.',
+              },
+              lanes: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  properties: {
+                    id: {
+                      type: 'string',
+                      description:
+                        'Stable identity; used as the keyed list identity within the group.',
+                    },
+                    label: {
+                      type: 'string',
+                      description: 'Optional display label for the lane.',
+                    },
+                    outcome: {
+                      enum: ['won', 'lost', 'settled'],
+                      description:
+                        'Competitive outcome for the lane. Omit while the branch is still racing.',
+                    },
+                    steps: {
+                      type: 'array',
+                      items: {
+                        type: 'object',
+                        properties: {
+                          id: {
+                            type: 'string',
+                            description: 'Stable identity; used as the keyed list identity.',
+                          },
+                          label: {
+                            type: 'string',
+                            description: 'Display label for this step.',
+                          },
+                          status: {
+                            enum: [
+                              'pending',
+                              'running',
+                              'succeeded',
+                              'failed',
+                              'cancelled',
+                              'skipped',
+                              'retrying',
+                              'waiting_approval',
+                            ],
+                            description: 'Generic execution state.',
+                          },
+                          startTime: {
+                            type: 'string',
+                            description: 'ISO datetime string for when this step started.',
+                          },
+                          endTime: {
+                            type: 'string',
+                            description: 'ISO datetime string for when this step ended.',
+                          },
+                          duration: {
+                            type: 'string',
+                            description: 'Human-readable duration string, e.g. "1m 23s".',
+                          },
+                          attemptCount: {
+                            type: 'number',
+                            description: 'Number of attempts made so far, including any retries.',
+                          },
+                          actionsCount: {
+                            type: 'number',
+                            description: 'Number of actions associated with this step.',
+                          },
+                          progress: {
+                            type: 'number',
+                            description:
+                              'Optional determinate progress value between 0 and `progressMax`.',
+                          },
+                          progressMax: {
+                            type: 'number',
+                            description: 'Maximum value for the progress bar. Defaults to 100.',
+                          },
+                          details: {
+                            type: 'array',
+                            items: {
                               type: 'object',
                               properties: {
-                                href: {
+                                id: {
                                   type: 'string',
-                                  description: 'Destination URL for the step link.',
+                                  description: 'Stable identity for this detail panel.',
                                 },
                                 label: {
                                   type: 'string',
-                                  description: 'Visible text for the step link.',
+                                  description: 'Trigger label rendered on the Collapsible header.',
+                                },
+                                content: {
+                                  type: 'string',
+                                  description: 'Pre-formatted content shown inside the panel.',
                                 },
                               },
                               additionalProperties: false,
-                              required: ['href', 'label'],
-                              description: 'Optional link to logs, traces, or a step detail route.',
+                              required: ['content', 'id', 'label'],
+                            },
+                            description:
+                              'Expandable detail panels (logs, payloads, errors) shown inline.',
+                          },
+                          link: {
+                            type: 'object',
+                            properties: {
+                              href: {
+                                type: 'string',
+                                description: 'Destination URL for the step link.',
+                              },
+                              label: {
+                                type: 'string',
+                                description: 'Visible text for the step link.',
+                              },
                             },
-                            children: {
-                              type: 'array',
-                              items: {
-                                type: 'object',
-                                additionalProperties: true,
+                            additionalProperties: false,
+                            required: ['href', 'label'],
+                            description: 'Optional link to logs, traces, or a step detail route.',
+                          },
+                          rewound: {
+                            type: 'boolean',
+                            description:
+                              'Marks a step that was speculatively executed and then unwound (rolled back).',
+                          },
+                          compensates: {
+                            type: 'string',
+                            description:
+                              'Id of the forward step that this step compensates (reverses).',
+                          },
+                          children: {
+                            type: 'array',
+                            items: {
+                              type: 'object',
+                              properties: {
+                                id: {
+                                  type: 'string',
+                                  description: 'Stable identity; used as the keyed list identity.',
+                                },
+                                label: {
+                                  type: 'string',
+                                  description: 'Display label for this step.',
+                                },
+                                status: {
+                                  enum: [
+                                    'pending',
+                                    'running',
+                                    'succeeded',
+                                    'failed',
+                                    'cancelled',
+                                    'skipped',
+                                    'retrying',
+                                    'waiting_approval',
+                                  ],
+                                  description: 'Generic execution state.',
+                                },
+                                startTime: {
+                                  type: 'string',
+                                  description: 'ISO datetime string for when this step started.',
+                                },
+                                endTime: {
+                                  type: 'string',
+                                  description: 'ISO datetime string for when this step ended.',
+                                },
+                                duration: {
+                                  type: 'string',
+                                  description: 'Human-readable duration string, e.g. "1m 23s".',
+                                },
+                                attemptCount: {
+                                  type: 'number',
+                                  description:
+                                    'Number of attempts made so far, including any retries.',
+                                },
+                                actionsCount: {
+                                  type: 'number',
+                                  description: 'Number of actions associated with this step.',
+                                },
+                                progress: {
+                                  type: 'number',
+                                  description:
+                                    'Optional determinate progress value between 0 and `progressMax`.',
+                                },
+                                progressMax: {
+                                  type: 'number',
+                                  description:
+                                    'Maximum value for the progress bar. Defaults to 100.',
+                                },
+                                details: {
+                                  type: 'array',
+                                  items: {
+                                    type: 'object',
+                                    properties: {
+                                      id: {
+                                        type: 'string',
+                                        description: 'Stable identity for this detail panel.',
+                                      },
+                                      label: {
+                                        type: 'string',
+                                        description:
+                                          'Trigger label rendered on the Collapsible header.',
+                                      },
+                                      content: {
+                                        type: 'string',
+                                        description:
+                                          'Pre-formatted content shown inside the panel.',
+                                      },
+                                    },
+                                    additionalProperties: false,
+                                    required: ['content', 'id', 'label'],
+                                  },
+                                  description:
+                                    'Expandable detail panels (logs, payloads, errors) shown inline.',
+                                },
+                                link: {
+                                  type: 'object',
+                                  properties: {
+                                    href: {
+                                      type: 'string',
+                                      description: 'Destination URL for the step link.',
+                                    },
+                                    label: {
+                                      type: 'string',
+                                      description: 'Visible text for the step link.',
+                                    },
+                                  },
+                                  additionalProperties: false,
+                                  required: ['href', 'label'],
+                                  description:
+                                    'Optional link to logs, traces, or a step detail route.',
+                                },
+                                rewound: {
+                                  type: 'boolean',
+                                  description:
+                                    'Marks a step that was speculatively executed and then unwound (rolled back).',
+                                },
+                                compensates: {
+                                  type: 'string',
+                                  description:
+                                    'Id of the forward step that this step compensates (reverses).',
+                                },
+                                children: {
+                                  type: 'array',
+                                  items: {
+                                    type: 'object',
+                                    properties: {
+                                      id: {
+                                        type: 'string',
+                                        description:
+                                          'Stable identity; used as the keyed list identity.',
+                                      },
+                                      label: {
+                                        type: 'string',
+                                        description: 'Display label for this step.',
+                                      },
+                                      status: {
+                                        enum: [
+                                          'pending',
+                                          'running',
+                                          'succeeded',
+                                          'failed',
+                                          'cancelled',
+                                          'skipped',
+                                          'retrying',
+                                          'waiting_approval',
+                                        ],
+                                        description: 'Generic execution state.',
+                                      },
+                                      startTime: {
+                                        type: 'string',
+                                        description:
+                                          'ISO datetime string for when this step started.',
+                                      },
+                                      endTime: {
+                                        type: 'string',
+                                        description:
+                                          'ISO datetime string for when this step ended.',
+                                      },
+                                      duration: {
+                                        type: 'string',
+                                        description:
+                                          'Human-readable duration string, e.g. "1m 23s".',
+                                      },
+                                      attemptCount: {
+                                        type: 'number',
+                                        description:
+                                          'Number of attempts made so far, including any retries.',
+                                      },
+                                      actionsCount: {
+                                        type: 'number',
+                                        description: 'Number of actions associated with this step.',
+                                      },
+                                      progress: {
+                                        type: 'number',
+                                        description:
+                                          'Optional determinate progress value between 0 and `progressMax`.',
+                                      },
+                                      progressMax: {
+                                        type: 'number',
+                                        description:
+                                          'Maximum value for the progress bar. Defaults to 100.',
+                                      },
+                                      details: {
+                                        type: 'array',
+                                        items: {
+                                          type: 'object',
+                                          properties: {
+                                            id: {
+                                              type: 'string',
+                                              description: 'Stable identity for this detail panel.',
+                                            },
+                                            label: {
+                                              type: 'string',
+                                              description:
+                                                'Trigger label rendered on the Collapsible header.',
+                                            },
+                                            content: {
+                                              type: 'string',
+                                              description:
+                                                'Pre-formatted content shown inside the panel.',
+                                            },
+                                          },
+                                          additionalProperties: false,
+                                          required: ['content', 'id', 'label'],
+                                        },
+                                        description:
+                                          'Expandable detail panels (logs, payloads, errors) shown inline.',
+                                      },
+                                      link: {
+                                        type: 'object',
+                                        properties: {
+                                          href: {
+                                            type: 'string',
+                                            description: 'Destination URL for the step link.',
+                                          },
+                                          label: {
+                                            type: 'string',
+                                            description: 'Visible text for the step link.',
+                                          },
+                                        },
+                                        additionalProperties: false,
+                                        required: ['href', 'label'],
+                                        description:
+                                          'Optional link to logs, traces, or a step detail route.',
+                                      },
+                                      rewound: {
+                                        type: 'boolean',
+                                        description:
+                                          'Marks a step that was speculatively executed and then unwound (rolled back).',
+                                      },
+                                      compensates: {
+                                        type: 'string',
+                                        description:
+                                          'Id of the forward step that this step compensates (reverses).',
+                                      },
+                                      children: {
+                                        type: 'array',
+                                        items: {
+                                          type: 'object',
+                                          properties: {
+                                            id: {
+                                              type: 'string',
+                                              description:
+                                                'Stable identity; used as the keyed list identity.',
+                                            },
+                                            label: {
+                                              type: 'string',
+                                              description: 'Display label for this step.',
+                                            },
+                                            status: {
+                                              enum: [
+                                                'pending',
+                                                'running',
+                                                'succeeded',
+                                                'failed',
+                                                'cancelled',
+                                                'skipped',
+                                                'retrying',
+                                                'waiting_approval',
+                                              ],
+                                              description: 'Generic execution state.',
+                                            },
+                                            startTime: {
+                                              type: 'string',
+                                              description:
+                                                'ISO datetime string for when this step started.',
+                                            },
+                                            endTime: {
+                                              type: 'string',
+                                              description:
+                                                'ISO datetime string for when this step ended.',
+                                            },
+                                            duration: {
+                                              type: 'string',
+                                              description:
+                                                'Human-readable duration string, e.g. "1m 23s".',
+                                            },
+                                            attemptCount: {
+                                              type: 'number',
+                                              description:
+                                                'Number of attempts made so far, including any retries.',
+                                            },
+                                            actionsCount: {
+                                              type: 'number',
+                                              description:
+                                                'Number of actions associated with this step.',
+                                            },
+                                            progress: {
+                                              type: 'number',
+                                              description:
+                                                'Optional determinate progress value between 0 and `progressMax`.',
+                                            },
+                                            progressMax: {
+                                              type: 'number',
+                                              description:
+                                                'Maximum value for the progress bar. Defaults to 100.',
+                                            },
+                                            details: {
+                                              type: 'array',
+                                              items: {
+                                                type: 'object',
+                                                properties: {
+                                                  id: {
+                                                    type: 'string',
+                                                    description:
+                                                      'Stable identity for this detail panel.',
+                                                  },
+                                                  label: {
+                                                    type: 'string',
+                                                    description:
+                                                      'Trigger label rendered on the Collapsible header.',
+                                                  },
+                                                  content: {
+                                                    type: 'string',
+                                                    description:
+                                                      'Pre-formatted content shown inside the panel.',
+                                                  },
+                                                },
+                                                additionalProperties: false,
+                                                required: ['content', 'id', 'label'],
+                                              },
+                                              description:
+                                                'Expandable detail panels (logs, payloads, errors) shown inline.',
+                                            },
+                                            link: {
+                                              type: 'object',
+                                              properties: {
+                                                href: {
+                                                  type: 'string',
+                                                  description: 'Destination URL for the step link.',
+                                                },
+                                                label: {
+                                                  type: 'string',
+                                                  description: 'Visible text for the step link.',
+                                                },
+                                              },
+                                              additionalProperties: false,
+                                              required: ['href', 'label'],
+                                              description:
+                                                'Optional link to logs, traces, or a step detail route.',
+                                            },
+                                            rewound: {
+                                              type: 'boolean',
+                                              description:
+                                                'Marks a step that was speculatively executed and then unwound (rolled back).',
+                                            },
+                                            compensates: {
+                                              type: 'string',
+                                              description:
+                                                'Id of the forward step that this step compensates (reverses).',
+                                            },
+                                            children: {
+                                              type: 'array',
+                                              items: {
+                                                type: 'object',
+                                                additionalProperties: true,
+                                              },
+                                              description:
+                                                'Descendants beyond the rendered depth cap; summarized as a depth-limit row.',
+                                            },
+                                          },
+                                          additionalProperties: false,
+                                          required: ['id', 'label', 'status'],
+                                        },
+                                        description:
+                                          'Nested child-workflow steps rendered at depth 3.',
+                                      },
+                                    },
+                                    additionalProperties: false,
+                                    required: ['id', 'label', 'status'],
+                                  },
+                                  description: 'Nested child-workflow steps rendered at depth 2.',
+                                },
                               },
-                              description:
-                                'Descendants beyond the rendered depth cap; summarized as a depth-limit row.',
+                              additionalProperties: false,
+                              required: ['id', 'label', 'status'],
                             },
+                            description: 'Schema-bounded nested child-workflow steps.',
                           },
-                          additionalProperties: false,
-                          required: ['id', 'label', 'status'],
                         },
-                        description: 'Nested child-workflow steps rendered at depth 3.',
+                        additionalProperties: false,
+                        required: ['id', 'label', 'status'],
                       },
+                      description: 'Ordered steps that ran within this lane.',
                     },
-                    additionalProperties: false,
-                    required: ['id', 'label', 'status'],
                   },
-                  description: 'Nested child-workflow steps rendered at depth 2.',
+                  additionalProperties: false,
+                  required: ['id', 'steps'],
                 },
+                description: 'The parallel sub-lanes.',
+              },
+              collapseThreshold: {
+                type: 'integer',
+                minimum: 1,
+                description:
+                  'Collapse the group by default once the lane count reaches this threshold. Defaults to 3.',
+              },
+              collapsed: {
+                type: 'boolean',
+                description: 'Force the initial collapsed (`true`) or expanded (`false`) state.',
               },
-              additionalProperties: false,
-              required: ['id', 'label', 'status'],
             },
-            description: 'Schema-bounded nested child-workflow steps.',
+            additionalProperties: false,
+            required: ['id', 'kind', 'label', 'lanes'],
           },
-        },
-        additionalProperties: false,
-        required: ['id', 'label', 'status'],
+        ],
       },
-      description: 'Ordered list of steps to render.',
+      description:
+        'Ordered list of timeline entries to render — either steps or branch/coordination groups.',
     },
   },
   additionalProperties: false,