@ancplua/qyl-api-schema 6.0.0 → 7.0.0

package/generated/ts-runtime/api.d.ts

@@ -34,12 +34,21 @@ export type WorkbenchSuiteId = string & {
 export type WorkbenchEvaluationExportId = string & {
     readonly __brand: "WorkbenchEvaluationExportId";
 };
+export type WorkflowGeneration = string & {
+    readonly __brand: "WorkflowGeneration";
+};
+export type WorkflowJournalPosition = string & {
+    readonly __brand: "WorkflowJournalPosition";
+};
 export type WorkflowRunId = string & {
     readonly __brand: "WorkflowRunId";
 };
 export type WorkflowAttemptId = string & {
     readonly __brand: "WorkflowAttemptId";
 };
+export type WorkflowRunCursor = string & {
+    readonly __brand: "WorkflowRunCursor";
+};
 export type WorkflowContentRef = string & {
     readonly __brand: "WorkflowContentRef";
 };
@@ -55,6 +64,15 @@ export type WorkflowToolCallId = string & {
 export type WorkflowNodeId = string & {
     readonly __brand: "WorkflowNodeId";
 };
+export type WorkflowEdgeId = string & {
+    readonly __brand: "WorkflowEdgeId";
+};
+export type WorkflowNodeCursor = string & {
+    readonly __brand: "WorkflowNodeCursor";
+};
+export type WorkflowEdgeCursor = string & {
+    readonly __brand: "WorkflowEdgeCursor";
+};
 export type WorkflowCommandId = string & {
     readonly __brand: "WorkflowCommandId";
 };
@@ -455,6 +473,18 @@ export declare const WorkflowControlStatusValues: {
     readonly failed: "failed";
 };
 export type WorkflowControlStatus = typeof WorkflowControlStatusValues[keyof typeof WorkflowControlStatusValues];
+export declare const WorkflowCursorKindValues: {
+    readonly node: "node";
+    readonly edge: "edge";
+};
+export type WorkflowCursorKind = typeof WorkflowCursorKindValues[keyof typeof WorkflowCursorKindValues];
+export declare const WorkflowCursorFailureReasonValues: {
+    readonly invalid: "invalid";
+    readonly wrongRun: "wrong_run";
+    readonly wrongGeneration: "wrong_generation";
+    readonly stale: "stale";
+};
+export type WorkflowCursorFailureReason = typeof WorkflowCursorFailureReasonValues[keyof typeof WorkflowCursorFailureReasonValues];
 export declare const WorkflowAttemptStatusValues: {
     readonly pending: "pending";
     readonly running: "running";
@@ -510,6 +540,7 @@ export type WorkbenchEvaluationExportPayload = WorkbenchEvaluationJsonExportPayl
 export type WorkbenchProtocolEvents = WorkbenchProtocolEvent;
 export type WorkbenchExecutionUpdateEvents = WorkbenchExecutionRecord;
 export type WorkflowEdgeProvenance = RecordedWorkflowEdgeProvenance | DerivedWorkflowEdgeProvenance;
+export type WorkflowProjectionStatus = CommittedWorkflowProjectionStatus | RebuildingWorkflowProjectionStatus | UnavailableWorkflowProjectionStatus | CorruptWorkflowProjectionStatus;
 export type WorkflowStreamEvents = WorkflowJournalEvent | WorkflowHeartbeatEvent | WorkflowCursorGapEvent;
 export type LogEvents = LogStreamEvent | HeartbeatEvent;
 export interface AttributeBytesValue {
@@ -1355,14 +1386,36 @@ export interface WorkbenchEvaluationExportArtifact {
 export interface WorkbenchEvaluationExportAccepted {
     "export": WorkbenchEvaluationExport;
 }
+export interface CommittedWorkflowProjectionStatus {
+    "state": "committed";
+    "generation": WorkflowGeneration;
+    "journal_position": WorkflowJournalPosition;
+}
+export interface RebuildingWorkflowProjectionStatus {
+    "state": "rebuilding";
+    "generation": WorkflowGeneration;
+    "target_journal_position": WorkflowJournalPosition;
+    "retry_after_ms": number;
+}
+export interface UnavailableWorkflowProjectionStatus {
+    "state": "unavailable";
+    "generation"?: WorkflowGeneration;
+    "retry_after_ms": number;
+}
+export interface CorruptWorkflowProjectionStatus {
+    "state": "corrupt";
+    "generation"?: WorkflowGeneration;
+    "reason": "corrupt_derived_state" | "incompatible_derived_state";
+}
 export interface WorkflowRun {
     "run_id": WorkflowRunId;
+    "generation": WorkflowGeneration;
     "thread_id"?: string;
     "title"?: string;
     "status": WorkflowRunStatus;
     "started_at": string;
     "ended_at"?: string;
-    "latest_journal_sequence": string;
+    "latest_journal_sequence": WorkflowJournalPosition;
     "active_attempt_id"?: WorkflowAttemptId;
     "metadata"?: Record<string, unknown>;
 }
@@ -1375,7 +1428,7 @@ export interface WorkflowRunCreateRequest {
 }
 export interface WorkflowRunPage {
     "items": WorkflowRun[];
-    "next_cursor"?: string;
+    "next_cursor"?: WorkflowRunCursor;
     "has_more": boolean;
 }
 export interface WorkflowContentChunk {
@@ -1408,18 +1461,18 @@ export interface WorkflowEventBatchAppendResponse {
     "accepted_count": number;
     "duplicate_count": number;
     "acknowledged_source_sequence": string;
-    "first_journal_sequence"?: string;
-    "last_journal_sequence"?: string;
+    "first_journal_sequence"?: WorkflowJournalPosition;
+    "last_journal_sequence"?: WorkflowJournalPosition;
 }
 export interface WorkflowJournalEvent extends WorkflowEventAppend {
     "run_id": WorkflowRunId;
     "client_id": string;
-    "journal_sequence": string;
+    "journal_sequence": WorkflowJournalPosition;
 }
 export interface WorkflowEventPage {
     "events": WorkflowJournalEvent[];
-    "next_sequence": string;
-    "high_water_mark": string;
+    "next_sequence": WorkflowJournalPosition;
+    "high_water_mark": WorkflowJournalPosition;
     "cursor_gap": boolean;
 }
 export interface RecordedWorkflowEdgeProvenance {
@@ -1446,7 +1499,7 @@ export interface WorkflowGraphNode {
     "attributes"?: Record<string, unknown>;
 }
 export interface WorkflowGraphEdge {
-    "edge_id": string;
+    "edge_id": WorkflowEdgeId;
     "source_node_id": WorkflowNodeId;
     "target_node_id": WorkflowNodeId;
     "kind": WorkflowEdgeKind;
@@ -1463,12 +1516,13 @@ export interface WorkflowGraphStatistics {
 }
 export interface WorkflowGraphSnapshot {
     "run": WorkflowRun;
+    "projection_status": WorkflowProjectionStatus;
     "nodes": WorkflowGraphNode[];
     "edges": WorkflowGraphEdge[];
     "statistics": WorkflowGraphStatistics;
-    "journal_sequence": string;
-    "next_node_cursor"?: string;
-    "next_edge_cursor"?: string;
+    "journal_sequence": WorkflowJournalPosition;
+    "next_node_cursor"?: WorkflowNodeCursor;
+    "next_edge_cursor"?: WorkflowEdgeCursor;
     "has_more_nodes": boolean;
     "has_more_edges": boolean;
     "total_node_count": number;
@@ -1509,15 +1563,33 @@ export interface WorkflowControlStatusUpdateRequest {
 }
 export interface WorkflowHeartbeatEvent {
     "type": "heartbeat";
-    "high_water_mark": string;
+    "high_water_mark": WorkflowJournalPosition;
     "timestamp": string;
 }
 export interface WorkflowCursorGapEvent {
     "type": "cursor_gap";
-    "oldest_available_sequence": string;
-    "high_water_mark": string;
+    "oldest_available_sequence": WorkflowJournalPosition;
+    "high_water_mark": WorkflowJournalPosition;
     "timestamp": string;
 }
+export interface WorkflowCursorError extends ProblemDetails {
+    "title": "Invalid Workflow Cursor";
+    "cursor_kind": WorkflowCursorKind;
+    "reason": WorkflowCursorFailureReason;
+    "current_generation"?: WorkflowGeneration;
+}
+export interface WorkflowRunDeletedError extends ProblemDetails {
+    "title": "Workflow Run Deleted";
+    "run_id": WorkflowRunId;
+}
+export interface WorkflowProjectionUnavailableError extends ProblemDetails {
+    "title": "Workflow Projection Unavailable";
+    "projection_status": WorkflowProjectionStatus;
+}
+export interface WorkflowProjectionCorruptError extends ProblemDetails {
+    "title": "Workflow Projection Corrupt";
+    "projection_status": WorkflowProjectionStatus;
+}
 export interface DisplayTracesInput {
     "trace_id"?: TraceId;
     "session_id"?: SessionId;
@@ -1649,20 +1721,20 @@ export interface FetchTelemetryOutput {
 }
 export interface ListWorkflowRunsInput {
     "status"?: WorkflowRunStatus;
-    "cursor"?: string;
+    "cursor"?: WorkflowRunCursor;
     "limit"?: number;
 }
 export interface ListWorkflowRunsOutput {
     "runs": WorkflowRun[];
-    "next_cursor"?: string;
+    "next_cursor"?: WorkflowRunCursor;
     "has_more": boolean;
     "mode": McpDataMode;
 }
 export interface GetWorkflowGraphInput {
     "run_id": WorkflowRunId;
-    "node_cursor"?: string;
+    "node_cursor"?: WorkflowNodeCursor;
     "node_limit"?: number;
-    "edge_cursor"?: string;
+    "edge_cursor"?: WorkflowEdgeCursor;
     "edge_limit"?: number;
 }
 export interface GetWorkflowGraphOutput {
@@ -1671,9 +1743,9 @@ export interface GetWorkflowGraphOutput {
 }
 export interface DisplayWorkflowGraphInput {
     "run_id"?: WorkflowRunId;
-    "node_cursor"?: string;
+    "node_cursor"?: WorkflowNodeCursor;
     "node_limit"?: number;
-    "edge_cursor"?: string;
+    "edge_cursor"?: WorkflowEdgeCursor;
     "edge_limit"?: number;
 }
 export interface DisplayWorkflowGraphOutput {
@@ -1683,12 +1755,12 @@ export interface DisplayWorkflowGraphOutput {
 }
 export interface FetchWorkflowGraphUpdatesInput {
     "run_id": WorkflowRunId;
-    "after_sequence": string;
+    "after_sequence": WorkflowJournalPosition;
     "limit"?: number;
     "wait_ms"?: number;
-    "node_cursor"?: string;
+    "node_cursor"?: WorkflowNodeCursor;
     "node_limit"?: number;
-    "edge_cursor"?: string;
+    "edge_cursor"?: WorkflowEdgeCursor;
     "edge_limit"?: number;
     "content_ref"?: WorkflowContentRef;
 }

package/generated/ts-runtime/api.js

@@ -353,6 +353,16 @@ export const WorkflowControlStatusValues = {
     "rejected": "rejected",
     "failed": "failed",
 };
+export const WorkflowCursorKindValues = {
+    "node": "node",
+    "edge": "edge",
+};
+export const WorkflowCursorFailureReasonValues = {
+    "invalid": "invalid",
+    "wrongRun": "wrong_run",
+    "wrongGeneration": "wrong_generation",
+    "stale": "stale",
+};
 export const WorkflowAttemptStatusValues = {
     "pending": "pending",
     "running": "running",
@@ -392,4 +402,4 @@ export const FetchTelemetryViewValues = {
 };
 // --- contract revision (scripts/emit-contract-revision.mjs) ---
 /** Revision of the API contract these types were emitted from; compare against HealthReport.contract_revision. */
-export const CONTRACT_REVISION = "sha256:f32216c3a3172ab0";
+export const CONTRACT_REVISION = "sha256:53278018c62ed547";

package/models/mcp-tools.tsp

@@ -222,7 +222,7 @@ model FetchTelemetryOutput {
 model ListWorkflowRunsInput {
   status?: WorkflowRunStatus;
 
-  cursor?: string;
+  cursor?: WorkflowRunCursor;
 
   @minValue(1)
   @maxValue(100)
@@ -234,7 +234,7 @@ model ListWorkflowRunsOutput {
   runs: WorkflowRun[];
 
   @encodedName("application/json", "next_cursor")
-  nextCursor?: string;
+  nextCursor?: WorkflowRunCursor;
 
   @encodedName("application/json", "has_more")
   hasMore: boolean;
@@ -247,16 +247,18 @@ model GetWorkflowGraphInput {
   @encodedName("application/json", "run_id")
   runId: WorkflowRunId;
 
+  @doc("Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it.")
   @encodedName("application/json", "node_cursor")
-  nodeCursor?: string;
+  nodeCursor?: WorkflowNodeCursor;
 
   @encodedName("application/json", "node_limit")
   @minValue(1)
   @maxValue(1000)
   nodeLimit?: int32 = 250;
 
+  @doc("Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it.")
   @encodedName("application/json", "edge_cursor")
-  edgeCursor?: string;
+  edgeCursor?: WorkflowEdgeCursor;
 
   @encodedName("application/json", "edge_limit")
   @minValue(1)
@@ -275,16 +277,18 @@ model DisplayWorkflowGraphInput {
   @encodedName("application/json", "run_id")
   runId?: WorkflowRunId;
 
+  @doc("Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it.")
   @encodedName("application/json", "node_cursor")
-  nodeCursor?: string;
+  nodeCursor?: WorkflowNodeCursor;
 
   @encodedName("application/json", "node_limit")
   @minValue(1)
   @maxValue(1000)
   nodeLimit?: int32 = 250;
 
+  @doc("Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it.")
   @encodedName("application/json", "edge_cursor")
-  edgeCursor?: string;
+  edgeCursor?: WorkflowEdgeCursor;
 
   @encodedName("application/json", "edge_limit")
   @minValue(1)
@@ -308,7 +312,7 @@ model FetchWorkflowGraphUpdatesInput {
   runId: WorkflowRunId;
 
   @encodedName("application/json", "after_sequence")
-  afterSequence: WorkflowSequence;
+  afterSequence: WorkflowJournalPosition;
 
   @minValue(1)
   @maxValue(1000)
@@ -319,16 +323,18 @@ model FetchWorkflowGraphUpdatesInput {
   @maxValue(30000)
   waitMs?: int32 = 20000;
 
+  @doc("Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it.")
   @encodedName("application/json", "node_cursor")
-  nodeCursor?: string;
+  nodeCursor?: WorkflowNodeCursor;
 
   @encodedName("application/json", "node_limit")
   @minValue(1)
   @maxValue(1000)
   nodeLimit?: int32 = 250;
 
+  @doc("Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it.")
   @encodedName("application/json", "edge_cursor")
-  edgeCursor?: string;
+  edgeCursor?: WorkflowEdgeCursor;
 
   @encodedName("application/json", "edge_limit")
   @minValue(1)

package/models/workflow.tsp

@@ -9,6 +9,17 @@ namespace Qyl.Api.Contracts.Workflow;
 @maxLength(128)
 scalar WorkflowRunId extends string;
 
+@doc("Opaque incarnation identifier for one workflow run's projected state.")
+@pattern("^[0-9a-f]{12}4[0-9a-f]{3}[89ab][0-9a-f]{15}$")
+@minLength(32)
+@maxLength(32)
+scalar WorkflowGeneration extends string;
+
+@doc("Opaque workflow-run list continuation scoped to the project and status filter. Reuse it unchanged; clients must not parse or construct it.")
+@minLength(1)
+@maxLength(512)
+scalar WorkflowRunCursor extends string;
+
 @doc("Stable identifier of one workflow attempt.")
 @minLength(1)
 @maxLength(128)
@@ -34,11 +45,26 @@ scalar WorkflowEventId extends string;
 @maxLength(128)
 scalar WorkflowCommandId extends string;
 
-@doc("Stable identifier of one graph node.")
+@doc("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.")
 @minLength(1)
 @maxLength(192)
 scalar WorkflowNodeId extends string;
 
+@doc("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.")
+@minLength(1)
+@maxLength(192)
+scalar WorkflowEdgeId extends string;
+
+@doc("Opaque node-page continuation scoped to one workflow run and generation. Reuse it unchanged; clients must not parse or construct it.")
+@minLength(1)
+@maxLength(1536)
+scalar WorkflowNodeCursor extends string;
+
+@doc("Opaque edge-page continuation scoped to one workflow run and generation. Reuse it unchanged; clients must not parse or construct it.")
+@minLength(1)
+@maxLength(1536)
+scalar WorkflowEdgeCursor extends string;
+
 @doc("Content-addressed reference to a captured workflow payload.")
 @pattern("^sha256:[a-f0-9]{64}$")
 @minLength(71)
@@ -50,6 +76,11 @@ scalar WorkflowContentRef extends string;
 @encode(string)
 scalar WorkflowSequence extends uint64;
 
+@doc("Collector-assigned position in the authoritative workflow journal, encoded without JavaScript precision loss.")
+@minValue(0)
+@encode(string)
+scalar WorkflowJournalPosition extends uint64;
+
 @doc("Current lifecycle of a workflow run.")
 enum WorkflowRunStatus {
   active: "active",
@@ -165,11 +196,60 @@ enum WorkflowContentEncoding {
   base64: "base64",
 }
 
+@doc("A valid committed projection that can be served to readers.")
+model CommittedWorkflowProjectionStatus {
+  state: "committed";
+  generation: WorkflowGeneration;
+
+  @encodedName("application/json", "journal_position")
+  journalPosition: WorkflowJournalPosition;
+}
+
+@doc("The requested generation is being reconstructed from its authoritative journal.")
+model RebuildingWorkflowProjectionStatus {
+  state: "rebuilding";
+  generation: WorkflowGeneration;
+
+  @encodedName("application/json", "target_journal_position")
+  targetJournalPosition: WorkflowJournalPosition;
+
+  @encodedName("application/json", "retry_after_ms")
+  @minValue(1)
+  retryAfterMs: int32;
+}
+
+@doc("Projection work is temporarily unavailable after a retryable storage failure.")
+model UnavailableWorkflowProjectionStatus {
+  state: "unavailable";
+  generation?: WorkflowGeneration;
+
+  @encodedName("application/json", "retry_after_ms")
+  @minValue(1)
+  retryAfterMs: int32;
+}
+
+@doc("Derived projection state is corrupt or incompatible and cannot currently be served.")
+model CorruptWorkflowProjectionStatus {
+  state: "corrupt";
+  generation?: WorkflowGeneration;
+  reason: "corrupt_derived_state" | "incompatible_derived_state";
+}
+
+@doc("Closed public availability state for one workflow projection. Storage paths, hashes, fingerprints, and database errors remain private.")
+union WorkflowProjectionStatus {
+  committed: CommittedWorkflowProjectionStatus,
+  rebuilding: RebuildingWorkflowProjectionStatus,
+  unavailable: UnavailableWorkflowProjectionStatus,
+  corrupt: CorruptWorkflowProjectionStatus,
+}
+
 @doc("One immutable workflow run.")
 model WorkflowRun {
   @encodedName("application/json", "run_id")
   runId: WorkflowRunId;
 
+  generation: WorkflowGeneration;
+
   @encodedName("application/json", "thread_id")
   threadId?: string;
 
@@ -183,7 +263,7 @@ model WorkflowRun {
   endedAt?: utcDateTime;
 
   @encodedName("application/json", "latest_journal_sequence")
-  latestJournalSequence: WorkflowSequence;
+  latestJournalSequence: WorkflowJournalPosition;
 
   @encodedName("application/json", "active_attempt_id")
   activeAttemptId?: WorkflowAttemptId;
@@ -212,7 +292,7 @@ model WorkflowRunPage {
   items: WorkflowRun[];
 
   @encodedName("application/json", "next_cursor")
-  nextCursor?: string;
+  nextCursor?: WorkflowRunCursor;
 
   @encodedName("application/json", "has_more")
   hasMore: boolean;
@@ -301,10 +381,10 @@ model WorkflowEventBatchAppendResponse {
   acknowledgedSourceSequence: WorkflowSequence;
 
   @encodedName("application/json", "first_journal_sequence")
-  firstJournalSequence?: WorkflowSequence;
+  firstJournalSequence?: WorkflowJournalPosition;
 
   @encodedName("application/json", "last_journal_sequence")
-  lastJournalSequence?: WorkflowSequence;
+  lastJournalSequence?: WorkflowJournalPosition;
 }
 
 @doc("One immutable event after collector journal sequence assignment.")
@@ -316,7 +396,7 @@ model WorkflowJournalEvent extends WorkflowEventAppend {
   clientId: string;
 
   @encodedName("application/json", "journal_sequence")
-  journalSequence: WorkflowSequence;
+  journalSequence: WorkflowJournalPosition;
 }
 
 @doc("A bounded page of workflow journal events.")
@@ -324,10 +404,10 @@ model WorkflowEventPage {
   events: WorkflowJournalEvent[];
 
   @encodedName("application/json", "next_sequence")
-  nextSequence: WorkflowSequence;
+  nextSequence: WorkflowJournalPosition;
 
   @encodedName("application/json", "high_water_mark")
-  highWaterMark: WorkflowSequence;
+  highWaterMark: WorkflowJournalPosition;
 
   @encodedName("application/json", "cursor_gap")
   cursorGap: boolean;
@@ -390,10 +470,10 @@ model WorkflowGraphNode {
   attributes?: Record<unknown>;
 }
 
-@doc("One typed edge in the deterministic workflow graph projection.")
+@doc("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.")
 model WorkflowGraphEdge {
   @encodedName("application/json", "edge_id")
-  edgeId: string;
+  edgeId: WorkflowEdgeId;
 
   @encodedName("application/json", "source_node_id")
   sourceNodeId: WorkflowNodeId;
@@ -405,7 +485,7 @@ model WorkflowGraphEdge {
   provenance: WorkflowEdgeProvenance;
 }
 
-@doc("Work and critical-path statistics for a workflow graph.")
+@doc("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.")
 model WorkflowGraphStatistics {
   @encodedName("application/json", "t1_ms")
   t1Ms: DurationMs;
@@ -434,18 +514,23 @@ model WorkflowGraphStatistics {
 @doc("Deterministic graph projection at one journal cursor.")
 model WorkflowGraphSnapshot {
   run: WorkflowRun;
+
+  @encodedName("application/json", "projection_status")
+  projectionStatus: WorkflowProjectionStatus;
   nodes: WorkflowGraphNode[];
   edges: WorkflowGraphEdge[];
   statistics: WorkflowGraphStatistics;
 
   @encodedName("application/json", "journal_sequence")
-  journalSequence: WorkflowSequence;
+  journalSequence: WorkflowJournalPosition;
 
   @encodedName("application/json", "next_node_cursor")
-  nextNodeCursor?: string;
+  @doc("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.")
+  nextNodeCursor?: WorkflowNodeCursor;
 
   @encodedName("application/json", "next_edge_cursor")
-  nextEdgeCursor?: string;
+  @doc("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.")
+  nextEdgeCursor?: WorkflowEdgeCursor;
 
   @encodedName("application/json", "has_more_nodes")
   hasMoreNodes: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "6.0.0",
+  "version": "7.0.0",
   "description": "TypeSpec source of truth for qyl API contracts. Emits OpenAPI, JSON Schema, Qyl.Api.Contracts DTOs, and TypeScript contract types; not an OpenTelemetry package, storage schema, or server implementation.",
   "license": "Apache-2.0",
   "repository": {