@ancplua/qyl-api-schema 0.2.2 → 0.3.0

package/intelligence/main.tsp

@@ -4,8 +4,6 @@
 // Canonical reasoning model over telemetry data. Schema-driven, generated,
 // deterministic. Defines diagnostic patterns, causal rules, and investigation
 // strategies as typed data consumed by Loom, MCP, and dashboard.
-//
-// Source of truth: specs/telemetry-intelligence.md
 // =============================================================================
 
 import "@typespec/openapi";

package/intelligence/seed/patterns.tsp

@@ -2,8 +2,7 @@
 // ANcpLua v2.0 - Seed Diagnostic Patterns (v1)
 // =============================================================================
 // 19 initial diagnostic patterns (10 infra + 9 agent behavioral)
-// Source: specs/telemetry-intelligence.md §5.1 + Microsoft Research AgentRx (March 2026)
-// These compile to static registries in DiagnosticPatterns.g.cs.
+// Source: Microsoft Research AgentRx (March 2026)
 //
 // Signal attributes reference:
 //   - OTel semantic attributes (status_code, duration_ns, etc.)

package/intelligence/seed/rules.tsp

@@ -1,8 +1,7 @@
 // =============================================================================
 // ANcpLua v2.0 - Seed Causal Rules (v1)
 // =============================================================================
-// 6 initial causal rules. Source: specs/telemetry-intelligence.md §5.2
-// These compile to static registries in CausalRules.g.cs.
+// 6 initial causal rules.
 // =============================================================================
 
 namespace Qyl.Api.Contracts.Intelligence.Seed;

package/intelligence/seed/strategies.tsp

@@ -1,8 +1,7 @@
 // =============================================================================
 // ANcpLua v2.0 - Seed Investigation Strategies (v1)
 // =============================================================================
-// 4 initial investigation strategies. Source: specs/telemetry-intelligence.md §5.3
-// These compile to static registries in InvestigationStrategies.g.cs.
+// 4 initial investigation strategies.
 //
 // Trigger patterns use category:X syntax for category-wide triggers.
 // Query templates are abstract qyl investigation hints; the runtime decides how to execute them.

package/models/agent/agent-run.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Agent Run Contract Model (OTel v1.40)
+// ANcpLua v2.0 - Agent Run Contract Model
 // =============================================================================
 // Agent run records extracted from OTLP spans.
 // Maps OTel GenAI semantic convention attributes to qyl API contract fields.

package/models/agent/tool-call.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Tool Call Contract Model (OTel v1.40)
+// ANcpLua v2.0 - Tool Call Contract Model
 // =============================================================================
 // Tool call records extracted from OTLP spans.
 // Maps OTel GenAI tool semantic convention attributes to qyl API contract fields.

package/models/agent/workflow-checkpoint.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Workflow Checkpoint Contract Model (OTel v1.40)
+// ANcpLua v2.0 - Workflow Checkpoint Contract Model
 // =============================================================================
 // Checkpoint state persistence for workflow execution recovery.
 // Enables resume-from-checkpoint after failures or cancellations.

package/models/agent/workflow-execution.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Workflow Execution Contract Model (OTel v1.40)
+// ANcpLua v2.0 - Workflow Execution Contract Model
 // =============================================================================
 // Workflow execution tracking for multi-step AI agent workflows.
 // Defines the public qyl workflow execution contract.

package/models/db.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Database Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - Database Semantic Conventions
 // =============================================================================
 // Database telemetry attributes with 45+ DBMS types.
 // =============================================================================
@@ -33,10 +33,10 @@ enum DbVersions {
 }
 
 // =============================================================================
-// Database Span Attributes (Complete OTel v1.40)
+// Database Span Attributes
 // =============================================================================
 
