@arcforges/api-client 1.0.0-ci.241.1 → 1.0.0-ci.244.1

package/NOTICE

@@ -1,10 +1,10 @@
 ArcForges Contracts
 Copyright 2026 ArcForges contributors
 
-@arcforges/api-client 1.0.0-ci.241.1 (Apache-2.0)
+@arcforges/api-client 1.0.0-ci.244.1 (Apache-2.0)
 
 Resolved runtime dependency inventory (dependencies retain their own licences):
-- @arcforges/proto 1.0.0-ci.241.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.241.1)
+- @arcforges/proto 1.0.0-ci.244.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.244.1)
 - @bufbuild/protobuf 2.15.0: (Apache-2.0 AND BSD-3-Clause) (pkg:npm/%40bufbuild/protobuf@2.15.0)
 - @connectrpc/connect 2.2.0: Apache-2.0 (pkg:npm/%40connectrpc/connect@2.2.0)
 - @connectrpc/connect-web 2.2.0: Apache-2.0 (pkg:npm/%40connectrpc/connect-web@2.2.0)
@@ -15,8 +15,8 @@ ArcForges source provenance notices
 
 Generated from reviewed active records. Original licence files and dependency notices remain authoritative.
 
-contract-bindings-con-03-r1
-Source: https://github.com/ArcForges/Contracts @ d4a89dd098fee96201e99d4879666b47f6ec679d
+contract-bindings-con-08-r1
+Source: https://github.com/ArcForges/Contracts @ 82f7dc331e39674b812ee53296ac5d6dd6badd0b
 Material licence: Apache-2.0
 Notice scope: packages
 Copyright 2026 ArcForges contributors.

package/build-identity.json

@@ -3,17 +3,17 @@
   "owner": "Contracts",
   "artifact": {
     "id": "@arcforges/api-client",
-    "version": "1.0.0-ci.241.1"
+    "version": "1.0.0-ci.244.1"
   },
   "build": {
-    "sourceCommit": "d4a50fc7e129e5cff28aeb68976f8d1182807f2f",
+    "sourceCommit": "063762f32c551449fb01936d9ec30fedb77260de",
     "dirty": false,
     "kind": "ci",
-    "buildId": "36419539537.1",
-    "runId": "36419539537",
+    "buildId": "36461962570.1",
+    "runId": "36461962570",
     "runAttempt": 1,
-    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/36419539537",
-    "sourceDateEpoch": 1790597094
+    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/36461962570",
+    "sourceDateEpoch": 1790618328
   },
   "axes": {
     "AppVersion": {
@@ -30,7 +30,7 @@
             "path": "public/proto/arcforges/catalog/v1/catalog.proto",
             "sha256": "ff77d24be445e107d4fb4a0b3f7fd6b205664317e856a3696e471be1a18f0828"
           },
-          "descriptorSha256": "13c9a31eacff4614dd41f90cc861fd4b1ce11e221081a42579b1f486758bba0a"
+          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
         },
         {
           "subject": "arcforges.events",
@@ -39,7 +39,7 @@
             "path": "public/proto/arcforges/events/v1/events.proto",
             "sha256": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43"
           },
-          "descriptorSha256": "13c9a31eacff4614dd41f90cc861fd4b1ce11e221081a42579b1f486758bba0a"
+          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
         },
         {
           "subject": "arcforges.foundation",
@@ -48,7 +48,7 @@
             "path": "public/proto/arcforges/foundation/v1/foundation.proto",
             "sha256": "adff62f65799bc5523965caf40f1f6bf11cbb4e2d769f46d9e3183a72a6d24d5"
           },
-          "descriptorSha256": "13c9a31eacff4614dd41f90cc861fd4b1ce11e221081a42579b1f486758bba0a"
+          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
         },
         {
           "subject": "arcforges.hello",
@@ -57,13 +57,17 @@
             "path": "public/proto/arcforges/hello/v1/hello.proto",
             "sha256": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9"
           },
