@happyvertical/smrt-subscriptions 0.51.21 → 0.51.24

package/dist/smrt-knowledge.json

@@ -3,13 +3,13 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-subscriptions",
-  "packageVersion": "0.51.21",
+  "packageVersion": "0.51.24",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "be2478f49ab65bd73b8a44ca0823e356ee65fe884512c312c9ecfc321413c594",
-    "packageJson": "3c1cdf3ff2af24ec038b1f747f103966b09ff38bb00907f8b1fba6eac1a3211f",
-    "agents": "149a45af3f2a142302dae957dd80c29dc11c30a3f40520679aad1e0029f6c4f8"
+    "manifest": "8ff906be519d9c5ef124675c0b671342369c6e3d326bb49747de6aeb4ae67b04",
+    "packageJson": "1c2be76b491ab95393c56fe66863c69afd9d1f21d91118da73b4041d6fe217ca",
+    "agents": "debf4259aee01e1df2ce90f22dec0321a0589cd5a3453541c15221dc437878b0"
   },
   "exports": [
     ".",
@@ -49,6 +49,7 @@
     "subscriptions"
   ],
   "risks": [
+    "cross-package-refs:6",
     "sensitive-fields-excluded"
   ],
   "objects": [
@@ -1430,9 +1431,24 @@
           "required": false,
           "columnType": "BOOLEAN",
           "default": true
+        },
+        {
+          "name": "priceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "priceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
         }
       ],
-      "relationships": [],
       "methods": [
         "getTerms",
         "setTerms"
@@ -1603,6 +1619,7 @@
         }
       ],
       "relationshipFeatures": [
+        "foreignKey",
         "uuidColumns"
       ],
       "tags": [],
@@ -1629,6 +1646,13 @@
           "related": "TenantUsageMetric",
           "columnType": "UUID"
         },
+        {
+          "name": "usageTenantId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
         {
           "name": "subscriberKind",
           "type": "text",
@@ -1713,6 +1737,13 @@
           "related": "PricingRule",
           "columnType": "UUID"
         },
+        {
+          "name": "priceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        },
         {
           "name": "pricingSnapshot",
           "type": "text",
@@ -1742,12 +1773,26 @@
           "related": "TenantUsageMetric",
           "columnType": "UUID"
         },
+        {
+          "name": "usageTenantId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
         {
           "name": "pricingRuleId",
           "type": "foreignKey",
           "required": false,
           "related": "PricingRule",
           "columnType": "UUID"
+        },
+        {
+          "name": "priceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
         }
       ],
       "methods": [
@@ -1819,6 +1864,7 @@
         }
       ],
       "relationshipFeatures": [
+        "crossPackageRef",
         "foreignKey",
         "uuidColumns"
       ],
@@ -1898,60 +1944,803 @@
           "columnType": "UUID"
         }
       ],
