@1claw/sdk 0.15.1 → 0.15.3

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.
@@ -674,6 +674,27 @@ export interface paths {
674
674
  patch?: never;
675
675
  trace?: never;
676
676
  };
677
+ "/v1/agents/{agent_id}/smart-accounts": {
678
+ parameters: {
679
+ query?: never;
680
+ header?: never;
681
+ path?: never;
682
+ cookie?: never;
683
+ };
684
+ get?: never;
685
+ put?: never;
686
+ /**
687
+ * Add a smart account (Safe) for this agent on a chain
688
+ * @description Use after deploying a Safe on a new chain. Multi-chain; one Safe per chain.
689
+ * Replaces any existing entry for the same chain_id.
690
+ */
691
+ post: operations["addAgentSmartAccount"];
692
+ delete?: never;
693
+ options?: never;
694
+ head?: never;
695
+ patch?: never;
696
+ trace?: never;
697
+ };
677
698
  "/v1/agents/{agent_id}/transactions": {
678
699
  parameters: {
679
700
  query?: never;
@@ -714,6 +735,32 @@ export interface paths {
714
735
  patch?: never;
715
736
  trace?: never;
716
737
  };
738
+ "/v1/agents/{agent_id}/transactions/sign": {
739
+ parameters: {
740
+ query?: never;
741
+ header?: never;
742
+ path?: never;
743
+ cookie?: never;
744
+ };
745
+ get?: never;
746
+ put?: never;
747
+ /**
748
+ * Sign a transaction without broadcasting
749
+ * @description Signs a transaction inside the server (or TEE when using Shroud) but does
750
+ * **not** broadcast it. The caller receives the raw `signed_tx` hex and
751
+ * `tx_hash` so it can submit to any RPC of its choosing.
752
+ *
753
+ * All agent guardrails (allowlists, value caps, daily limits) are enforced
754
+ * exactly as for the submit endpoint. The signed transaction is recorded for
755
+ * audit and daily-limit tracking with `status: "sign_only"`.
756
+ */
757
+ post: operations["signTransaction"];
758
+ delete?: never;
759
+ options?: never;
760
+ head?: never;
761
+ patch?: never;
762
+ trace?: never;
763
+ };
717
764
  "/v1/agents/{agent_id}/transactions/simulate": {
718
765
  parameters: {
719
766
  query?: never;
@@ -1129,6 +1176,66 @@ export interface paths {
1129
1176
  patch?: never;
1130
1177
  trace?: never;
1131
1178
  };
1179
+ "/v1/billing/llm-token-billing": {
1180
+ parameters: {
1181
+ query?: never;
1182
+ header?: never;
1183
+ path?: never;
1184
+ cookie?: never;
1185
+ };
1186
+ /**
1187
+ * Get LLM token billing status
1188
+ * @description Returns whether LLM token billing is enabled for the caller's org.
1189
+ */
1190
+ get: operations["getLlmTokenBilling"];
1191
+ put?: never;
1192
+ post?: never;
1193
+ delete?: never;
1194
+ options?: never;
1195
+ head?: never;
1196
+ patch?: never;
1197
+ trace?: never;
1198
+ };
1199
+ "/v1/billing/llm-token-billing/subscribe": {
1200
+ parameters: {
1201
+ query?: never;
1202
+ header?: never;
1203
+ path?: never;
1204
+ cookie?: never;
1205
+ };
1206
+ get?: never;
1207
+ put?: never;
1208
+ /**
1209
+ * Subscribe to LLM token billing
1210
+ * @description Creates a Stripe Checkout session for the LLM token billing pricing plan. Returns a checkout URL to redirect the user. After the user completes checkout, a webhook activates LLM billing for the org.
1211
+ */
1212
+ post: operations["subscribeLlmTokenBilling"];
1213
+ delete?: never;
1214
+ options?: never;
1215
+ head?: never;
1216
+ patch?: never;
1217
+ trace?: never;
1218
+ };
1219
+ "/v1/billing/llm-token-billing/disable": {
1220
+ parameters: {
1221
+ query?: never;
1222
+ header?: never;
1223
+ path?: never;
1224
+ cookie?: never;
1225
+ };
1226
+ get?: never;
1227
+ put?: never;
1228
+ /**
1229
+ * Disable LLM token billing
1230
+ * @description Disables LLM token billing for the org and cancels all active Stripe subscriptions for the LLM pricing plan. Agents will fall back to direct provider routing. You can re-enable it at any time.
1231
+ */
1232
+ post: operations["disableLlmTokenBilling"];
1233
+ delete?: never;
1234
+ options?: never;
1235
+ head?: never;
1236
+ patch?: never;
1237
+ trace?: never;
1238
+ };
1132
1239
  "/v1/billing/overage-method": {
1133
1240
  parameters: {
1134
1241
  query?: never;
@@ -1244,10 +1351,12 @@ export interface paths {
1244
1351
  get: operations["getTreasury"];
1245
1352
  put?: never;
1246
1353
  post?: never;
1247
- delete?: never;
1354
+ /** Delete a treasury and its signers */
1355
+ delete: operations["deleteTreasury"];
1248
1356
  options?: never;
1249
1357
  head?: never;
1250
- patch?: never;
1358
+ /** Update treasury name and/or threshold */
1359
+ patch: operations["updateTreasury"];
1251
1360
  trace?: never;
1252
1361
  };
1253
1362
  "/v1/treasury/{treasury_id}/signers": {
@@ -1530,8 +1639,11 @@ export interface components {
1530
1639
  refresh_token?: string;
1531
1640
  };
1532
1641
  AgentTokenRequest: {
1533
- /** Format: uuid */
1534
- agent_id: string;
1642
+ /**
1643
+ * Format: uuid
1644
+ * @description Optional when using key-only auth (ocv_ keys auto-resolve agent)
1645
+ */
1646
+ agent_id?: string;
1535
1647
  api_key: string;
1536
1648
  };
1537
1649
  UserApiKeyTokenRequest: {
@@ -1899,6 +2011,27 @@ export interface components {
1899
2011
  expires_at?: string;
1900
2012
  /** Format: date-time */
1901
2013
  last_active_at?: string;
2014
+ /** @description Multi-chain; one Safe per chain */
2015
+ smart_accounts?: components["schemas"]["AgentSmartAccountResponse"][];
2016
+ };
2017
+ /** @description One Safe smart account per chain for an agent */
2018
+ AgentSmartAccountResponse: {
2019
+ /** Format: uuid */
2020
+ id?: string;
2021
+ chain?: string;
2022
+ chain_id?: number;
2023
+ safe_address?: string;
2024
+ nonce?: string;
2025
+ init_data?: Record<string, never>;
2026
+ /** Format: date-time */
2027
+ created_at?: string;
2028
+ };
2029
+ AddSmartAccountRequest: {
2030
+ chain: string;
2031
+ chain_id: number;
2032
+ safe_address: string;
2033
+ nonce?: string;
2034
+ init_data?: Record<string, never>;
1902
2035
  };
1903
2036
  AgentSelfResponse: {
1904
2037
  /** Format: uuid */
@@ -2143,6 +2276,48 @@ export interface components {
2143
2276
  max_priority_fee_per_gas?: string;
2144
2277
  /** @default false */
2145
2278
  simulate_first: boolean;
2279
+ /**
2280
+ * @description Transaction mode
2281
+ * @default eoa
2282
+ * @enum {string}
2283
+ */
2284
+ mode: "eoa" | "smart_account";
2285
+ };
2286
+ SignTransactionRequest: {
2287
+ /** @description Destination address (0x-prefixed) */
2288
+ to: string;
2289
+ /** @description Value in ETH */
2290
+ value: string;
2291
+ /** @description Chain name or numeric ID */
2292
+ chain: string;
2293
+ /** @description Hex-encoded calldata */
2294
+ data?: string;
2295
+ signing_key_path?: string;
2296
+ nonce?: number;
2297
+ gas_price?: string;
2298
+ gas_limit?: number;
2299
+ max_fee_per_gas?: string;
2300
+ max_priority_fee_per_gas?: string;
2301
+ /** @default false */
2302
+ simulate_first: boolean;
2303
+ };
2304
+ SignTransactionResponse: {
2305
+ /** @description Raw signed transaction hex (always included) */
2306
+ signed_tx?: string;
2307
+ tx_hash?: string;
2308
+ /** @description Derived sender address */
2309
+ from?: string;
2310
+ to?: string;
2311
+ chain?: string;
2312
+ chain_id?: number;
2313
+ nonce?: number;
2314
+ value_wei?: string;
2315
+ /** @enum {string} */
2316
+ status?: "sign_only";
2317
+ simulation_id?: string;
2318
+ simulation_status?: string;
2319
+ max_fee_per_gas?: string;
2320
+ max_priority_fee_per_gas?: string;
2146
2321
  };
2147
2322
  SimulateTransactionRequest: {
2148
2323
  to: string;
@@ -2165,8 +2340,8 @@ export interface components {
2165
2340
  to?: string;
2166
2341
  value_wei?: string;
2167
2342
  /** @enum {string} */
2168
- status?: "pending" | "signed" | "broadcast" | "failed" | "simulation_failed";
2169
- /** @description Raw signed transaction hex. Omitted (null) by default to reduce exfiltration risk. Pass `include_signed_tx=true` query param on GET endpoints to include it. Always returned on the initial POST submission response. */
2343
+ status?: "pending" | "signed" | "sign_only" | "broadcast" | "failed" | "simulation_failed";
2344
+ /** @description Raw signed transaction hex. On GET list and GET by id, this property is omitted by default (absent from the response). Pass `include_signed_tx=true` on those endpoints to include it. Always present on the initial POST submit response. */
2170
2345
  signed_tx?: string | null;
2171
2346
  tx_hash?: string;
2172
2347
  error_message?: string;
@@ -2407,6 +2582,18 @@ export interface components {
2407
2582
  used?: number;
2408
2583
  limit?: number;
2409
2584
  };
2585
+ LlmTokenBillingStatus: {
2586
+ enabled?: boolean;
2587
+ /** @enum {string} */
2588
+ subscription_status?: "active" | "inactive";
2589
+ };
2590
+ LlmCheckoutResponse: {
2591
+ /** Format: uri */
2592
+ checkout_url?: string;
2593
+ };
2594
+ LlmDisableResponse: {
2595
+ enabled?: boolean;
2596
+ };
2410
2597
  CreditBalanceResponse: {
2411
2598
  balance_cents?: number;
2412
2599
  balance_usd?: string;
@@ -2534,23 +2721,40 @@ export interface components {
2534
2721
  duration_days?: number;
2535
2722
  };
2536
2723
  CreateTreasuryRequest: {
2724
+ /** @description Display name (1–128 characters) */
2537
2725
  name: string;
2538
- chain: string;
2539
- chain_id: number;
2540
- threshold: number;
2541
- /** @description Pre-deployed Safe address (optional) */
2542
- safe_address?: string;
2726
+ /** @description Deployed Safe contract address (0x-prefixed, 42 characters) */
2727
+ safe_address: string;
2728
+ /** @description Chain name (default base) */
2729
+ chain?: string;
2730
+ /** @description EVM chain ID (default 8453 for Base) */
2731
+ chain_id?: number;
2732
+ /** @description Safe threshold (default 1) */
2733
+ threshold?: number;
2734
+ signers?: components["schemas"]["CreateTreasurySignerEntry"][];
2735
+ };
2736
+ CreateTreasurySignerEntry: {
2737
+ /** @enum {string} */
2738
+ signer_type: "user" | "agent";
2739
+ /** Format: uuid */
2740
+ signer_id: string;
2741
+ /** @description EVM address (0x-prefixed) */
2742
+ signer_address: string;
2743
+ };
2744
+ UpdateTreasuryRequest: {
2745
+ name?: string;
2746
+ threshold?: number;
2543
2747
  };
2544
2748
  TreasuryResponse: {
2545
2749
  /** Format: uuid */
2546
2750
  id?: string;
2547
- /** Format: uuid */
2548
- org_id?: string;
2549
2751
  name?: string;
2550
2752
  safe_address?: string;
2551
2753
  chain?: string;
2552
2754
  chain_id?: number;
2553
2755
  threshold?: number;
2756
+ /** Format: uuid */
2757
+ created_by?: string;
2554
2758
  signers?: components["schemas"]["TreasurySignerResponse"][];
2555
2759
  /** Format: date-time */
2556
2760
  created_at?: string;
@@ -2562,15 +2766,16 @@ export interface components {
2562
2766
  signer_type?: "user" | "agent";
2563
2767
  /** Format: uuid */
2564
2768
  signer_id?: string;
2565
- evm_address?: string;
2769
+ signer_address?: string;
2566
2770
  /** Format: date-time */
2567
- created_at?: string;
2771
+ added_at?: string;
2568
2772
  };
2569
2773
  AddSignerRequest: {
2570
2774
  /** @enum {string} */
2571
2775
  signer_type: "user" | "agent";
2572
2776
  /** Format: uuid */
2573
2777
  signer_id: string;
2778
+ signer_address: string;
2574
2779
  };
2575
2780
  AccessRequestResponse: {
2576
2781
  /** Format: uuid */
@@ -2581,9 +2786,13 @@ export interface components {
2581
2786
  agent_id?: string;
2582
2787
  /** @enum {string} */
2583
2788
  status?: "pending" | "approved" | "denied";
2584
- evm_address?: string;
2789
+ reason?: string;
2585
2790
  /** Format: date-time */
2586
- created_at?: string;
2791
+ requested_at?: string;
2792
+ /** Format: uuid */
2793
+ resolved_by?: string;
2794
+ /** Format: date-time */
2795
+ resolved_at?: string;
2587
2796
  };
2588
2797
  PaymentRequirement: {
2589
2798
  x402Version?: number;
@@ -2655,7 +2864,7 @@ export interface components {
2655
2864
  SecretPath: string;
2656
2865
  AgentId: string;
2657
2866
  PolicyId: string;
2658
- /** @description Set to `true` or `1` to include the raw signed transaction hex in the response. Omitted by default to reduce key exfiltration risk. Only the literal values "true" or "1" enable inclusion; any other value or omission returns responses without signed_tx. */
2867
+ /** @description Set to `true` or `1` to include the raw signed transaction hex in the response. Omitted by default to reduce key exfiltration risk. Only the literal values "true" or "1" enable inclusion; any other value or omission returns responses without signed_tx. Applies to GET /v1/agents/{agent_id}/transactions and GET /v1/agents/{agent_id}/transactions/{tx_id}. */
2659
2868
  IncludeSignedTx: boolean;
2660
2869
  };
2661
2870
  requestBodies: never;
@@ -3888,10 +4097,39 @@ export interface operations {
3888
4097
  404: components["responses"]["NotFound"];
3889
4098
  };
3890
4099
  };
4100
+ addAgentSmartAccount: {
4101
+ parameters: {
4102
+ query?: never;
4103
+ header?: never;
4104
+ path: {
4105
+ agent_id: components["parameters"]["AgentId"];
4106
+ };
4107
+ cookie?: never;
4108
+ };
4109
+ requestBody: {
4110
+ content: {
4111
+ "application/json": components["schemas"]["AddSmartAccountRequest"];
4112
+ };
4113
+ };
4114
+ responses: {
4115
+ /** @description Agent with updated smart_accounts list */
4116
+ 200: {
4117
+ headers: {
4118
+ [name: string]: unknown;
4119
+ };
4120
+ content: {
4121
+ "application/json": components["schemas"]["AgentResponse"];
4122
+ };
4123
+ };
4124
+ 400: components["responses"]["BadRequest"];
4125
+ 403: components["responses"]["Forbidden"];
4126
+ 404: components["responses"]["NotFound"];
4127
+ };
4128
+ };
3891
4129
  listTransactions: {
3892
4130
  parameters: {
3893
4131
  query?: {
3894
- /** @description Set to `true` or `1` to include the raw signed transaction hex in the response. Omitted by default to reduce key exfiltration risk. Only the literal values "true" or "1" enable inclusion; any other value or omission returns responses without signed_tx. */
4132
+ /** @description Set to `true` or `1` to include the raw signed transaction hex in the response. Omitted by default to reduce key exfiltration risk. Only the literal values "true" or "1" enable inclusion; any other value or omission returns responses without signed_tx. Applies to GET /v1/agents/{agent_id}/transactions and GET /v1/agents/{agent_id}/transactions/{tx_id}. */
3895
4133
  include_signed_tx?: components["parameters"]["IncludeSignedTx"];
3896
4134
  };
3897
4135
  header?: never;
@@ -3974,7 +4212,7 @@ export interface operations {
3974
4212
  getTransaction: {
3975
4213
  parameters: {
3976
4214
  query?: {
3977
- /** @description Set to `true` or `1` to include the raw signed transaction hex in the response. Omitted by default to reduce key exfiltration risk. Only the literal values "true" or "1" enable inclusion; any other value or omission returns responses without signed_tx. */
4215
+ /** @description Set to `true` or `1` to include the raw signed transaction hex in the response. Omitted by default to reduce key exfiltration risk. Only the literal values "true" or "1" enable inclusion; any other value or omission returns responses without signed_tx. Applies to GET /v1/agents/{agent_id}/transactions and GET /v1/agents/{agent_id}/transactions/{tx_id}. */
3978
4216
  include_signed_tx?: components["parameters"]["IncludeSignedTx"];
3979
4217
  };
3980
4218
  header?: never;
@@ -3998,6 +4236,35 @@ export interface operations {
3998
4236
  404: components["responses"]["NotFound"];
3999
4237
  };
4000
4238
  };
4239
+ signTransaction: {
4240
+ parameters: {
4241
+ query?: never;
4242
+ header?: never;
4243
+ path: {
4244
+ agent_id: components["parameters"]["AgentId"];
4245
+ };
4246
+ cookie?: never;
4247
+ };
4248
+ requestBody: {
4249
+ content: {
4250
+ "application/json": components["schemas"]["SignTransactionRequest"];
4251
+ };
4252
+ };
4253
+ responses: {
4254
+ /** @description Transaction signed successfully (not broadcast) */
4255
+ 200: {
4256
+ headers: {
4257
+ [name: string]: unknown;
4258
+ };
4259
+ content: {
4260
+ "application/json": components["schemas"]["SignTransactionResponse"];
4261
+ };
4262
+ };
4263
+ 400: components["responses"]["BadRequest"];
4264
+ 402: components["responses"]["PaymentRequired"];
4265
+ 403: components["responses"]["Forbidden"];
4266
+ };
4267
+ };
4001
4268
  simulateTransaction: {
4002
4269
  parameters: {
4003
4270
  query?: never;
@@ -4631,6 +4898,66 @@ export interface operations {
4631
4898
  };
4632
4899
  };
4633
4900
  };
4901
+ getLlmTokenBilling: {
4902
+ parameters: {
4903
+ query?: never;
4904
+ header?: never;
4905
+ path?: never;
4906
+ cookie?: never;
4907
+ };
4908
+ requestBody?: never;
4909
+ responses: {
4910
+ /** @description LLM token billing status */
4911
+ 200: {
4912
+ headers: {
4913
+ [name: string]: unknown;
4914
+ };
4915
+ content: {
4916
+ "application/json": components["schemas"]["LlmTokenBillingStatus"];
4917
+ };
4918
+ };
4919
+ };
4920
+ };
4921
+ subscribeLlmTokenBilling: {
4922
+ parameters: {
4923
+ query?: never;
4924
+ header?: never;
4925
+ path?: never;
4926
+ cookie?: never;
4927
+ };
4928
+ requestBody?: never;
4929
+ responses: {
4930
+ /** @description Stripe Checkout URL */
4931
+ 200: {
4932
+ headers: {
4933
+ [name: string]: unknown;
4934
+ };
4935
+ content: {
4936
+ "application/json": components["schemas"]["LlmCheckoutResponse"];
4937
+ };
4938
+ };
4939
+ };
4940
+ };
4941
+ disableLlmTokenBilling: {
4942
+ parameters: {
4943
+ query?: never;
4944
+ header?: never;
4945
+ path?: never;
4946
+ cookie?: never;
4947
+ };
4948
+ requestBody?: never;
4949
+ responses: {
4950
+ /** @description LLM billing disabled */
4951
+ 200: {
4952
+ headers: {
4953
+ [name: string]: unknown;
4954
+ };
4955
+ content: {
4956
+ "application/json": components["schemas"]["LlmDisableResponse"];
4957
+ };
4958
+ };
4959
+ };
4960
+ };
4634
4961
  billingOverageMethod: {
4635
4962
  parameters: {
4636
4963
  query?: never;
@@ -4838,6 +5165,55 @@ export interface operations {
4838
5165
  404: components["responses"]["NotFound"];
4839
5166
  };
4840
5167
  };
5168
+ deleteTreasury: {
5169
+ parameters: {
5170
+ query?: never;
5171
+ header?: never;
5172
+ path: {
5173
+ treasury_id: string;
5174
+ };
5175
+ cookie?: never;
5176
+ };
5177
+ requestBody?: never;
5178
+ responses: {
5179
+ /** @description Treasury deleted */
5180
+ 204: {
5181
+ headers: {
5182
+ [name: string]: unknown;
5183
+ };
5184
+ content?: never;
5185
+ };
5186
+ 404: components["responses"]["NotFound"];
5187
+ };
5188
+ };
5189
+ updateTreasury: {
5190
+ parameters: {
5191
+ query?: never;
5192
+ header?: never;
5193
+ path: {
5194
+ treasury_id: string;
5195
+ };
5196
+ cookie?: never;
5197
+ };
5198
+ requestBody: {
5199
+ content: {
5200
+ "application/json": components["schemas"]["UpdateTreasuryRequest"];
5201
+ };
5202
+ };
5203
+ responses: {
5204
+ /** @description Treasury updated */
5205
+ 200: {
5206
+ headers: {
5207
+ [name: string]: unknown;
5208
+ };
5209
+ content: {
5210
+ "application/json": components["schemas"]["TreasuryResponse"];
5211
+ };
5212
+ };
5213
+ 400: components["responses"]["BadRequest"];
5214
+ 404: components["responses"]["NotFound"];
5215
+ };
5216
+ };
4841
5217
  addTreasurySigner: {
4842
5218
  parameters: {
4843
5219
  query?: never;
@@ -4903,7 +5279,7 @@ export interface operations {
4903
5279
  };
4904
5280
  content: {
4905
5281
  "application/json": {
4906
- access_requests?: components["schemas"]["AccessRequestResponse"][];
5282
+ requests?: components["schemas"]["AccessRequestResponse"][];
4907
5283
  };
4908
5284
  };
4909
5285
  };