@ancplua/qyl-api-schema 11.0.1 → 11.1.0

package/common/types.tsp

@@ -38,9 +38,10 @@ scalar TraceParent extends string;
 @example("rojo=00f067aa0ba902b7,congo=t61rcWkgMzE")
 scalar TraceState extends string;
 
-@doc("Unique session identifier")
+@doc("Unique session identifier: URL-safe characters, at least one, at most 128, not only dots. The same rule the SDK enforces on the baggage header.")
 @minLength(1)
 @maxLength(128)
+@pattern("^(?!\\.+$)[A-Za-z0-9._~-]{1,128}$")
 scalar SessionId extends string;
 
 @doc("User identifier (pseudonymized for privacy)")
@@ -64,18 +65,15 @@ scalar Timestamp extends utcDateTime;
 @doc("Unsigned Unix timestamp in nanoseconds since epoch, encoded as a decimal string")
 @minValue(0)
 @encode(string)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "ulong")
 scalar UnixNanos extends uint64;
 
 @doc("Duration in nanoseconds, encoded as a decimal string")
 @minValue(0)
 @encode(string)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "ulong")
 scalar DurationNs extends uint64;
 
 @doc("Duration in milliseconds")
 @minValue(0)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "double")
 scalar DurationMs extends float64;
 
 @doc("Duration in seconds")
@@ -105,7 +103,6 @@ scalar IpAddress extends string;
 @doc("Network port number (1-65535)")
 @minValue(1)
 @maxValue(65535)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "int")
 scalar Port extends int32;
 
 @doc("MAC address in colon-separated hex notation")
@@ -119,29 +116,24 @@ scalar MacAddress extends string;
 
 @doc("Size in bytes")
 @minValue(0)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "long")
 scalar ByteSize extends int64;
 
 @doc("Token count (for LLM operations)")
 @minValue(0)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "long")
 scalar TokenCount extends int64;
 
 @doc("Generic non-negative counter")
 @minValue(0)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "long")
 scalar Count extends int64;
 
 @doc("Percentage value (0.0 to 100.0)")
 @minValue(0.0)
 @maxValue(100.0)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "double")
 scalar Percentage extends float64;
 
 @doc("Ratio value (0.0 to 1.0)")
 @minValue(0.0)
 @maxValue(1.0)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "double")
 scalar Ratio extends float64;
 
 // =============================================================================
@@ -150,13 +142,11 @@ scalar Ratio extends float64;
 
 @doc("Cost in USD (floating point)")
 @minValue(0)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "double")
 scalar CostUsd extends float64;
 
 @doc("Temperature setting for LLM requests (0.0-2.0)")
 @minValue(0)
 @maxValue(2)
-@TypeSpec.OpenAPI.extension("x-csharp-type", "double")
 scalar Temperature extends float64;
 
 // =============================================================================
@@ -226,7 +216,6 @@ model AttributeBytesValue {
 
 @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.")

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

@@ -91,7 +91,6 @@
       "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
     },
@@ -215,8 +214,7 @@
       "type": "integer",
       "format": "int64",
       "minimum": 0,
-      "description": "Size in bytes",
-      "x-csharp-type": "long"
+      "description": "Size in bytes"
     },
     "Common.ContentType": {
       "type": "string",
@@ -239,28 +237,24 @@
       "type": "number",
       "format": "double",
       "minimum": 0,
-      "description": "Cost in USD (floating point)",
-      "x-csharp-type": "double"
+      "description": "Cost in USD (floating point)"
     },
     "Common.Count": {
       "type": "integer",
       "format": "int64",
       "minimum": 0,
-      "description": "Generic non-negative counter",
-      "x-csharp-type": "long"
+      "description": "Generic non-negative counter"
     },
     "Common.DurationMs": {
       "type": "number",
       "format": "double",
       "minimum": 0,
-      "description": "Duration in milliseconds",
-      "x-csharp-type": "double"
+      "description": "Duration in milliseconds"
     },
     "Common.DurationNs": {
       "type": "string",
       "format": "uint64",
       "description": "Duration in nanoseconds, encoded as a decimal string",
-      "x-csharp-type": "ulong",
       "pattern": "^(0|[1-9][0-9]*)$",
       "maxLength": 20
     },
