fabro/docs/execution
Bryan Helmkamp b2b25fbe6c Apply API design guidelines to all non-Session endpoints
Enrich the entire OpenAPI spec with descriptions, examples, format
annotations, extracted parameters, discriminated unions, and richer
response schemas — matching the patterns already established for
Sessions.

Structural changes:
- Extract CancelRunResponse and SteerRunResponse from inline schemas
- Change POST /runs/{id}/steer from 200 to 202 (async fire-and-forget)
- Split StageTurn into discriminated union (SystemStageTurn,
  AssistantStageTurn, ToolStageTurn) with oneOf + discriminator
- Add status + created_at to StartRunResponse
- Add created_at to RunListItem and RunStatusResponse
- Add created_at + updated_at to SavedQuery
- Add format: date-time on RetroListItem.timestamp
- Extract 7 new reusable parameters (StageId, QuestionId, WorkflowName,
  VerificationSlug, InsightQueryId, ProjectId, CheckpointFilter)
- Enrich existing RunId, PageLimit, PageOffset parameters
- Add descriptions + examples to all ~66 schemas and ~200+ properties
- Add operation descriptions to all ~35 endpoints

Rust handler updates:
- Change ManagedRun.created_at from Instant to chrono::DateTime<Utc>
- Populate new fields in StartRunResponse, RunStatusResponse
- Use new StageTurn discriminated union variants in demo data
- Update demo data timestamps to use DateTime<Utc>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 10:30:33 -05:00
..
checkpoints.mdx Add Daytona network access control and fill in execution docs 2026-03-05 18:31:19 -05:00
context.mdx Fill in tutorials, examples, and reference docs with content and SVGs 2026-03-05 22:14:02 -05:00
environments.mdx Switch Daytona git cloning from gh CLI to GitHub App Installation Access Tokens 2026-03-05 22:31:40 -05:00
failures.mdx Implement per-node max_visits override for loop detection 2026-03-05 22:05:11 -05:00
interviews.mdx Add custom TextMate grammar for DOT syntax highlighting in docs 2026-03-05 21:41:54 -05:00
observability.mdx Apply API design guidelines to all non-Session endpoints 2026-03-06 10:30:33 -05:00
retros.mdx Apply API design guidelines to all non-Session endpoints 2026-03-06 10:30:33 -05:00
run-configuration.mdx Add custom TextMate grammar for DOT syntax highlighting in docs 2026-03-05 21:41:54 -05:00