@ancplua/qyl-api-schema 0.6.0 → 1.0.0

package/generated/openapi/qyl.openapi.json

@@ -13721,15 +13721,103 @@
         },
         "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": "#/components/schemas/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"
+      },
+      "Common.AttributeIntValue": {
+        "type": "object",
+        "required": [
+          "type",
+          "value"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "int"
+            ]
+          },
+          "value": {
+            "$ref": "#/components/schemas/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": "#/components/schemas/Common.AttributeValue"
+            }
+          }
+        },
         "unevaluatedProperties": {
-          "$ref": "#/components/schemas/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"
           },
@@ -13737,12 +13825,10 @@
             "type": "boolean"
           },
           {
-            "type": "integer",
-            "format": "int64"
+            "$ref": "#/components/schemas/Common.AttributeIntValue"
           },
           {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/Common.AttributeDoubleValue"
           },
           {
             "$ref": "#/components/schemas/Common.AttributeBytesValue"
@@ -13826,6 +13912,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": "#/components/schemas/Common.EntityAttributeKey"
+            },
+            "minItems": 1,
+            "description": "Non-empty set of Resource attribute keys that identify the entity."
+          },
+          "description_keys": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/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": [
           {
@@ -17881,6 +18009,10 @@
             ],
             "description": "Associated span ID"
           },
+          "event_name": {
+            "type": "string",
+            "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": [
               {
@@ -17978,8 +18110,7 @@
             "$ref": "#/components/schemas/OTel.Metrics.MetricUInt64"
           },
           "sum": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "scale": {
             "type": "integer",
@@ -17989,8 +18120,7 @@
             "$ref": "#/components/schemas/OTel.Metrics.MetricUInt64"
           },
           "zero_threshold": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "positive": {
             "$ref": "#/components/schemas/OTel.Metrics.ExponentialHistogramBuckets"
@@ -17999,12 +18129,10 @@
             "$ref": "#/components/schemas/OTel.Metrics.ExponentialHistogramBuckets"
           },
           "min": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "max": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "aggregation_temporality": {
             "$ref": "#/components/schemas/OTel.Enums.AggregationTemporality"
@@ -18029,8 +18157,7 @@
       "OTel.Metrics.GaugeMetricPoint": {
         "type": "object",
         "required": [
-          "type",
-          "value"
+          "type"
         ],
         "properties": {
           "type": {
@@ -18040,7 +18167,12 @@
             ]
           },
           "value": {
-            "$ref": "#/components/schemas/OTel.Metrics.MetricNumberValue"
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/OTel.Metrics.MetricNumberValue"
+              }
+            ],
+            "description": "Recorded value, absent when flags contain NO_RECORDED_VALUE (bit 1)."
           },
           "exemplars": {
             "type": "array",
@@ -18079,8 +18211,7 @@
             "$ref": "#/components/schemas/OTel.Metrics.MetricUInt64"
           },
           "sum": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "bucket_counts": {
             "type": "array",
@@ -18096,12 +18227,10 @@
             }
           },
           "min": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "max": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "aggregation_temporality": {
             "$ref": "#/components/schemas/OTel.Enums.AggregationTemporality"
@@ -18123,6 +18252,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": [
@@ -18130,8 +18276,7 @@
         ],
         "properties": {
           "as_double": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           }
         },
         "unevaluatedProperties": {
@@ -18312,7 +18457,6 @@
         "type": "object",
         "required": [
           "type",
-          "value",
           "aggregation_temporality",
           "is_monotonic"
         ],
@@ -18324,7 +18468,12 @@
             ]
           },
           "value": {
-            "$ref": "#/components/schemas/OTel.Metrics.MetricNumberValue"
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/OTel.Metrics.MetricNumberValue"
+              }
+            ],
+            "description": "Recorded value, absent when flags contain NO_RECORDED_VALUE (bit 1)."
           },
           "aggregation_temporality": {
             "$ref": "#/components/schemas/OTel.Enums.AggregationTemporality"
@@ -18368,8 +18517,7 @@
             "$ref": "#/components/schemas/OTel.Metrics.MetricUInt64"
           },
           "sum": {
-            "type": "number",
-            "format": "double"
+            "$ref": "#/components/schemas/OTel.Metrics.MetricDouble"
           },
           "quantile_values": {
             "type": "array",
@@ -18388,6 +18536,26 @@
         ],
         "description": "Pre-aggregated summary measurement."
       },
