@ancplua/qyl-api-schema 0.6.1 → 1.0.2

package/README.md

@@ -69,8 +69,10 @@ Important generated outputs include:
 
 Generated files are not editing surfaces. OpenAPI comes from the official TypeSpec
 emitter; the bundled JSON Schema is a deterministic projection of its component
-schemas so both artifacts preserve the same wire names. Change TypeSpec or the
-owning generator and regenerate.
+schemas and exposes inline route bodies as stable
+`Operations.<operationId>.Request` and
+`Operations.<operationId>.Response.<status>` definitions. Both artifacts preserve
+the same wire names. Change TypeSpec or the owning generator and regenerate.
 
 ## Publish
 

package/api/runner.tsp

@@ -130,6 +130,54 @@ namespace Qyl.Api.Contracts.Runner {
       | InternalServerError;
   }
 
+  @route("/runner/mcp/{resource}")
+  @tag("Runner MCP")
+  interface RunnerMcpApi {
+    @doc("Returns the MCP SDK-owned tools/list result without redefining its protocol body.")
+    @get
+    @route("/tools")
+    listTools(@path resource: string):
+      | unknown
+      | ForbiddenError
+      | NotFoundError
+      | ConflictError
+      | BadGatewayError
+      | ServiceUnavailableError
+      | InternalServerError;
+
+    @doc("Accepts and returns MCP SDK-owned tools/call bodies without redefining the protocol DTOs.")
+    @post
+    @route("/tools/call")
+    callTool(
+      @path resource: string,
+      @body request: unknown,
+    ):
+      | unknown
+      | ValidationError
+      | ForbiddenError
+      | NotFoundError
+      | ConflictError
+      | BadGatewayError
+      | ServiceUnavailableError
+      | InternalServerError;
+
+    @doc("Accepts and returns MCP SDK-owned resources/read bodies without redefining the protocol DTOs.")
+    @post
+    @route("/resources/read")
+    readResource(
+      @path resource: string,
+      @body request: unknown,
+    ):
+      | unknown
+      | ValidationError
+      | ForbiddenError
+      | NotFoundError
+      | ConflictError
+      | BadGatewayError
+      | ServiceUnavailableError
+      | InternalServerError;
+  }
+
   @route("/runner/workspaces")
   @tag("Runner workspaces")
   @useAuth(RunnerMcpSessionCookieAuth)

package/common/types.tsp

@@ -215,24 +215,53 @@ model AttributeBytesValue {
   base64: bytes;
 }
 
-@doc("Recursive OTLP key-value-list projected as a JSON object.")
+@doc("An OTLP signed 64-bit attribute integer encoded without JavaScript precision loss.")
+@encode(string)
+@TypeSpec.OpenAPI.extension("x-csharp-type", "long")
+scalar AttributeInt64 extends int64;
+
+@doc("An OTLP attribute double encoded as a JSON number when finite or a canonical named string when non-finite.")
+union AttributeDouble {
+  finite: float64,
+  nan: "NaN",
+  positiveInfinity: "Infinity",
+  negativeInfinity: "-Infinity",
+}
+
+@doc("Tagged OTLP signed 64-bit integer attribute.")
+model AttributeIntValue {
+  type: "int";
+  value: AttributeInt64;
+}
+
+@doc("Tagged OTLP double attribute.")
+model AttributeDoubleValue {
+  type: "double";
+  value: AttributeDouble;
+}
+
+@doc("Tagged recursive OTLP key-value-list, distinct from other object-shaped attribute variants.")
 model AttributeKeyValueListValue {
-  ...Record<AttributeValue>;
+  type: "kvlist";
+  values: Record<AttributeValue>;
 }
 
 @doc("Lossless JSON projection of an OpenTelemetry AnyValue attribute.")
 union AttributeValue {
+  @doc("Empty AnyValue")
+  emptyValue: null,
+
   @doc("String value")
   stringValue: string,
 
   @doc("Boolean value")
   boolValue: boolean,
 
-  @doc("64-bit integer value")
-  intValue: int64,
+  @doc("Lossless 64-bit integer value")
+  intValue: AttributeIntValue,
 
-  @doc("64-bit floating point value")
-  doubleValue: float64,
+  @doc("Lossless finite or non-finite 64-bit floating point value")
+  doubleValue: AttributeDoubleValue,
 
   @doc("Bytes value projected as an explicit tagged object")
   bytesValue: AttributeBytesValue,
@@ -261,6 +290,30 @@ model Attributes {
   items: Attribute[];
 }
 
+@doc("A non-empty Resource attribute key referenced by an OpenTelemetry entity.")
+@minLength(1)
+scalar EntityAttributeKey extends string;
+
+@doc("A reference to an OpenTelemetry entity described by attributes on the containing Resource.")
+model EntityRef {
+  @doc("Schema URL applying to the entity and its referenced Resource attributes, when known.")
+  @encodedName("application/json", "schema_url")
+  schemaUrl?: string;
+
+  @doc("Stable non-empty entity type, such as service or host.")
+  @minLength(1)
+  type: string;
+
+  @doc("Non-empty set of Resource attribute keys that identify the entity.")
+  @encodedName("application/json", "id_keys")
+  @minItems(1)
+  idKeys: EntityAttributeKey[];
+
+  @doc("Resource attribute keys that describe but do not identify the entity.")
+  @encodedName("application/json", "description_keys")
+  descriptionKeys?: EntityAttributeKey[];
+}
+
 // =============================================================================
 // Instrumentation Scope
 // =============================================================================

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

@@ -52,15 +52,105 @@
       },
       "description": "Base64 bytes projected by qyl without colliding with an ordinary string attribute."
     },
