@1claw/sdk 0.57.0 → 0.58.0

package/README.md

@@ -1000,6 +1000,23 @@ 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();
+```
+
 ## 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:

package/dist/generated/api-types.d.ts

@@ -3897,12 +3897,14 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Deleted */
-                204: {
+                /** @description Soft-deleted; slug released for reuse within the org */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["PlatformAppDeleteResponse"];
+                    };
                 };
                 /** @description Only human users can delete platform apps */
                 403: {
@@ -3944,6 +3946,29 @@ export interface paths {
         };
         trace?: never;
     };
+    "/v1/platform/apps/{appId}/transfer-ownership": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Transfer platform app to another organization
+         * @description Moves the platform app record to another organization. Requires org
+         *     owner/admin in the source org and step-up auth (`X-Auth-Confirm`,
+         *     purpose `platform.app.transfer`). End-user connections and provisioned
+         *     resources remain in their original organizations.
+         */
+        post: operations["transferPlatformAppOwnership"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/platform/apps/{appId}/rotate-key": {
         parameters: {
             query?: never;
@@ -5069,7 +5094,8 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /** Get a spend policy by ID */
+        get: operations["getSpendPolicy"];
         put?: never;
         post?: never;
         /** Delete a spend policy */
@@ -5086,7 +5112,12 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /**
+         * Get effective spend policy for a connection
+         * @description Returns the effective spend policy for the connected user, resolving
+         *     per-user overrides before app-level defaults. Requires plt_ platform auth.
+         */
+        get: operations["getConnectionSpendPolicy"];
         /**
          * Set per-user spend policy override
          * @description Override the app-wide spend policy for a specific connected user. This
@@ -5101,6 +5132,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/platform/connections/{connectionId}/approvals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List approvals for a platform connection
+         * @description Returns approvals assigned to the connection's user, filtered to agents
+         *     provisioned on the connection. Requires plt_ platform auth.
+         */
+        get: operations["listConnectionApprovals"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/platform/connections/{connectionId}/approvals/{approvalId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a connection-scoped approval */
+        get: operations["getConnectionApproval"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/platform/connections/{connectionId}/pending-approvals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List pending consensus approvals for a connection
+         * @description Returns pending approvals for agents provisioned on the connection,
+         *     including `action_payload` and `payload_hash` for consensus UX.
+         *     Requires plt_ platform auth.
+         */
+        get: operations["listConnectionPendingApprovals"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/approvals": {
         parameters: {
             query?: never;
@@ -6263,7 +6354,7 @@ export interface paths {
         /**
          * Chat with a running runtime agent
          * @description Human-only. Proxies to the runtime container's OpenAI-compatible
-         *     `POST /v1/chat/completions` (hermes / openclaw / openclaude chat bridge).
+         *     `POST /v1/chat/completions` (hermes / openclaw / openclaude / opencode chat bridge).
          *     Starts the runtime if stopped. Streams SSE when `Accept: text/event-stream`
          *     or `stream: true`. Conversation history is ephemeral (pass `messages`).
          *     Requires a public URL (shell access, Shroud sidecar, or HTTP hosting).
@@ -10469,6 +10560,28 @@ export interface components {
              */
             api_key_expires_at?: string | null;
         };
+        PlatformAppDeleteResponse: {
+            deleted: boolean;
+            soft_delete: boolean;
+            slug_released: boolean;
+            former_slug: string;
+        };
+        /** @description Provide `target_org_id` or `target_user_email` (owner/admin in destination org). */
+        TransferPlatformAppOwnershipRequest: {
+            /** Format: uuid */
+            target_org_id?: string;
+            /** Format: email */
+            target_user_email?: string;
+        };
+        TransferPlatformAppOwnershipResponse: {
+            /** Format: uuid */
+            app_id: string;
+            /** Format: uuid */
+            former_org_id: string;
+            /** Format: uuid */
+            new_org_id: string;
+            message: string;
+        };
         PlatformAppResponse: {
             /** Format: uuid */
             id?: string;
@@ -10863,6 +10976,10 @@ export interface components {
             /** Format: date-time */
             created_at: string;
         };
+        ApprovalListResponse: {
+            approvals: components["schemas"]["ApprovalResponse"][];
+            total: number;
+        };
         ApprovalStatusResponse: {
             /** @enum {string} */
             status: "pending" | "approved" | "rejected" | "expired";
@@ -19201,6 +19318,37 @@ export interface operations {
             };
         };
     };
+    transferPlatformAppOwnership: {
+        parameters: {
+            query?: never;
+            header: {
+                "X-Auth-Confirm": string;
+            };
+            path: {
+                appId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TransferPlatformAppOwnershipRequest"];
+            };
+        };
+        responses: {
+            /** @description Ownership transferred */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransferPlatformAppOwnershipResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     getPlatformAppStats: {
         parameters: {
             query?: never;
@@ -19440,6 +19588,30 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    getSpendPolicy: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                appId: string;
+                policyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Spend policy */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SpendPolicyResponse"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
     deleteSpendPolicy: {
         parameters: {
             query?: never;
@@ -19462,7 +19634,7 @@ export interface operations {
             404: components["responses"]["NotFound"];
         };
     };
-    setUserSpendPolicy: {
+    getConnectionSpendPolicy: {
         parameters: {
             query?: never;
             header?: never;
@@ -19471,13 +19643,41 @@ export interface operations {
             };
             cookie?: never;
         };
+        requestBody?: never;
+        responses: {
+            /** @description Effective spend policy (or null) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        policy?: components["schemas"]["SpendPolicyResponse"] | null;
+                    };
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    setUserSpendPolicy: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Optional replay protection; same key + body returns cached response (409 on body mismatch). */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                connectionId: string;
+            };
+            cookie?: never;
+        };
         requestBody: {
             content: {
                 "application/json": components["schemas"]["CreateSpendPolicyRequest"];
             };
         };
         responses: {
-            /** @description Spend policy set */
+            /** @description Spend policy set (or idempotent replay) */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -19486,8 +19686,104 @@ export interface operations {
                     "application/json": components["schemas"]["SpendPolicyResponse"];
                 };
             };
+            /** @description Spend policy created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SpendPolicyResponse"];
+                };
+            };
             400: components["responses"]["BadRequest"];
             403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            /** @description Idempotency-Key reused with different body */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    listConnectionApprovals: {
+        parameters: {
+            query?: {
+                status?: string;
+                risk_tier?: number;
+                limit?: number;
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                connectionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Connection-scoped approvals */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApprovalListResponse"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getConnectionApproval: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connectionId: string;
+                approvalId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Approval detail */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApprovalResponse"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    listConnectionPendingApprovals: {
+        parameters: {
+            query?: {
+                status?: string;
+                limit?: number;
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                connectionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Pending approvals list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PendingApprovalListResponse"];
+                };
+            };
+            404: components["responses"]["NotFound"];
         };
     };
     listApprovals: {