@ancplua/qyl-api-schema 0.5.10 → 0.5.11

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

@@ -289,6 +289,122 @@ export declare const FetchTelemetryViewValues: {
     readonly mcpStats: "mcp_stats";
 };
 export type FetchTelemetryView = typeof FetchTelemetryViewValues[keyof typeof FetchTelemetryViewValues];
+export declare const ProviderCostSourceKindValues: {
+    readonly actualBilledCost: "actual_billed_cost";
+    readonly officialPublicCatalog: "official_public_catalog";
+};
+export type ProviderCostSourceKind = typeof ProviderCostSourceKindValues[keyof typeof ProviderCostSourceKindValues];
+export declare const ProviderCostSourceStatusValues: {
+    readonly unconfigured: "unconfigured";
+    readonly current: "current";
+    readonly stale: "stale";
+    readonly syncFailed: "sync_failed";
+    readonly notAttributable: "not_attributable";
+};
+export type ProviderCostSourceStatus = typeof ProviderCostSourceStatusValues[keyof typeof ProviderCostSourceStatusValues];
+export declare const ProviderCostAttributionValues: {
+    readonly providerModelPeriod: "provider_model_period";
+    readonly providerPeriod: "provider_period";
+    readonly scenario: "scenario";
+    readonly unavailable: "unavailable";
+};
+export type ProviderCostAttribution = typeof ProviderCostAttributionValues[keyof typeof ProviderCostAttributionValues];
+export declare const GenAiEtlPromotionGateKindValues: {
+    readonly contractStability: "contract_stability";
+    readonly offlineReplay: "offline_replay";
+    readonly calibratedConfidence: "calibrated_confidence";
+    readonly shadowTraffic: "shadow_traffic";
+    readonly limitedServing: "limited_serving";
+    readonly rollbackResidualPolicy: "rollback_residual_policy";
+};
+export type GenAiEtlPromotionGateKind = typeof GenAiEtlPromotionGateKindValues[keyof typeof GenAiEtlPromotionGateKindValues];
+export declare const GenAiEtlPromotionGateStateValues: {
+    readonly passed: "passed";
+    readonly failed: "failed";
+    readonly notEvaluated: "not_evaluated";
+    readonly blockedMissingEvidence: "blocked_missing_evidence";
+};
+export type GenAiEtlPromotionGateState = typeof GenAiEtlPromotionGateStateValues[keyof typeof GenAiEtlPromotionGateStateValues];
+export declare const GenAiEtlOutputContractValues: {
+    readonly prose: "prose";
+    readonly label: "label";
+    readonly spanList: "span_list";
+    readonly record: "record";
+    readonly vector: "vector";
+    readonly catalogReference: "catalog_reference";
+    readonly number: "number";
+    readonly boolean: "boolean";
+    readonly unknown: "unknown";
+};
+export type GenAiEtlOutputContract = typeof GenAiEtlOutputContractValues[keyof typeof GenAiEtlOutputContractValues];
+export declare const GenAiEtlTaskFamilyValues: {
+    readonly openReasoningGeneration: "open_reasoning_generation";
+    readonly classification: "classification";
+    readonly sequenceLabeling: "sequence_labeling";
+    readonly structuredExtraction: "structured_extraction";
+    readonly retrievalEntityResolution: "retrieval_entity_resolution";
+    readonly similarityClustering: "similarity_clustering";
+    readonly normalizationTransformation: "normalization_transformation";
+    readonly numericAnalytical: "numeric_analytical";
+    readonly unknown: "unknown";
+};
+export type GenAiEtlTaskFamily = typeof GenAiEtlTaskFamilyValues[keyof typeof GenAiEtlTaskFamilyValues];
+export declare const GenAiEtlCandidatePathValues: {
+    readonly exactCache: "exact_cache";
+    readonly deterministicCode: "deterministic_code";
+    readonly boundedRetrieval: "bounded_retrieval";
+    readonly smallClassifierExtractor: "small_classifier_extractor";
+    readonly smallerGenerativeModel: "smaller_generative_model";
+    readonly frontierModel: "frontier_model";
+    readonly insufficientEvidence: "insufficient_evidence";
+};
+export type GenAiEtlCandidatePath = typeof GenAiEtlCandidatePathValues[keyof typeof GenAiEtlCandidatePathValues];
+export declare const GenAiEtlValidationMetricValues: {
+    readonly accuracy: "accuracy";
+    readonly macroF1: "macro_f1";
+    readonly spanF1: "span_f1";
+    readonly fieldExactMatch: "field_exact_match";
+    readonly schemaValidity: "schema_validity";
+    readonly matchAccuracy: "match_accuracy";
+    readonly recallAtK: "recall_at_k";
+    readonly meanReciprocalRank: "mean_reciprocal_rank";
+    readonly exactMatch: "exact_match";
+    readonly numericTolerance: "numeric_tolerance";
+    readonly humanPreference: "human_preference";
+    readonly taskSuccess: "task_success";
+    readonly unavailable: "unavailable";
+};
+export type GenAiEtlValidationMetric = typeof GenAiEtlValidationMetricValues[keyof typeof GenAiEtlValidationMetricValues];
+export declare const GenAiEtlResidualPathValues: {
+    readonly frontierModel: "frontier_model";
+    readonly humanReview: "human_review";
+    readonly retry: "retry";
+    readonly degradedResponse: "degraded_response";
+    readonly none: "none";
+    readonly undetermined: "undetermined";
+};
+export type GenAiEtlResidualPath = typeof GenAiEtlResidualPathValues[keyof typeof GenAiEtlResidualPathValues];
+export declare const GenAiEtlEvidenceSignalValues: {
+    readonly workflowIdentity: "workflow_identity";
+    readonly outputContract: "output_contract";
+    readonly providerModel: "provider_model";
+    readonly tokenUsage: "token_usage";
+    readonly providerCost: "provider_cost";
+    readonly recurringSchema: "recurring_schema";
+    readonly boundedReference: "bounded_reference";
+    readonly taskMetric: "task_metric";
+    readonly acceptedOutputReplay: "accepted_output_replay";
+    readonly downstreamFate: "downstream_fate";
+    readonly calibratedConfidence: "calibrated_confidence";
+    readonly shadowComparison: "shadow_comparison";
+    readonly fallbackPolicy: "fallback_policy";
+};
+export type GenAiEtlEvidenceSignal = typeof GenAiEtlEvidenceSignalValues[keyof typeof GenAiEtlEvidenceSignalValues];
+export declare const GenAiEtlCalculationStatusValues: {
+    readonly calculated: "calculated";
+    readonly missingFrontierCost: "missing_frontier_cost";
+};
+export type GenAiEtlCalculationStatus = typeof GenAiEtlCalculationStatusValues[keyof typeof GenAiEtlCalculationStatusValues];
 export type AttributeValue = string | boolean | number | AttributeBytesValue | AttributeValue[] | AttributeKeyValueListValue;
 export type ApiError = NotFoundError | ValidationError | UnauthorizedError | ForbiddenError | ConflictError | RateLimitError | InternalServerError | BadGatewayError | ServiceUnavailableError;
 export type LogBody = LogBodyString | LogBodyKvList | LogBodyArray | LogBodyBytes;
