@oxy.so/contracts 5.8.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/dist/cjs/accountAccess.js +6 -5
  2. package/dist/cjs/accountEmail.js +13 -5
  3. package/dist/cjs/accountGraph.js +10 -9
  4. package/dist/cjs/accountName.js +3 -2
  5. package/dist/cjs/agency.js +91 -34
  6. package/dist/cjs/agentKeys.js +21 -17
  7. package/dist/cjs/appAssertions.js +14 -13
  8. package/dist/cjs/applicationRoles.js +19 -12
  9. package/dist/cjs/civic.js +10 -9
  10. package/dist/cjs/client/check.js +61 -53
  11. package/dist/cjs/consoleOnboarding.js +9 -4
  12. package/dist/cjs/contentClaims.js +23 -14
  13. package/dist/cjs/deviceDirectory.js +11 -9
  14. package/dist/cjs/deviceSession.js +27 -25
  15. package/dist/cjs/email/messages.js +20 -18
  16. package/dist/cjs/emailAgentContext.js +11 -9
  17. package/dist/cjs/externalIdentity.js +15 -11
  18. package/dist/cjs/federationInstanceFetch.js +12 -7
  19. package/dist/cjs/identity.js +19 -17
  20. package/dist/cjs/identityLink.js +6 -4
  21. package/dist/cjs/identityProof.js +6 -4
  22. package/dist/cjs/inboxPush.js +5 -4
  23. package/dist/cjs/index.js +15 -6
  24. package/dist/cjs/inference/accountBilling.js +35 -33
  25. package/dist/cjs/inference/aliaModelRelease.js +9 -7
  26. package/dist/cjs/inference/attribution.js +14 -12
  27. package/dist/cjs/inference/catalogue.js +35 -29
  28. package/dist/cjs/inference/economics.js +24 -19
  29. package/dist/cjs/inference/embeddings.js +9 -7
  30. package/dist/cjs/inference/entitlement.js +17 -15
  31. package/dist/cjs/inference/errors.js +15 -8
  32. package/dist/cjs/inference/identifiers.js +33 -21
  33. package/dist/cjs/inference/inbox.js +37 -35
  34. package/dist/cjs/inference/modelDocumentation.js +16 -14
  35. package/dist/cjs/inference/money.js +5 -4
  36. package/dist/cjs/inference/priceVersion.js +10 -5
  37. package/dist/cjs/inference/providerConnection.js +21 -14
  38. package/dist/cjs/inference/realtime.js +88 -47
  39. package/dist/cjs/inference/request.js +27 -25
  40. package/dist/cjs/inference/routingPolicy.js +12 -10
  41. package/dist/cjs/inference/streamEvents.js +22 -16
  42. package/dist/cjs/inference/usage.js +32 -15
  43. package/dist/cjs/keyRecovery.js +8 -6
  44. package/dist/cjs/keyRotation.js +5 -4
  45. package/dist/cjs/linkedAccounts.js +22 -18
  46. package/dist/cjs/moderationReputation.js +29 -27
  47. package/dist/cjs/notifications.js +25 -9
  48. package/dist/cjs/numberChecks.js +45 -0
  49. package/dist/cjs/oauth.js +14 -12
  50. package/dist/cjs/organizations.js +23 -21
  51. package/dist/cjs/products/access.js +10 -8
  52. package/dist/cjs/products/billing.js +10 -8
  53. package/dist/cjs/products/checkout.js +22 -10
  54. package/dist/cjs/products/plans.js +15 -10
  55. package/dist/cjs/protocol.js +6 -5
  56. package/dist/cjs/recommendations.js +27 -19
  57. package/dist/cjs/reputation.js +15 -13
  58. package/dist/cjs/safety.js +43 -27
  59. package/dist/cjs/serviceToken.js +81 -2
  60. package/dist/cjs/sessionRevocation.js +8 -6
  61. package/dist/cjs/signIn.js +42 -24
  62. package/dist/cjs/stickers.js +19 -15
  63. package/dist/cjs/stringChecks.js +70 -0
  64. package/dist/cjs/transparency.js +14 -12
  65. package/dist/cjs/updates.js +24 -22
  66. package/dist/cjs/userInvalidation.js +7 -5
  67. package/dist/cjs/userResponse.js +8 -7
  68. package/dist/cjs/username.js +7 -6
  69. package/dist/esm/accountAccess.js +4 -3
  70. package/dist/esm/accountEmail.js +13 -5
  71. package/dist/esm/accountGraph.js +8 -7
  72. package/dist/esm/accountName.js +3 -2
  73. package/dist/esm/agency.js +90 -33
  74. package/dist/esm/agentKeys.js +21 -17
  75. package/dist/esm/appAssertions.js +11 -10
  76. package/dist/esm/applicationRoles.js +16 -9
  77. package/dist/esm/civic.js +8 -7
  78. package/dist/esm/client/check.js +61 -53
  79. package/dist/esm/consoleOnboarding.js +7 -2
  80. package/dist/esm/contentClaims.js +23 -14
  81. package/dist/esm/deviceDirectory.js +11 -9
  82. package/dist/esm/deviceSession.js +27 -25
  83. package/dist/esm/email/messages.js +18 -16
  84. package/dist/esm/emailAgentContext.js +11 -9
  85. package/dist/esm/externalIdentity.js +15 -11
  86. package/dist/esm/federationInstanceFetch.js +10 -5
  87. package/dist/esm/identity.js +17 -15
  88. package/dist/esm/identityLink.js +6 -4
  89. package/dist/esm/identityProof.js +6 -4
  90. package/dist/esm/inboxPush.js +3 -2
  91. package/dist/esm/index.js +4 -2
  92. package/dist/esm/inference/accountBilling.js +33 -31
  93. package/dist/esm/inference/aliaModelRelease.js +7 -5
  94. package/dist/esm/inference/attribution.js +14 -12
  95. package/dist/esm/inference/catalogue.js +33 -27
  96. package/dist/esm/inference/economics.js +22 -17
  97. package/dist/esm/inference/embeddings.js +9 -7
  98. package/dist/esm/inference/entitlement.js +15 -13
  99. package/dist/esm/inference/errors.js +13 -6
  100. package/dist/esm/inference/identifiers.js +31 -19
  101. package/dist/esm/inference/inbox.js +37 -35
  102. package/dist/esm/inference/modelDocumentation.js +14 -12
  103. package/dist/esm/inference/money.js +3 -2
  104. package/dist/esm/inference/priceVersion.js +8 -3
  105. package/dist/esm/inference/providerConnection.js +19 -12
  106. package/dist/esm/inference/realtime.js +85 -44
  107. package/dist/esm/inference/request.js +25 -23
  108. package/dist/esm/inference/routingPolicy.js +9 -7
  109. package/dist/esm/inference/streamEvents.js +20 -14
  110. package/dist/esm/inference/usage.js +30 -13
  111. package/dist/esm/keyRecovery.js +8 -6
  112. package/dist/esm/keyRotation.js +5 -4
  113. package/dist/esm/linkedAccounts.js +20 -16
  114. package/dist/esm/moderationReputation.js +27 -25
  115. package/dist/esm/notifications.js +23 -7
  116. package/dist/esm/numberChecks.js +41 -0
  117. package/dist/esm/oauth.js +14 -12
  118. package/dist/esm/organizations.js +23 -21
  119. package/dist/esm/products/access.js +10 -8
  120. package/dist/esm/products/billing.js +10 -8
  121. package/dist/esm/products/checkout.js +22 -10
  122. package/dist/esm/products/plans.js +15 -10
  123. package/dist/esm/protocol.js +4 -3
  124. package/dist/esm/recommendations.js +25 -17
  125. package/dist/esm/reputation.js +13 -11
  126. package/dist/esm/safety.js +43 -27
  127. package/dist/esm/serviceToken.js +80 -1
  128. package/dist/esm/sessionRevocation.js +6 -4
  129. package/dist/esm/signIn.js +42 -24
  130. package/dist/esm/stickers.js +17 -13
  131. package/dist/esm/stringChecks.js +63 -0
  132. package/dist/esm/transparency.js +14 -12
  133. package/dist/esm/updates.js +22 -20
  134. package/dist/esm/userInvalidation.js +4 -2
  135. package/dist/esm/userResponse.js +4 -3
  136. package/dist/esm/username.js +3 -2
  137. package/dist/types/accountAccess.d.ts +29 -70
  138. package/dist/types/accountEmail.d.ts +2 -14
  139. package/dist/types/accountGraph.d.ts +179 -171
  140. package/dist/types/accountName.d.ts +1 -1
  141. package/dist/types/accountSubject.d.ts +20 -93
  142. package/dist/types/agency.d.ts +528 -2924
  143. package/dist/types/agentKeys.d.ts +48 -421
  144. package/dist/types/appAssertions.d.ts +56 -210
  145. package/dist/types/applicationRoles.d.ts +30 -276
  146. package/dist/types/avatarCharacter.d.ts +1 -1
  147. package/dist/types/civic.d.ts +1 -13
  148. package/dist/types/client/agentKeys.d.ts +18 -18
  149. package/dist/types/client/appAssertions.d.ts +3 -3
  150. package/dist/types/client/check.d.ts +13 -13
  151. package/dist/types/client/deviceDirectory.d.ts +51 -51
  152. package/dist/types/client/deviceSession.d.ts +14 -14
  153. package/dist/types/client/organizations.d.ts +25 -25
  154. package/dist/types/client/products.d.ts +33 -33
  155. package/dist/types/client/recommendations.d.ts +2 -2
  156. package/dist/types/client/safety.d.ts +45 -45
  157. package/dist/types/client/sessionStatus.d.ts +4 -4
  158. package/dist/types/client/signIn.d.ts +1 -1
  159. package/dist/types/commonsSignIn.d.ts +4 -1
  160. package/dist/types/consoleOnboarding.d.ts +24 -44
  161. package/dist/types/contentClaims.d.ts +24 -180
  162. package/dist/types/deviceDirectory.d.ts +109 -1040
  163. package/dist/types/deviceSession.d.ts +36 -298
  164. package/dist/types/email/messages.d.ts +212 -1793
  165. package/dist/types/emailAgentContext.d.ts +10 -194
  166. package/dist/types/externalIdentity.d.ts +121 -615
  167. package/dist/types/federationInstanceFetch.d.ts +3 -32
  168. package/dist/types/identity.d.ts +15 -92
  169. package/dist/types/identityLink.d.ts +6 -84
  170. package/dist/types/identityProof.d.ts +5 -17
  171. package/dist/types/inboxPush.d.ts +1 -9
  172. package/dist/types/index.d.ts +5 -3
  173. package/dist/types/inference/accountBilling.d.ts +151 -488
  174. package/dist/types/inference/aliaModelRelease.d.ts +42 -439
  175. package/dist/types/inference/attribution.d.ts +75 -104
  176. package/dist/types/inference/catalogue.d.ts +417 -1599
  177. package/dist/types/inference/economics.d.ts +69 -276
  178. package/dist/types/inference/embeddings.d.ts +110 -406
  179. package/dist/types/inference/entitlement.d.ts +80 -335
  180. package/dist/types/inference/errors.d.ts +90 -102
  181. package/dist/types/inference/identifiers.d.ts +12 -4
  182. package/dist/types/inference/inbox.d.ts +105 -420
  183. package/dist/types/inference/modelDocumentation.d.ts +201 -1390
  184. package/dist/types/inference/money.d.ts +65 -32
  185. package/dist/types/inference/priceVersion.d.ts +53 -120
  186. package/dist/types/inference/providerConnection.d.ts +253 -710
  187. package/dist/types/inference/realtime.d.ts +954 -6825
  188. package/dist/types/inference/request.d.ts +300 -2572
  189. package/dist/types/inference/routingPolicy.d.ts +95 -503
  190. package/dist/types/inference/streamEvents.d.ts +253 -721
  191. package/dist/types/inference/usage.d.ts +317 -950
  192. package/dist/types/keyRecovery.d.ts +3 -51
  193. package/dist/types/keyRotation.d.ts +3 -38
  194. package/dist/types/linkedAccounts.d.ts +50 -236
  195. package/dist/types/moderationReputation.d.ts +81 -14
  196. package/dist/types/notifications.d.ts +19 -51
  197. package/dist/types/numberChecks.d.ts +9 -0
  198. package/dist/types/oauth.d.ts +101 -809
  199. package/dist/types/organizations.d.ts +268 -921
  200. package/dist/types/oxyRecordTypes.d.ts +11 -1
  201. package/dist/types/products/access.d.ts +125 -775
  202. package/dist/types/products/billing.d.ts +67 -503
  203. package/dist/types/products/checkout.d.ts +16 -69
  204. package/dist/types/products/plans.d.ts +33 -366
  205. package/dist/types/recommendations.d.ts +76 -389
  206. package/dist/types/reputation.d.ts +37 -5
  207. package/dist/types/safety.d.ts +408 -2048
  208. package/dist/types/serviceToken.d.ts +247 -7
  209. package/dist/types/sessionRevocation.d.ts +2 -17
  210. package/dist/types/sessionStatus.d.ts +27 -115
  211. package/dist/types/signIn.d.ts +53 -553
  212. package/dist/types/stickers.d.ts +67 -819
  213. package/dist/types/stringChecks.d.ts +16 -0
  214. package/dist/types/transparency.d.ts +14 -302
  215. package/dist/types/updates.d.ts +60 -316
  216. package/dist/types/userInvalidation.d.ts +4 -13
  217. package/dist/types/userResponse.d.ts +302 -2400
  218. package/dist/types/username.d.ts +3 -3
  219. package/package.json +2 -2