-          "descriptorSha256": "13c9a31eacff4614dd41f90cc861fd4b1ce11e221081a42579b1f486758bba0a"
+          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
         },
         {
           "subject": "arcforges.publicapi",
           "version": "1",
-          "descriptorSha256": "13c9a31eacff4614dd41f90cc861fd4b1ce11e221081a42579b1f486758bba0a",
+          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf",
           "sources": [
+            {
+              "path": "public/proto/arcforges/publicapi/v1/commerce.proto",
+              "sha256": "e0ed5700197fdb20006c7ea699d9071dd8c4ac9d4248651f8a148363ad8af9dc"
+            },
             {
               "path": "public/proto/arcforges/publicapi/v1/content.proto",
               "sha256": "1c912ac9fa37633a3e5d186cb6f3838bd886f09f935e1ce41c5a665640c54abd"
@@ -169,10 +173,10 @@
       "values": [
         {
           "subject": "pkg:npm/%40arcforges/proto",
-          "version": "1.0.0-ci.241.1",
+          "version": "1.0.0-ci.244.1",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "0679f5815e47162ad9df8032584e5cc7f8d1856342f2c19361c0815cc42c8bb5"
+            "sha256": "7d1c0506884183be94130c1562bebe4f852bfeddb607cd9607c80cd8d2c00a22"
           }
         },
         {
@@ -180,7 +184,7 @@
           "version": "2.15.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "0679f5815e47162ad9df8032584e5cc7f8d1856342f2c19361c0815cc42c8bb5"
+            "sha256": "7d1c0506884183be94130c1562bebe4f852bfeddb607cd9607c80cd8d2c00a22"
           }
         },
         {
@@ -188,7 +192,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "0679f5815e47162ad9df8032584e5cc7f8d1856342f2c19361c0815cc42c8bb5"
+            "sha256": "7d1c0506884183be94130c1562bebe4f852bfeddb607cd9607c80cd8d2c00a22"
           }
         },
         {
@@ -196,7 +200,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "0679f5815e47162ad9df8032584e5cc7f8d1856342f2c19361c0815cc42c8bb5"
+            "sha256": "7d1c0506884183be94130c1562bebe4f852bfeddb607cd9607c80cd8d2c00a22"
           }
         }
       ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcforges/api-client",
-  "version": "1.0.0-ci.241.1",
+  "version": "1.0.0-ci.244.1",
   "description": "ArcForges public gRPC-Web client entry point; initial Hello World example.",
   "type": "module",
   "license": "Apache-2.0",
