@seclai/sdk 1.1.0 → 1.1.1

package/dist/index.d.ts

@@ -360,6 +360,39 @@ interface components {
              */
             total: number;
         };
+        /**
+         * AiAssistantAcceptResponse
+         * @description Response from accepting and executing a plan.
+         */
+        AiAssistantAcceptResponse: {
+            /**
+             * Conversation Id
+             * Format: uuid
+             * @description Conversation ID.
+             */
+            conversation_id: string;
+            /**
+             * Error
+             * @description Error message if failed.
+             */
+            error?: string | null;
+            /**
+             * Executed Actions
+             * @description Results of each executed action.
+             */
+            executed_actions: components["schemas"]["ExecutedActionResponse"][];
+            /**
+             * Solution Id
+             * @description Solution ID when a new solution was auto-created.
+             */
+            solution_id?: string | null;
+            /**
+             * Success
+             * @description Whether execution succeeded.
+             * @default true
+             */
+            success: boolean;
+        };
         /**
          * AiAssistantFeedbackResponse
          * @description Response after submitting feedback.
@@ -386,6 +419,45 @@ interface components {
              */
             user_input: string;
         };
+        /**
+         * AiAssistantGenerateResponse
+         * @description Response from an AI assistant generate endpoint.
+         */
+        AiAssistantGenerateResponse: {
+            /**
+             * Conversation Id
+             * Format: uuid
+             * @description Conversation ID for accept/decline.
+             */
+            conversation_id: string;
+            /**
+             * Example Prompts
+             * @description Example natural-language prompts that demonstrate the capabilities of this AI assistant.
+             */
+            example_prompts?: components["schemas"]["ExamplePrompt"][];
+            /**
+             * Note
+             * @description AI-generated note about the plan.
+             */
+            note: string;
+            /**
+             * Proposed Actions
+             * @description List of proposed actions.
+             */
+            proposed_actions: components["schemas"]["ProposedActionResponse"][];
+            /**
+             * Requires Delete Confirmation
+             * @description Whether destructive actions require explicit confirmation.
+             * @default false
+             */
+            requires_delete_confirmation: boolean;
+            /**
+             * Success
+             * @description Whether plan generation succeeded.
+             * @default false
+             */
+            success: boolean;
+        };
         /** AiConversationHistoryResponse */
         AiConversationHistoryResponse: {
             /**
@@ -439,6 +511,37 @@ interface components {
              */
             user_input: string;
         };
+        /**
+         * AppliedActionResponse
+         * @description Result of a single executed governance action.
+         */
+        AppliedActionResponse: {
+            /**
+             * Action Type
+             * @description Type of action that was executed.
+             */
+            action_type: string;
+            /**
+             * Description
+             * @description Human-readable description of the executed action.
+             */
+            description: string;
+            /**
+             * Error
+             * @description Error message if this action failed, or null.
+             */
+            error?: string | null;
+            /**
+             * Policy Id
+             * @description ID of the policy that was created or modified, or null.
+             */
+            policy_id?: string | null;
+            /**
+             * Success
+             * @description Whether this individual action succeeded.
+             */
+            success: boolean;
+        };
         /** Body_upload_file_to_content_api_contents__source_connection_content_version__upload_post */
         Body_upload_file_to_content_api_contents__source_connection_content_version__upload_post: {
             /**
@@ -1179,6 +1282,43 @@ interface components {
         ExamplePrompt: {
             [key: string]: string;
         };
+        /**
+         * ExecutedActionResponse
+         * @description A single executed action result.
+         */
+        ExecutedActionResponse: {
+            /**
+             * Action Type
+             * @description Type of the executed action.
+             */
+            action_type: string;
+            /**
+             * Description
+             * @description Human-readable description.
+             */
+            description: string;
+            /**
+             * Error
+             * @description Error message if failed.
+             */
+            error?: string | null;
+            /**
+             * Resource Id
+             * @description ID of the affected resource.
+             */
+            resource_id?: string | null;
+            /**
+             * Resource Type
+             * @description Type of the affected resource.
+             */
+            resource_type?: string | null;
+            /**
+             * Success
+             * @description Whether the action succeeded.
+             * @default true
+             */
+            success: boolean;
+        };
         /**
          * ExportFormat
          * @description Supported export file formats.
@@ -1329,6 +1469,68 @@ interface components {
              */
             success: boolean;
         };
