@seclai/sdk 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -20,18 +20,37 @@ interface components {
              */
             user_input: string;
         };
+        /**
+         * AgentAttachmentRefsApiResponse
+         * @description Static attachment-reference contract for an agent.
+         *
+         *     Mirrors the MCP ``get_agent_attachment_references`` tool: returns
+         *     what files (if any) an agent's templates expect on a run so API
+         *     consumers can stage uploads correctly before calling
+         *     ``POST /agents/{id}/runs``.
+         */
+        AgentAttachmentRefsApiResponse: {
+            /** @description Aggregated selector summary across all consumer steps. ``exact_names`` entries must each appear in the upload batch; ``indexes_max+1`` is the minimum file count; every ``patterns`` glob must match at least one upload. */
+            agent?: components["schemas"]["AttachmentRefsSourceApiSummary"];
+            /**
+             * Requires Uploads
+             * @description When ``false`` the agent's definition does NOT reference any uploaded attachments — ``POST /agents/{id}/upload-input`` will reject with HTTP 400. When ``true`` the ``agent`` block lists the specific selectors a run-time batch must satisfy.
+             */
+            requires_uploads: boolean;
+        };
         /**
          * AgentDefinitionImportErrorResponse
          * @description 422 body for invalid `agent_definition` payloads.
          *
-         *     Mirrors :py:meth:`AgentDefinitionImportError.to_response_dict`.
+         *     Mirrors `AgentDefinitionImportError.to_response_dict`.
          */
         AgentDefinitionImportErrorResponse: {
             /**
              * Error
-             * @default invalid_agent_definition
+             * @description Stable machine-readable error code.
+             * @constant
              */
-            error: string;
+            error: "invalid_agent_definition";
             /** Errors */
             errors: components["schemas"]["ImportFieldErrorModel"][];
             /** Message */
@@ -51,7 +70,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, 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.
+             * @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, if_else, switch, and others.
              */
             definition: {
                 [key: string]: unknown;
@@ -177,9 +196,18 @@ interface components {
             input?: string | null;
             /**
              * Input Upload Id
-             * @description ID of a previously uploaded file (via POST /{agent_id}/upload-input) to use as the run input for dynamic-input triggers. Mutually exclusive with the 'input' field.
+             * @description ID of a previously uploaded file (via POST /{agent_id}/upload-input) to use as the run input for dynamic-input triggers. Mutually exclusive with the 'input' field. Use ``input_upload_ids`` to attach multiple files.
+             *
+             *     **Attachment visibility:** a step only sees the upload when its template references the input — via ``{{input}}`` / ``{{agent.input}}`` / ``{{step.<id>.input|output}}`` (implicit, all attachments) or the ``{{attachments[…]}}`` family (explicit narrowing — e.g. ``{{attachments[0]}}``, ``{{attachments[*.pdf]}}``).
+             *
+             *     **Per-batch validation:** every selector the agent's definition declares must be satisfied or the run is rejected with HTTP 400. Exact-name selectors require that filename to be present; indexed selectors require at least N+1 files; glob patterns require at least one matching filename.
              */
             input_upload_id?: string | null;
+            /**
+             * Input Upload Ids
+             * @description IDs of multiple previously uploaded files. Each upload's extracted text is concatenated under a heading; each upload's binary is surfaced as a separate ``MediaAttachment`` so multi-modal prompt steps reason over all files at once. Steps narrow visibility via ``{{attachments[…]}}`` selectors (by index, filename, or fnmatch glob). The batch must satisfy every selector the agent declares — exact names, indexed references (length must exceed the highest index), and glob patterns (each pattern needs at least one match). Mismatches return HTTP 400 with the unmet requirements listed.  Mutually exclusive with ``input`` and ``input_upload_id`` — pass exactly one of the three. Max 20 uploads per run.
+             */
+            input_upload_ids?: string[] | null;
             /**
              * Metadata
              * @description Metadata to make available for string substitution expressions in agent tasks.
@@ -193,6 +221,11 @@ interface components {
              * @default false
              */
             priority: boolean;
+            /**
+             * Replay Of Run Id
+             * @description Re-run this agent reusing a prior run's uploaded input files. The files are re-resolved server-side from the source run (which must belong to this account and agent) — you do not re-upload them. Combine with ``input`` to change the text while keeping the files. A fresh upload batch (``input_upload_id(s)``) takes precedence and disables replay. Binaries swept by retention fall back to their extracted text.
+             */
+            replay_of_run_id?: string | null;
         };
         /** AgentRunResponse */
         AgentRunResponse: {
@@ -231,6 +264,11 @@ interface components {
              * @description Milliseconds spent waiting for governance input evaluation.
              */
             governance_input_wait_ms?: number | null;
+            /**
+             * Hitl Wait Ms
+             * @description Cumulative milliseconds the run was parked waiting for a human decision on a human_in_the_loop step.  Subtracted from active duration in run-detail and duration-stats responses.
+             */
+            hitl_wait_ms?: number | null;
             /**
              * Input
              * @description Input provided to the agent for this run.
@@ -246,6 +284,11 @@ interface components {
              * @description Output produced by the agent run.
              */
             output: string | null;
+            /**
+             * Output Content Type
+             * @description MIME type of `output` — mirrors the terminal step's `output_content_type`.  Consumers interpret `output` differently depending on this value: `application/vnd.seclai.manifest+json` is a multi-asset manifest with shape `{text, attachments: [{storage_key, mime, name, bytes}]}` — fetch each attachment via `GET /authenticated/storage-blobs/{storage_key}`.  `text/plain` / `text/*` are free-form text.  `application/json` is a JSON document.  Null on runs that produced no terminal output or that pre-date this column.
+             */
+            output_content_type?: string | null;
             /**
              * Priority
              * @description Indicates if the run was treated as a priority execution.
@@ -318,6 +361,11 @@ interface components {
              * @description Type of the agent step.
              */
             step_type: string;
+            /**
+             * Tool Calls
+             * @description LLM tool calls made during this step (prompt_call steps only), ordered by execution. Empty for steps that invoked no tools.
+             */
+            tool_calls?: components["schemas"]["AgentRunToolCallResponse"][];
         };
         /** AgentRunStreamRequest */
         AgentRunStreamRequest: {
@@ -328,9 +376,14 @@ interface components {
             input?: string | null;
             /**
              * Input Upload Id
-             * @description ID of a previously uploaded file (via POST /{agent_id}/upload-input) to use as the run input for dynamic-input triggers. Mutually exclusive with the 'input' field.
+             * @description ID of a previously uploaded file (via POST /{agent_id}/upload-input) to use as the run input for dynamic-input triggers. Mutually exclusive with the 'input' field. Use ``input_upload_ids`` to attach multiple files. Subject to the same per-batch attachment-selector validation as the non-streaming endpoint.
              */
             input_upload_id?: string | null;
+            /**
+             * Input Upload Ids
+             * @description IDs of multiple previously uploaded files. See the non-streaming endpoint for full semantics, including per-batch selector validation (exact names, indexed references, and glob patterns must all be satisfied or the run is rejected with HTTP 400). Max 20.
+             */
+            input_upload_ids?: string[] | null;
             /**
              * Metadata
              * @description Metadata to make available for string substitution expressions in agent tasks.
@@ -338,6 +391,81 @@ interface components {
             metadata?: {
                 [key: string]: components["schemas"]["JsonValue"];
             } | null;
+            /**
+             * Replay Of Run Id
+             * @description Re-run reusing a prior run's uploaded input files (re-resolved server-side from the source run, which must belong to this account and agent). A fresh upload batch takes precedence.
+             */
+            replay_of_run_id?: string | null;
+        };
+        /**
+         * AgentRunToolCallResponse
+         * @description A single LLM tool call made during a prompt_call step.
+         */
+        AgentRunToolCallResponse: {
+            /**
+             * Credits Used
+             * @description Credits consumed by this tool call (0 for tools that don't bill).
+             * @default 0
+             */
+            credits_used: number;
+            /**
+             * Duration Seconds
+             * @description Duration of the tool call in seconds.
+             */
+            duration_seconds?: number | null;
+            /**
+             * Ended At
+             * @description Timestamp when the tool call ended.
+             */
+            ended_at?: string | null;
+            /**
+             * Error
+             * @description Error message when the tool call failed.
+             */
+            error?: string | null;
+            /**
+             * Function Name
+             * @description Name of the tool/function invoked.
+             */
+            function_name: string;
+            /**
+             * Id
+             * @description Tool call identifier.
+             */
+            id: string;
+            /**
+             * Input
+             * @description JSON arguments the LLM passed to the tool, if persisted.
+             */
+            input?: string | null;
+            /**
+             * Output
+             * @description JSON result the tool returned to the LLM, if persisted.
+             */
+            output?: string | null;
+            /**
+             * Round Index
+             * @description 0-based tool-loop round this call belonged to.
+             * @default 0
+             */
+            round_index: number;
+            /**
+             * Sequence
+             * @description 0-based ordinal of this call within its step run.
+             * @default 0
+             */
+            sequence: number;
+            /**
+             * Started At
+             * @description Timestamp when the tool call started.
+             */
+            started_at?: string | null;
+            /**
+             * Succeeded
+             * @description Whether the tool call completed without error.
+             * @default true
+             */
+            succeeded: boolean;
         };
         /** AgentSummaryResponse */
         AgentSummaryResponse: {
@@ -417,7 +545,7 @@ interface components {
              * Trigger Type
              * @description Trigger type for the agent.
              */
-            trigger_type: string | null;
+            trigger_type?: string | null;
             /**
              * Updated At
              * @description ISO 8601 last-updated timestamp.
@@ -533,17 +661,6 @@ interface components {
             /** Flagged */
             flagged: boolean;
         };
-        /**
-         * AiAssistantGenerateRequest
-         * @description Request body for AI assistant generate endpoints.
-         */
-        AiAssistantGenerateRequest: {
-            /**
-             * User Input
-             * @description User input describing what to do
-             */
-            user_input: string;
-        };
         /**
          * AiAssistantGenerateResponse
          * @description Response from an AI assistant generate endpoint.
@@ -667,6 +784,20 @@ interface components {
              */
             success: boolean;
         };
+        /**
+         * AttachmentRefsSourceApiSummary
+         * @description Per-source attachment-reference summary.
+         */
+        AttachmentRefsSourceApiSummary: {
+            /** Exact Names */
+            exact_names?: string[];
+            /** Indexes Max */
+            indexes_max?: number | null;
+            /** Kinds */
+            kinds?: string[];
+            /** Patterns */
+            patterns?: string[];
+        };
         /** 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: {
             /**
@@ -1695,8 +1826,8 @@ interface components {
          *
          *     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.
+         *     See ``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
@@ -1779,6 +1910,35 @@ interface components {
              */
             title?: string | null;
         };
+        /**
+         * InsufficientCreditsDetail
+         * @description ``detail`` body for a 402 ``insufficient_credits`` response.
+         */
+        InsufficientCreditsDetail: {
+            /**
+             * Account Id
+             * @description UUID of the account that ran out of credits.
+             */
+            account_id: string;
+            /**
+             * Error
+             * @description Stable machine-readable error code.
+             * @constant
+             */
+            error: "insufficient_credits";
+            /**
+             * Message
+             * @description Human-readable explanation.
+             */
+            message: string;
+        };
+        /**
+         * InsufficientCreditsResponse
+         * @description 402 envelope returned when the account has exhausted its credits.
+         */
+        InsufficientCreditsResponse: {
+            detail: components["schemas"]["InsufficientCreditsDetail"];
+        };
         JsonValue: unknown;
         /**
          * KnowledgeBaseListResponseModel
@@ -2104,6 +2264,24 @@ interface components {
              */
             updated_at: string;
         };
+        /**
+         * ModalityRateResponse
+         * @description Per-modality rate for an LLM that prices image/audio/video output
+         *     (or input) at a rate distinct from the default text rate.
+         *
+         *     Example: Gemini 3.1 Flash Image charges $3/1M output tokens for
+         *     text but $60/1M output tokens for generated images.  The image rate
+         *     surfaces here with ``modality="image"`` and ``output_credits_per_1000_tokens``
+         *     set; the default text rate stays on the parent model fields.
+         */
+        ModalityRateResponse: {
+            /** Input Credits Per 1000 Tokens */
+            input_credits_per_1000_tokens?: number | null;
+            /** Modality */
+            modality: string;
+            /** Output Credits Per 1000 Tokens */
+            output_credits_per_1000_tokens?: number | null;
+        };
         /** OrganizationAlertPreferenceListResponse */
         OrganizationAlertPreferenceListResponse: {
             /** Preferences */
@@ -2148,7 +2326,7 @@ interface components {
          * PendingProcessingCompletedFailedStatus
          * @enum {string}
          */
-        PendingProcessingCompletedFailedStatus: "pending" | "processing" | "completed" | "failed";
+        PendingProcessingCompletedFailedStatus: "pending" | "processing" | "completed" | "failed" | "waiting_human";
         /**
          * PlaygroundCreateRequest
          * @description Create a model playground experiment via the public API.
@@ -3627,11 +3805,6 @@ interface components {
          * @description Request body for the memory bank AI assistant.
          */
         routers__api__memory_banks__MemoryBankAiAssistantRequest: {
-            /**
-             * Conversation Id
-             * @description Previous conversation ID to continue.
-             */
-            conversation_id?: string | null;
             /**
              * Current Config
              * @description Current configuration to refine, if any.
@@ -3639,6 +3812,11 @@ interface components {
             current_config?: {
                 [key: string]: unknown;
             } | null;
+            /**
+             * History Since
+             * @description Optional ISO 8601 timestamp.  When set, only conversation turns created at or after this timestamp are loaded as context, scoping history to the current session so the assistant remembers earlier turns in a multi-turn refinement.
+             */
+            history_since?: string | null;
             /**
              * User Input
              * @description Natural-language description of the memory bank.
@@ -3732,6 +3910,22 @@ interface components {
              */
             solution_name?: string | null;
         };
+        /**
+         * AiAssistantGenerateRequest
+         * @description Request body for AI assistant generate endpoints.
+         */
+        routers__api__solutions__AiAssistantGenerateRequest: {
+            /**
+             * History Since
+             * @description Optional ISO 8601 timestamp.  When set, only conversation turns created at or after this timestamp are loaded as context, scoping history to the current session so the assistant remembers earlier turns in a create flow.
+             */
+            history_since?: string | null;
+            /**
+             * User Input
+             * @description User input describing what to do
+             */
+            user_input: string;
+        };
         /** SolutionAgentResponse */
         routers__api__solutions__SolutionAgentResponse: {
             /**
@@ -4071,6 +4265,11 @@ interface components {
              * @description ID of the created content version
              */
             content_version_id: string | null;
+            /**
+             * Embedder Warning
+             * @description Set when the file is non-text but the source's embedder is text-only — indexing will rely on OCR / transcription and may produce a FAILED row if no text can be extracted.
+             */
+            embedder_warning?: string | null;
             /**
              * Filename
              * @description Original filename
@@ -4157,6 +4356,8 @@ interface components {
              * @description Source URL used to derive payload_schema guidance for this model.
              */
             payload_schema_source_url?: string | null;
+            /** Per Modality Rates */
+            per_modality_rates?: components["schemas"]["ModalityRateResponse"][];
             /** Provider */
             provider: string;
             /** Released At */
@@ -4179,6 +4380,8 @@ interface components {
             supported_input_media?: string[] | null;
             /** Supported Languages */
             supported_languages?: string[] | null;
+            /** Supported Output Media */
+            supported_output_media?: string[] | null;
             /**
              * Supports Openai Arguments
              * @default false
@@ -4337,6 +4540,8 @@ type AgentRunListResponse = components["schemas"]["routers__api__agents__AgentRu
 type AgentRunStepResponse = components["schemas"]["AgentRunStepResponse"];
 /** Details of a single attempt within an agent run step. */
 type AgentRunAttemptResponse = components["schemas"]["AgentRunAttemptResponse"];
+/** A single LLM tool call made during a `prompt_call` step (within {@link AgentRunStepResponse}'s `tool_calls`). */
+type AgentRunToolCallResponse = components["schemas"]["AgentRunToolCallResponse"];
 /** Search request for agent runs (traces). */
 type AgentTraceSearchRequest = components["schemas"]["routers__api__agents__AgentTraceSearchRequest"];
 /** Search response containing matching agent runs. */
@@ -4345,6 +4550,13 @@ type AgentTraceSearchResponse = components["schemas"]["AgentTraceSearchResponse"
 type AgentTraceMatchResponse = components["schemas"]["AgentTraceMatchResponse"];
 /** Response from uploading a file input for an agent run. */
 type UploadAgentInputApiResponse = components["schemas"]["UploadAgentInputApiResponse"];
+/**
+ * Static attachment-reference contract for an agent — what files (if any) its
+ * templates expect on a run, so uploads can be staged before calling `runAgent`.
+ */
+type AgentAttachmentRefsApiResponse = components["schemas"]["AgentAttachmentRefsApiResponse"];
+/** Per-source attachment-reference summary (exact names, indexes, glob patterns) within an {@link AgentAttachmentRefsApiResponse}. */
+type AttachmentRefsSourceApiSummary = components["schemas"]["AttachmentRefsSourceApiSummary"];
 /** Request body for generating agent workflow steps via AI. */
 type GenerateAgentStepsRequest = components["schemas"]["GenerateAgentStepsRequest"];
 /** Response containing AI-generated agent workflow steps. */
@@ -4498,7 +4710,7 @@ type AddConversationTurnRequest = components["schemas"]["AddConversationTurnRequ
 /** Request body for marking a conversation turn. */
 type MarkConversationTurnRequest = components["schemas"]["MarkConversationTurnRequest"];
 /** AI assistant generate request for solutions. */
-type AiAssistantGenerateRequest = components["schemas"]["AiAssistantGenerateRequest"];
+type AiAssistantGenerateRequest = components["schemas"]["routers__api__solutions__AiAssistantGenerateRequest"];
 /** AI assistant generate response for solutions. */
 type AiAssistantGenerateResponse = components["schemas"]["AiAssistantGenerateResponse"];
 /** AI assistant accept request for solutions. */
@@ -4551,6 +4763,8 @@ type ProviderGroupResponse = components["schemas"]["schemas__model_responses__Pr
 type PromptModelResponse = components["schemas"]["schemas__model_responses__PromptModelResponse"];
 /** Prompt tool configuration within a model. */
 type PromptToolResponse = components["schemas"]["PromptToolResponse"];
+/** Per-modality rate for a model that prices image/audio/video distinctly from its default text rate. */
+type ModalityRateResponse = components["schemas"]["ModalityRateResponse"];
 /** Variant category for model pricing tiers. */
 type VariantCategoryResponse = components["schemas"]["VariantCategoryResponse"];
 /** Variant option with credit pricing and context limits. */
@@ -4564,6 +4778,10 @@ type PlaygroundCreateRequest = components["schemas"]["PlaygroundCreateRequest"];
  * server-side default and can be omitted.
  */
 type CreateExperimentInput = Pick<PlaygroundCreateRequest, "model_ids" | "prompt"> & Partial<Omit<PlaygroundCreateRequest, "model_ids" | "prompt">>;
+/** 402 envelope returned when an account has exhausted its credits. */
+type InsufficientCreditsResponse = components["schemas"]["InsufficientCreditsResponse"];
+/** `detail` body of an {@link InsufficientCreditsResponse} (error code, message, and account id). */
+type InsufficientCreditsDetail = components["schemas"]["InsufficientCreditsDetail"];
 /** Source index mode: fast_and_cheap, balanced, slow_and_thorough, or custom. */
 type SourceIndexMode = components["schemas"]["SourceIndexMode"];
 /** Processing status: pending, processing, completed, or failed. */
@@ -4938,6 +5156,33 @@ declare class Seclai {
      * @returns Upload status and metadata.
      */
     getAgentInputUploadStatus(agentId: string, uploadId: string): Promise<UploadAgentInputApiResponse>;
+    /**
+     * Get the static attachment-reference contract for an agent — what files (if
+     * any) its definition expects on a run.
+     *
+     * Call this before staging uploads to learn whether the agent accepts files
+     * at all (`requires_uploads`) and which specific filenames, indexes, or glob
+     * patterns its templates reference. A run-time upload batch that doesn't
+     * satisfy every declared selector is rejected with HTTP 400.
+     *
+     * @param agentId - Agent identifier.
+     * @returns The agent's attachment-reference contract.
+     */
+    getAgentAttachmentReferences(agentId: string): Promise<AgentAttachmentRefsApiResponse>;
+    /**
+     * Download a file attachment emitted by a step in an agent run.
+     *
+     * Returns the raw `Response` so you can stream or save the binary data.
+     *
+     * @param runId - Run identifier.
+     * @param attachmentId - URL-safe-base64-encoded `storage_key` of the attachment
+     *   (as surfaced in run output manifests and webhook/email payloads).
+     * @param opts - Optional `downloadName` filename hint for the download disposition.
+     * @returns Raw response with the attachment bytes.
+     */
+    downloadAgentRunAttachment(runId: string, attachmentId: string, opts?: {
+        downloadName?: string;
+    }): Promise<Response>;
     /**
      * Generate agent workflow steps from natural language using AI.
      *
@@ -5712,6 +5957,15 @@ declare class Seclai {
      * @param experimentId - Experiment identifier.
      */
     cancelExperiment(experimentId: string): Promise<unknown>;
+    /**
+     * Soft-delete a model playground experiment.
+     *
+     * Removes the experiment from list/detail views while preserving audit
+     * history. Returns HTTP 204 with no body.
+     *
+     * @param experimentId - Experiment identifier.
+     */
+    deleteExperiment(experimentId: string): Promise<void>;
     /**
      * Search across all resource types in your account.
      *
@@ -5759,7 +6013,7 @@ declare class Seclai {
      *
      * @param body - Generation request.
      */
-    aiAssistantMemoryBank(body: AiAssistantGenerateRequest): Promise<MemoryBankAiAssistantResponse>;
+    aiAssistantMemoryBank(body: MemoryBankAiAssistantRequest): Promise<MemoryBankAiAssistantResponse>;
     /**
      * Get AI assistant memory bank conversation history.
      */
@@ -5990,4 +6244,4 @@ declare class SeclaiStreamingError extends SeclaiError {
     constructor(message: string, runId?: string);
 }
 
-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 };
+export { type AccessTokenProvider, type AddCommentRequest, type AddConversationTurnRequest, type AgentAttachmentRefsApiResponse, 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 AgentRunToolCallResponse, 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 AttachmentRefsSourceApiSummary, 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 InsufficientCreditsDetail, type InsufficientCreditsResponse, 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 ModalityRateResponse, 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 };

package/dist/index.js

@@ -1161,6 +1161,37 @@ var Seclai = class {
   async getAgentInputUploadStatus(agentId, uploadId) {
     return await this.request("GET", `/agents/${agentId}/input-uploads/${uploadId}`);
   }
+  /**
+   * Get the static attachment-reference contract for an agent — what files (if
+   * any) its definition expects on a run.
+   *
+   * Call this before staging uploads to learn whether the agent accepts files
+   * at all (`requires_uploads`) and which specific filenames, indexes, or glob
+   * patterns its templates reference. A run-time upload batch that doesn't
+   * satisfy every declared selector is rejected with HTTP 400.
+   *
+   * @param agentId - Agent identifier.
+   * @returns The agent's attachment-reference contract.
+   */
+  async getAgentAttachmentReferences(agentId) {
+    return await this.request("GET", `/agents/${agentId}/attachment-references`);
+  }
+  /**
+   * Download a file attachment emitted by a step in an agent run.
+   *
+   * Returns the raw `Response` so you can stream or save the binary data.
+   *
+   * @param runId - Run identifier.
+   * @param attachmentId - URL-safe-base64-encoded `storage_key` of the attachment
+   *   (as surfaced in run output manifests and webhook/email payloads).
+   * @param opts - Optional `downloadName` filename hint for the download disposition.
+   * @returns Raw response with the attachment bytes.
+   */
+  async downloadAgentRunAttachment(runId, attachmentId, opts = {}) {
+    return await this.requestRaw("GET", `/v2/agent-runs/${runId}/attachments/${attachmentId}`, {
+      query: { download_name: opts.downloadName }
+    });
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // Agent AI Assistant (Steps Generation)
   // ═══════════════════════════════════════════════════════════════════════════
@@ -2200,6 +2231,17 @@ var Seclai = class {
   async cancelExperiment(experimentId) {
     return await this.request("POST", `/models/playground/experiments/${experimentId}/cancel`);
   }
+  /**
+   * Soft-delete a model playground experiment.
+   *
+   * Removes the experiment from list/detail views while preserving audit
+   * history. Returns HTTP 204 with no body.
+   *
+   * @param experimentId - Experiment identifier.
+   */
+  async deleteExperiment(experimentId) {
+    await this.request("DELETE", `/models/playground/experiments/${experimentId}`);
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // Search
   // ═══════════════════════════════════════════════════════════════════════════