@@ -33,7 +33,7 @@
     "source.json"
   ],
   "dependencies": {
-    "@arcforges/proto": "1.0.0-ci.241.1",
+    "@arcforges/proto": "1.0.0-ci.244.1",
     "@bufbuild/protobuf": "2.15.0",
     "@connectrpc/connect": "2.2.0",
     "@connectrpc/connect-web": "2.2.0"

package/sbom.cdx.json

@@ -5,10 +5,10 @@
   "metadata": {
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.241.1",
+      "bom-ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.244.1",
       "name": "@arcforges/api-client",
-      "version": "1.0.0-ci.241.1",
-      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.241.1",
+      "version": "1.0.0-ci.244.1",
+      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.244.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -19,10 +19,10 @@
   "components": [
     {
       "type": "library",
-      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.241.1",
+      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.244.1",
       "name": "@arcforges/proto",
-      "version": "1.0.0-ci.241.1",
-      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.241.1",
+      "version": "1.0.0-ci.244.1",
+      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.244.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -72,7 +72,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.241.1",
+      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.244.1",
       "dependsOn": [
         "pkg:npm/%40bufbuild/protobuf@2.15.0"
       ]
@@ -91,9 +91,9 @@
       ]
     },
     {
-      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.241.1",
+      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.244.1",
       "dependsOn": [
-        "pkg:npm/%40arcforges/proto@1.0.0-ci.241.1",
+        "pkg:npm/%40arcforges/proto@1.0.0-ci.244.1",
         "pkg:npm/%40bufbuild/protobuf@2.15.0",
         "pkg:npm/%40connectrpc/connect@2.2.0",
         "pkg:npm/%40connectrpc/connect-web@2.2.0"

package/schemas/public/proto/arcforges/publicapi/v1/commerce.proto

@@ -0,0 +1,542 @@
+// SPDX-License-Identifier: Apache-2.0
+syntax = "proto3";
+
+package arcforges.publicapi.v1;
+
+import "arcforges/foundation/v1/foundation.proto";
+import "arcforges/publicapi/v1/inprocess-values.proto";
+
+option csharp_namespace = "ArcForges.Contracts.PublicApi.V1";
+option java_package = "io.github.arcforges.contracts.publicapi.v1";
+option java_multiple_files = true;
+option java_outer_classname = "CommerceProto";
+
+// Frozen per CC-04. These are read/projection and commercial-owner boundaries,
+// not checkout-provider adapters, payment credential transport or entitlement
+// admission logic.
+service EntitlementService {
+  rpc GetSnapshot(EntitlementServiceGetSnapshotRequest) returns (EntitlementServiceGetSnapshotResponse);
+  rpc GetServiceTerm(EntitlementServiceGetServiceTermRequest) returns (EntitlementServiceGetServiceTermResponse);
+  rpc GetCapacity(EntitlementServiceGetCapacityRequest) returns (EntitlementServiceGetCapacityResponse);
+  rpc ListGrants(EntitlementServiceListGrantsRequest) returns (EntitlementServiceListGrantsResponse);
+  rpc GetUsage(EntitlementServiceGetUsageRequest) returns (EntitlementServiceGetUsageResponse);
+  rpc Check(EntitlementServiceCheckRequest) returns (EntitlementServiceCheckResponse);
+}
+
+// Frozen per CC-04. Provider-facing webhook traffic stays on its separately
+// declared signed HTTP boundary and is not a customer RPC.
+service CommerceService {
+  rpc AuthoriseExtraUsage(CommerceServiceAuthoriseExtraUsageRequest) returns (CommerceServiceAuthoriseExtraUsageResponse);
+  rpc RevokeExtraUsage(CommerceServiceRevokeExtraUsageRequest) returns (CommerceServiceRevokeExtraUsageResponse);
+  rpc ExplainCharge(CommerceServiceExplainChargeRequest) returns (CommerceServiceExplainChargeResponse);
+  rpc GetCatalogue(CommerceServiceGetCatalogueRequest) returns (CommerceServiceGetCatalogueResponse);
+  rpc CreatePurchaseIntent(CommerceServiceCreatePurchaseIntentRequest) returns (CommerceServiceCreatePurchaseIntentResponse);
+  rpc CreateCheckoutAttempt(CommerceServiceCreateCheckoutAttemptRequest) returns (CommerceServiceCreateCheckoutAttemptResponse);
+  rpc GetPurchaseState(CommerceServiceGetPurchaseStateRequest) returns (CommerceServiceGetPurchaseStateResponse);
+  rpc GetSubscription(CommerceServiceGetSubscriptionRequest) returns (CommerceServiceGetSubscriptionResponse);
+  rpc CancelSubscription(CommerceServiceCancelSubscriptionRequest) returns (CommerceServiceCancelSubscriptionResponse);
+  rpc ReactivateSubscription(CommerceServiceReactivateSubscriptionRequest) returns (CommerceServiceReactivateSubscriptionResponse);
+  rpc GetCredits(CommerceServiceGetCreditsRequest) returns (CommerceServiceGetCreditsResponse);
+  rpc ListBillingHistory(CommerceServiceListBillingHistoryRequest) returns (CommerceServiceListBillingHistoryResponse);
+  rpc RequestRefund(CommerceServiceRequestRefundRequest) returns (CommerceServiceRequestRefundResponse);
+  rpc ExportEvidence(CommerceServiceExportEvidenceRequest) returns (CommerceServiceExportEvidenceResponse);
+}
+
+enum SubscriptionState {
+  SUBSCRIPTION_STATE_UNSPECIFIED = 0;
+  SUBSCRIPTION_STATE_PENDING = 1;
+  SUBSCRIPTION_STATE_ACTIVE = 2;
+  SUBSCRIPTION_STATE_GRACE = 3;
+  SUBSCRIPTION_STATE_CANCEL_SCHEDULED = 4;
+  SUBSCRIPTION_STATE_ENDED = 5;
+  SUBSCRIPTION_STATE_SUSPENDED = 6;
+}
+
+message EntitlementSnapshot {
+  optional int64 version = 1 [json_name = "version"];
+  repeated Availability capabilities = 2 [json_name = "capabilities"];
+  ServiceTerm service_term = 3 [json_name = "serviceTerm"];
+  repeated QuotaUsage quotas = 4 [json_name = "quotas"];
+}
+
+message ServiceTerm {
+  optional string kind = 1 [json_name = "kind"];
+  arcforges.foundation.v1.Instant starts_at = 2 [json_name = "startsAt"];
+  arcforges.foundation.v1.Instant ends_at = 3 [json_name = "endsAt"];
+  arcforges.foundation.v1.Instant grace_ends_at = 4 [json_name = "graceEndsAt"];
+  optional bool ai_admissible = 5 [json_name = "aiAdmissible"];
+}
+
+message Capacity {
+  optional uint64 available = 1 [json_name = "available"];
+  optional uint64 held = 2 [json_name = "held"];
+  optional uint64 burst = 3 [json_name = "burst"];
+  arcforges.foundation.v1.Rational recovery_rate = 4 [json_name = "recoveryRate"];
+  arcforges.foundation.v1.Instant recovery_at = 5 [json_name = "recoveryAt"];
+  optional string version = 6 [json_name = "version"];
+}
+
+message Grant {
+  arcforges.foundation.v1.Id grant_id = 1 [json_name = "grantId"];
+  optional string capability = 2 [json_name = "capability"];
+  optional string source = 3 [json_name = "source"];
+  arcforges.foundation.v1.Instant starts_at = 4 [json_name = "startsAt"];
+  arcforges.foundation.v1.Instant ends_at = 5 [json_name = "endsAt"];
+  arcforges.foundation.v1.Instant revoked_at = 6 [json_name = "revokedAt"];
+}
+
+message QuotaUsage {
+  optional string kind = 1 [json_name = "kind"];
+  optional uint64 used = 2 [json_name = "used"];
+  optional uint64 held = 3 [json_name = "held"];
+  optional uint64 limit = 4 [json_name = "limit"];
+  arcforges.foundation.v1.TimeRangeUtc period = 5 [json_name = "period"];
+}
+
+message SpendBudget {
+  arcforges.foundation.v1.Id authorisation_id = 1 [json_name = "authorisationId"];
+  optional uint64 maximum = 2 [json_name = "maximum"];
+  optional uint64 spent = 3 [json_name = "spent"];
+  optional uint64 held = 4 [json_name = "held"];
+  arcforges.foundation.v1.Instant expires_at = 5 [json_name = "expiresAt"];
+  arcforges.foundation.v1.Instant revoked_at = 6 [json_name = "revokedAt"];
+}
+
+message ChargeExplanation {
+  arcforges.foundation.v1.Id logical_request_id = 1 [json_name = "logicalRequestId"];
+  optional string state = 2 [json_name = "state"];
+  optional string reason = 3 [json_name = "reason"];
+  optional uint64 capacity_debit = 4 [json_name = "capacityDebit"];
+  optional uint64 compensation_debit = 5 [json_name = "compensationDebit"];
+  optional uint64 purchased_debit = 6 [json_name = "purchasedDebit"];
+  optional string tariff_version = 7 [json_name = "tariffVersion"];
+  optional string supplier_version = 8 [json_name = "supplierVersion"];
+  repeated AttemptCharge attempts = 9 [json_name = "attempts"];
+}
+
+message AttemptCharge {
+  arcforges.foundation.v1.Id attempt_id = 1 [json_name = "attemptId"];
+  optional string model_id = 2 [json_name = "modelId"];
+  ModelUsage usage = 3 [json_name = "usage"];
+  arcforges.foundation.v1.Decimal supplier_cost = 4 [json_name = "supplierCost"];
+  optional uint64 customer_debit = 5 [json_name = "customerDebit"];
+  optional arcforges.foundation.v1.EffectCertainty certainty = 6 [json_name = "certainty"];
+}
+
+message ModelUsage {
+  optional uint64 input_tokens = 1 [json_name = "inputTokens"];
+  optional uint64 output_tokens = 2 [json_name = "outputTokens"];
+  optional uint64 cached_input_tokens = 3 [json_name = "cachedInputTokens"];
+  arcforges.foundation.v1.Instant measured_at = 4 [json_name = "measuredAt"];
+  optional string source = 5 [json_name = "source"];
+
+  reserved 6;
+  reserved "audio_milliseconds";
+}
+
+message Offer {
+  arcforges.foundation.v1.Id offer_id = 1 [json_name = "offerId"];
+  optional string price_version = 2 [json_name = "priceVersion"];
+  optional string kind = 3 [json_name = "kind"];
+  optional string currency = 4 [json_name = "currency"];
+  arcforges.foundation.v1.Decimal amount = 5 [json_name = "amount"];
+  optional string interval = 6 [json_name = "interval"];
+  repeated string entitlements = 7 [json_name = "entitlements"];
+  optional string region = 8 [json_name = "region"];
+}
+
+message PurchaseView {
+  arcforges.foundation.v1.Id purchase_intent_id = 1 [json_name = "purchaseIntentId"];
+  optional string state = 2 [json_name = "state"];
+  arcforges.foundation.v1.Id offer_id = 3 [json_name = "offerId"];
+  arcforges.foundation.v1.Id order_id = 4 [json_name = "orderId"];
+  optional string reason = 5 [json_name = "reason"];
+}
+
+message CheckoutView {
+  arcforges.foundation.v1.Id checkout_attempt_id = 1 [json_name = "checkoutAttemptId"];
+  arcforges.foundation.v1.Id purchase_intent_id = 2 [json_name = "purchaseIntentId"];
+  optional string url = 3 [json_name = "url"];
+  arcforges.foundation.v1.Instant expires_at = 4 [json_name = "expiresAt"];
+}
+
+message SubscriptionView {
+  arcforges.foundation.v1.Id subscription_id = 1 [json_name = "subscriptionId"];
+  optional SubscriptionState state = 2 [json_name = "state"];
+  arcforges.foundation.v1.TimeRangeUtc current_period = 3 [json_name = "currentPeriod"];
+  optional bool cancel_at_period_end = 4 [json_name = "cancelAtPeriodEnd"];
+  arcforges.foundation.v1.Revision revision = 5 [json_name = "revision"];
+}
+
+message CreditPool {
+  optional uint64 available = 1 [json_name = "available"];
+  optional uint64 held = 2 [json_name = "held"];
+  repeated CreditLot lots = 3 [json_name = "lots"];
+}
+
+message CreditLot {
+  arcforges.foundation.v1.Id lot_id = 1 [json_name = "lotId"];
+  optional string kind = 2 [json_name = "kind"];
+  optional uint64 amount = 3 [json_name = "amount"];
+  optional uint64 remaining = 4 [json_name = "remaining"];
+  arcforges.foundation.v1.Instant expires_at = 5 [json_name = "expiresAt"];
+  arcforges.foundation.v1.Id source_order_id = 6 [json_name = "sourceOrderId"];
+}
+
+message BillingItem {
+  arcforges.foundation.v1.Id item_id = 1 [json_name = "itemId"];
+  optional string kind = 2 [json_name = "kind"];
+  optional string state = 3 [json_name = "state"];
+  arcforges.foundation.v1.Decimal amount = 4 [json_name = "amount"];
+  optional string currency = 5 [json_name = "currency"];
+  arcforges.foundation.v1.Instant occurred_at = 6 [json_name = "occurredAt"];
+  optional string document_url = 7 [json_name = "documentUrl"];
+}
+
+message RefundView {
+  arcforges.foundation.v1.Id refund_id = 1 [json_name = "refundId"];
+  optional string state = 2 [json_name = "state"];
+  arcforges.foundation.v1.Id payment_id = 3 [json_name = "paymentId"];
+  arcforges.foundation.v1.Decimal amount = 4 [json_name = "amount"];
+  optional string reason = 5 [json_name = "reason"];
+}
+
+message ExportJob {
+  arcforges.foundation.v1.Id export_id = 1 [json_name = "exportId"];
+  optional string state = 2 [json_name = "state"];
+  optional int32 progress = 3 [json_name = "progress"];
+  repeated arcforges.foundation.v1.VersionedRef snapshot_refs = 4 [json_name = "snapshotRefs"];
+  arcforges.foundation.v1.ArtifactRef artifact = 5 [json_name = "artifact"];
+  arcforges.foundation.v1.Instant expires_at = 6 [json_name = "expiresAt"];
+  optional string reason = 7 [json_name = "reason"];
+}
+
+message EntitlementServiceGetSnapshotRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+}
+message EntitlementServiceGetSnapshotValue { EntitlementSnapshot snapshot = 10 [json_name = "snapshot"]; }
+message EntitlementServiceGetSnapshotResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    EntitlementServiceGetSnapshotValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message EntitlementServiceGetServiceTermRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+}
+message EntitlementServiceGetServiceTermValue { ServiceTerm term = 10 [json_name = "term"]; }
+message EntitlementServiceGetServiceTermResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    EntitlementServiceGetServiceTermValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message EntitlementServiceGetCapacityRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+}
+message EntitlementServiceGetCapacityValue { Capacity capacity = 10 [json_name = "capacity"]; }
+message EntitlementServiceGetCapacityResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    EntitlementServiceGetCapacityValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message EntitlementServiceListGrantsRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.PageRequest page = 10 [json_name = "page"];
+}
+message EntitlementServiceListGrantsValue {
+  repeated Grant items = 10 [json_name = "items"];
+  arcforges.foundation.v1.PageState page = 11 [json_name = "page"];
+}
+message EntitlementServiceListGrantsResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    EntitlementServiceListGrantsValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message EntitlementServiceGetUsageRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.TimeRangeUtc period = 10 [json_name = "period"];
+}
+message EntitlementServiceGetUsageValue { repeated QuotaUsage usage = 10 [json_name = "usage"]; }
+message EntitlementServiceGetUsageResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    EntitlementServiceGetUsageValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message EntitlementServiceCheckRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  repeated string capabilities = 10 [json_name = "capabilities"];
+}
+message EntitlementServiceCheckValue { repeated Availability items = 10 [json_name = "items"]; }
+message EntitlementServiceCheckResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    EntitlementServiceCheckValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message CommerceServiceAuthoriseExtraUsageRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id authorisation_id = 10 [json_name = "authorisationId"];
+  optional uint64 max_budget = 11 [json_name = "maxBudget"];
+  arcforges.foundation.v1.Instant expires_at = 12 [json_name = "expiresAt"];
+}
+message CommerceServiceAuthoriseExtraUsageValue { SpendBudget budget = 10 [json_name = "budget"]; }
+message CommerceServiceAuthoriseExtraUsageResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceAuthoriseExtraUsageValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message CommerceServiceRevokeExtraUsageRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id authorisation_id = 10 [json_name = "authorisationId"];
+}
+message CommerceServiceRevokeExtraUsageValue { arcforges.foundation.v1.Receipt receipt = 10 [json_name = "receipt"]; }
+message CommerceServiceRevokeExtraUsageResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceRevokeExtraUsageValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message CommerceServiceExplainChargeRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id logical_request_id = 10 [json_name = "logicalRequestId"];
+}
+message CommerceServiceExplainChargeValue { ChargeExplanation explanation = 10 [json_name = "explanation"]; }
+message CommerceServiceExplainChargeResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceExplainChargeValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message CommerceServiceGetCatalogueRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  optional string region = 10 [json_name = "region"];
+}
+message CommerceServiceGetCatalogueValue {
+  repeated Offer items = 10 [json_name = "items"];
+  optional string catalogue_version = 11 [json_name = "catalogueVersion"];
+}
+message CommerceServiceGetCatalogueResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceGetCatalogueValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message CommerceServiceCreatePurchaseIntentRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id purchase_intent_id = 10 [json_name = "purchaseIntentId"];
+  arcforges.foundation.v1.Id offer_id = 11 [json_name = "offerId"];
+  optional string price_version = 12 [json_name = "priceVersion"];
+  optional string region = 13 [json_name = "region"];
+}
+message CommerceServiceCreatePurchaseIntentValue { PurchaseView purchase = 10 [json_name = "purchase"]; }
+message CommerceServiceCreatePurchaseIntentResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceCreatePurchaseIntentValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message CommerceServiceCreateCheckoutAttemptRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id purchase_intent_id = 10 [json_name = "purchaseIntentId"];
+  arcforges.foundation.v1.Id checkout_attempt_id = 11 [json_name = "checkoutAttemptId"];
+  optional string return_route = 12 [json_name = "returnRoute"];
+}
+message CommerceServiceCreateCheckoutAttemptValue { CheckoutView checkout = 10 [json_name = "checkout"]; }
+message CommerceServiceCreateCheckoutAttemptResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceCreateCheckoutAttemptValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message CommerceServiceGetPurchaseStateRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id purchase_intent_id = 10 [json_name = "purchaseIntentId"];
+}
+message CommerceServiceGetPurchaseStateValue { PurchaseView purchase = 10 [json_name = "purchase"]; }
+message CommerceServiceGetPurchaseStateResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceGetPurchaseStateValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message CommerceServiceGetSubscriptionRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+}
+message CommerceServiceGetSubscriptionValue { SubscriptionView subscription = 10 [json_name = "subscription"]; }
+message CommerceServiceGetSubscriptionResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceGetSubscriptionValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message CommerceServiceCancelSubscriptionRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id subscription_id = 10 [json_name = "subscriptionId"];
+}
+message CommerceServiceCancelSubscriptionValue { SubscriptionView subscription = 10 [json_name = "subscription"]; }
+message CommerceServiceCancelSubscriptionResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceCancelSubscriptionValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message CommerceServiceReactivateSubscriptionRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id subscription_id = 10 [json_name = "subscriptionId"];
+}
+message CommerceServiceReactivateSubscriptionValue { SubscriptionView subscription = 10 [json_name = "subscription"]; }
+message CommerceServiceReactivateSubscriptionResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceReactivateSubscriptionValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message CommerceServiceGetCreditsRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+}
+message CommerceServiceGetCreditsValue {
+  Capacity capacity = 10 [json_name = "capacity"];
+  repeated CreditLot compensation = 11 [json_name = "compensation"];
+  CreditPool purchased = 12 [json_name = "purchased"];
+}
+message CommerceServiceGetCreditsResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceGetCreditsValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message CommerceServiceListBillingHistoryRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.TimeRangeUtc period = 10 [json_name = "period"];
+  arcforges.foundation.v1.PageRequest page = 11 [json_name = "page"];
+}
+message CommerceServiceListBillingHistoryValue {
+  repeated BillingItem items = 10 [json_name = "items"];
+  arcforges.foundation.v1.PageState page = 11 [json_name = "page"];
+}
+message CommerceServiceListBillingHistoryResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceListBillingHistoryValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message CommerceServiceRequestRefundRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id refund_id = 10 [json_name = "refundId"];
+  arcforges.foundation.v1.Id payment_id = 11 [json_name = "paymentId"];
+  optional string reason = 12 [json_name = "reason"];
+}
+message CommerceServiceRequestRefundValue { RefundView refund = 10 [json_name = "refund"]; }
+message CommerceServiceRequestRefundResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceRequestRefundValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message CommerceServiceExportEvidenceRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.TimeRangeUtc period = 10 [json_name = "period"];
+}
+message CommerceServiceExportEvidenceValue { ExportJob job = 10 [json_name = "job"]; }
+message CommerceServiceExportEvidenceResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    CommerceServiceExportEvidenceValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}