+      "OTel.Metrics.SummaryQuantileDouble": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/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": [
@@ -18402,9 +18570,7 @@
             "maximum": 1
           },
           "value": {
-            "type": "number",
-            "format": "double",
-            "minimum": 0
+            "$ref": "#/components/schemas/OTel.Metrics.SummaryQuantileDouble"
           }
         },
         "unevaluatedProperties": {
@@ -19188,6 +19354,13 @@
               }
             ],
             "description": "Dropped attributes count"
+          },
+          "entity_refs": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Common.EntityRef"
+            },
+            "description": "Entities participating in this Resource, keyed by attributes on the Resource."
           }
         },
         "unevaluatedProperties": {

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

@@ -577,10 +577,13 @@ export declare const GenAiEtlFrontierCostBasisValues: {
     readonly unavailable: "unavailable";
 };
 export type GenAiEtlFrontierCostBasis = typeof GenAiEtlFrontierCostBasisValues[keyof typeof GenAiEtlFrontierCostBasisValues];
-export type AttributeValue = string | boolean | number | AttributeBytesValue | AttributeValue[] | AttributeKeyValueListValue;
+export type AttributeDouble = number | "NaN" | "Infinity" | "-Infinity";
+export type AttributeValue = null | string | boolean | AttributeIntValue | AttributeDoubleValue | AttributeBytesValue | AttributeValue[] | AttributeKeyValueListValue;
 export type ApiError = NotFoundError | ValidationError | UnauthorizedError | ForbiddenError | ConflictError | RateLimitError | InternalServerError | BadGatewayError | ServiceUnavailableError;
 export type LogBody = LogBodyString | LogBodyKvList | LogBodyArray | LogBodyBytes;
+export type MetricDouble = number | "NaN" | "Infinity" | "-Infinity";
 export type MetricNumberValue = MetricIntegerValue | MetricDoubleValue;
+export type SummaryQuantileDouble = number | "Infinity";
 export type MetricPoint = GaugeMetricPoint | SumMetricPoint | HistogramMetricPoint | ExponentialHistogramMetricPoint | SummaryMetricPoint;
 export type RunnerMcpServerConfiguration = RunnerMcpStdioServerConfiguration | RunnerMcpStreamableHttpServerConfiguration | RunnerMcpSseServerConfiguration | RunnerMcpInProcessServerConfiguration | RunnerMcpBuiltinServerConfiguration;
 export type RunnerMcpTestAssertion = RunnerMcpStatusAssertion | RunnerMcpExactAssertion | RunnerMcpPartialAssertion | RunnerMcpSchemaAssertion | RunnerMcpPatternAssertion | RunnerMcpLatencyAssertion;
@@ -599,8 +602,17 @@ export interface AttributeBytesValue {
     "type": "bytes";
     "base64": string;
 }
+export interface AttributeIntValue {
+    "type": "int";
+    "value": string;
+}
+export interface AttributeDoubleValue {
+    "type": "double";
+    "value": AttributeDouble;
+}
 export interface AttributeKeyValueListValue {
-    [key: string]: AttributeValue;
+    "type": "kvlist";
+    "values": Record<string, AttributeValue>;
 }
 export interface Attribute {
     "key": string;
@@ -609,6 +621,12 @@ export interface Attribute {
 export interface Attributes {
     "items": Attribute[];
 }
+export interface EntityRef {
+    "schema_url"?: string;
+    "type": string;
+    "id_keys": string[];
+    "description_keys"?: string[];
+}
 export interface InstrumentationScope {
     "name": string;
     "version"?: string;
@@ -727,6 +745,7 @@ export interface Resource {
     "k8s.deployment.name"?: string;
     "attributes"?: Attribute[];
     "dropped_attributes_count"?: number;
+    "entity_refs"?: EntityRef[];
 }
 export interface Span {
     "span_id": SpanId;
@@ -821,6 +840,7 @@ export interface LogRecord {
     "flags"?: number;
     "trace_id"?: TraceId;
     "span_id"?: SpanId;
+    "event_name"?: string;
     "resource": Resource;
     "instrumentation_scope"?: InstrumentationScope;
 }
@@ -845,7 +865,7 @@ export interface MetricIntegerValue {
     "as_int": string;
 }
 export interface MetricDoubleValue {
-    "as_double": number;
+    "as_double": MetricDouble;
 }
 export interface MetricExemplar {
     "time_unix_nano": string;
@@ -860,7 +880,7 @@ export interface ExponentialHistogramBuckets {
 }
 export interface SummaryQuantileValue {
     "quantile": number;
-    "value": number;
+    "value": SummaryQuantileDouble;
 }
 export interface MetricPointBase {
     "name": string;
@@ -878,12 +898,12 @@ export interface MetricPointBase {
 }
 export interface GaugeMetricPoint extends MetricPointBase {
     "type": "gauge";
-    "value": MetricNumberValue;
+    "value"?: MetricNumberValue;
     "exemplars"?: MetricExemplar[];
 }
 export interface SumMetricPoint extends MetricPointBase {
     "type": "sum";
-    "value": MetricNumberValue;
+    "value"?: MetricNumberValue;
     "aggregation_temporality": AggregationTemporality;
     "is_monotonic": boolean;
     "exemplars"?: MetricExemplar[];
@@ -891,32 +911,32 @@ export interface SumMetricPoint extends MetricPointBase {
 export interface HistogramMetricPoint extends MetricPointBase {
     "type": "histogram";
     "count": string;
-    "sum"?: number;
+    "sum"?: MetricDouble;
     "bucket_counts": string[];
     "explicit_bounds": number[];
-    "min"?: number;
-    "max"?: number;
+    "min"?: MetricDouble;
+    "max"?: MetricDouble;
     "aggregation_temporality": AggregationTemporality;
     "exemplars"?: MetricExemplar[];
 }
 export interface ExponentialHistogramMetricPoint extends MetricPointBase {
     "type": "exponential_histogram";
     "count": string;
-    "sum"?: number;
+    "sum"?: MetricDouble;
     "scale": number;
     "zero_count": string;
-    "zero_threshold": number;
+    "zero_threshold": MetricDouble;
     "positive": ExponentialHistogramBuckets;
     "negative": ExponentialHistogramBuckets;
-    "min"?: number;
-    "max"?: number;
+    "min"?: MetricDouble;
+    "max"?: MetricDouble;
     "aggregation_temporality": AggregationTemporality;
     "exemplars"?: MetricExemplar[];
 }
 export interface SummaryMetricPoint extends MetricPointBase {
     "type": "summary";
     "count": string;
-    "sum": number;
+    "sum": MetricDouble;
     "quantile_values": SummaryQuantileValue[];
 }
 export interface Profile {

package/otel/logs.tsp

@@ -61,6 +61,10 @@ model LogRecord {
   @encodedName("application/json", "span_id")
   spanId?: SpanId;
 
+  @doc("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.")
+  @encodedName("application/json", "event_name")
+  eventName?: string;
+
   @doc("Resource describing the entity that produced this log")
   resource: Qyl.Api.Contracts.OTel.Resource.Resource;
 

package/otel/metrics.tsp

@@ -38,6 +38,24 @@ scalar MetricUnixNanos extends uint64;
 @TypeSpec.OpenAPI.extension("x-csharp-type", "ulong")
 scalar MetricStartUnixNanos extends uint64;
 
+@doc("An OTLP double encoded as a JSON number when finite or as a canonical named string when non-finite.")
+union MetricDouble {
+  finite: float64,
+  nan: "NaN",
+  positiveInfinity: "Infinity",
+  negativeInfinity: "-Infinity",
+}
+
+@doc("A finite, non-negative value observed at an OTLP summary quantile.")
+@minValue(0)
+scalar SummaryQuantileFiniteValue extends float64;
+
+@doc("A non-negative OTLP summary quantile value, including canonical positive infinity.")
+union SummaryQuantileDouble {
+  finite: SummaryQuantileFiniteValue,
+  positiveInfinity: "Infinity",
+}
+
 @doc("An integer measurement value from an OTLP number data point or exemplar.")
 model MetricIntegerValue {
   @encodedName("application/json", "as_int")
@@ -47,7 +65,7 @@ model MetricIntegerValue {
 @doc("A floating-point measurement value from an OTLP number data point or exemplar.")
 model MetricDoubleValue {
   @encodedName("application/json", "as_double")
-  asDouble: float64;
+  asDouble: MetricDouble;
 }
 
 @doc("The exactly-one numeric value carried by an OTLP number data point or exemplar.")
@@ -88,8 +106,7 @@ model SummaryQuantileValue {
   @maxValue(1)
   quantile: float64;
 
-  @minValue(0)
-  value: float64;
+  value: SummaryQuantileDouble;
 }
 
 @doc("Fields shared by every persisted OTLP metric data point.")
@@ -132,14 +149,19 @@ model MetricPointBase {
 @doc("Instantaneous gauge measurement.")
 model GaugeMetricPoint extends MetricPointBase {
   type: "gauge";
-  value: MetricNumberValue;
+
+  @doc("Recorded value, absent when flags contain NO_RECORDED_VALUE (bit 1).")
+  value?: MetricNumberValue;
+
   exemplars?: MetricExemplar[];
 }
 
 @doc("Delta or cumulative sum measurement.")
 model SumMetricPoint extends MetricPointBase {
   type: "sum";
-  value: MetricNumberValue;
+
+  @doc("Recorded value, absent when flags contain NO_RECORDED_VALUE (bit 1).")
+  value?: MetricNumberValue;
 
   @encodedName("application/json", "aggregation_temporality")
   aggregationTemporality: AggregationTemporality;
@@ -154,7 +176,7 @@ model SumMetricPoint extends MetricPointBase {
 model HistogramMetricPoint extends MetricPointBase {
   type: "histogram";
   count: MetricUInt64;
-  sum?: float64;
+  sum?: MetricDouble;
 
   @encodedName("application/json", "bucket_counts")
   bucketCounts: MetricUInt64[];
@@ -162,8 +184,8 @@ model HistogramMetricPoint extends MetricPointBase {
   @encodedName("application/json", "explicit_bounds")
   explicitBounds: float64[];
 
-  min?: float64;
-  max?: float64;
+  min?: MetricDouble;
+  max?: MetricDouble;
 
   @encodedName("application/json", "aggregation_temporality")
   aggregationTemporality: AggregationTemporality;
@@ -175,19 +197,19 @@ model HistogramMetricPoint extends MetricPointBase {
 model ExponentialHistogramMetricPoint extends MetricPointBase {
   type: "exponential_histogram";
   count: MetricUInt64;
-  sum?: float64;
+  sum?: MetricDouble;
   scale: int32;
 
   @encodedName("application/json", "zero_count")
   zeroCount: MetricUInt64;
 
   @encodedName("application/json", "zero_threshold")
-  zeroThreshold: float64;
+  zeroThreshold: MetricDouble;
 
   positive: ExponentialHistogramBuckets;
   negative: ExponentialHistogramBuckets;
-  min?: float64;
-  max?: float64;
+  min?: MetricDouble;
+  max?: MetricDouble;
 
   @encodedName("application/json", "aggregation_temporality")
   aggregationTemporality: AggregationTemporality;
@@ -199,7 +221,7 @@ model ExponentialHistogramMetricPoint extends MetricPointBase {
 model SummaryMetricPoint extends MetricPointBase {
   type: "summary";
   count: MetricUInt64;
-  sum: float64;
+  sum: MetricDouble;
 
   @encodedName("application/json", "quantile_values")
   quantileValues: SummaryQuantileValue[];

package/otel/resource.tsp

@@ -163,6 +163,10 @@ model Resource {
   @doc("Dropped attributes count")
   @encodedName("application/json", "dropped_attributes_count")
   droppedAttributesCount?: Count;
+
+  @doc("Entities participating in this Resource, keyed by attributes on the Resource.")
+  @encodedName("application/json", "entity_refs")
+  entityRefs?: EntityRef[];
 }
 
 // =============================================================================

package/package.json

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