@@ -40,142 +40,81 @@ import { z } from 'zod';
40
40
  * balance goes negative on a long generation.
41
41
  */
42
42
  export declare const usageReservationRequestSchema: z.ZodObject<{
43
- /** See `version.ts`: exchanged between the edge and the ledger on its own. */
44
43
  schemaVersion: z.ZodLiteral<1>;
45
44
  idempotencyKey: z.ZodString;
46
45
  attribution: z.ZodObject<{
47
- principal: z.ZodObject<{
46
+ principal: z.ZodDiscriminatedUnion<[z.ZodObject<{
47
+ authority: z.ZodLiteral<"first_party">;
48
48
  billing: z.ZodObject<{
49
- accountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
50
- }, "strict", z.ZodTypeAny, {
51
- accountId: string & z.BRAND<"OxyAccountId">;
52
- }, {
53
- accountId: string;
49
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
50
+ }, z.core.$strict>;
51
+ applicationId: z.ZodString;
52
+ credentialId: z.ZodString;
53
+ environment: z.ZodEnum<{
54
+ development: "development";
55
+ staging: "staging";
56
+ production: "production";
54
57
  }>;
58
+ }, z.core.$strict>, z.ZodObject<{
59
+ authority: z.ZodOptional<z.ZodLiteral<"external">>;
60
+ inferenceScopes: z.ZodArray<z.ZodEnum<{
61
+ "inference:invoke": "inference:invoke";
62
+ "inference:models:read": "inference:models:read";
63
+ "inference:usage:read": "inference:usage:read";
64
+ "inference:routing:read": "inference:routing:read";
65
+ "inference:routing:write": "inference:routing:write";
66
+ "inference:providers:read": "inference:providers:read";
67
+ "inference:providers:write": "inference:providers:write";
68
+ }>>;
69
+ billing: z.ZodObject<{
70
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
71
+ }, z.core.$strict>;
55
72
  applicationId: z.ZodString;
56
73
  credentialId: z.ZodString;
57
- environment: z.ZodEnum<["development", "staging", "production"]>;
58
- inferenceScopes: z.ZodArray<z.ZodEnum<["inference:invoke", "inference:models:read", "inference:usage:read", "inference:routing:read", "inference:routing:write", "inference:providers:read", "inference:providers:write"]>, "many">;
59
- }, "strip", z.ZodTypeAny, {
60
- environment: "development" | "staging" | "production";
61
- applicationId: string;
62
- credentialId: string;
63
- billing: {
64
- accountId: string & z.BRAND<"OxyAccountId">;
65
- };
66
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
67
- }, {
68
- environment: "development" | "staging" | "production";
69
- applicationId: string;
70
- credentialId: string;
71
- billing: {
72
- accountId: string;
73
- };
74
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
75
- }>;
76
- userId: z.ZodOptional<z.ZodBranded<z.ZodString, "DelegatedUserId">>;
74
+ environment: z.ZodEnum<{
75
+ development: "development";
76
+ staging: "staging";
77
+ production: "production";
78
+ }>;
79
+ }, z.core.$strict>], "authority">;
80
+ userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
77
81
  requestId: z.ZodString;
78
82
  generationId: z.ZodOptional<z.ZodString>;
79
- }, "strip", z.ZodTypeAny, {
80
- requestId: string;
81
- principal: {
82
- environment: "development" | "staging" | "production";
83
- applicationId: string;
84
- credentialId: string;
85
- billing: {
86
- accountId: string & z.BRAND<"OxyAccountId">;
87
- };
88
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
89
- };
90
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
91
- generationId?: string | undefined;
92
- }, {
93
- requestId: string;
94
- principal: {
95
- environment: "development" | "staging" | "production";
96
- applicationId: string;
97
- credentialId: string;
98
- billing: {
99
- accountId: string;
100
- };
101
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
102
- };
103
- userId?: string | undefined;
104
- generationId?: string | undefined;
105
- }>;
106
- /** Units already determined by the request itself, e.g. input tokens. */
83
+ }, z.core.$strip>;
107
84
  knownUnits: z.ZodDefault<z.ZodArray<z.ZodObject<{
108
- unit: z.ZodEnum<["input_tokens", "cached_input_tokens", "output_tokens", "reasoning_tokens", "requests", "images", "audio_input_milliseconds", "audio_output_milliseconds", "video_milliseconds", "characters", "embeddings", "audio_input_tokens", "cached_audio_input_tokens", "audio_output_tokens", "session_milliseconds", "input_transcription_milliseconds"]>;
85
+ unit: z.ZodEnum<{
86
+ input_tokens: "input_tokens";
87
+ cached_input_tokens: "cached_input_tokens";
88
+ output_tokens: "output_tokens";
89
+ reasoning_tokens: "reasoning_tokens";
90
+ requests: "requests";
91
+ images: "images";
92
+ audio_input_milliseconds: "audio_input_milliseconds";
93
+ audio_output_milliseconds: "audio_output_milliseconds";
94
+ video_milliseconds: "video_milliseconds";
95
+ characters: "characters";
96
+ embeddings: "embeddings";
97
+ audio_input_tokens: "audio_input_tokens";
98
+ cached_audio_input_tokens: "cached_audio_input_tokens";
99
+ audio_output_tokens: "audio_output_tokens";
100
+ session_milliseconds: "session_milliseconds";
101
+ input_transcription_milliseconds: "input_transcription_milliseconds";
102
+ }>;
109
103
  quantity: z.ZodNumber;
110
- }, "strict", z.ZodTypeAny, {
111
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
112
- quantity: number;
113
- }, {
114
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
115
- quantity: number;
116
- }>, "many">>;
117
- /** The ceiling on generated output, when the request set one. */
104
+ }, z.core.$strict>>>;
118
105
  maxOutputTokens: z.ZodOptional<z.ZodNumber>;
