@ancplua/qyl-api-schema 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +11 -7
  2. package/generated/README.md +24 -7
  3. package/generated/otel-keys-legacy.tsp +51 -0
  4. package/generated/otel-keys.gen.tsp +605 -64
  5. package/index.tsp +1 -0
  6. package/intelligence/main.tsp +0 -2
  7. package/intelligence/seed/patterns.tsp +1 -2
  8. package/intelligence/seed/rules.tsp +1 -2
  9. package/intelligence/seed/strategies.tsp +1 -2
  10. package/models/agent/agent-run.tsp +1 -1
  11. package/models/agent/tool-call.tsp +1 -1
  12. package/models/agent/workflow-checkpoint.tsp +1 -1
  13. package/models/agent/workflow-execution.tsp +1 -1
  14. package/models/db.tsp +3 -3
  15. package/models/deployment.tsp +1 -1
  16. package/models/error.tsp +1 -1
  17. package/models/genai.tsp +4 -4
  18. package/models/http.tsp +3 -3
  19. package/models/identity.tsp +1 -1
  20. package/models/log.tsp +1 -1
  21. package/models/messaging.tsp +1 -1
  22. package/models/otel-config.tsp +1 -1
  23. package/models/rpc.tsp +1 -1
  24. package/models/session.tsp +1 -1
  25. package/models/system.tsp +1 -1
  26. package/models/test.tsp +1 -1
  27. package/otel/enums.tsp +1 -1
  28. package/package.json +3 -4
package/index.tsp CHANGED
@@ -19,6 +19,7 @@ import "@typespec/sse";
19
19
  import "@typespec/events";
20
20
 
21
21
  import "./generated/otel-keys.gen.tsp";
22
+ import "./generated/otel-keys-legacy.tsp";
22
23
 
23
24
  import "./common/types.tsp";
24
25
  import "./common/errors.tsp";
package/intelligence/main.tsp CHANGED
@@ -4,8 +4,6 @@
4
4
  // Canonical reasoning model over telemetry data. Schema-driven, generated,
5
5
  // deterministic. Defines diagnostic patterns, causal rules, and investigation
6
6
  // strategies as typed data consumed by Loom, MCP, and dashboard.
7
- //
8
- // Source of truth: specs/telemetry-intelligence.md
9
7
  // =============================================================================
10
8
 
11
9
  import "@typespec/openapi";
package/intelligence/seed/patterns.tsp CHANGED
@@ -2,8 +2,7 @@
2
2
  // ANcpLua v2.0 - Seed Diagnostic Patterns (v1)
3
3
  // =============================================================================
4
4
  // 19 initial diagnostic patterns (10 infra + 9 agent behavioral)
5
- // Source: specs/telemetry-intelligence.md §5.1 + Microsoft Research AgentRx (March 2026)
6
- // These compile to static registries in DiagnosticPatterns.g.cs.
5
+ // Source: Microsoft Research AgentRx (March 2026)
7
6
  //
8
7
  // Signal attributes reference:
9
8
  // - OTel semantic attributes (status_code, duration_ns, etc.)
package/intelligence/seed/rules.tsp CHANGED
@@ -1,8 +1,7 @@
1
1
  // =============================================================================
2
2
  // ANcpLua v2.0 - Seed Causal Rules (v1)
3
3
  // =============================================================================
4
- // 6 initial causal rules. Source: specs/telemetry-intelligence.md §5.2
5
- // These compile to static registries in CausalRules.g.cs.
4
+ // 6 initial causal rules.
6
5
  // =============================================================================
7
6
 
8
7
  namespace Qyl.Api.Contracts.Intelligence.Seed;
package/intelligence/seed/strategies.tsp CHANGED
@@ -1,8 +1,7 @@
1
1
  // =============================================================================
2
2
  // ANcpLua v2.0 - Seed Investigation Strategies (v1)
3
3
  // =============================================================================
4
- // 4 initial investigation strategies. Source: specs/telemetry-intelligence.md §5.3
5
- // These compile to static registries in InvestigationStrategies.g.cs.
4
+ // 4 initial investigation strategies.
6
5
  //
