@ancplua/qyl-api-schema 0.5.11 → 0.5.13

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

@@ -848,7 +848,6 @@
         "cluster_id",
         "workflow_key",
         "service_name",
-        "span_name",
         "output_contract",
         "task_family",
         "call_count",
@@ -876,13 +875,14 @@
         },
         "workflow_key": {
           "type": "string",
-          "description": "Privacy-safe workflow identity used to group repeated calls."
+          "description": "Privacy-safe derived grouping identity used to group repeated calls."
         },
         "service_name": {
           "type": "string"
         },
         "span_name": {
-          "type": "string"
+          "type": "string",
+          "description": "Present only when an upstream source proves or canonicalizes a low-cardinality, privacy-safe span name."
         },
         "operation_name": {
           "type": "string"
@@ -1514,6 +1514,7 @@
       "type": "string",
       "enum": [
         "unconfigured",
+        "pending",
         "current",
         "stale",
         "sync_failed",
@@ -1803,11 +1804,6 @@
             "type": "string"
           },
           "description": "Providers used in session"
-        },
-        "estimated_cost_usd": {
-          "type": "number",
-          "format": "double",
-          "description": "Estimated cost in USD"
         }
       },
       "description": "Session GenAI usage summary"

package/generated/openapi/qyl.openapi.json

@@ -4844,7 +4844,6 @@
           "cluster_id",
           "workflow_key",
           "service_name",
-          "span_name",
           "output_contract",
           "task_family",
           "call_count",
@@ -4872,13 +4871,14 @@
           },
           "workflow_key": {
             "type": "string",
-            "description": "Privacy-safe workflow identity used to group repeated calls."
+            "description": "Privacy-safe derived grouping identity used to group repeated calls."
           },
           "service_name": {
             "type": "string"
           },
           "span_name": {
-            "type": "string"
+            "type": "string",
+            "description": "Present only when an upstream source proves or canonicalizes a low-cardinality, privacy-safe span name."
           },
           "operation_name": {
             "type": "string"
@@ -5510,6 +5510,7 @@
         "type": "string",
         "enum": [
           "unconfigured",
+          "pending",
           "current",
           "stale",
           "sync_failed",
@@ -5799,11 +5800,6 @@
               "type": "string"
             },
             "description": "Providers used in session"
-          },
-          "estimated_cost_usd": {
-            "type": "number",
-            "format": "double",
-            "description": "Estimated cost in USD"
           }
         },
         "description": "Session GenAI usage summary"

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

@@ -296,6 +296,7 @@ export declare const ProviderCostSourceKindValues: {
 export type ProviderCostSourceKind = typeof ProviderCostSourceKindValues[keyof typeof ProviderCostSourceKindValues];
 export declare const ProviderCostSourceStatusValues: {
     readonly unconfigured: "unconfigured";
+    readonly pending: "pending";
     readonly current: "current";
     readonly stale: "stale";
     readonly syncFailed: "sync_failed";
@@ -795,7 +796,6 @@ export interface SessionGenAiUsage {
     "total_output_tokens": number;
     "models_used": string[];
     "providers_used": string[];
-    "estimated_cost_usd"?: number;
 }
 export interface SessionStats {
     "active_sessions": number;
@@ -1078,7 +1078,7 @@ export interface GenAiEtlAuditCluster {
     "cluster_id": string;
     "workflow_key": string;
     "service_name": string;
-    "span_name": string;
+    "span_name"?: string;
     "operation_name"?: string;
     "provider"?: string;
     "model"?: string;

package/generated/ts-runtime/api.js

@@ -254,6 +254,7 @@ export const ProviderCostSourceKindValues = {
 };
 export const ProviderCostSourceStatusValues = {
     "unconfigured": "unconfigured",
+    "pending": "pending",
     "current": "current",
     "stale": "stale",
     "syncFailed": "sync_failed",

package/models/cost-etl-audit.tsp

@@ -24,6 +24,9 @@ enum ProviderCostSourceStatus {
   @doc("The source has no configured provider credential or cloud identity.")
   unconfigured: "unconfigured",
 
+  @doc("A provider credential or cloud identity is configured, but no fetch has completed yet.")
+  pending: "pending",
+
   @doc("The most recent provider fetch completed inside its freshness window.")
   current: "current",
 
@@ -217,15 +220,16 @@ model GenAiEtlAuditCluster {
   @encodedName("application/json", "cluster_id")
   clusterId: string;
 
-  @doc("Privacy-safe workflow identity used to group repeated calls.")
+  @doc("Privacy-safe derived grouping identity used to group repeated calls.")
   @encodedName("application/json", "workflow_key")
   workflowKey: string;
 
   @encodedName("application/json", "service_name")
   serviceName: string;
 
+  @doc("Present only when an upstream source proves or canonicalizes a low-cardinality, privacy-safe span name.")
   @encodedName("application/json", "span_name")
-  spanName: string;
+  spanName?: string;
 
   @encodedName("application/json", "operation_name")
   operationName?: string;

package/models/session.tsp

@@ -236,10 +236,6 @@ model SessionGenAiUsage {
   @doc("Providers used in session")
   @encodedName("application/json", "providers_used")
   providersUsed: string[];
-
-  @doc("Estimated cost in USD")
-  @encodedName("application/json", "estimated_cost_usd")
-  estimatedCostUsd?: float64;
 }
 
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "0.5.11",
+  "version": "0.5.13",
   "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": {