@contractspec/lib.metering 3.0.0 → 3.2.0

package/dist/browser/events.js

@@ -205,6 +205,45 @@ var ThresholdApproachingEvent = defineEvent({
   },
   payload: ThresholdApproachingPayload
 });
+var ModelSelectionPayload = defineSchemaModel({
+  name: "ModelSelectionEventPayload",
+  description: "Payload when an AI model is selected via ranking",
+  fields: {
+    modelId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    providerKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    dimension: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    score: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    alternativesCount: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false
+    },
+    costEstimateInput: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    costEstimateOutput: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    selectionDurationMs: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ModelSelectionEvent = defineEvent({
+  meta: {
+    key: "model.selected",
+    version: "1.0.0",
+    description: "An AI model has been selected via ranking-driven selection.",
+    stability: "experimental",
+    owners: ["@platform.metering"],
+    tags: ["metering", "ai", "model-selection"]
+  },
+  payload: ModelSelectionPayload
+});
 var MeteringEvents = {
   MetricDefinedEvent,
   MetricUpdatedEvent,
@@ -213,7 +252,8 @@ var MeteringEvents = {
   UsageAggregatedEvent,
   ThresholdCreatedEvent,
   ThresholdExceededEvent,
-  ThresholdApproachingEvent
+  ThresholdApproachingEvent,
+  ModelSelectionEvent
 };
 export {
   UsageRecordedEvent,
@@ -222,6 +262,7 @@ export {
   ThresholdExceededEvent,
   ThresholdCreatedEvent,
   ThresholdApproachingEvent,
+  ModelSelectionEvent,
   MetricUpdatedEvent,
   MetricDefinedEvent,
   MeteringEvents

package/dist/browser/index.js

@@ -1770,6 +1770,45 @@ var ThresholdApproachingEvent = defineEvent({
   },
   payload: ThresholdApproachingPayload
 });
+var ModelSelectionPayload = defineSchemaModel2({
+  name: "ModelSelectionEventPayload",
+  description: "Payload when an AI model is selected via ranking",
+  fields: {
+    modelId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    providerKey: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    dimension: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    score: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    alternativesCount: {
+      type: ScalarTypeEnum2.Int_unsecure(),
+      isOptional: false
+    },
+    costEstimateInput: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    costEstimateOutput: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    selectionDurationMs: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ModelSelectionEvent = defineEvent({
+  meta: {
+    key: "model.selected",
+    version: "1.0.0",
+    description: "An AI model has been selected via ranking-driven selection.",
+    stability: "experimental",
+    owners: ["@platform.metering"],
+    tags: ["metering", "ai", "model-selection"]
+  },
+  payload: ModelSelectionPayload
+});
 var MeteringEvents = {
   MetricDefinedEvent,
   MetricUpdatedEvent,
@@ -1778,7 +1817,8 @@ var MeteringEvents = {
   UsageAggregatedEvent,
   ThresholdCreatedEvent,
   ThresholdExceededEvent,
-  ThresholdApproachingEvent
+  ThresholdApproachingEvent,
+  ModelSelectionEvent
 };
 
 // src/metering.feature.ts
@@ -1859,6 +1899,7 @@ export {
   PosthogMeteringReporter,
   PosthogMeteringReader,
   PeriodTypeEnum,
+  ModelSelectionEvent,
   MetricUpdatedEvent,
   MetricDefinitionModel,
   MetricDefinitionEntity,

package/dist/events.d.ts

@@ -274,6 +274,51 @@ export declare const ThresholdApproachingEvent: import("@contractspec/lib.contra
         isOptional: false;
     };
 }>>;
+/**
+ * Emitted when a model is selected via ranking-driven selection.
+ */
+export declare const ModelSelectionEvent: import("@contractspec/lib.contracts-spec").EventSpec<import("@contractspec/lib.schema").SchemaModel<{
+    modelId: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    providerKey: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    dimension: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    score: {
+        type: import("@contractspec/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    reason: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    alternativesCount: {
+        type: import("@contractspec/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    costEstimateInput: {
+        type: import("@contractspec/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    costEstimateOutput: {
+        type: import("@contractspec/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    selectionDurationMs: {
+        type: import("@contractspec/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    timestamp: {
+        type: import("@contractspec/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>>;
 /**
  * All metering events.
  */
@@ -530,4 +575,46 @@ export declare const MeteringEvents: {
             isOptional: false;
         };
     }>>;
+    ModelSelectionEvent: import("@contractspec/lib.contracts-spec").EventSpec<import("@contractspec/lib.schema").SchemaModel<{
+        modelId: {
+            type: import("@contractspec/lib.schema").FieldType<string, string>;
+            isOptional: false;
+        };
+        providerKey: {
+            type: import("@contractspec/lib.schema").FieldType<string, string>;
+            isOptional: false;
+        };
+        dimension: {
+            type: import("@contractspec/lib.schema").FieldType<string, string>;
+            isOptional: true;
+        };
+        score: {
+            type: import("@contractspec/lib.schema").FieldType<number, number>;
+            isOptional: false;
+        };
+        reason: {
+            type: import("@contractspec/lib.schema").FieldType<string, string>;
+            isOptional: false;
+        };
+        alternativesCount: {
+            type: import("@contractspec/lib.schema").FieldType<number, number>;
+            isOptional: false;
+        };
+        costEstimateInput: {
+            type: import("@contractspec/lib.schema").FieldType<number, number>;
+            isOptional: true;
+        };
+        costEstimateOutput: {
+            type: import("@contractspec/lib.schema").FieldType<number, number>;
+            isOptional: true;
+        };
+        selectionDurationMs: {
+            type: import("@contractspec/lib.schema").FieldType<number, number>;
+            isOptional: true;
+        };
+        timestamp: {
+            type: import("@contractspec/lib.schema").FieldType<Date, string>;
+            isOptional: false;
+        };
+    }>>;
 };

package/dist/events.js

@@ -206,6 +206,45 @@ var ThresholdApproachingEvent = defineEvent({
   },
   payload: ThresholdApproachingPayload
 });
+var ModelSelectionPayload = defineSchemaModel({
+  name: "ModelSelectionEventPayload",
+  description: "Payload when an AI model is selected via ranking",
+  fields: {
+    modelId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    providerKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    dimension: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    score: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    alternativesCount: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false
+    },
+    costEstimateInput: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    costEstimateOutput: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    selectionDurationMs: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ModelSelectionEvent = defineEvent({
+  meta: {
+    key: "model.selected",
+    version: "1.0.0",
+    description: "An AI model has been selected via ranking-driven selection.",
+    stability: "experimental",
+    owners: ["@platform.metering"],
+    tags: ["metering", "ai", "model-selection"]
+  },
+  payload: ModelSelectionPayload
+});
 var MeteringEvents = {
   MetricDefinedEvent,
   MetricUpdatedEvent,
@@ -214,7 +253,8 @@ var MeteringEvents = {
   UsageAggregatedEvent,
   ThresholdCreatedEvent,
   ThresholdExceededEvent,
-  ThresholdApproachingEvent
+  ThresholdApproachingEvent,
+  ModelSelectionEvent
 };
 export {
   UsageRecordedEvent,
@@ -223,6 +263,7 @@ export {
   ThresholdExceededEvent,
   ThresholdCreatedEvent,
   ThresholdApproachingEvent,
+  ModelSelectionEvent,
   MetricUpdatedEvent,
   MetricDefinedEvent,
   MeteringEvents

package/dist/index.js

@@ -1771,6 +1771,45 @@ var ThresholdApproachingEvent = defineEvent({
   },
   payload: ThresholdApproachingPayload
 });
+var ModelSelectionPayload = defineSchemaModel2({
+  name: "ModelSelectionEventPayload",
+  description: "Payload when an AI model is selected via ranking",
+  fields: {
+    modelId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    providerKey: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    dimension: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    score: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    alternativesCount: {
+      type: ScalarTypeEnum2.Int_unsecure(),
+      isOptional: false
+    },
+    costEstimateInput: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    costEstimateOutput: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    selectionDurationMs: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ModelSelectionEvent = defineEvent({
+  meta: {
+    key: "model.selected",
+    version: "1.0.0",
+    description: "An AI model has been selected via ranking-driven selection.",
+    stability: "experimental",
+    owners: ["@platform.metering"],
+    tags: ["metering", "ai", "model-selection"]
+  },
+  payload: ModelSelectionPayload
+});
 var MeteringEvents = {
   MetricDefinedEvent,
   MetricUpdatedEvent,
@@ -1779,7 +1818,8 @@ var MeteringEvents = {
   UsageAggregatedEvent,
   ThresholdCreatedEvent,
   ThresholdExceededEvent,
-  ThresholdApproachingEvent
+  ThresholdApproachingEvent,
+  ModelSelectionEvent
 };
 
 // src/metering.feature.ts
@@ -1860,6 +1900,7 @@ export {
   PosthogMeteringReporter,
   PosthogMeteringReader,
   PeriodTypeEnum,
+  ModelSelectionEvent,
   MetricUpdatedEvent,
   MetricDefinitionModel,
   MetricDefinitionEntity,

package/dist/node/events.js

@@ -205,6 +205,45 @@ var ThresholdApproachingEvent = defineEvent({
   },
   payload: ThresholdApproachingPayload
 });
+var ModelSelectionPayload = defineSchemaModel({
+  name: "ModelSelectionEventPayload",
+  description: "Payload when an AI model is selected via ranking",
+  fields: {
+    modelId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    providerKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    dimension: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    score: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    alternativesCount: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false
+    },
+    costEstimateInput: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    costEstimateOutput: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    selectionDurationMs: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ModelSelectionEvent = defineEvent({
+  meta: {
+    key: "model.selected",
+    version: "1.0.0",
+    description: "An AI model has been selected via ranking-driven selection.",
+    stability: "experimental",
+    owners: ["@platform.metering"],
+    tags: ["metering", "ai", "model-selection"]
+  },
+  payload: ModelSelectionPayload
+});
 var MeteringEvents = {
   MetricDefinedEvent,
   MetricUpdatedEvent,
@@ -213,7 +252,8 @@ var MeteringEvents = {
   UsageAggregatedEvent,
   ThresholdCreatedEvent,
   ThresholdExceededEvent,
-  ThresholdApproachingEvent
+  ThresholdApproachingEvent,
+  ModelSelectionEvent
 };
 export {
   UsageRecordedEvent,
@@ -222,6 +262,7 @@ export {
   ThresholdExceededEvent,
   ThresholdCreatedEvent,
   ThresholdApproachingEvent,
+  ModelSelectionEvent,
   MetricUpdatedEvent,
   MetricDefinedEvent,
   MeteringEvents

package/dist/node/index.js

@@ -1770,6 +1770,45 @@ var ThresholdApproachingEvent = defineEvent({
   },
   payload: ThresholdApproachingPayload
 });
+var ModelSelectionPayload = defineSchemaModel2({
+  name: "ModelSelectionEventPayload",
+  description: "Payload when an AI model is selected via ranking",
+  fields: {
+    modelId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    providerKey: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    dimension: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    score: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    alternativesCount: {
+      type: ScalarTypeEnum2.Int_unsecure(),
+      isOptional: false
+    },
+    costEstimateInput: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    costEstimateOutput: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    selectionDurationMs: {
+      type: ScalarTypeEnum2.Float_unsecure(),
+      isOptional: true
+    },
+    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ModelSelectionEvent = defineEvent({
+  meta: {
+    key: "model.selected",
+    version: "1.0.0",
+    description: "An AI model has been selected via ranking-driven selection.",
+    stability: "experimental",
+    owners: ["@platform.metering"],
+    tags: ["metering", "ai", "model-selection"]
+  },
+  payload: ModelSelectionPayload
+});
 var MeteringEvents = {
   MetricDefinedEvent,
   MetricUpdatedEvent,
@@ -1778,7 +1817,8 @@ var MeteringEvents = {
   UsageAggregatedEvent,
   ThresholdCreatedEvent,
   ThresholdExceededEvent,
-  ThresholdApproachingEvent
+  ThresholdApproachingEvent,
+  ModelSelectionEvent
 };
 
 // src/metering.feature.ts
@@ -1859,6 +1899,7 @@ export {
   PosthogMeteringReporter,
   PosthogMeteringReader,
   PeriodTypeEnum,
+  ModelSelectionEvent,
   MetricUpdatedEvent,
   MetricDefinitionModel,
   MetricDefinitionEntity,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.metering",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Usage metering and billing core module for ContractSpec applications",
   "keywords": [
     "contractspec",
@@ -27,15 +27,15 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "3.0.0",
-    "@contractspec/lib.contracts-spec": "3.0.0",
-    "@contractspec/lib.contracts-integrations": "3.0.0",
+    "@contractspec/lib.schema": "3.2.0",
+    "@contractspec/lib.contracts-spec": "3.2.0",
+    "@contractspec/lib.contracts-integrations": "3.2.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.0.0",
+    "@contractspec/tool.typescript": "3.2.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.0.0"
+    "@contractspec/tool.bun": "3.2.0"
   },
   "exports": {
     ".": {