@ancplua/qyl-api-schema 0.5.5 → 0.5.7

package/api/runner.tsp

@@ -28,35 +28,35 @@ namespace Qyl.Api.Contracts.Runner {
   @tag("Runner resources")
   interface RunnerResourcesApi {
     @get
-    snapshot(): RunnerResourceState[] | ForbiddenError | InternalServerError;
+    snapshot(): RunnerResourceState[] | ForbiddenError | ServiceUnavailableError | InternalServerError;
 
     @get
     @route("/stream")
-    stream(): SSEStream<RunnerResourceEvents> | ForbiddenError | InternalServerError;
+    stream(): SSEStream<RunnerResourceEvents> | ForbiddenError | ServiceUnavailableError | InternalServerError;
 
     @get
     @route("/{resource}/logs")
     logs(
       @path resource: string,
-    ): RunnerLogLine[] | ForbiddenError | NotFoundError | InternalServerError;
+    ): RunnerLogLine[] | ForbiddenError | NotFoundError | ServiceUnavailableError | InternalServerError;
 
     @get
     @route("/{resource}/logs/stream")
     streamLogs(
       @path resource: string,
-    ): SSEStream<RunnerLogEvents> | ForbiddenError | NotFoundError | InternalServerError;
+    ): SSEStream<RunnerLogEvents> | ForbiddenError | NotFoundError | ServiceUnavailableError | InternalServerError;
 
     @post
     @route("/{resource}/restart")
     restart(
       @path resource: string,
-    ): RunnerActionAccepted | ForbiddenError | NotFoundError | ConflictError | InternalServerError;
+    ): RunnerActionAccepted | ForbiddenError | NotFoundError | ConflictError | ServiceUnavailableError | InternalServerError;
 
     @post
     @route("/{resource}/stop")
     stop(
       @path resource: string,
-    ): RunnerActionAccepted | ForbiddenError | NotFoundError | ConflictError | InternalServerError;
+    ): RunnerActionAccepted | ForbiddenError | NotFoundError | ConflictError | ServiceUnavailableError | InternalServerError;
   }
 
   @route("/runner/mcp/{resource}")
@@ -71,6 +71,7 @@ namespace Qyl.Api.Contracts.Runner {
       | NotFoundError
       | ConflictError
       | BadGatewayError
+      | ServiceUnavailableError
       | InternalServerError;
 
     @post
@@ -84,6 +85,7 @@ namespace Qyl.Api.Contracts.Runner {
       | NotFoundError
       | ConflictError
       | BadGatewayError
+      | ServiceUnavailableError
       | InternalServerError;
 
     @post
@@ -97,6 +99,7 @@ namespace Qyl.Api.Contracts.Runner {
       | NotFoundError
       | ConflictError
       | BadGatewayError
+      | ServiceUnavailableError
       | InternalServerError;
   }
 }

package/api/streaming.tsp

@@ -45,5 +45,5 @@ interface StreamingApi {
     @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/common/types.tsp

@@ -209,7 +209,18 @@ scalar LanguageCode extends string;
 // OpenTelemetry Attribute Value Types
 // =============================================================================
 
-@doc("Primitive attribute value types supported by OpenTelemetry")
+@doc("Base64 bytes projected by qyl without colliding with an ordinary string attribute.")
+model AttributeBytesValue {
+  type: "bytes";
+  base64: bytes;
+}
+
+@doc("Recursive OTLP key-value-list projected as a JSON object.")
+model AttributeKeyValueListValue {
+  ...Record<AttributeValue>;
+}
+
+@doc("Lossless JSON projection of an OpenTelemetry AnyValue attribute.")
 union AttributeValue {
   @doc("String value")
   stringValue: string,
@@ -223,20 +234,14 @@ union AttributeValue {
   @doc("64-bit floating point value")
   doubleValue: float64,
 
-  @doc("Array of strings")
-  stringArrayValue: string[],
-
-  @doc("Array of booleans")
-  boolArrayValue: boolean[],
-
-  @doc("Array of integers")
-  intArrayValue: int64[],
+  @doc("Bytes value projected as an explicit tagged object")
+  bytesValue: AttributeBytesValue,
 
-  @doc("Array of doubles")
-  doubleArrayValue: float64[],
+  @doc("Nested and heterogeneous array value")
+  arrayValue: AttributeValue[],
 
-  @doc("Bytes value (base64 encoded)")
-  bytesValue: bytes,
+  @doc("Recursive key-value-list value")
+  keyValueListValue: AttributeKeyValueListValue,
 }
 
 @doc("Key-value attribute pair following OTel conventions")

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

@@ -26,6 +26,33 @@
       },
       "description": "Key-value attribute pair following OTel conventions"
     },
+    "Common.AttributeBytesValue": {
+      "type": "object",
+      "required": [
+        "type",
+        "base64"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "bytes"
+          ]
+        },
+        "base64": {
+          "type": "string",
+          "contentEncoding": "base64"
+        }
+      },
+      "description": "Base64 bytes projected by qyl without colliding with an ordinary string attribute."
+    },
+    "Common.AttributeKeyValueListValue": {
+      "type": "object",
+      "unevaluatedProperties": {
+        "$ref": "#/$defs/Common.AttributeValue"
+      },
+      "description": "Recursive OTLP key-value-list projected as a JSON object."
+    },
     "Common.AttributeValue": {
       "anyOf": [
         {
@@ -43,37 +70,19 @@
           "format": "double"
         },
         {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        {
-          "type": "array",
-          "items": {
-            "type": "boolean"
-          }
+          "$ref": "#/$defs/Common.AttributeBytesValue"
         },
         {
           "type": "array",
           "items": {
-            "type": "integer",
-            "format": "int64"
-          }
-        },
-        {
-          "type": "array",
-          "items": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/$defs/Common.AttributeValue"
           }
         },
         {
-          "type": "string",
-          "contentEncoding": "base64"
+          "$ref": "#/$defs/Common.AttributeKeyValueListValue"
         }
       ],
-      "description": "Primitive attribute value types supported by OpenTelemetry"
+      "description": "Lossless JSON projection of an OpenTelemetry AnyValue attribute."
     },
     "Common.Attributes": {
       "type": "object",
@@ -3477,71 +3486,82 @@
       },
       "description": "Trace summary without the full span collection"
     },