119
- /** The price version of the most expensive route the policy permits. */
120
106
  ceilingPriceVersionId: z.ZodString;
121
- maxAmount: z.ZodBranded<z.ZodString, "ExactDecimal">;
107
+ maxAmount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
122
108
  currency: z.ZodString;
123
109
  expiresInSeconds: z.ZodNumber;
124
- }, "strip", z.ZodTypeAny, {
125
- schemaVersion: 1;
126
- currency: string;
127
- attribution: {
128
- requestId: string;
129
- principal: {
130
- environment: "development" | "staging" | "production";
131
- applicationId: string;
132
- credentialId: string;
133
- billing: {
134
- accountId: string & z.BRAND<"OxyAccountId">;
135
- };
136
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
137
- };
138
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
139
- generationId?: string | undefined;
140
- };
141
- idempotencyKey: string;
142
- knownUnits: {
143
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
144
- quantity: number;
145
- }[];
146
- ceilingPriceVersionId: string;
147
- maxAmount: string & z.BRAND<"ExactDecimal">;
148
- expiresInSeconds: number;
149
- maxOutputTokens?: number | undefined;
150
- }, {
151
- schemaVersion: 1;
152
- currency: string;
153
- attribution: {
154
- requestId: string;
155
- principal: {
156
- environment: "development" | "staging" | "production";
157
- applicationId: string;
158
- credentialId: string;
159
- billing: {
160
- accountId: string;
161
- };
162
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
163
- };
164
- userId?: string | undefined;
165
- generationId?: string | undefined;
166
- };
167
- idempotencyKey: string;
168
- ceilingPriceVersionId: string;
169
- maxAmount: string;
170
- expiresInSeconds: number;
171
- maxOutputTokens?: number | undefined;
172
- knownUnits?: {
173
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
174
- quantity: number;
175
- }[] | undefined;
176
- }>;
110
+ }, z.core.$strip>;
177
111
  /** Lifecycle of a hold. Terminal states are `settled`, `released`, `expired`. */
178
- export declare const usageReservationStatusSchema: z.ZodEnum<["held", "settled", "released", "expired"]>;
112
+ export declare const usageReservationStatusSchema: z.ZodEnum<{
113
+ expired: "expired";
114
+ held: "held";
115
+ settled: "settled";
116
+ released: "released";
117
+ }>;
179
118
  /**
180
119
  * A hold placed against an account's balance.
181
120
  *
@@ -183,182 +122,69 @@ export declare const usageReservationStatusSchema: z.ZodEnum<["held", "settled",
183
122
  * reservation is not money spent, and presenting the two as one number makes a
184
123
  * balance appear to drop and then recover for every request.
185
124
  */
