@ancplua/qyl-api-schema 5.1.0 → 7.0.0

package/generated/openapi/qyl.openapi.json

@@ -1687,6 +1687,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -1799,8 +1825,9 @@
             "name": "cursor",
             "in": "query",
             "required": false,
+            "description": "Opaque continuation scoped to the project and status filter. Reuse it unchanged from next_cursor; do not parse, construct, or modify it.",
             "schema": {
-              "type": "string"
+              "$ref": "#/components/schemas/Workflow.WorkflowRunCursor"
             },
             "explode": false
           }
@@ -2032,6 +2059,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -2241,6 +2294,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -2467,6 +2546,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -2684,6 +2789,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -2859,6 +2990,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -3068,6 +3225,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -3167,7 +3350,7 @@
             "in": "query",
             "required": false,
             "schema": {
-              "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+              "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
             },
             "explode": false
           },
@@ -3294,6 +3477,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -3384,8 +3593,9 @@
             "name": "node_cursor",
             "in": "query",
             "required": false,
+            "description": "Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it.",
             "schema": {
-              "type": "string"
+              "$ref": "#/components/schemas/Workflow.WorkflowNodeCursor"
             },
             "explode": false
           },
@@ -3406,8 +3616,9 @@
             "name": "edge_cursor",
             "in": "query",
             "required": false,
+            "description": "Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it.",
             "schema": {
-              "type": "string"
+              "$ref": "#/components/schemas/Workflow.WorkflowEdgeCursor"
             },
             "explode": false
           },
@@ -3521,8 +3732,60 @@
               }
             }
           },
+          "409": {
+            "description": "Opaque graph cursor is malformed, belongs to another run, or targets a stale generation.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowCursorError"
+                }
+              }
+            }
+          },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
-            "description": "Internal server error (500)",
+            "description": "Workflow projection is non-retryably corrupt or incompatible. Internal storage details are intentionally omitted.",
             "headers": {
               "X-Trace-Id": {
                 "required": false,
@@ -3542,17 +3805,16 @@
             "content": {
               "application/problem+json": {
                 "schema": {
-                  "$ref": "#/components/schemas/Common.Errors.InternalServerError"
+                  "$ref": "#/components/schemas/Workflow.WorkflowProjectionCorruptError"
                 }
               }
             }
           },
           "503": {
-            "description": "Service unavailable (503)",
+            "description": "Workflow projection is rebuilding or temporarily unavailable after a retryable storage failure.",
             "headers": {
               "Retry-After": {
-                "required": false,
-                "description": "Expected availability time",
+                "required": true,
                 "schema": {
                   "type": "integer",
                   "format": "int32"
@@ -3576,7 +3838,7 @@
             "content": {
               "application/problem+json": {
                 "schema": {
-                  "$ref": "#/components/schemas/Common.Errors.ServiceUnavailableError"
+                  "$ref": "#/components/schemas/Workflow.WorkflowProjectionUnavailableError"
                 }
               }
             }
@@ -3764,6 +4026,32 @@
               }
             }
           },
+          "410": {
+            "description": "Workflow run was durably deleted and can no longer accept events or publish projections.",
+            "headers": {
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "$ref": "#/components/schemas/Common.TraceId"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Workflow.WorkflowRunDeletedError"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error (500)",
             "headers": {
@@ -16276,7 +16564,8 @@
             "$ref": "#/components/schemas/Workflow.WorkflowRunId"
           },
           "node_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowNodeCursor",
+            "description": "Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it."
           },
           "node_limit": {
             "type": "integer",
@@ -16286,7 +16575,8 @@
             "default": 250
           },
           "edge_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowEdgeCursor",
+            "description": "Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it."
           },
           "edge_limit": {
             "type": "integer",
@@ -16420,7 +16710,7 @@
             "$ref": "#/components/schemas/Workflow.WorkflowRunId"
           },
           "after_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "limit": {
             "type": "integer",
@@ -16437,7 +16727,8 @@
             "default": 20000
           },
           "node_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowNodeCursor",
+            "description": "Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it."
           },
           "node_limit": {
             "type": "integer",
@@ -16447,7 +16738,8 @@
             "default": 250
           },
           "edge_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowEdgeCursor",
