@1claw/sdk 0.24.0 → 0.24.1

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
@@ -79,7 +79,7 @@ await client.auth.resetPassword({ token: "...", new_password: "..." });
79
79
  | `client.vault` | `create`, `get`, `list`, `delete`, `enableMpc`, `disableMpc` |
80
80
  | `client.secrets` | `set`, `get`, `delete`, `list`, `rotate` |
81
81
  | `client.access` | `grantHuman`, `grantAgent`, `update`, `revoke`, `listGrants` |
82
- | `client.agents` | `enroll` (also `AgentsResource.enroll(baseUrl, …)` static), `create`, `getSelf`, `get`, `list`, `update`, `delete`, `rotateKey`, `rotateIdentityKeys`, `submitTransaction`, `signTransaction`, `getTransaction`, `listTransactions`, `simulateTransaction`, `simulateBundle`, `sign` |
82
+ | `client.agents` | `enroll` (also `AgentsResource.enroll(baseUrl, …)` static), `create`, `getSelf`, `get`, `list`, `update`, `delete`, `rotateKey`, `submitTransaction`, `signTransaction`, `getTransaction`, `listTransactions`, `simulateTransaction`, `simulateBundle`, `sign` |
83
83
  | `client.chains` | `list`, `get`, `adminList`, `create`, `update`, `delete` |
84
84
  | `client.sharing` | `create`, `access`, `listOutbound`, `listInbound`, `accept`, `decline`, `revoke` |
85
85
  | `client.approvals` | `request`, `list`, `approve`, `deny`, `check`, `subscribe` |
@@ -91,7 +91,7 @@ await client.auth.resetPassword({ token: "...", new_password: "..." });
91
91
  | `client.treasury` | `create`, `list`, `get`, `update`, `delete`, `addSigner`, `removeSigner`, `requestAccess`, `listAccessRequests`, `approveAccess`, `denyAccess` |
92
92
  | `client.treasuryWallets` | `generateWallets`, `listWallets`, `getWallet`, `exportWallet`, `rotateWallet`, `deactivateWallet` |
93
93
  | `client.signingKeys` | `create`, `list`, `rotate`, `deactivate`, `export` |
94
- | `client.platform` | `createApp`, `listApps`, `getApp`, `updateApp`, `deleteApp`, `createTemplate`, `listTemplates`, `upsertUser`, `bootstrapUser`, `listConnectedApps` |
94
+ | `client.platform` | `createApp`, `listApps`, `getApp`, `updateApp`, `deleteApp`, `createTemplate`, `listTemplates`, `upsertUser`, `listUsers`, `bootstrapUser`, `listConnectedApps`, `disconnectApp` |
95
95
  | `client.x402` | `getPaymentRequirement`, `pay`, `verifyReceipt`, `withPayment` |
96
96
 
97
97
  **Agent create response:** `agents.create()` returns `{ agent: AgentResponse, api_key?: string }`. The `api_key` is only present for `auth_method: "api_key"` and is shown once — use `data.agent.id` and `data.api_key` from the response.
@@ -249,7 +249,7 @@ const oidcJwt = tokenRes.data?.access_token; // RS256-signed; ~15 min default TT
249
249
 
250
250
  The acting agent must have `federation_enabled: true` and the `audience` must be on its `federation_audiences` allowlist (set via dashboard or `client.agents.update`). Every active KMS key version is published in JWKS, so verifiers reject unknown `kid`s automatically when 1claw rotates keys.
251
251
 