+        /**
+         * GovernanceAiAcceptResponse
+         * @description Response from accepting a governance AI assistant plan.
+         */
+        GovernanceAiAcceptResponse: {
+            /**
+             * Actions Applied
+             * @description Results of each action that was executed.
+             */
+            actions_applied: components["schemas"]["AppliedActionResponse"][];
+            /**
+             * Conversation Id
+             * @description Conversation ID that was accepted.
+             */
+            conversation_id: string;
+            /**
+             * Error
+             * @description Overall error message if the plan failed, or null.
+             */
+            error?: string | null;
+            /**
+             * Success
+             * @description Whether all actions were applied successfully.
+             */
+            success: boolean;
+        };
+        /**
+         * GovernanceAiAssistantResponse
+         * @description Response from the governance AI assistant generate endpoint.
+         */
+        GovernanceAiAssistantResponse: {
+            /**
+             * Conversation Id
+             * @description Conversation ID to accept or decline this plan.
+             */
+            conversation_id: string;
+            /**
+             * Example Prompts
+             * @description Example natural-language prompts that demonstrate the capabilities of the governance AI assistant.
+             */
+            example_prompts?: components["schemas"]["ExamplePrompt"][];
+            /**
+             * Note
+             * @description AI-generated summary of the proposed changes.
+             */
+            note: string;
+            /**
+             * Prompt Call Id
+             * @description Prompt call ID for credit tracking, or null.
+             */
+            prompt_call_id?: string | null;
+            /**
+             * Proposed Actions
+             * @description Ordered list of policy actions the AI proposes to execute.
+             */
+            proposed_actions: components["schemas"]["ProposedPolicyActionResponse"][];
+            /**
+             * Success
+             * @description Whether the plan was generated successfully.
+             */
+            success: boolean;
+        };
         /** HTTPValidationError */
         HTTPValidationError: {
             /** Detail */
@@ -1505,6 +1707,91 @@ interface components {
              */
             accepted: boolean;
         };
+        /**
+         * MemoryBankAiAssistantResponse
+         * @description Response from the memory bank AI assistant.
+         */
+        MemoryBankAiAssistantResponse: {
+            /** @description Proposed configuration, or null. */
+            config?: components["schemas"]["MemoryBankConfigResponse"] | null;
+            /**
+             * Conversation Id
+             * @description Conversation ID for follow-up.
+             */
+            conversation_id: string;
+            /**
+             * Example Prompts
+             * @description Example natural-language prompts that demonstrate the capabilities of the memory bank AI assistant.
+             */
+            example_prompts?: components["schemas"]["ExamplePrompt"][];
+            /**
+             * Note
+             * @description AI-generated explanation.
+             */
+            note: string;
+            /**
+             * Prompt Call Id
+             * @description Prompt call ID for credit tracking.
+             */
+            prompt_call_id?: string | null;
+            /**
+             * Success
+             * @description Whether generation succeeded.
+             * @default false
+             */
+            success: boolean;
+        };
+        /**
+         * MemoryBankConfigResponse
+         * @description Suggested memory bank configuration from the AI assistant.
+         */
+        MemoryBankConfigResponse: {
+            /**
+             * Compaction Prompt
+             * @description Suggested compaction prompt.
+             */
+            compaction_prompt?: string | null;
+            /**
+             * Description
+             * @description Suggested description.
+             */
+            description?: string | null;
+            /**
+             * Max Age Days
+             * @description Max age in days.
+             */
+            max_age_days?: number | null;
+            /**
+             * Max Size Tokens
+             * @description Max size in tokens.
+             */
+            max_size_tokens?: number | null;
+            /**
+             * Max Turns
+             * @description Max conversation turns.
+             */
+            max_turns?: number | null;
+            /**
+             * Mode
+             * @description Memory bank mode.
+             */
+            mode: string;
+            /**
+             * Name
+             * @description Suggested name.
+             */
+            name: string;
+            /**
+             * Retention Days
+             * @description Retention in days.
+             */
+            retention_days?: number | null;
+            /**
+             * Type
+             * @description Memory bank type: conversation or general.
+             */
+            type: string;
+        };
         /**
          * MemoryBankListResponseModel
          * @description Paginated list of memory banks.
@@ -1657,6 +1944,58 @@ interface components {
          * @enum {string}
          */
         PromptModelAutoUpgradeStrategy: "none" | "early_adopter" | "middle_of_road" | "cautious_adopter";
+        /**
+         * ProposedActionResponse
+         * @description A single proposed action.
+         */
+        ProposedActionResponse: {
+            /**
+             * Action Type
+             * @description Type of the proposed action.
+             */
+            action_type: string;
+            /**
+             * Description
+             * @description Human-readable description of the action.
+             */
+            description: string;
+            /**
+             * Is Destructive
+             * @description Whether the action is destructive.
+             * @default false
+             */
+            is_destructive: boolean;
+            /**
+             * Params
+             * @description Parameters for the action.
+             */
+            params: {
+                [key: string]: unknown;
+            };
+        };
+        /**
+         * ProposedPolicyActionResponse
+         * @description A single proposed governance policy action.
+         */
+        ProposedPolicyActionResponse: {
+            /**
+             * Action Type
+             * @description Type of action: create, update, delete, enable, or disable.
+             */
+            action_type: string;
+            /**
+             * Description
+             * @description Human-readable description of what this action will do.
+             */
+            description: string;
+            /**
+             * Params
+             * @description Parameters for the action (e.g. policy_document_id, thresholds).
+             */
+            params: {
+                [key: string]: unknown;
+            };
+        };
         /** SolutionSourceConnectionResponse */
         SolutionSourceConnectionResponse: {
             /**
@@ -2723,63 +3062,6 @@ interface components {
              */
             status: string;
         };
-        /**
-         * AppliedActionResponse
-         * @description Result of a single executed governance action.
-         */
-        routers__api__governance__AppliedActionResponse: {
-            /**
-             * Action Type
-             * @description Type of action that was executed.
-             */
-            action_type: string;
-            /**
-             * Description
-             * @description Human-readable description of the executed action.
-             */
-            description: string;
-            /**
-             * Error
-             * @description Error message if this action failed, or null.
-             */
-            error?: string | null;
-            /**
-             * Policy Id
-             * @description ID of the policy that was created or modified, or null.
-             */
-            policy_id?: string | null;
-            /**
-             * Success
-             * @description Whether this individual action succeeded.
-             */
-            success: boolean;
-        };
-        /**
-         * GovernanceAiAcceptResponse
-         * @description Response from accepting a governance AI assistant plan.
-         */
-        routers__api__governance__GovernanceAiAcceptResponse: {
-            /**
-             * Actions Applied
-             * @description Results of each action that was executed.
-             */
-            actions_applied: components["schemas"]["routers__api__governance__AppliedActionResponse"][];
-            /**
-             * Conversation Id
-             * @description Conversation ID that was accepted.
-             */
-            conversation_id: string;
-            /**
-             * Error
-             * @description Overall error message if the plan failed, or null.
-             */
-            error?: string | null;
-            /**
-             * Success
-             * @description Whether all actions were applied successfully.
-             */
-            success: boolean;
-        };
         /**
          * GovernanceAiAssistantRequest
          * @description Request body for the governance AI assistant.
@@ -2791,42 +3073,6 @@ interface components {
              */
             user_input: string;
         };
