@dcdr/contracts 2.4.3 → 2.5.0

package/README.md

@@ -37,6 +37,7 @@ On top of that, every failure can be reviewed, corrected, and turned into traini
 
 - **Public TypeScript contracts** (interfaces/enums) for DCDR Registries and runtime API payloads.
 - **`DcdrRuntimeClient`**: a strongly-typed TypeScript HTTP client for calling a DCDR Runtime instance.
+- **Tracked-call rating metadata**: a shared, versioned multimodal multiplier matrix that backend/UI can render and audit consistently with runtime behavior.
 
 ## Who should use it
 

package/dist/execution.contract.d.ts

@@ -318,12 +318,30 @@ export interface ExecutionTrackedCallAccounting {
     trackedCallsMultiplier?: number;
     /** Human-readable explanation of the final tracked-call rating. */
     trackedCallsRatingReason?: string;
+    /** Optional coarse context describing how the final rating was chosen. */
+    trackedCallsRatingContext?: string;
     /** Optional aggregate input size used by rating. */
     inputSizeBytes?: number;
+    /** Optional aggregate known non-text input size used by guardrails. */
+    aggregateInputSizeBytes?: number;
+    /** Optional aggregate floor multiplier applied by guardrails. */
+    aggregateInputSizeMultiplier?: number;
     /** Optional aggregate output size used by rating. */
     outputSizeBytes?: number;
     /** Optional input asset count used by rating. */
     inputAssetCount?: number;
+    /** Optional dominant modality that determined the per-part winning bucket. */
+    dominantModality?: ExecutionPartType;
+    /** Optional dominant source type that determined the per-part winning bucket. */
+    dominantSourceType?: ExecutionPartSourceKind;
+    /** Optional dominant known size used by the per-part winning bucket. */
+    dominantSizeBytes?: number;
+    /** Optional dominant part index used by the per-part winning bucket. */
+    dominantPartIndex?: number;
+    /** Optional dominant bucket reason when a coarse context is also present. */
+    dominantRatingReason?: string;
+    /** Optional distinct per-part reasons observed during rating. */
+    observedRatingReasons?: string[];
     /** Optional output asset count used by rating. */
     outputAssetCount?: number;
     /** Optional document page count used by rating. */

package/dist/execution.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution.contract.d.ts","sourceRoot":"","sources":["../src/execution.contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execution.contract.d.ts","sourceRoot":"","sources":["../src/execution.contract.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export * from "./runtime.client";
 export * from "./utils.contract";
 export * from "./cache.contract";
 export * from "./storage.credentials.contract";
+export * from "./tracked-call-rating.contract";
 export * from "./prompt-variable-schema.contract";
 export * from "./registry.stats.contract";
 export { ASSET_TYPE_VALUES, ASSET_TYPE_LABELS, DcdrAssetScope, DcdrAssetMetadata, DcdrAssetMetadataAttributes, DcdrAssetStorageDescriptor, DcdrAssetUploadRequest, DcdrAssetUploadResponse, DcdrAssetGetRequest, DcdrAssetGetResponse, DcdrAssetDeleteRequest, DcdrAssetDeleteResponse, } from "./asset.contract";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAM1C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAM1C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -36,6 +36,7 @@ __exportStar(require("./runtime.client"), exports);
 __exportStar(require("./utils.contract"), exports);
 __exportStar(require("./cache.contract"), exports);
 __exportStar(require("./storage.credentials.contract"), exports);
+__exportStar(require("./tracked-call-rating.contract"), exports);
 __exportStar(require("./prompt-variable-schema.contract"), exports);
 __exportStar(require("./registry.stats.contract"), exports);
 // Asset contract surface — symbols not already re-exported via execution.contract.

package/dist/tracked-call-rating.contract.d.ts

@@ -0,0 +1,128 @@
+import { AssetType as ExecutionPartType, ExecutionPartSourceKind } from "./execution.contract";
+/**
+ * Stable semantic family used by the tracked-call rating matrix.
+ *
+ * Notes
+ * - This is intentionally narrower than the full execution/report domain.
+ * - Values align with `ExecutionPartType` so UI and runtime can map directly.
+ */
+export declare enum TrackedCallRatingAssetFamily {
+    TEXT = "text",
+    DOCUMENT = "document",
+    IMAGE = "image",
+    AUDIO = "audio",
+    VIDEO = "video"
+}
+/**
+ * Source-family selector used by tracked-call rating buckets.
+ */
+export declare enum TrackedCallRatingSourceKind {
+    ANY = "ANY",
+    INLINE = "INLINE",
+    URL = "URL",
+    ASSET = "ASSET"
+}
+/**
+ * Bucket matching mode used by tracked-call rating rows.
+ */
+export declare enum TrackedCallRatingBucketKind {
+    ANY_SIZE = "ANY_SIZE",
+    SIZE_RANGE = "SIZE_RANGE",
+    UNKNOWN_SIZE = "UNKNOWN_SIZE"
+}
+/**
+ * Lifecycle status for a tracked-call rating matrix snapshot.
+ */
+export declare enum TrackedCallRatingMatrixStatus {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    DEPRECATED = "DEPRECATED"
+}
+/**
+ * Combination rule used when multiple multimodal parts are present.
+ */
+export declare enum TrackedCallRatingCombinationStrategy {
+    MAX_BUCKET = "MAX_BUCKET"
+}
+/**
+ * One rated bucket row inside the tracked-call matrix.
+ */
+export interface TrackedCallRatingBucket {
+    /** Stable row identifier for UI/debugging. */
+    id: string;
+    /** Rated semantic family. */
+    assetFamily: TrackedCallRatingAssetFamily;
+    /** Applicable source kind or `ANY`. */
+    sourceKind: TrackedCallRatingSourceKind;
+    /** Matching mode for this bucket. */
+    bucketKind: TrackedCallRatingBucketKind;
+    /** Inclusive lower bound when `bucketKind=SIZE_RANGE`. */
+    minSizeBytes?: number;
+    /** Exclusive upper bound when `bucketKind=SIZE_RANGE`. */
+    maxSizeBytesExclusive?: number;
+    /** Applied tracked-call multiplier. */
+    multiplier: number;
+    /** Stable reason stored in execution reports. */
+    reason: string;
+    /** Optional human note for UI/docs. */
+    notes?: string;
+}
+/**
+ * Aggregate floor row used to prevent large batches of small parts from rating
+ * like trivial requests.
+ */
+export interface TrackedCallAggregateGuardrailBucket {
+    /** Stable row identifier for UI/debugging. */
+    id: string;
+    /** Inclusive lower bound for known non-text aggregate bytes. */
+    minTotalNonTextBytes?: number;
+    /** Exclusive upper bound for known non-text aggregate bytes. */
+    maxTotalNonTextBytesExclusive?: number;
+    /** Minimum final multiplier enforced by this guardrail. */
+    minMultiplier: number;
+    /** Stable reason/context for auditability. */
+    reason: string;
+}
+/**
+ * Declarative tracked-call rating matrix shared by runtime and backend/UI.
+ */
+export interface TrackedCallRatingMatrix {
+    /** Stable matrix identifier. */
+    id: string;
+    /** Version string used for auditability. */
+    version: string;
+    /** Lifecycle status for this matrix snapshot. */
+    status: TrackedCallRatingMatrixStatus;
+    /** Base tracked-call count before multipliers. */
+    baseTrackedCalls: number;
+    /** Combination rule used across multiple parts. */
+    mixedModalityStrategy: TrackedCallRatingCombinationStrategy;
+    /** Bucket rows matched against individual parts. */
+    buckets: TrackedCallRatingBucket[];
+    /** Optional aggregate non-text size floors. */
+    aggregateGuardrails?: TrackedCallAggregateGuardrailBucket[];
+    /** Optional explanatory notes for UI/docs. */
+    notes?: string[];
+}
+/**
+ * Default tracked-call rating matrix for multimodal v1.
+ *
+ * Notes
+ * - Keeps the public unit as tracked calls.
+ * - Uses bounded, auditable size buckets instead of continuous formulas.
+ * - Intended to be shared by runtime, backend, and UI.
+ */
+export declare const DEFAULT_TRACKED_CALL_RATING_MATRIX_V1: TrackedCallRatingMatrix;
+/**
+ * Returns the default tracked-call rating matrix used by runtime v1.
+ */
+export declare function getDefaultTrackedCallRatingMatrix(): TrackedCallRatingMatrix;
+/**
+ * Maps an execution part type to the tracked-call family when the domains align.
+ */
+export declare function toTrackedCallRatingAssetFamily(value: ExecutionPartType): TrackedCallRatingAssetFamily | null;
+/**
+ * Maps the execution source kind into the tracked-call matrix domain.
+ */
+export declare function toTrackedCallRatingSourceKind(value?: ExecutionPartSourceKind): TrackedCallRatingSourceKind;
+//# sourceMappingURL=tracked-call-rating.contract.d.ts.map

package/dist/tracked-call-rating.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-call-rating.contract.d.ts","sourceRoot":"","sources":["../src/tracked-call-rating.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,IAAI,iBAAiB,EAC9B,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,oBAAY,4BAA4B;IACtC,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,2BAA2B;IACrC,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,2BAA2B;IACrC,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,oBAAY,6BAA6B;IACvC,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,oBAAY,oCAAoC;IAC9C,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IAEX,6BAA6B;IAC7B,WAAW,EAAE,4BAA4B,CAAC;IAE1C,uCAAuC;IACvC,UAAU,EAAE,2BAA2B,CAAC;IAExC,qCAAqC;IACrC,UAAU,EAAE,2BAA2B,CAAC;IAExC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0DAA0D;IAC1D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IAEX,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,gEAAgE;IAChE,6BAA6B,CAAC,EAAE,MAAM,CAAC;IAEvC,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,MAAM,EAAE,6BAA6B,CAAC;IAEtC,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IAEzB,mDAAmD;IACnD,qBAAqB,EAAE,oCAAoC,CAAC;IAE5D,oDAAoD;IACpD,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAEnC,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,mCAAmC,EAAE,CAAC;IAE5D,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAKD;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,EAAE,uBA0MnD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,uBAAuB,CAE3E;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,iBAAiB,GACvB,4BAA4B,GAAG,IAAI,CAerC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,EAAE,uBAAuB,GAC9B,2BAA2B,CAW7B"}

package/dist/tracked-call-rating.contract.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TRACKED_CALL_RATING_MATRIX_V1 = exports.TrackedCallRatingCombinationStrategy = exports.TrackedCallRatingMatrixStatus = exports.TrackedCallRatingBucketKind = exports.TrackedCallRatingSourceKind = exports.TrackedCallRatingAssetFamily = void 0;
+exports.getDefaultTrackedCallRatingMatrix = getDefaultTrackedCallRatingMatrix;
+exports.toTrackedCallRatingAssetFamily = toTrackedCallRatingAssetFamily;
+exports.toTrackedCallRatingSourceKind = toTrackedCallRatingSourceKind;
+const execution_contract_1 = require("./execution.contract");
+/**
+ * Stable semantic family used by the tracked-call rating matrix.
+ *
+ * Notes
+ * - This is intentionally narrower than the full execution/report domain.
+ * - Values align with `ExecutionPartType` so UI and runtime can map directly.
+ */
+var TrackedCallRatingAssetFamily;
+(function (TrackedCallRatingAssetFamily) {
+    TrackedCallRatingAssetFamily["TEXT"] = "text";
+    TrackedCallRatingAssetFamily["DOCUMENT"] = "document";
+    TrackedCallRatingAssetFamily["IMAGE"] = "image";
+    TrackedCallRatingAssetFamily["AUDIO"] = "audio";
+    TrackedCallRatingAssetFamily["VIDEO"] = "video";
+})(TrackedCallRatingAssetFamily || (exports.TrackedCallRatingAssetFamily = TrackedCallRatingAssetFamily = {}));
+/**
+ * Source-family selector used by tracked-call rating buckets.
+ */
+var TrackedCallRatingSourceKind;
+(function (TrackedCallRatingSourceKind) {
+    TrackedCallRatingSourceKind["ANY"] = "ANY";
+    TrackedCallRatingSourceKind["INLINE"] = "INLINE";
+    TrackedCallRatingSourceKind["URL"] = "URL";
+    TrackedCallRatingSourceKind["ASSET"] = "ASSET";
+})(TrackedCallRatingSourceKind || (exports.TrackedCallRatingSourceKind = TrackedCallRatingSourceKind = {}));
+/**
+ * Bucket matching mode used by tracked-call rating rows.
+ */
+var TrackedCallRatingBucketKind;
+(function (TrackedCallRatingBucketKind) {
+    TrackedCallRatingBucketKind["ANY_SIZE"] = "ANY_SIZE";
+    TrackedCallRatingBucketKind["SIZE_RANGE"] = "SIZE_RANGE";
+    TrackedCallRatingBucketKind["UNKNOWN_SIZE"] = "UNKNOWN_SIZE";
+})(TrackedCallRatingBucketKind || (exports.TrackedCallRatingBucketKind = TrackedCallRatingBucketKind = {}));
+/**
+ * Lifecycle status for a tracked-call rating matrix snapshot.
+ */
+var TrackedCallRatingMatrixStatus;
+(function (TrackedCallRatingMatrixStatus) {
+    TrackedCallRatingMatrixStatus["DRAFT"] = "DRAFT";
+    TrackedCallRatingMatrixStatus["ACTIVE"] = "ACTIVE";
+    TrackedCallRatingMatrixStatus["DEPRECATED"] = "DEPRECATED";
+})(TrackedCallRatingMatrixStatus || (exports.TrackedCallRatingMatrixStatus = TrackedCallRatingMatrixStatus = {}));
+/**
+ * Combination rule used when multiple multimodal parts are present.
+ */
+var TrackedCallRatingCombinationStrategy;
+(function (TrackedCallRatingCombinationStrategy) {
+    TrackedCallRatingCombinationStrategy["MAX_BUCKET"] = "MAX_BUCKET";
+})(TrackedCallRatingCombinationStrategy || (exports.TrackedCallRatingCombinationStrategy = TrackedCallRatingCombinationStrategy = {}));
+const KB = 1024;
+const MB = 1024 * 1024;
+/**
+ * Default tracked-call rating matrix for multimodal v1.
+ *
+ * Notes
+ * - Keeps the public unit as tracked calls.
+ * - Uses bounded, auditable size buckets instead of continuous formulas.
+ * - Intended to be shared by runtime, backend, and UI.
+ */
+exports.DEFAULT_TRACKED_CALL_RATING_MATRIX_V1 = {
+    id: "default-multimodal-tracked-calls-v1",
+    version: "1.0",
+    status: TrackedCallRatingMatrixStatus.ACTIVE,
+    baseTrackedCalls: 1,
+    mixedModalityStrategy: TrackedCallRatingCombinationStrategy.MAX_BUCKET,
+    buckets: [
+        {
+            id: "text-any",
+            assetFamily: TrackedCallRatingAssetFamily.TEXT,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.ANY_SIZE,
+            multiplier: 1,
+            reason: "text_any_size",
+            notes: "Text remains 1.0x in v1 and is governed by separate token/size limits.",
+        },
+        {
+            id: "document-lt-1mb",
+            assetFamily: TrackedCallRatingAssetFamily.DOCUMENT,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 0,
+            maxSizeBytesExclusive: 1 * MB,
+            multiplier: 1,
+            reason: "document_size_lt_1mb",
+        },
+        {
+            id: "document-1mb-10mb",
+            assetFamily: TrackedCallRatingAssetFamily.DOCUMENT,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 1 * MB,
+            maxSizeBytesExclusive: 10 * MB,
+            multiplier: 1.5,
+            reason: "document_size_1mb_10mb",
+        },
+        {
+            id: "document-10mb-50mb",
+            assetFamily: TrackedCallRatingAssetFamily.DOCUMENT,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 10 * MB,
+            maxSizeBytesExclusive: 50 * MB,
+            multiplier: 2,
+            reason: "document_size_10mb_50mb",
+        },
+        {
+            id: "document-gte-50mb",
+            assetFamily: TrackedCallRatingAssetFamily.DOCUMENT,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 50 * MB,
+            multiplier: 3,
+            reason: "document_size_gte_50mb",
+        },
+        {
+            id: "document-unknown",
+            assetFamily: TrackedCallRatingAssetFamily.DOCUMENT,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.UNKNOWN_SIZE,
+            multiplier: 1.5,
+            reason: "document_size_unknown",
+        },
+        {
+            id: "image-lt-512kb",
+            assetFamily: TrackedCallRatingAssetFamily.IMAGE,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 0,
+            maxSizeBytesExclusive: 512 * KB,
+            multiplier: 1,
+            reason: "image_size_lt_512kb",
+        },
+        {
+            id: "image-512kb-5mb",
+            assetFamily: TrackedCallRatingAssetFamily.IMAGE,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 512 * KB,
+            maxSizeBytesExclusive: 5 * MB,
+            multiplier: 1.5,
+            reason: "image_size_512kb_5mb",
+        },
+        {
+            id: "image-gte-5mb",
+            assetFamily: TrackedCallRatingAssetFamily.IMAGE,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 5 * MB,
+            multiplier: 2,
+            reason: "image_size_gte_5mb",
+        },
+        {
+            id: "image-unknown",
+            assetFamily: TrackedCallRatingAssetFamily.IMAGE,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.UNKNOWN_SIZE,
+            multiplier: 1.5,
+            reason: "image_size_unknown",
+        },
+        {
+            id: "audio-lt-1mb",
+            assetFamily: TrackedCallRatingAssetFamily.AUDIO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 0,
+            maxSizeBytesExclusive: 1 * MB,
+            multiplier: 1.25,
+            reason: "audio_size_lt_1mb",
+        },
+        {
+            id: "audio-1mb-10mb",
+            assetFamily: TrackedCallRatingAssetFamily.AUDIO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 1 * MB,
+            maxSizeBytesExclusive: 10 * MB,
+            multiplier: 2,
+            reason: "audio_size_1mb_10mb",
+        },
+        {
+            id: "audio-gte-10mb",
+            assetFamily: TrackedCallRatingAssetFamily.AUDIO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 10 * MB,
+            multiplier: 3,
+            reason: "audio_size_gte_10mb",
+        },
+        {
+            id: "audio-unknown",
+            assetFamily: TrackedCallRatingAssetFamily.AUDIO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.UNKNOWN_SIZE,
+            multiplier: 2,
+            reason: "audio_size_unknown",
+        },
+        {
+            id: "video-lt-5mb",
+            assetFamily: TrackedCallRatingAssetFamily.VIDEO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 0,
+            maxSizeBytesExclusive: 5 * MB,
+            multiplier: 2,
+            reason: "video_size_lt_5mb",
+        },
+        {
+            id: "video-5mb-100mb",
+            assetFamily: TrackedCallRatingAssetFamily.VIDEO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 5 * MB,
+            maxSizeBytesExclusive: 100 * MB,
+            multiplier: 3,
+            reason: "video_size_5mb_100mb",
+        },
+        {
+            id: "video-gte-100mb",
+            assetFamily: TrackedCallRatingAssetFamily.VIDEO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.SIZE_RANGE,
+            minSizeBytes: 100 * MB,
+            multiplier: 4,
+            reason: "video_size_gte_100mb",
+        },
+        {
+            id: "video-unknown",
+            assetFamily: TrackedCallRatingAssetFamily.VIDEO,
+            sourceKind: TrackedCallRatingSourceKind.ANY,
+            bucketKind: TrackedCallRatingBucketKind.UNKNOWN_SIZE,
+            multiplier: 3,
+            reason: "video_size_unknown",
+        },
+    ],
+    aggregateGuardrails: [
+        {
+            id: "aggregate-non-text-10mb-50mb",
+            minTotalNonTextBytes: 10 * MB,
+            maxTotalNonTextBytesExclusive: 50 * MB,
+            minMultiplier: 1.5,
+            reason: "aggregate_non_text_size_10mb_50mb",
+        },
+        {
+            id: "aggregate-non-text-50mb-200mb",
+            minTotalNonTextBytes: 50 * MB,
+            maxTotalNonTextBytesExclusive: 200 * MB,
+            minMultiplier: 2,
+            reason: "aggregate_non_text_size_50mb_200mb",
+        },
+        {
+            id: "aggregate-non-text-gte-200mb",
+            minTotalNonTextBytes: 200 * MB,
+            minMultiplier: 3,
+            reason: "aggregate_non_text_size_gte_200mb",
+        },
+    ],
+    notes: [
+        "Uses max-bucket rating plus an aggregate non-text size floor.",
+        "Does not fetch remote URLs or managed assets only for rating.",
+        "Tracked-call multipliers may be fractional and should be aggregated before rounding.",
+    ],
+};
+/**
+ * Returns the default tracked-call rating matrix used by runtime v1.
+ */
+function getDefaultTrackedCallRatingMatrix() {
+    return exports.DEFAULT_TRACKED_CALL_RATING_MATRIX_V1;
+}
+/**
+ * Maps an execution part type to the tracked-call family when the domains align.
+ */
+function toTrackedCallRatingAssetFamily(value) {
+    switch (value) {
+        case execution_contract_1.AssetType.TEXT:
+            return TrackedCallRatingAssetFamily.TEXT;
+        case execution_contract_1.AssetType.DOCUMENT:
+            return TrackedCallRatingAssetFamily.DOCUMENT;
+        case execution_contract_1.AssetType.IMAGE:
+            return TrackedCallRatingAssetFamily.IMAGE;
+        case execution_contract_1.AssetType.AUDIO:
+            return TrackedCallRatingAssetFamily.AUDIO;
+        case execution_contract_1.AssetType.VIDEO:
+            return TrackedCallRatingAssetFamily.VIDEO;
+        default:
+            return null;
+    }
+}
+/**
+ * Maps the execution source kind into the tracked-call matrix domain.
+ */
+function toTrackedCallRatingSourceKind(value) {
+    switch (value) {
+        case execution_contract_1.ExecutionPartSourceKind.INLINE:
+            return TrackedCallRatingSourceKind.INLINE;
+        case execution_contract_1.ExecutionPartSourceKind.URL:
+            return TrackedCallRatingSourceKind.URL;
+        case execution_contract_1.ExecutionPartSourceKind.ASSET:
+            return TrackedCallRatingSourceKind.ASSET;
+        default:
+            return TrackedCallRatingSourceKind.ANY;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcdr/contracts",
-  "version": "2.4.3",
+  "version": "2.5.0",
   "homepage": "https://dcdr.ai",
   "description": "TypeScript contracts and runtime client for DCDR intent-based AI execution",
   "private": false,
@@ -51,6 +51,7 @@
     ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
     "./asset.contract": { "types": "./dist/asset.contract.d.ts", "default": "./dist/asset.contract.js" },
     "./storage.credentials.contract": { "types": "./dist/storage.credentials.contract.d.ts", "default": "./dist/storage.credentials.contract.js" },
+    "./tracked-call-rating.contract": { "types": "./dist/tracked-call-rating.contract.d.ts", "default": "./dist/tracked-call-rating.contract.js" },
     "./runtime.client": { "types": "./dist/runtime.client.d.ts", "default": "./dist/runtime.client.js" },
     "./cache.contract": { "types": "./dist/cache.contract.d.ts", "default": "./dist/cache.contract.js" },
     "./capabilities.contract": { "types": "./dist/capabilities.contract.d.ts", "default": "./dist/capabilities.contract.js" },
@@ -78,6 +79,7 @@
     "*": {
       "asset.contract": ["dist/asset.contract.d.ts"],
       "storage.credentials.contract": ["dist/storage.credentials.contract.d.ts"],
+      "tracked-call-rating.contract": ["dist/tracked-call-rating.contract.d.ts"],
       "runtime.client": ["dist/runtime.client.d.ts"],
       "cache.contract": ["dist/cache.contract.d.ts"],
       "capabilities.contract": ["dist/capabilities.contract.d.ts"],