252
- End-to-end Anthropic WIF demo: [`examples/anthropic-wif`](https://github.com/1clawAI/1claw-examples/tree/main/anthropic-wif).
252
+ End-to-end Anthropic WIF demo: see the [`examples/anthropic-wif`](https://github.com/1clawAI/1claw-examples/tree/main/anthropic-wif) repo and [`internal-docs/runbooks/oidc-federation.md`](../../internal-docs/runbooks/oidc-federation.md).
253
253
 
254
254
  ## Customer-Managed Encryption Keys (CMEK)
255
255
 
@@ -2779,6 +2779,104 @@ export interface paths {
2779
2779
  patch?: never;
2780
2780
  trace?: never;
2781
2781
  };
2782
+ "/v1/platform/claim/{token}": {
2783
+ parameters: {
2784
+ query?: never;
2785
+ header?: never;
2786
+ path?: never;
2787
+ cookie?: never;
2788
+ };
2789
+ /**
2790
+ * Preview a claim token
2791
+ * @description Verify a claim token and preview what was provisioned (app name, vaults, agents, policies).
2792
+ * Public endpoint — the token itself is the authentication.
2793
+ */
2794
+ get: {
2795
+ parameters: {
2796
+ query?: never;
2797
+ header?: never;
2798
+ path: {
2799
+ /** @description The `ct_` prefixed claim token from the bootstrap response */
2800
+ token: string;
2801
+ };
2802
+ cookie?: never;
2803
+ };
2804
+ requestBody?: never;
2805
+ responses: {
2806
+ /** @description Claim preview */
2807
+ 200: {
2808
+ headers: {
2809
+ [name: string]: unknown;
2810
+ };
2811
+ content: {
2812
+ "application/json": components["schemas"]["ClaimPreviewResponse"];
2813
+ };
2814
+ };
2815
+ /** @description Invalid or expired claim token */
2816
+ 404: {
2817
+ headers: {
2818
+ [name: string]: unknown;
2819
+ };
2820
+ content?: never;
2821
+ };
2822
+ };
2823
+ };
2824
+ put?: never;
2825
+ /**
2826
+ * Redeem a claim token
2827
+ * @description Redeem a one-time claim token, marking the connection as claimed.
2828
+ * Public endpoint — the token itself is the authentication. Returns 409 if already claimed, 410 if expired.
2829
+ */
2830
+ post: {
2831
+ parameters: {
2832
+ query?: never;
2833
+ header?: never;
2834
+ path: {
2835
+ /** @description The `ct_` prefixed claim token from the bootstrap response */
2836
+ token: string;
2837
+ };
2838
+ cookie?: never;
2839
+ };
2840
+ requestBody?: never;
2841
+ responses: {
2842
+ /** @description Claim redeemed */
2843
+ 200: {
2844
+ headers: {
2845
+ [name: string]: unknown;
2846
+ };
2847
+ content: {
2848
+ "application/json": components["schemas"]["ClaimRedeemResponse"];
2849
+ };
2850
+ };
2851
+ /** @description Invalid claim token */
2852
+ 404: {
2853
+ headers: {
2854
+ [name: string]: unknown;
2855
+ };
2856
+ content?: never;
2857
+ };
2858
+ /** @description Claim token already used */
2859
+ 409: {
2860
+ headers: {
2861
+ [name: string]: unknown;
2862
+ };
2863
+ content?: never;
2864
+ };
2865
+ /** @description Claim token has expired */
2866
+ 410: {
2867
+ headers: {
2868
+ [name: string]: unknown;
2869
+ };
2870
+ content?: never;
2871
+ };
2872
+ };
2873
+ };
2874
+ delete?: never;
2875
+ options?: never;
2876
+ head?: never;
2877
+ patch?: never;
2878
+ trace?: never;
2879
+ };
2782
2880
  }
2783
2881
  export type webhooks = Record<string, never>;
2784
2882
  export interface components {
@@ -4676,6 +4774,28 @@ export interface components {
4676
4774
  /** Format: date-time */
4677
4775
  created_at?: string;
4678
4776
  };
4777
+ ClaimPreviewResponse: {
4778
+ app_name?: string;
4779
+ app_slug?: string;
4780
+ app_logo_url?: string | null;
4781
+ auth_mode?: string;
4782
+ vault_ids?: string[];
4783
+ agent_ids?: string[];
4784
+ policy_count?: number;
4785
+ status?: string;
4786
+ already_claimed?: boolean;
4787
+ expired?: boolean;
4788
+ return_to?: string | null;
4789
+ };
4790
+ ClaimRedeemResponse: {
4791
+ status?: string;
4792
+ /** Format: uuid */
4793
+ connection_id?: string;
4794
+ vault_ids?: string[];
4795
+ agent_ids?: string[];
4796
+ return_to?: string | null;
4797
+ dashboard_url?: string;
4798
+ };
4679
4799
  };
4680
4800
  responses: {
4681
4801
  /** @description Invalid request */