-        /**
-         * GovernanceAiAssistantResponse
-         * @description Response from the governance AI assistant generate endpoint.
-         */
-        routers__api__governance__GovernanceAiAssistantResponse: {
-            /**
-             * Conversation Id
-             * @description Conversation ID to accept or decline this plan.
-             */
-            conversation_id: string;
-            /**
-             * Example Prompts
-             * @description Example natural-language prompts that demonstrate the capabilities of the governance AI assistant.
-             */
-            example_prompts?: components["schemas"]["ExamplePrompt"][];
-            /**
-             * Note
-             * @description AI-generated summary of the proposed changes.
-             */
-            note: string;
-            /**
-             * Prompt Call Id
-             * @description Prompt call ID for credit tracking, or null.
-             */
-            prompt_call_id?: string | null;
-            /**
-             * Proposed Actions
-             * @description Ordered list of policy actions the AI proposes to execute.
-             */
-            proposed_actions: components["schemas"]["routers__api__governance__ProposedPolicyActionResponse"][];
-            /**
-             * Success
-             * @description Whether the plan was generated successfully.
-             */
-            success: boolean;
-        };
         /**
          * GovernanceConversationResponse
          * @description A governance AI assistant conversation entry.
@@ -2851,42 +3097,19 @@ interface components {
              * Id
              * @description Conversation ID.
              */
-            id: string;
-            /**
-             * Proposed Actions
-             * @description JSON of proposed actions, or null.
-             */
-            proposed_actions: {
-                [key: string]: unknown;
-            } | null;
-            /**
-             * User Input
-             * @description The original user request.
-             */
-            user_input: string;
-        };
-        /**
-         * ProposedPolicyActionResponse
-         * @description A single proposed governance policy action.
-         */
-        routers__api__governance__ProposedPolicyActionResponse: {
-            /**
-             * Action Type
-             * @description Type of action: create, update, delete, enable, or disable.
-             */
-            action_type: string;
-            /**
-             * Description
-             * @description Human-readable description of what this action will do.
-             */
-            description: string;
+            id: string;
             /**
-             * Params
-             * @description Parameters for the action (e.g. policy_document_id, thresholds).
+             * Proposed Actions
+             * @description JSON of proposed actions, or null.
              */
-            params: {
+            proposed_actions: {
                 [key: string]: unknown;
-            };
+            } | null;
+            /**
+             * User Input
+             * @description The original user request.
+             */
+            user_input: string;
         };
         /**
          * MemoryBankAcceptRequest
@@ -2922,91 +3145,6 @@ interface components {
              */
             user_input: string;
         };