-@doc("Database span attributes following OTel Semantic Conventions v1.40")
+@doc("Database span attributes following OTel Semantic Conventions")
 model DbAttributes {
   // ---------------------------------------------------------------------------
   // System & Connection

package/models/deployment.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Deployment Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - Deployment Semantic Conventions
 // =============================================================================
 // Deployment/release telemetry attributes.
 // =============================================================================

package/models/error.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Error Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - Error Semantic Conventions
 // =============================================================================
 // Error type and error handling telemetry attributes.
 // =============================================================================

package/models/genai.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - GenAI Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - GenAI Semantic Conventions
 // =============================================================================
 // Comprehensive AI/LLM telemetry following OpenTelemetry GenAI specifications.
 // https://opentelemetry.io/docs/specs/semconv/gen-ai/
@@ -47,10 +47,10 @@ enum GenAiVersions {
 }
 
 // =============================================================================
-// GenAI Span Attributes (Complete OTel v1.40)
+// GenAI Span Attributes
 // =============================================================================
 
-@doc("GenAI span attributes following OTel Semantic Conventions v1.40")
+@doc("GenAI span attributes following OTel Semantic Conventions")
 model GenAiSpanAttributes {
   // ---------------------------------------------------------------------------
   // Provider & System (REQUIRED)
@@ -60,11 +60,6 @@ model GenAiSpanAttributes {
   @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.ProviderName)
   providerName: GenAiProvider;
 
-  @doc("The name of the GenAI system/product (e.g., 'ChatGPT', 'Claude', 'Gemini')")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.System)
-  @removed(GenAiVersions.v1_37)
-  system?: string;
-
   // ---------------------------------------------------------------------------
   // Operation Details
   // ---------------------------------------------------------------------------
@@ -184,20 +179,6 @@ model GenAiSpanAttributes {
   @added(GenAiVersions.v1_40)
   usageCacheCreationInputTokens?: TokenCount;
 
-  // ---------------------------------------------------------------------------
-  // Deprecated Attributes (for migration)
-  // ---------------------------------------------------------------------------
-
-  @doc("Prompt tokens (deprecated - use gen_ai.usage.input_tokens)")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.UsagePromptTokens)
-  @removed(GenAiVersions.v1_28)
-  usagePromptTokens?: TokenCount;
-
-  @doc("Completion tokens (deprecated - use gen_ai.usage.output_tokens)")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.UsageCompletionTokens)
-  @removed(GenAiVersions.v1_28)
-  usageCompletionTokens?: TokenCount;
-
   // ---------------------------------------------------------------------------
   // Agent Attributes (v1.38+)
   // ---------------------------------------------------------------------------
@@ -294,10 +275,6 @@ model GenAiSpanAttributes {
   @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.OutputType)
   outputType?: GenAiOutputType;
 
-  @doc("Prompt content (may be redacted)")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.Prompt)
-  prompt?: string;
-
   @doc("Name of the prompt template being used")
   @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.PromptName)
   promptName?: string;
@@ -306,10 +283,6 @@ model GenAiSpanAttributes {
   @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.SystemInstructions)
   systemInstructions?: string;
 
-  @doc("Completion content (may be redacted)")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.Completion)
-  completion?: string;
-
   // ---------------------------------------------------------------------------
   // Extended Request Attributes
   // ---------------------------------------------------------------------------
@@ -507,7 +480,7 @@ model GenAiCostEstimate {
 }
 
 // =============================================================================
-// GenAI Enumerations (18+ enums as promised)
+// GenAI Enumerations
 // =============================================================================
 
 // =============================================================================
@@ -1329,40 +1302,21 @@ model LatencyPercentiles {
 // Vendor-Specific Extensions (OTel 1.40)
 // =============================================================================
 
-@doc("OpenAI-specific request attributes")
+@doc("OpenAI-specific request attributes (OTel 1.42 moved these to the openai.* namespace; response_format and seed graduated to the generic gen_ai.output.type / gen_ai.request.seed)")
 model OpenAiRequestAttributes {
-  @doc("Response format requested (text, json_object, json_schema)")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.OpenaiRequestResponseFormat)
-  responseFormat?: OpenAiResponseFormat;
-
-  @doc("Random seed for deterministic generation")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.OpenaiRequestSeed)
-  seed?: int64;
-
   @doc("Service tier for the request (auto, default, etc.)")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.OpenaiRequestServiceTier)
+  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.Openai.RequestServiceTier)
   serviceTier?: string;
 }
 
 @doc("OpenAI-specific response attributes")
 model OpenAiResponseAttributes {
   @doc("Service tier used for the response")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.OpenaiResponseServiceTier)