+    "Common.AttributeDouble": {
+      "anyOf": [
+        {
+          "type": "number",
+          "format": "double"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "NaN",
+            "Infinity",
+            "-Infinity"
+          ]
+        }
+      ],
+      "description": "An OTLP attribute double encoded as a JSON number when finite or a canonical named string when non-finite."
+    },
+    "Common.AttributeDoubleValue": {
+      "type": "object",
+      "required": [
+        "type",
+        "value"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "double"
+          ]
+        },
+        "value": {
+          "$ref": "#/$defs/Common.AttributeDouble"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Tagged OTLP double attribute."
+    },
+    "Common.AttributeInt64": {
+      "type": "string",
+      "format": "int64",
+      "description": "An OTLP signed 64-bit attribute integer encoded without JavaScript precision loss.",
+      "x-csharp-type": "long",
+      "pattern": "^(0|-?[1-9][0-9]*)$",
+      "maxLength": 20
+    },
+    "Common.AttributeIntValue": {
+      "type": "object",
+      "required": [
+        "type",
+        "value"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "int"
+          ]
+        },
+        "value": {
+          "$ref": "#/$defs/Common.AttributeInt64"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Tagged OTLP signed 64-bit integer attribute."
+    },
     "Common.AttributeKeyValueListValue": {
       "type": "object",
+      "required": [
+        "type",
+        "values"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "kvlist"
+          ]
+        },
+        "values": {
+          "type": "object",
+          "unevaluatedProperties": {
+            "$ref": "#/$defs/Common.AttributeValue"
+          }
+        }
+      },
       "unevaluatedProperties": {
-        "$ref": "#/$defs/Common.AttributeValue"
+        "not": {}
       },