-        /**
-         * MemoryBankAiAssistantResponse
-         * @description Response from the memory bank AI assistant.
-         */
-        routers__api__memory_banks__MemoryBankAiAssistantResponse: {
-            /** @description Proposed configuration, or null. */
-            config?: components["schemas"]["routers__api__memory_banks__MemoryBankConfigResponse"] | null;
-            /**
-             * Conversation Id
-             * @description Conversation ID for follow-up.
-             */
-            conversation_id: string;
-            /**
-             * Example Prompts
-             * @description Example natural-language prompts that demonstrate the capabilities of the memory bank AI assistant.
-             */
-            example_prompts?: components["schemas"]["ExamplePrompt"][];
-            /**
-             * Note
-             * @description AI-generated explanation.
-             */
-            note: string;
-            /**
-             * Prompt Call Id
-             * @description Prompt call ID for credit tracking.
-             */
-            prompt_call_id?: string | null;
-            /**
-             * Success
-             * @description Whether generation succeeded.
-             * @default false
-             */
-            success: boolean;
-        };
-        /**
-         * MemoryBankConfigResponse
-         * @description Suggested memory bank configuration from the AI assistant.
-         */
-        routers__api__memory_banks__MemoryBankConfigResponse: {
-            /**
-             * Compaction Prompt
-             * @description Suggested compaction prompt.
-             */
-            compaction_prompt?: string | null;
-            /**
-             * Description
-             * @description Suggested description.
-             */
-            description?: string | null;
-            /**
-             * Max Age Days
-             * @description Max age in days.
-             */
-            max_age_days?: number | null;
-            /**
-             * Max Size Tokens
-             * @description Max size in tokens.
-             */
-            max_size_tokens?: number | null;
-            /**
-             * Max Turns
-             * @description Max conversation turns.
-             */
-            max_turns?: number | null;
-            /**
-             * Mode
-             * @description Memory bank mode.
-             */
-            mode: string;
-            /**
-             * Name
-             * @description Suggested name.
-             */
-            name: string;
-            /**
-             * Retention Days
-             * @description Retention in days.
-             */
-            retention_days?: number | null;
-            /**
-             * Type
-             * @description Memory bank type: conversation or general.
-             */
-            type: string;
-        };
         /**
          * MemoryBankConversationTurnResponse
          * @description A single turn of memory bank AI assistant conversation.
@@ -3094,144 +3232,6 @@ interface components {
              */
             solution_name?: string | null;
         };
-        /**
-         * AiAssistantAcceptResponse
-         * @description Response from accepting and executing a plan.
-         */
-        routers__api__solutions__AiAssistantAcceptResponse: {
-            /**
-             * Conversation Id
-             * Format: uuid
-             * @description Conversation ID.
-             */
-            conversation_id: string;
-            /**
-             * Error
-             * @description Error message if failed.
-             */
-            error?: string | null;
-            /**
-             * Executed Actions
-             * @description Results of each executed action.
-             */
-            executed_actions: components["schemas"]["routers__api__solutions__ExecutedActionResponse"][];
-            /**
-             * Solution Id
-             * @description Solution ID when a new solution was auto-created.
-             */
-            solution_id?: string | null;
-            /**
-             * Success
-             * @description Whether execution succeeded.
-             * @default true
-             */
-            success: boolean;
-        };
-        /**
-         * AiAssistantGenerateResponse
-         * @description Response from an AI assistant generate endpoint.
-         */
-        routers__api__solutions__AiAssistantGenerateResponse: {
-            /**
-             * Conversation Id
-             * Format: uuid
-             * @description Conversation ID for accept/decline.
-             */
-            conversation_id: string;
-            /**
-             * Example Prompts
-             * @description Example natural-language prompts that demonstrate the capabilities of this AI assistant.
-             */
-            example_prompts?: components["schemas"]["ExamplePrompt"][];
-            /**
-             * Note
-             * @description AI-generated note about the plan.
-             */
-            note: string;
-            /**
-             * Proposed Actions
-             * @description List of proposed actions.
-             */
-            proposed_actions: components["schemas"]["routers__api__solutions__ProposedActionResponse"][];
-            /**
-             * Requires Delete Confirmation
-             * @description Whether destructive actions require explicit confirmation.
-             * @default false
-             */
-            requires_delete_confirmation: boolean;
-            /**
-             * Success
-             * @description Whether plan generation succeeded.
-             * @default false
-             */
-            success: boolean;
-        };
-        /**
-         * ExecutedActionResponse
-         * @description A single executed action result.
-         */
-        routers__api__solutions__ExecutedActionResponse: {
-            /**
-             * Action Type
-             * @description Type of the executed action.
-             */
-            action_type: string;
-            /**
-             * Description
-             * @description Human-readable description.
-             */
-            description: string;
-            /**
-             * Error
-             * @description Error message if failed.
-             */
-            error?: string | null;
-            /**
-             * Resource Id
-             * @description ID of the affected resource.
-             */
-            resource_id?: string | null;
-            /**
-             * Resource Type
-             * @description Type of the affected resource.
-             */
-            resource_type?: string | null;
-            /**
-             * Success
-             * @description Whether the action succeeded.
-             * @default true
-             */
-            success: boolean;
-        };
-        /**
-         * ProposedActionResponse
-         * @description A single proposed action.
-         */
-        routers__api__solutions__ProposedActionResponse: {
-            /**
-             * Action Type
-             * @description Type of the proposed action.
-             */
-            action_type: string;
-            /**
-             * Description
-             * @description Human-readable description of the action.
-             */
-            description: string;
-            /**
-             * Is Destructive
-             * @description Whether the action is destructive.
-             * @default false
-             */
-            is_destructive: boolean;
-            /**
-             * Params
-             * @description Parameters for the action.
-             */
-            params: {
-                [key: string]: unknown;
-            };
-        };
         /** SolutionAgentResponse */
         routers__api__solutions__SolutionAgentResponse: {
             /**
@@ -3638,7 +3638,10 @@ interface components {
         };
     };
     responses: never;
-    parameters: never;
+    parameters: {
+        /** @description Target a different organization account. When omitted, the user's default account is used. For API key authentication the key's account is always used; the header is accepted but has no effect. */
+        "X-Account-Id": string;
+    };
     requestBodies: never;
     headers: never;
     pathItems: never;
