@fourier-labs/harbour-contracts 0.11.0 → 0.12.0

package/README.md

@@ -35,7 +35,7 @@ exist here first.
 | `ai-runtime-binding.schema.json` | Platform-neutral workload identity/secret binding | AI governance §5.8 |
 | `binding-classification-subject.schema.json` | Complete value-free binding-name classification before version allocation | AI governance §5.7 / SEC-UP-01 |
 | `sanitized-binding-evidence.schema.json` | Exact-version sanitized runtime-binding allocation receipt | AI governance §5.7 / SEC-UP-02 |
-| `ai-pricing-revision`, `ai-metering-policy`, `ai-budget-ledger-event`, `ai-trace-event-v2` | Additive metering v2 records; v1 records remain readable | AI governance §9 |
+| `ai-pricing-revision`, `ai-metering-policy`, `ai-budget-ledger-event`, `ai-trace-event-v2` | Additive metering v2 records, including media dimensions and P5 trace attribution; v1 records remain readable | AI governance §9 |
 
 Two schemas carry logic beyond structural types, generated into helpers:
 

package/contract-release.json

@@ -1,18 +1,18 @@
 {
   "schema": "harbour.contract-release/1.0",
-  "repositoryVersion": "0.11.0.0",
-  "publishVersion": "0.11.0",
-  "publishTag": "v0.11.0",
-  "schemasDigest": "sha256:76b4a8c59792cf8a986af9c5ec4848a7ec3292c933c9ecb35e73cd96dcddcd57",
-  "aiFixturesDigest": "sha256:8bea1c670c5e12d362fa590e4eb33dd0acf03a5e3305a5214f3a718723e9073a",
-  "generatedGoDigest": "sha256:7768cee30edf5bad65d76a881d618e14a6759ac481df3f680dc622b627c7d00a",
-  "generatedTypeScriptDigest": "sha256:106e9421a0329d355a71ad1a0a4154f05dc600bcb8733b33ae2e763f5b558142",
+  "repositoryVersion": "0.12.0.0",
+  "publishVersion": "0.12.0",
+  "publishTag": "v0.12.0",
+  "schemasDigest": "sha256:0e90bbd74c5b1df2e0123ec75d8bec1296e9647b95c4aa88a9e9bb2452872bf4",
+  "aiFixturesDigest": "sha256:8c406c269e909c028e35eca1321c18de95457ddd6731db8f3fb4cd90726758a8",
+  "generatedGoDigest": "sha256:b42e736e80decef8ac00823a1e9a2e6ffe21dc9de43c5c9e1c53ebf467d34e2c",
+  "generatedTypeScriptDigest": "sha256:03ed593ff19141cb265436d6d069b86e0a75f3290d74b76689d48c5b37a52e5b",
   "generatedExclusions": {
     "gen-go/contract_release.go": "contains the generated aggregate digests (self-reference)",
     "gen-ts/contract-release.ts": "contains the generated aggregate digests (self-reference)"
   },
   "schemas": {
-    "schema/ai-budget-ledger-event.schema.json": "sha256:8396a1b3457bed3496dc7b60fb7fb30f76bbe3c60a20501823a61c75f2fdbafa",
+    "schema/ai-budget-ledger-event.schema.json": "sha256:92770bc5358e03a3aae6cd261dad02dfcbbb06a6203566da2c6c7a5e63dd671c",
     "schema/ai-callsite-inventory.schema.json": "sha256:b15899a97cf108e4cd1bfd31ec40c57b341590ddb9c118fdaa904215dbe01859",
     "schema/ai-classification-stamp.schema.json": "sha256:ad7f01dc8bb9a1cd619fce470227914aa3ef2ad57d34bfeaa0c6ef753aa6781d",
     "schema/ai-composite-policy-digest.schema.json": "sha256:3efccc249327e59f67a37fd954b524ee727a3e28a3c557a46d6ec1f15d69b34e",
@@ -20,12 +20,12 @@
     "schema/ai-gateway-key-lifecycle-event.schema.json": "sha256:ba5cb862abe73227bee714b25247b4cacb34f11fdd1476bb5f920923fd75e2a9",
     "schema/ai-gateway-key-lookup.schema.json": "sha256:e994d4782c9bc4f14d3a1c35c9ac1e7a5ec84284cde5b3af7e3e6022130ddbb3",
     "schema/ai-governance-decision.schema.json": "sha256:4d45c8540908bebb68456c45077c0cd453b416a3b955cc710de270950e090f50",
-    "schema/ai-metering-policy.schema.json": "sha256:e036885c170ce654740353aaaa01b2a7bcff714e73629123d7865af98c1cf303",
-    "schema/ai-policy-snapshot.schema.json": "sha256:dde70f30f4a501cfa65fc4d8da954d902e1c4cc966573fbe654eaea7bdeefca9",
-    "schema/ai-pricing-revision.schema.json": "sha256:75ccb847ac090821d817e92dc98dff49e29620018f8dc465b47f3617585d5b21",
+    "schema/ai-metering-policy.schema.json": "sha256:044115938d254d914feac162219d20ee48f741cd7ad32df4613b45f9c862fe8c",
+    "schema/ai-policy-snapshot.schema.json": "sha256:1778de5f1a5f6b034e2e767bd8189ad50daa03194107a05e090efafb5dce0cc1",
+    "schema/ai-pricing-revision.schema.json": "sha256:847fc3abf93ace82a188b028b067f3c3c1e7452e02a3c9ebba9bfbf3af749fd6",
     "schema/ai-runtime-binding.schema.json": "sha256:e86cac2f70a474997bdef1577ca15f22982ec0ce866921df3f763c4d7f7fa191",
     "schema/ai-runtime-contract.schema.json": "sha256:694cf8900ebe07a37ba0f12f50d2eed76e6608dc809e2b65969043e548dc4bba",
-    "schema/ai-trace-event-v2.schema.json": "sha256:946489fe9d58de5acf4a265d250800b4ad7b08aaacc50b00ef39feabe7aae94e",
+    "schema/ai-trace-event-v2.schema.json": "sha256:b479199bb6e44ea23a1da53f69943cb8f3886c433914fdb9bf9e9bdbc3dd767d",
     "schema/ai-trace-event.schema.json": "sha256:47c2268c9b8dbcf6e7908aeef43e71210f8a309bf4be4acc02139f9b59e7c717",
     "schema/ai-transform-event.schema.json": "sha256:b845762e653b19afdaf959f7bd1624db490cd10c760daa9aaa61fb83f2a86b6e",
     "schema/ai-transform-result.schema.json": "sha256:244e380a36957ab2dcb526ea22aaecb56b53664ce1fda6934d0021c084c99133",
@@ -59,7 +59,7 @@
     "fixtures/ai/adversarial-sanitized-binding-relabel.json": "sha256:5deba053e91be027588e0a921bc7fcd75363044587b651b9fbb3f986b3a8bc85",
     "fixtures/ai/valid-binding-classification-subject.json": "sha256:ca40d605f3351d44a4b37b598d033d129861443b65044fc056ca4406f07717c6",
     "fixtures/ai/valid-blocked-trace-event.json": "sha256:c72e753f5ed805d97b47af5cc57ea2fe9034f27b133bf0f5c6565fbc0c6693c1",
-    "fixtures/ai/valid-budget-ledger-event.json": "sha256:f56ee5339e549da44be1a30ac9ab08e209ff06749910bedfd66f47ef37c92877",
+    "fixtures/ai/valid-budget-ledger-event.json": "sha256:a2c1aea4f96fb28c61aa522bd5f5dfb2e1321b003f40fbcbac162d5404685760",
     "fixtures/ai/valid-classification-stamp.json": "sha256:bf8256cec5626031b4cf5acfe9ffde73100150ba19259c36b274e1be0820bb73",
     "fixtures/ai/valid-composite-policy-digest.json": "sha256:d13f2d022f9a29230103845b8af42b4f90c0d818ee64e6efaa31f5a547d9eeb7",
     "fixtures/ai/valid-deployment-gate-decision.json": "sha256:cf070be5b6b4b4363d72aba448c1f23c1eef288e930a7f0a2807598a30a7e0af",
@@ -68,15 +68,15 @@
     "fixtures/ai/valid-gateway-key-lookup.json": "sha256:a577cbdd019a7f39631e7efdb12dccb4377e3184d626a79979bfc426d04a50f4",
     "fixtures/ai/valid-governance-decision.json": "sha256:0cd3ffc5244e177af00670c6d839814a93048157cf11ccb738ed13b10d875c55",
     "fixtures/ai/valid-inventory.json": "sha256:3bb29df5525c3a69f6c13c203fbd08bb3d493ae5416fdd2f99125c74bbc11759",
-    "fixtures/ai/valid-metering-policy.json": "sha256:791892d2b70b999b6b4eb37ba0db6df579bb4a7dc31411c1edd5fc41f9f10600",
-    "fixtures/ai/valid-policy-snapshot.json": "sha256:862fb81b2a77f152c5f0d9f04542b8a93e5d0a3d88a518263a550c4ca0047f60",
-    "fixtures/ai/valid-pricing-revision.json": "sha256:ff7bfdccc1fd4173cf0cf0800fb953e60de55286b0bba557fac9c6a4e5984f81",
+    "fixtures/ai/valid-metering-policy.json": "sha256:73d10929f0232a09d31b263c5bf61f8985c9c629e1e78ea5c867dd919ff95c96",
+    "fixtures/ai/valid-policy-snapshot.json": "sha256:5ce6df9c261989f7a279eb772ead47d19e425a3e1df78d3a3eeb9043dee04318",
+    "fixtures/ai/valid-pricing-revision.json": "sha256:b8a89816a332397257fa0c40e5142ad9f05c9c6cbb92c37ae700f9b61c31fbce",
     "fixtures/ai/valid-runtime-binding.json": "sha256:df971a518b8e680bb5260e801e7a0b03dd05076aeb11258205ec5ec205719f53",
     "fixtures/ai/valid-runtime-contract.json": "sha256:a6af61297f2612679112675e9d401685966e58b891720014e3a5176426850006",
     "fixtures/ai/valid-sanitized-binding-evidence-byo-source.json": "sha256:77f258fdb6cb7232b78a62fc035e293c6d604bed438ca35c54ab398064bc053a",
     "fixtures/ai/valid-sanitized-binding-evidence.json": "sha256:19a4994b9a562305854945643a588f4f7c098db4bc3653da26df6e4284b00190",
     "fixtures/ai/valid-source-revision-digest.json": "sha256:ec32021dbb636de9a1e47d560bfe59c21451e88f67d647387968aba48691409d",
-    "fixtures/ai/valid-trace-event-v2.json": "sha256:001bc0bfb64bb2c161e10e49347727887302fba067c7a1ced511f17457867451",
+    "fixtures/ai/valid-trace-event-v2.json": "sha256:cdf33ae74b9113f0525fc6702aa3f8070605ce0d6352f82040f5bd354ff3c0f3",
     "fixtures/ai/valid-trace-event.json": "sha256:42451ebfb0dc0c475baf6bc1acc3d1006cc2294df37174764e936519b7d64100",
     "fixtures/ai/valid-transform-event.json": "sha256:6d99d5f34c010b39b194ff49a4c279d88bc7f05c697bacf088791352ca2d6330",
     "fixtures/ai/valid-transform-result.json": "sha256:406f6deae648837f7610fda38f6b4c1a1a73b83b7a96f9f427fcf4e2061dee50",
@@ -91,11 +91,11 @@
     "gen-go/doc.go": "sha256:c17bc2d39ed175ce7105c68305f8ae7152f659eb7cd187ecceee7698eb3a65dd",
     "gen-go/error_category.go": "sha256:e36745796e32f753cf153a76c5f77c4bdf37a6a228e6607abcf95cac6f4a934b",
     "gen-go/schema_documents.go": "sha256:c0399930c719b93d850847b257186f08d69a527f3ac1286ed0c49b66327b315a",
-    "gen-go/types.go": "sha256:803fea3111bcd1a76e3b7852e49039f3a1156c8b3b987b79a0d14c28dae39c5a",
+    "gen-go/types.go": "sha256:6e5c65527e748482a9fa44ebdcd4c8122dbb503d8c006b58baa0c18c360dfed7",
     "gen-go/version_state.go": "sha256:827f8768359998409b86ea02d9ba1a149981928bae7161e4dc95fe0520ce7410"
   },
   "generatedTypeScript": {
-    "gen-ts/ai-budget-ledger-event.ts": "sha256:26454e6adc34b7c202cfb2888753b164b22dcd2d9f7a0b10c835a0db9132f36f",
+    "gen-ts/ai-budget-ledger-event.ts": "sha256:64448d98a394e6eb103927cd35ce8a33e30176c0d5ee5afcdd8444f8aa051809",
     "gen-ts/ai-callsite-inventory.ts": "sha256:2665ffe965056b85a7f03db22071d56ce6d21d306a82a876908d0727ef2315dc",
     "gen-ts/ai-classification-stamp.ts": "sha256:dce78efba03df86a0986a16fd54c52066d322ff515d2463dbc45cafad82ecb44",
     "gen-ts/ai-composite-policy-digest-helper.ts": "sha256:d6c51d0c35599ee4f81d605b71773f4fff41a0bb46499ff0c6185072fedf53ce",
@@ -105,12 +105,12 @@
     "gen-ts/ai-gateway-key-lookup.ts": "sha256:e55fc9a2252d5e7e1a383a58c8b92f22d8147ee4862a893a6cfe815b4225fc00",
     "gen-ts/ai-gateway-key-token.ts": "sha256:ff6551ad3332cc665878d7ec93f42ce185c375e637531b2fbc82c697b877e784",
     "gen-ts/ai-governance-decision.ts": "sha256:efc422971a06d741e048c81f299ce258d7fdd4b7f036a2b9dda7aaca0679e950",
-    "gen-ts/ai-metering-policy.ts": "sha256:7dc951dbc208721de6c881219524c6075c92523e7884e31d934899c36b43f24e",
-    "gen-ts/ai-policy-snapshot.ts": "sha256:58e53c5468e65b6a229905c21cd05a34935242c4c55564cf292da675a44b3afa",
-    "gen-ts/ai-pricing-revision.ts": "sha256:87ee18e16ae5fa10f64ceed52e07bb05a4860f4b6303ad678cb0d35d23fdb1d5",
+    "gen-ts/ai-metering-policy.ts": "sha256:dd261d57646a509cd46efaefac4aad58d018c7f7da98326dd8859e4ce951c56a",
+    "gen-ts/ai-policy-snapshot.ts": "sha256:9a8c65936674a957979048a2a0c6d08c887c87f2c4d5e7e8127dcf31d33eccbc",
+    "gen-ts/ai-pricing-revision.ts": "sha256:6e09e8354025dc859023295753ecc3674b5bc198b77317413654f1b7d2327a39",
     "gen-ts/ai-runtime-binding.ts": "sha256:176c830d400ce44c508f8d249bb3c9724b2d595b78262615487cdafc4790263e",
     "gen-ts/ai-runtime-contract.ts": "sha256:fc60f5c45edfee7d6f37e99ed9a60e4e5c22bba5793593aa259f028e1c7d0c6e",
-    "gen-ts/ai-trace-event-v2.ts": "sha256:9c453805316d471eb8acac04f33f931d5a441560a249bef990ec8451606d86b8",
+    "gen-ts/ai-trace-event-v2.ts": "sha256:8c994355f290864da1cf42850c3eceb0e4a1567b45ed989de865213430d3ce0e",
     "gen-ts/ai-trace-event.ts": "sha256:1e714996dc4622e94c6ae144a7bdb09147306940db47ae788aafd6f7f8311b0c",
     "gen-ts/ai-transform-event.ts": "sha256:c8b520e01ce12b0e3a5ebe03a3ca63cc83368f26e1eef933de732c4fc1c504f9",
     "gen-ts/ai-transform-result.ts": "sha256:208c66b2aeb425c0cbcc18b7191f6e8989443f2b2c1690648e0e06cc1448ce25",

package/dist/gen-ts/ai-budget-ledger-event.d.ts

@@ -14,6 +14,10 @@ export interface AiBudgetLedgerEvent {
     requestId?: AiBudgetIdentifier;
     amountMicroUsd: number;
     committedMicroUsdAfter: number;
+    holdMicroUsd?: number;
+    actualMicroUsd?: number;
+    expiresAt?: string;
+    pricingRevision?: AiBudgetIdentifier;
     pricingRevisionDigest?: AiBudgetDigest;
     supersedesEventId?: AiBudgetIdentifier;
     eventDigest: AiBudgetDigest;

package/dist/gen-ts/ai-metering-policy.d.ts

@@ -1,4 +1,14 @@
 export type AiMeteringPolicyDigest = string;
+export type AiDimensionLimit = AiDimensionLimit1 & {
+    dimension: AiMeteringIdentifier;
+    unit: AiMeteringIdentifier;
+    maxPerRequest?: number;
+    maxPerMinute?: number;
+};
+export type AiDimensionLimit1 = {
+    [k: string]: unknown;
+};
+export type AiMeteringIdentifier = string;
 /**
  * Additive v2 metering-policy binding. It binds a composite policy to immutable pricing revisions without changing the v1 policy snapshot.
  */
@@ -11,6 +21,10 @@ export interface AiMeteringPolicy {
      */
     pricingRevisionDigests: AiMeteringPolicyDigest[];
     reservationMode: 'committed_exposure';
+    /**
+     * @maxItems 64
+     */
+    dimensionLimits?: AiDimensionLimit[];
     policyDigestV2: AiMeteringPolicyDigest;
     publishedAt: string;
 }

package/dist/gen-ts/ai-policy-snapshot.d.ts

@@ -41,6 +41,15 @@ export type AiPolicyEmbeddedJsonSchema = {
     minItems?: number;
     maxItems?: number;
 };
+export type AiPolicyDimensionLimit = AiPolicyDimensionLimit1 & {
+    dimension: AiPolicyIdentifier;
+    unit: AiPolicyIdentifier;
+    maxPerRequest?: number;
+    maxPerMinute?: number;
+};
+export type AiPolicyDimensionLimit1 = {
+    [k: string]: unknown;
+};
 /**
  * Immutable, content-addressed AI policy snapshot consumed by the Harbour AI Gateway. Provider credentials are represented only by Secrets Manager references.
  */
@@ -93,19 +102,25 @@ export interface AiPolicyModel {
      * @minItems 1
      * @maxItems 2
      */
-    capabilities: ('generation' | 'embeddings')[];
+    capabilities: ('generation' | 'embeddings' | 'transcription' | 'translation' | 'speech' | 'image' | 'realtime')[];
     approved: boolean;
     pricing: AiPolicyPricing;
 }
 export interface AiPolicyPricing {
     revision: AiPolicyIdentifier;
+    revisionDigest?: AiPolicyDigest;
     inputMicroUsdPerMillion: number;
     outputMicroUsdPerMillion: number;
+    mediaMicroUsdPerUnit?: {
+        audio_seconds?: number;
+        image_count?: number;
+        video_seconds?: number;
+    };
 }
 export interface AiPolicyRoute {
     alias: AiPolicyIdentifier;
     version: number;
-    capability: 'generation' | 'embeddings';
+    capability: 'generation' | 'embeddings' | 'transcription' | 'translation' | 'speech' | 'image' | 'realtime';
     /**
      * @minItems 1
      * @maxItems 16
@@ -154,6 +169,10 @@ export interface AiPolicyLimit {
     requestsPerMinute: number;
     tokensPerMinute: number;
     monthlyBudgetMicroUsd: number;
+    /**
+     * @maxItems 64
+     */
+    dimensionLimits?: AiPolicyDimensionLimit[];
 }
 export interface AiPolicyRetention {
     captureMode: 'OFF' | 'BEST_EFFORT' | 'REQUIRED';

package/dist/gen-ts/ai-pricing-revision.d.ts

@@ -1,7 +1,7 @@
 export type AiPricingIdentifier = string;
 export type AiPricingDigest = string;
 /**
- * Immutable v2 line-item pricing revision. A correction is a new revision; published records are never edited.
+ * Immutable v2 line-item pricing revision for token and media dimensions. A correction is a new revision; published records are never edited.
  */
 export interface AiPricingRevision {
     schema: 'harbour.ai-pricing-revision/2.0';

package/dist/gen-ts/ai-trace-event-v2.d.ts

@@ -1,7 +1,7 @@
 export type AiTraceV2Digest = string;
 export type AiTraceV2Identifier = string;
 /**
- * Additive metering projection linked to a readable v1 trace. It carries dimension-level reported or estimated usage without changing the v1 event.
+ * Additive metering projection linked to a readable v1 trace. It carries dimension-level reported or estimated usage (including audio, image and input-video media) without changing the v1 event.
  */
 export interface AiTraceEventV2 {
     schema: 'harbour.ai-trace-event/2.0';
@@ -16,6 +16,10 @@ export interface AiTraceEventV2 {
     totalCostMicroUsd: number;
     reservationId?: string;
     meteringStatus: 'settled' | 'reserved' | 'unknown' | 'repaired';
+    servedModel?: string;
+    ingressFormat?: 'openai' | 'gemini';
+    identityFastPath?: boolean;
+    versionOrdinalVerified?: boolean;
     occurredAt: string;
 }
 export interface UsageLineItem {
@@ -24,6 +28,7 @@ export interface UsageLineItem {
     direction: 'input' | 'output';
     quantity: number;
     unit: AiTraceV2Identifier;
+    priceRevision?: AiTraceV2Identifier;
     priceRevisionDigest: AiTraceV2Digest;
     scale: number;
     costMicroUsd: number;

package/dist/gen-ts/contract-release.d.ts

@@ -1,7 +1,7 @@
-export declare const ContractRepositoryVersion: "0.11.0.0";
-export declare const ContractPublishVersion: "0.11.0";
-export declare const ContractPublishTag: "v0.11.0";
-export declare const ContractSchemasDigest: "sha256:76b4a8c59792cf8a986af9c5ec4848a7ec3292c933c9ecb35e73cd96dcddcd57";
-export declare const ContractAiFixturesDigest: "sha256:8bea1c670c5e12d362fa590e4eb33dd0acf03a5e3305a5214f3a718723e9073a";
-export declare const ContractGeneratedGoDigest: "sha256:7768cee30edf5bad65d76a881d618e14a6759ac481df3f680dc622b627c7d00a";
-export declare const ContractGeneratedTypeScriptDigest: "sha256:106e9421a0329d355a71ad1a0a4154f05dc600bcb8733b33ae2e763f5b558142";
+export declare const ContractRepositoryVersion: "0.12.0.0";
+export declare const ContractPublishVersion: "0.12.0";
+export declare const ContractPublishTag: "v0.12.0";
+export declare const ContractSchemasDigest: "sha256:0e90bbd74c5b1df2e0123ec75d8bec1296e9647b95c4aa88a9e9bb2452872bf4";
+export declare const ContractAiFixturesDigest: "sha256:8c406c269e909c028e35eca1321c18de95457ddd6731db8f3fb4cd90726758a8";
+export declare const ContractGeneratedGoDigest: "sha256:b42e736e80decef8ac00823a1e9a2e6ffe21dc9de43c5c9e1c53ebf467d34e2c";
+export declare const ContractGeneratedTypeScriptDigest: "sha256:03ed593ff19141cb265436d6d069b86e0a75f3290d74b76689d48c5b37a52e5b";

package/dist/gen-ts/contract-release.js

@@ -1,9 +1,9 @@
 /* eslint-disable */
 // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
-export const ContractRepositoryVersion = "0.11.0.0";
-export const ContractPublishVersion = "0.11.0";
-export const ContractPublishTag = "v0.11.0";
-export const ContractSchemasDigest = "sha256:76b4a8c59792cf8a986af9c5ec4848a7ec3292c933c9ecb35e73cd96dcddcd57";
-export const ContractAiFixturesDigest = "sha256:8bea1c670c5e12d362fa590e4eb33dd0acf03a5e3305a5214f3a718723e9073a";
-export const ContractGeneratedGoDigest = "sha256:7768cee30edf5bad65d76a881d618e14a6759ac481df3f680dc622b627c7d00a";
-export const ContractGeneratedTypeScriptDigest = "sha256:106e9421a0329d355a71ad1a0a4154f05dc600bcb8733b33ae2e763f5b558142";
+export const ContractRepositoryVersion = "0.12.0.0";
+export const ContractPublishVersion = "0.12.0";
+export const ContractPublishTag = "v0.12.0";
+export const ContractSchemasDigest = "sha256:0e90bbd74c5b1df2e0123ec75d8bec1296e9647b95c4aa88a9e9bb2452872bf4";
+export const ContractAiFixturesDigest = "sha256:8c406c269e909c028e35eca1321c18de95457ddd6731db8f3fb4cd90726758a8";
+export const ContractGeneratedGoDigest = "sha256:b42e736e80decef8ac00823a1e9a2e6ffe21dc9de43c5c9e1c53ebf467d34e2c";
+export const ContractGeneratedTypeScriptDigest = "sha256:03ed593ff19141cb265436d6d069b86e0a75f3290d74b76689d48c5b37a52e5b";

package/fixtures/ai/valid-budget-ledger-event.json

@@ -9,6 +9,10 @@
   "requestId": "req_example123",
   "amountMicroUsd": 500,
   "committedMicroUsdAfter": 10500,
+  "holdMicroUsd": 500,
+  "actualMicroUsd": 0,
+  "expiresAt": "2026-08-10T10:15:00Z",
+  "pricingRevision": "gemini-flash-2026-08-10",
   "pricingRevisionDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
   "eventDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
   "occurredAt": "2026-08-10T10:00:00Z"

package/fixtures/ai/valid-metering-policy.json

@@ -3,6 +3,11 @@
   "policyDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
   "pricingRevisionDigests": ["sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"],
   "reservationMode": "committed_exposure",
+  "dimensionLimits": [
+    { "dimension": "audio_in", "unit": "seconds", "maxPerRequest": 3600, "maxPerMinute": 7200 },
+    { "dimension": "image_in", "unit": "count", "maxPerRequest": 16 },
+    { "dimension": "video_in", "unit": "seconds", "maxPerRequest": 300 }
+  ],
   "policyDigestV2": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
   "publishedAt": "2026-08-10T09:00:00Z"
 }

package/fixtures/ai/valid-policy-snapshot.json

@@ -28,12 +28,18 @@
       "id": "openai-gpt-4.1-mini",
       "providerId": "openai-primary",
       "providerModel": "gpt-4.1-mini",
-      "capabilities": ["generation"],
+      "capabilities": ["generation", "image"],
       "approved": true,
       "pricing": {
         "revision": "openai-gpt-4.1-mini-2026-08-01",
+        "revisionDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
         "inputMicroUsdPerMillion": 400000,
-        "outputMicroUsdPerMillion": 1600000
+        "outputMicroUsdPerMillion": 1600000,
+        "mediaMicroUsdPerUnit": {
+          "audio_seconds": 4,
+          "image_count": 40,
+          "video_seconds": 5
+        }
       }
     }
   ],
@@ -106,7 +112,12 @@
       "scope": "application",
       "requestsPerMinute": 60,
       "tokensPerMinute": 100000,
-      "monthlyBudgetMicroUsd": 100000000
+      "monthlyBudgetMicroUsd": 100000000,
+      "dimensionLimits": [
+        { "dimension": "audio_in", "unit": "seconds", "maxPerRequest": 3600 },
+        { "dimension": "image_in", "unit": "count", "maxPerRequest": 16 },
+        { "dimension": "video_in", "unit": "seconds", "maxPerRequest": 300 }
+      ]
     }
   ],
   "retention": {

package/fixtures/ai/valid-pricing-revision.json

@@ -5,8 +5,11 @@
   "providerModel": "gpt-test",
   "currency": "USD",
   "dimensions": [
-    { "dimension": "tokens", "direction": "input", "unit": "token", "scale": 1000000, "microUsdPerScale": 100000 },
-    { "dimension": "tokens", "direction": "output", "unit": "token", "scale": 1000000, "microUsdPerScale": 200000 }
+    { "dimension": "input_tokens", "direction": "input", "unit": "tokens", "scale": 1000000, "microUsdPerScale": 100000 },
+    { "dimension": "output_tokens", "direction": "output", "unit": "tokens", "scale": 1000000, "microUsdPerScale": 200000 },
+    { "dimension": "audio_in", "direction": "input", "unit": "seconds", "scale": 1, "microUsdPerScale": 4 },
+    { "dimension": "image_in", "direction": "input", "unit": "count", "scale": 1, "microUsdPerScale": 40 },
+    { "dimension": "video_in", "direction": "input", "unit": "seconds", "scale": 1, "microUsdPerScale": 5 }
   ],
   "revisionDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
   "effectiveAt": "2026-08-10T00:00:00Z",

package/fixtures/ai/valid-trace-event-v2.json

@@ -7,18 +7,59 @@
   "usageLineItems": [
     {
       "attempt": 1,
-      "dimension": "tokens",
+      "dimension": "input_tokens",
       "direction": "input",
       "quantity": 120,
-      "unit": "token",
+      "unit": "tokens",
+      "priceRevision": "gemini-flash-2026-08-10",
       "priceRevisionDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
       "scale": 1000000,
       "costMicroUsd": 12,
       "provenance": "reported"
+    },
+    {
+      "attempt": 1,
+      "dimension": "audio_in",
+      "direction": "input",
+      "quantity": 30,
+      "unit": "seconds",
+      "priceRevision": "gemini-flash-2026-08-10",
+      "priceRevisionDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "scale": 1,
+      "costMicroUsd": 120,
+      "provenance": "reported"
+    },
+    {
+      "attempt": 1,
+      "dimension": "image_in",
+      "direction": "input",
+      "quantity": 2,
+      "unit": "count",
+      "priceRevision": "gemini-flash-2026-08-10",
+      "priceRevisionDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "scale": 1,
+      "costMicroUsd": 80,
+      "provenance": "reported"
+    },
+    {
+      "attempt": 1,
+      "dimension": "video_in",
+      "direction": "input",
+      "quantity": 12,
+      "unit": "seconds",
+      "priceRevision": "gemini-flash-2026-08-10",
+      "priceRevisionDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "scale": 1,
+      "costMicroUsd": 60,
+      "provenance": "estimated"
     }
   ],
-  "totalCostMicroUsd": 12,
+  "totalCostMicroUsd": 272,
   "reservationId": "req_example123#budget",
   "meteringStatus": "settled",
+  "servedModel": "gemini-2.5-flash",
+  "ingressFormat": "gemini",
+  "identityFastPath": true,
+  "versionOrdinalVerified": true,
   "occurredAt": "2026-08-10T10:00:00Z"
 }

package/gen-ts/ai-budget-ledger-event.ts

@@ -18,6 +18,10 @@ export interface AiBudgetLedgerEvent {
   requestId?: AiBudgetIdentifier;
   amountMicroUsd: number;
   committedMicroUsdAfter: number;
+  holdMicroUsd?: number;
+  actualMicroUsd?: number;
+  expiresAt?: string;
+  pricingRevision?: AiBudgetIdentifier;
   pricingRevisionDigest?: AiBudgetDigest;
   supersedesEventId?: AiBudgetIdentifier;
   eventDigest: AiBudgetDigest;

package/gen-ts/ai-metering-policy.ts

@@ -2,6 +2,16 @@
 // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
 
 export type AiMeteringPolicyDigest = string;
+export type AiDimensionLimit = AiDimensionLimit1 & {
+  dimension: AiMeteringIdentifier;
+  unit: AiMeteringIdentifier;
+  maxPerRequest?: number;
+  maxPerMinute?: number;
+};
+export type AiDimensionLimit1 = {
+  [k: string]: unknown;
+};
+export type AiMeteringIdentifier = string;
 
 /**
  * Additive v2 metering-policy binding. It binds a composite policy to immutable pricing revisions without changing the v1 policy snapshot.
@@ -15,6 +25,10 @@ export interface AiMeteringPolicy {
    */
   pricingRevisionDigests: AiMeteringPolicyDigest[];
   reservationMode: 'committed_exposure';
+  /**
+   * @maxItems 64
+   */
+  dimensionLimits?: AiDimensionLimit[];
   policyDigestV2: AiMeteringPolicyDigest;
   publishedAt: string;
 }

package/gen-ts/ai-policy-snapshot.ts

@@ -44,6 +44,15 @@ export type AiPolicyEmbeddedJsonSchema = {
   minItems?: number;
   maxItems?: number;
 };
+export type AiPolicyDimensionLimit = AiPolicyDimensionLimit1 & {
+  dimension: AiPolicyIdentifier;
+  unit: AiPolicyIdentifier;
+  maxPerRequest?: number;
+  maxPerMinute?: number;
+};
+export type AiPolicyDimensionLimit1 = {
+  [k: string]: unknown;
+};
 
 /**
  * Immutable, content-addressed AI policy snapshot consumed by the Harbour AI Gateway. Provider credentials are represented only by Secrets Manager references.
@@ -97,19 +106,25 @@ export interface AiPolicyModel {
    * @minItems 1
    * @maxItems 2
    */
-  capabilities: ('generation' | 'embeddings')[];
+  capabilities: ('generation' | 'embeddings' | 'transcription' | 'translation' | 'speech' | 'image' | 'realtime')[];
   approved: boolean;
   pricing: AiPolicyPricing;
 }
 export interface AiPolicyPricing {
   revision: AiPolicyIdentifier;
+  revisionDigest?: AiPolicyDigest;
   inputMicroUsdPerMillion: number;
   outputMicroUsdPerMillion: number;
+  mediaMicroUsdPerUnit?: {
+    audio_seconds?: number;
+    image_count?: number;
+    video_seconds?: number;
+  };
 }
 export interface AiPolicyRoute {
   alias: AiPolicyIdentifier;
   version: number;
-  capability: 'generation' | 'embeddings';
+  capability: 'generation' | 'embeddings' | 'transcription' | 'translation' | 'speech' | 'image' | 'realtime';
   /**
    * @minItems 1
    * @maxItems 16
@@ -158,6 +173,10 @@ export interface AiPolicyLimit {
   requestsPerMinute: number;
   tokensPerMinute: number;
   monthlyBudgetMicroUsd: number;
+  /**
+   * @maxItems 64
+   */
+  dimensionLimits?: AiPolicyDimensionLimit[];
 }
 export interface AiPolicyRetention {
   captureMode: 'OFF' | 'BEST_EFFORT' | 'REQUIRED';

package/gen-ts/ai-pricing-revision.ts

@@ -5,7 +5,7 @@ export type AiPricingIdentifier = string;
 export type AiPricingDigest = string;
 
 /**
- * Immutable v2 line-item pricing revision. A correction is a new revision; published records are never edited.
+ * Immutable v2 line-item pricing revision for token and media dimensions. A correction is a new revision; published records are never edited.
  */
 export interface AiPricingRevision {
   schema: 'harbour.ai-pricing-revision/2.0';

package/gen-ts/ai-trace-event-v2.ts

@@ -5,7 +5,7 @@ export type AiTraceV2Digest = string;
 export type AiTraceV2Identifier = string;
 
 /**
- * Additive metering projection linked to a readable v1 trace. It carries dimension-level reported or estimated usage without changing the v1 event.
+ * Additive metering projection linked to a readable v1 trace. It carries dimension-level reported or estimated usage (including audio, image and input-video media) without changing the v1 event.
  */
 export interface AiTraceEventV2 {
   schema: 'harbour.ai-trace-event/2.0';
@@ -20,6 +20,10 @@ export interface AiTraceEventV2 {
   totalCostMicroUsd: number;
   reservationId?: string;
   meteringStatus: 'settled' | 'reserved' | 'unknown' | 'repaired';
+  servedModel?: string;
+  ingressFormat?: 'openai' | 'gemini';
+  identityFastPath?: boolean;
+  versionOrdinalVerified?: boolean;
   occurredAt: string;
 }
 export interface UsageLineItem {
@@ -28,6 +32,7 @@ export interface UsageLineItem {
   direction: 'input' | 'output';
   quantity: number;
   unit: AiTraceV2Identifier;
+  priceRevision?: AiTraceV2Identifier;
   priceRevisionDigest: AiTraceV2Digest;
   scale: number;
   costMicroUsd: number;

package/gen-ts/contract-release.ts

@@ -1,10 +1,10 @@
 /* eslint-disable */
 // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
 
-export const ContractRepositoryVersion = "0.11.0.0" as const;
-export const ContractPublishVersion = "0.11.0" as const;
-export const ContractPublishTag = "v0.11.0" as const;
-export const ContractSchemasDigest = "sha256:76b4a8c59792cf8a986af9c5ec4848a7ec3292c933c9ecb35e73cd96dcddcd57" as const;
-export const ContractAiFixturesDigest = "sha256:8bea1c670c5e12d362fa590e4eb33dd0acf03a5e3305a5214f3a718723e9073a" as const;
-export const ContractGeneratedGoDigest = "sha256:7768cee30edf5bad65d76a881d618e14a6759ac481df3f680dc622b627c7d00a" as const;
-export const ContractGeneratedTypeScriptDigest = "sha256:106e9421a0329d355a71ad1a0a4154f05dc600bcb8733b33ae2e763f5b558142" as const;
+export const ContractRepositoryVersion = "0.12.0.0" as const;
+export const ContractPublishVersion = "0.12.0" as const;
+export const ContractPublishTag = "v0.12.0" as const;
+export const ContractSchemasDigest = "sha256:0e90bbd74c5b1df2e0123ec75d8bec1296e9647b95c4aa88a9e9bb2452872bf4" as const;
+export const ContractAiFixturesDigest = "sha256:8c406c269e909c028e35eca1321c18de95457ddd6731db8f3fb4cd90726758a8" as const;
+export const ContractGeneratedGoDigest = "sha256:b42e736e80decef8ac00823a1e9a2e6ffe21dc9de43c5c9e1c53ebf467d34e2c" as const;
+export const ContractGeneratedTypeScriptDigest = "sha256:03ed593ff19141cb265436d6d069b86e0a75f3290d74b76689d48c5b37a52e5b" as const;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fourier-labs/harbour-contracts",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Single source of truth for every data shape that crosses a boundary between Harbour components.",
   "license": "UNLICENSED",
   "private": false,

package/schema/ai-budget-ledger-event.schema.json

@@ -17,6 +17,10 @@
     "requestId": { "$ref": "#/definitions/AiBudgetIdentifier" },
     "amountMicroUsd": { "type": "integer" },
     "committedMicroUsdAfter": { "type": "integer", "minimum": 0 },
+    "holdMicroUsd": { "type": "integer", "minimum": 0 },
+    "actualMicroUsd": { "type": "integer", "minimum": 0 },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "pricingRevision": { "$ref": "#/definitions/AiBudgetIdentifier" },
     "pricingRevisionDigest": { "$ref": "#/definitions/AiBudgetDigest" },
     "supersedesEventId": { "$ref": "#/definitions/AiBudgetIdentifier" },
     "eventDigest": { "$ref": "#/definitions/AiBudgetDigest" },

package/schema/ai-metering-policy.schema.json

@@ -11,8 +11,24 @@
     "policyDigest": { "$ref": "#/definitions/AiMeteringPolicyDigest" },
     "pricingRevisionDigests": { "type": "array", "minItems": 1, "maxItems": 512, "uniqueItems": true, "items": { "$ref": "#/definitions/AiMeteringPolicyDigest" } },
     "reservationMode": { "type": "string", "const": "committed_exposure" },
+    "dimensionLimits": { "type": "array", "maxItems": 64, "items": { "$ref": "#/definitions/AiDimensionLimit" } },
     "policyDigestV2": { "$ref": "#/definitions/AiMeteringPolicyDigest" },
     "publishedAt": { "type": "string", "format": "date-time" }
   },
-  "definitions": { "AiMeteringPolicyDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+  "definitions": {
+    "AiMeteringPolicyDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "AiMeteringIdentifier": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9_.@/-]*$" },
+    "AiDimensionLimit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dimension", "unit"],
+      "properties": {
+        "dimension": { "$ref": "#/definitions/AiMeteringIdentifier" },
+        "unit": { "$ref": "#/definitions/AiMeteringIdentifier" },
+        "maxPerRequest": { "type": "integer", "minimum": 0 },
+        "maxPerMinute": { "type": "integer", "minimum": 0 }
+      },
+      "anyOf": [{ "required": ["maxPerRequest"] }, { "required": ["maxPerMinute"] }]
+    }
+  }
 }

package/schema/ai-policy-snapshot.schema.json

@@ -124,8 +124,18 @@
       "required": ["revision", "inputMicroUsdPerMillion", "outputMicroUsdPerMillion"],
       "properties": {
         "revision": { "$ref": "#/definitions/AiPolicyIdentifier" },
+        "revisionDigest": { "$ref": "#/definitions/AiPolicyDigest" },
         "inputMicroUsdPerMillion": { "type": "integer", "minimum": 0 },
-        "outputMicroUsdPerMillion": { "type": "integer", "minimum": 0 }
+        "outputMicroUsdPerMillion": { "type": "integer", "minimum": 0 },
+        "mediaMicroUsdPerUnit": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "audio_seconds": { "type": "integer", "minimum": 0 },
+            "image_count": { "type": "integer", "minimum": 0 },
+            "video_seconds": { "type": "integer", "minimum": 0 }
+          }
+        }
       }
     },
     "AiPolicyModel": {
@@ -141,7 +151,7 @@
           "minItems": 1,
           "maxItems": 2,
           "uniqueItems": true,
-          "items": { "type": "string", "enum": ["generation", "embeddings"] }
+          "items": { "type": "string", "enum": ["generation", "embeddings", "transcription", "translation", "speech", "image", "realtime"] }
         },
         "approved": { "type": "boolean" },
         "pricing": { "$ref": "#/definitions/AiPolicyPricing" }
