@seclai/sdk 1.1.4 → 1.2.0

package/dist/index.d.ts

@@ -20,6 +20,28 @@ interface components {
              */
             user_input: string;
         };
+        /**
+         * AgentDefinitionImportErrorResponse
+         * @description 422 body for invalid `agent_definition` payloads.
+         *
+         *     Mirrors :py:meth:`AgentDefinitionImportError.to_response_dict`.
+         */
+        AgentDefinitionImportErrorResponse: {
+            /**
+             * Error
+             * @default invalid_agent_definition
+             */
+            error: string;
+            /** Errors */
+            errors: components["schemas"]["ImportFieldErrorModel"][];
+            /** Message */
+            message: string;
+            /**
+             * Source
+             * @description Canonical pretty-printed echo of the supplied payload — error line/column refer to this string.
+             */
+            source: string;
+        };
         /** AgentDefinitionResponse */
         AgentDefinitionResponse: {
             /**
@@ -29,7 +51,7 @@ interface components {
             change_id: string;
             /**
              * Definition
-             * @description The agent definition containing name, description, tags, and step workflow tree. Step types include prompt_call, retrieval, transform, gate, retry, evaluate_step, insight, extract_json, send_email, webhook_call, call_agent, write_metadata, write_content_attachment, load_content_attachment, load_content, display_result, and others.
+             * @description The agent definition containing name, description, tags, and step workflow tree. Step types include prompt_call, retrieval, regex_replace, gate, retry, evaluate_step, extract_data, extract_content, add_chat_turn, load_chat_history, add_memory, search_memory, load_memory, streaming_result, send_email, webhook_call, call_agent, write_metadata, write_content_attachment, load_content_attachment, load_content, display_result, merge, for_each, and others.
              */
             definition: {
                 [key: string]: unknown;
@@ -179,6 +201,11 @@ interface components {
              * @description List of attempts made for this agent run.
              */
             attempts: components["schemas"]["AgentRunAttemptResponse"][];
+            /**
+             * Blocked Policies
+             * @description Governance policies that produced at least one BLOCK verdict during this run.  Deduplicated by policy id.
+             */
+            blocked_policies?: components["schemas"]["routers__api__agents__GovernancePolicyRefResponse"][];
             /**
              * Credits
              * @description Credits consumed by the agent run, if applicable.
@@ -189,11 +216,31 @@ interface components {
              * @description Number of errors encountered during the run.
              */
             error_count: number;
+            /**
+             * Flagged Policies
+             * @description Governance policies that produced at least one FLAG verdict during this run.  Deduplicated by policy id.
+             */
+            flagged_policies?: components["schemas"]["routers__api__agents__GovernancePolicyRefResponse"][];
+            /**
+             * Governance Input Status
+             * @description Result of the governance input evaluation: safe, blocked, skipped, or timed_out.
+             */
+            governance_input_status?: string | null;
+            /**
+             * Governance Input Wait Ms
+             * @description Milliseconds spent waiting for governance input evaluation.
+             */
+            governance_input_wait_ms?: number | null;
             /**
              * Input
              * @description Input provided to the agent for this run.
              */
             input: string | null;
+            /**
+             * Input Scan Status
+             * @description Result of the prompt injection scan: safe, unsafe, skipped, timed_out, or error.
+             */
+            input_scan_status?: string | null;
             /**
              * Output
              * @description Output produced by the agent run.
@@ -209,6 +256,11 @@ interface components {
              * @description Unique identifier for the agent run.
              */
             run_id: string;
+            /**
+             * Scan Wait Ms
+             * @description Milliseconds spent waiting for prompt injection scan.
+             */
+            scan_wait_ms?: number | null;
             /** @description Current status of the agent run. */
             status: components["schemas"]["PendingProcessingCompletedFailedStatus"];
             /**
@@ -315,6 +367,11 @@ interface components {
              * @description Unique agent identifier.
              */
             id: string;
+            /**
+             * Import Warnings
+             * @description One entry per item dropped or substituted during import. Present only on endpoints that accept agent_definition; null on non-import calls; [] when the import had no skips.
+             */
+            import_warnings?: components["schemas"]["ImportSkipResponse"][] | null;
             /**
              * Max Retries
              * @description Max retries for eval_and_retry mode.
@@ -1045,6 +1102,8 @@ interface components {
              * @description Embedding model override.
              */
             embedding_model?: string | null;
+            /** @description Index mode for custom_index sources: fast_and_cheap (default), balanced, slow_and_thorough, or custom. */
+            index_mode?: components["schemas"]["SourceIndexMode"] | null;
             /**
              * Name
              * @description Source name.
@@ -1072,7 +1131,7 @@ interface components {
             retention?: number | null;
             /**
              * Source Type
-             * @description Source type: rss, website, file_uploads, or custom_index.
+             * @description Source type: rss, website, or custom_index. The legacy value 'file_uploads' is accepted as an alias for custom_index.
              */
             source_type: string;
             /**
@@ -1493,7 +1552,7 @@ interface components {
             step_id?: string | null;
             /**
              * Step Type
-             * @description The step type to generate config for (e.g. 'transform', 'gate', 'text', 'prompt_call', 'retrieval').
+             * @description The step type to generate config for (e.g. 'regex_replace', 'gate', 'text', 'prompt_call', 'retrieval').
              */
             step_type: string;
             /**
@@ -1604,6 +1663,64 @@ interface components {
             /** Detail */
             detail?: components["schemas"]["ValidationError"][];
         };
+        /**
+         * ImportFieldErrorModel
+         * @description Single agent_definition validation error with source position.
+         */
+        ImportFieldErrorModel: {
+            /**
+             * Column
+             * @description 1-indexed column in `source`.
+             */
+            column: number;
+            /**
+             * Line
+             * @description 1-indexed line in `source`.
+             */
+            line: number;
+            /**
+             * Message
+             * @description Human-readable description of the problem.
+             */
+            message: string;
+            /**
+             * Path
+             * @description Dotted path of the offending field, e.g. `agent.definition.child_steps[0].step_type`.
+             */
+            path: string;
+        };
+        /**
+         * ImportSkipResponse
+         * @description One item that was not applied during an agent import.
+         *
+         *     Used as the element type for ``import_warnings`` on every
+         *     response model that accepts an ``agent_definition`` payload.
+         *     See :py:class:`services.agent_definition_import.AgentImportSkip`
+         *     for the full category list.
+         *
+         *     Lives here (not on each router) so the authenticated and public
+         *     API responses share one definition — keeping the shape that
+         *     clients (UI modal, MCP, OpenAPI consumers) depend on aligned.
+         */
+        ImportSkipResponse: {
+            /**
+             * Category
+             * @description The kind of item that was skipped or substituted: 'schedule', 'evaluation_criteria', 'alert_config', 'alert_recipient', 'governance_policy', 'governance_kb_link', 'solution_link'.
+             */
+            category: string;
+            /**
+             * Details
+             * @description Category-specific identifiers for the skipped item (step_id, alert_type, kb_name, etc.).  Stable keys per category; absent keys are simply not applicable.
+             */
+            details?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Message
+             * @description Human-readable explanation of what was skipped and why.
+             */
+            message: string;
+        };
         /**
          * InlineTextReplaceRequest
          * @description Request model for inline text content replacement.
@@ -2032,11 +2149,96 @@ interface components {
          * @enum {string}
          */
         PendingProcessingCompletedFailedStatus: "pending" | "processing" | "completed" | "failed";
+        /**
+         * PlaygroundCreateRequest
+         * @description Create a model playground experiment via the public API.
+         */
+        PlaygroundCreateRequest: {
+            /**
+             * Evaluation Complexity
+             * @description simple, medium, or complex
+             * @default medium
+             * @enum {string}
+             */
+            evaluation_complexity: "simple" | "medium" | "complex";
+            /**
+             * Evaluation Mode
+             * @description manual or prompt
+             * @default manual
+             * @enum {string}
+             */
+            evaluation_mode: "manual" | "prompt";
+            /**
+             * Evaluator Model Id
+             * @description Evaluator model ID when evaluation_mode is prompt.
+             */
+            evaluator_model_id?: string | null;
+            /**
+             * Include Step Output In Evaluation
+             * @description Whether to include selected step output as evaluator context.
+             * @default false
+             */
+            include_step_output_in_evaluation: boolean;
+            /**
+             * Json Template
+             * @description Optional JSON template for advanced mode.
+             */
+            json_template?: string | null;
+            /**
+             * Model Ids
+             * @description Selected model IDs (1-10).
+             */
+            model_ids: string[];
+            /**
+             * Prompt
+             * @description Prompt text for the experiment.
+             */
+            prompt: string;
+            /**
+             * Selected Step Output
+             * @description Optional step output text for evaluator context.
+             */
+            selected_step_output?: string | null;
+            /**
+             * System Prompt
+             * @description Optional system prompt.
+             * @default
+             */
+            system_prompt: string;
+        };
         /**
          * PromptModelAutoUpgradeStrategy
          * @enum {string}
          */
         PromptModelAutoUpgradeStrategy: "none" | "early_adopter" | "middle_of_road" | "cautious_adopter";
+        /**
+         * PromptToolResponse
+         * @description Response model for a prompt tool.
+         */
+        PromptToolResponse: {
+            /** Description */
+            description?: string | null;
+            /** Documentation Url */
+            documentation_url?: string | null;
+            /** Example */
+            example?: string | null;
+            /** Headers */
+            headers?: {
+                [key: string]: string;
+            } | null;
+            /** Id */
+            id: string;
+            /** Name */
+            name: string;
+            /** Notes */
+            notes?: string | null;
+            /** Tool Name */
+            tool_name?: string | null;
+            /** Tool Type */
+            tool_type: string;
+            /** Tool Type Pattern */
+            tool_type_pattern?: string | null;
+        };
         /**
          * ProposedActionResponse
          * @description A single proposed action.
@@ -2065,6 +2267,13 @@ interface components {
             params: {
                 [key: string]: unknown;
             };
+            /**
+             * Preview
+             * @description Planning-time dry-run preview attached by the solution AI assistant for create_agent / update_agent actions. Contains ``steps`` (the generated step tree), ``step_count``, ``warnings`` (a mix of heuristic structural issues — e.g. brittle JSONPath, pass-through ``regex_replace``, ``prompt_call`` missing a model — and deterministic resource-usage issues: every pre-bound knowledge base / memory bank must be referenced by at least one step, and no step may reference an unknown id), and ``skipped`` / ``skipped_reason`` when preview couldn't run (e.g. the action depends on resources created earlier in the same plan). ``None`` for non-agent actions or when generation failed.
+             */
+            preview?: {
+                [key: string]: unknown;
+            } | null;
         };
         /**
          * ProposedPolicyActionResponse
@@ -2224,6 +2433,22 @@ interface components {
             /** Updated At */
             updated_at: string;
         };