186
- export declare const usageReservationSchema: z.ZodEffects<z.ZodObject<{
187
- /** See `version.ts`: read back by the edge and the Console on its own. */
125
+ export declare const usageReservationSchema: z.ZodObject<{
188
126
  schemaVersion: z.ZodLiteral<1>;
189
127
  reservationId: z.ZodString;
190
128
  idempotencyKey: z.ZodString;
191
129
  attribution: z.ZodObject<{
192
- principal: z.ZodObject<{
130
+ principal: z.ZodDiscriminatedUnion<[z.ZodObject<{
131
+ authority: z.ZodLiteral<"first_party">;
193
132
  billing: z.ZodObject<{
194
- accountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
195
- }, "strict", z.ZodTypeAny, {
196
- accountId: string & z.BRAND<"OxyAccountId">;
197
- }, {
198
- accountId: string;
133
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
134
+ }, z.core.$strict>;
135
+ applicationId: z.ZodString;
136
+ credentialId: z.ZodString;
137
+ environment: z.ZodEnum<{
138
+ development: "development";
139
+ staging: "staging";
140
+ production: "production";
199
141
  }>;
142
+ }, z.core.$strict>, z.ZodObject<{
143
+ authority: z.ZodOptional<z.ZodLiteral<"external">>;
144
+ inferenceScopes: z.ZodArray<z.ZodEnum<{
145
+ "inference:invoke": "inference:invoke";
146
+ "inference:models:read": "inference:models:read";
147
+ "inference:usage:read": "inference:usage:read";
148
+ "inference:routing:read": "inference:routing:read";
149
+ "inference:routing:write": "inference:routing:write";
150
+ "inference:providers:read": "inference:providers:read";
151
+ "inference:providers:write": "inference:providers:write";
152
+ }>>;
153
+ billing: z.ZodObject<{
154
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
155
+ }, z.core.$strict>;
200
156
  applicationId: z.ZodString;
201
157
  credentialId: z.ZodString;
202
- environment: z.ZodEnum<["development", "staging", "production"]>;
203
- inferenceScopes: z.ZodArray<z.ZodEnum<["inference:invoke", "inference:models:read", "inference:usage:read", "inference:routing:read", "inference:routing:write", "inference:providers:read", "inference:providers:write"]>, "many">;
204
- }, "strip", z.ZodTypeAny, {
205
- environment: "development" | "staging" | "production";
206
- applicationId: string;
207
- credentialId: string;
208
- billing: {
209
- accountId: string & z.BRAND<"OxyAccountId">;
210
- };
211
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
212
- }, {
213
- environment: "development" | "staging" | "production";
214
- applicationId: string;
215
- credentialId: string;
216
- billing: {
217
- accountId: string;
218
- };
219
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
220
- }>;
221
- userId: z.ZodOptional<z.ZodBranded<z.ZodString, "DelegatedUserId">>;
158
+ environment: z.ZodEnum<{
159
+ development: "development";
160
+ staging: "staging";
161
+ production: "production";
162
+ }>;
163
+ }, z.core.$strict>], "authority">;
164
+ userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
222
165
  requestId: z.ZodString;
223
166
  generationId: z.ZodOptional<z.ZodString>;
224
- }, "strip", z.ZodTypeAny, {
225
- requestId: string;
226
- principal: {
227
- environment: "development" | "staging" | "production";
228
- applicationId: string;
229
- credentialId: string;
230
- billing: {
231
- accountId: string & z.BRAND<"OxyAccountId">;
232
- };
233
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
234
- };
235
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
236
- generationId?: string | undefined;
237
- }, {
238
- requestId: string;
239
- principal: {
240
- environment: "development" | "staging" | "production";
241
- applicationId: string;
242
- credentialId: string;
243
- billing: {
244
- accountId: string;
245
- };
246
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
247
- };
248
- userId?: string | undefined;
249
- generationId?: string | undefined;
167
+ }, z.core.$strip>;
168
+ status: z.ZodEnum<{
169
+ expired: "expired";
170
+ held: "held";
171
+ settled: "settled";
172
+ released: "released";
250
173
  }>;
251
- status: z.ZodEnum<["held", "settled", "released", "expired"]>;
252
- reservedAmount: z.ZodBranded<z.ZodString, "ExactDecimal">;
174
+ reservedAmount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
253
175
  currency: z.ZodString;
254
176
  ceilingPriceVersionId: z.ZodString;
255
177
  createdAt: z.ZodString;
256
178
  expiresAt: z.ZodString;
257
- /** The receipt that consumed this hold. Present exactly when `settled`. */
258
179
  settledReceiptId: z.ZodOptional<z.ZodString>;
259
- }, "strip", z.ZodTypeAny, {
260
- status: "expired" | "held" | "settled" | "released";
261
- createdAt: string;
262
- expiresAt: string;
263
- schemaVersion: 1;
264
- currency: string;
265
- reservationId: string;
266
- reservedAmount: string & z.BRAND<"ExactDecimal">;
267
- attribution: {
268
- requestId: string;
269
- principal: {
270
- environment: "development" | "staging" | "production";
271
- applicationId: string;
272
- credentialId: string;
273
- billing: {
274
- accountId: string & z.BRAND<"OxyAccountId">;
275
- };
276
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
277
- };
278
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
279
- generationId?: string | undefined;
280
- };
281
- idempotencyKey: string;
282
- ceilingPriceVersionId: string;
283
- settledReceiptId?: string | undefined;
284
- }, {
285
- status: "expired" | "held" | "settled" | "released";
286
- createdAt: string;
287
- expiresAt: string;
288
- schemaVersion: 1;
289
- currency: string;
290
- reservationId: string;
291
- reservedAmount: string;
292
- attribution: {
293
- requestId: string;
294
- principal: {
295
- environment: "development" | "staging" | "production";
296
- applicationId: string;
297
- credentialId: string;
298
- billing: {
299
- accountId: string;
300
- };
301
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
302
- };
303
- userId?: string | undefined;
304
- generationId?: string | undefined;
305
- };
306
- idempotencyKey: string;
307
- ceilingPriceVersionId: string;
308
- settledReceiptId?: string | undefined;
309
- }>, {
310
- status: "expired" | "held" | "settled" | "released";
311
- createdAt: string;
312
- expiresAt: string;
313
- schemaVersion: 1;
314
- currency: string;
315
- reservationId: string;
316
- reservedAmount: string & z.BRAND<"ExactDecimal">;
317
- attribution: {
318
- requestId: string;
319
- principal: {
320
- environment: "development" | "staging" | "production";
321
- applicationId: string;
322
- credentialId: string;
323
- billing: {
324
- accountId: string & z.BRAND<"OxyAccountId">;
325
- };
326
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
327
- };
328
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
329
- generationId?: string | undefined;
330
- };
331
- idempotencyKey: string;
332
- ceilingPriceVersionId: string;
333
- settledReceiptId?: string | undefined;
334
- }, {
335
- status: "expired" | "held" | "settled" | "released";
336
- createdAt: string;
337
- expiresAt: string;
338
- schemaVersion: 1;
339
- currency: string;
340
- reservationId: string;
341
- reservedAmount: string;
342
- attribution: {
343
- requestId: string;
344
- principal: {
345
- environment: "development" | "staging" | "production";
346
- applicationId: string;
347
- credentialId: string;
348
- billing: {
349
- accountId: string;
350
- };
351
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
352
- };
353
- userId?: string | undefined;
354
- generationId?: string | undefined;
355
- };
356
- idempotencyKey: string;
357
- ceilingPriceVersionId: string;
358
- settledReceiptId?: string | undefined;
359
- }>;
180
+ }, z.core.$strip>;
360
181
  /** How a request ended, from the data plane's point of view. */
361
- export declare const inferenceRequestOutcomeSchema: z.ZodEnum<["completed", "partial", "cancelled", "failed"]>;
182
+ export declare const inferenceRequestOutcomeSchema: z.ZodEnum<{
183
+ failed: "failed";
184
+ completed: "completed";
185
+ cancelled: "cancelled";
186
+ partial: "partial";
187
+ }>;
362
188
  /**
363
189
  * The data plane's technical account of one request, and the ONLY shape a
364
190
  * settlement is written from.
@@ -401,229 +227,94 @@ export declare const inferenceRequestOutcomeSchema: z.ZodEnum<["completed", "par
401
227
  * reports, and a refused report is a request that ran, cost money upstream and
402
228
  * can never be settled or refunded.
403
229
  */