@@ -164,7 +174,7 @@
       "properties": {
         "alias": { "$ref": "#/definitions/AiPolicyIdentifier" },
         "version": { "type": "integer", "minimum": 1 },
-        "capability": { "type": "string", "enum": ["generation", "embeddings"] },
+        "capability": { "type": "string", "enum": ["generation", "embeddings", "transcription", "translation", "speech", "image", "realtime"] },
         "targets": {
           "type": "array",
           "minItems": 1,
@@ -318,9 +328,26 @@
         "scope": { "type": "string", "enum": ["tenant", "application"] },
         "requestsPerMinute": { "type": "integer", "minimum": 1 },
         "tokensPerMinute": { "type": "integer", "minimum": 1 },
-        "monthlyBudgetMicroUsd": { "type": "integer", "minimum": 0 }
+        "monthlyBudgetMicroUsd": { "type": "integer", "minimum": 0 },
+        "dimensionLimits": {
+          "type": "array",
+          "maxItems": 64,
+          "items": { "$ref": "#/definitions/AiPolicyDimensionLimit" }
+        }
       }
     },
+    "AiPolicyDimensionLimit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dimension", "unit"],
+      "properties": {
+        "dimension": { "$ref": "#/definitions/AiPolicyIdentifier" },
+        "unit": { "$ref": "#/definitions/AiPolicyIdentifier" },
+        "maxPerRequest": { "type": "integer", "minimum": 0 },
+        "maxPerMinute": { "type": "integer", "minimum": 0 }
+      },
+      "anyOf": [{ "required": ["maxPerRequest"] }, { "required": ["maxPerMinute"] }]
+    },
     "AiPolicyRetention": {
       "type": "object",
       "additionalProperties": false,

package/schema/ai-pricing-revision.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://schemas.harbour.dev/ai-pricing-revision.schema.json",
   "title": "AiPricingRevision",
-  "description": "Immutable v2 line-item pricing revision. A correction is a new revision; published records are never edited.",
+  "description": "Immutable v2 line-item pricing revision for token and media dimensions. A correction is a new revision; published records are never edited.",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema", "revisionId", "provider", "providerModel", "currency", "dimensions", "revisionDigest", "effectiveAt", "publishedAt"],

package/schema/ai-trace-event-v2.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://schemas.harbour.dev/ai-trace-event-v2.schema.json",
   "title": "AiTraceEventV2",
-  "description": "Additive metering projection linked to a readable v1 trace. It carries dimension-level reported or estimated usage without changing the v1 event.",
+  "description": "Additive metering projection linked to a readable v1 trace. It carries dimension-level reported or estimated usage (including audio, image and input-video media) without changing the v1 event.",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema", "traceId", "requestId", "policyDigest", "outcome", "usageLineItems", "totalCostMicroUsd", "meteringStatus", "occurredAt"],
@@ -16,6 +16,10 @@
     "totalCostMicroUsd": { "type": "integer", "minimum": 0 },
     "reservationId": { "type": "string", "minLength": 1, "maxLength": 256 },
     "meteringStatus": { "type": "string", "enum": ["settled", "reserved", "unknown", "repaired"] },
+    "servedModel": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "ingressFormat": { "type": "string", "enum": ["openai", "gemini"] },
+    "identityFastPath": { "type": "boolean" },
+    "versionOrdinalVerified": { "type": "boolean" },
     "occurredAt": { "type": "string", "format": "date-time" }
   },
   "definitions": {
@@ -31,6 +35,7 @@
         "direction": { "type": "string", "enum": ["input", "output"] },
         "quantity": { "type": "integer", "minimum": 0 },
         "unit": { "$ref": "#/definitions/AiTraceV2Identifier" },
+        "priceRevision": { "$ref": "#/definitions/AiTraceV2Identifier" },
         "priceRevisionDigest": { "$ref": "#/definitions/AiTraceV2Digest" },
         "scale": { "type": "integer", "minimum": 1 },
         "costMicroUsd": { "type": "integer", "minimum": 0 },