@ancplua/qyl-api-schema 4.0.0 → 5.1.0

package/generated/json-schema/qyl-api-schema.json

@@ -212,7 +212,7 @@
       "minLength": 23,
       "maxLength": 23,
       "pattern": "^sha256:[a-f0-9]{16}$",
-      "description": "Deterministic revision of the generated API contract: 'sha256:' followed by the first 16 hex characters of the SHA-256 digest of the emitted OpenAPI document.",
+      "description": "Deterministic revision of the generated API contract: 'sha256:' followed by the first 16 hex characters of its canonical semantic digest.",
       "examples": [
         "sha256:0f1e2d3c4b5a6978"
       ]
@@ -1543,6 +1543,50 @@
       },
       "description": "One CI run, summarized from the session its telemetry is grouped under."
     },
+    "Mcp.Tools.ControlWorkflowRunInput": {
+      "type": "object",
+      "required": [
+        "run_id",
+        "action",
+        "idempotency_key"
+      ],
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "action": {
+          "$ref": "#/$defs/Workflow.WorkflowControlAction"
+        },
+        "idempotency_key": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160
+        },
+        "input": {
+          "type": "string",
+          "maxLength": 32768
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Input for control_workflow_run."
+    },
+    "Mcp.Tools.ControlWorkflowRunOutput": {
+      "type": "object",
+      "required": [
+        "command"
+      ],
+      "properties": {
+        "command": {
+          "$ref": "#/$defs/Workflow.WorkflowControlCommand"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Structured output for control_workflow_run."
+    },
     "Mcp.Tools.DisplayMcpDashboardInput": {
       "type": "object",
       "properties": {
@@ -1621,6 +1665,61 @@
       },
       "description": "Structured output for display_traces."
     },
+    "Mcp.Tools.DisplayWorkflowGraphInput": {
+      "type": "object",
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "node_cursor": {
+          "type": "string"
+        },
+        "node_limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 1000,
+          "default": 250
+        },
+        "edge_cursor": {
+          "type": "string"
+        },
+        "edge_limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 2000,
+          "default": 500
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Input for display_workflow_graph. Omit run_id to select the most recent run."
+    },
+    "Mcp.Tools.DisplayWorkflowGraphOutput": {
+      "type": "object",
+      "required": [
+        "graph",
+        "live_controls_available",
+        "mode"
+      ],
+      "properties": {
+        "graph": {
+          "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
+        },
+        "live_controls_available": {
+          "type": "boolean"
+        },
+        "mode": {
+          "$ref": "#/$defs/Mcp.Tools.McpDataMode"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Structured output for display_workflow_graph."
+    },
     "Mcp.Tools.FetchTelemetryInput": {
       "type": "object",
       "required": [
@@ -1706,6 +1805,88 @@
       ],
       "description": "Data projection requested by the app-only fetch_telemetry tool."
     },
+    "Mcp.Tools.FetchWorkflowGraphUpdatesInput": {
+      "type": "object",
+      "required": [
+        "run_id",
+        "after_sequence"
+      ],
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "after_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 1000,
+          "default": 250
+        },
+        "wait_ms": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "maximum": 30000,
+          "default": 20000
+        },
+        "node_cursor": {
+          "type": "string"
+        },
+        "node_limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 1000,
+          "default": 250
+        },
+        "edge_cursor": {
+          "type": "string"
+        },
+        "edge_limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 2000,
+          "default": 500
+        },
+        "content_ref": {
+          "$ref": "#/$defs/Workflow.WorkflowContentRef",
+          "description": "Optional captured payload to retrieve lazily for the selected run."
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Input for the app-only fetch_workflow_graph_updates tool."
+    },
+    "Mcp.Tools.FetchWorkflowGraphUpdatesOutput": {
+      "type": "object",
+      "required": [
+        "page",
+        "mode"
+      ],
+      "properties": {
+        "page": {
+          "$ref": "#/$defs/Workflow.WorkflowEventPage"
+        },
+        "graph": {
+          "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
+        },
+        "content": {
+          "$ref": "#/$defs/Workflow.WorkflowContent"
+        },
+        "mode": {
+          "$ref": "#/$defs/Mcp.Tools.McpDataMode"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Structured output for the app-only fetch_workflow_graph_updates tool."
+    },
     "Mcp.Tools.GetTraceInput": {
       "type": "object",
       "required": [
@@ -1740,6 +1921,60 @@
       },
       "description": "Structured output for get_trace."
     },
+    "Mcp.Tools.GetWorkflowGraphInput": {
+      "type": "object",
+      "required": [
+        "run_id"
+      ],
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "node_cursor": {
+          "type": "string"
+        },
+        "node_limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 1000,
+          "default": 250
+        },
+        "edge_cursor": {
+          "type": "string"
+        },
+        "edge_limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 2000,
+          "default": 500
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Input for get_workflow_graph."
+    },
+    "Mcp.Tools.GetWorkflowGraphOutput": {
+      "type": "object",
+      "required": [
+        "graph",
+        "mode"
+      ],
+      "properties": {
+        "graph": {
+          "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
+        },
+        "mode": {
+          "$ref": "#/$defs/Mcp.Tools.McpDataMode"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Structured output for get_workflow_graph."
+    },
     "Mcp.Tools.ListSessionsInput": {
       "type": "object",
       "properties": {
@@ -1819,6 +2054,57 @@
       },
       "description": "Structured output for list_traces."
     },
+    "Mcp.Tools.ListWorkflowRunsInput": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "$ref": "#/$defs/Workflow.WorkflowRunStatus"
+        },
+        "cursor": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 100,
+          "default": 20
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Input for list_workflow_runs."
+    },
+    "Mcp.Tools.ListWorkflowRunsOutput": {
+      "type": "object",
+      "required": [
+        "runs",
+        "has_more",
+        "mode"
+      ],
+      "properties": {
+        "runs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowRun"
+          }
+        },
+        "next_cursor": {
+          "type": "string"
+        },
+        "has_more": {
+          "type": "boolean"
+        },
+        "mode": {
+          "$ref": "#/$defs/Mcp.Tools.McpDataMode"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Structured output for list_workflow_runs."
+    },
     "Mcp.Tools.McpDashboardBucket": {
       "type": "object",
       "required": [
@@ -5853,43 +6139,1036 @@
       },
       "description": "Request to update mutable MCP workbench workspace metadata."
     },
-    "Operations.LogsApi_list.Response.200": {
+    "Workflow.DerivedWorkflowEdgeProvenance": {
       "type": "object",
       "required": [
-        "items",
-        "has_more"
+        "type",
+        "event_ids",
+        "evidence",
+        "confidence"
       ],
       "properties": {
-        "items": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "derived"
+          ]
+        },
+        "event_ids": {
           "type": "array",
           "items": {
-            "$ref": "#/$defs/OTel.Logs.LogRecord"
+            "$ref": "#/$defs/Workflow.WorkflowEventId"
           },
-          "description": "List of items in this page"
+          "minItems": 1
         },
-        "next_cursor": {
-          "type": "string",
-          "description": "Cursor for the next page (null if no more pages)"
+        "evidence": {
+          "type": "string"
         },
-        "prev_cursor": {
+        "confidence": {
+          "$ref": "#/$defs/Common.Ratio"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Derived edge provenance with explicit evidence and confidence."
+    },
+    "Workflow.RecordedWorkflowEdgeProvenance": {
+      "type": "object",
+      "required": [
+        "type",
+        "event_ids"
+      ],
+      "properties": {
+        "type": {
           "type": "string",
-          "description": "Cursor for the previous page (null if first page)"
+          "enum": [
+            "recorded"
+          ]
         },
-        "has_more": {
-          "type": "boolean",
-          "description": "Whether there are more items available"
+        "event_ids": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowEventId"
+          },
+          "minItems": 1
         }
       },
       "unevaluatedProperties": {
         "not": {}
       },
-      "description": "Cursor-based paginated response wrapper"
+      "description": "Recorded edge provenance directly observed from Codex."
     },
-    "Operations.LogsApi_list.Response.400": {
-      "$ref": "#/$defs/Common.Errors.ValidationError"
-    },
-    "Operations.LogsApi_list.Response.401": {
-      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    "Workflow.WorkflowAgentId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Stable identifier of one agent within a workflow run."
+    },
+    "Workflow.WorkflowAgentStatus": {
+      "type": "string",
+      "enum": [
+        "pending",
+        "running",
+        "waiting",
+        "succeeded",
+        "failed",
+        "interrupted"
+      ],
+      "description": "Current lifecycle of an observed workflow agent."
+    },
+    "Workflow.WorkflowAttemptId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Stable identifier of one workflow attempt."
+    },
+    "Workflow.WorkflowAttemptStatus": {
+      "type": "string",
+      "enum": [
+        "pending",
+        "running",
+        "succeeded",
+        "failed",
+        "interrupted"
+      ],
+      "description": "Current lifecycle of one workflow attempt."
+    },
+    "Workflow.WorkflowCommandId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Stable identifier of one run-level control command."
+    },
+    "Workflow.WorkflowContent": {
+      "type": "object",
+      "required": [
+        "content_ref",
+        "content_type",
+        "encoding",
+        "content",
+        "size_bytes"
+      ],
+      "properties": {
+        "content_ref": {
+          "$ref": "#/$defs/Workflow.WorkflowContentRef"
+        },
+        "content_type": {
+          "$ref": "#/$defs/Common.ContentType"
+        },
+        "encoding": {
+          "$ref": "#/$defs/Workflow.WorkflowContentEncoding"
+        },
+        "content": {
+          "type": "string"
+        },
+        "size_bytes": {
+          "$ref": "#/$defs/Common.ByteSize"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Lazily retrieved captured workflow content."
+    },
+    "Workflow.WorkflowContentChunk": {
+      "type": "object",
+      "required": [
+        "content_ref",
+        "content_type",
+        "encoding",
+        "content"
+      ],
+      "properties": {
+        "content_ref": {
+          "$ref": "#/$defs/Workflow.WorkflowContentRef"
+        },
+        "content_type": {
+          "$ref": "#/$defs/Common.ContentType"
+        },
+        "encoding": {
+          "$ref": "#/$defs/Workflow.WorkflowContentEncoding"
+        },
+        "content": {
+          "type": "string",
+          "maxLength": 1398104,
+          "description": "UTF-8 text or base64 bytes, according to encoding."
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "One captured payload supplied with an append batch."
+    },
+    "Workflow.WorkflowContentEncoding": {
+      "type": "string",
+      "enum": [
+        "utf8",
+        "base64"
+      ],
+      "description": "Encoding used when lazily returning captured workflow content."
+    },
+    "Workflow.WorkflowContentRef": {
+      "type": "string",
+      "minLength": 71,
+      "maxLength": 71,
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Content-addressed reference to a captured workflow payload."
+    },
+    "Workflow.WorkflowControlAction": {
+      "type": "string",
+      "enum": [
+        "steer",
+        "interrupt",
+        "resume"
+      ],
+      "description": "Control operation supported by the Codex app-server boundary."
+    },
+    "Workflow.WorkflowControlCommand": {
+      "type": "object",
+      "required": [
+        "command_id",
+        "run_id",
+        "action",
+        "status",
+        "idempotency_key",
+        "requested_at",
+        "updated_at",
+        "command_sequence"
+      ],
+      "properties": {
+        "command_id": {
+          "$ref": "#/$defs/Workflow.WorkflowCommandId"
+        },
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "action": {
+          "$ref": "#/$defs/Workflow.WorkflowControlAction"
+        },
+        "status": {
+          "$ref": "#/$defs/Workflow.WorkflowControlStatus"
+        },
+        "idempotency_key": {
+          "type": "string"
+        },
+        "input": {
+          "type": "string"
+        },
+        "requested_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "command_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Durable run-level control command."
+    },
+    "Workflow.WorkflowControlCommandPage": {
+      "type": "object",
+      "required": [
+        "commands",
+        "next_sequence"
+      ],
+      "properties": {
+        "commands": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowControlCommand"
+          }
+        },
+        "next_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Page of control commands polled by the launcher-owned outbound adapter."
+    },
+    "Workflow.WorkflowControlRequest": {
+      "type": "object",
+      "required": [
+        "action",
+        "idempotency_key"
+      ],
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/Workflow.WorkflowControlAction"
+        },
+        "idempotency_key": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160
+        },
+        "input": {
+          "type": "string",
+          "maxLength": 32768,
+          "description": "Text appended by steer or resume. Omit for interrupt."
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Request to enqueue one idempotent run-level control command."
+    },
+    "Workflow.WorkflowControlStatus": {
+      "type": "string",
+      "enum": [
+        "requested",
+        "accepted",
+        "applied",
+        "rejected",
+        "failed"
+      ],
+      "description": "Durable lifecycle of a workflow control command."
+    },
+    "Workflow.WorkflowControlStatusUpdateRequest": {
+      "type": "object",
+      "required": [
+        "status"
+      ],
+      "properties": {
+        "status": {
+          "$ref": "#/$defs/Workflow.WorkflowControlStatus"
+        },
+        "error": {
+          "type": "string"
+        },
+        "occurred_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the reported transition actually occurred at the adapter that executed\nit. The journal event minted for this transition carries this clock — the\noriginating agent's — so control events order and measure consistently with\nthe agent-clocked events around them; omitted, the collector's receipt time\nis the fallback."
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Adapter acknowledgement or terminal result for one control command."
+    },
+    "Workflow.WorkflowCursorGapEvent": {
+      "type": "object",
+      "required": [
+        "type",
+        "oldest_available_sequence",
+        "high_water_mark",
+        "timestamp"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "cursor_gap"
+          ]
+        },
+        "oldest_available_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "high_water_mark": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Signals that the requested cursor predates retained workflow history."
+    },
+    "Workflow.WorkflowEdgeKind": {
+      "type": "string",
+      "enum": [
+        "data",
+        "control",
+        "conflict",
+        "resource",
+        "gate",
+        "temporal"
+      ],
+      "description": "Semantic relationship represented by a workflow graph edge."
+    },
+    "Workflow.WorkflowEdgeProvenance": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/Workflow.RecordedWorkflowEdgeProvenance"
+        },
+        {
+          "$ref": "#/$defs/Workflow.DerivedWorkflowEdgeProvenance"
+        }
+      ],
+      "description": "Provenance for one workflow graph edge."
+    },
+    "Workflow.WorkflowEventAppend": {
+      "type": "object",
+      "required": [
+        "event_id",
+        "source_sequence",
+        "timestamp",
+        "kind"
+      ],
+      "properties": {
+        "event_id": {
+          "$ref": "#/$defs/Workflow.WorkflowEventId"
+        },
+        "source_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "kind": {
+          "$ref": "#/$defs/Workflow.WorkflowJournalEventKind"
+        },
+        "thread_id": {
+          "type": "string"
+        },
+        "turn_id": {
+          "type": "string"
+        },
+        "attempt_id": {
+          "$ref": "#/$defs/Workflow.WorkflowAttemptId"
+        },
+        "agent_id": {
+          "$ref": "#/$defs/Workflow.WorkflowAgentId"
+        },
+        "parent_agent_id": {
+          "$ref": "#/$defs/Workflow.WorkflowAgentId"
+        },
+        "receiver_agent_id": {
+          "$ref": "#/$defs/Workflow.WorkflowAgentId"
+        },
+        "tool_call_id": {
+          "$ref": "#/$defs/Workflow.WorkflowToolCallId"
+        },
+        "content_refs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowContentRef"
+          },
+          "maxItems": 64
+        },
+        "data": {
+          "type": "object",
+          "unevaluatedProperties": {}
+        }
+      },
+      "description": "One source-ordered immutable journal event awaiting collector sequence assignment."
+    },
+    "Workflow.WorkflowEventBatchAppendRequest": {
+      "type": "object",
+      "required": [
+        "client_id",
+        "events"
+      ],
+      "properties": {
+        "client_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowEventAppend"
+          },
+          "minItems": 1,
+          "maxItems": 500
+        },
+        "content": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowContentChunk"
+          },
+          "maxItems": 500
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Idempotent append batch from one observer client."
+    },
+    "Workflow.WorkflowEventBatchAppendResponse": {
+      "type": "object",
+      "required": [
+        "accepted_count",
+        "duplicate_count",
+        "acknowledged_source_sequence"
+      ],
+      "properties": {
+        "accepted_count": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0
+        },
+        "duplicate_count": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0
+        },
+        "acknowledged_source_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "first_journal_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "last_journal_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Collector acknowledgement for an idempotent workflow-event append."
+    },
+    "Workflow.WorkflowEventId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "description": "Stable identifier of one immutable journal event."
+    },
+    "Workflow.WorkflowEventPage": {
+      "type": "object",
+      "required": [
+        "events",
+        "next_sequence",
+        "high_water_mark",
+        "cursor_gap"
+      ],
+      "properties": {
+        "events": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowJournalEvent"
+          }
+        },
+        "next_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "high_water_mark": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "cursor_gap": {
+          "type": "boolean"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "A bounded page of workflow journal events."
+    },
+    "Workflow.WorkflowGraphEdge": {
+      "type": "object",
+      "required": [
+        "edge_id",
+        "source_node_id",
+        "target_node_id",
+        "kind",
+        "provenance"
+      ],
+      "properties": {
+        "edge_id": {
+          "type": "string"
+        },
+        "source_node_id": {
+          "$ref": "#/$defs/Workflow.WorkflowNodeId"
+        },
+        "target_node_id": {
+          "$ref": "#/$defs/Workflow.WorkflowNodeId"
+        },
+        "kind": {
+          "$ref": "#/$defs/Workflow.WorkflowEdgeKind"
+        },
+        "provenance": {
+          "$ref": "#/$defs/Workflow.WorkflowEdgeProvenance"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "One typed edge in the deterministic workflow graph projection."
+    },
+    "Workflow.WorkflowGraphNode": {
+      "type": "object",
+      "required": [
+        "node_id",
+        "kind",
+        "label",
+        "status"
+      ],
+      "properties": {
+        "node_id": {
+          "$ref": "#/$defs/Workflow.WorkflowNodeId"
+        },
+        "kind": {
+          "$ref": "#/$defs/Workflow.WorkflowNodeKind"
+        },
+        "label": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "attempt_id": {
+          "$ref": "#/$defs/Workflow.WorkflowAttemptId"
+        },
+        "agent_id": {
+          "$ref": "#/$defs/Workflow.WorkflowAgentId"
+        },
+        "parent_node_id": {
+          "$ref": "#/$defs/Workflow.WorkflowNodeId"
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "ended_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "duration_ms": {
+          "$ref": "#/$defs/Common.DurationMs"
+        },
+        "content_refs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowContentRef"
+          }
+        },
+        "attributes": {
+          "type": "object",
+          "unevaluatedProperties": {}
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "One node in the deterministic workflow graph projection."
+    },
+    "Workflow.WorkflowGraphSnapshot": {
+      "type": "object",
+      "required": [
+        "run",
+        "nodes",
+        "edges",
+        "statistics",
+        "journal_sequence",
+        "has_more_nodes",
+        "has_more_edges",
+        "total_node_count",
+        "total_edge_count"
+      ],
+      "properties": {
+        "run": {
+          "$ref": "#/$defs/Workflow.WorkflowRun"
+        },
+        "nodes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowGraphNode"
+          }
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowGraphEdge"
+          }
+        },
+        "statistics": {
+          "$ref": "#/$defs/Workflow.WorkflowGraphStatistics"
+        },
+        "journal_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "next_node_cursor": {
+          "type": "string"
+        },
+        "next_edge_cursor": {
+          "type": "string"
+        },
+        "has_more_nodes": {
+          "type": "boolean"
+        },
+        "has_more_edges": {
+          "type": "boolean"
+        },
+        "total_node_count": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0
+        },
+        "total_edge_count": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Deterministic graph projection at one journal cursor."
+    },
+    "Workflow.WorkflowGraphStatistics": {
+      "type": "object",
+      "required": [
+        "t1_ms",
+        "t_infinity_ms",
+        "wall_time_ms",
+        "peak_concurrency",
+        "worker_count",
+        "parallel_lower_bound_ms",
+        "critical_path_node_ids"
+      ],
+      "properties": {
+        "t1_ms": {
+          "$ref": "#/$defs/Common.DurationMs"
+        },
+        "t_infinity_ms": {
+          "$ref": "#/$defs/Common.DurationMs"
+        },
+        "wall_time_ms": {
+          "$ref": "#/$defs/Common.DurationMs"
+        },
+        "peak_concurrency": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0
+        },
+        "worker_count": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1
+        },
+        "parallel_lower_bound_ms": {
+          "$ref": "#/$defs/Common.DurationMs"
+        },
+        "critical_path_node_ids": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowNodeId"
+          }
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Work and critical-path statistics for a workflow graph."
+    },
+    "Workflow.WorkflowHeartbeatEvent": {
+      "type": "object",
+      "required": [
+        "type",
+        "high_water_mark",
+        "timestamp"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "heartbeat"
+          ]
+        },
+        "high_water_mark": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Keep-alive emitted while a workflow event stream has no new event."
+    },
+    "Workflow.WorkflowJournalEvent": {
+      "type": "object",
+      "required": [
+        "run_id",
+        "client_id",
+        "journal_sequence"
+      ],
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "client_id": {
+          "type": "string"
+        },
+        "journal_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Workflow.WorkflowEventAppend"
+        }
+      ],
+      "description": "One immutable event after collector journal sequence assignment."
+    },
+    "Workflow.WorkflowJournalEventKind": {
+      "type": "string",
+      "enum": [
+        "run_created",
+        "run_completed",
+        "thread_started",
+        "thread_resumed",
+        "turn_started",
+        "turn_completed",
+        "turn_interrupted",
+        "attempt_started",
+        "attempt_completed",
+        "agent_spawned",
+        "agent_started",
+        "agent_completed",
+        "message_sent",
+        "message_received",
+        "wait_started",
+        "wait_completed",
+        "joined",
+        "item_started",
+        "item_completed",
+        "tool_started",
+        "tool_completed",
+        "approval_requested",
+        "approval_resolved",
+        "content_captured",
+        "file_written",
+        "control_requested",
+        "control_accepted",
+        "control_applied",
+        "control_rejected",
+        "control_failed"
+      ],
+      "description": "Immutable journal event kinds accepted from a Codex observer."
+    },
+    "Workflow.WorkflowNodeId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 192,
+      "description": "Stable identifier of one graph node."
+    },
+    "Workflow.WorkflowNodeKind": {
+      "type": "string",
+      "enum": [
+        "run",
+        "attempt",
+        "turn",
+        "agent",
+        "tool_call",
+        "message",
+        "wait",
+        "gate",
+        "resource"
+      ],
+      "description": "Kinds of execution node in the deterministic workflow graph."
+    },
+    "Workflow.WorkflowRun": {
+      "type": "object",
+      "required": [
+        "run_id",
+        "status",
+        "started_at",
+        "latest_journal_sequence"
+      ],
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "thread_id": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "status": {
+          "$ref": "#/$defs/Workflow.WorkflowRunStatus"
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "ended_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "latest_journal_sequence": {
+          "$ref": "#/$defs/Workflow.WorkflowSequence"
+        },
+        "active_attempt_id": {
+          "$ref": "#/$defs/Workflow.WorkflowAttemptId"
+        },
+        "metadata": {
+          "type": "object",
+          "unevaluatedProperties": {}
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "One immutable workflow run."
+    },
+    "Workflow.WorkflowRunCreateRequest": {
+      "type": "object",
+      "required": [
+        "run_id",
+        "started_at"
+      ],
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Workflow.WorkflowRunId"
+        },
+        "thread_id": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "metadata": {
+          "type": "object",
+          "unevaluatedProperties": {}
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Request to create an observed workflow run before appending journal events."
+    },
+    "Workflow.WorkflowRunId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Stable identifier of one observed Codex workflow run."
+    },
+    "Workflow.WorkflowRunPage": {
+      "type": "object",
+      "required": [
+        "items",
+        "has_more"
+      ],
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Workflow.WorkflowRun"
+          }
+        },
+        "next_cursor": {
+          "type": "string"
+        },
+        "has_more": {
+          "type": "boolean"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Cursor page of workflow runs."
+    },
+    "Workflow.WorkflowRunStatus": {
+      "type": "string",
+      "enum": [
+        "active",
+        "completed",
+        "failed",
+        "interrupted"
+      ],
+      "description": "Current lifecycle of a workflow run."
+    },
+    "Workflow.WorkflowSequence": {
+      "type": "string",
+      "format": "uint64",
+      "description": "Unsigned source or collector journal sequence encoded without JavaScript precision loss.",
+      "pattern": "^(0|[1-9][0-9]*)$",
+      "maxLength": 20
+    },
+    "Workflow.WorkflowStreamEvents": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/Workflow.WorkflowJournalEvent"
+        },
+        {
+          "$ref": "#/$defs/Workflow.WorkflowHeartbeatEvent"
+        },
+        {
+          "$ref": "#/$defs/Workflow.WorkflowCursorGapEvent"
+        }
+      ]
+    },
+    "Workflow.WorkflowToolCallId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Stable identifier of one tool call within a workflow run."
+    },
+    "Workflow.WorkflowToolCallStatus": {
+      "type": "string",
+      "enum": [
+        "requested",
+        "running",
+        "succeeded",
+        "failed",
+        "rejected"
+      ],
+      "description": "Current lifecycle of an observed tool call."
+    },
+    "Operations.LogsApi_list.Response.200": {
+      "type": "object",
+      "required": [
+        "items",
+        "has_more"
+      ],
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/OTel.Logs.LogRecord"
+          },
+          "description": "List of items in this page"
+        },
+        "next_cursor": {
+          "type": "string",
+          "description": "Cursor for the next page (null if no more pages)"
+        },
+        "prev_cursor": {
+          "type": "string",
+          "description": "Cursor for the previous page (null if first page)"
+        },
+        "has_more": {
+          "type": "boolean",
+          "description": "Whether there are more items available"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Cursor-based paginated response wrapper"
+    },
+    "Operations.LogsApi_list.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.LogsApi_list.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
     },
     "Operations.LogsApi_list.Response.500": {
       "$ref": "#/$defs/Common.Errors.InternalServerError"
@@ -7165,6 +8444,213 @@
     "Operations.WorkbenchWorkspacesApi_updatePreferences.Response.503": {
       "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
     },
+    "Operations.WorkflowRunsApi_appendEvents.Request": {
+      "$ref": "#/$defs/Workflow.WorkflowEventBatchAppendRequest"
+    },
+    "Operations.WorkflowRunsApi_appendEvents.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowEventBatchAppendResponse"
+    },
+    "Operations.WorkflowRunsApi_appendEvents.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_appendEvents.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_appendEvents.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_appendEvents.Response.409": {
+      "$ref": "#/$defs/Common.Errors.ConflictError"
+    },
+    "Operations.WorkflowRunsApi_appendEvents.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_appendEvents.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_create.Request": {
+      "$ref": "#/$defs/Workflow.WorkflowRunCreateRequest"
+    },
+    "Operations.WorkflowRunsApi_create.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowRun"
+    },
+    "Operations.WorkflowRunsApi_create.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_create.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_create.Response.409": {
+      "$ref": "#/$defs/Common.Errors.ConflictError"
+    },
+    "Operations.WorkflowRunsApi_create.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_create.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_get.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowRun"
+    },
+    "Operations.WorkflowRunsApi_get.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_get.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_get.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_get.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_getContent.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowContent"
+    },
+    "Operations.WorkflowRunsApi_getContent.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_getContent.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_getContent.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_getContent.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_getGraph.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
+    },
+    "Operations.WorkflowRunsApi_getGraph.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_getGraph.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_getGraph.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_getGraph.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_getGraph.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_list.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowRunPage"
+    },
+    "Operations.WorkflowRunsApi_list.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_list.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_list.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_list.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_pollControls.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowControlCommandPage"
+    },
+    "Operations.WorkflowRunsApi_pollControls.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_pollControls.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_pollControls.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_pollControls.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_pollControls.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_readEvents.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowEventPage"
+    },
+    "Operations.WorkflowRunsApi_readEvents.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_readEvents.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_readEvents.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_readEvents.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_readEvents.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_stream.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_stream.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_stream.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_stream.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_stream.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Request": {
+      "$ref": "#/$defs/Workflow.WorkflowControlRequest"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowControlCommand"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Response.409": {
+      "$ref": "#/$defs/Common.Errors.ConflictError"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_submitControl.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Request": {
+      "$ref": "#/$defs/Workflow.WorkflowControlStatusUpdateRequest"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Response.200": {
+      "$ref": "#/$defs/Workflow.WorkflowControlCommand"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Response.401": {
+      "$ref": "#/$defs/Common.Errors.UnauthorizedError"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Response.409": {
+      "$ref": "#/$defs/Common.Errors.ConflictError"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.WorkflowRunsApi_updateControl.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
     "Operations.health_alive.Response.200": {
       "$ref": "#/$defs/Health.HealthReport"
     },