@@ -3769,11 +3772,11 @@ type UpdateMemoryBankBody = components["schemas"]["UpdateMemoryBankBody"];
 /** Memory bank AI assistant request. */
 type MemoryBankAiAssistantRequest = components["schemas"]["routers__api__memory_banks__MemoryBankAiAssistantRequest"];
 /** Memory bank AI assistant response. */
-type MemoryBankAiAssistantResponse = components["schemas"]["routers__api__memory_banks__MemoryBankAiAssistantResponse"];
+type MemoryBankAiAssistantResponse = components["schemas"]["MemoryBankAiAssistantResponse"];
 /** Memory bank AI accept request. */
 type MemoryBankAcceptRequest = components["schemas"]["routers__api__memory_banks__MemoryBankAcceptRequest"];
 /** Memory bank configuration generated by AI. */
-type MemoryBankConfigResponse = components["schemas"]["routers__api__memory_banks__MemoryBankConfigResponse"];
+type MemoryBankConfigResponse = components["schemas"]["MemoryBankConfigResponse"];
 /** Last conversation for a memory bank AI assistant. */
 type MemoryBankLastConversationResponse = components["schemas"]["routers__api__memory_banks__MemoryBankLastConversationResponse"];
 /** Individual turn in a memory bank AI conversation. */