-      "description": "Recursive OTLP key-value-list projected as a JSON object."
+      "description": "Tagged recursive OTLP key-value-list, distinct from other object-shaped attribute variants."
     },
     "Common.AttributeValue": {
       "anyOf": [
+        {
+          "type": "null"
+        },
         {
           "type": "string"
         },
@@ -68,12 +158,10 @@
           "type": "boolean"
         },
         {
-          "type": "integer",
-          "format": "int64"
+          "$ref": "#/$defs/Common.AttributeIntValue"
         },
         {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/Common.AttributeDoubleValue"
         },
         {
           "$ref": "#/$defs/Common.AttributeBytesValue"
@@ -157,6 +245,48 @@
       "minimum": 0,
       "description": "Duration in seconds"
     },
+    "Common.EntityAttributeKey": {
+      "type": "string",
+      "minLength": 1,
+      "description": "A non-empty Resource attribute key referenced by an OpenTelemetry entity."
+    },
+    "Common.EntityRef": {
+      "type": "object",
+      "required": [
+        "type",
+        "id_keys"
+      ],
+      "properties": {
+        "schema_url": {
+          "type": "string",
+          "description": "Schema URL applying to the entity and its referenced Resource attributes, when known."
+        },
+        "type": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Stable non-empty entity type, such as service or host."
+        },
+        "id_keys": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Common.EntityAttributeKey"
+          },
+          "minItems": 1,
+          "description": "Non-empty set of Resource attribute keys that identify the entity."
+        },
+        "description_keys": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Common.EntityAttributeKey"
+          },
+          "description": "Resource attribute keys that describe but do not identify the entity."
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "A reference to an OpenTelemetry entity described by attributes on the containing Resource."
+    },
     "Common.Errors.ApiError": {
       "anyOf": [
         {
@@ -4214,7 +4344,7 @@
         },
         "event_name": {
           "type": "string",
-          "description": "Fully qualified category identifying this log record as an event"
+          "description": "Optional event category whose presence identifies this log record as an event; records with the same name are expected to share one body and attribute schema."
         },
         "resource": {
           "allOf": [
@@ -4313,8 +4443,7 @@
           "$ref": "#/$defs/OTel.Metrics.MetricUInt64"
         },
         "sum": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "scale": {
           "type": "integer",
@@ -4324,8 +4453,7 @@
           "$ref": "#/$defs/OTel.Metrics.MetricUInt64"
         },
         "zero_threshold": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "positive": {
           "$ref": "#/$defs/OTel.Metrics.ExponentialHistogramBuckets"
@@ -4334,12 +4462,10 @@
           "$ref": "#/$defs/OTel.Metrics.ExponentialHistogramBuckets"
         },
         "min": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "max": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "aggregation_temporality": {
           "$ref": "#/$defs/OTel.Enums.AggregationTemporality"
@@ -4364,8 +4490,7 @@
     "OTel.Metrics.GaugeMetricPoint": {
       "type": "object",
       "required": [
-        "type",
-        "value"
+        "type"
       ],
       "properties": {
         "type": {
@@ -4375,7 +4500,12 @@
           ]
         },
         "value": {
-          "$ref": "#/$defs/OTel.Metrics.MetricNumberValue"
+          "allOf": [
+            {
+              "$ref": "#/$defs/OTel.Metrics.MetricNumberValue"
+            }
+          ],
+          "description": "Recorded value, absent when flags contain NO_RECORDED_VALUE (bit 1)."
         },
         "exemplars": {
           "type": "array",
@@ -4414,8 +4544,7 @@
           "$ref": "#/$defs/OTel.Metrics.MetricUInt64"
         },
         "sum": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "bucket_counts": {
           "type": "array",
@@ -4431,12 +4560,10 @@
           }
         },
         "min": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "max": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "aggregation_temporality": {
           "$ref": "#/$defs/OTel.Enums.AggregationTemporality"
@@ -4458,6 +4585,23 @@
       ],
       "description": "Explicit-bucket histogram measurement."
     },
+    "OTel.Metrics.MetricDouble": {
+      "anyOf": [
+        {
+          "type": "number",
+          "format": "double"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "NaN",
+            "Infinity",
+            "-Infinity"
+          ]
+        }
+      ],
+      "description": "An OTLP double encoded as a JSON number when finite or as a canonical named string when non-finite."
+    },
     "OTel.Metrics.MetricDoubleValue": {
       "type": "object",
       "required": [
@@ -4465,8 +4609,7 @@
       ],
       "properties": {
         "as_double": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         }
       },
       "unevaluatedProperties": {
@@ -4653,7 +4796,6 @@
       "type": "object",
       "required": [
         "type",
-        "value",
         "aggregation_temporality",
         "is_monotonic"
       ],
@@ -4665,7 +4807,12 @@
           ]
         },
         "value": {
-          "$ref": "#/$defs/OTel.Metrics.MetricNumberValue"
+          "allOf": [
+            {
+              "$ref": "#/$defs/OTel.Metrics.MetricNumberValue"
+            }
+          ],
+          "description": "Recorded value, absent when flags contain NO_RECORDED_VALUE (bit 1)."
         },
         "aggregation_temporality": {
           "$ref": "#/$defs/OTel.Enums.AggregationTemporality"
@@ -4709,8 +4856,7 @@
           "$ref": "#/$defs/OTel.Metrics.MetricUInt64"
         },
         "sum": {
-          "type": "number",
-          "format": "double"
+          "$ref": "#/$defs/OTel.Metrics.MetricDouble"
         },
         "quantile_values": {
           "type": "array",
@@ -4729,6 +4875,26 @@
       ],
       "description": "Pre-aggregated summary measurement."
     },