+        /**
+         * SourceIndexMode
+         * @description Embedding quality / cost trade-off preset for custom_index sources.
+         *
+         *     Each preset controls the default embedding dimensions, chunk size, and
+         *     chunk overlap.  The embedding model is always the account-level default
+         *     (currently ``AWS_BEDROCK_AMAZON_NOVA_2_MULTIMODAL``).
+         *
+         *     Presets:
+         *         FAST_AND_CHEAP: 256 dimensions, 3 000 char chunks, 500 char overlap.
+         *         BALANCED: 384 dimensions, 1 500 char chunks, 300 char overlap.
+         *         SLOW_AND_THOROUGH: 1 024 dimensions, 1 000 char chunks, 200 char overlap.
+         *         CUSTOM: Caller supplies embedding model, dimensions, and chunk config.
+         * @enum {string}
+         */
+        SourceIndexMode: "fast_and_cheap" | "balanced" | "slow_and_thorough" | "custom";
         /**
          * SourceResponse
          * @description Response model for source data.
@@ -2317,6 +2542,8 @@ interface components {
              * @description Unique identifier for the source connection.
              */
             id: string;
+            /** @description Index mode for custom_index sources: fast_and_cheap, balanced, slow_and_thorough, or custom. */
+            index_mode?: components["schemas"]["SourceIndexMode"] | null;
             /**
              * Name
              * @description Name of the source connection.
@@ -2791,6 +3018,142 @@ interface components {
             /** Error Type */
             type: string;
         };