@@ -3851,15 +3854,15 @@ type MarkConversationTurnRequest = components["schemas"]["MarkConversationTurnRe
 /** AI assistant generate request for solutions. */
 type AiAssistantGenerateRequest = components["schemas"]["AiAssistantGenerateRequest"];
 /** AI assistant generate response for solutions. */
-type AiAssistantGenerateResponse = components["schemas"]["routers__api__solutions__AiAssistantGenerateResponse"];
+type AiAssistantGenerateResponse = components["schemas"]["AiAssistantGenerateResponse"];
 /** AI assistant accept request for solutions. */
 type AiAssistantAcceptRequest = components["schemas"]["routers__api__solutions__AiAssistantAcceptRequest"];
 /** AI assistant accept response for solutions. */
-type AiAssistantAcceptResponse = components["schemas"]["routers__api__solutions__AiAssistantAcceptResponse"];
+type AiAssistantAcceptResponse = components["schemas"]["AiAssistantAcceptResponse"];
 /** Proposed action in a solution AI plan. */
-type ProposedActionResponse = components["schemas"]["routers__api__solutions__ProposedActionResponse"];
+type ProposedActionResponse = components["schemas"]["ProposedActionResponse"];
 /** Executed action in a solution AI plan. */
-type ExecutedActionResponse = components["schemas"]["routers__api__solutions__ExecutedActionResponse"];
+type ExecutedActionResponse = components["schemas"]["ExecutedActionResponse"];
 /** Request body for linking resources (agents, KBs, sources) to a parent. */
 type LinkResourcesRequest = components["schemas"]["LinkResourcesRequest"];
 /** Request body for unlinking resources from a parent. */
@@ -3867,15 +3870,15 @@ type UnlinkResourcesRequest = components["schemas"]["UnlinkResourcesRequest"];
 /** Governance AI assistant request. */
 type GovernanceAiAssistantRequest = components["schemas"]["routers__api__governance__GovernanceAiAssistantRequest"];
 /** Governance AI assistant response. */
-type GovernanceAiAssistantResponse = components["schemas"]["routers__api__governance__GovernanceAiAssistantResponse"];
+type GovernanceAiAssistantResponse = components["schemas"]["GovernanceAiAssistantResponse"];
 /** Governance AI accept response. */
-type GovernanceAiAcceptResponse = components["schemas"]["routers__api__governance__GovernanceAiAcceptResponse"];
+type GovernanceAiAcceptResponse = components["schemas"]["GovernanceAiAcceptResponse"];
 /** Governance conversation turn. */
 type GovernanceConversationResponse = components["schemas"]["routers__api__governance__GovernanceConversationResponse"];
 /** Proposed policy action from governance AI. */
-type GovernanceProposedPolicyActionResponse = components["schemas"]["routers__api__governance__ProposedPolicyActionResponse"];
+type GovernanceProposedPolicyActionResponse = components["schemas"]["ProposedPolicyActionResponse"];
 /** Applied policy action from governance AI. */
-type GovernanceAppliedActionResponse = components["schemas"]["routers__api__governance__AppliedActionResponse"];
+type GovernanceAppliedActionResponse = components["schemas"]["AppliedActionResponse"];
 /** Request body for creating an alert config. */
 type CreateAlertConfigRequest = components["schemas"]["CreateAlertConfigRequest"];
 /** Request body for updating an alert config. */
@@ -3924,10 +3927,20 @@ interface SortableListOptions extends ListOptions {
 declare const SECLAI_API_URL = "https://api.seclai.com";
 /** A `fetch`-compatible function (e.g. `globalThis.fetch` or `undici.fetch`). */
 type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Token provider: a synchronous or asynchronous function that returns an
+ * access token string.  Called on every request to allow automatic refresh.
+ */
+type AccessTokenProvider = () => string | Promise<string>;
 /** Configuration for the {@link Seclai} client. */
 interface SeclaiOptions {
     /** API key used for authentication. Defaults to `process.env.SECLAI_API_KEY` when available. */
     apiKey?: string;
+    /**
+     * Static bearer access token **or** a provider function that returns one.
+     * Mutually exclusive with `apiKey`.
+     */
+    accessToken?: string | AccessTokenProvider;
     /** API base URL. Defaults to `process.env.SECLAI_API_URL` when available, else {@link SECLAI_API_URL}. */
     baseUrl?: string;
     /** Header name to use for the API key. Defaults to `x-api-key`. */
@@ -3936,6 +3949,25 @@ interface SeclaiOptions {
     defaultHeaders?: Record<string, string>;
     /** Optional `fetch` implementation for environments without a global `fetch`. */
     fetch?: FetchLike;
+    /**
+     * SSO profile name to load from `~/.seclai/config`.
+     * Defaults to `process.env.SECLAI_PROFILE`, then `"default"`.
+     */
+    profile?: string;
+    /**
+     * Override the config directory path (default: `SECLAI_CONFIG_DIR` env var or `~/.seclai/`).
+     */
+    configDir?: string;
+    /**
+     * Whether to auto-refresh expired SSO tokens. Defaults to `true`.
+     * Set to `false` in environments that should not write to disk.
+     */
+    autoRefresh?: boolean;
+    /**
+     * Target organization account ID. Sent as `X-Account-Id` header.
+     * Overrides the profile's `sso_account_id` when using SSO auth.
+     */
+    accountId?: string;
 }
 /**
  * Seclai JavaScript/TypeScript client.
@@ -3962,19 +3994,30 @@ interface SeclaiOptions {
  * ```
  */
 declare class Seclai {
-    private readonly apiKey;
     private readonly baseUrl;
-    private readonly apiKeyHeader;
     private readonly defaultHeaders;
     private readonly fetcher;
+    private _authState;
+    private _authInitPromise;
+    private _authInitError;
     /**
      * Create a new Seclai client.
      *
+     * Credentials are resolved via a chain (first match wins):
+     * 1. Explicit `apiKey` option
+     * 2. Explicit `accessToken` option (static string or provider function)
+     * 3. `SECLAI_API_KEY` environment variable
+     * 4. SSO profile from `~/.seclai/config` + cached tokens in `~/.seclai/sso/cache/`
+     *
      * @param opts - Client configuration.
-     * @throws {@link SeclaiConfigurationError} If no API key is provided (and `SECLAI_API_KEY` is not set).
      * @throws {@link SeclaiConfigurationError} If no `fetch` implementation is available.
+     * @throws {@link SeclaiConfigurationError} If both `apiKey` and `accessToken` are provided.
      */
     constructor(opts?: SeclaiOptions);
+    /** Ensure the credential chain has been resolved. */
+    private ensureAuth;
+    /** Resolve auth headers for the current request. */
+    private authHeaders;
     /**
      * Make a raw HTTP request to the Seclai API.
      *
@@ -4000,6 +4043,8 @@ declare class Seclai {
      * @param path - Request path relative to `baseUrl`.
      * @param opts - Query params, JSON body, per-request headers, and optional AbortSignal.
      * @returns The raw `Response` object.
+     * @throws {SeclaiAPIValidationError} On HTTP 422 responses.
+     * @throws {SeclaiAPIStatusError} On other non-2xx responses.
      */
     requestRaw(method: string, path: string, opts?: {
         query?: Record<string, unknown>;
@@ -5031,6 +5076,73 @@ declare class Seclai {
     }): AsyncGenerator<T, void, undefined>;
 }
 
+/**
+ * @module
+ *
+ * SSO credential resolution: config file parsing, token caching, and automatic
+ * token refresh against AWS Cognito.
+ *
+ * @internal — not part of the public API surface. Consumed by {@link Seclai}.
+ */
+
+/** Resolved SSO profile settings. */
+interface SsoProfile {
+    ssoAccountId: string;
+    ssoRegion: string;
+    ssoClientId: string;
+    ssoDomain: string;
+}
+/** Contents of a single SSO cache file. */
+interface SsoCacheEntry {
+    accessToken: string;
+    refreshToken?: string;
+    idToken?: string | undefined;
+    expiresAt: string;
+    clientId: string;
+    region: string;
+    cognitoDomain: string;
+}
+/** Options for resolving the credential chain. */
+interface CredentialChainOptions {
+    /** Explicit API key (highest priority). */
+    apiKey?: string | undefined;
+    /** Explicit static bearer token. */
+    accessToken?: string | undefined;
+    /** Dynamic bearer token provider. */
+    accessTokenProvider?: (() => string | Promise<string>) | undefined;
+    /** Name of the profile from ~/.seclai/config. */
+    profile?: string | undefined;
+    /** Override config directory path. */
+    configDir?: string | undefined;
+    /** Whether to auto-refresh expired SSO tokens. Defaults to true. */
+    autoRefresh?: boolean | undefined;
+    /** Account ID override (takes precedence over profile's sso_account_id). */
+    accountId?: string | undefined;
+    /** Header name for API key auth. */
+    apiKeyHeader?: string | undefined;
+    /** fetch implementation for token refresh. */
+    fetch?: FetchLike | undefined;
+}
+/**
+ * Resolved authentication state used throughout the client lifecycle.
+ * Created once by {@link resolveCredentialChain} and passed to
+ * {@link resolveAuthHeaders} on every request.
+ */
+interface AuthState {
+    mode: "apiKey" | "bearerStatic" | "bearerProvider" | "sso";
+    apiKey?: string;
+    apiKeyHeader: string;
+    accessToken?: string;
+    accessTokenProvider?: () => string | Promise<string>;
+    accountId?: string | undefined;
+    ssoProfile?: SsoProfile;
+    configDir?: string;
+    autoRefresh: boolean;
+    fetcher?: FetchLike | undefined;
+    /** @internal Coalesces concurrent SSO token refresh attempts. */
+    _refreshPromise?: Promise<string> | undefined;
+}
+
 /**
  * @module
  *
@@ -5095,4 +5207,4 @@ declare class SeclaiStreamingError extends SeclaiError {
     constructor(message: string, runId?: string);
 }
 
-export { type AddCommentRequest, type AddConversationTurnRequest, type AgentDefinitionResponse, type AgentEvaluationTier, type AgentListResponse, type AgentRunAttemptResponse, type AgentRunEvent, type AgentRunListResponse, type AgentRunRequest, type AgentRunResponse, type AgentRunStepResponse, type AgentRunStreamRequest, type AgentSummaryResponse, type AgentTraceMatchResponse, type AgentTraceSearchRequest, type AgentTraceSearchResponse, type AiAssistantAcceptRequest, type AiAssistantAcceptResponse, type AiAssistantFeedbackRequest, type AiAssistantFeedbackResponse, type AiAssistantGenerateRequest, type AiAssistantGenerateResponse, type AiConversationHistoryResponse, type AiConversationTurnResponse, type ChangeStatusRequest, type CompactionEvaluationModel, type CompactionTestResponse, type CompatibleRunListResponse, type CompatibleRunResponse, type ContentDetailResponse, type ContentEmbeddingResponse, type ContentEmbeddingsListResponse, type ContentFileUploadResponse, type CreateAgentRequest, type CreateAlertConfigRequest, type CreateEvaluationCriteriaRequest, type CreateEvaluationResultRequest, type CreateExportRequest, type CreateKnowledgeBaseBody, type CreateMemoryBankBody, type CreateSolutionRequest, type CreateSourceBody, type EstimateExportRequest, type EstimateExportResponse, type EvaluationCriteriaResponse, type EvaluationResultListResponse, type EvaluationResultResponse, type EvaluationResultSummaryResponse, type EvaluationResultWithCriteriaListResponse, type EvaluationResultWithCriteriaResponse, type EvaluationRunSummaryListResponse, type EvaluationRunSummaryResponse, type EvaluationStatus, type ExamplePrompt, type ExecutedActionResponse, type ExportFormat, type ExportListResponse, type ExportResponse, type FetchLike, type FileUploadResponse, type GenerateAgentStepsRequest, type GenerateAgentStepsResponse, type GenerateStepConfigRequest, type GenerateStepConfigResponse, type GovernanceAiAcceptResponse, type GovernanceAiAssistantRequest, type GovernanceAiAssistantResponse, type GovernanceAppliedActionResponse, type GovernanceConversationResponse, type GovernanceProposedPolicyActionResponse, type HTTPValidationError, type InlineTextReplaceRequest, type InlineTextUploadRequest, type JSONValue, type KnowledgeBaseListResponse, type KnowledgeBaseResponse, type LinkResourcesRequest, type ListOptions, type MarkAiSuggestionRequest, type MarkConversationTurnRequest, type MemoryBankAcceptRequest, type MemoryBankAiAssistantRequest, type MemoryBankAiAssistantResponse, type MemoryBankConfigResponse, type MemoryBankConversationTurnResponse, type MemoryBankLastConversationResponse, type MemoryBankListResponse, type MemoryBankResponse, type NonManualEvaluationModeStatResponse, type NonManualEvaluationSummaryResponse, type OrganizationAlertPreferenceListResponse, type OrganizationAlertPreferenceResponse, type PaginationResponse, type PendingProcessingCompletedFailedStatus, type PromptModelAutoUpgradeStrategy, type ProposedActionResponse, SECLAI_API_URL, Seclai, SeclaiAPIStatusError, SeclaiAPIValidationError, SeclaiConfigurationError, SeclaiError, type SeclaiOptions, SeclaiStreamingError, type SolutionAgentResponse, type SolutionConversationResponse, type SolutionKnowledgeBaseResponse, type SolutionListResponse, type SolutionResponse, type SolutionSourceConnectionResponse, type SolutionSummaryResponse, type SortableListOptions, type SourceConnectionResponse, type SourceEmbeddingMigrationResponse, type SourceListResponse, type SourceResponse, type StandaloneTestCompactionRequest, type StartSourceEmbeddingMigrationRequest, type TestCompactionRequest, type TestDraftEvaluationRequest, type TestDraftEvaluationResponse, type UnlinkResourcesRequest, type UpdateAgentDefinitionRequest, type UpdateAgentRequest, type UpdateAlertConfigRequest, type UpdateEvaluationCriteriaRequest, type UpdateKnowledgeBaseBody, type UpdateMemoryBankBody, type UpdateOrganizationAlertPreferenceRequest, type UpdateSolutionRequest, type UpdateSourceBody, type UploadAgentInputApiResponse, type ValidationError };
+export { type AccessTokenProvider, type AddCommentRequest, type AddConversationTurnRequest, type AgentDefinitionResponse, type AgentEvaluationTier, type AgentListResponse, type AgentRunAttemptResponse, type AgentRunEvent, type AgentRunListResponse, type AgentRunRequest, type AgentRunResponse, type AgentRunStepResponse, type AgentRunStreamRequest, type AgentSummaryResponse, type AgentTraceMatchResponse, type AgentTraceSearchRequest, type AgentTraceSearchResponse, type AiAssistantAcceptRequest, type AiAssistantAcceptResponse, type AiAssistantFeedbackRequest, type AiAssistantFeedbackResponse, type AiAssistantGenerateRequest, type AiAssistantGenerateResponse, type AiConversationHistoryResponse, type AiConversationTurnResponse, type AuthState, type ChangeStatusRequest, type CompactionEvaluationModel, type CompactionTestResponse, type CompatibleRunListResponse, type CompatibleRunResponse, type ContentDetailResponse, type ContentEmbeddingResponse, type ContentEmbeddingsListResponse, type ContentFileUploadResponse, type CreateAgentRequest, type CreateAlertConfigRequest, type CreateEvaluationCriteriaRequest, type CreateEvaluationResultRequest, type CreateExportRequest, type CreateKnowledgeBaseBody, type CreateMemoryBankBody, type CreateSolutionRequest, type CreateSourceBody, type CredentialChainOptions, type EstimateExportRequest, type EstimateExportResponse, type EvaluationCriteriaResponse, type EvaluationResultListResponse, type EvaluationResultResponse, type EvaluationResultSummaryResponse, type EvaluationResultWithCriteriaListResponse, type EvaluationResultWithCriteriaResponse, type EvaluationRunSummaryListResponse, type EvaluationRunSummaryResponse, type EvaluationStatus, type ExamplePrompt, type ExecutedActionResponse, type ExportFormat, type ExportListResponse, type ExportResponse, type FetchLike, type FileUploadResponse, type GenerateAgentStepsRequest, type GenerateAgentStepsResponse, type GenerateStepConfigRequest, type GenerateStepConfigResponse, type GovernanceAiAcceptResponse, type GovernanceAiAssistantRequest, type GovernanceAiAssistantResponse, type GovernanceAppliedActionResponse, type GovernanceConversationResponse, type GovernanceProposedPolicyActionResponse, type HTTPValidationError, type InlineTextReplaceRequest, type InlineTextUploadRequest, type JSONValue, type KnowledgeBaseListResponse, type KnowledgeBaseResponse, type LinkResourcesRequest, type ListOptions, type MarkAiSuggestionRequest, type MarkConversationTurnRequest, type MemoryBankAcceptRequest, type MemoryBankAiAssistantRequest, type MemoryBankAiAssistantResponse, type MemoryBankConfigResponse, type MemoryBankConversationTurnResponse, type MemoryBankLastConversationResponse, type MemoryBankListResponse, type MemoryBankResponse, type NonManualEvaluationModeStatResponse, type NonManualEvaluationSummaryResponse, type OrganizationAlertPreferenceListResponse, type OrganizationAlertPreferenceResponse, type PaginationResponse, type PendingProcessingCompletedFailedStatus, type PromptModelAutoUpgradeStrategy, type ProposedActionResponse, SECLAI_API_URL, Seclai, SeclaiAPIStatusError, SeclaiAPIValidationError, SeclaiConfigurationError, SeclaiError, type SeclaiOptions, SeclaiStreamingError, type SolutionAgentResponse, type SolutionConversationResponse, type SolutionKnowledgeBaseResponse, type SolutionListResponse, type SolutionResponse, type SolutionSourceConnectionResponse, type SolutionSummaryResponse, type SortableListOptions, type SourceConnectionResponse, type SourceEmbeddingMigrationResponse, type SourceListResponse, type SourceResponse, type SsoCacheEntry, type SsoProfile, type StandaloneTestCompactionRequest, type StartSourceEmbeddingMigrationRequest, type TestCompactionRequest, type TestDraftEvaluationRequest, type TestDraftEvaluationResponse, type UnlinkResourcesRequest, type UpdateAgentDefinitionRequest, type UpdateAgentRequest, type UpdateAlertConfigRequest, type UpdateEvaluationCriteriaRequest, type UpdateKnowledgeBaseBody, type UpdateMemoryBankBody, type UpdateOrganizationAlertPreferenceRequest, type UpdateSolutionRequest, type UpdateSourceBody, type UploadAgentInputApiResponse, type ValidationError };