@1claw/sdk 0.57.0 → 0.58.2

package/README.md

@@ -1,4 +1,4 @@
-# @1claw/sdk
+# @1claw/sdk (v0.58.2)
 
 TypeScript/JavaScript client for the 1Claw Vault API.
 
@@ -106,8 +106,19 @@ await client.auth.verifyEmailChange({ code: "123456" });
 | `client.fiat` | `createOnrampSession`, `initiateOfframp` |
 | `client.signingKeys` | `create`, `list`, `rotate`, `deactivate`, `export`                                                               |
 | `client.agents` (Bankr) | `leaseBankrKey`, `listBankrKeys`, `revokeBankrKey` — privileged; `api_key` omitted for agent JWTs (use Shroud) |
-| `client.platform`  | `createApp`, `listApps`, `getApp`, `updateApp`, `deleteApp`, `rotateKey`, `rotateWebhookSecret`, `getAppStats`, `marketplace`, `createTemplate`, `listTemplates`, `upsertUser`, `listUsers`, `bootstrapUser`, `reissueClaim`, `claimPreview`, `claimRedeem`, `listConnectedApps`, `disconnectApp`, `grantAccess`, `listGrants`, `revokeGrant`, `createSpendPolicy`, `listSpendPolicies`, `setUserSpendPolicy`, `deleteSpendPolicy`, `updateConnectionDelegation`, **`siweChallenge`**, **`getConnection`**, **`getConnectionUsage`**, **`listEntitlements`**, **`refreshEntitlements`**, **`previewTemplate`** |
+| `client.platform`  | `createApp`, `listApps`, `getApp`, `updateApp`, `deleteApp`, `rotateKey`, `rotateWebhookSecret`, `getAppStats`, `marketplace`, `createTemplate`, `listTemplates`, `upsertUser`, `listUsers`, `bootstrapUser`, `reissueClaim`, `claimPreview`, `claimRedeem`, `listConnectedApps`, `disconnectApp`, `grantAccess`, `listGrants`, `revokeGrant`, `createSpendPolicy`, `listSpendPolicies`, `setUserSpendPolicy`, `deleteSpendPolicy`, `updateConnectionDelegation`, **`siweChallenge`**, **`getConnection`**, **`getConnectionUsage`**, **`listEntitlements`**, **`refreshEntitlements`**, **`previewTemplate`**, **`transferAppOwnership`**, **`getSpendPolicy`**, **`getConnectionSpendPolicy`**, **`listConnectionApprovals`**, **`getConnectionApproval`**, **`listConnectionPendingApprovals`** |
 | `client.treasuryWallets` | … **`getInferenceBudget`** (platform-connected users) |
+| `client.bindings`  | `create`, `list`, `get`, `update`, `delete`, `test`, `execute`, `rotateCredential`, `listExecutions` |
+| `client.chat`      | `sendMessage`, `sendMessageStream`, `listConversations`, `getConversation`, `deleteConversation` |
+| `client.channels`  | `create`, `list`, `update`, `delete`, `send`, `test`, `refreshWebhook`, `listMessages` |
+| `client.oauthConnect` | `listProviders`, `listConnections`, `connect`, `disconnect`, `saveAppCredentials`, `listAppCredentials`, `deleteAppCredentials` |
+| `client.cedarPolicies` | `create`, `list`, `get`, `delete`, `test` |
+| `client.opaPolicies` | `create`, `list`, `get`, `delete`, `test` |
+| `client.contractAbis` | `upload`, `list`, `delete` |
+| `client.pendingApprovals` | `list`, `get`, `approve`, `execute`, `cancel` |
+| `client.subOrgs`   | `create`, `list`, `get`, `delete`, `grantPermission`, `revokePermission`, `addUser`, `generateWallets` |
+| `client.portfolio` | `get` |
+| `client.cards`     | `order`, `orderGiftCard`, `searchGiftCards`, `list`, `get`, `reveal`, `update`, `void`, `refresh`, `import` |
 | `client.devices`   | `register`, `list`, `delete`, `challenge`, `attest`, `setPushToken`                                                 |
 | `client.passkeys`  | `list`, `registerBegin`, `registerComplete`, `assertBegin`, `assertComplete`, `delete`                               |
 | `client.risk`      | `listEvents`, `getVerdict`, `listVerdicts`, `createHoneytoken`, `listHoneytokens`, `deleteHoneytoken`                |
@@ -1000,6 +1011,58 @@ const begin = await client.auth.beginPasskeyTxAssert({ tx_digest: "abc123...", a
 // ... complete ceremony, then send with X-Passkey-Token header
 ```
 
+## v0.57 — Platform API expansion
+
+SIWE wallet login, parameterized bootstrap, connection polling, entitlements, and inference budgets:
+
+```typescript
+// SIWE challenge + upsert (plt_ auth)
+const challenge = await client.platform.siweChallenge();
+// ... sign SIWE message, upsert with subject_token_type urn:1claw:params:oauth:token-type:siwe
+
+await client.platform.getConnection(connectionId);
+await client.platform.getConnectionUsage(connectionId);
+await client.platform.listEntitlements(connectionId);
+await client.platform.previewTemplate(appId, templateId, { parameters: { agent_name: "demo" } });
+
+await client.treasuryWallets.getInferenceBudget();
+```
+
+## v0.58 — Platform API control plane
+
+App-scoped reads, spend-policy idempotency, and ownership transfer (plt_ auth unless noted):
+
+```typescript
+await client.platform.transferAppOwnership(appId, {
+    target_org_id: "org-uuid",
+});
+await client.platform.getSpendPolicy(appId, policyId);
+await client.platform.getConnectionSpendPolicy(connectionId);
+await client.platform.listConnectionApprovals(connectionId);
+await client.platform.getConnectionApproval(connectionId, approvalId);
+await client.platform.listConnectionPendingApprovals(connectionId);
+await client.platform.getTemplate(appId, templateId);
+await client.platform.createConnectionRuntime(connectionId, {
+    name: "my-runtime",
+    agent_id: "agent-uuid",
+    preset: "small",
+    template: "openclaw",
+});
+await client.platform.connectionAgentChat(connectionId, agentId, {
+    message: "Hello",
+});
+await client.platform.decideConnectionPendingApproval(connectionId, approvalId, {
+    decision: "approve",
+    payload_hash: "...",
+    credential_type: "wallet_mandate",
+});
+await client.platform.decideConnectionApproval(connectionId, approvalId, {
+    decision: "approved",
+});
+await client.platform.deactivateConnectionSigningKey(connectionId, "ethereum", agentId);
+// setUserSpendPolicy(connectionId, data, { idempotencyKey: "..." }) — 24h replay protection
+```
+
 ## OpenAPI Types
 
 The SDK's request types are generated from the **OpenAPI 3.1** spec, published as [@1claw/openapi-spec](https://www.npmjs.com/package/@1claw/openapi-spec). Advanced users can access the raw generated types: