@ancplua/qyl-api-schema 3.0.0 → 4.0.0

package/common/types.tsp

@@ -178,6 +178,18 @@ scalar Temperature extends float64;
 @maxLength(64)
 scalar Sha256Hash extends string;
 
+// The revision is a content hash of the emitted OpenAPI artifact, not a package
+// version: two builds of the same contract share it whatever their package
+// versions say, and any contract edit changes it without anyone remembering to
+// bump anything. Truncated to 16 hex characters because it is compared for
+// equality, never used as a security boundary.
+@doc("Deterministic revision of the generated API contract: 'sha256:' followed by the first 16 hex characters of the SHA-256 digest of the emitted OpenAPI document.")
+@pattern("^sha256:[a-f0-9]{16}$")
+@minLength(23)
+@maxLength(23)
+@example("sha256:0f1e2d3c4b5a6978")
+scalar ContractRevision extends string;
+
 @doc("Semantic version string (e.g., 1.2.3)")
 @pattern("^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$")
 @example("2.1.0")

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

@@ -207,6 +207,16 @@
         "application/json"
       ]
     },
+    "Common.ContractRevision": {
+      "type": "string",
+      "minLength": 23,
+      "maxLength": 23,
+      "pattern": "^sha256:[a-f0-9]{16}$",
+      "description": "Deterministic revision of the generated API contract: 'sha256:' followed by the first 16 hex characters of the SHA-256 digest of the emitted OpenAPI document.",
+      "examples": [
+        "sha256:0f1e2d3c4b5a6978"
+      ]
+    },
     "Common.CostUsd": {
       "type": "number",
       "format": "double",
@@ -1362,7 +1372,8 @@
       "required": [
         "status",
         "total_duration_ms",
-        "entries"
+        "entries",
+        "contract_revision"
       ],
       "properties": {
         "status": {
@@ -1377,6 +1388,10 @@
           "unevaluatedProperties": {
             "$ref": "#/$defs/Health.HealthCheckEntry"
           }
+        },
+        "contract_revision": {
+          "$ref": "#/$defs/Common.ContractRevision",
+          "description": "Revision of the API contract this process serves, for the client-side startup handshake."
         }
       },
       "unevaluatedProperties": {
@@ -1393,6 +1408,141 @@
       ],
       "description": "Health state reported by a qyl-managed process."
     },
+    "Mcp.Tools.CiLogInput": {
+      "type": "object",
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Common.SessionId",
+          "description": "Session id of one CI run for a per-leg phase breakdown; omit to list recent runs."
+        },
+        "limit": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 1,
+          "maximum": 50,
+          "description": "Maximum CI runs to list.",
+          "default": 10
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Input for ci_log."
+    },
+    "Mcp.Tools.CiLogOutput": {
+      "type": "object",
+      "required": [
+        "mode"
+      ],
+      "properties": {
+        "runs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Mcp.Tools.CiRunSummary"
+          }
+        },
+        "run_id": {
+          "$ref": "#/$defs/Common.SessionId"
+        },
+        "phases": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Mcp.Tools.CiPhase"
+          }
+        },
+        "mode": {
+          "$ref": "#/$defs/Mcp.Tools.McpDataMode"
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "Structured output for ci_log: recent runs, or one run's phases."
+    },
+    "Mcp.Tools.CiPhase": {
+      "type": "object",
+      "required": [
+        "leg",
+        "phase",
+        "status",
+        "duration_ms"
+      ],
+      "properties": {
+        "leg": {
+          "type": "string",
+          "description": "Value of the span's ci.leg attribute, falling back to its service name."
+        },
+        "phase": {
+          "type": "string",
+          "description": "Span name, which the CI emitter convention sets to the phase name."
+        },
+        "status": {
+          "$ref": "#/$defs/Mcp.Tools.CiPhaseStatus"
+        },
+        "duration_ms": {
+          "$ref": "#/$defs/Common.DurationMs"
+        },
+        "message": {
+          "type": "string",
+          "description": "Span status message, present on a failed phase."
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "One phase span of a CI run, attributed to the leg that executed it."
+    },
+    "Mcp.Tools.CiPhaseStatus": {
+      "type": "string",
+      "enum": [
+        "ok",
+        "error",
+        "unset"
+      ],
+      "description": "Outcome of one CI phase span, projected from its OpenTelemetry span status."
+    },
+    "Mcp.Tools.CiRunSummary": {
+      "type": "object",
+      "required": [
+        "run_id",
+        "state",
+        "start_time",
+        "error_count",
+        "services"
+      ],
+      "properties": {
+        "run_id": {
+          "$ref": "#/$defs/Common.SessionId"
+        },
+        "state": {
+          "$ref": "#/$defs/Domains.Observe.Session.SessionState"
+        },
+        "start_time": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "duration_ms": {
+          "$ref": "#/$defs/Common.DurationMs"
+        },
+        "error_count": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "description": "Spans in the run that ended with an error status."
+        },
+        "services": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Service names observed in the run, at least one of which is CI-emitted."
+        }
+      },
+      "unevaluatedProperties": {
+        "not": {}
+      },
+      "description": "One CI run, summarized from the session its telemetry is grouped under."
+    },
     "Mcp.Tools.DisplayMcpDashboardInput": {
       "type": "object",
       "properties": {

package/generated/openapi/qyl.openapi.json

@@ -12558,6 +12558,16 @@
           "application/json"
         ]
       },