+    "OTel.Metrics.SummaryQuantileDouble": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/OTel.Metrics.SummaryQuantileFiniteValue"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "Infinity"
+          ]
+        }
+      ],
+      "description": "A non-negative OTLP summary quantile value, including canonical positive infinity."
+    },
+    "OTel.Metrics.SummaryQuantileFiniteValue": {
+      "type": "number",
+      "format": "double",
+      "minimum": 0,
+      "description": "A finite, non-negative value observed at an OTLP summary quantile."
+    },
     "OTel.Metrics.SummaryQuantileValue": {
       "type": "object",
       "required": [
@@ -4743,9 +4909,7 @@
           "maximum": 1
         },
         "value": {
-          "type": "number",
-          "format": "double",
-          "minimum": 0
+          "$ref": "#/$defs/OTel.Metrics.SummaryQuantileDouble"
         }
       },
       "unevaluatedProperties": {
@@ -5529,6 +5693,13 @@
             }
           ],
           "description": "Dropped attributes count"
+        },
+        "entity_refs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Common.EntityRef"
+          },
+          "description": "Entities participating in this Resource, keyed by attributes on the Resource."
         }
       },
       "unevaluatedProperties": {
@@ -9158,6 +9329,71 @@
     "Operations.ProfilesApi_list.Response.500": {
       "$ref": "#/$defs/Common.Errors.InternalServerError"
     },
+    "Operations.RunnerMcpApi_callTool.Request": {},
+    "Operations.RunnerMcpApi_callTool.Response.200": {},
+    "Operations.RunnerMcpApi_callTool.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.RunnerMcpApi_callTool.Response.403": {
+      "$ref": "#/$defs/Common.Errors.ForbiddenError"
+    },
+    "Operations.RunnerMcpApi_callTool.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.RunnerMcpApi_callTool.Response.409": {
+      "$ref": "#/$defs/Common.Errors.ConflictError"
+    },
+    "Operations.RunnerMcpApi_callTool.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.RunnerMcpApi_callTool.Response.502": {
+      "$ref": "#/$defs/Common.Errors.BadGatewayError"
+    },
+    "Operations.RunnerMcpApi_callTool.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.RunnerMcpApi_listTools.Response.200": {},
+    "Operations.RunnerMcpApi_listTools.Response.403": {
+      "$ref": "#/$defs/Common.Errors.ForbiddenError"
+    },
+    "Operations.RunnerMcpApi_listTools.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.RunnerMcpApi_listTools.Response.409": {
+      "$ref": "#/$defs/Common.Errors.ConflictError"
+    },
+    "Operations.RunnerMcpApi_listTools.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.RunnerMcpApi_listTools.Response.502": {
+      "$ref": "#/$defs/Common.Errors.BadGatewayError"
+    },
+    "Operations.RunnerMcpApi_listTools.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
+    "Operations.RunnerMcpApi_readResource.Request": {},
+    "Operations.RunnerMcpApi_readResource.Response.200": {},
+    "Operations.RunnerMcpApi_readResource.Response.400": {
+      "$ref": "#/$defs/Common.Errors.ValidationError"
+    },
+    "Operations.RunnerMcpApi_readResource.Response.403": {
+      "$ref": "#/$defs/Common.Errors.ForbiddenError"
+    },
+    "Operations.RunnerMcpApi_readResource.Response.404": {
+      "$ref": "#/$defs/Common.Errors.NotFoundError"
+    },
+    "Operations.RunnerMcpApi_readResource.Response.409": {
+      "$ref": "#/$defs/Common.Errors.ConflictError"
+    },
+    "Operations.RunnerMcpApi_readResource.Response.500": {
+      "$ref": "#/$defs/Common.Errors.InternalServerError"
+    },
+    "Operations.RunnerMcpApi_readResource.Response.502": {
+      "$ref": "#/$defs/Common.Errors.BadGatewayError"
+    },
+    "Operations.RunnerMcpApi_readResource.Response.503": {
+      "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
+    },
     "Operations.RunnerMcpEvaluationRunsApi_compare.Request": {
       "$ref": "#/$defs/Runner.Mcp.RunnerMcpEvaluationComparisonRequest"
     },