@@ -938,6 +1054,111 @@ export interface FetchTelemetryOutput {
     "stats"?: McpDashboardStats;
     "mode": McpDataMode;
 }
+export interface ProviderCostSource {
+    "provider": string;
+    "kind": ProviderCostSourceKind;
+    "status": ProviderCostSourceStatus;
+    "source_endpoint": string;
+    "attribution": ProviderCostAttribution;
+    "last_attempt_at"?: string;
+    "last_success_at"?: string;
+    "period_start"?: string;
+    "period_end"?: string;
+    "currency_code"?: string;
+    "reported_cost_usd"?: number;
+    "model"?: string;
+    "failure_category"?: string;
+}
+export interface GenAiEtlPromotionGate {
+    "gate": GenAiEtlPromotionGateKind;
+    "state": GenAiEtlPromotionGateState;
+    "reason"?: string;
+}
+export interface GenAiEtlAuditCluster {
+    "cluster_id": string;
+    "workflow_key": string;
+    "service_name": string;
+    "span_name": string;
+    "operation_name"?: string;
+    "provider"?: string;
+    "model"?: string;
+    "output_contract": GenAiEtlOutputContract;
+    "task_family": GenAiEtlTaskFamily;
+    "call_count": number;
+    "input_tokens": number;
+    "output_tokens": number;
+    "cache_read_input_tokens": number;
+    "cache_creation_input_tokens": number;
+    "reasoning_output_tokens": number;
+    "error_count": number;
+    "error_rate": number;
+    "average_latency_ms": number;
+    "p95_latency_ms": number;
+    "observed_cost_usd"?: number;
+    "cost_per_call_usd"?: number;
+    "cost_attribution": ProviderCostAttribution;
+    "spend_share"?: number;
+    "measurable_coverage"?: number;
+    "safe_deferral_coverage"?: number;
+    "candidate_path": GenAiEtlCandidatePath;
+    "validation_metric": GenAiEtlValidationMetric;
+    "residual_path": GenAiEtlResidualPath;
+    "evidence_signals": GenAiEtlEvidenceSignal[];
+    "missing_evidence": GenAiEtlEvidenceSignal[];
+    "promotion_gates": GenAiEtlPromotionGate[];
+}
+export interface GenAiEtlAuditSummary {
+    "total_calls": number;
+    "total_input_tokens": number;
+    "total_output_tokens": number;
+    "attributed_cost_usd"?: number;
+    "priced_call_coverage": number;
+    "economic_concentration"?: number;
+    "measurable_coverage"?: number;
+    "safe_deferral_coverage"?: number;
+    "candidate_etl_spend_share"?: number;
+}
+export interface GenAiEtlAuditReport {
+    "generated_at": string;
+    "period_start": string;
+    "period_end": string;
+    "summary": GenAiEtlAuditSummary;
+    "cost_sources": ProviderCostSource[];
+    "clusters": GenAiEtlAuditCluster[];
+}
+export interface GenAiEtlClusterScenario {
+    "cluster_id": string;
+    "coverage": number;
+    "frontier_cost_per_call_usd"?: number;
+    "alternative_cost_per_call_usd": number;
+    "period_maintenance_cost_usd": number;
+    "period_error_cost_usd": number;
+}
+export interface GenAiEtlAuditEvaluationRequest {
+    "scenarios": GenAiEtlClusterScenario[];
+}
+export interface GenAiEtlClusterEvaluation {
+    "cluster_id": string;
+    "status": GenAiEtlCalculationStatus;
+    "call_count": number;
+    "coverage": number;
+    "served_call_count": number;
+    "residual_call_count": number;
+    "frontier_cost_per_call_usd"?: number;
+    "frontier_cost_basis": ProviderCostAttribution;
+    "alternative_cost_per_call_usd": number;
+    "current_period_cost_usd"?: number;
+    "gross_replaceable_value_usd"?: number;
+    "period_maintenance_cost_usd": number;
+    "period_error_cost_usd": number;
+    "net_replaceable_value_usd"?: number;
+}
+export interface GenAiEtlAuditEvaluationResponse {
+    "generated_at": string;
+    "period_start": string;
+    "period_end": string;
+    "results": GenAiEtlClusterEvaluation[];
+}
 export interface LogStreamEvent {
     "type": "log";
     "data": LogRecord;

package/generated/ts-runtime/api.js

@@ -248,3 +248,107 @@ export const FetchTelemetryViewValues = {
     "logs": "logs",
     "mcpStats": "mcp_stats",
 };
+export const ProviderCostSourceKindValues = {
+    "actualBilledCost": "actual_billed_cost",
+    "officialPublicCatalog": "official_public_catalog",
+};
+export const ProviderCostSourceStatusValues = {
+    "unconfigured": "unconfigured",
+    "current": "current",
+    "stale": "stale",
+    "syncFailed": "sync_failed",
+    "notAttributable": "not_attributable",
+};
+export const ProviderCostAttributionValues = {
+    "providerModelPeriod": "provider_model_period",
+    "providerPeriod": "provider_period",
+    "scenario": "scenario",
+    "unavailable": "unavailable",
+};
+export const GenAiEtlPromotionGateKindValues = {
+    "contractStability": "contract_stability",
+    "offlineReplay": "offline_replay",
+    "calibratedConfidence": "calibrated_confidence",
+    "shadowTraffic": "shadow_traffic",
+    "limitedServing": "limited_serving",
+    "rollbackResidualPolicy": "rollback_residual_policy",
+};
+export const GenAiEtlPromotionGateStateValues = {
+    "passed": "passed",
+    "failed": "failed",
+    "notEvaluated": "not_evaluated",
+    "blockedMissingEvidence": "blocked_missing_evidence",
+};
+export const GenAiEtlOutputContractValues = {
+    "prose": "prose",
+    "label": "label",
+    "spanList": "span_list",
+    "record": "record",
+    "vector": "vector",
+    "catalogReference": "catalog_reference",
+    "number": "number",
+    "boolean": "boolean",
+    "unknown": "unknown",
+};
+export const GenAiEtlTaskFamilyValues = {
+    "openReasoningGeneration": "open_reasoning_generation",
+    "classification": "classification",
+    "sequenceLabeling": "sequence_labeling",
+    "structuredExtraction": "structured_extraction",
+    "retrievalEntityResolution": "retrieval_entity_resolution",
+    "similarityClustering": "similarity_clustering",
+    "normalizationTransformation": "normalization_transformation",
+    "numericAnalytical": "numeric_analytical",
+    "unknown": "unknown",
+};
+export const GenAiEtlCandidatePathValues = {
+    "exactCache": "exact_cache",
+    "deterministicCode": "deterministic_code",
+    "boundedRetrieval": "bounded_retrieval",
+    "smallClassifierExtractor": "small_classifier_extractor",
+    "smallerGenerativeModel": "smaller_generative_model",
+    "frontierModel": "frontier_model",
+    "insufficientEvidence": "insufficient_evidence",
+};
+export const GenAiEtlValidationMetricValues = {
+    "accuracy": "accuracy",
+    "macroF1": "macro_f1",
+    "spanF1": "span_f1",
+    "fieldExactMatch": "field_exact_match",
+    "schemaValidity": "schema_validity",
+    "matchAccuracy": "match_accuracy",
+    "recallAtK": "recall_at_k",
+    "meanReciprocalRank": "mean_reciprocal_rank",
+    "exactMatch": "exact_match",
+    "numericTolerance": "numeric_tolerance",
+    "humanPreference": "human_preference",
+    "taskSuccess": "task_success",
+    "unavailable": "unavailable",
+};
+export const GenAiEtlResidualPathValues = {
+    "frontierModel": "frontier_model",
+    "humanReview": "human_review",
+    "retry": "retry",
+    "degradedResponse": "degraded_response",
+    "none": "none",
+    "undetermined": "undetermined",
+};
+export const GenAiEtlEvidenceSignalValues = {
+    "workflowIdentity": "workflow_identity",
+    "outputContract": "output_contract",
+    "providerModel": "provider_model",
+    "tokenUsage": "token_usage",
+    "providerCost": "provider_cost",
+    "recurringSchema": "recurring_schema",
+    "boundedReference": "bounded_reference",
+    "taskMetric": "task_metric",
+    "acceptedOutputReplay": "accepted_output_replay",
+    "downstreamFate": "downstream_fate",
+    "calibratedConfidence": "calibrated_confidence",
+    "shadowComparison": "shadow_comparison",
+    "fallbackPolicy": "fallback_policy",
+};
+export const GenAiEtlCalculationStatusValues = {
+    "calculated": "calculated",
+    "missingFrontierCost": "missing_frontier_cost",
+};

package/index.tsp

@@ -23,6 +23,7 @@ import "./models/health.tsp";
 import "./models/runner.tsp";
 import "./models/runner-mcp.tsp";
 import "./models/mcp-tools.tsp";
+import "./models/cost-etl-audit.tsp";
 
 import "./api/routes.tsp";
 import "./api/streaming.tsp";