+            "description": "Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it."
           },
           "edge_limit": {
             "type": "integer",
@@ -16535,7 +16827,8 @@
             "$ref": "#/components/schemas/Workflow.WorkflowRunId"
           },
           "node_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowNodeCursor",
+            "description": "Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it."
           },
           "node_limit": {
             "type": "integer",
@@ -16545,7 +16838,8 @@
             "default": 250
           },
           "edge_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowEdgeCursor",
+            "description": "Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it."
           },
           "edge_limit": {
             "type": "integer",
@@ -16665,7 +16959,7 @@
             "$ref": "#/components/schemas/Workflow.WorkflowRunStatus"
           },
           "cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowRunCursor"
           },
           "limit": {
             "type": "integer",
@@ -16695,7 +16989,7 @@
             }
           },
           "next_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowRunCursor"
           },
           "has_more": {
             "type": "boolean"
@@ -20743,6 +21037,61 @@
         },
         "description": "Request to update mutable MCP workbench workspace metadata."
       },
+      "Workflow.CommittedWorkflowProjectionStatus": {
+        "type": "object",
+        "required": [
+          "state",
+          "generation",
+          "journal_position"
+        ],
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "committed"
+            ]
+          },
+          "generation": {
+            "$ref": "#/components/schemas/Workflow.WorkflowGeneration"
+          },
+          "journal_position": {
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "A valid committed projection that can be served to readers."
+      },
+      "Workflow.CorruptWorkflowProjectionStatus": {
+        "type": "object",
+        "required": [
+          "state",
+          "reason"
+        ],
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "corrupt"
+            ]
+          },
+          "generation": {
+            "$ref": "#/components/schemas/Workflow.WorkflowGeneration"
+          },
+          "reason": {
+            "type": "string",
+            "enum": [
+              "corrupt_derived_state",
+              "incompatible_derived_state"
+            ]
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "Derived projection state is corrupt or incompatible and cannot currently be served."
+      },
       "Workflow.DerivedWorkflowEdgeProvenance": {
         "type": "object",
         "required": [
@@ -20777,6 +21126,38 @@
         },
         "description": "Derived edge provenance with explicit evidence and confidence."
       },
+      "Workflow.RebuildingWorkflowProjectionStatus": {
+        "type": "object",
+        "required": [
+          "state",
+          "generation",
+          "target_journal_position",
+          "retry_after_ms"
+        ],
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "rebuilding"
+            ]
+          },
+          "generation": {
+            "$ref": "#/components/schemas/Workflow.WorkflowGeneration"
+          },
+          "target_journal_position": {
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
+          },
+          "retry_after_ms": {
+            "type": "integer",
+            "format": "int32",
+            "minimum": 1
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "The requested generation is being reconstructed from its authoritative journal."
+      },
       "Workflow.RecordedWorkflowEdgeProvenance": {
         "type": "object",
         "required": [
@@ -20803,6 +21184,33 @@
         },
         "description": "Recorded edge provenance directly observed from Codex."
       },
+      "Workflow.UnavailableWorkflowProjectionStatus": {
+        "type": "object",
+        "required": [
+          "state",
+          "retry_after_ms"
+        ],
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "unavailable"
+            ]
+          },
+          "generation": {
+            "$ref": "#/components/schemas/Workflow.WorkflowGeneration"
+          },
+          "retry_after_ms": {
+            "type": "integer",
+            "format": "int32",
+            "minimum": 1
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "Projection work is temporarily unavailable after a retryable storage failure."
+      },
       "Workflow.WorkflowAgentId": {
         "type": "string",
         "minLength": 1,
@@ -21061,6 +21469,50 @@
         },
         "description": "Adapter acknowledgement or terminal result for one control command."
       },