-    "Runner.Mcp.RunnerMcpContent": {
+    "Runner.Mcp.RunnerMcpAudioContent": {
       "type": "object",
       "required": [
-        "type"
+        "type",
+        "data",
+        "mimeType"
       ],
       "properties": {
         "type": {
-          "type": "string"
-        },
-        "text": {
-          "type": "string"
+          "type": "string",
+          "enum": [
+            "audio"
+          ]
         },
         "data": {
-          "type": "string"
+          "type": "string",
+          "contentEncoding": "base64"
         },
         "mimeType": {
           "type": "string"
-        },
-        "uri": {
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpContentMetadata"
+        }
+      ],
+      "description": "Base64-encoded audio content."
+    },
+    "Runner.Mcp.RunnerMcpBlobResourceContent": {
+      "type": "object",
+      "required": [
+        "blob"
+      ],
+      "properties": {
+        "blob": {
           "type": "string",
-          "format": "uri"
-        },
-        "name": {
-          "type": "string"
-        },
-        "title": {
-          "type": "string"
-        },
-        "description": {
-          "type": "string"
-        },
-        "size": {
-          "type": "integer",
-          "format": "int64",
-          "minimum": 0
-        },
-        "icons": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/Runner.Mcp.RunnerMcpIcon"
-          }
-        },
-        "resource": {
-          "$ref": "#/$defs/Runner.Mcp.RunnerMcpResourceContent"
+          "contentEncoding": "base64"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpResourceContentMetadata"
+        }
+      ],
+      "description": "Base64-encoded resource content returned by an MCP server."
+    },
+    "Runner.Mcp.RunnerMcpContent": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpTextContent"
         },
-        "id": {
-          "type": "string"
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpImageContent"
         },
-        "input": {},
-        "toolUseId": {
-          "type": "string"
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpAudioContent"
         },
-        "content": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/Runner.Mcp.RunnerMcpContent"
-          }
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpEmbeddedResourceContent"
         },
-        "structuredContent": {
-          "type": "object",
-          "unevaluatedProperties": {}
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpResourceLinkContent"
         },
-        "isError": {
-          "type": "boolean"
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpToolUseContent"
         },
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpToolResultContent"
+        }
+      ],
+      "description": "One MCP content item. The type literal selects the required variant fields."
+    },
+    "Runner.Mcp.RunnerMcpContentMetadata": {
+      "type": "object",
+      "properties": {
         "annotations": {
           "type": "object",
           "unevaluatedProperties": {}
@@ -3551,7 +3571,31 @@
           "unevaluatedProperties": {}
         }
       },
-      "description": "One MCP content item projected onto a stable qyl JSON shape. Variant-specific required fields follow its type discriminator."
+      "description": "Metadata shared by every MCP content variant."
+    },
+    "Runner.Mcp.RunnerMcpEmbeddedResourceContent": {
+      "type": "object",
+      "required": [
+        "type",
+        "resource"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "resource"
+          ]
+        },
+        "resource": {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpResourceContent"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpContentMetadata"
+        }
+      ],
+      "description": "A resource embedded in MCP content."
     },
     "Runner.Mcp.RunnerMcpIcon": {
       "type": "object",
@@ -3577,7 +3621,47 @@
       },
       "description": "Icon metadata carried by MCP tools and resource links."
     },