7
6
  // Trigger patterns use category:X syntax for category-wide triggers.
8
7
  // Query templates are abstract qyl investigation hints; the runtime decides how to execute them.
package/models/agent/agent-run.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Agent Run Contract Model (OTel v1.40)
2
+ // ANcpLua v2.0 - Agent Run Contract Model
3
3
  // =============================================================================
4
4
  // Agent run records extracted from OTLP spans.
5
5
  // Maps OTel GenAI semantic convention attributes to qyl API contract fields.
package/models/agent/tool-call.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Tool Call Contract Model (OTel v1.40)
2
+ // ANcpLua v2.0 - Tool Call Contract Model
3
3
  // =============================================================================
4
4
  // Tool call records extracted from OTLP spans.
5
5
  // Maps OTel GenAI tool semantic convention attributes to qyl API contract fields.
package/models/agent/workflow-checkpoint.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Workflow Checkpoint Contract Model (OTel v1.40)
2
+ // ANcpLua v2.0 - Workflow Checkpoint Contract Model
3
3
  // =============================================================================
4
4
  // Checkpoint state persistence for workflow execution recovery.
5
5
  // Enables resume-from-checkpoint after failures or cancellations.
package/models/agent/workflow-execution.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Workflow Execution Contract Model (OTel v1.40)
2
+ // ANcpLua v2.0 - Workflow Execution Contract Model
3
3
  // =============================================================================
4
4
  // Workflow execution tracking for multi-step AI agent workflows.
5
5
  // Defines the public qyl workflow execution contract.
package/models/db.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Database Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - Database Semantic Conventions
3
3
  // =============================================================================
4
4
  // Database telemetry attributes with 45+ DBMS types.
5
5
  // =============================================================================
@@ -33,10 +33,10 @@ enum DbVersions {
33
33
  }
34
34
 
35
35
  // =============================================================================
36
- // Database Span Attributes (Complete OTel v1.40)
36
+ // Database Span Attributes
37
37
  // =============================================================================
38
38
 