+      "Workflow.WorkflowCursorError": {
+        "type": "object",
+        "required": [
+          "title",
+          "cursor_kind",
+          "reason"
+        ],
+        "properties": {
+          "title": {
+            "type": "string",
+            "enum": [
+              "Invalid Workflow Cursor"
+            ]
+          },
+          "cursor_kind": {
+            "$ref": "#/components/schemas/Workflow.WorkflowCursorKind"
+          },
+          "reason": {
+            "$ref": "#/components/schemas/Workflow.WorkflowCursorFailureReason"
+          },
+          "current_generation": {
+            "$ref": "#/components/schemas/Workflow.WorkflowGeneration"
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/Common.Errors.ProblemDetails"
+          }
+        ],
+        "description": "Opaque graph cursor is malformed, belongs to another run, or targets a stale generation."
+      },
+      "Workflow.WorkflowCursorFailureReason": {
+        "type": "string",
+        "enum": [
+          "invalid",
+          "wrong_run",
+          "wrong_generation",
+          "stale"
+        ],
+        "description": "Why an opaque graph cursor cannot be reused for this request."
+      },
       "Workflow.WorkflowCursorGapEvent": {
         "type": "object",
         "required": [
@@ -21077,10 +21529,10 @@
             ]
           },
           "oldest_available_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "high_water_mark": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "timestamp": {
             "type": "string",
@@ -21092,6 +21544,26 @@
         },
         "description": "Signals that the requested cursor predates retained workflow history."
       },
+      "Workflow.WorkflowCursorKind": {
+        "type": "string",
+        "enum": [
+          "node",
+          "edge"
+        ],
+        "description": "Which opaque graph cursor was rejected."
+      },
+      "Workflow.WorkflowEdgeCursor": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 1536,
+        "description": "Opaque edge-page continuation scoped to one workflow run and generation. Reuse it unchanged; clients must not parse or construct it."
+      },
+      "Workflow.WorkflowEdgeId": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 192,
+        "description": "Stable identifier of one graph edge. Endpoint tuples preserve the nodes' structural run-versus-attempt scope and ordinal component boundaries, escape colon as \\c and backslash as \\\\, and never infer scope from a literal component value. A canonical identifier over 192 Unicode scalar values is replaced by its edge kind, a tilde, and the full lowercase 64-hex SHA-256 of the length-prefixed canonical tuple."
+      },
       "Workflow.WorkflowEdgeKind": {
         "type": "string",
         "enum": [
@@ -21227,10 +21699,10 @@
             "$ref": "#/components/schemas/Workflow.WorkflowSequence"
           },
           "first_journal_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "last_journal_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           }
         },
         "unevaluatedProperties": {
@@ -21260,10 +21732,10 @@
             }
           },
           "next_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "high_water_mark": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "cursor_gap": {
             "type": "boolean"
@@ -21274,6 +21746,13 @@
         },
         "description": "A bounded page of workflow journal events."
       },