+    "Runner.Mcp.RunnerMcpImageContent": {
+      "type": "object",
+      "required": [
+        "type",
+        "data",
+        "mimeType"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "image"
+          ]
+        },
+        "data": {
+          "type": "string",
+          "contentEncoding": "base64"
+        },
+        "mimeType": {
+          "type": "string"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpContentMetadata"
+        }
+      ],
+      "description": "Base64-encoded image content."
+    },
     "Runner.Mcp.RunnerMcpResourceContent": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpTextResourceContent"
+        },
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpBlobResourceContent"
+        }
+      ],
+      "description": "Exactly one MCP text or blob resource variant."
+    },
+    "Runner.Mcp.RunnerMcpResourceContentMetadata": {
       "type": "object",
       "required": [
         "uri"
@@ -3590,18 +3674,61 @@
         "mimeType": {
           "type": "string"
         },
-        "text": {
+        "_meta": {
+          "type": "object",
+          "unevaluatedProperties": {}
+        }
+      },
+      "description": "Metadata shared by MCP text and blob resources."
+    },
+    "Runner.Mcp.RunnerMcpResourceLinkContent": {
+      "type": "object",
+      "required": [
+        "type",
+        "uri",
+        "name"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "resource_link"
+          ]
+        },
+        "uri": {
+          "type": "string",
+          "format": "uri"
+        },
+        "name": {
           "type": "string"
         },
-        "blob": {
+        "title": {
           "type": "string"
         },
-        "_meta": {
-          "type": "object",
-          "unevaluatedProperties": {}
+        "description": {
+          "type": "string"
+        },
+        "mimeType": {
+          "type": "string"
+        },
+        "size": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0
+        },
+        "icons": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Runner.Mcp.RunnerMcpIcon"
+          }
         }
       },
-      "description": "Text or base64 resource content returned by an MCP server. Exactly one of text or blob is present."
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpContentMetadata"
+        }
+      ],
+      "description": "A link to a resource that an MCP server can read."
     },
     "Runner.Mcp.RunnerMcpResourceReadRequest": {
       "type": "object",
@@ -3697,6 +3824,47 @@
       ],
       "description": "Lifecycle state of an MCP task returned by a task-augmented tool call."
     },
+    "Runner.Mcp.RunnerMcpTextContent": {
+      "type": "object",
+      "required": [
+        "type",
+        "text"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "text"
+          ]
+        },
+        "text": {
+          "type": "string"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpContentMetadata"
+        }
+      ],
+      "description": "Text provided to or returned by an MCP model or tool."
+    },
+    "Runner.Mcp.RunnerMcpTextResourceContent": {
+      "type": "object",
+      "required": [
+        "text"
+      ],
+      "properties": {
+        "text": {
+          "type": "string"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpResourceContentMetadata"
+        }
+      ],
+      "description": "Text resource content returned by an MCP server."
+    },
     "Runner.Mcp.RunnerMcpTool": {
       "type": "object",
       "required": [
@@ -3803,6 +3971,44 @@
       },
       "description": "Execution metadata advertised for an MCP tool."
     },
+    "Runner.Mcp.RunnerMcpToolResultContent": {
+      "type": "object",
+      "required": [
+        "type",
+        "toolUseId",
+        "content"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "tool_result"
+          ]
+        },
+        "toolUseId": {
+          "type": "string"
+        },
+        "content": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Runner.Mcp.RunnerMcpContent"
+          }
+        },
+        "structuredContent": {
+          "type": "object",
+          "unevaluatedProperties": {}
+        },
+        "isError": {
+          "type": "boolean"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpContentMetadata"
+        }
+      ],
+      "description": "The result of an MCP sampling tool invocation."
+    },
     "Runner.Mcp.RunnerMcpToolTaskSupport": {
       "type": "string",
       "enum": [
@@ -3812,6 +4018,36 @@
       ],
       "description": "Task-augmentation support advertised for an MCP tool."
     },
+    "Runner.Mcp.RunnerMcpToolUseContent": {
+      "type": "object",
+      "required": [
+        "type",
+        "id",
+        "name",
+        "input"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "tool_use"
+          ]
+        },
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "input": {}
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpContentMetadata"
+        }
+      ],
+      "description": "An MCP sampling request to invoke a tool."
+    },
     "Runner.Mcp.RunnerMcpToolsResponse": {
       "type": "object",
       "required": [