@ancplua/qyl-api-schema 0.5.6 → 0.5.8

package/api/routes.tsp

@@ -46,6 +46,7 @@ interface TracesApi {
   list(
     ...ProjectScopeHeader,
     @query @minValue(1) @maxValue(1000) limit?: int32 = 100,
+    @query cursor?: string,
   ): CursorPage<Trace> | ValidationError | UnauthorizedError | InternalServerError;
 
   @get

package/api/runner.tsp

@@ -44,6 +44,7 @@ namespace Qyl.Api.Contracts.Runner {
     @route("/{resource}/logs/stream")
     streamLogs(
       @path resource: string,
+      @header("Last-Event-ID") lastEventId?: string,
     ): SSEStream<RunnerLogEvents> | ForbiddenError | NotFoundError | ServiceUnavailableError | InternalServerError;
 
     @post

package/api/streaming.tsp

@@ -42,8 +42,9 @@ interface StreamingApi {
   @useAuth(Qyl.Api.Contracts.QylApiKeyHeaderAuth)
   streamLogs(
     ...Qyl.Api.Contracts.ProjectScopeHeader,
+    @header("Last-Event-ID") lastEventId?: string,
     @query serviceName?: string,
     @query @minValue(1) @maxValue(24) minSeverity?: int32,
     @query query?: string,
-  ): SSEStream<LogEvents> | ValidationError | UnauthorizedError | InternalServerError;
+  ): SSEStream<LogEvents> | ValidationError | UnauthorizedError | ServiceUnavailableError | InternalServerError;
 }

package/generated/openapi/qyl.openapi.json

@@ -1464,6 +1464,14 @@
           {
             "$ref": "#/components/parameters/ProjectScopeHeader"
           },
+          {
+            "name": "Last-Event-ID",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "serviceName",
             "in": "query",
@@ -1629,6 +1637,40 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable (503)",
+            "headers": {
+              "Retry-After": {
+                "required": false,
+                "description": "Expected availability time",
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "X-Trace-Id": {
+                "required": false,
+                "description": "Trace ID for correlation",
+                "schema": {
+                  "type": "string"
+                }
+              },
+              "X-Request-Id": {
+                "required": false,
+                "description": "Request ID for support",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Common.Errors.ServiceUnavailableError"
+                }
+              }
+            }
           }
         },
         "tags": [
@@ -1660,6 +1702,15 @@
               "default": 100
             },
             "explode": false
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "explode": false
           }
         ],
         "responses": {
@@ -3151,6 +3202,14 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "Last-Event-ID",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
           }
         ],
         "responses": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "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": {