404
- export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
405
- /** See `version.ts`: emitted by the data plane as a whole message. */
230
+ export declare const normalizedUsageReportSchema: z.ZodObject<{
406
231
  schemaVersion: z.ZodLiteral<2>;
407
232
  requestId: z.ZodString;
408
233
  generationId: z.ZodOptional<z.ZodString>;
409
234
  attribution: z.ZodObject<{
410
- principal: z.ZodObject<{
235
+ principal: z.ZodDiscriminatedUnion<[z.ZodObject<{
236
+ authority: z.ZodLiteral<"first_party">;
411
237
  billing: z.ZodObject<{
412
- accountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
413
- }, "strict", z.ZodTypeAny, {
414
- accountId: string & z.BRAND<"OxyAccountId">;
415
- }, {
416
- accountId: string;
238
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
239
+ }, z.core.$strict>;
240
+ applicationId: z.ZodString;
241
+ credentialId: z.ZodString;
242
+ environment: z.ZodEnum<{
243
+ development: "development";
244
+ staging: "staging";
245
+ production: "production";
417
246
  }>;
247
+ }, z.core.$strict>, z.ZodObject<{
248
+ authority: z.ZodOptional<z.ZodLiteral<"external">>;
249
+ inferenceScopes: z.ZodArray<z.ZodEnum<{
250
+ "inference:invoke": "inference:invoke";
251
+ "inference:models:read": "inference:models:read";
252
+ "inference:usage:read": "inference:usage:read";
253
+ "inference:routing:read": "inference:routing:read";
254
+ "inference:routing:write": "inference:routing:write";
255
+ "inference:providers:read": "inference:providers:read";
256
+ "inference:providers:write": "inference:providers:write";
257
+ }>>;
258
+ billing: z.ZodObject<{
259
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
260
+ }, z.core.$strict>;
418
261
  applicationId: z.ZodString;
419
262
  credentialId: z.ZodString;
420
- environment: z.ZodEnum<["development", "staging", "production"]>;
421
- inferenceScopes: z.ZodArray<z.ZodEnum<["inference:invoke", "inference:models:read", "inference:usage:read", "inference:routing:read", "inference:routing:write", "inference:providers:read", "inference:providers:write"]>, "many">;
422
- }, "strip", z.ZodTypeAny, {
423
- environment: "development" | "staging" | "production";
424
- applicationId: string;
425
- credentialId: string;
426
- billing: {
427
- accountId: string & z.BRAND<"OxyAccountId">;
428
- };
429
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
430
- }, {
431
- environment: "development" | "staging" | "production";
432
- applicationId: string;
433
- credentialId: string;
434
- billing: {
435
- accountId: string;
436
- };
437
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
438
- }>;
439
- userId: z.ZodOptional<z.ZodBranded<z.ZodString, "DelegatedUserId">>;
263
+ environment: z.ZodEnum<{
264
+ development: "development";
265
+ staging: "staging";
266
+ production: "production";
267
+ }>;
268
+ }, z.core.$strict>], "authority">;
269
+ userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
440
270
  requestId: z.ZodString;
441
271
  generationId: z.ZodOptional<z.ZodString>;
442
- }, "strip", z.ZodTypeAny, {
443
- requestId: string;
444
- principal: {
445
- environment: "development" | "staging" | "production";
446
- applicationId: string;
447
- credentialId: string;
448
- billing: {
449
- accountId: string & z.BRAND<"OxyAccountId">;
450
- };
451
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
452
- };
453
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
454
- generationId?: string | undefined;
455
- }, {
456
- requestId: string;
457
- principal: {
458
- environment: "development" | "staging" | "production";
459
- applicationId: string;
460
- credentialId: string;
461
- billing: {
462
- accountId: string;
463
- };
464
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
465
- };
466
- userId?: string | undefined;
467
- generationId?: string | undefined;
272
+ }, z.core.$strip>;
273
+ outcome: z.ZodEnum<{
274
+ failed: "failed";
275
+ completed: "completed";
276
+ cancelled: "cancelled";
277
+ partial: "partial";
468
278
  }>;
469
- outcome: z.ZodEnum<["completed", "partial", "cancelled", "failed"]>;
470
279
  units: z.ZodArray<z.ZodObject<{
471
- unit: z.ZodEnum<["input_tokens", "cached_input_tokens", "output_tokens", "reasoning_tokens", "requests", "images", "audio_input_milliseconds", "audio_output_milliseconds", "video_milliseconds", "characters", "embeddings", "audio_input_tokens", "cached_audio_input_tokens", "audio_output_tokens", "session_milliseconds", "input_transcription_milliseconds"]>;
280
+ unit: z.ZodEnum<{
281
+ input_tokens: "input_tokens";
282
+ cached_input_tokens: "cached_input_tokens";
283
+ output_tokens: "output_tokens";
284
+ reasoning_tokens: "reasoning_tokens";
285
+ requests: "requests";
286
+ images: "images";
287
+ audio_input_milliseconds: "audio_input_milliseconds";
288
+ audio_output_milliseconds: "audio_output_milliseconds";
289
+ video_milliseconds: "video_milliseconds";
290
+ characters: "characters";
291
+ embeddings: "embeddings";
292
+ audio_input_tokens: "audio_input_tokens";
293
+ cached_audio_input_tokens: "cached_audio_input_tokens";
294
+ audio_output_tokens: "audio_output_tokens";
295
+ session_milliseconds: "session_milliseconds";
296
+ input_transcription_milliseconds: "input_transcription_milliseconds";
297
+ }>;
472
298
  quantity: z.ZodNumber;
473
- }, "strict", z.ZodTypeAny, {
474
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
475
- quantity: number;
476
- }, {
477
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
478
- quantity: number;
479
- }>, "many">;
480
- usageSource: z.ZodEnum<["provider_reported", "oxy_measured", "estimated"]>;
299
+ }, z.core.$strict>>;
300
+ usageSource: z.ZodEnum<{
301
+ provider_reported: "provider_reported";
302
+ oxy_measured: "oxy_measured";
303
+ estimated: "estimated";
304
+ }>;
481
305
  resolvedModelReference: z.ZodString;
482
306
  servingProvider: z.ZodString;
483
- /** Exact Kaana deployment that attempted the request; never inferred from names. */
484
307
  deploymentId: z.ZodString;
485
- /** How many allowed route switches occurred while serving this request. */
486
308
  routeSwitches: z.ZodNumber;
487
- /**
488
- * The funding tier of the platform key that served the final attempt, as
489
- * the data plane states it (ADR 0038). Absent when the key's economics
490
- * were never stated, when a customer credential served, or when nothing
491
- * was served. Oxy reads it to account for what the request cost the
492
- * platform; it is never a key identity and never reaches a customer.
493
- */
494
- fundingTier: z.ZodOptional<z.ZodEnum<["free", "credit", "paid"]>>;
309
+ fundingTier: z.ZodOptional<z.ZodEnum<{
310
+ free: "free";
311
+ credit: "credit";
312
+ paid: "paid";
313
+ }>>;
495
314
  startedAt: z.ZodString;
496
315
  completedAt: z.ZodString;
497
316
  timeToFirstTokenMs: z.ZodOptional<z.ZodNumber>;
498
- }, "strip", z.ZodTypeAny, {
499
- schemaVersion: 2;
500
- requestId: string;
501
- outcome: "failed" | "completed" | "cancelled" | "partial";
502
- resolvedModelReference: string;
503
- servingProvider: string;
504
- attribution: {
505
- requestId: string;
506
- principal: {
507
- environment: "development" | "staging" | "production";
508
- applicationId: string;
509
- credentialId: string;
510
- billing: {
511
- accountId: string & z.BRAND<"OxyAccountId">;
512
- };
513
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
514
- };
515
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
516
- generationId?: string | undefined;
517
- };
518
- deploymentId: string;
519
- completedAt: string;
520
- startedAt: string;
521
- units: {
522
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
523
- quantity: number;
524
- }[];
525
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
526
- routeSwitches: number;
527
- generationId?: string | undefined;
528
- fundingTier?: "free" | "credit" | "paid" | undefined;
529
- timeToFirstTokenMs?: number | undefined;
530
- }, {
531
- schemaVersion: 2;
532
- requestId: string;
533
- outcome: "failed" | "completed" | "cancelled" | "partial";
534
- resolvedModelReference: string;
535
- servingProvider: string;
536
- attribution: {
537
- requestId: string;
538
- principal: {
539
- environment: "development" | "staging" | "production";
540
- applicationId: string;
541
- credentialId: string;
542
- billing: {
543
- accountId: string;
544
- };
545
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
546
- };
547
- userId?: string | undefined;
548
- generationId?: string | undefined;
549
- };
550
- deploymentId: string;
551
- completedAt: string;
552
- startedAt: string;
553
- units: {
554
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
555
- quantity: number;
556
- }[];
557
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
558
- routeSwitches: number;
559
- generationId?: string | undefined;
560
- fundingTier?: "free" | "credit" | "paid" | undefined;
561
- timeToFirstTokenMs?: number | undefined;
562
- }>, {
563
- schemaVersion: 2;
564
- requestId: string;
565
- outcome: "failed" | "completed" | "cancelled" | "partial";
566
- resolvedModelReference: string;
567
- servingProvider: string;
568
- attribution: {
569
- requestId: string;
570
- principal: {
571
- environment: "development" | "staging" | "production";
572
- applicationId: string;
573
- credentialId: string;
574
- billing: {
575
- accountId: string & z.BRAND<"OxyAccountId">;
576
- };
577
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
578
- };
579
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
580
- generationId?: string | undefined;
581
- };
582
- deploymentId: string;
583
- completedAt: string;
584
- startedAt: string;
585
- units: {
586
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
587
- quantity: number;
588
- }[];
589
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
590
- routeSwitches: number;
591
- generationId?: string | undefined;
592
- fundingTier?: "free" | "credit" | "paid" | undefined;
593
- timeToFirstTokenMs?: number | undefined;
594
- }, {
595
- schemaVersion: 2;
596
- requestId: string;
597
- outcome: "failed" | "completed" | "cancelled" | "partial";
598
- resolvedModelReference: string;
599
- servingProvider: string;
600
- attribution: {
601
- requestId: string;
602
- principal: {
603
- environment: "development" | "staging" | "production";
604
- applicationId: string;
605
- credentialId: string;
606
- billing: {
607
- accountId: string;
608
- };
609
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
610
- };
611
- userId?: string | undefined;
612
- generationId?: string | undefined;
613
- };
614
- deploymentId: string;
615
- completedAt: string;
616
- startedAt: string;
617
- units: {
618
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
619
- quantity: number;
620
- }[];
621
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
622
- routeSwitches: number;
623
- generationId?: string | undefined;
624
- fundingTier?: "free" | "credit" | "paid" | undefined;
625
- timeToFirstTokenMs?: number | undefined;
626
- }>;
317
+ }, z.core.$strip>;
627
318
  /**
628
319
  * The immutable record of what a request was actually charged.
629
320
  *
@@ -636,294 +327,116 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
636
327
  * rather than the cost of the tokens. Without the flag, the two look identical
637
328
  * and a BYOK customer appears to have been charged twice for one request.
638
329
  */