-      "methods": [],
+      "methods": [],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "billingadjustments.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment",
+          "path": "/billingadjustments",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "billingadjustments.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment",
+          "path": "/billingadjustments/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "billingadjustment_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+        },
+        {
+          "kind": "cli",
+          "name": "billingadjustment_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+        },
+        {
+          "kind": "mcp",
+          "name": "billingadjustment_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+        },
+        {
+          "kind": "mcp",
+          "name": "billingadjustment_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SpendingPolicy",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
+      "collection": "spendingpolicies",
+      "tableName": "_smrt_spending_policies",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "subscriberKind",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "subscriberExternalId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "projectId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "serviceKey",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "metricKey",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "period",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "month"
+        },
+        {
+          "name": "rollingSeconds",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "limitAmount",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "currency",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "USD"
+        },
+        {
+          "name": "behavior",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "observe"
+        },
+        {
+          "name": "priority",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "active",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN",
+          "default": true
+        },
+        {
+          "name": "basis",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "billed"
+        },
+        {
+          "name": "setByTenantId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "balanceFrom",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "setByTenantId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "subscriber_kind",
+        "subscriber_external_id",
+        "project_id",
+        "service_key",
+        "metric_key",
+        "period",
+        "name"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "spendingpolicies.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
+          "path": "/spendingpolicies",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "spendingpolicies.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
+          "path": "/spendingpolicies/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "spendingpolicies.create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
+          "path": "/spendingpolicies",
+          "method": "POST"
+        },
+        {
+          "kind": "api",
+          "name": "spendingpolicies.update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
+          "path": "/spendingpolicies/[id]",
+          "method": "PATCH"
+        },
+        {
+          "kind": "api",
+          "name": "spendingpolicies.delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
+          "path": "/spendingpolicies/[id]",
+          "method": "DELETE"
+        },
+        {
+          "kind": "cli",
+          "name": "spendingpolicy_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "cli",
+          "name": "spendingpolicy_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "cli",
+          "name": "spendingpolicy_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "cli",
+          "name": "spendingpolicy_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "cli",
+          "name": "spendingpolicy_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "mcp",
+          "name": "spendingpolicy_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "mcp",
+          "name": "spendingpolicy_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "mcp",
+          "name": "spendingpolicy_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "mcp",
+          "name": "spendingpolicy_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        },
+        {
+          "kind": "mcp",
+          "name": "spendingpolicy_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "PricingRuleCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:PricingRuleCollection",
+      "collection": "pricingrules",
+      "tableName": "_smrt_pricing_rules",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ClientChargeCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:ClientChargeCollection",
+      "collection": "clientcharges",
+      "tableName": "_smrt_client_charges",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "BillingAdjustmentCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:BillingAdjustmentCollection",
+      "collection": "billingadjustments",
+      "tableName": "_smrt_billing_adjustments",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SpendingPolicyCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:SpendingPolicyCollection",
+      "collection": "spendingpolicies",
+      "tableName": "_smrt_spending_policies",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "PriceBook",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:PriceBook",
+      "collection": "pricebooks",
+      "tableName": "_smrt_price_books",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "bookKey",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "kind",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "retail"
+        },
+        {
+          "name": "active",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN",
+          "default": true
+        }
+      ],
+      "relationships": [],
+      "methods": [],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "book_key"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "PriceBookAssignment",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:PriceBookAssignment",
+      "collection": "pricebookassignments",
+      "tableName": "_smrt_price_book_assignments",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "childTenantId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "resellerTenantId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "wholesalePriceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        },
+        {
+          "name": "wholesaleCurrency",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "retailPriceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        },
+        {
+          "name": "retailCurrency",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        }
+      ],
+      "relationships": [
+        {
+          "name": "childTenantId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "resellerTenantId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "wholesalePriceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        },
+        {
+          "name": "retailPriceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [],
+      "conflictColumns": [
+        "child_tenant_id"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "RetailCharge",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:RetailCharge",
+      "collection": "retailcharges",
+      "tableName": "_smrt_retail_charges",
+      "packageName": "@happyvertical/smrt-subscriptions",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "resellerTenantId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "usageEventId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "TenantUsageMetric",
+          "columnType": "UUID"
+        },
+        {
+          "name": "clientChargeId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ClientCharge",
+          "columnType": "UUID"
+        },
+        {
+          "name": "subscriberKind",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "tenant"
+        },
+        {
+          "name": "subscriberExternalId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "projectId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "workRefType",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "workRefId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "provider",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "serviceKey",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "metricKey",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "quantity",
+          "type": "decimal",
+          "required": false,
+          "columnType": "REAL",
+          "default": 0
+        },
+        {
+          "name": "amount",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "currency",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "USD"
+        },
+        {
+          "name": "priceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        },
+        {
+          "name": "pricingRuleId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PricingRule",
+          "columnType": "UUID"
+        },
+        {
+          "name": "pricingSnapshot",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "{}"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "draft"
+        },
+        {
+          "name": "approvedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "resellerTenantId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "usageEventId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "TenantUsageMetric",
+          "columnType": "UUID"
+        },
+        {
+          "name": "clientChargeId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ClientCharge",
+          "columnType": "UUID"
+        },
+        {
+          "name": "priceBookId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PriceBook",
+          "columnType": "UUID"
+        },
+        {
+          "name": "pricingRuleId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "PricingRule",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "getPricingSnapshot"
+      ],
+      "methodSignatures": [
+        {
+          "name": "getPricingSnapshot",
+          "returns": "Record<string, unknown>"
+        }
+      ],
       "tenant": {
         "scoped": true,
         "mode": "required",
         "field": "tenantId"
       },
       "conflictColumns": [
-        "tenant_id",
-        "slug",
-        "context"
+        "usage_event_id"
       ],
       "surfaces": [
         {
           "kind": "api",
-          "name": "billingadjustments.list",
+          "name": "retailcharges.list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment",
-          "path": "/billingadjustments",
+          "objectName": "@happyvertical/smrt-subscriptions:RetailCharge",
+          "path": "/retailcharges",
           "method": "GET"
         },
         {
           "kind": "api",
-          "name": "billingadjustments.get",
+          "name": "retailcharges.get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment",
-          "path": "/billingadjustments/[id]",
+          "objectName": "@happyvertical/smrt-subscriptions:RetailCharge",
+          "path": "/retailcharges/[id]",
           "method": "GET"
         },
         {
           "kind": "cli",
-          "name": "billingadjustment_list",
+          "name": "retailcharge_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+          "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
         },
         {
           "kind": "cli",
-          "name": "billingadjustment_get",
+          "name": "retailcharge_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+          "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
         },
         {
           "kind": "mcp",
-          "name": "billingadjustment_list",
+          "name": "retailcharge_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+          "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
         },
         {
           "kind": "mcp",
-          "name": "billingadjustment_get",
+          "name": "retailcharge_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-subscriptions:BillingAdjustment"
+          "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
+        }
+      ],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getPricingSnapshot",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
         }
       ],
       "relationshipFeatures": [
+        "crossPackageRef",
         "foreignKey",
         "uuidColumns"
       ],
@@ -1959,10 +2748,10 @@
       "risks": []
     },
     {
-      "name": "SpendingPolicy",
-      "qualifiedName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
-      "collection": "spendingpolicies",
-      "tableName": "_smrt_spending_policies",
+      "name": "CreditGrant",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:CreditGrant",
+      "collection": "creditgrants",
+      "tableName": "_smrt_credit_grants",
       "packageName": "@happyvertical/smrt-subscriptions",
       "extends": "SmrtObject",
       "fields": [
@@ -1973,98 +2762,71 @@
           "columnType": "UUID"
         },
         {
-          "name": "name",
-          "type": "text",
+          "name": "spendingPolicyId",
+          "type": "foreignKey",
           "required": false,
-          "columnType": "TEXT",
-          "default": ""
+          "related": "SpendingPolicy",
+          "columnType": "UUID"
         },
         {
-          "name": "subscriberKind",
-          "type": "text",
+          "name": "amount",
+          "type": "integer",
           "required": false,
-          "columnType": "TEXT",
-          "default": ""
+          "columnType": "INTEGER",
+          "default": 0
         },
         {
-          "name": "subscriberExternalId",
+          "name": "currency",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "USD"
         },
         {
-          "name": "projectId",
+          "name": "reason",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
           "default": ""
         },
         {
-          "name": "serviceKey",
+          "name": "source",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
           "default": ""
         },
         {
-          "name": "metricKey",
+          "name": "sourceId",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
           "default": ""
         },
         {
-          "name": "period",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT",
-          "default": "month"
-        },
-        {
-          "name": "rollingSeconds",
-          "type": "integer",
-          "required": false,
-          "columnType": "INTEGER",
-          "default": 0
-        },
-        {
-          "name": "limitAmount",
-          "type": "integer",
-          "required": false,
-          "columnType": "INTEGER",
-          "default": 0
-        },
-        {
-          "name": "currency",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT",
-          "default": "USD"
-        },
-        {
-          "name": "behavior",
-          "type": "text",
+          "name": "grantedByTenantId",
+          "type": "crossPackageRef",
           "required": false,
-          "columnType": "TEXT",
-          "default": "observe"
-        },
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
+        }
+      ],
+      "relationships": [
         {
-          "name": "priority",
-          "type": "integer",
+          "name": "spendingPolicyId",
+          "type": "foreignKey",
           "required": false,
-          "columnType": "INTEGER",
-          "default": 0
+          "related": "SpendingPolicy",
+          "columnType": "UUID"
         },
         {
-          "name": "active",
-          "type": "boolean",
+          "name": "grantedByTenantId",
+          "type": "crossPackageRef",
           "required": false,
-          "columnType": "BOOLEAN",
-          "default": true
+          "related": "@happyvertical/smrt-users:Tenant",
+          "columnType": "UUID"
         }
       ],
-      "relationships": [],
       "methods": [],
       "tenant": {
         "scoped": true,
@@ -2073,127 +2835,64 @@
       },
       "conflictColumns": [
         "tenant_id",
-        "subscriber_kind",
-        "subscriber_external_id",
-        "project_id",
-        "service_key",
-        "metric_key",
-        "period",
-        "name"
+        "slug",
+        "context"
       ],
       "surfaces": [
         {
           "kind": "api",
-          "name": "spendingpolicies.list",
+          "name": "creditgrants.list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
-          "path": "/spendingpolicies",
+          "objectName": "@happyvertical/smrt-subscriptions:CreditGrant",
+          "path": "/creditgrants",
           "method": "GET"
         },
         {
           "kind": "api",
-          "name": "spendingpolicies.get",
+          "name": "creditgrants.get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
-          "path": "/spendingpolicies/[id]",
+          "objectName": "@happyvertical/smrt-subscriptions:CreditGrant",
+          "path": "/creditgrants/[id]",
           "method": "GET"
         },
-        {
-          "kind": "api",
-          "name": "spendingpolicies.create",
-          "operation": "create",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
-          "path": "/spendingpolicies",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "spendingpolicies.update",
-          "operation": "update",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
-          "path": "/spendingpolicies/[id]",
-          "method": "PATCH"
-        },
-        {
-          "kind": "api",
-          "name": "spendingpolicies.delete",
-          "operation": "delete",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy",
-          "path": "/spendingpolicies/[id]",
-          "method": "DELETE"
-        },
         {
           "kind": "cli",
-          "name": "spendingpolicy_list",
+          "name": "creditgrant_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+          "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
         },
         {
           "kind": "cli",
-          "name": "spendingpolicy_get",
+          "name": "creditgrant_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
-        },
-        {
-          "kind": "cli",
-          "name": "spendingpolicy_create",
-          "operation": "create",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
-        },
-        {
-          "kind": "cli",
-          "name": "spendingpolicy_update",
-          "operation": "update",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
-        },
-        {
-          "kind": "cli",
-          "name": "spendingpolicy_delete",
-          "operation": "delete",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+          "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
         },
         {
           "kind": "mcp",
-          "name": "spendingpolicy_list",
+          "name": "creditgrant_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+          "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
         },
         {
           "kind": "mcp",
-          "name": "spendingpolicy_get",
+          "name": "creditgrant_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
-        },
-        {
-          "kind": "mcp",
-          "name": "spendingpolicy_create",
-          "operation": "create",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
-        },
-        {
-          "kind": "mcp",
-          "name": "spendingpolicy_update",
-          "operation": "update",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
-        },
-        {
-          "kind": "mcp",
-          "name": "spendingpolicy_delete",
-          "operation": "delete",
-          "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+          "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
         }
       ],
       "relationshipFeatures": [
+        "crossPackageRef",
+        "foreignKey",
         "uuidColumns"
       ],
       "tags": [],
       "risks": []
     },
     {
-      "name": "PricingRuleCollection",
-      "qualifiedName": "@happyvertical/smrt-subscriptions:PricingRuleCollection",
-      "collection": "pricingrules",
-      "tableName": "_smrt_pricing_rules",
+      "name": "PriceBookCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:PriceBookCollection",
+      "collection": "pricebooks",
+      "tableName": "_smrt_price_books",
       "packageName": "@happyvertical/smrt-subscriptions",
       "extends": "SmrtCollection",
       "fields": [],
@@ -2207,10 +2906,10 @@
       "risks": []
     },
     {
-      "name": "ClientChargeCollection",
-      "qualifiedName": "@happyvertical/smrt-subscriptions:ClientChargeCollection",
-      "collection": "clientcharges",
-      "tableName": "_smrt_client_charges",
+      "name": "PriceBookAssignmentCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:PriceBookAssignmentCollection",
+      "collection": "pricebookassignments",
+      "tableName": "_smrt_price_book_assignments",
       "packageName": "@happyvertical/smrt-subscriptions",
       "extends": "SmrtCollection",
       "fields": [],
@@ -2224,10 +2923,10 @@
       "risks": []
     },
     {
-      "name": "BillingAdjustmentCollection",
-      "qualifiedName": "@happyvertical/smrt-subscriptions:BillingAdjustmentCollection",
-      "collection": "billingadjustments",
-      "tableName": "_smrt_billing_adjustments",
+      "name": "RetailChargeCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:RetailChargeCollection",
+      "collection": "retailcharges",
+      "tableName": "_smrt_retail_charges",
       "packageName": "@happyvertical/smrt-subscriptions",
       "extends": "SmrtCollection",
       "fields": [],
@@ -2241,10 +2940,10 @@
       "risks": []
     },
     {
-      "name": "SpendingPolicyCollection",
-      "qualifiedName": "@happyvertical/smrt-subscriptions:SpendingPolicyCollection",
-      "collection": "spendingpolicies",
-      "tableName": "_smrt_spending_policies",
+      "name": "CreditGrantCollection",
+      "qualifiedName": "@happyvertical/smrt-subscriptions:CreditGrantCollection",
+      "collection": "creditgrants",
+      "tableName": "_smrt_credit_grants",
       "packageName": "@happyvertical/smrt-subscriptions",
       "extends": "SmrtCollection",
       "fields": [],
@@ -3092,16 +3791,96 @@
       "name": "spendingpolicy_delete",
       "operation": "delete",
       "objectName": "@happyvertical/smrt-subscriptions:SpendingPolicy"
+    },
+    {
+      "kind": "api",
+      "name": "retailcharges.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-subscriptions:RetailCharge",
+      "path": "/retailcharges",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "retailcharges.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-subscriptions:RetailCharge",
+      "path": "/retailcharges/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "retailcharge_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
+    },
+    {
+      "kind": "cli",
+      "name": "retailcharge_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
+    },
+    {
+      "kind": "mcp",
+      "name": "retailcharge_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
+    },
+    {
+      "kind": "mcp",
+      "name": "retailcharge_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-subscriptions:RetailCharge"
+    },
+    {
+      "kind": "api",
+      "name": "creditgrants.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-subscriptions:CreditGrant",
+      "path": "/creditgrants",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "creditgrants.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-subscriptions:CreditGrant",
+      "path": "/creditgrants/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "creditgrant_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
+    },
+    {
+      "kind": "cli",
+      "name": "creditgrant_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
+    },
+    {
+      "kind": "mcp",
+      "name": "creditgrant_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
+    },
+    {
+      "kind": "mcp",
+      "name": "creditgrant_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-subscriptions:CreditGrant"
     }
   ],
   "prompts": [],
   "relationshipsV2": {
-    "foreignKeyFields": 4,
-    "crossPackageRefFields": 0,
+    "foreignKeyFields": 13,
+    "crossPackageRefFields": 6,
     "junctionCollections": 0,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 36
+    "uuidColumns": 80
   },