39
- @doc("Database span attributes following OTel Semantic Conventions v1.40")
39
+ @doc("Database span attributes following OTel Semantic Conventions")
40
40
  model DbAttributes {
41
41
  // ---------------------------------------------------------------------------
42
42
  // System & Connection
package/models/deployment.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Deployment Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - Deployment Semantic Conventions
3
3
  // =============================================================================
4
4
  // Deployment/release telemetry attributes.
5
5
  // =============================================================================
package/models/error.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Error Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - Error Semantic Conventions
3
3
  // =============================================================================
4
4
  // Error type and error handling telemetry attributes.
5
5
  // =============================================================================
package/models/genai.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - GenAI Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - GenAI Semantic Conventions
3
3
  // =============================================================================
4
4
  // Comprehensive AI/LLM telemetry following OpenTelemetry GenAI specifications.
5
5
  // https://opentelemetry.io/docs/specs/semconv/gen-ai/
@@ -47,10 +47,10 @@ enum GenAiVersions {
47
47
  }
48
48
 
49
49
  // =============================================================================
50
- // GenAI Span Attributes (Complete OTel v1.40)
50
+ // GenAI Span Attributes
51
51
  // =============================================================================
52
52
 
53
- @doc("GenAI span attributes following OTel Semantic Conventions v1.40")
53
+ @doc("GenAI span attributes following OTel Semantic Conventions")
54
54
  model GenAiSpanAttributes {
55
55
  // ---------------------------------------------------------------------------
56
56
  // Provider & System (REQUIRED)
@@ -507,7 +507,7 @@ model GenAiCostEstimate {
507
507
  }
508
508
 
509
509
  // =============================================================================
510
- // GenAI Enumerations (18+ enums as promised)
510
+ // GenAI Enumerations
511
511
  // =============================================================================
512
512
 
513
513
  // =============================================================================
package/models/http.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - HTTP Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - HTTP Semantic Conventions
3
3
  // =============================================================================
4
4
  // HTTP client and server telemetry attributes following OTel specifications.
5
5
  // =============================================================================
@@ -33,10 +33,10 @@ enum HttpVersions {
33
33
  }
34
34
 
35
35
  // =============================================================================
36
- // HTTP Span Attributes (Complete OTel v1.40)
36
+ // HTTP Span Attributes
37
37
  // =============================================================================
38
38
 
39
- @doc("HTTP span attributes following OTel Semantic Conventions v1.40")
39
+ @doc("HTTP span attributes following OTel Semantic Conventions")
40
40
  model HttpAttributes {
41
41
  // ---------------------------------------------------------------------------
42
42
  // Common Attributes (Client & Server)
package/models/identity.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - User/Client/Service Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - User/Client/Service Semantic Conventions
3
3
  // =============================================================================
4
4
  // User, client, service, and app identity attributes.
5
5
  // =============================================================================
package/models/log.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Log Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - Log Semantic Conventions
3
3
  // =============================================================================
4
4
  // Log record attributes and log-specific semantic conventions.
5
5
  // =============================================================================
package/models/messaging.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Messaging Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - Messaging Semantic Conventions
3
3
  // =============================================================================
4
4
  // Message broker and queue telemetry attributes.
5
5
  // =============================================================================
package/models/otel-config.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - OpenTelemetry SDK Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - OpenTelemetry SDK Semantic Conventions
3
3
  // =============================================================================
4
4
  // OTel SDK configuration and telemetry scope attributes.
5
5
  // =============================================================================
package/models/rpc.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - RPC Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - RPC Semantic Conventions
3
3
  // =============================================================================
4
4
  // Remote Procedure Call telemetry attributes (gRPC, etc.).
5
5
  // =============================================================================
package/models/session.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Session Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - Session Semantic Conventions
3
3
  // =============================================================================
4
4
  // User session telemetry attributes.
5
5
  // =============================================================================
package/models/system.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - System Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - System Semantic Conventions
3
3
  // =============================================================================
4
4
  // Operating system telemetry attributes.
5
5
  // =============================================================================
package/models/test.tsp CHANGED
@@ -1,5 +1,5 @@
1
1
  // =============================================================================
2
- // ANcpLua v2.0 - Test Semantic Conventions (OTel v1.40)
2
+ // ANcpLua v2.0 - Test Semantic Conventions
3
3
  // =============================================================================
4
4
  // Test execution telemetry attributes.
5
5
  // =============================================================================
package/otel/enums.tsp CHANGED
@@ -1,7 +1,7 @@
1
1
  // =============================================================================
2
2
  // ANcpLua v2.0 - OpenTelemetry Core Enumerations
3
3
  // =============================================================================
4
- // All OTel standard enumerations following Semantic Conventions v1.40.
4
+ // All OTel standard enumerations following OTel Semantic Conventions.
5
5
  // =============================================================================
6
6
 
7
7
  namespace Qyl.Api.Contracts.OTel.Enums;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ancplua/qyl-api-schema",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
4
  "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.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -73,8 +73,8 @@
73
73
  "devDependencies": {
74
74
  "@ancplua/typespec-emit-csharp": "file:./emitters/csharp",
75
75
  "@ancplua/typespec-emit-ts-types": "file:./emitters/ts-types",
76
- "@ancplua/typespec-otel-semconv": "1.41.0-2",
77
76
  "@ancplua/typespec-otelconventions-lint": "file:./emitters/otelconventions-lint",
77
+ "@qyl/telemetry-control-graph": "file:./emitters/telemetry-control-graph",
78
78
  "@types/node": "25.9.4",
79
79
  "@typespec/compiler": "1.13.0",
80
80
  "@typespec/events": "0.83.0",
@@ -87,7 +87,6 @@
87
87
  "@typespec/streams": "0.83.0",
88
88
  "@typespec/versioning": "0.83.0",
89
89
  "typescript": "6.0.3",
90
- "vitest": "4.1.9",
91
- "@qyl/telemetry-control-graph": "file:./emitters/telemetry-control-graph"
90
+ "vitest": "4.1.9"
92
91
  }
93
92
  }