@ancplua/qyl-api-schema 7.1.0 → 7.3.0

package/common/types.tsp

@@ -2,8 +2,7 @@
 // qyl common types and scalars
 // =============================================================================
 // Foundational types used across qyl API contracts and OTel-compatible models.
-// OpenTelemetry semantic-convention references are pinned to core v1.43.0
-// (GenAI keys come from the dedicated GenAI registry since the 1.42 split).
+// OpenTelemetry registry provenance is owned by generated/otel-keys.gen.tsp.
 // =============================================================================
 
 import "@typespec/openapi";

package/generated/otel-keys.gen.tsp

@@ -1,8 +1,8 @@
 // <auto-generated/>
 // Generated by qyl's Weaver pipeline (emit_typespec_keys.py) from:
-//   open-telemetry/semantic-conventions v1.43.0 (89aae438b3b3b0a8dd33003c9d70592baf7dbd0d)
-//   open-telemetry/semantic-conventions-genai f77b9235f2ad49fe95b61e9809ca82bb08ef9d47 (f77b9235f2ad49fe95b61e9809ca82bb08ef9d47)
-// Schema: https://opentelemetry.io/schemas/1.43.0
+//   open-telemetry/semantic-conventions v1.44.0 (e10a930844c6951757a43b849d364f7d056ac32b)
+//   open-telemetry/semantic-conventions-genai eaefa142a94cefe5d199d47e4a73727dfbd825df (eaefa142a94cefe5d199d47e4a73727dfbd825df)
+// Schema: https://opentelemetry.io/schemas/1.44.0
 // GenAI schema: https://opentelemetry.io/schemas/gen-ai-dev/1.42.0-dev
 // Licensed under Apache-2.0 (inherited from OpenTelemetry upstream)
 // </auto-generated>