-  "agentDoc": "# @happyvertical/smrt-subscriptions\n\nTenant subscriptions, plan features, immutable/idempotent usage evidence,\neffective-dated client pricing, scoped spending policies, and entitlement\nresolution for SMRT applications.\n\n## Validation\n\n```bash\npnpm --filter @happyvertical/smrt-subscriptions test\npnpm --filter @happyvertical/smrt-subscriptions test:postgres\npnpm --filter @happyvertical/smrt-subscriptions typecheck\npnpm --filter @happyvertical/smrt-subscriptions build\n```\n\n`test:postgres` is the lane that holds the money-column line — SQLite's type\naffinity stores a REAL in an INTEGER column without complaint, so a money field\nthat reverted to DECIMAL passes every SQLite suite.\n\n## Money\n\n- **Money is integer minor units** (cents) — `$19.99` is `1999`.\n  `SubscriptionPlan.priceAmount`, `ClientCharge.amount`,\n  `BillingAdjustment.amount` and `SpendingPolicy.limitAmount` all initialize\n  `= 0`, never `= 0.0`: the integer literal is what maps them to INTEGER\n  columns (BIGINT on fresh PostgreSQL/DuckDB databases; #2401, #2373). `ClientCharge.quantity` and `TenantUsageMetric.quantity` are\n  the opposite case — metered quantities are genuinely fractional and stay\n  DECIMAL.\n- **`PricingRule.terms` are minor units *per unit of usage*, and stay\n  fractional.** A per-token rate is routinely a fraction of a cent, so an\n  integer `unitPrice` would truncate it to zero. `calculateAmount()` rounds the\n  computed result to a whole minor unit — that is the single boundary in the\n  package where a rate meets money, and it is what lets `evaluateSpending()`\n  compare charge sums against `limitAmount` exactly.\n- **`adjust()` rejects a fractional amount.** Negative amounts are legitimate\n  (a credit); fractional ones almost always mean the caller passed major units.\n- **Billing rejects immediate JSON write-back.** The JSON adapter's default\n  `writeStrategy: 'immediate'` and DuckDB with that write-back strategy export\n  files before transaction commit, while adapter rollback restores only the\n  database transaction. `CommercialUsageService` therefore fails before setup\n  on those configurations. PostgreSQL, SQLite, ordinary DuckDB, and explicit\n  non-immediate write strategies remain supported. When supplying an already\n  resolved database handle, also pass `billingStorage` so this capability\n  decision is explicit rather than inferred from private adapter state.\n- **Embedded sourced adjustments serialize per database.** SQLite, DuckDB, and\n  supported non-immediate JSON handles multiplex local writes; the complete\n  deterministic adjustment flow, including recovery reads, runs under one\n  database-scoped lock. Every supported embedded adjustment transaction,\n  sourced or unsourced, also holds the core embedded write queue for its full\n  lifetime; transaction-bound model saves re-enter that hold so adjustments\n  cannot absorb, roll back, or deadlock with unrelated ordinary writes.\n- **UI formats by dividing, never by `toFixed`.** `PlanPicker` and\n  `CommercialOverview` scale back to major units using the currency's own\n  minor-unit exponent, so zero-decimal currencies (JPY, KRW) are not divided.\n- **Migrating an existing database**: `preflightSubscriptionsMoneyMinorUnits(db)`\n  reports which columns still hold major units and which rows would be rounded\n  or exceed JavaScript's safe-integer range; `migrateSubscriptionsMoneyToMinorUnits(db)` converts them\n  (idempotent via `_smrt_backfills`). On SQLite the values are rescaled but the\n  declared type needs the table-rebuild path (#2370). Existing\n  `PricingRule.terms` are **not** migrated automatically — only the operator\n  knows which keys in a given rule are prices rather than quantities or ratios.\n- **Range and existing deployments**: fresh PostgreSQL/DuckDB INTEGER columns\n  are BIGINT, and hydration rejects values outside JavaScript's safe-integer\n  range. Existing PostgreSQL `int4` columns require the explicit widening in #2424.\n\n## Notes\n\n- Keep Stripe-specific fields as provider binding metadata. Runtime Stripe API\n  calls belong in the HappyVertical SDK accounting provider.\n- Thresholds are evaluated from tenant usage metrics and optional AI usage\n  summaries. Resolve multiple thresholds with the batch usage path where\n  available; do not bypass tenant context in application code.\n- Use `SubscriptionResolver.create()` or an explicitly injected\n  `SubscriptionResolver` once per request when resolving entitlements multiple\n  times. Load and pass `EntitlementResolutionContext` to avoid re-reading the\n  current subscription and plan.\n- Subscription UI components should stay provider-neutral and receive actions\n  from the host app.\n"
+  "agentDoc": "# @happyvertical/smrt-subscriptions\n\nTenant subscriptions, plan features, immutable/idempotent usage evidence,\neffective-dated client pricing, scoped spending policies, and entitlement\nresolution for SMRT applications.\n\n## Validation\n\n```bash\npnpm --filter @happyvertical/smrt-subscriptions test\npnpm --filter @happyvertical/smrt-subscriptions test:postgres\npnpm --filter @happyvertical/smrt-subscriptions typecheck\npnpm --filter @happyvertical/smrt-subscriptions build\n```\n\n`test:postgres` is the lane that holds the money-column line — SQLite's type\naffinity stores a REAL in an INTEGER column without complaint, so a money field\nthat reverted to DECIMAL passes every SQLite suite.\n\n## Money\n\n- **Money is integer minor units** (cents) — `$19.99` is `1999`.\n  `SubscriptionPlan.priceAmount`, `ClientCharge.amount`, `RetailCharge.amount`,\n  `CreditGrant.amount`,\n  `BillingAdjustment.amount` and `SpendingPolicy.limitAmount` all initialize\n  `= 0`, never `= 0.0`: the integer literal is what maps them to INTEGER\n  columns (BIGINT on fresh PostgreSQL/DuckDB databases; #2401, #2373). `ClientCharge.quantity` and `TenantUsageMetric.quantity` are\n  the opposite case — metered quantities are genuinely fractional and stay\n  DECIMAL.\n- **`PricingRule.terms` are minor units *per unit of usage*, and stay\n  fractional.** A per-token rate is routinely a fraction of a cent, so an\n  integer `unitPrice` would truncate it to zero. `calculateAmount()` rounds the\n  computed result to a whole minor unit — that is the single boundary in the\n  package where a rate meets money, and it is what lets `evaluateSpending()`\n  compare charge sums against `limitAmount` exactly.\n- **`adjust()` rejects a fractional amount.** Negative amounts are legitimate\n  (a credit); fractional ones almost always mean the caller passed major units.\n- **Billing rejects immediate JSON write-back.** The JSON adapter's default\n  `writeStrategy: 'immediate'` and DuckDB with that write-back strategy export\n  files before transaction commit, while adapter rollback restores only the\n  database transaction. `CommercialUsageService` therefore fails before setup\n  on those configurations. PostgreSQL, SQLite, ordinary DuckDB, and explicit\n  non-immediate write strategies remain supported. When supplying an already\n  resolved database handle, also pass `billingStorage` so this capability\n  decision is explicit rather than inferred from private adapter state.\n- **Embedded sourced adjustments serialize per database.** SQLite, DuckDB, and\n  supported non-immediate JSON handles multiplex local writes; the complete\n  deterministic adjustment flow, including recovery reads, runs under one\n  database-scoped lock. Every supported embedded adjustment transaction,\n  sourced or unsourced, also holds the core embedded write queue for its full\n  lifetime; transaction-bound model saves re-enter that hold so adjustments\n  cannot absorb, roll back, or deadlock with unrelated ordinary writes.\n- **UI formats by dividing, never by `toFixed`.** `PlanPicker` and\n  `CommercialOverview` scale back to major units using the currency's own\n  minor-unit exponent, so zero-decimal currencies (JPY, KRW) are not divided.\n- **Migrating an existing database**: `preflightSubscriptionsMoneyMinorUnits(db)`\n  reports which columns still hold major units and which rows would be rounded\n  or exceed JavaScript's safe-integer range; `migrateSubscriptionsMoneyToMinorUnits(db)` converts them\n  (idempotent via `_smrt_backfills`). On SQLite the values are rescaled but the\n  declared type needs the table-rebuild path (#2370). Existing\n  `PricingRule.terms` are **not** migrated automatically — only the operator\n  knows which keys in a given rule are prices rather than quantities or ratios.\n- **Range and existing deployments**: fresh PostgreSQL/DuckDB INTEGER columns\n  are BIGINT, and hydration rejects values outside JavaScript's safe-integer\n  range. Existing PostgreSQL `int4` columns require the explicit widening in #2424.\n\n## Reseller billing (#3059)\n\n- Billing ownership is consumed from `smrt-tenancy`'s\n  `BillingRelationshipService` (`BillingRelationshipReader`); never re-derive\n  parentage or owners here.\n- `ClientCharge` stays one row per usage event (`usage_event_id` unique) and\n  `tenantId` is always the payer. That uniqueness is the double-billing guard\n  across owner changes; do not widen its conflict key. The retail leg lives in\n  `RetailCharge` (also one per event), written in the same transaction.\n- Price-book rules are `PricingRule` rows with `priceBookId`; `price()` must\n  keep ignoring them, and `rateUsage()` only trusts rules whose tenant owns the\n  book.\n- Delegated `SpendingPolicy` rows (`setByTenantId`) are guarded in\n  `validateBeforeSave` and a `beforeDelete` hook, by id and by conflict key;\n  `CreditGrant` applies the same parent-only rule to delegated balances.\n  `PriceBookAssignmentCollection` is deliberately not a root export.\n- `ResellerBillingService` authorizes first, then writes in a system context\n  (parent writes land on child-owned rows). The wholesale leg is authorized by\n  the book's publisher and may never be published by the payer; whether a\n  publisher is a legitimate provider for the reseller is a host obligation\n  (the model records no upstream seller). Relationship reads precede\n  authorization and stay under smrt-tenancy's own read rules. The only\n  cross-tenant read in evaluation is the bounded `wholesale`-basis sum.\n- `balance` policies take their limit from `CreditGrant`s; `limitAmount` must\n  be 0, and currency and period are fixed once saved (the ledger is scoped to\n  them). Auto top-up is a host hook only — no payment provider calls.\n\n## Notes\n\n- Keep Stripe-specific fields as provider binding metadata. Runtime Stripe API\n  calls belong in the HappyVertical SDK accounting provider.\n- Thresholds are evaluated from tenant usage metrics and optional AI usage\n  summaries. Resolve multiple thresholds with the batch usage path where\n  available; do not bypass tenant context in application code.\n- Use `SubscriptionResolver.create()` or an explicitly injected\n  `SubscriptionResolver` once per request when resolving entitlements multiple\n  times. Load and pass `EntitlementResolutionContext` to avoid re-reading the\n  current subscription and plan.\n- Subscription UI components should stay provider-neutral and receive actions\n  from the host app.\n"
 }