package/source.json

@@ -1,8 +1,8 @@
 {
   "repository": "https://github.com/ArcForges/Contracts",
-  "commit": "d4a50fc7e129e5cff28aeb68976f8d1182807f2f",
+  "commit": "063762f32c551449fb01936d9ec30fedb77260de",
   "dirty": false,
-  "version": "1.0.0-ci.241.1",
+  "version": "1.0.0-ci.244.1",
   "contractAccess": "public",
   "schemaSources": {
     "public/http/v1/inventory.schema.json": "2d17acc663de43ff847e522ddb16f32b1e7ec356df7db7dcafe8342d3fb014ce",
@@ -16,11 +16,12 @@
     "public/proto/arcforges/events/v1/events.proto": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43",
     "public/proto/arcforges/foundation/v1/foundation.proto": "adff62f65799bc5523965caf40f1f6bf11cbb4e2d769f46d9e3183a72a6d24d5",
     "public/proto/arcforges/hello/v1/hello.proto": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9",
+    "public/proto/arcforges/publicapi/v1/commerce.proto": "e0ed5700197fdb20006c7ea699d9071dd8c4ac9d4248651f8a148363ad8af9dc",
     "public/proto/arcforges/publicapi/v1/content.proto": "1c912ac9fa37633a3e5d186cb6f3838bd886f09f935e1ce41c5a665640c54abd",
     "public/proto/arcforges/publicapi/v1/descriptors.proto": "d8a43c27fd345d55786a67ce9776efa0b4bc089f57361c3e532dd1b5f9326161",
     "public/proto/arcforges/publicapi/v1/inprocess-values.proto": "24921ae4f54f48800ea1201a9eee27a4e23a476b738cc3903665dff137a10eea"
   },
-  "descriptorSha256": "13c9a31eacff4614dd41f90cc861fd4b1ce11e221081a42579b1f486758bba0a",
+  "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf",
   "dependencyLocks": {
     "package-lock.json": "3e536db25743ceb5a021559dbc1f31d57112211c62d94f84df34daca5382709c",
     "src/public/dotnet/ArcForges.Contracts.Foundation/packages.lock.json": "fa17fe6057706e36ae0b9370a457536d05d0f3a8f0f72df622881bfc1628337e",