639
- export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
640
- /** See `version.ts`: returned to customers by `GET /v1/generations/:id`. */
330
+ export declare const usageReceiptSchema: z.ZodObject<{
641
331
  schemaVersion: z.ZodLiteral<1>;
642
332
  receiptId: z.ZodString;
643
- /** The hold this settled against. Absent for a charge with no reservation. */
644
333
  reservationId: z.ZodOptional<z.ZodString>;
645
334
  idempotencyKey: z.ZodString;
646
335
  attribution: z.ZodObject<{
647
- principal: z.ZodObject<{
336
+ principal: z.ZodDiscriminatedUnion<[z.ZodObject<{
337
+ authority: z.ZodLiteral<"first_party">;
648
338
  billing: z.ZodObject<{
649
- accountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
650
- }, "strict", z.ZodTypeAny, {
651
- accountId: string & z.BRAND<"OxyAccountId">;
652
- }, {
653
- accountId: string;
339
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
340
+ }, z.core.$strict>;
341
+ applicationId: z.ZodString;
342
+ credentialId: z.ZodString;
343
+ environment: z.ZodEnum<{
344
+ development: "development";
345
+ staging: "staging";
346
+ production: "production";
654
347
  }>;
348
+ }, z.core.$strict>, z.ZodObject<{
349
+ authority: z.ZodOptional<z.ZodLiteral<"external">>;
350
+ inferenceScopes: z.ZodArray<z.ZodEnum<{
351
+ "inference:invoke": "inference:invoke";
352
+ "inference:models:read": "inference:models:read";
353
+ "inference:usage:read": "inference:usage:read";
354
+ "inference:routing:read": "inference:routing:read";
355
+ "inference:routing:write": "inference:routing:write";
356
+ "inference:providers:read": "inference:providers:read";
357
+ "inference:providers:write": "inference:providers:write";
358
+ }>>;
359
+ billing: z.ZodObject<{
360
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
361
+ }, z.core.$strict>;
655
362
  applicationId: z.ZodString;
656
363
  credentialId: z.ZodString;
657
- environment: z.ZodEnum<["development", "staging", "production"]>;
658
- inferenceScopes: z.ZodArray<z.ZodEnum<["inference:invoke", "inference:models:read", "inference:usage:read", "inference:routing:read", "inference:routing:write", "inference:providers:read", "inference:providers:write"]>, "many">;
659
- }, "strip", z.ZodTypeAny, {
660
- environment: "development" | "staging" | "production";
661
- applicationId: string;
662
- credentialId: string;
663
- billing: {
664
- accountId: string & z.BRAND<"OxyAccountId">;
665
- };
666
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
667
- }, {
668
- environment: "development" | "staging" | "production";
669
- applicationId: string;
670
- credentialId: string;
671
- billing: {
672
- accountId: string;
673
- };
674
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
675
- }>;
676
- userId: z.ZodOptional<z.ZodBranded<z.ZodString, "DelegatedUserId">>;
364
+ environment: z.ZodEnum<{
365
+ development: "development";
366
+ staging: "staging";
367
+ production: "production";
368
+ }>;
369
+ }, z.core.$strict>], "authority">;
370
+ userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
677
371
  requestId: z.ZodString;
678
372
  generationId: z.ZodOptional<z.ZodString>;
679
- }, "strip", z.ZodTypeAny, {
680
- requestId: string;
681
- principal: {
682
- environment: "development" | "staging" | "production";
683
- applicationId: string;
684
- credentialId: string;
685
- billing: {
686
- accountId: string & z.BRAND<"OxyAccountId">;
687
- };
688
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
689
- };
690
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
691
- generationId?: string | undefined;
692
- }, {
693
- requestId: string;
694
- principal: {
695
- environment: "development" | "staging" | "production";
696
- applicationId: string;
697
- credentialId: string;
698
- billing: {
699
- accountId: string;
700
- };
701
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
702
- };
703
- userId?: string | undefined;
704
- generationId?: string | undefined;
373
+ }, z.core.$strip>;
374
+ outcome: z.ZodEnum<{
375
+ failed: "failed";
376
+ completed: "completed";
377
+ cancelled: "cancelled";
378
+ partial: "partial";
705
379
  }>;
706
- outcome: z.ZodEnum<["completed", "partial", "cancelled", "failed"]>;
707
380
  units: z.ZodArray<z.ZodObject<{
708
- unit: z.ZodEnum<["input_tokens", "cached_input_tokens", "output_tokens", "reasoning_tokens", "requests", "images", "audio_input_milliseconds", "audio_output_milliseconds", "video_milliseconds", "characters", "embeddings", "audio_input_tokens", "cached_audio_input_tokens", "audio_output_tokens", "session_milliseconds", "input_transcription_milliseconds"]>;
381
+ unit: z.ZodEnum<{
382
+ input_tokens: "input_tokens";
383
+ cached_input_tokens: "cached_input_tokens";
384
+ output_tokens: "output_tokens";
385
+ reasoning_tokens: "reasoning_tokens";
386
+ requests: "requests";
387
+ images: "images";
388
+ audio_input_milliseconds: "audio_input_milliseconds";
389
+ audio_output_milliseconds: "audio_output_milliseconds";
390
+ video_milliseconds: "video_milliseconds";
391
+ characters: "characters";
392
+ embeddings: "embeddings";
393
+ audio_input_tokens: "audio_input_tokens";
394
+ cached_audio_input_tokens: "cached_audio_input_tokens";
395
+ audio_output_tokens: "audio_output_tokens";
396
+ session_milliseconds: "session_milliseconds";
397
+ input_transcription_milliseconds: "input_transcription_milliseconds";
398
+ }>;
709
399
  quantity: z.ZodNumber;
710
- }, "strict", z.ZodTypeAny, {
711
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
712
- quantity: number;
713
- }, {
714
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
715
- quantity: number;
716
- }>, "many">;
717
- usageSource: z.ZodEnum<["provider_reported", "oxy_measured", "estimated"]>;
400
+ }, z.core.$strict>>;
401
+ usageSource: z.ZodEnum<{
402
+ provider_reported: "provider_reported";
403
+ oxy_measured: "oxy_measured";
404
+ estimated: "estimated";
405
+ }>;
718
406
  priceSnapshot: z.ZodObject<{
719
407
  priceVersionId: z.ZodString;
720
408
  currency: z.ZodString;
721
409
  unitPrices: z.ZodArray<z.ZodObject<{
722
- unit: z.ZodEnum<["input_tokens", "cached_input_tokens", "output_tokens", "reasoning_tokens", "requests", "images", "audio_input_milliseconds", "audio_output_milliseconds", "video_milliseconds", "characters", "embeddings", "audio_input_tokens", "cached_audio_input_tokens", "audio_output_tokens", "session_milliseconds", "input_transcription_milliseconds"]>;
723
- amount: z.ZodBranded<z.ZodString, "ExactDecimal">;
410
+ unit: z.ZodEnum<{
411
+ input_tokens: "input_tokens";
412
+ cached_input_tokens: "cached_input_tokens";
413
+ output_tokens: "output_tokens";
414
+ reasoning_tokens: "reasoning_tokens";
415
+ requests: "requests";
416
+ images: "images";
417
+ audio_input_milliseconds: "audio_input_milliseconds";
418
+ audio_output_milliseconds: "audio_output_milliseconds";
419
+ video_milliseconds: "video_milliseconds";
420
+ characters: "characters";
421
+ embeddings: "embeddings";
422
+ audio_input_tokens: "audio_input_tokens";
423
+ cached_audio_input_tokens: "cached_audio_input_tokens";
424
+ audio_output_tokens: "audio_output_tokens";
425
+ session_milliseconds: "session_milliseconds";
426
+ input_transcription_milliseconds: "input_transcription_milliseconds";
427
+ }>;
428
+ amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
724
429
  per: z.ZodNumber;
725
430
  currency: z.ZodString;
726
- }, "strict", z.ZodTypeAny, {
727
- currency: string;
728
- amount: string & z.BRAND<"ExactDecimal">;
729
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
730
- per: number;
731
- }, {
732
- currency: string;
733
- amount: string;
734
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
735
- per: number;
736
- }>, "many">;
737
- }, "strict", z.ZodTypeAny, {
738
- currency: string;
739
- priceVersionId: string;
740
- unitPrices: {
741
- currency: string;
742
- amount: string & z.BRAND<"ExactDecimal">;
743
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
744
- per: number;
745
- }[];
746
- }, {
747
- currency: string;
748
- priceVersionId: string;
749
- unitPrices: {
750
- currency: string;
751
- amount: string;
752
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
753
- per: number;
754
- }[];
755
- }>;
756
- billedAmount: z.ZodBranded<z.ZodString, "ExactDecimal">;
431
+ }, z.core.$strict>>;
432
+ }, z.core.$strict>;
433
+ billedAmount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
757
434
  currency: z.ZodString;