@@ -898,24 +892,21 @@
       "format": "double",
       "minimum": 0,
       "maximum": 100,
-      "description": "Percentage value (0.0 to 100.0)",
-      "x-csharp-type": "double"
+      "description": "Percentage value (0.0 to 100.0)"
     },
     "Common.Port": {
       "type": "integer",
       "format": "int32",
       "minimum": 1,
       "maximum": 65535,
-      "description": "Network port number (1-65535)",
-      "x-csharp-type": "int"
+      "description": "Network port number (1-65535)"
     },
     "Common.Ratio": {
       "type": "number",
       "format": "double",
       "minimum": 0,
       "maximum": 1,
-      "description": "Ratio value (0.0 to 1.0)",
-      "x-csharp-type": "double"
+      "description": "Ratio value (0.0 to 1.0)"
     },
     "Common.SemVer": {
       "type": "string",
@@ -929,7 +920,8 @@
       "type": "string",
       "minLength": 1,
       "maxLength": 128,
-      "description": "Unique session identifier"
+      "pattern": "^(?!\\.+$)[A-Za-z0-9._~-]{1,128}$",
+      "description": "Unique session identifier: URL-safe characters, at least one, at most 128, not only dots. The same rule the SDK enforces on the baggage header."
     },
     "Common.Sha256Hash": {
       "type": "string",
@@ -953,8 +945,7 @@
       "format": "double",
       "minimum": 0,
       "maximum": 2,
-      "description": "Temperature setting for LLM requests (0.0-2.0)",
-      "x-csharp-type": "double"
+      "description": "Temperature setting for LLM requests (0.0-2.0)"
     },
     "Common.Timestamp": {
       "type": "string",
@@ -965,8 +956,7 @@
       "type": "integer",
       "format": "int64",
       "minimum": 0,
-      "description": "Token count (for LLM operations)",
-      "x-csharp-type": "long"
+      "description": "Token count (for LLM operations)"
     },
     "Common.TraceId": {
       "type": "string",
@@ -997,7 +987,6 @@
       "type": "string",
       "format": "uint64",
       "description": "Unsigned Unix timestamp in nanoseconds since epoch, encoded as a decimal string",
-      "x-csharp-type": "ulong",
       "pattern": "^(0|[1-9][0-9]*)$",
       "maxLength": 20
     },
@@ -1180,8 +1169,7 @@
       "unevaluatedProperties": {
         "not": {}
       },