+      "Workflow.WorkflowGeneration": {
+        "type": "string",
+        "minLength": 32,
+        "maxLength": 32,
+        "pattern": "^[0-9a-f]{12}4[0-9a-f]{3}[89ab][0-9a-f]{15}$",
+        "description": "Opaque incarnation identifier for one workflow run's projected state."
+      },
       "Workflow.WorkflowGraphEdge": {
         "type": "object",
         "required": [
@@ -21285,7 +21764,7 @@
         ],
         "properties": {
           "edge_id": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowEdgeId"
           },
           "source_node_id": {
             "$ref": "#/components/schemas/Workflow.WorkflowNodeId"
@@ -21303,7 +21782,7 @@
         "unevaluatedProperties": {
           "not": {}
         },
-        "description": "One typed edge in the deterministic workflow graph projection."
+        "description": "One typed edge in the deterministic workflow graph projection. Data, Control, and Gate edges are causal dependencies. Temporal edges describe observed order, Resource edges describe resource use, and Conflict edges describe contention; Temporal, Resource, and Conflict edges are excluded from critical-path causality."
       },
       "Workflow.WorkflowGraphNode": {
         "type": "object",
@@ -21332,9 +21811,6 @@
           "agent_id": {
             "$ref": "#/components/schemas/Workflow.WorkflowAgentId"
           },
-          "parent_node_id": {
-            "$ref": "#/components/schemas/Workflow.WorkflowNodeId"
-          },
           "started_at": {
             "type": "string",
             "format": "date-time"
@@ -21366,6 +21842,7 @@
         "type": "object",
         "required": [
           "run",
+          "projection_status",
           "nodes",
           "edges",
           "statistics",
@@ -21379,6 +21856,9 @@
           "run": {
             "$ref": "#/components/schemas/Workflow.WorkflowRun"
           },
+          "projection_status": {
+            "$ref": "#/components/schemas/Workflow.WorkflowProjectionStatus"
+          },
           "nodes": {
             "type": "array",
             "items": {
@@ -21395,13 +21875,15 @@
             "$ref": "#/components/schemas/Workflow.WorkflowGraphStatistics"
           },
           "journal_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "next_node_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowNodeCursor",
+            "description": "Opaque node continuation for the next page. Reuse it unchanged as node_cursor on the next graph request; do not parse, construct, or modify it."
           },
           "next_edge_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowEdgeCursor",
+            "description": "Opaque edge continuation for the next page. Reuse it unchanged as edge_cursor on the next graph request; do not parse, construct, or modify it."
           },
           "has_more_nodes": {
             "type": "boolean"
@@ -21469,7 +21951,7 @@
         "unevaluatedProperties": {
           "not": {}
         },
-        "description": "Work and critical-path statistics for a workflow graph."
+        "description": "Work and critical-path statistics for a workflow graph. Every ToolCall, Wait, Gate, and duration-bearing Message or Item contributes an independently weighted interval even when it has no Agent owner. An Agent contributes its own-work fragments: its interval minus the union of precisely owned child intervals clipped to the Agent interval. Precisely owned children are Control-linked Agent and ToolCall nodes, Temporal-linked Wait nodes, Gate-linked Gate nodes, and Data-linked duration-bearing Message or Item nodes. Peak concurrency sweeps every positive independently weighted or Agent own-work fragment. Critical-path analysis uses only Data, Control, and Gate edges, condenses each causal strongly connected component, charges every component member exactly once, and expands selected component members in ordinal node-id order."
       },
       "Workflow.WorkflowHeartbeatEvent": {
         "type": "object",
@@ -21486,7 +21968,7 @@
             ]
           },
           "high_water_mark": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "timestamp": {
             "type": "string",
@@ -21513,7 +21995,7 @@
             "type": "string"
           },
           "journal_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           }
         },
         "unevaluatedProperties": {
@@ -21562,11 +22044,23 @@
         ],
         "description": "Immutable journal event kinds accepted from a Codex observer."
       },
+      "Workflow.WorkflowJournalPosition": {
+        "type": "string",
+        "format": "uint64",
+        "minimum": 0,
+        "description": "Collector-assigned position in the authoritative workflow journal, encoded without JavaScript precision loss."
+      },
+      "Workflow.WorkflowNodeCursor": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 1536,
+        "description": "Opaque node-page continuation scoped to one workflow run and generation. Reuse it unchanged; clients must not parse or construct it."
+      },
       "Workflow.WorkflowNodeId": {
         "type": "string",
         "minLength": 1,
         "maxLength": 192,
-        "description": "Stable identifier of one graph node."
+        "description": "Stable identifier of one graph node. Canonical tuples structurally distinguish run scope from attempt scope, escape colon as \\c and backslash as \\\\, and never infer scope from a literal component value. A canonical identifier over 192 Unicode scalar values is replaced by its kind, a tilde, and the full lowercase 64-hex SHA-256 of the length-prefixed canonical tuple."
       },
       "Workflow.WorkflowNodeKind": {
         "type": "string",
@@ -21583,10 +22077,82 @@
         ],
         "description": "Kinds of execution node in the deterministic workflow graph."
       },