758
435
  platformFeeOnly: z.ZodBoolean;
759
436
  resolvedModelReference: z.ZodString;
760
437
  servingProvider: z.ZodString;
761
438
  settledAt: z.ZodString;
762
- }, "strip", z.ZodTypeAny, {
763
- schemaVersion: 1;
764
- receiptId: string;
765
- settledAt: string;
766
- billedAmount: string & z.BRAND<"ExactDecimal">;
767
- currency: string;
768
- outcome: "failed" | "completed" | "cancelled" | "partial";
769
- resolvedModelReference: string;
770
- servingProvider: string;
771
- platformFeeOnly: boolean;
772
- attribution: {
773
- requestId: string;
774
- principal: {
775
- environment: "development" | "staging" | "production";
776
- applicationId: string;
777
- credentialId: string;
778
- billing: {
779
- accountId: string & z.BRAND<"OxyAccountId">;
780
- };
781
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
782
- };
783
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
784
- generationId?: string | undefined;
785
- };
786
- idempotencyKey: string;
787
- units: {
788
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
789
- quantity: number;
790
- }[];
791
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
792
- priceSnapshot: {
793
- currency: string;
794
- priceVersionId: string;
795
- unitPrices: {
796
- currency: string;
797
- amount: string & z.BRAND<"ExactDecimal">;
798
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
799
- per: number;
800
- }[];
801
- };
802
- reservationId?: string | undefined;
803
- }, {
804
- schemaVersion: 1;
805
- receiptId: string;
806
- settledAt: string;
807
- billedAmount: string;
808
- currency: string;
809
- outcome: "failed" | "completed" | "cancelled" | "partial";
810
- resolvedModelReference: string;
811
- servingProvider: string;
812
- platformFeeOnly: boolean;
813
- attribution: {
814
- requestId: string;
815
- principal: {
816
- environment: "development" | "staging" | "production";
817
- applicationId: string;
818
- credentialId: string;
819
- billing: {
820
- accountId: string;
821
- };
822
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
823
- };
824
- userId?: string | undefined;
825
- generationId?: string | undefined;
826
- };
827
- idempotencyKey: string;
828
- units: {
829
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
830
- quantity: number;
831
- }[];
832
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
833
- priceSnapshot: {
834
- currency: string;
835
- priceVersionId: string;
836
- unitPrices: {
837
- currency: string;
838
- amount: string;
839
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
840
- per: number;
841
- }[];
842
- };
843
- reservationId?: string | undefined;
844
- }>, {
845
- schemaVersion: 1;
846
- receiptId: string;
847
- settledAt: string;
848
- billedAmount: string & z.BRAND<"ExactDecimal">;
849
- currency: string;
850
- outcome: "failed" | "completed" | "cancelled" | "partial";
851
- resolvedModelReference: string;
852
- servingProvider: string;
853
- platformFeeOnly: boolean;
854
- attribution: {
855
- requestId: string;
856
- principal: {
857
- environment: "development" | "staging" | "production";
858
- applicationId: string;
859
- credentialId: string;
860
- billing: {
861
- accountId: string & z.BRAND<"OxyAccountId">;
862
- };
863
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
864
- };
865
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
866
- generationId?: string | undefined;
867
- };
868
- idempotencyKey: string;
869
- units: {
870
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
871
- quantity: number;
872
- }[];
873
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
874
- priceSnapshot: {
875
- currency: string;
876
- priceVersionId: string;
877
- unitPrices: {
878
- currency: string;
879
- amount: string & z.BRAND<"ExactDecimal">;
880
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
881
- per: number;
882
- }[];
883
- };
884
- reservationId?: string | undefined;
885
- }, {
886
- schemaVersion: 1;
887
- receiptId: string;
888
- settledAt: string;
889
- billedAmount: string;
890
- currency: string;
891
- outcome: "failed" | "completed" | "cancelled" | "partial";
892
- resolvedModelReference: string;
893
- servingProvider: string;
894
- platformFeeOnly: boolean;
895
- attribution: {
896
- requestId: string;
897
- principal: {
898
- environment: "development" | "staging" | "production";
899
- applicationId: string;
900
- credentialId: string;
901
- billing: {
902
- accountId: string;
903
- };
904
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
905
- };
906
- userId?: string | undefined;
907
- generationId?: string | undefined;
908
- };
909
- idempotencyKey: string;
910
- units: {
911
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
912
- quantity: number;
913
- }[];
914
- usageSource: "provider_reported" | "oxy_measured" | "estimated";
915
- priceSnapshot: {
916
- currency: string;
917
- priceVersionId: string;
918
- unitPrices: {
919
- currency: string;
920
- amount: string;
921
- unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings" | "audio_input_tokens" | "cached_audio_input_tokens" | "audio_output_tokens" | "session_milliseconds" | "input_transcription_milliseconds";
922
- per: number;
923
- }[];
924
- };
925
- reservationId?: string | undefined;
926
- }>;
439
+ }, z.core.$strip>;
927
440
  /**
928
441
  * What a reversal acts on: an unused hold, or a settled charge.
929
442
  *
@@ -931,27 +444,23 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
931
444
  * already booked" can never be confused for one another — they hit different
932
445
  * ledger accounts and only the second one is visible on an invoice.
933
446
  */
934
- export declare const usageRefundSubjectSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
447
+ export declare const usageRefundSubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
935
448
  kind: z.ZodLiteral<"reservation">;
936
449
  reservationId: z.ZodString;
937
- }, "strict", z.ZodTypeAny, {
938
- kind: "reservation";
939
- reservationId: string;
940
- }, {
941
- kind: "reservation";
942
- reservationId: string;
943
- }>, z.ZodObject<{
450
+ }, z.core.$strict>, z.ZodObject<{
944
451
  kind: z.ZodLiteral<"receipt">;
945
452
  receiptId: z.ZodString;
946
- }, "strict", z.ZodTypeAny, {
947
- kind: "receipt";
948
- receiptId: string;
949
- }, {
950
- kind: "receipt";
951
- receiptId: string;
952
- }>]>;
453
+ }, z.core.$strict>], "kind">;
953
454
  /** Why money was given back or a hold was released. */
954
- export declare const usageRefundReasonSchema: z.ZodEnum<["unused_reservation", "client_cancelled", "upstream_failure", "partial_stream", "usage_unavailable", "billing_correction", "duplicate_charge"]>;
455
+ export declare const usageRefundReasonSchema: z.ZodEnum<{
456
+ unused_reservation: "unused_reservation";
457
+ client_cancelled: "client_cancelled";
458
+ upstream_failure: "upstream_failure";
459
+ partial_stream: "partial_stream";
460
+ usage_unavailable: "usage_unavailable";
461
+ billing_correction: "billing_correction";
462
+ duplicate_charge: "duplicate_charge";
463
+ }>;
955
464
  /**
956
465
  * An immutable reversal entry.
957
466
  *
@@ -960,211 +469,69 @@ export declare const usageRefundReasonSchema: z.ZodEnum<["unused_reservation", "
960
469
  * consumer could read the wrong way round. Idempotent by key, so a retried
961
470
  * refund releases the same money once.
962
471
  */