-      "description": "Complete session entity with aggregated data",
-      "x-csharp-type": "SessionEntity"
+      "description": "Complete session entity with aggregated data"
     },
     "Domains.Observe.Session.SessionEvent": {
       "type": "object",

package/generated/openapi/qyl.openapi.json

@@ -13074,8 +13074,7 @@
       "Common.AttributeInt64": {
         "type": "string",
         "format": "int64",
-        "description": "An OTLP signed 64-bit attribute integer encoded without JavaScript precision loss.",
-        "x-csharp-type": "long"
+        "description": "An OTLP signed 64-bit attribute integer encoded without JavaScript precision loss."
       },
       "Common.AttributeIntValue": {
         "type": "object",
@@ -13197,8 +13196,7 @@
         "type": "integer",
         "format": "int64",
         "minimum": 0,
-        "description": "Size in bytes",
-        "x-csharp-type": "long"
+        "description": "Size in bytes"
       },
       "Common.ContentType": {
         "type": "string",
@@ -13221,29 +13219,25 @@
         "type": "number",
         "format": "double",
         "minimum": 0,
-        "description": "Cost in USD (floating point)",
-        "x-csharp-type": "double"
+        "description": "Cost in USD (floating point)"
       },
       "Common.Count": {
         "type": "integer",
         "format": "int64",
         "minimum": 0,
-        "description": "Generic non-negative counter",
-        "x-csharp-type": "long"
+        "description": "Generic non-negative counter"
       },
       "Common.DurationMs": {
         "type": "number",
         "format": "double",
         "minimum": 0,
-        "description": "Duration in milliseconds",
-        "x-csharp-type": "double"
+        "description": "Duration in milliseconds"
       },
       "Common.DurationNs": {
         "type": "string",
         "format": "uint64",
         "minimum": 0,
-        "description": "Duration in nanoseconds, encoded as a decimal string",
-        "x-csharp-type": "ulong"
+        "description": "Duration in nanoseconds, encoded as a decimal string"
       },
       "Common.DurationS": {
         "type": "number",
@@ -13879,24 +13873,21 @@
         "format": "double",
         "minimum": 0,
         "maximum": 100,
-        "description": "Percentage value (0.0 to 100.0)",
-        "x-csharp-type": "double"
+        "description": "Percentage value (0.0 to 100.0)"
       },
       "Common.Port": {
         "type": "integer",
         "format": "int32",
         "minimum": 1,
         "maximum": 65535,
-        "description": "Network port number (1-65535)",
-        "x-csharp-type": "int"
+        "description": "Network port number (1-65535)"
       },
       "Common.Ratio": {
         "type": "number",
         "format": "double",
         "minimum": 0,
         "maximum": 1,
-        "description": "Ratio value (0.0 to 1.0)",
-        "x-csharp-type": "double"
+        "description": "Ratio value (0.0 to 1.0)"
       },
       "Common.SemVer": {
         "type": "string",
@@ -13910,7 +13901,8 @@
         "type": "string",
         "minLength": 1,
         "maxLength": 128,
-        "description": "Unique session identifier"
+        "pattern": "^(?!\\.+$)[A-Za-z0-9._~-]{1,128}$",
+        "description": "Unique session identifier: URL-safe characters, at least one, at most 128, not only dots. The same rule the SDK enforces on the baggage header."
       },
       "Common.Sha256Hash": {
         "type": "string",
@@ -13934,8 +13926,7 @@
         "format": "double",
         "minimum": 0,
         "maximum": 2,
-        "description": "Temperature setting for LLM requests (0.0-2.0)",
-        "x-csharp-type": "double"
+        "description": "Temperature setting for LLM requests (0.0-2.0)"
       },
       "Common.Timestamp": {
         "type": "string",
@@ -13946,8 +13937,7 @@
         "type": "integer",
         "format": "int64",
         "minimum": 0,
-        "description": "Token count (for LLM operations)",
-        "x-csharp-type": "long"
+        "description": "Token count (for LLM operations)"
       },
       "Common.TraceId": {
         "type": "string",
@@ -13978,8 +13968,7 @@
         "type": "string",
         "format": "uint64",
         "minimum": 0,
-        "description": "Unsigned Unix timestamp in nanoseconds since epoch, encoded as a decimal string",
-        "x-csharp-type": "ulong"
+        "description": "Unsigned Unix timestamp in nanoseconds since epoch, encoded as a decimal string"
       },
       "Common.UrlPath": {
         "type": "string",
@@ -14160,8 +14149,7 @@
         "unevaluatedProperties": {
           "not": {}
         },
-        "description": "Complete session entity with aggregated data",
-        "x-csharp-type": "SessionEntity"
+        "description": "Complete session entity with aggregated data"
       },
       "Domains.Observe.Session.SessionEvent": {
         "type": "object",

package/generated/runtime/index.d.ts

@@ -1,4 +1,5 @@
 import type { AttributeValue } from "@ancplua/qyl-api-schema/types";
+export * from "./time.js";
 export { AttributeObjectValueTags, isAttributeObjectValue, matchAttributeValue, } from "../../generated/ts-runtime/runtime.js";
 export type { AttributeObjectValueTag, AttributeValueHandlers } from "../../generated/ts-runtime/runtime.js";
 /** An AttributeValue with the wire tags removed: what a reader sees, not how it travelled. */

package/generated/runtime/index.js

@@ -1,4 +1,5 @@
 import { matchAttributeValue } from "../../generated/ts-runtime/runtime.js";
+export * from "./time.js";
 export { AttributeObjectValueTags, isAttributeObjectValue, matchAttributeValue, } from "../../generated/ts-runtime/runtime.js";
 /** Strip the tags. int64 stays text so no digit is lost; bytes stay marked so they never read as a string. */
 export function decodeAttributeValue(value) {

package/generated/runtime/time.d.ts

@@ -0,0 +1,12 @@
+/** The exact nanosecond count. */
+export declare function parseUnixNanos(nanos: string): bigint;
+/** Ascending comparator, exact at nanosecond resolution. */
+export declare function compareUnixNanos(a: string, b: string): number;
+/** Exact nanosecond delta as a number; safe for any span shorter than about 104 days. */
+export declare function unixNanosDelta(fromNanos: string, toNanos: string): number;
+/** Epoch milliseconds, floored in BigInt so no precision is assumed. */
+export declare function unixNanosToEpochMs(nanos: string): number;
+/** ISO-8601 at millisecond resolution. */
+export declare function unixNanosToIso(nanos: string): string;
+/** The wire form of an epoch-millisecond instant. */
+export declare function epochMsToUnixNanos(epochMs: number): string;

package/generated/runtime/time.js

@@ -0,0 +1,29 @@
+// Absolute wire timestamps are unsigned 64-bit nanosecond counts encoded as decimal strings.
+// They exceed Number.MAX_SAFE_INTEGER, so every operation goes through BigInt and only the
+// millisecond result is a number.
+/** The exact nanosecond count. */
+export function parseUnixNanos(nanos) {
+    return BigInt(nanos);
+}
+/** Ascending comparator, exact at nanosecond resolution. */
+export function compareUnixNanos(a, b) {
+    const left = BigInt(a);
+    const right = BigInt(b);
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** Exact nanosecond delta as a number; safe for any span shorter than about 104 days. */
+export function unixNanosDelta(fromNanos, toNanos) {
+    return Number(BigInt(toNanos) - BigInt(fromNanos));
+}
+/** Epoch milliseconds, floored in BigInt so no precision is assumed. */
+export function unixNanosToEpochMs(nanos) {
+    return Number(BigInt(nanos) / 1000000n);
+}
+/** ISO-8601 at millisecond resolution. */
+export function unixNanosToIso(nanos) {
+    return new Date(unixNanosToEpochMs(nanos)).toISOString();
+}
+/** The wire form of an epoch-millisecond instant. */
+export function epochMsToUnixNanos(epochMs) {
+    return (BigInt(Math.round(epochMs)) * 1000000n).toString();
+}

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

@@ -1,12 +1,18 @@
 export type TraceId = string & {
     readonly __brand: "TraceId";
 };
+export declare function isTraceId(value: string): value is TraceId;
+export declare function parseTraceId(value: string): TraceId;
 export type SpanId = string & {
     readonly __brand: "SpanId";
 };
+export declare function isSpanId(value: string): value is SpanId;
+export declare function parseSpanId(value: string): SpanId;
 export type SessionId = string & {
     readonly __brand: "SessionId";
 };
+export declare function isSessionId(value: string): value is SessionId;
+export declare function parseSessionId(value: string): SessionId;
 export type UserId = string & {
     readonly __brand: "UserId";
 };

package/generated/ts-runtime/api.js

@@ -1,5 +1,32 @@
 // <auto-generated/>
 // Copyright (c) 2025-2026 ancplua
+const TraceIdPattern = new RegExp("^[a-f0-9]{32}$", "u");
+export function isTraceId(value) {
+    return TraceIdPattern.test(value);
+}
+export function parseTraceId(value) {
+    if (!isTraceId(value))
+        throw new TypeError(`Not a TraceId: ${JSON.stringify(value)}`);
+    return value;
+}
+const SpanIdPattern = new RegExp("^[a-f0-9]{16}$", "u");
+export function isSpanId(value) {
+    return SpanIdPattern.test(value);
+}
+export function parseSpanId(value) {
+    if (!isSpanId(value))
+        throw new TypeError(`Not a SpanId: ${JSON.stringify(value)}`);
+    return value;
+}
+const SessionIdPattern = new RegExp("^(?!\\.+$)[A-Za-z0-9._~-]{1,128}$", "u");
+export function isSessionId(value) {
+    return SessionIdPattern.test(value);
+}
+export function parseSessionId(value) {
+    if (!isSessionId(value))
+        throw new TypeError(`Not a SessionId: ${JSON.stringify(value)}`);
+    return value;
+}
 export const ProblemDetailsMediaType = "application/problem+json";
 export const SortOrderValues = {
     "asc": "asc",
@@ -320,4 +347,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:5c1aa27ccdf48067";
+export const CONTRACT_REVISION = "sha256:75278211aa54def8";