@1claw/sdk 0.43.5 → 0.44.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.
package/README.md CHANGED
@@ -102,12 +102,12 @@ await client.auth.verifyEmailChange({ code: "123456" });
102
102
  | `client.fiat` | `createOnrampSession`, `initiateOfframp` |
103
103
  | `client.signingKeys` | `create`, `list`, `rotate`, `deactivate`, `export` |
104
104
  | `client.agents` (Bankr) | `leaseBankrKey`, `listBankrKeys`, `revokeBankrKey` — privileged; `api_key` omitted for agent JWTs (use Shroud) |
105
- | `client.platform` | `createApp`, `listApps`, `getApp`, `updateApp`, `deleteApp`, `rotateKey`, `createTemplate`, `listTemplates`, `upsertUser`, `listUsers`, `bootstrapUser`, `reissueClaim`, `claimPreview`, `claimRedeem`, `listConnectedApps`, `disconnectApp`, `grantAccess`, `listGrants`, `revokeGrant`, `createSpendPolicy`, `listSpendPolicies`, `setUserSpendPolicy`, `deleteSpendPolicy` |
105
+ | `client.platform` | `createApp`, `listApps`, `getApp`, `updateApp`, `deleteApp`, `rotateKey`, `createTemplate`, `listTemplates`, `upsertUser`, `listUsers`, `bootstrapUser`, `reissueClaim`, `claimPreview`, `claimRedeem`, `listConnectedApps`, `disconnectApp`, `grantAccess`, `listGrants`, `revokeGrant`, `createSpendPolicy`, `listSpendPolicies`, `setUserSpendPolicy`, `deleteSpendPolicy`, `updateConnectionDelegation` |
106
106
  | `client.devices` | `register`, `list`, `delete`, `challenge`, `attest`, `setPushToken` |
107
107
  | `client.passkeys` | `list`, `registerBegin`, `registerComplete`, `assertBegin`, `assertComplete`, `delete` |
108
108
  | `client.risk` | `listEvents`, `getVerdict`, `listVerdicts`, `createHoneytoken`, `listHoneytokens`, `deleteHoneytoken` |
109
109
  | `client.webhooks` | `create`, `list`, `get`, `update`, `delete` |
110
- | `client.memory` | `put`, `get`, `list`, `delete`, `search`, `listNamespaces` |
110
+ | `client.memory` | `put`, `get`, `list`, `delete`, `search`, `listNamespaces`, `deleteNamespace` |
111
111
  | `client.automations` | `create`, `list`, `get`, `update`, `delete`, `trigger`, `listRuns` |
112
112
  | `client.runtimes` | `create`, `list`, `get`, `update`, `delete`, `start`, `stop`, `logs`, `checkSlug` |
113
113
  | `client.discovery` | `getAgentCard`, `directory`, `updateDiscovery`, `marketplace` |
@@ -3288,6 +3288,27 @@ export interface paths {
3288
3288
  patch?: never;
3289
3289
  trace?: never;
3290
3290
  };
