@1claw/sdk 0.44.3 → 0.46.0

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

@@ -1515,6 +1515,74 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{agent_id}/delegations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List delegations for an agent
+         * @description List all delegations where this agent is the delegator.
+         */
+        get: operations["listDelegations"];
+        put?: never;
+        /**
+         * Create a delegation
+         * @description Grant an agent (delegator) permission to delegate tasks to another agent (delegate).
+         *     Human-only — agents cannot create their own delegations.
+         */
+        post: operations["createDelegation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/agents/{agent_id}/delegations/effective": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get effective delegations
+         * @description Get the effective delegations for an agent, including daily usage statistics.
+         *     Agents can call this on their own ID to discover what they are authorized to delegate to.
+         */
+        get: operations["getEffectiveDelegations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/agents/{agent_id}/delegations/{delegation_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a specific delegation */
+        get: operations["getDelegation"];
+        put?: never;
+        post?: never;
+        /** Revoke a delegation */
+        delete: operations["revokeDelegation"];
+        options?: never;
+        head?: never;
+        /**
+         * Update a delegation
+         * @description Update delegation tools, limits, mode, or active status. Human-only.
+         */
+        patch: operations["updateDelegation"];
+        trace?: never;
+    };
     "/v1/agents/{agent_id}/sign": {
         parameters: {
             query?: never;
@@ -3221,6 +3289,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/platform/apps/{appId}/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get platform app statistics
+         * @description Returns aggregate statistics about a platform app's connected users, bootstraps, and grants.
+         */
+        get: operations["getPlatformAppStats"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/platform/apps/{appId}/rotate-webhook-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotate webhook secret
+         * @description Generate a new webhook signing secret for the platform app. The old secret is immediately invalidated. Returns the new secret (one-time).
+         */
+        post: operations["rotatePlatformWebhookSecret"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/platform/apps/{appId}/templates": {
         parameters: {
             query?: never;
@@ -4406,6 +4514,48 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/oauth/revoke": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Revoke an OAuth token (RFC 7009)
+         * @description Revokes an access token or refresh token. The authorization server
+         *     invalidates the token so it can no longer be used. Follows RFC 7009.
+         */
+        post: operations["revokeOAuthToken"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/oauth/consents/{app_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke consent for a platform app
+         * @description Revokes the user's previously granted OAuth consent for a specific platform app.
+         *     All active tokens issued to the app are invalidated and the consent record is deleted.
+         */
+        delete: operations["revokeOAuthConsent"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/risk/events": {
         parameters: {
             query?: never;
@@ -5275,7 +5425,7 @@ export interface paths {
         };
         /**
          * Public marketplace
-         * @description Browse the public platform marketplace of agents and apps.
+         * @description Browse the public platform marketplace of listed apps and agents. Returns approved platform apps with category, tags, pricing summaries, and screenshots.
          */
         get: operations["listMarketplace"];
         put?: never;
@@ -7150,6 +7300,82 @@ export interface components {
         BankrKeyLeaseListResponse: {
             leases?: components["schemas"]["BankrKeyLeaseResponse"][];
         };
+        CreateDelegationRequest: {
+            /**
+             * Format: uuid
+             * @description The agent ID to delegate to.
+             */
+            delegate_id: string;
+            /** @description Tool names the delegate may use. Empty means all tools allowed. */
+            allowed_tools?: string[];
+            /** @description Tool names the delegate may NOT use. */
+            blocked_tools?: string[];
+            /** @description Maximum delegation calls per UTC day. NULL means unlimited. */
+            max_daily_delegations?: number;
+            /**
+             * @description Maximum delegation chain depth (default 3).
+             * @default 3
+             */
+            max_depth: number;
+            /** @description Additional guardrail constraints for this delegation. */
+            guardrails?: Record<string, never>;
+            /**
+             * @description Execution mode: caller (use delegator's creds), target (use delegate's config), or both.
+             * @default caller
+             * @enum {string}
+             */
+            delegation_mode: "caller" | "target" | "both";
+            /**
+             * Format: date-time
+             * @description Optional expiration timestamp.
+             */
+            expires_at?: string;
+        };
+        UpdateDelegationRequest: {
+            allowed_tools?: string[];
+            blocked_tools?: string[];
+            max_daily_delegations?: number;
+            max_depth?: number;
+            guardrails?: Record<string, never>;
+            /** @enum {string} */
+            delegation_mode?: "caller" | "target" | "both";
+            is_active?: boolean;
+            /** Format: date-time */
+            expires_at?: string | null;
+        };
+        DelegationResponse: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            org_id?: string;
+            /** Format: uuid */
+            delegator_id?: string;
+            /** Format: uuid */
+            delegate_id?: string;
+            delegator_name?: string;
+            delegate_name?: string;
+            allowed_tools?: string[];
+            blocked_tools?: string[];
+            max_daily_delegations?: number | null;
+            max_depth?: number;
+            guardrails?: Record<string, never>;
+            /** @enum {string} */
+            delegation_mode?: "caller" | "target" | "both";
+            is_active?: boolean;
+            /** Format: uuid */
+            created_by?: string;
+            /** Format: date-time */
+            expires_at?: string | null;
+            /** Format: date-time */
+            created_at?: string;
+            /** Format: date-time */
+            updated_at?: string;
+            /** @description Number of delegations used today (present in effective endpoint). */
+            delegations_today?: number;
+        };
+        DelegationListResponse: {
+            delegations?: components["schemas"]["DelegationResponse"][];
+        };
         SignIntentRequest: {
             /** @enum {string} */
             intent_type: "personal_sign" | "typed_data" | "eip712_digest" | "transaction";
@@ -8238,6 +8464,8 @@ export interface components {
                 vault_id?: string | null;
                 /** Format: uuid */
                 agent_id?: string | null;
+                /** @description All agent IDs provisioned by the template (when multiple agents are defined) */
+                agent_ids?: string[];
                 policy_ids?: string[];
                 /** @description Chains with provisioned signing keys */
                 signing_key_chains?: string[];
@@ -8258,6 +8486,32 @@ export interface components {
                 automation_ids?: string[];
             };
         };
+        PlatformAppStatsResponse: {
+            /** @description Total number of user connections (all statuses) */
+            total_connections: number;
+            /** @description Number of active connections */
+            active_connections: number;
+            /** @description Number of claimed connections */
+            claimed_connections: number;
+            /** @description Total bootstrap operations performed */
+            total_bootstraps: number;
+            /** @description Total resource grants issued */
+            total_grants: number;
+        };
+        MarketplaceResponse: {
+            apps?: {
+                /** Format: uuid */
+                id?: string;
+                name?: string;
+                slug?: string;
+                description?: string;
+                logo_url?: string | null;
+                category?: string | null;
+                listing_tags?: string[];
+                listing_screenshots?: string[];
+                pricing_summary?: string | null;
+            }[];
+        };
         ConnectedAppResponse: {
             /** Format: uuid */
             connection_id?: string;
@@ -8463,6 +8717,8 @@ export interface components {
             token_type: "Bearer";
             /** @description Token lifetime in seconds */
             expires_in: number;
+            /** @description Refresh token for obtaining new access tokens (when offline_access scope was granted) */
+            refresh_token?: string | null;
             /** @description OIDC ID token (when openid scope was granted) */
             id_token?: string | null;
             scope: string;
@@ -9171,6 +9427,19 @@ export interface components {
             config: {
                 [key: string]: string;
             };
+            /**
+             * @description Enable Hermes-compatible slash commands on this channel. When true,
+             *     messages starting with `/` are handled before the LLM. Commands:
+             *     /help, /new, /reset, /clear, /model, /mode, /personality, /retry,
+             *     /undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.
+             */
+            slash_commands_enabled?: boolean;
+            /** @description Enable voice message transcription */
+            voice_transcription_enabled?: boolean;
+            /** @description List of allowed sender IDs */
+            sender_allowlist?: string[];
+            /** @description Enable auto-respond */
+            auto_respond_enabled?: boolean;
         };
         UpdateChannelRequest: {
             channel_name?: string;
@@ -9178,6 +9447,10 @@ export interface components {
             config?: {
                 [key: string]: string;
             };
+            slash_commands_enabled?: boolean;
+            voice_transcription_enabled?: boolean;
+            sender_allowlist?: string[];
+            auto_respond_enabled?: boolean;
         };
         ChannelResponse: {
             /** Format: uuid */
@@ -9200,6 +9473,25 @@ export interface components {
             config?: {
                 [key: string]: unknown;
             } | null;
+            /**
+             * @description Whether Hermes-compatible slash commands are enabled for this channel.
+             *     Commands: /help, /new, /reset, /clear, /model, /mode, /personality, /retry,
+             *     /undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.
+             */
+            slash_commands_enabled?: boolean;
+            /** @description Whether voice message transcription is enabled */
+            voice_transcription_enabled?: boolean;
+            /**
+             * Format: uuid
+             * @description ID linking this channel to a unified cross-platform conversation
+             */
+            unified_conversation_id?: string | null;
+            /** @description Whether this is the agent's home platform channel */
+            is_home_platform?: boolean;
+            /** @description List of allowed sender IDs for auto-respond */
+            sender_allowlist?: string[] | null;
+            /** @description Whether auto-respond is enabled for this channel */
+            auto_respond_enabled?: boolean;
             /** Format: date-time */
             created_at?: string;
             /** Format: date-time */
@@ -9227,6 +9519,17 @@ export interface components {
             sender_name?: string;
             content?: string;
             media_url?: string;
+            /** @description Whether this message was a voice message */
+            is_voice_message?: boolean;
+            /** @description Telegram voice file ID */
+            voice_file_id?: string | null;
+            /** @description Duration of voice message in seconds */
+            voice_duration_secs?: number | null;
+            /**
+             * @description Status of voice transcription
+             * @enum {string|null}
+             */
+            transcription_status?: "pending" | "completed" | "failed" | null;
             /** Format: date-time */
             created_at?: string;
         };
@@ -11878,6 +12181,165 @@ export interface operations {
             404: components["responses"]["NotFound"];
         };
     };
+    listDelegations: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: components["parameters"]["AgentId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of delegations */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DelegationListResponse"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    createDelegation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: components["parameters"]["AgentId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateDelegationRequest"];
+            };
+        };
+        responses: {
+            /** @description Delegation created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DelegationResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            /** @description Delegation already exists for this delegator/delegate pair */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    getEffectiveDelegations: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: components["parameters"]["AgentId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Effective delegations with usage stats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DelegationListResponse"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getDelegation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: components["parameters"]["AgentId"];
+                delegation_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Delegation details */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DelegationResponse"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    revokeDelegation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: components["parameters"]["AgentId"];
+                delegation_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Delegation revoked */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    updateDelegation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: components["parameters"]["AgentId"];
+                delegation_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateDelegationRequest"];
+            };
+        };
+        responses: {
+            /** @description Delegation updated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DelegationResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     signIntent: {
         parameters: {
             query?: never;
@@ -14118,6 +14580,64 @@ export interface operations {
             };
         };
     };
+    getPlatformAppStats: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                appId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description App statistics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlatformAppStatsResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    rotatePlatformWebhookSecret: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                appId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description New webhook secret generated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description The new webhook signing secret (shown once) */
+                        webhook_secret: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Only human users can rotate webhook secrets */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
     deletePlatformTemplate: {
         parameters: {
             query?: never;
@@ -15049,6 +15569,71 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    revokeOAuthToken: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description The token to revoke (access_token or refresh_token) */
+                    token: string;
+                    /**
+                     * @description Hint about the type of token being revoked
+                     * @enum {string}
+                     */
+                    token_type_hint?: "access_token" | "refresh_token";
+                };
+            };
+        };
+        responses: {
+            /** @description Token revoked successfully (or was already invalid) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example true */
+                        revoked?: boolean;
+                    };
+                };
+            };
+        };
+    };
+    revokeOAuthConsent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The platform app ID whose consent to revoke */
+                app_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Consent revoked */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example true */
+                        revoked?: boolean;
+                        /** Format: uuid */
+                        app_id?: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     listRiskEvents: {
         parameters: {
             query?: {
@@ -16485,6 +17070,8 @@ export interface operations {
                 per_page?: number;
                 /** @description Search query */
                 q?: string;
+                /** @description Filter by app category */
+                category?: string;
             };
             header?: never;
             path?: never;
@@ -16498,7 +17085,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["DirectoryResponse"];
+                    "application/json": components["schemas"]["MarketplaceResponse"];
                 };
             };
         };