@@ -15,7 +15,7 @@
 namespace Qyl.Telemetry.SemanticConventions.Keys.Android {
   /** This attribute represents the state of the application. */
   const AppState: string = "android.app.state";
-  /** Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). */
+  /** Uniquely identifies the framework API revision offered by a version (`os.version`) of the Android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). */
   const OsApiLevel: string = "android.os.api_level";
   /** Deprecated. Use `android.app.state` attribute instead. */
   #deprecated "Replaced by android.app.state."
@@ -24,7 +24,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Android {
 namespace Qyl.Telemetry.SemanticConventions.Keys.App {
   /** Unique identifier for a particular build or compilation of the application. */
   const BuildId: string = "app.build_id";
-  /** A unique identifier representing an instance of an end-user facing app crash. */
+  /** A unique identifier representing an instance of an end user facing app crash. */
   const CrashId: string = "app.crash.id";
   /** A unique identifier representing the installation of an application on a specific device */
   const InstallationId: string = "app.installation.id";
@@ -52,9 +52,9 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Artifact {
   const AttestationFilename: string = "artifact.attestation.filename";
   /** The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), of the built attestation. Some envelopes in the [software attestation space](https://github.com/in-toto/attestation/tree/main/spec) also refer to this as the **digest**. */
   const AttestationHash: string = "artifact.attestation.hash";
-  /** The id of the build [software attestation](https://slsa.dev/attestation-model). */
+  /** The ID of the build [software attestation](https://slsa.dev/attestation-model). */
   const AttestationId: string = "artifact.attestation.id";
-  /** The human readable file name of the artifact, typically generated during build and release processes. Often includes the package name and version in the file name. */
+  /** The human readable filename of the artifact, typically generated during build and release processes. Often includes the package name and version in the filename. */
   const Filename: string = "artifact.filename";
   /** The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), often found in checksum.txt on a release of the artifact and used to verify package integrity. */
   const Hash: string = "artifact.hash";
@@ -258,6 +258,18 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Browser {
   const Mobile: string = "browser.mobile";
   /** The platform on which the browser is running */
   const Platform: string = "browser.platform";
+  /** The delta between the current value and the last-reported value. See [delta](https://github.com/GoogleChrome/web-vitals?tab=readme-ov-file#report-only-the-delta-of-changes). */
+  const WebVitalDelta: string = "browser.web_vital.delta";
+  /** A unique ID representing this particular metric instance. */
+  const WebVitalId: string = "browser.web_vital.id";
+  /** Name of the web vital. */
+  const WebVitalName: string = "browser.web_vital.name";
+  /** The type of navigation, as reported by the [Navigation Timing API](https://developer.mozilla.org/docs/Web/API/PerformanceNavigationTiming/type), with additional values reported by the web-vitals library. */
+  const WebVitalNavigationType: string = "browser.web_vital.navigation_type";
+  /** The rating of the web vital value against the "good", "needs improvement", and "poor" thresholds defined for the metric. */
+  const WebVitalRating: string = "browser.web_vital.rating";
+  /** Value of the web vital. */
+  const WebVitalValue: string = "browser.web_vital.value";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Cassandra {
   /** The consistency level of the query. Based on consistency values from [CQL](https://docs.datastax.com/en/cassandra-oss/3.0/cassandra/dml/dmlConfigConsistency.html). */
@@ -308,7 +320,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Cicd {
   const WorkerUrlFull: string = "cicd.worker.url.full";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Client {
-  /** Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Client address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "client.address";
   /** Client port number. */
   const Port: string = "client.port";
@@ -369,7 +381,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Code {
   const Column: string = "code.column";
   /** The column number in `code.file.path` best representing the operation. It SHOULD point within the code unit named in `code.function.name`. This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Line'. This constraint is imposed to prevent redundancy and maintain data integrity. */
   const ColumnNumber: string = "code.column.number";
-  /** The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity. */
+  /** The source code filename that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity. */
   const FilePath: string = "code.file.path";
   /** Deprecated, use `code.file.path` instead */
   #deprecated "Replaced by code.file.path."
@@ -410,7 +422,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Container {
   const ImageId: string = "container.image.id";
   /** Name of the image the container was built on. */
   const ImageName: string = "container.image.name";
-  /** Repo digests of the container image as provided by the container runtime. */
+  /** Repository digests of the container image as provided by the container runtime. */
   const ImageRepoDigests: string = "container.image.repo_digests";
   /** Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect). Should be only the `<tag>` section of the full name for example from `registry.example.com/my-org/my-image:<tag>`. */
   const ImageTags: string = "container.image.tags";
@@ -550,7 +562,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Db {
   /** The database query being executed. */
   const QueryText: string = "db.query.text";
   /** Deprecated, use `db.namespace` instead. */
-  #deprecated "Uncategorized."
+  #deprecated "Replaced by `db.namespace` (string)."
   const RedisDatabaseIndex: string = "db.redis.database_index";
   /** Number of rows returned by the operation. */
   const ResponseReturnedRows: string = "db.response.returned_rows";
@@ -579,7 +591,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Deployment {
   const Environment: string = "deployment.environment";
   /** Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). */
   const EnvironmentName: string = "deployment.environment.name";
-  /** The id of the deployment. */
+  /** The ID of the deployment. */
   const Id: string = "deployment.id";
   /** The name of the deployment. */
   const Name: string = "deployment.name";
@@ -587,7 +599,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Deployment {
   const Status: string = "deployment.status";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Destination {
-  /** Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "destination.address";
   /** Destination port number */
   const Port: string = "destination.port";
@@ -755,7 +767,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.File {
   const OwnerId: string = "file.owner.id";
   /** Username of the file owner. */
   const OwnerName: string = "file.owner.name";
-  /** Full path to the file, including the file name. It should include the drive letter, when appropriate. */
+  /** Full path to the file, including the filename. It should include the drive letter, when appropriate. */
   const Path: string = "file.path";
   /** File size in bytes. */
   const Size: string = "file.size";
@@ -933,16 +945,34 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.GenAi {
   const ToolName: string = "gen_ai.tool.name";
   /** Type of the tool utilized by the agent */
   const ToolType: string = "gen_ai.tool.type";
-  /** The number of input tokens written to a provider-managed cache. */
-  const UsageCacheCreationInputTokens: string = "gen_ai.usage.cache_creation.input_tokens";
+  /** The number of audio input tokens served from a provider-managed cache. */
+  const UsageAudioCacheReadInputTokens: string = "gen_ai.usage.audio.cache_read.input_tokens";
+  /** The number of audio input tokens. */
+  const UsageAudioInputTokens: string = "gen_ai.usage.audio.input_tokens";
+  /** The number of audio output tokens. */
+  const UsageAudioOutputTokens: string = "gen_ai.usage.audio.output_tokens";
   /** The number of input tokens served from a provider-managed cache. */
   const UsageCacheReadInputTokens: string = "gen_ai.usage.cache_read.input_tokens";
+  /** The number of input tokens written to a provider-managed cache. */
+  const UsageCacheWriteInputTokens: string = "gen_ai.usage.cache_write.input_tokens";
+  /** The number of image input tokens served from a provider-managed cache. */
+  const UsageImageCacheReadInputTokens: string = "gen_ai.usage.image.cache_read.input_tokens";
+  /** The number of image input tokens. */
+  const UsageImageInputTokens: string = "gen_ai.usage.image.input_tokens";
+  /** The number of image output tokens. */
+  const UsageImageOutputTokens: string = "gen_ai.usage.image.output_tokens";
   /** The number of tokens used in the GenAI input (prompt). */
   const UsageInputTokens: string = "gen_ai.usage.input_tokens";
   /** The number of tokens used in the GenAI response (completion). */
   const UsageOutputTokens: string = "gen_ai.usage.output_tokens";
   /** The number of output tokens used for reasoning (e.g. chain-of-thought, extended thinking). */
   const UsageReasoningOutputTokens: string = "gen_ai.usage.reasoning.output_tokens";
+  /** The number of text input tokens served from a provider-managed cache. */
+  const UsageTextCacheReadInputTokens: string = "gen_ai.usage.text.cache_read.input_tokens";
+  /** The number of text input tokens. */
+  const UsageTextInputTokens: string = "gen_ai.usage.text.input_tokens";
+  /** The number of text output tokens. */
+  const UsageTextOutputTokens: string = "gen_ai.usage.text.output_tokens";
   /** Human-readable name of the GenAI workflow provided by the application. */
   const WorkflowName: string = "gen_ai.workflow.name";
 }
@@ -1015,7 +1045,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Host {
   const Ip: string = "host.ip";
   /** Available MAC addresses of the host, excluding loopback interfaces. */
   const Mac: string = "host.mac";
-  /** Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. */
+  /** Name of the host. On UNIX systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. */
   const Name: string = "host.name";
   /** Type of host. For Cloud, this must be the machine type. */
   const Type: string = "host.type";
@@ -1439,17 +1469,19 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Messaging {
   const EventhubsMessageEnqueuedTime: string = "messaging.eventhubs.message.enqueued_time";
   /** The ack deadline in seconds set for the modify ack deadline request. */
   const GcpPubsubMessageAckDeadline: string = "messaging.gcp_pubsub.message.ack_deadline";
-  /** The ack id for a given message. */
+  /** The ack ID for a given message. */
   const GcpPubsubMessageAckId: string = "messaging.gcp_pubsub.message.ack_id";
   /** The delivery attempt for a given message. */
   const GcpPubsubMessageDeliveryAttempt: string = "messaging.gcp_pubsub.message.delivery_attempt";
   /** The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. */
   const GcpPubsubMessageOrderingKey: string = "messaging.gcp_pubsub.message.ordering_key";
+  /** The Kafka cluster ID, obtained from the broker metadata exposed through the Kafka client (or AdminClient) API. */
+  const KafkaClusterId: string = "messaging.kafka.cluster.id";
   /** Deprecated, use `messaging.consumer.group.name` instead. */
   #deprecated "Replaced by messaging.consumer.group.name."
   const KafkaConsumerGroup: string = "messaging.kafka.consumer.group";
   /** Deprecated, use `messaging.destination.partition.id` instead. */
-  #deprecated "Record string representation of the partition id in `messaging.destination.partition.id` attribute."
+  #deprecated "Record string representation of the partition ID in `messaging.destination.partition.id` attribute."
   const KafkaDestinationPartition: string = "messaging.kafka.destination.partition";
   /** Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. */
   const KafkaMessageKey: string = "messaging.kafka.message.key";
@@ -1490,7 +1522,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Messaging {
   const RocketmqMessageDeliveryTimestamp: string = "messaging.rocketmq.message.delivery_timestamp";
   /** It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. */
   const RocketmqMessageGroup: string = "messaging.rocketmq.message.group";
-  /** Key(s) of message, another way to mark message besides message id. */
+  /** Key(s) of message, another way to mark message besides message ID. */
   const RocketmqMessageKeys: string = "messaging.rocketmq.message.keys";
   /** The secondary classifier of message besides topic. */
   const RocketmqMessageTag: string = "messaging.rocketmq.message.tag";
@@ -1568,7 +1600,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Network {
   const CarrierName: string = "network.carrier.name";
   /** The state of network connection */
   const ConnectionState: string = "network.connection.state";
-  /** This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. */
+  /** This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a Wi-Fi connection. */
   const ConnectionSubtype: string = "network.connection.subtype";
   /** The internet connection type. */
   const ConnectionType: string = "network.connection.type";
@@ -1576,11 +1608,11 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Network {
   const InterfaceName: string = "network.interface.name";
   /** The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. */
   const IoDirection: string = "network.io.direction";
-  /** Local address of the network connection - IP address or Unix domain socket name. */
+  /** Local address of the network connection - IP address or UNIX domain socket name. */
   const LocalAddress: string = "network.local.address";
   /** Local port number of the network connection. */
   const LocalPort: string = "network.local.port";
-  /** Peer address of the network connection - IP address or Unix domain socket name. */
+  /** Peer address of the network connection - IP address or UNIX domain socket name. */
   const PeerAddress: string = "network.peer.address";
   /** Peer port number of the network connection. */
   const PeerPort: string = "network.peer.port";
@@ -1718,9 +1750,9 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Pprof {
   const ProfileComment: string = "pprof.profile.comment";
   /** Documentation link for this profile type. */
   const ProfileDocUrl: string = "pprof.profile.doc_url";
-  /** Frames with Function.function_name fully matching the regexp will be dropped from the samples, along with their successors. */
+  /** Frames with Function.function_name fully matching the regular expression will be dropped from the samples, along with their successors. */
   const ProfileDropFrames: string = "pprof.profile.drop_frames";
-  /** Frames with Function.function_name fully matching the regexp will be kept, even if it matches drop_frames. */
+  /** Frames with Function.function_name fully matching the regular expression will be kept, even if it matches drop_frames. */
   const ProfileKeepFrames: string = "pprof.profile.keep_frames";
   /** Records the pprof's default_sample_type in the original profile. Not set if the default sample type was missing. */
   const ScopeDefaultSampleType: string = "pprof.scope.default_sample_type";
@@ -1891,7 +1923,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.SecurityRule {
   const Version: string = "security_rule.version";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Server {
-  /** Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Server domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "server.address";
   /** Server port number. */
   const Port: string = "server.port";
@@ -1913,7 +1945,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Service {
   const Version: string = "service.version";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Session {
-  /** A unique id to identify a session. */
+  /** A unique ID to identify a session. */
   const Id: string = "session.id";
   /** The previous `session.id` for this user, when known. */
   const PreviousId: string = "session.previous_id";
@@ -1925,7 +1957,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Signalr {
   const Transport: string = "signalr.transport";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Source {
-  /** Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Source address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "source.address";
   /** Source port number */
   const Port: string = "source.port";
@@ -2083,11 +2115,11 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Url {
   const Port: string = "url.port";
   /** The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component */
   const Query: string = "url.query";
-  /** The highest registered url domain, stripped of the subdomain. */
+  /** The highest registered URL domain, stripped of the subdomain. */
   const RegisteredDomain: string = "url.registered_domain";
   /** The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. */
   const Scheme: string = "url.scheme";
-  /** The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. */
+  /** The subdomain portion of a fully qualified domain name includes all of the names except the hostname under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. */
   const Subdomain: string = "url.subdomain";
   /** The low-cardinality template of an [absolute path reference](https://www.rfc-editor.org/rfc/rfc3986#section-4.2). */
   const Template: string = "url.template";

package/generated/ts-runtime/api.js

@@ -445,4 +445,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:72545708596baccd";
+export const CONTRACT_REVISION = "sha256:a11cb761a9cb6534";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "7.1.0",
+  "version": "7.3.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": {
@@ -132,13 +132,13 @@
     "@ancplua/typespec-emit-csharp": "file:./emitters/csharp",
     "@ancplua/typespec-emit-ts-types": "file:./emitters/ts-types",
     "@ancplua/typespec-qyl-lint": "file:./emitters/qyl-lint",
-    "@types/node": "26.1.1",
-    "@typespec/compiler": "1.14.0",
-    "@typespec/events": "0.84.0",
-    "@typespec/http": "1.14.0",
-    "@typespec/openapi": "1.14.0",
-    "@typespec/openapi3": "1.14.0",
-    "@typespec/sse": "0.84.0",
+    "@types/node": "26.2.0",
+    "@typespec/compiler": "1.15.0",
+    "@typespec/events": "0.85.0",
+    "@typespec/http": "1.15.0",
+    "@typespec/openapi": "1.15.0",
+    "@typespec/openapi3": "1.15.0",
+    "@typespec/sse": "0.85.0",
     "ajv": "8.20.0",
     "typescript": "7.0.2"
   }