+      "Workflow.WorkflowProjectionCorruptError": {
+        "type": "object",
+        "required": [
+          "title",
+          "projection_status"
+        ],
+        "properties": {
+          "title": {
+            "type": "string",
+            "enum": [
+              "Workflow Projection Corrupt"
+            ]
+          },
+          "projection_status": {
+            "$ref": "#/components/schemas/Workflow.WorkflowProjectionStatus"
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/Common.Errors.ProblemDetails"
+          }
+        ],
+        "description": "Workflow projection is non-retryably corrupt or incompatible. Internal storage details are intentionally omitted."
+      },
+      "Workflow.WorkflowProjectionStatus": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/Workflow.CommittedWorkflowProjectionStatus"
+          },
+          {
+            "$ref": "#/components/schemas/Workflow.RebuildingWorkflowProjectionStatus"
+          },
+          {
+            "$ref": "#/components/schemas/Workflow.UnavailableWorkflowProjectionStatus"
+          },
+          {
+            "$ref": "#/components/schemas/Workflow.CorruptWorkflowProjectionStatus"
+          }
+        ],
+        "description": "Closed public availability state for one workflow projection. Storage paths, hashes, fingerprints, and database errors remain private."
+      },
+      "Workflow.WorkflowProjectionUnavailableError": {
+        "type": "object",
+        "required": [
+          "title",
+          "projection_status"
+        ],
+        "properties": {
+          "title": {
+            "type": "string",
+            "enum": [
+              "Workflow Projection Unavailable"
+            ]
+          },
+          "projection_status": {
+            "$ref": "#/components/schemas/Workflow.WorkflowProjectionStatus"
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/Common.Errors.ProblemDetails"
+          }
+        ],
+        "description": "Workflow projection is rebuilding or temporarily unavailable after a retryable storage failure."
+      },
       "Workflow.WorkflowRun": {
         "type": "object",
         "required": [
           "run_id",
+          "generation",
           "status",
           "started_at",
           "latest_journal_sequence"
@@ -21595,6 +22161,9 @@
           "run_id": {
             "$ref": "#/components/schemas/Workflow.WorkflowRunId"
           },
+          "generation": {
+            "$ref": "#/components/schemas/Workflow.WorkflowGeneration"
+          },
           "thread_id": {
             "type": "string"
           },
@@ -21613,7 +22182,7 @@
             "format": "date-time"
           },
           "latest_journal_sequence": {
-            "$ref": "#/components/schemas/Workflow.WorkflowSequence"
+            "$ref": "#/components/schemas/Workflow.WorkflowJournalPosition"
           },
           "active_attempt_id": {
             "$ref": "#/components/schemas/Workflow.WorkflowAttemptId"
@@ -21658,6 +22227,39 @@
         },
         "description": "Request to create an observed workflow run before appending journal events."
       },
+      "Workflow.WorkflowRunCursor": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 512,
+        "description": "Opaque workflow-run list continuation scoped to the project and status filter. Reuse it unchanged; clients must not parse or construct it."
+      },
+      "Workflow.WorkflowRunDeletedError": {
+        "type": "object",
+        "required": [
+          "title",
+          "run_id"
+        ],
+        "properties": {
+          "title": {
+            "type": "string",
+            "enum": [
+              "Workflow Run Deleted"
+            ]
+          },
+          "run_id": {
+            "$ref": "#/components/schemas/Workflow.WorkflowRunId"
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/Common.Errors.ProblemDetails"
+          }
+        ],
+        "description": "Workflow run was durably deleted and can no longer accept events or publish projections."
+      },
       "Workflow.WorkflowRunId": {
         "type": "string",
         "minLength": 1,
@@ -21678,7 +22280,7 @@
             }
           },
           "next_cursor": {
-            "type": "string"
+            "$ref": "#/components/schemas/Workflow.WorkflowRunCursor"
           },
           "has_more": {
             "type": "boolean"