+  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.Openai.ResponseServiceTier)
   serviceTier?: string;
 
   @doc("System fingerprint for reproducibility")
-  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.GenAi.OpenaiResponseSystemFingerprint)
+  @encodedName("application/json", ANcpLua.OpenTelemetry.SemanticConventions.Keys.Openai.ResponseSystemFingerprint)
   systemFingerprint?: string;
 }
 
-@doc("OpenAI response format types")
-enum OpenAiResponseFormat {
-  @doc("Plain text response")
-  text: "text",
-
-  @doc("JSON object response")
-  jsonObject: "json_object",
-
-  @doc("JSON schema-constrained response")
-  jsonSchema: "json_schema",
-}

package/models/http.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - HTTP Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - HTTP Semantic Conventions
 // =============================================================================
 // HTTP client and server telemetry attributes following OTel specifications.
 // =============================================================================
@@ -33,10 +33,10 @@ enum HttpVersions {
 }
 
 // =============================================================================
-// HTTP Span Attributes (Complete OTel v1.40)
+// HTTP Span Attributes
 // =============================================================================
 
-@doc("HTTP span attributes following OTel Semantic Conventions v1.40")
+@doc("HTTP span attributes following OTel Semantic Conventions")
 model HttpAttributes {
   // ---------------------------------------------------------------------------
   // Common Attributes (Client & Server)

package/models/identity.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - User/Client/Service Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - User/Client/Service Semantic Conventions
 // =============================================================================
 // User, client, service, and app identity attributes.
 // =============================================================================

package/models/log.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Log Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - Log Semantic Conventions
 // =============================================================================
 // Log record attributes and log-specific semantic conventions.
 // =============================================================================

package/models/messaging.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Messaging Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - Messaging Semantic Conventions
 // =============================================================================
 // Message broker and queue telemetry attributes.
 // =============================================================================

package/models/otel-config.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - OpenTelemetry SDK Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - OpenTelemetry SDK Semantic Conventions
 // =============================================================================
 // OTel SDK configuration and telemetry scope attributes.
 // =============================================================================

package/models/rpc.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - RPC Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - RPC Semantic Conventions
 // =============================================================================
 // Remote Procedure Call telemetry attributes (gRPC, etc.).
 // =============================================================================

package/models/session.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Session Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - Session Semantic Conventions
 // =============================================================================
 // User session telemetry attributes.
 // =============================================================================

package/models/system.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - System Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - System Semantic Conventions
 // =============================================================================
 // Operating system telemetry attributes.
 // =============================================================================

package/models/test.tsp

@@ -1,5 +1,5 @@
 // =============================================================================
-// ANcpLua v2.0 - Test Semantic Conventions (OTel v1.40)
+// ANcpLua v2.0 - Test Semantic Conventions
 // =============================================================================
 // Test execution telemetry attributes.
 // =============================================================================

package/otel/enums.tsp

@@ -1,7 +1,7 @@
 // =============================================================================
 // ANcpLua v2.0 - OpenTelemetry Core Enumerations
 // =============================================================================
-// All OTel standard enumerations following Semantic Conventions v1.40.
+// All OTel standard enumerations following OTel Semantic Conventions.
 // =============================================================================
 
 namespace Qyl.Api.Contracts.OTel.Enums;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "0.2.2",
+  "version": "0.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": {
@@ -73,8 +73,8 @@
   "devDependencies": {
     "@ancplua/typespec-emit-csharp": "file:./emitters/csharp",
     "@ancplua/typespec-emit-ts-types": "file:./emitters/ts-types",
-    "@ancplua/typespec-otel-semconv": "1.41.0-2",
     "@ancplua/typespec-otelconventions-lint": "file:./emitters/otelconventions-lint",
+    "@qyl/telemetry-control-graph": "file:./emitters/telemetry-control-graph",
     "@types/node": "25.9.4",
     "@typespec/compiler": "1.13.0",
     "@typespec/events": "0.83.0",
@@ -87,7 +87,6 @@
     "@typespec/streams": "0.83.0",
     "@typespec/versioning": "0.83.0",
     "typescript": "6.0.3",
-    "vitest": "4.1.9",
-    "@qyl/telemetry-control-graph": "file:./emitters/telemetry-control-graph"
+    "vitest": "4.1.9"
   }
 }