+      "Common.ContractRevision": {
+        "type": "string",
+        "minLength": 23,
+        "maxLength": 23,
+        "pattern": "^sha256:[a-f0-9]{16}$",
+        "description": "Deterministic revision of the generated API contract: 'sha256:' followed by the first 16 hex characters of the SHA-256 digest of the emitted OpenAPI document.",
+        "examples": [
+          "sha256:0f1e2d3c4b5a6978"
+        ]
+      },
       "Common.CostUsd": {
         "type": "number",
         "format": "double",
@@ -13711,7 +13721,8 @@
         "required": [
           "status",
           "total_duration_ms",
-          "entries"
+          "entries",
+          "contract_revision"
         ],
         "properties": {
           "status": {
@@ -13726,6 +13737,10 @@
             "unevaluatedProperties": {
               "$ref": "#/components/schemas/Health.HealthCheckEntry"
             }
+          },
+          "contract_revision": {
+            "$ref": "#/components/schemas/Common.ContractRevision",
+            "description": "Revision of the API contract this process serves, for the client-side startup handshake."
           }
         },
         "unevaluatedProperties": {
@@ -13742,6 +13757,141 @@
         ],
         "description": "Health state reported by a qyl-managed process."
       },
+      "Mcp.Tools.CiLogInput": {
+        "type": "object",
+        "properties": {
+          "run_id": {
+            "$ref": "#/components/schemas/Common.SessionId",
+            "description": "Session id of one CI run for a per-leg phase breakdown; omit to list recent runs."
+          },
+          "limit": {
+            "type": "integer",
+            "format": "int32",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "Maximum CI runs to list.",
+            "default": 10
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "Input for ci_log."
+      },
+      "Mcp.Tools.CiLogOutput": {
+        "type": "object",
+        "required": [
+          "mode"
+        ],
+        "properties": {
+          "runs": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Mcp.Tools.CiRunSummary"
+            }
+          },
+          "run_id": {
+            "$ref": "#/components/schemas/Common.SessionId"
+          },
+          "phases": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Mcp.Tools.CiPhase"
+            }
+          },
+          "mode": {
+            "$ref": "#/components/schemas/Mcp.Tools.McpDataMode"
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "Structured output for ci_log: recent runs, or one run's phases."
+      },
+      "Mcp.Tools.CiPhase": {
+        "type": "object",
+        "required": [
+          "leg",
+          "phase",
+          "status",
+          "duration_ms"
+        ],
+        "properties": {
+          "leg": {
+            "type": "string",
+            "description": "Value of the span's ci.leg attribute, falling back to its service name."
+          },
+          "phase": {
+            "type": "string",
+            "description": "Span name, which the CI emitter convention sets to the phase name."
+          },
+          "status": {
+            "$ref": "#/components/schemas/Mcp.Tools.CiPhaseStatus"
+          },
+          "duration_ms": {
+            "$ref": "#/components/schemas/Common.DurationMs"
+          },
+          "message": {
+            "type": "string",
+            "description": "Span status message, present on a failed phase."
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "One phase span of a CI run, attributed to the leg that executed it."
+      },
+      "Mcp.Tools.CiPhaseStatus": {
+        "type": "string",
+        "enum": [
+          "ok",
+          "error",
+          "unset"
+        ],
+        "description": "Outcome of one CI phase span, projected from its OpenTelemetry span status."
+      },
+      "Mcp.Tools.CiRunSummary": {
+        "type": "object",
+        "required": [
+          "run_id",
+          "state",
+          "start_time",
+          "error_count",
+          "services"
+        ],
+        "properties": {
+          "run_id": {
+            "$ref": "#/components/schemas/Common.SessionId"
+          },
+          "state": {
+            "$ref": "#/components/schemas/Domains.Observe.Session.SessionState"
+          },
+          "start_time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "duration_ms": {
+            "$ref": "#/components/schemas/Common.DurationMs"
+          },
+          "error_count": {
+            "type": "integer",
+            "format": "int32",
+            "minimum": 0,
+            "description": "Spans in the run that ended with an error status."
+          },
+          "services": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Service names observed in the run, at least one of which is CI-emitted."
+          }
+        },
+        "unevaluatedProperties": {
+          "not": {}
+        },
+        "description": "One CI run, summarized from the session its telemetry is grouped under."
+      },
       "Mcp.Tools.DisplayMcpDashboardInput": {
         "type": "object",
         "properties": {

package/generated/otel-keys.gen.tsp

@@ -1,18 +1,18 @@
 // <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 74fd2e0f77267ce26d55cf8991200df5a265ef74 (74fd2e0f77267ce26d55cf8991200df5a265ef74)
+//   open-telemetry/semantic-conventions-genai 64cfaa612a1af8472b2f063374fbe3c9e6cea2ab (64cfaa612a1af8472b2f063374fbe3c9e6cea2ab)
 // Schema: https://opentelemetry.io/schemas/1.43.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>
 //
 // DO NOT EDIT THIS FILE.
-// Regenerate: Qyl.OpenTelemetry.SemanticConventions repo →
+// Regenerate: Qyl.Telemetry.SemanticConventions repo →
 //   src/…SourceGeneration/scripts/generate.sh   (refresh resolved-registry.json)
 //   src/…SourceGeneration/scripts/emit_typespec_keys.py --write <this file>
 
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Android {
+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). */
@@ -21,7 +21,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Android {
   #deprecated "Replaced by android.app.state."
   const State: string = "android.state";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.App {
+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. */
@@ -47,7 +47,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.App {
   /** The name of an application widget. */
   const WidgetName: string = "app.widget.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Artifact {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Artifact {
   /** The provenance filename of the built attestation which directly relates to the build artifact filename. This filename SHOULD accompany the artifact at publish time. See the [SLSA Relationship](https://slsa.dev/spec/v1.0/distributing-provenance#relationship-between-artifacts-and-attestations) specification for more information. */
   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**. */
@@ -63,7 +63,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Artifact {
   /** The version of the artifact. */
   const Version: string = "artifact.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Aspnetcore {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Aspnetcore {
   /** The result of the authentication operation. */
   const AuthenticationResult: string = "aspnetcore.authentication.result";
   /** The identifier that names a particular authentication handler. */
@@ -111,7 +111,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Aspnetcore {
   /** A value that indicates whether the user is authenticated. */
   const UserIsAuthenticated: string = "aspnetcore.user.is_authenticated";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Aws {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Aws {
   /** The unique identifier of the AWS Bedrock Guardrail. A [guardrail](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) helps safeguard and prevent unwanted behavior from model responses or user messages. */
   const BedrockGuardrailId: string = "aws.bedrock.guardrail.id";
   /** The unique identifier of the AWS Bedrock Knowledge base. A [knowledge base](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html) is a bank of information that can be queried by models to generate more relevant responses and augment prompts. */
@@ -217,7 +217,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Aws {
   /** The ARN of the AWS Step Functions State Machine. */
   const StepFunctionsStateMachineArn: string = "aws.step_functions.state_machine.arn";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Az {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Az {
   /** Deprecated, use `azure.resource_provider.namespace` instead. */
   #deprecated "Replaced by azure.resource_provider.namespace."
   const Namespace: string = "az.namespace";
@@ -225,7 +225,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Az {
   #deprecated "Replaced by azure.service.request.id."
   const ServiceRequestId: string = "az.service_request_id";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Azure {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Azure {
   /** The unique identifier of the client instance. */
   const ClientId: string = "azure.client.id";
   /** Cosmos client connection mode. */
@@ -247,7 +247,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Azure {
   /** The unique identifier of the service request. It's generated by the Azure service and returned with the response. */
   const ServiceRequestId: string = "azure.service.request.id";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Browser {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Browser {
   /** Array of brand name and version separated by a space */
   const Brands: string = "browser.brands";
   /** Absolute URL of the current browser document according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986). */
@@ -259,7 +259,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Browser {
   /** The platform on which the browser is running */
   const Platform: string = "browser.platform";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cassandra {
+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). */
   const ConsistencyLevel: string = "cassandra.consistency.level";
   /** The data center of the coordinating node for a query. */
@@ -273,7 +273,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cassandra {
   /** The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively. */
   const SpeculativeExecutionCount: string = "cassandra.speculative_execution.count";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cicd {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Cicd {
   /** The kind of action a pipeline run is performing. */
   const PipelineActionName: string = "cicd.pipeline.action.name";
   /** The human readable name of the pipeline within a CI/CD system. */
@@ -307,13 +307,13 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cicd {
   /** The [URL](https://wikipedia.org/wiki/URL) of the worker, providing the complete address in order to locate and identify the worker. */
   const WorkerUrlFull: string = "cicd.worker.url.full";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Client {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Client {
   /** 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";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cloud {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Cloud {
   /** The cloud account ID the resource is assigned to. */
   const AccountId: string = "cloud.account.id";
   /** Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running. */
@@ -327,7 +327,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cloud {
   /** Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://google.aip.dev/122#full-resource-names) on GCP) */
   const ResourceId: string = "cloud.resource_id";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cloudevents {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Cloudevents {
   /** The [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id) uniquely identifies the event. */
   const EventId: string = "cloudevents.event_id";
   /** The [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1) identifies the context in which an event happened. */
@@ -339,7 +339,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cloudevents {
   /** The [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type) contains a value describing the type of event related to the originating occurrence. */
   const EventType: string = "cloudevents.event_type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cloudfoundry {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Cloudfoundry {
   /** The guid of the application. */
   const AppId: string = "cloudfoundry.app.id";
   /** The index of the application instance. 0 when just one instance is active. */
@@ -363,7 +363,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cloudfoundry {
   /** A guid describing the concrete instance of the event source. */
   const SystemInstanceId: string = "cloudfoundry.system.instance.id";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Code {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Code {
   /** Deprecated, use `code.column.number` */
   #deprecated "Replaced by code.column.number."
   const Column: string = "code.column";
@@ -390,7 +390,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Code {
   /** A stacktrace as a string in the natural representation for the language runtime. The representation is identical to [`exception.stacktrace`](/docs/exceptions/exceptions-spans.md#stacktrace-representation). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Location'. This constraint is imposed to prevent redundancy and maintain data integrity. */
   const Stacktrace: string = "code.stacktrace";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Container {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Container {
   /** The command used to run the container (i.e. the command name). */
   const Command: string = "container.command";
   /** All the command arguments (including the command/executable itself) run by the container. */
@@ -431,17 +431,17 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Container {
   /** The version of the runtime of this process, as returned by the runtime without modification. */
   const RuntimeVersion: string = "container.runtime.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cpu {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Cpu {
   /** The logical CPU number [0..n-1] */
   const LogicalNumber: string = "cpu.logical_number";
   /** The mode of the CPU */
   const Mode: string = "cpu.mode";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Cpython {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Cpython {
   /** Value of the garbage collector collection generation. */
   const GcGeneration: string = "cpython.gc.generation";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Db {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Db {
   /** Deprecated, use `cassandra.consistency.level` instead. */
   #deprecated "Replaced by cassandra.consistency.level."
   const CassandraConsistencyLevel: string = "db.cassandra.consistency_level";
@@ -573,7 +573,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Db {
   #deprecated "Removed, no replacement."
   const User: string = "db.user";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Deployment {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Deployment {
   /** Deprecated, use `deployment.environment.name` instead. */
   #deprecated "Replaced by deployment.environment.name."
   const Environment: string = "deployment.environment";
@@ -586,13 +586,13 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Deployment {
   /** The status of the deployment. */
   const Status: string = "deployment.status";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Destination {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Destination {
   /** 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";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Device {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Device {
   /** A unique identifier representing the device */
   const Id: string = "device.id";
   /** The name of the device manufacturer */
@@ -602,25 +602,25 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Device {
   /** The marketing name for the device model */
   const ModelName: string = "device.model.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Disk {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Disk {
   /** The disk IO operation direction. */
   const IoDirection: string = "disk.io.direction";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Dns {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Dns {
   /** The list of IPv4 or IPv6 addresses resolved during DNS lookup. */
   const Answers: string = "dns.answers";
   /** The name being queried. */
   const QuestionName: string = "dns.question.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Dotnet {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Dotnet {
   /** Name of the garbage collector managed heap generation. */
   const GcHeapGeneration: string = "dotnet.gc.heap.generation";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Elasticsearch {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Elasticsearch {
   /** Represents the human-readable identifier of the node/instance to which a request was routed. */
   const NodeName: string = "elasticsearch.node.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Enduser {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Enduser {
   /** Unique identifier of an end user in the system. It maybe a username, email address, or other identifier. */
   const Id: string = "enduser.id";
   /** Pseudonymous identifier of an end user. This identifier should be a random value that is not directly linked or associated with the end user's actual identity. */
@@ -632,19 +632,19 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Enduser {
   #deprecated "Removed, no replacement."
   const Scope: string = "enduser.scope";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Error {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Error {
   /** A message providing more detail about an error in human-readable form. */
   #deprecated "Removed, no replacement."
   const Message: string = "error.message";
   /** Describes a class of error the operation ended with. */
   const Type: string = "error.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Event {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Event {
   /** Identifies the class / type of event. */
   #deprecated "The value of this attribute MUST now be set as the value of the EventName field on the LogRecord to indicate that the LogRecord represents an Event."
   const Name: string = "event.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Exception {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Exception {
   /** Indicates that the exception is escaping the scope of the span. */
   #deprecated "Removed, no replacement."
   const Escaped: string = "exception.escaped";
@@ -655,7 +655,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Exception {
   /** The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. */
   const Type: string = "exception.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Faas {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Faas {
   /** A boolean that is true if the serverless function is executed for the first time (aka cold-start). */
   const Coldstart: string = "faas.coldstart";
   /** A string containing the schedule period as [Cron Expression](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm). */
@@ -689,7 +689,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Faas {
   /** The immutable version of the function being executed. */
   const Version: string = "faas.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.FeatureFlag {
+namespace Qyl.Telemetry.SemanticConventions.Keys.FeatureFlag {
   /** The unique identifier for the flag evaluation context. For example, the targeting key. */
   const ContextId: string = "feature_flag.context.id";
   /** A message providing more detail about an error that occurred during feature flag evaluation in human-readable form. */
@@ -718,7 +718,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.FeatureFlag {
   /** The version of the ruleset used during the evaluation. This may be any stable value which uniquely identifies the ruleset. */
   const Version: string = "feature_flag.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.File {
+namespace Qyl.Telemetry.SemanticConventions.Keys.File {
   /** Time when the file was last accessed, in ISO 8601 format. */
   const Accessed: string = "file.accessed";
   /** Array of file attributes. */
@@ -762,7 +762,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.File {
   /** Path to the target of a symbolic link. */
   const SymbolicLinkTargetPath: string = "file.symbolic_link.target_path";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Gcp {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Gcp {
   /** The container within GCP where the AppHub application is defined. */
   const ApphubApplicationContainer: string = "gcp.apphub.application.container";
   /** The name of the application as configured in AppHub. */
@@ -818,7 +818,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Gcp {
   /** The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). */
   const GceInstanceName: string = "gcp.gce.instance.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.GenAi {
+namespace Qyl.Telemetry.SemanticConventions.Keys.GenAi {
   /** Free-form description of the GenAI agent provided by the application. */
   const AgentDescription: string = "gen_ai.agent.description";
   /** The unique and stable identifier of the GenAI hosted agent resource. */
@@ -942,7 +942,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.GenAi {
   /** Human-readable name of the GenAI workflow provided by the application. */
   const WorkflowName: string = "gen_ai.workflow.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Geo {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Geo {
   /** Two-letter code representing continent’s name. */
   const ContinentCode: string = "geo.continent.code";
   /** Two-letter ISO Country Code ([ISO 3166-1 alpha2](https://wikipedia.org/wiki/ISO_3166-1#Codes)). */
@@ -958,7 +958,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Geo {
   /** Region ISO code ([ISO 3166-2](https://wikipedia.org/wiki/ISO_3166-2)). */
   const RegionIsoCode: string = "geo.region.iso_code";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Go {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Go {
   /** The detailed state of the CPU. */
   const CpuDetailedState: string = "go.cpu.detailed_state";
   /** The state of the CPU. */
@@ -968,7 +968,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Go {
   /** The type of memory. */
   const MemoryType: string = "go.memory.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Graphql {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Graphql {
   /** The GraphQL document being executed. */
   const Document: string = "graphql.document";
   /** The name of the operation being executed. */
@@ -976,7 +976,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Graphql {
   /** The type of the operation being executed. */
   const OperationType: string = "graphql.operation.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Heroku {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Heroku {
   /** Unique identifier for the application */
   const AppId: string = "heroku.app.id";
   /** Commit hash for the current release */
@@ -984,7 +984,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Heroku {
   /** Time and date the release was created */
   const ReleaseCreationTimestamp: string = "heroku.release.creation_timestamp";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Host {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Host {
   /** The CPU architecture the host system is running on. */
   const Arch: string = "host.arch";
   /** The amount of level 2 memory cache available to the processor (in Bytes). */
@@ -1016,7 +1016,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Host {
   /** Type of host. For Cloud, this must be the machine type. */
   const Type: string = "host.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Http {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Http {
   /** Deprecated, use `client.address` instead. */
   #deprecated "Replaced by client.address."
   const ClientIp: string = "http.client_ip";
@@ -1084,7 +1084,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Http {
   #deprecated "Replaced by user_agent.original."
   const UserAgent: string = "http.user_agent";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Hw {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Hw {
   /** Design capacity in Watts-hours or Ampere-hours */
   const BatteryCapacity: string = "hw.battery.capacity";
   /** Battery [chemistry](https://schemas.dmtf.org/wbem/cim-html/2.31.0/CIM_Battery.html), e.g. Lithium-Ion, Nickel-Cadmium, etc. */
@@ -1140,20 +1140,20 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Hw {
   /** Vendor name of the hardware component */
   const Vendor: string = "hw.vendor";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Ios {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Ios {
   /** This attribute represents the state of the application. */
   const AppState: string = "ios.app.state";
   /** Deprecated. Use the `ios.app.state` attribute. */
   #deprecated "Replaced by ios.app.state."
   const State: string = "ios.state";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Jsonrpc {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Jsonrpc {
   /** Protocol version, as specified in the `jsonrpc` property of the request and its corresponding response. */
   const ProtocolVersion: string = "jsonrpc.protocol.version";
   /** A string representation of the `id` property of the request and its corresponding response. */
   const RequestId: string = "jsonrpc.request.id";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Jvm {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Jvm {
   /** Name of the buffer pool. */
   const BufferPoolName: string = "jvm.buffer.pool.name";
   /** Name of the garbage collector action. */
@@ -1171,7 +1171,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Jvm {
   /** State of the thread. */
   const ThreadState: string = "jvm.thread.state";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.K8s {
+namespace Qyl.Telemetry.SemanticConventions.Keys.K8s {
   /** The name of the cluster. */
   const ClusterName: string = "k8s.cluster.name";
   /** A pseudo-ID for the cluster, set to the UID of the `kube-system` namespace. */
@@ -1354,12 +1354,12 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.K8s {
   /** The type of the K8s volume. */
   const VolumeType: string = "k8s.volume.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Linux {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Linux {
   /** The Linux Slab memory state */
   #deprecated "Replaced by system.memory.linux.slab.state."
   const MemorySlabState: string = "linux.memory.slab.state";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Log {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Log {
   /** The basename of the file. */
   const FileName: string = "log.file.name";
   /** The basename of the file, with symlinks resolved. */
@@ -1375,11 +1375,11 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Log {
   /** A unique identifier for the Log Record. */
   const RecordUid: string = "log.record.uid";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Mainframe {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Mainframe {
   /** Name of the logical partition that hosts a systems with a mainframe operating system. */
   const LparName: string = "mainframe.lpar.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Mcp {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Mcp {
   /** The name of the request or notification method. */
   const MethodName: string = "mcp.method.name";
   /** The [version](https://modelcontextprotocol.io/specification/versioning) of the Model Context Protocol used. */
@@ -1389,7 +1389,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Mcp {
   /** Identifies [MCP session](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management). */
   const SessionId: string = "mcp.session.id";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Message {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Message {
   /** Deprecated, no replacement at this time. */
   #deprecated "Removed, no replacement."
   const CompressedSize: string = "message.compressed_size";
@@ -1403,7 +1403,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Message {
   #deprecated "Removed, no replacement."
   const UncompressedSize: string = "message.uncompressed_size";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Messaging {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Messaging {
   /** The number of messages sent, received, or processed in the scope of the batching operation. */
   const BatchMessageCount: string = "messaging.batch.message_count";
   /** A unique identifier for the client that consumes or produces a message. */
@@ -1506,7 +1506,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Messaging {
   /** The messaging system as identified by the client instrumentation. */
   const System: string = "messaging.system";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Net {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Net {
   /** Deprecated, use `network.local.address`. */
   #deprecated "Replaced by network.local.address."
   const HostIp: string = "net.host.ip";
@@ -1553,7 +1553,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Net {
   #deprecated "Replaced by network.transport."
   const Transport: string = "net.transport";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Network {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Network {
   /** The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. */
   const CarrierIcc: string = "network.carrier.icc";
   /** The mobile carrier country code. */
@@ -1589,21 +1589,21 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Network {
   /** [OSI network layer](https://wikipedia.org/wiki/Network_layer) or non-OSI equivalent. */
   const Type: string = "network.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Nfs {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Nfs {
   /** NFSv4+ operation name. */
   const OperationName: string = "nfs.operation.name";
   /** Linux: one of "hit" (NFSD_STATS_RC_HITS), "miss" (NFSD_STATS_RC_MISSES), or "nocache" (NFSD_STATS_RC_NOCACHE -- uncacheable) */
   const ServerRepcacheStatus: string = "nfs.server.repcache.status";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Nodejs {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Nodejs {
   /** The state of event loop time. */
   const EventloopState: string = "nodejs.eventloop.state";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Oci {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Oci {
   /** The digest of the OCI image manifest. For container images specifically is the digest by which the container image is known. */
   const ManifestDigest: string = "oci.manifest.digest";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.OncRpc {
+namespace Qyl.Telemetry.SemanticConventions.Keys.OncRpc {
   /** ONC/Sun RPC procedure name. */
   const ProcedureName: string = "onc_rpc.procedure.name";
   /** ONC/Sun RPC procedure number. */
@@ -1613,7 +1613,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.OncRpc {
   /** ONC/Sun RPC program version. */
   const Version: string = "onc_rpc.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Openai {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Openai {
   /** The type of OpenAI API being used. */
   const ApiType: string = "openai.api.type";
   /** The service tier requested. May be a specific tier, default, or auto. */
@@ -1623,17 +1623,17 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Openai {
   /** A fingerprint to track any eventual change in the Generative AI environment. */
   const ResponseSystemFingerprint: string = "openai.response.system_fingerprint";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Openshift {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Openshift {
   /** The name of the cluster quota. */
   const ClusterquotaName: string = "openshift.clusterquota.name";
   /** The UID of the cluster quota. */
   const ClusterquotaUid: string = "openshift.clusterquota.uid";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Opentracing {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Opentracing {
   /** Parent-child Reference type */
   const RefType: string = "opentracing.ref_type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Oracle {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Oracle {
   /** The database domain associated with the connection. */
   const DbDomain: string = "oracle.db.domain";
   /** The instance name associated with the connection in an Oracle Real Application Clusters environment. */
@@ -1645,11 +1645,11 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Oracle {
   /** The service name currently associated with the database connection. */
   const DbService: string = "oracle.db.service";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.OracleCloud {
+namespace Qyl.Telemetry.SemanticConventions.Keys.OracleCloud {
   /** The OCI realm identifier that indicates the isolated partition in which the tenancy and its resources reside. */
   const Realm: string = "oracle_cloud.realm";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Os {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Os {
   /** Unique identifier for a particular build or compilation of the operating system. */
   const BuildId: string = "os.build_id";
   /** Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. */
@@ -1661,7 +1661,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Os {
   /** The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). */
   const Version: string = "os.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Otel {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Otel {
   /** A name uniquely identifying the instance of the OpenTelemetry component within its containing SDK instance. */
   const ComponentName: string = "otel.component.name";
   /** A name identifying the type of the OpenTelemetry component. */
@@ -1689,17 +1689,17 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Otel {
   /** Description of the Status if it has a value, otherwise not set. */
   const StatusDescription: string = "otel.status_description";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Peer {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Peer {
   /** The [`service.name`](/docs/resource/README.md#service) of the remote service. SHOULD be equal to the actual `service.name` resource attribute of the remote service if any. */
   #deprecated "Replaced by service.peer.name."
   const Service: string = "peer.service";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Pool {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Pool {
   /** Deprecated, use `db.client.connection.pool.name` instead. */
   #deprecated "Replaced by db.client.connection.pool.name."
   const Name: string = "pool.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Pprof {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Pprof {
   /** Provides an indication that multiple symbols map to this location's address, for example due to identical code folding by the linker. In that case the line information represents one of the multiple symbols. This field must be recomputed when the symbolization state of the profile changes. */
   const LocationIsFolded: string = "pprof.location.is_folded";
   /** Indicates that there are filenames related to this mapping. */
@@ -1723,7 +1723,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Pprof {
   /** Records the indexes of the sample types in the original profile. */
   const ScopeSampleTypeOrder: string = "pprof.scope.sample_type_order";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Process {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Process {
   /** Length of the process.command_args array */
   const ArgsCount: string = "process.args_count";
   /** The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`. */
@@ -1802,11 +1802,11 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Process {
   /** The working directory of the process. */
   const WorkingDirectory: string = "process.working_directory";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Profile {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Profile {
   /** Describes the interpreter or compiler of a single frame. */
   const FrameType: string = "profile.frame.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Rpc {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Rpc {
   /** Deprecated, use `rpc.response.status_code` attribute instead. */
   #deprecated "Replaced by rpc.response.status_code."
   const ConnectRpcErrorCode: string = "rpc.connect_rpc.error_code";
@@ -1868,7 +1868,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Rpc {
   /** The Remote Procedure Call (RPC) system. */
   const SystemName: string = "rpc.system.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.SecurityRule {
+namespace Qyl.Telemetry.SemanticConventions.Keys.SecurityRule {
   /** A categorization value keyword used by the entity using the rule for detection of this event */
   const Category: string = "security_rule.category";
   /** The description of the rule generating the event. */
@@ -1886,13 +1886,13 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.SecurityRule {
   /** The version / revision of the rule being used for analysis. */
   const Version: string = "security_rule.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Server {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Server {
   /** 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";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Service {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Service {
   /** The operational criticality of the service. */
   const Criticality: string = "service.criticality";
   /** The string ID of the service instance. */
@@ -1908,30 +1908,30 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Service {
   /** The version string of the service component. The format is not defined by these conventions. */
   const Version: string = "service.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Session {
+namespace Qyl.Telemetry.SemanticConventions.Keys.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";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Signalr {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Signalr {
   /** SignalR HTTP connection closure status. */
   const ConnectionStatus: string = "signalr.connection.status";
   /** [SignalR transport type](https://github.com/dotnet/aspnetcore/blob/main/src/SignalR/docs/specs/TransportProtocols.md) */
   const Transport: string = "signalr.transport";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Source {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Source {
   /** 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";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.State {
+namespace Qyl.Telemetry.SemanticConventions.Keys.State {
   /** Deprecated, use `db.client.connection.state` instead. */
   #deprecated "Replaced by db.client.connection.state."
   const State: string = "state";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.System {
+namespace Qyl.Telemetry.SemanticConventions.Keys.System {
   /** Deprecated, use `cpu.logical_number` instead. */
   #deprecated "Replaced by cpu.logical_number."
   const CpuLogicalNumber: string = "system.cpu.logical_number";
@@ -1973,7 +1973,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.System {
   #deprecated "Replaced by process.state."
   const ProcessesStatus: string = "system.processes.status";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Telemetry {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Telemetry {
   /** The name of the auto instrumentation agent or distribution, if used. */
   const DistroName: string = "telemetry.distro.name";
   /** The version string of the auto instrumentation agent or distribution, if used. */
@@ -1985,7 +1985,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Telemetry {
   /** The version string of the telemetry SDK. */
   const SdkVersion: string = "telemetry.sdk.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Test {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Test {
   /** The fully qualified human readable name of the [test case](https://wikipedia.org/wiki/Test_case). */
   const CaseName: string = "test.case.name";
   /** The status of the actual test case result from test execution. */
@@ -1995,13 +1995,13 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Test {
   /** The status of the test suite run. */
   const SuiteRunStatus: string = "test.suite.run.status";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Thread {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Thread {
   /** Current "managed" thread ID (as opposed to OS thread ID). */
   const Id: string = "thread.id";
   /** Current thread name. */
   const Name: string = "thread.name";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Tls {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Tls {
   /** String indicating the [cipher](https://datatracker.ietf.org/doc/html/rfc5246#appendix-A.5) used during the current connection. */
   const Cipher: string = "tls.cipher";
   /** PEM-encoded stand-alone certificate offered by the client. This is usually mutually-exclusive of `client.certificate_chain` since this value also exists in that list. */
@@ -2062,7 +2062,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Tls {
   /** Distinguished name of subject of the x.509 certificate presented by the server. */
   const ServerSubject: string = "tls.server.subject";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Url {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Url {
   /** Domain extracted from the `url.full`, such as "opentelemetry.io". */
   const Domain: string = "url.domain";
   /** The file extension extracted from the `url.full`, excluding the leading dot. */
@@ -2090,7 +2090,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Url {
   /** The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is `com`. */
   const TopLevelDomain: string = "url.top_level_domain";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.User {
+namespace Qyl.Telemetry.SemanticConventions.Keys.User {
   /** User email address. */
   const Email: string = "user.email";
   /** User's full name */
@@ -2104,7 +2104,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.User {
   /** Array of user roles at the time of the event. */
   const Roles: string = "user.roles";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.UserAgent {
+namespace Qyl.Telemetry.SemanticConventions.Keys.UserAgent {
   /** Name of the user-agent extracted from original. Usually refers to the browser's name. */
   const Name: string = "user_agent.name";
   /** Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. */
@@ -2118,7 +2118,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.UserAgent {
   /** Version of the user-agent extracted from original. Usually refers to the browser's version */
   const Version: string = "user_agent.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.V8js {
+namespace Qyl.Telemetry.SemanticConventions.Keys.V8js {
   /** The type of garbage collection. */
   const GcType: string = "v8js.gc.type";
   /** The name of the space type of heap memory. */
@@ -2126,7 +2126,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.V8js {
   /** The type of resource keeping the event loop active. */
   const ResourceType: string = "v8js.resource.type";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Vcs {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Vcs {
   /** The ID of the change (pull request/merge request/changelist) if applicable. This is usually a unique (within repository) identifier generated by the VCS system. */
   const ChangeId: string = "vcs.change.id";
   /** The state of the change (pull request/merge request/changelist). */
@@ -2175,7 +2175,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Vcs {
   /** The type of revision comparison. */
   const RevisionDeltaDirection: string = "vcs.revision_delta.direction";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Webengine {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Webengine {
   /** Additional description of the web engine (e.g. detailed version and edition information). */
   const Description: string = "webengine.description";
   /** The name of the web engine. */
@@ -2183,7 +2183,7 @@ namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Webengine {
   /** The version of the web engine. */
   const Version: string = "webengine.version";
 }
-namespace Qyl.OpenTelemetry.SemanticConventions.Keys.Zos {
+namespace Qyl.Telemetry.SemanticConventions.Keys.Zos {
   /** The System Management Facility (SMF) Identifier uniquely identified a z/OS system within a SYSPLEX or mainframe environment and is used for system and performance analysis. */
   const SmfId: string = "zos.smf.id";
   /** The name of the SYSPLEX to which the z/OS system belongs too. */

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

@@ -356,6 +356,12 @@ export declare const McpDataModeValues: {
     readonly demo: "demo";
 };
 export type McpDataMode = typeof McpDataModeValues[keyof typeof McpDataModeValues];
+export declare const CiPhaseStatusValues: {
+    readonly ok: "ok";
+    readonly error: "error";
+    readonly unset: "unset";
+};
+export type CiPhaseStatus = typeof CiPhaseStatusValues[keyof typeof CiPhaseStatusValues];
 export declare const FetchTelemetryViewValues: {
     readonly traces: "traces";
     readonly trace: "trace";
@@ -703,6 +709,7 @@ export interface HealthReport {
     "status": HealthStatus;
     "total_duration_ms": number;
     "entries": Record<string, HealthCheckEntry>;
+    "contract_revision": string;
 }
 export interface RunnerResourceState {
     "name": string;
@@ -1305,6 +1312,31 @@ export interface SearchLogsOutput {
     "logs": LogRecord[];
     "mode": McpDataMode;
 }
+export interface CiLogInput {
+    "run_id"?: SessionId;
+    "limit"?: number;
+}
+export interface CiRunSummary {
+    "run_id": SessionId;
+    "state": SessionState;
+    "start_time": string;
+    "duration_ms"?: number;
+    "error_count": number;
+    "services": string[];
+}
+export interface CiPhase {
+    "leg": string;
+    "phase": string;
+    "status": CiPhaseStatus;
+    "duration_ms": number;
+    "message"?: string;
+}
+export interface CiLogOutput {
+    "runs"?: CiRunSummary[];
+    "run_id"?: SessionId;
+    "phases"?: CiPhase[];
+    "mode": McpDataMode;
+}
 export interface FetchTelemetryInput {
     "view": FetchTelemetryView;
     "trace_id"?: TraceId;
@@ -1354,3 +1386,5 @@ export interface CursorPageSessionEntity {
     "prev_cursor"?: string;
     "has_more": boolean;
 }
+/** Revision of the API contract these types were emitted from; compare against HealthReport.contract_revision. */
+export declare const CONTRACT_REVISION: string;

package/generated/ts-runtime/api.js

@@ -284,9 +284,17 @@ export const McpDataModeValues = {
     "live": "live",
     "demo": "demo",
 };
+export const CiPhaseStatusValues = {
+    "ok": "ok",
+    "error": "error",
+    "unset": "unset",
+};
 export const FetchTelemetryViewValues = {
     "traces": "traces",
     "trace": "trace",
     "logs": "logs",
     "mcpStats": "mcp_stats",
 };
+// --- 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:9ba787d0bd3269a9";

package/models/health.tsp

@@ -1,3 +1,7 @@
+import "../common/types.tsp";
+
+using Qyl.Api.Contracts.Common;
+
 namespace Qyl.Api.Contracts.Health;
 
 @doc("Health state reported by a qyl-managed process.")
@@ -21,4 +25,12 @@ model HealthReport {
   @encodedName("application/json", "total_duration_ms")
   totalDurationMs: float64;
   entries: Record<HealthCheckEntry>;
+
+  // The meta surface of the contract loop: first-party clients compare this to
+  // the revision baked into their own generated artifacts and refuse to run on
+  // a mismatch, so a redeployed collector cannot silently serve a contract its
+  // clients were not generated from.
+  @doc("Revision of the API contract this process serves, for the client-side startup handshake.")
+  @encodedName("application/json", "contract_revision")
+  contractRevision: ContractRevision;
 }

package/models/mcp-tools.tsp

@@ -117,6 +117,76 @@ model SearchLogsOutput {
   mode: McpDataMode;
 }
 
+@doc("Outcome of one CI phase span, projected from its OpenTelemetry span status.")
+enum CiPhaseStatus {
+  ok: "ok",
+  error: "error",
+  unset: "unset",
+}
+
+@doc("Input for ci_log.")
+model CiLogInput {
+  @doc("Session id of one CI run for a per-leg phase breakdown; omit to list recent runs.")
+  @encodedName("application/json", "run_id")
+  runId?: SessionId;
+
+  @doc("Maximum CI runs to list.")
+  @minValue(1)
+  @maxValue(50)
+  limit?: int32 = 10;
+}
+
+@doc("One CI run, summarized from the session its telemetry is grouped under.")
+model CiRunSummary {
+  @encodedName("application/json", "run_id")
+  runId: SessionId;
+
+  state: SessionState;
+
+  @encodedName("application/json", "start_time")
+  startTime: utcDateTime;
+
+  @encodedName("application/json", "duration_ms")
+  durationMs?: DurationMs;
+
+  @doc("Spans in the run that ended with an error status.")
+  @encodedName("application/json", "error_count")
+  @minValue(0)
+  errorCount: int32;
+
+  @doc("Service names observed in the run, at least one of which is CI-emitted.")
+  services: string[];
+}
+
+@doc("One phase span of a CI run, attributed to the leg that executed it.")
+model CiPhase {
+  @doc("Value of the span's ci.leg attribute, falling back to its service name.")
+  leg: string;
+
+  @doc("Span name, which the CI emitter convention sets to the phase name.")
+  phase: string;
+
+  status: CiPhaseStatus;
+
+  @encodedName("application/json", "duration_ms")
+  durationMs: DurationMs;
+
+  @doc("Span status message, present on a failed phase.")
+  message?: string;
+}
+
+@doc("Structured output for ci_log: recent runs, or one run's phases.")
+model CiLogOutput {
+  runs?: CiRunSummary[];
+
+  @encodedName("application/json", "run_id")
+  runId?: SessionId;
+
+  phases?: CiPhase[];
+
+  mode: McpDataMode;
+}
+
 @doc("Input for the app-only fetch_telemetry tool.")
 model FetchTelemetryInput {
   view: FetchTelemetryView;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "3.0.0",
+  "version": "4.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": {
@@ -85,9 +85,10 @@
     "build:emitters": "tsc -p emitters/csharp && tsc -p emitters/ts-types && tsc -p emitters/qyl-lint",
     "build:ts-runtime": "tsc -p tsconfig.contracts.json",
     "build:json-schema": "node scripts/openapi-to-json-schema.mjs",
+    "emit:contract-revision": "node scripts/emit-contract-revision.mjs",
     "prepare": "npm run build:emitters",
     "prepack": "npm run compile",
-    "compile": "npm run clean:generated && npm run build:emitters && tsp compile main.tsp && npm run build:json-schema && npm run build:ts-runtime",
+    "compile": "npm run clean:generated && npm run build:emitters && tsp compile main.tsp && npm run emit:contract-revision && npm run build:json-schema && npm run build:ts-runtime",
     "watch": "tsp compile main.tsp --watch",
     "format": "tsp format **/*.tsp",
     "lint": "npm run build:emitters && tsp compile main.tsp --no-emit --warn-as-error",
@@ -98,7 +99,7 @@
   },
   "peerDependencies": {
     "@typespec/compiler": "^1.13.0 || >=1.13.0-dev.0",
-    "@typespec/events": "^0.83.0",
+    "@typespec/events": "^0.83.0 || ^0.84.0",
     "@typespec/http": "^1.13.0",
     "@typespec/openapi": "^1.13.0",
     "@typespec/openapi3": "^1.13.0",