+        /**
+         * VariantCategoryResponse
+         * @description Response model for a variant category
+         */
+        VariantCategoryResponse: {
+            /** Category */
+            category: string;
+            /** Configurable */
+            configurable: boolean;
+            /** Description */
+            description: string;
+            /** Options */
+            options: components["schemas"]["VariantOptionResponse"][];
+            /** Title */
+            title: string;
+        };
+        /**
+         * VariantOptionResponse
+         * @description Response model for a variant option
+         */
+        VariantOptionResponse: {
+            /** Default */
+            default: boolean;
+            /** Description */
+            description?: string | null;
+            /** Input 1H Cache Write Credits Per 1000 Tokens */
+            input_1h_cache_write_credits_per_1000_tokens?: number | null;
+            /** Input 5M Cache Write Credits Per 1000 Tokens */
+            input_5m_cache_write_credits_per_1000_tokens?: number | null;
+            /** Input Cache Hit Credits Per 1000 Tokens */
+            input_cache_hit_credits_per_1000_tokens?: number | null;
+            /** Input Credits Per 1000 Tokens */
+            input_credits_per_1000_tokens?: number | null;
+            /** Long Context Input Cache Hit Credits Per 1000 Tokens */
+            long_context_input_cache_hit_credits_per_1000_tokens?: number | null;
+            /** Long Context Input Credits Per 1000 Tokens */
+            long_context_input_credits_per_1000_tokens?: number | null;
+            /** Long Context Output Credits Per 1000 Tokens */
+            long_context_output_credits_per_1000_tokens?: number | null;
+            /** Long Context Threshold */
+            long_context_threshold?: number | null;
+            /** Output Credits Per 1000 Tokens */
+            output_credits_per_1000_tokens?: number | null;
+            /** Title */
+            title: string;
+            /** Value */
+            value: string;
+        };
+        /**
+         * AgentImportPreviewRequest
+         * @description Dry-run import request — same payload shape as the export endpoint.
+         */
+        routers__api__agents__AgentImportPreviewRequest: {
+            /**
+             * Agent Definition
+             * @description Payload in the same shape as GET /api/agents/{agent_id}/export.
+             */
+            agent_definition: {
+                [key: string]: unknown;
+            };
+        };
+        /**
+         * AgentImportPreviewResponse
+         * @description Summary of a successfully validated import payload (no DB writes).
+         *
+         *     Counts are derived from the validated payload as supplied — they
+         *     reflect what was requested, not what would eventually be persisted
+         *     (cross-account skips for recipients and KB names happen later, only
+         *     on commit).
+         */
+        routers__api__agents__AgentImportPreviewResponse: {
+            /**
+             * Agent Name
+             * @description Imported agent name, if any.
+             */
+            agent_name: string | null;
+            /**
+             * Alert Configs
+             * @description Number of alert configs in the payload.
+             */
+            alert_configs: number;
+            /**
+             * Description
+             * @description Imported agent description, if any.
+             */
+            description: string | null;
+            /**
+             * Evaluation Criteria
+             * @description Number of evaluation criteria in the payload.
+             */
+            evaluation_criteria: number;
+            /**
+             * Governance Policies
+             * @description Number of agent-scoped governance policies in the payload.
+             */
+            governance_policies: number;
+            /**
+             * Ok
+             * @description Always true on a 200 response; failures use HTTP 422.
+             */
+            ok: boolean;
+            /**
+             * Payload Export Version
+             * @description Export-format version the payload claims (or ``null`` for legacy payloads).  When this differs from ``supported_export_version``, fields may have been silently dropped or defaulted on import.
+             */
+            payload_export_version?: string | null;
+            /**
+             * Schedules
+             * @description Number of trigger schedules in the payload.
+             */
+            schedules: number;
+            /**
+             * Solutions
+             * @description Number of solutions the source agent belonged to. On import these are matched by name in the target account; unmatched names are silently skipped.
+             * @default 0
+             */
+            solutions: number;
+            /**
+             * Step Count
+             * @description Total number of steps in the workflow tree (recursive).
+             */
+            step_count: number;
+            /**
+             * Supported Export Version
+             * @description Export-format version this server understands.  Compare against ``payload_export_version`` to detect cross-version imports.
+             * @default 2
+             */
+            supported_export_version: string;
+            /**
+             * Unresolved Refs
+             * @description Entity references in the imported workflow that don't exist in the target account.  Each entry: {category, ref_id, ref_name?, locations:[step:<id>], alternatives:[{id, name, description?}]}. Pass {source_uuid: target_uuid} as ``entity_remap`` on the create/update call to substitute these references before save.
+             */
+            unresolved_refs?: {
+                [key: string]: unknown;
+            }[];
+        };
         /** AgentListResponse */
         routers__api__agents__AgentListResponse: {
             /**
@@ -2840,6 +3203,13 @@ interface components {
         };
         /** CreateAgentRequest */
         routers__api__agents__CreateAgentRequest: {
+            /**
+             * Agent Definition
+             * @description Optional payload in the same format produced by GET /agents/{id}/export. When provided, replaces any template-derived workflow and pre-fills metadata/trigger fields the request does not specify explicitly. Validation errors include line/column references against a canonical pretty-printed echo of the supplied payload.
+             */
+            agent_definition?: {
+                [key: string]: unknown;
+            } | null;
             /**
              * Agent Template
              * @description Template to initialize the agent from. Values: blank, retrieval_example, simple_qa, summarizer, json_extractor, content_change_notifier, scheduled_report, webhook_pipeline.
@@ -2850,6 +3220,13 @@ interface components {
              * @description Optional description.
              */
             description?: string | null;
+            /**
+             * Entity Remap
+             * @description Optional UUID-substitution map applied to the imported workflow before save. Each key is a source-account UUID (as returned by /agents/preview-import's ``unresolved_refs``); each value is the target-account UUID to substitute. Used to relink knowledge bases, memory banks, source connections, and sub-agents on cross-account imports.
+             */
+            entity_remap?: {
+                [key: string]: string;
+            } | null;
             /**
              * Name
              * @description Name for the new agent.
@@ -2862,8 +3239,31 @@ interface components {
              */
             trigger_type: string;
         };
+        /**
+         * GovernancePolicyRefResponse
+         * @description Reference to a governance policy by id and name.
+         */
+        routers__api__agents__GovernancePolicyRefResponse: {
+            /**
+             * Policy Id
+             * @description Governance policy identifier.
+             */
+            policy_id: string;
+            /**
+             * Policy Name
+             * @description Display name of the policy at evaluation time. May be null when the policy has been deleted.
+             */
+            policy_name?: string | null;
+        };
         /** UpdateAgentRequest */
         routers__api__agents__UpdateAgentRequest: {
+            /**
+             * Agent Definition
+             * @description Optional payload in the same format produced by GET /agents/{id}/export. When provided, agent metadata fields the request does not set explicitly are taken from the payload, and the agent's workflow is replaced from `agent.definition`. The previous version is preserved in history. Validation errors include line/column references against a canonical pretty-printed echo of the supplied payload.
+             */
+            agent_definition?: {
+                [key: string]: unknown;
+            } | null;
             /**
              * Default Evaluation Tier
              * @description Default evaluation tier: 'fast', 'balanced', or 'thorough'.
@@ -2874,6 +3274,13 @@ interface components {
              * @description New description for the agent.
              */
             description?: string | null;
+            /**
+             * Entity Remap
+             * @description Optional UUID-substitution map applied to the imported workflow before save (same shape as on POST /agents).
+             */
+            entity_remap?: {
+                [key: string]: string;
+            } | null;
             /**
              * Evaluation Mode
              * @description Evaluation mode: 'output_expectation', 'eval_and_retry', or 'sample_and_flag'.
@@ -3689,6 +4096,135 @@ interface components {
             data: components["schemas"]["SourceResponse"][];
             pagination: components["schemas"]["PaginationResponse"];
         };
+        /**
+         * PromptModelResponse
+         * @description Response model for prompt model data
+         */
+        schemas__model_responses__PromptModelResponse: {
+            /** Default */
+            default: boolean;
+            /** Deprecated At */
+            deprecated_at?: string | null;
+            /** Description */
+            description: string;
+            /** Enabled */
+            enabled: boolean;
+            /** Family */
+            family?: string | null;
+            /** Family Generation */
+            family_generation?: number | null;
+            /** Id */
+            id: string;
+            /** Input 1H Cache Write Credits Per 1000 Tokens */
+            input_1h_cache_write_credits_per_1000_tokens?: number | null;
+            /** Input 5M Cache Write Credits Per 1000 Tokens */
+            input_5m_cache_write_credits_per_1000_tokens?: number | null;
+            /** Input Cache Hit Credits Per 1000 Tokens */
+            input_cache_hit_credits_per_1000_tokens?: number | null;
+            /** Input Credits Per 1000 Tokens */
+            input_credits_per_1000_tokens?: number | null;
+            /**
+             * Is New
+             * @default false
+             */
+            is_new: boolean;
+            /**
+             * Last Used
+             * @default false
+             */
+            last_used: boolean;
+            /** Max Context Tokens */
+            max_context_tokens: number;
+            /** Max Conversation Length */
+            max_conversation_length: number;
+            /** Max Output Tokens */
+            max_output_tokens: number;
+            /** Model Id */
+            model_id: string;
+            /** Name */
+            name: string;
+            /** Output Credits Per 1000 Tokens */
+            output_credits_per_1000_tokens?: number | null;
+            /**
+             * Payload Schema
+             * @description Model-specific JSON schema for advanced prompt_call json_template payloads.
+             */
+            payload_schema?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Payload Schema Source Url
+             * @description Source URL used to derive payload_schema guidance for this model.
+             */
+            payload_schema_source_url?: string | null;
+            /** Provider */
+            provider: string;
+            /** Released At */
+            released_at?: string | null;
+            /**
+             * Schema Documentation Url
+             * @description Model documentation URL with request/response payload details.
+             */
+            schema_documentation_url?: string | null;
+            /**
+             * Schema Notes
+             * @description Human-readable notes about request payload compatibility.
+             */
+            schema_notes?: string | null;
+            /** Successor Model Id */
+            successor_model_id?: string | null;
+            /** Sunset At */
+            sunset_at?: string | null;
+            /** Supported Input Media */
+            supported_input_media?: string[] | null;
+            /** Supported Languages */
+            supported_languages?: string[] | null;
+            /**
+             * Supports Openai Arguments
+             * @default false
+             */
+            supports_openai_arguments: boolean;
+            /**
+             * Supports Streaming
+             * @default false
+             */
+            supports_streaming: boolean;
+            /**
+             * Supports Structured Output
+             * @default true
+             */
+            supports_structured_output: boolean;
+            /**
+             * Supports Thinking
+             * @default false
+             */
+            supports_thinking: boolean;
+            /**
+             * Supports Tool Use
+             * @default true
+             */
+            supports_tool_use: boolean;
+            /** Tools Disabled */
+            tools_disabled?: components["schemas"]["PromptToolResponse"][];
+            /** Tools Enabled */
+            tools_enabled?: components["schemas"]["PromptToolResponse"][];
+            /** Training Cutoff At */
+            training_cutoff_at?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Variants */
+            variants?: components["schemas"]["VariantCategoryResponse"][] | null;
+        };
+        /**
+         * ProviderGroupResponse
+         * @description Response model for provider group with models
+         */
+        schemas__model_responses__ProviderGroupResponse: {
+            /** Models */
+            models: components["schemas"]["schemas__model_responses__PromptModelResponse"][];
+            /** Provider */
+            provider: string;
+        };
         /**
          * NonManualEvaluationModeStatResponse
          * @description Per-mode rollup for evaluation activity.
@@ -3774,6 +4310,21 @@ type CreateAgentRequest = components["schemas"]["routers__api__agents__CreateAge
 type UpdateAgentRequest = components["schemas"]["routers__api__agents__UpdateAgentRequest"];
 /** Request body for updating an agent definition (steps, model, etc.). */
 type UpdateAgentDefinitionRequest = components["schemas"]["UpdateAgentDefinitionRequest"];
+/** Request body for previewing an agent_definition import (dry-run validation). */
+type AgentImportPreviewRequest = components["schemas"]["routers__api__agents__AgentImportPreviewRequest"];
+/** Response body summarising a successfully validated agent_definition import payload. */
+type AgentImportPreviewResponse = components["schemas"]["routers__api__agents__AgentImportPreviewResponse"];
+/**
+ * 422 response body for invalid `agent_definition` payloads on create/update/preview-import.
+ * Errors carry 1-indexed line/column references into the canonical `source` echo.
+ */
+type AgentDefinitionImportErrorResponse = components["schemas"]["AgentDefinitionImportErrorResponse"];
+/** Single validation error within an {@link AgentDefinitionImportErrorResponse} (with source position). */
+type ImportFieldErrorModel = components["schemas"]["ImportFieldErrorModel"];
+/** One item dropped or substituted during an agent import (emitted in `import_warnings`). */
+type ImportSkipResponse = components["schemas"]["ImportSkipResponse"];
+/** Reference to a governance policy (id and optional display name). */
+type GovernancePolicyRefResponse = components["schemas"]["routers__api__agents__GovernancePolicyRefResponse"];
 /** Request body for starting an agent run. */
 type AgentRunRequest = components["schemas"]["AgentRunRequest"];
 /** Request body for starting an agent run in streaming mode (SSE). */
@@ -3994,6 +4545,27 @@ type AiAssistantFeedbackRequest = components["schemas"]["routers__api__ai_assist
 type AiAssistantFeedbackResponse = components["schemas"]["AiAssistantFeedbackResponse"];
 /** Prompt model auto-upgrade strategy. */
 type PromptModelAutoUpgradeStrategy = components["schemas"]["PromptModelAutoUpgradeStrategy"];
+/** Models grouped by provider. */
+type ProviderGroupResponse = components["schemas"]["schemas__model_responses__ProviderGroupResponse"];
+/** Full model details including capabilities, pricing, and lifecycle status. */
+type PromptModelResponse = components["schemas"]["schemas__model_responses__PromptModelResponse"];
+/** Prompt tool configuration within a model. */
+type PromptToolResponse = components["schemas"]["PromptToolResponse"];
+/** Variant category for model pricing tiers. */
+type VariantCategoryResponse = components["schemas"]["VariantCategoryResponse"];
+/** Variant option with credit pricing and context limits. */
+type VariantOptionResponse = components["schemas"]["VariantOptionResponse"];
+/** Request body for creating a model playground experiment. */
+type PlaygroundCreateRequest = components["schemas"]["PlaygroundCreateRequest"];
+/**
+ * Input type for {@link SeclaiClient.createExperiment}.
+ *
+ * Only `model_ids` and `prompt` are required — every other field has a
+ * server-side default and can be omitted.
+ */
+type CreateExperimentInput = Pick<PlaygroundCreateRequest, "model_ids" | "prompt"> & Partial<Omit<PlaygroundCreateRequest, "model_ids" | "prompt">>;
+/** Source index mode: fast_and_cheap, balanced, slow_and_thorough, or custom. */
+type SourceIndexMode = components["schemas"]["SourceIndexMode"];
 /** Processing status: pending, processing, completed, or failed. */
 type PendingProcessingCompletedFailedStatus = components["schemas"]["PendingProcessingCompletedFailedStatus"];
 /** An SSE event emitted during a streaming agent run. */
@@ -4192,6 +4764,25 @@ declare class Seclai {
      * @returns The exported agent snapshot.
      */
     exportAgent(agentId: string, download?: boolean): Promise<AgentExportResponse>;
+    /**
+     * Validate an `agent_definition` payload (same shape as {@link exportAgent})
+     * without creating or modifying any agent.
+     *
+     * Use this before {@link createAgent} or {@link updateAgent} with an
+     * `agent_definition` to surface `unresolved_refs` — workflow references to
+     * knowledge bases, memory banks, source connections, or sub-agents that
+     * don't exist in the target account. Pass the returned ids back in
+     * `entity_remap` on the commit call to substitute them.
+     *
+     * @param body - The preview payload (`{ agent_definition: ... }`).
+     * @returns Summary of the validated payload (step counts, schedules,
+     *   alert configs, evaluation criteria, governance policies, and any
+     *   `unresolved_refs`).
+     * @throws {SeclaiAPIValidationError} On HTTP 422 — the body is an
+     *   {@link AgentDefinitionImportErrorResponse} with 1-indexed
+     *   line/column-anchored errors against a canonical `source` echo.
+     */
+    previewImportAgent(body: AgentImportPreviewRequest): Promise<AgentImportPreviewResponse>;
     /**
      * Get an agent's full definition (steps, model config, etc.).
      *
@@ -5075,6 +5666,52 @@ declare class Seclai {
      * @param modelId - Model identifier.
      */
     getModelRecommendations(modelId: string): Promise<unknown>;
+    /**
+     * List all enabled LLM models grouped by provider.
+     *
+     * @param opts - Optional filters.
+     */
+    listModels(opts?: {
+        provider?: string;
+        supportsToolUse?: boolean;
+        supportsThinking?: boolean;
+    }): Promise<ProviderGroupResponse[]>;
+    /**
+     * Get full details for a specific model.
+     *
+     * @param modelId - Model identifier.
+     */
+    getModel(modelId: string): Promise<PromptModelResponse>;
+    /**
+     * List model playground experiments.
+     *
+     * @param opts - Optional filters and pagination.
+     */
+    listExperiments(opts?: {
+        days?: number;
+        startDate?: string;
+        endDate?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    /**
+     * Create a model playground experiment.
+     *
+     * @param body - Experiment configuration.
+     */
+    createExperiment(body: CreateExperimentInput): Promise<unknown>;
+    /**
+     * Get a model playground experiment by ID.
+     *
+     * @param experimentId - Experiment identifier.
+     */
+    getExperiment(experimentId: string): Promise<unknown>;
+    /**
+     * Cancel a running model playground experiment.
+     *
+     * @param experimentId - Experiment identifier.
+     */
+    cancelExperiment(experimentId: string): Promise<unknown>;
     /**
      * Search across all resource types in your account.
      *
@@ -5353,4 +5990,4 @@ declare class SeclaiStreamingError extends SeclaiError {
     constructor(message: string, runId?: string);
 }
 
-export { type AccessTokenProvider, type AddCommentRequest, type AddConversationTurnRequest, type AgentDefinitionResponse, type AgentEvaluationTier, type AgentExportResponse, 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, DEFAULT_SSO_CLIENT_ID, DEFAULT_SSO_DOMAIN, DEFAULT_SSO_REGION, 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, deleteSsoCache, isTokenValid, loadSsoProfile, readSsoCache, writeSsoCache };
+export { type AccessTokenProvider, type AddCommentRequest, type AddConversationTurnRequest, type AgentDefinitionImportErrorResponse, type AgentDefinitionResponse, type AgentEvaluationTier, type AgentExportResponse, type AgentImportPreviewRequest, type AgentImportPreviewResponse, 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 CreateExperimentInput, type CreateExportRequest, type CreateKnowledgeBaseBody, type CreateMemoryBankBody, type CreateSolutionRequest, type CreateSourceBody, type CredentialChainOptions, DEFAULT_SSO_CLIENT_ID, DEFAULT_SSO_DOMAIN, DEFAULT_SSO_REGION, 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 GovernancePolicyRefResponse, type GovernanceProposedPolicyActionResponse, type HTTPValidationError, type ImportFieldErrorModel, type ImportSkipResponse, 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 PlaygroundCreateRequest, type PromptModelAutoUpgradeStrategy, type PromptModelResponse, type PromptToolResponse, type ProposedActionResponse, type ProviderGroupResponse, 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 SourceIndexMode, 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, type VariantCategoryResponse, type VariantOptionResponse, deleteSsoCache, isTokenValid, loadSsoProfile, readSsoCache, writeSsoCache };