3291
+ "/v1/platform/apps/{appId}/templates/{template_id}": {
3292
+ parameters: {
3293
+ query?: never;
3294
+ header?: never;
3295
+ path?: never;
3296
+ cookie?: never;
3297
+ };
3298
+ get?: never;
3299
+ put?: never;
3300
+ post?: never;
3301
+ /** Delete a bootstrap template */
3302
+ delete: operations["deletePlatformTemplate"];
3303
+ options?: never;
3304
+ head?: never;
3305
+ /**
3306
+ * Update a bootstrap template
3307
+ * @description Update an existing template's name, description, spec, or active status.
3308
+ */
3309
+ patch: operations["updatePlatformTemplate"];
3310
+ trace?: never;
3311
+ };
3291
3312
  "/v1/platform/users/upsert": {
3292
3313
  parameters: {
3293
3314
  query?: never;
@@ -3634,6 +3655,30 @@ export interface paths {
3634
3655
  };
3635
3656
  options?: never;
3636
3657
  head?: never;
3658
+ /**
3659
+ * Update connection delegation
3660
+ * @description Toggle delegation and update delegation scopes for a connected platform app. User-only.
3661
+ */
3662
+ patch: operations["updateConnectionDelegation"];
3663
+ trace?: never;
3664
+ };
3665
+ "/v1/platform/connections/{connectionId}/delegation-log": {
3666
+ parameters: {
3667
+ query?: never;
3668
+ header?: never;
3669
+ path?: never;
3670
+ cookie?: never;
3671
+ };
3672
+ /**
3673
+ * Delegation audit log
3674
+ * @description List delegated actions performed by a platform app on behalf of this user.
3675
+ */
3676
+ get: operations["getDelegationLog"];
3677
+ put?: never;
3678
+ post?: never;
3679
+ delete?: never;
3680
+ options?: never;
3681
+ head?: never;
3637
3682
  patch?: never;
3638
3683
  trace?: never;
3639
3684
  };
@@ -4767,6 +4812,26 @@ export interface paths {
4767
4812
  patch?: never;
4768
4813
  trace?: never;
4769
4814
  };
4815
+ "/v1/automations/{automationId}/runs/{runId}": {
4816
+ parameters: {
4817
+ query?: never;
4818
+ header?: never;
4819
+ path?: never;
4820
+ cookie?: never;
4821
+ };
4822
+ /**
4823
+ * Get automation run
4824
+ * @description Get details of a single automation run including step results and context.
4825
+ */
4826
+ get: operations["getAutomationRun"];
4827
+ put?: never;
4828
+ post?: never;
4829
+ delete?: never;
4830
+ options?: never;
4831
+ head?: never;
4832
+ patch?: never;
4833
+ trace?: never;
4834
+ };
4770
4835
  "/v1/automations/assist/draft": {
4771
4836
  parameters: {
4772
4837
  query?: never;
@@ -5353,6 +5418,26 @@ export interface paths {
5353
5418
  patch?: never;
5354
5419
  trace?: never;
5355
5420
  };
5421
+ "/v1/agents/{agent_id}/channels/{channel_id}/test": {
5422
+ parameters: {
5423
+ query?: never;
5424
+ header?: never;
5425
+ path?: never;
5426
+ cookie?: never;
5427
+ };
5428
+ get?: never;
5429
+ put?: never;
5430
+ /**
5431
+ * Test channel connectivity
5432
+ * @description Send a test message through the channel to verify connectivity and credentials.
5433
+ */
5434
+ post: operations["testChannel"];
5435
+ delete?: never;
5436
+ options?: never;
5437
+ head?: never;
5438
+ patch?: never;
5439
+ trace?: never;
5440
+ };
5356
5441
  "/v1/webhooks/telegram/{webhook_path}": {
5357
5442
  parameters: {
5358
5443
  query?: never;
@@ -7980,6 +8065,8 @@ export interface components {
7980
8065
  signing_key_chains?: string[];
7981
8066
  /** @description One-time agent API key (ocv_ prefix). Store securely — not retrievable later. */
7982
8067
  agent_api_key?: string | null;
8068
+ /** @description EOA address when provision_eoa is true in the template */
8069
+ agent_evm_address?: string | null;
7983
8070
  /** @description Provisioned signing key details (chain, address, public key) */
7984
8071
  signing_keys?: {
7985
8072
  chain?: string;
@@ -7987,6 +8074,10 @@ export interface components {
7987
8074
  public_key?: string;
7988
8075
  address?: string;
7989
8076
  }[];
8077
+ /** @description IDs of runtimes provisioned by the template */
8078
+ runtime_ids?: string[];
8079
+ /** @description IDs of automations provisioned by the template */
8080
+ automation_ids?: string[];
7990
8081
  };
7991
8082
  };
7992
8083
  ConnectedAppResponse: {
@@ -8551,6 +8642,14 @@ export interface components {
8551
8642
  last_run_at?: string | null;
8552
8643
  /** Format: date-time */
8553
8644
  next_run_at?: string | null;
8645
+ /** @description Status of the most recent run (enriched list field) */
8646
+ last_run_status?: string | null;
8647
+ /** @description Total runs in the last 30 days (enriched list field) */
8648
+ total_runs?: number | null;
8649
+ /** @description Success rate percentage (enriched list field) */
8650
+ success_rate?: number | null;
8651
+ /** @description Resolved agent display name (enriched list field) */
8652
+ agent_name?: string | null;
8554
8653
  /** Format: date-time */
8555
8654
  created_at: string;
8556
8655
  /** Format: date-time */
@@ -8592,10 +8691,14 @@ export interface components {
8592
8691
  /** Format: uuid */
8593
8692
  agent_id: string;
8594
8693
  /** @enum {string} */
8595
- status: "pending" | "running" | "completed" | "failed" | "denied" | "cancelled" | "awaiting_approval";
8694
+ status: "running" | "success" | "failed" | "timed_out" | "cancelled" | "awaiting_approval";
8596
8695
  step_results?: unknown;
8597
8696
  error?: string | null;
8598
8697
  trigger_source?: string | null;
8698
+ /** @description JSONB context passed between workflow steps */
8699
+ context?: {
8700
+ [key: string]: unknown;
8701
+ } | null;
8599
8702
  /** Format: date-time */
8600
8703
  started_at: string;
8601
8704
  /** Format: date-time */
@@ -8892,6 +8995,14 @@ export interface components {
8892
8995
  webhook_path?: string;
8893
8996
  webhook_url?: string;
8894
8997
  is_active?: boolean;
8998
+ /**
8999
+ * @description Channel-specific configuration JSON. May include:
9000
+ * - sender_allowlist (array of strings): restrict which external senders can trigger the agent
9001
+ * - auto_respond_enabled (boolean): whether the agent auto-responds to inbound messages
9002
+ */
9003
+ config?: {
9004
+ [key: string]: unknown;
9005
+ } | null;
8895
9006
  /** Format: date-time */
8896
9007
  created_at?: string;
8897
9008
  /** Format: date-time */
@@ -13724,6 +13835,135 @@ export interface operations {
13724
13835
  };
13725
13836
  };
13726
13837
  };
13838
+ deletePlatformTemplate: {
13839
+ parameters: {
13840
+ query?: never;
13841
+ header?: never;
13842
+ path: {
13843
+ appId: string;
13844
+ template_id: string;
13845
+ };
13846
+ cookie?: never;
13847
+ };
13848
+ requestBody?: never;
13849
+ responses: {
13850
+ /** @description Template deleted */
13851
+ 204: {
13852
+ headers: {
13853
+ [name: string]: unknown;
13854
+ };
13855
+ content?: never;
13856
+ };
13857
+ 404: components["responses"]["NotFound"];
13858
+ };
13859
+ };
13860
+ updatePlatformTemplate: {
13861
+ parameters: {
13862
+ query?: never;
13863
+ header?: never;
13864
+ path: {
13865
+ appId: string;
13866
+ template_id: string;
13867
+ };
13868
+ cookie?: never;
13869
+ };
13870
+ requestBody: {
13871
+ content: {
13872
+ "application/json": {
13873
+ name?: string;
13874
+ description?: string | null;
13875
+ spec?: {
13876
+ [key: string]: unknown;
13877
+ };
13878
+ is_active?: boolean;
13879
+ };
13880
+ };
13881
+ };
13882
+ responses: {
13883
+ /** @description Template updated */
13884
+ 200: {
13885
+ headers: {
13886
+ [name: string]: unknown;
13887
+ };
13888
+ content: {
13889
+ "application/json": components["schemas"]["PlatformTemplateResponse"];
13890
+ };
13891
+ };
13892
+ 404: components["responses"]["NotFound"];
13893
+ };
13894
+ };
13895
+ updateConnectionDelegation: {
13896
+ parameters: {
13897
+ query?: never;
13898
+ header?: never;
13899
+ path: {
13900
+ connectionId: string;
13901
+ };
13902
+ cookie?: never;
13903
+ };
13904
+ requestBody: {
13905
+ content: {
13906
+ "application/json": {
13907
+ delegation_enabled?: boolean;
13908
+ /** @description Scopes: vaults:read, vaults:write, agents:read, agents:write, secrets:read, secrets:write, automations:*, runtimes:* */
13909
+ delegation_scopes?: string[];
13910
+ };
13911
+ };
13912
+ };
13913
+ responses: {
13914
+ /** @description Delegation settings updated */
13915
+ 200: {
13916
+ headers: {
13917
+ [name: string]: unknown;
13918
+ };
13919
+ content: {
13920
+ "application/json": {
13921
+ /** Format: uuid */
13922
+ connection_id?: string;
13923
+ delegation_enabled?: boolean;
13924
+ delegation_scopes?: string[];
13925
+ };
13926
+ };
13927
+ };
13928
+ 404: components["responses"]["NotFound"];
13929
+ };
13930
+ };
13931
+ getDelegationLog: {
13932
+ parameters: {
13933
+ query?: never;
13934
+ header?: never;
13935
+ path: {
13936
+ connectionId: string;
13937
+ };
13938
+ cookie?: never;
13939
+ };
13940
+ requestBody?: never;
13941
+ responses: {
13942
+ /** @description Delegation log entries */
13943
+ 200: {
13944
+ headers: {
13945
+ [name: string]: unknown;
13946
+ };
13947
+ content: {
13948
+ "application/json": {
13949
+ entries?: {
13950
+ action?: string;
13951
+ scope?: string;
13952
+ resource_type?: string;
13953
+ /** Format: uuid */
13954
+ resource_id?: string;
13955
+ /** Format: date-time */
13956
+ timestamp?: string;
13957
+ details?: {
13958
+ [key: string]: unknown;
13959
+ } | null;
13960
+ }[];
13961
+ };
13962
+ };
13963
+ };
13964
+ 404: components["responses"]["NotFound"];
13965
+ };
13966
+ };
13727
13967
  listSpendPolicies: {
13728
13968
  parameters: {
13729
13969
  query?: never;
@@ -15193,6 +15433,31 @@ export interface operations {
15193
15433
  404: components["responses"]["NotFound"];
15194
15434
  };
15195
15435
  };
15436
+ getAutomationRun: {
15437
+ parameters: {
15438
+ query?: never;
15439
+ header?: never;
15440
+ path: {
15441
+ automationId: string;
15442
+ runId: string;
15443
+ };
15444
+ cookie?: never;
15445
+ };
15446
+ requestBody?: never;
15447
+ responses: {
15448
+ /** @description Automation run detail */
15449
+ 200: {
15450
+ headers: {
15451
+ [name: string]: unknown;
15452
+ };
15453
+ content: {
15454
+ "application/json": components["schemas"]["AutomationRunResponse"];
15455
+ };
15456
+ };
15457
+ 401: components["responses"]["Unauthorized"];
15458
+ 404: components["responses"]["NotFound"];
15459
+ };
15460
+ };
15196
15461
  assistDraftAutomation: {
15197
15462
  parameters: {
15198
15463
  query?: never;
@@ -16188,6 +16453,44 @@ export interface operations {
16188
16453
  401: components["responses"]["Unauthorized"];
16189
16454
  };
16190
16455
  };
16456
+ testChannel: {
16457
+ parameters: {
16458
+ query?: never;
16459
+ header?: never;
16460
+ path: {
16461
+ agent_id: components["parameters"]["AgentId"];
16462
+ channel_id: string;
16463
+ };
16464
+ cookie?: never;
16465
+ };
16466
+ requestBody?: {
16467
+ content: {
16468
+ "application/json": {
16469
+ /** @description Optional chat ID to send the test message to */
16470
+ external_chat_id?: string;
16471
+ /** @description Optional custom test message content */
16472
+ content?: string;
16473
+ };
16474
+ };
16475
+ };
16476
+ responses: {
16477
+ /** @description Test result */
16478
+ 200: {
16479
+ headers: {
16480
+ [name: string]: unknown;
16481
+ };
16482
+ content: {
16483
+ "application/json": {
16484
+ success?: boolean;
16485
+ message?: string | null;
16486
+ error?: string | null;
16487
+ };
16488
+ };
16489
+ };
16490
+ 401: components["responses"]["Unauthorized"];
16491
+ 404: components["responses"]["NotFound"];
16492
+ };
16493
+ };
16191
16494
  telegramWebhook: {
16192
16495
  parameters: {
16193
16496
  query?: never;