963
- export declare const usageRefundSchema: z.ZodEffects<z.ZodObject<{
964
- /** See `version.ts`: a ledger record read back on its own. */
472
+ export declare const usageRefundSchema: z.ZodObject<{
965
473
  schemaVersion: z.ZodLiteral<1>;
966
474
  refundId: z.ZodString;
967
475
  idempotencyKey: z.ZodString;
968
476
  attribution: z.ZodObject<{
969
- principal: z.ZodObject<{
477
+ principal: z.ZodDiscriminatedUnion<[z.ZodObject<{
478
+ authority: z.ZodLiteral<"first_party">;
970
479
  billing: z.ZodObject<{
971
- accountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
972
- }, "strict", z.ZodTypeAny, {
973
- accountId: string & z.BRAND<"OxyAccountId">;
974
- }, {
975
- accountId: string;
480
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
481
+ }, z.core.$strict>;
482
+ applicationId: z.ZodString;
483
+ credentialId: z.ZodString;
484
+ environment: z.ZodEnum<{
485
+ development: "development";
486
+ staging: "staging";
487
+ production: "production";
976
488
  }>;
489
+ }, z.core.$strict>, z.ZodObject<{
490
+ authority: z.ZodOptional<z.ZodLiteral<"external">>;
491
+ inferenceScopes: z.ZodArray<z.ZodEnum<{
492
+ "inference:invoke": "inference:invoke";
493
+ "inference:models:read": "inference:models:read";
494
+ "inference:usage:read": "inference:usage:read";
495
+ "inference:routing:read": "inference:routing:read";
496
+ "inference:routing:write": "inference:routing:write";
497
+ "inference:providers:read": "inference:providers:read";
498
+ "inference:providers:write": "inference:providers:write";
499
+ }>>;
500
+ billing: z.ZodObject<{
501
+ accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
502
+ }, z.core.$strict>;
977
503
  applicationId: z.ZodString;
978
504
  credentialId: z.ZodString;
979
- environment: z.ZodEnum<["development", "staging", "production"]>;
980
- inferenceScopes: z.ZodArray<z.ZodEnum<["inference:invoke", "inference:models:read", "inference:usage:read", "inference:routing:read", "inference:routing:write", "inference:providers:read", "inference:providers:write"]>, "many">;
981
- }, "strip", z.ZodTypeAny, {
982
- environment: "development" | "staging" | "production";
983
- applicationId: string;
984
- credentialId: string;
985
- billing: {
986
- accountId: string & z.BRAND<"OxyAccountId">;
987
- };
988
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
989
- }, {
990
- environment: "development" | "staging" | "production";
991
- applicationId: string;
992
- credentialId: string;
993
- billing: {
994
- accountId: string;
995
- };
996
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
997
- }>;
998
- userId: z.ZodOptional<z.ZodBranded<z.ZodString, "DelegatedUserId">>;
505
+ environment: z.ZodEnum<{
506
+ development: "development";
507
+ staging: "staging";
508
+ production: "production";
509
+ }>;
510
+ }, z.core.$strict>], "authority">;
511
+ userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
999
512
  requestId: z.ZodString;
1000
513
  generationId: z.ZodOptional<z.ZodString>;
1001
- }, "strip", z.ZodTypeAny, {
1002
- requestId: string;
1003
- principal: {
1004
- environment: "development" | "staging" | "production";
1005
- applicationId: string;
1006
- credentialId: string;
1007
- billing: {
1008
- accountId: string & z.BRAND<"OxyAccountId">;
1009
- };
1010
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
1011
- };
1012
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
1013
- generationId?: string | undefined;
1014
- }, {
1015
- requestId: string;
1016
- principal: {
1017
- environment: "development" | "staging" | "production";
1018
- applicationId: string;
1019
- credentialId: string;
1020
- billing: {
1021
- accountId: string;
1022
- };
1023
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
1024
- };
1025
- userId?: string | undefined;
1026
- generationId?: string | undefined;
1027
- }>;
1028
- subject: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
514
+ }, z.core.$strip>;
515
+ subject: z.ZodDiscriminatedUnion<[z.ZodObject<{
1029
516
  kind: z.ZodLiteral<"reservation">;
1030
517
  reservationId: z.ZodString;
1031
- }, "strict", z.ZodTypeAny, {
1032
- kind: "reservation";
1033
- reservationId: string;
1034
- }, {
1035
- kind: "reservation";
1036
- reservationId: string;
1037
- }>, z.ZodObject<{
518
+ }, z.core.$strict>, z.ZodObject<{
1038
519
  kind: z.ZodLiteral<"receipt">;
1039
520
  receiptId: z.ZodString;
1040
- }, "strict", z.ZodTypeAny, {
1041
- kind: "receipt";
1042
- receiptId: string;
1043
- }, {
1044
- kind: "receipt";
1045
- receiptId: string;
1046
- }>]>;
1047
- reason: z.ZodEnum<["unused_reservation", "client_cancelled", "upstream_failure", "partial_stream", "usage_unavailable", "billing_correction", "duplicate_charge"]>;
1048
- amount: z.ZodBranded<z.ZodString, "ExactDecimal">;
521
+ }, z.core.$strict>], "kind">;
522
+ reason: z.ZodEnum<{
523
+ unused_reservation: "unused_reservation";
524
+ client_cancelled: "client_cancelled";
525
+ upstream_failure: "upstream_failure";
526
+ partial_stream: "partial_stream";
527
+ usage_unavailable: "usage_unavailable";
528
+ billing_correction: "billing_correction";
529
+ duplicate_charge: "duplicate_charge";
530
+ }>;
531
+ amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
1049
532
  currency: z.ZodString;
1050
533
  createdAt: z.ZodString;
1051
- }, "strip", z.ZodTypeAny, {
1052
- createdAt: string;
1053
- schemaVersion: 1;
1054
- subject: {
1055
- kind: "reservation";
1056
- reservationId: string;
1057
- } | {
1058
- kind: "receipt";
1059
- receiptId: string;
1060
- };
1061
- reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
1062
- currency: string;
1063
- attribution: {
1064
- requestId: string;
1065
- principal: {
1066
- environment: "development" | "staging" | "production";
1067
- applicationId: string;
1068
- credentialId: string;
1069
- billing: {
1070
- accountId: string & z.BRAND<"OxyAccountId">;
1071
- };
1072
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
1073
- };
1074
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
1075
- generationId?: string | undefined;
1076
- };
1077
- idempotencyKey: string;
1078
- amount: string & z.BRAND<"ExactDecimal">;
1079
- refundId: string;
1080
- }, {
1081
- createdAt: string;
1082
- schemaVersion: 1;
1083
- subject: {
1084
- kind: "reservation";
1085
- reservationId: string;
1086
- } | {
1087
- kind: "receipt";
1088
- receiptId: string;
1089
- };
1090
- reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
1091
- currency: string;
1092
- attribution: {
1093
- requestId: string;
1094
- principal: {
1095
- environment: "development" | "staging" | "production";
1096
- applicationId: string;
1097
- credentialId: string;
1098
- billing: {
1099
- accountId: string;
1100
- };
1101
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
1102
- };
1103
- userId?: string | undefined;
1104
- generationId?: string | undefined;
1105
- };
1106
- idempotencyKey: string;
1107
- amount: string;
1108
- refundId: string;
1109
- }>, {
1110
- createdAt: string;
1111
- schemaVersion: 1;
1112
- subject: {
1113
- kind: "reservation";
1114
- reservationId: string;
1115
- } | {
1116
- kind: "receipt";
1117
- receiptId: string;
1118
- };
1119
- reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
1120
- currency: string;
1121
- attribution: {
1122
- requestId: string;
1123
- principal: {
1124
- environment: "development" | "staging" | "production";
1125
- applicationId: string;
1126
- credentialId: string;
1127
- billing: {
1128
- accountId: string & z.BRAND<"OxyAccountId">;
1129
- };
1130
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
1131
- };
1132
- userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
1133
- generationId?: string | undefined;
1134
- };
1135
- idempotencyKey: string;
1136
- amount: string & z.BRAND<"ExactDecimal">;
1137
- refundId: string;
1138
- }, {
1139
- createdAt: string;
1140
- schemaVersion: 1;
1141
- subject: {
1142
- kind: "reservation";
1143
- reservationId: string;
1144
- } | {
1145
- kind: "receipt";
1146
- receiptId: string;
1147
- };
1148
- reason: "unused_reservation" | "client_cancelled" | "upstream_failure" | "partial_stream" | "usage_unavailable" | "billing_correction" | "duplicate_charge";
1149
- currency: string;
1150
- attribution: {
1151
- requestId: string;
1152
- principal: {
1153
- environment: "development" | "staging" | "production";
1154
- applicationId: string;
1155
- credentialId: string;
1156
- billing: {
1157
- accountId: string;
1158
- };
1159
- inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
1160
- };
1161
- userId?: string | undefined;
1162
- generationId?: string | undefined;
1163
- };
1164
- idempotencyKey: string;
1165
- amount: string;
1166
- refundId: string;
1167
- }>;
534
+ }, z.core.$strip>;
1168
535
  export type UsageReservationRequest = z.infer<typeof usageReservationRequestSchema>;
1169
536
  export type UsageReservationStatus = z.infer<typeof usageReservationStatusSchema>;
1170
537
  export type UsageReservation = z.infer<typeof usageReservationSchema>;