mixpeek 0.81.1

package/dist/api/agent-sessions-api.d.ts

@@ -0,0 +1,915 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { Configuration } from '../configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import { type RequestArgs, BaseAPI } from '../base';
+import type { ConfirmationRequest } from '../models';
+import type { CreateSessionRequest } from '../models';
+import type { CreateSessionResponse } from '../models';
+import type { DetectIntentRequest } from '../models';
+import type { GetHistoryResponse } from '../models';
+import type { GetSessionResponse } from '../models';
+import type { IntentClassification } from '../models';
+import type { ListSessionsRequest } from '../models';
+import type { ListSessionsResponse } from '../models';
+import type { ListToolsResponse } from '../models';
+import type { PatchSessionRequest } from '../models';
+import type { PatchSessionResponse } from '../models';
+import type { SendMessageRequest } from '../models';
+import type { SubmitFeedbackRequest } from '../models';
+import type { SubmitFeedbackResponse } from '../models';
+import type { TerminateSessionResponse } from '../models';
+/**
+ * AgentSessionsApi - axios parameter creator
+ * @export
+ */
+export declare const AgentSessionsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Create a new agent session.  A session represents a stateful conversation with an AI agent that can call tools to search data, filter results, and perform multi-step reasoning.  Args:     request: FastAPI request with tenant context     payload: Session creation request  Returns:     CreateSessionResponse with session metadata  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"agent_config\": {           \"model\": \"claude-3-5-sonnet-20241022\",           \"temperature\": 0.7,           \"available_tools\": [\"search_retrievers\", \"execute_retriever\"]         },         \"quotas\": {           \"max_messages\": 100,           \"max_tokens_total\": 100000         }       }\'     ```
+     * @summary Create Session
+     * @param {CreateSessionRequest} createSessionRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \'Bearer sk_xxxxxxxxxxxxx\'. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \'my-namespace\'
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createSessionAgents: (createSessionRequest: CreateSessionRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Detect user intent from natural language request.  This endpoint analyzes a user\'s request to determine whether they want to: - Execute queries on existing data (execution mode) - Create new resources/infrastructure (setup mode) - Or if the request is ambiguous and needs clarification  It performs keyword analysis and checks existing collections to provide intelligent classification and recommendations.  Args:     request: FastAPI request with tenant context     payload: Intent detection request with user\'s input  Returns:     IntentClassification with detected intent and recommendations  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/intent/detect \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_request\": \"I want to search videos by faces\",         \"include_collection_analysis\": true       }\'     ```
+     * @summary Detect Intent
+     * @param {DetectIntentRequest} detectIntentRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    detectIntentAgentsSessions: (detectIntentRequest: DetectIntentRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Get conversation history for a session.  Returns messages in chronological order (oldest first).  Args:     request: FastAPI request with tenant context     session_id: Session identifier     limit: Maximum messages to return (default: 50, max: 200)     offset: Pagination offset (default: 0)  Returns:     GetHistoryResponse with message history  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET \"http://localhost:8000/v1/agents/sessions/ses_abc123/history?limit=20&offset=0\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get History
+     * @param {string} sessionId Session ID
+     * @param {number} [limit] Maximum messages to return
+     * @param {number} [offset] Pagination offset
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getHistoryAgentsSessions: (sessionId: string, limit?: number, offset?: number, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Get session metadata by ID.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     GetSessionResponse with session metadata  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get Session
+     * @param {string} sessionId Session ID
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSessionAgents: (sessionId: string, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * List agent sessions in the namespace.  Args:     request: FastAPI request with tenant context     list_request: Optional filters and sorting     pagination: Pagination parameters  Returns:     ListSessionsResponse with session list  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/list \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"status\": \"active\"}\'     ```
+     * @summary List Sessions
+     * @param {number} [limit]
+     * @param {number} [offset]
+     * @param {string} [cursor]
+     * @param {boolean} [includeTotal]
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {ListSessionsRequest} [listSessionsRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listSessionsAgents: (limit?: number, offset?: number, cursor?: string, includeTotal?: boolean, authorization?: string, authorization2?: string, xNamespace?: string, listSessionsRequest?: ListSessionsRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * List all available agent tools.  Use this endpoint to discover available tools before creating a session.  Tool Categories: - search: Tools for searching data (execute_retriever) - read: Tools for reading resources (list_*, get_*) - create: Tools for creating resources (create_*) - requires confirmation - update: Tools for updating resources (update_*) - requires confirmation - delete: Tools for deleting resources (delete_*) - requires confirmation - upload: Tools for file uploads (upload_object)  Note: Write operations (create, update, delete) require user confirmation via the /confirmations endpoint before execution.  Args:     request: FastAPI request with tenant context     category: Optional filter by tool category  Returns:     ListToolsResponse with available tools  Example:     ```bash     # List all tools     curl -X GET http://localhost:8000/v1/agents/tools \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"      # List only search tools     curl -X GET \"http://localhost:8000/v1/agents/tools?category=search\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary List Tools
+     * @param {string} [category] Filter by tool category
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listToolsAgentsSessions: (category?: string, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Update session metadata.  Only user_memory can be updated. To change agent configuration, create a new session.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Update request  Returns:     PatchSessionResponse with update timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X PATCH http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_memory\": {           \"preferences\": {\"language\": \"en\", \"domain\": \"tech\"}         }       }\'     ```
+     * @summary Patch Session
+     * @param {string} sessionId Session ID
+     * @param {PatchSessionRequest} patchSessionRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    patchSessionAgents: (sessionId: string, patchSessionRequest: PatchSessionRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Respond to a pending confirmation for a write operation.  When the agent requests a write operation (create, update, delete), the stream pauses and emits a `confirmation_required` event. The user must call this endpoint to approve or deny the action.  After responding, this endpoint returns a new SSE stream that continues the agent\'s execution from where it paused.  ## Confirmation Workflow  1. User sends message via POST /sessions/{id}/messages 2. Agent proposes a write operation 3. Stream emits `confirmation_required` event with `confirmation_id` 4. User calls this endpoint with `approved: true/false` 5. This endpoint returns SSE stream continuing the agent\'s work 6. If approved, agent executes the tool and continues 7. If denied, agent acknowledges and continues without executing  ## Confirmation Expiration  Confirmations expire after 5 minutes. Attempting to respond to an expired confirmation returns a 400 error.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     confirmation_id: Confirmation identifier from `confirmation_required` event     payload: Approval/denial decision  Returns:     StreamingResponse with SSE events (continuation of agent execution)  Raises:     NotFoundError: If session or confirmation not found     ValidationError: If confirmation already processed or expired  Example:     ```bash     # Approve a pending action     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc/confirmations/conf_xyz \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"approved\": true}\'      # SSE Output (continuation):     event: tool_result     data: {\"tool_name\": \"delete_collection\", \"success\": true, \"result\": {...}}      event: token     data: {\"content\": \"I\'ve deleted the collection as requested.\"}      event: done     data: {}     ```
+     * @summary Respond To Confirmation
+     * @param {string} sessionId Session ID
+     * @param {string} confirmationId Confirmation ID
+     * @param {ConfirmationRequest} confirmationRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    respondToConfirmationAgentsSessions: (sessionId: string, confirmationId: string, confirmationRequest: ConfirmationRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Send a message to the agent and stream the response.  This endpoint streams Server-Sent Events (SSE) back to the client as the agent processes the message through its workflow.  ## SSE Event Types  **Core Events:** - `intent`: Intent classification result (emitted first)     - `{intent, confidence, category, reasoning, context_scope}` - `thinking`: Agent is analyzing/planning     - `{step, message}` - `tool_call`: Agent is calling a tool     - `{tool_name, tool_call_id, inputs}` - `tool_result`: Tool execution completed     - `{tool_name, tool_call_id, success, output, latency_ms}` - `token`: Response token (streaming)     - `{content}` - `message`: Final response content     - `{content, message_id, is_final}` - `session_name`: Auto-generated session name (first message only)     - `{session_name}` - `done`: Processing complete     - `{latency_ms, tool_calls_made, message_id, retriever_summary, data_accessed_via_retriever}` - `error`: Error occurred     - `{message, recoverable}`  **Retriever Events (IMPORTANT - Primary Data Pathway):** - `retriever_execution`: Retriever was used for data access     - `{tool_name, execution_id, retriever_id, is_adhoc, documents_returned, latency_ms, message}`     - Emitted whenever data is accessed via retriever (saved or ad-hoc) - `pipeline_config`: Ad-hoc retriever configuration     - `{tool_name, config, message}`     - Contains the exact pipeline config users can save as a named retriever  **Retriever Summary in `done` Event:** ```json {   \"retriever_summary\": {     \"used_retrievers\": true,     \"retriever_count\": 2,     \"saved_retrievers\": 1,     \"adhoc_retrievers\": 1,     \"total_documents\": 25,     \"executions\": [...]   },   \"data_accessed_via_retriever\": true } ```  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Message request  Returns:     StreamingResponse with SSE events  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/messages \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"content\": \"Find videos about machine learning\",         \"stream\": true       }\'      # SSE Output:     event: intent     data: {\"intent\": \"retriever_search\", \"confidence\": 0.92, \"category\": \"retriever\"}      event: thinking     data: {\"step\": \"processing\", \"message\": \"Analyzing your request...\"}      event: tool_call     data: {\"tool_name\": \"execute_retriever\", \"tool_call_id\": \"run_abc\", \"inputs\": {...}}      event: tool_result     data: {\"tool_name\": \"execute_retriever\", \"success\": true, \"output\": {...}}      event: retriever_execution     data: {\"tool_name\": \"execute_retriever\", \"is_adhoc\": false, \"documents_returned\": 5}      event: message     data: {\"content\": \"I found 5 videos about machine learning...\", \"is_final\": true}      event: done     data: {\"latency_ms\": 1250.5, \"data_accessed_via_retriever\": true, \"retriever_summary\": {...}}     ```
+     * @summary Send Message
+     * @param {string} sessionId Session ID
+     * @param {SendMessageRequest} sendMessageRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    sendMessageAgentsSessions: (sessionId: string, sendMessageRequest: SendMessageRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Submit feedback on an assistant message.  When positive feedback is received, the conversation exchange is stored to memory for future context. When negative feedback is received, the exchange is NOT stored. This enables learning from quality interactions.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Feedback request  Returns:     SubmitFeedbackResponse with feedback status  Raises:     NotFoundError: If session or message not found  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/feedback \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"message_id\": \"msg_xyz789\",         \"rating\": \"positive\",         \"feedback_text\": \"Very helpful response!\"       }\'     ```
+     * @summary Submit Feedback
+     * @param {string} sessionId Session ID
+     * @param {SubmitFeedbackRequest} submitFeedbackRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitFeedbackAgentsSessions: (sessionId: string, submitFeedbackRequest: SubmitFeedbackRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Terminate a session and kill its actor.  This permanently ends the session and releases all associated resources.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     TerminateSessionResponse with termination timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X DELETE http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Terminate Session
+     * @param {string} sessionId Session ID
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    terminateSessionAgents: (sessionId: string, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * AgentSessionsApi - functional programming interface
+ * @export
+ */
+export declare const AgentSessionsApiFp: (configuration?: Configuration) => {
+    /**
+     * Create a new agent session.  A session represents a stateful conversation with an AI agent that can call tools to search data, filter results, and perform multi-step reasoning.  Args:     request: FastAPI request with tenant context     payload: Session creation request  Returns:     CreateSessionResponse with session metadata  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"agent_config\": {           \"model\": \"claude-3-5-sonnet-20241022\",           \"temperature\": 0.7,           \"available_tools\": [\"search_retrievers\", \"execute_retriever\"]         },         \"quotas\": {           \"max_messages\": 100,           \"max_tokens_total\": 100000         }       }\'     ```
+     * @summary Create Session
+     * @param {CreateSessionRequest} createSessionRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createSessionAgents(createSessionRequest: CreateSessionRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreateSessionResponse>>;
+    /**
+     * Detect user intent from natural language request.  This endpoint analyzes a user\'s request to determine whether they want to: - Execute queries on existing data (execution mode) - Create new resources/infrastructure (setup mode) - Or if the request is ambiguous and needs clarification  It performs keyword analysis and checks existing collections to provide intelligent classification and recommendations.  Args:     request: FastAPI request with tenant context     payload: Intent detection request with user\'s input  Returns:     IntentClassification with detected intent and recommendations  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/intent/detect \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_request\": \"I want to search videos by faces\",         \"include_collection_analysis\": true       }\'     ```
+     * @summary Detect Intent
+     * @param {DetectIntentRequest} detectIntentRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    detectIntentAgentsSessions(detectIntentRequest: DetectIntentRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<IntentClassification>>;
+    /**
+     * Get conversation history for a session.  Returns messages in chronological order (oldest first).  Args:     request: FastAPI request with tenant context     session_id: Session identifier     limit: Maximum messages to return (default: 50, max: 200)     offset: Pagination offset (default: 0)  Returns:     GetHistoryResponse with message history  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET \"http://localhost:8000/v1/agents/sessions/ses_abc123/history?limit=20&offset=0\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get History
+     * @param {string} sessionId Session ID
+     * @param {number} [limit] Maximum messages to return
+     * @param {number} [offset] Pagination offset
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getHistoryAgentsSessions(sessionId: string, limit?: number, offset?: number, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetHistoryResponse>>;
+    /**
+     * Get session metadata by ID.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     GetSessionResponse with session metadata  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get Session
+     * @param {string} sessionId Session ID
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSessionAgents(sessionId: string, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetSessionResponse>>;
+    /**
+     * List agent sessions in the namespace.  Args:     request: FastAPI request with tenant context     list_request: Optional filters and sorting     pagination: Pagination parameters  Returns:     ListSessionsResponse with session list  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/list \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"status\": \"active\"}\'     ```
+     * @summary List Sessions
+     * @param {number} [limit]
+     * @param {number} [offset]
+     * @param {string} [cursor]
+     * @param {boolean} [includeTotal]
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {ListSessionsRequest} [listSessionsRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listSessionsAgents(limit?: number, offset?: number, cursor?: string, includeTotal?: boolean, authorization?: string, authorization2?: string, xNamespace?: string, listSessionsRequest?: ListSessionsRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListSessionsResponse>>;
+    /**
+     * List all available agent tools.  Use this endpoint to discover available tools before creating a session.  Tool Categories: - search: Tools for searching data (execute_retriever) - read: Tools for reading resources (list_*, get_*) - create: Tools for creating resources (create_*) - requires confirmation - update: Tools for updating resources (update_*) - requires confirmation - delete: Tools for deleting resources (delete_*) - requires confirmation - upload: Tools for file uploads (upload_object)  Note: Write operations (create, update, delete) require user confirmation via the /confirmations endpoint before execution.  Args:     request: FastAPI request with tenant context     category: Optional filter by tool category  Returns:     ListToolsResponse with available tools  Example:     ```bash     # List all tools     curl -X GET http://localhost:8000/v1/agents/tools \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"      # List only search tools     curl -X GET \"http://localhost:8000/v1/agents/tools?category=search\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary List Tools
+     * @param {string} [category] Filter by tool category
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listToolsAgentsSessions(category?: string, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListToolsResponse>>;
+    /**
+     * Update session metadata.  Only user_memory can be updated. To change agent configuration, create a new session.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Update request  Returns:     PatchSessionResponse with update timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X PATCH http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_memory\": {           \"preferences\": {\"language\": \"en\", \"domain\": \"tech\"}         }       }\'     ```
+     * @summary Patch Session
+     * @param {string} sessionId Session ID
+     * @param {PatchSessionRequest} patchSessionRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    patchSessionAgents(sessionId: string, patchSessionRequest: PatchSessionRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PatchSessionResponse>>;
+    /**
+     * Respond to a pending confirmation for a write operation.  When the agent requests a write operation (create, update, delete), the stream pauses and emits a `confirmation_required` event. The user must call this endpoint to approve or deny the action.  After responding, this endpoint returns a new SSE stream that continues the agent\'s execution from where it paused.  ## Confirmation Workflow  1. User sends message via POST /sessions/{id}/messages 2. Agent proposes a write operation 3. Stream emits `confirmation_required` event with `confirmation_id` 4. User calls this endpoint with `approved: true/false` 5. This endpoint returns SSE stream continuing the agent\'s work 6. If approved, agent executes the tool and continues 7. If denied, agent acknowledges and continues without executing  ## Confirmation Expiration  Confirmations expire after 5 minutes. Attempting to respond to an expired confirmation returns a 400 error.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     confirmation_id: Confirmation identifier from `confirmation_required` event     payload: Approval/denial decision  Returns:     StreamingResponse with SSE events (continuation of agent execution)  Raises:     NotFoundError: If session or confirmation not found     ValidationError: If confirmation already processed or expired  Example:     ```bash     # Approve a pending action     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc/confirmations/conf_xyz \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"approved\": true}\'      # SSE Output (continuation):     event: tool_result     data: {\"tool_name\": \"delete_collection\", \"success\": true, \"result\": {...}}      event: token     data: {\"content\": \"I\'ve deleted the collection as requested.\"}      event: done     data: {}     ```
+     * @summary Respond To Confirmation
+     * @param {string} sessionId Session ID
+     * @param {string} confirmationId Confirmation ID
+     * @param {ConfirmationRequest} confirmationRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    respondToConfirmationAgentsSessions(sessionId: string, confirmationId: string, confirmationRequest: ConfirmationRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>>;
+    /**
+     * Send a message to the agent and stream the response.  This endpoint streams Server-Sent Events (SSE) back to the client as the agent processes the message through its workflow.  ## SSE Event Types  **Core Events:** - `intent`: Intent classification result (emitted first)     - `{intent, confidence, category, reasoning, context_scope}` - `thinking`: Agent is analyzing/planning     - `{step, message}` - `tool_call`: Agent is calling a tool     - `{tool_name, tool_call_id, inputs}` - `tool_result`: Tool execution completed     - `{tool_name, tool_call_id, success, output, latency_ms}` - `token`: Response token (streaming)     - `{content}` - `message`: Final response content     - `{content, message_id, is_final}` - `session_name`: Auto-generated session name (first message only)     - `{session_name}` - `done`: Processing complete     - `{latency_ms, tool_calls_made, message_id, retriever_summary, data_accessed_via_retriever}` - `error`: Error occurred     - `{message, recoverable}`  **Retriever Events (IMPORTANT - Primary Data Pathway):** - `retriever_execution`: Retriever was used for data access     - `{tool_name, execution_id, retriever_id, is_adhoc, documents_returned, latency_ms, message}`     - Emitted whenever data is accessed via retriever (saved or ad-hoc) - `pipeline_config`: Ad-hoc retriever configuration     - `{tool_name, config, message}`     - Contains the exact pipeline config users can save as a named retriever  **Retriever Summary in `done` Event:** ```json {   \"retriever_summary\": {     \"used_retrievers\": true,     \"retriever_count\": 2,     \"saved_retrievers\": 1,     \"adhoc_retrievers\": 1,     \"total_documents\": 25,     \"executions\": [...]   },   \"data_accessed_via_retriever\": true } ```  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Message request  Returns:     StreamingResponse with SSE events  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/messages \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"content\": \"Find videos about machine learning\",         \"stream\": true       }\'      # SSE Output:     event: intent     data: {\"intent\": \"retriever_search\", \"confidence\": 0.92, \"category\": \"retriever\"}      event: thinking     data: {\"step\": \"processing\", \"message\": \"Analyzing your request...\"}      event: tool_call     data: {\"tool_name\": \"execute_retriever\", \"tool_call_id\": \"run_abc\", \"inputs\": {...}}      event: tool_result     data: {\"tool_name\": \"execute_retriever\", \"success\": true, \"output\": {...}}      event: retriever_execution     data: {\"tool_name\": \"execute_retriever\", \"is_adhoc\": false, \"documents_returned\": 5}      event: message     data: {\"content\": \"I found 5 videos about machine learning...\", \"is_final\": true}      event: done     data: {\"latency_ms\": 1250.5, \"data_accessed_via_retriever\": true, \"retriever_summary\": {...}}     ```
+     * @summary Send Message
+     * @param {string} sessionId Session ID
+     * @param {SendMessageRequest} sendMessageRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    sendMessageAgentsSessions(sessionId: string, sendMessageRequest: SendMessageRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>>;
+    /**
+     * Submit feedback on an assistant message.  When positive feedback is received, the conversation exchange is stored to memory for future context. When negative feedback is received, the exchange is NOT stored. This enables learning from quality interactions.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Feedback request  Returns:     SubmitFeedbackResponse with feedback status  Raises:     NotFoundError: If session or message not found  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/feedback \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"message_id\": \"msg_xyz789\",         \"rating\": \"positive\",         \"feedback_text\": \"Very helpful response!\"       }\'     ```
+     * @summary Submit Feedback
+     * @param {string} sessionId Session ID
+     * @param {SubmitFeedbackRequest} submitFeedbackRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitFeedbackAgentsSessions(sessionId: string, submitFeedbackRequest: SubmitFeedbackRequest, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SubmitFeedbackResponse>>;
+    /**
+     * Terminate a session and kill its actor.  This permanently ends the session and releases all associated resources.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     TerminateSessionResponse with termination timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X DELETE http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Terminate Session
+     * @param {string} sessionId Session ID
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {string} [authorization2]
+     * @param {string} [xNamespace] REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    terminateSessionAgents(sessionId: string, authorization?: string, authorization2?: string, xNamespace?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<TerminateSessionResponse>>;
+};
+/**
+ * AgentSessionsApi - factory interface
+ * @export
+ */
+export declare const AgentSessionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Create a new agent session.  A session represents a stateful conversation with an AI agent that can call tools to search data, filter results, and perform multi-step reasoning.  Args:     request: FastAPI request with tenant context     payload: Session creation request  Returns:     CreateSessionResponse with session metadata  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"agent_config\": {           \"model\": \"claude-3-5-sonnet-20241022\",           \"temperature\": 0.7,           \"available_tools\": [\"search_retrievers\", \"execute_retriever\"]         },         \"quotas\": {           \"max_messages\": 100,           \"max_tokens_total\": 100000         }       }\'     ```
+     * @summary Create Session
+     * @param {AgentSessionsApiCreateSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createSessionAgents(requestParameters: AgentSessionsApiCreateSessionAgentsRequest, options?: RawAxiosRequestConfig): AxiosPromise<CreateSessionResponse>;
+    /**
+     * Detect user intent from natural language request.  This endpoint analyzes a user\'s request to determine whether they want to: - Execute queries on existing data (execution mode) - Create new resources/infrastructure (setup mode) - Or if the request is ambiguous and needs clarification  It performs keyword analysis and checks existing collections to provide intelligent classification and recommendations.  Args:     request: FastAPI request with tenant context     payload: Intent detection request with user\'s input  Returns:     IntentClassification with detected intent and recommendations  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/intent/detect \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_request\": \"I want to search videos by faces\",         \"include_collection_analysis\": true       }\'     ```
+     * @summary Detect Intent
+     * @param {AgentSessionsApiDetectIntentAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    detectIntentAgentsSessions(requestParameters: AgentSessionsApiDetectIntentAgentsSessionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<IntentClassification>;
+    /**
+     * Get conversation history for a session.  Returns messages in chronological order (oldest first).  Args:     request: FastAPI request with tenant context     session_id: Session identifier     limit: Maximum messages to return (default: 50, max: 200)     offset: Pagination offset (default: 0)  Returns:     GetHistoryResponse with message history  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET \"http://localhost:8000/v1/agents/sessions/ses_abc123/history?limit=20&offset=0\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get History
+     * @param {AgentSessionsApiGetHistoryAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getHistoryAgentsSessions(requestParameters: AgentSessionsApiGetHistoryAgentsSessionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<GetHistoryResponse>;
+    /**
+     * Get session metadata by ID.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     GetSessionResponse with session metadata  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get Session
+     * @param {AgentSessionsApiGetSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSessionAgents(requestParameters: AgentSessionsApiGetSessionAgentsRequest, options?: RawAxiosRequestConfig): AxiosPromise<GetSessionResponse>;
+    /**
+     * List agent sessions in the namespace.  Args:     request: FastAPI request with tenant context     list_request: Optional filters and sorting     pagination: Pagination parameters  Returns:     ListSessionsResponse with session list  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/list \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"status\": \"active\"}\'     ```
+     * @summary List Sessions
+     * @param {AgentSessionsApiListSessionsAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listSessionsAgents(requestParameters?: AgentSessionsApiListSessionsAgentsRequest, options?: RawAxiosRequestConfig): AxiosPromise<ListSessionsResponse>;
+    /**
+     * List all available agent tools.  Use this endpoint to discover available tools before creating a session.  Tool Categories: - search: Tools for searching data (execute_retriever) - read: Tools for reading resources (list_*, get_*) - create: Tools for creating resources (create_*) - requires confirmation - update: Tools for updating resources (update_*) - requires confirmation - delete: Tools for deleting resources (delete_*) - requires confirmation - upload: Tools for file uploads (upload_object)  Note: Write operations (create, update, delete) require user confirmation via the /confirmations endpoint before execution.  Args:     request: FastAPI request with tenant context     category: Optional filter by tool category  Returns:     ListToolsResponse with available tools  Example:     ```bash     # List all tools     curl -X GET http://localhost:8000/v1/agents/tools \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"      # List only search tools     curl -X GET \"http://localhost:8000/v1/agents/tools?category=search\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary List Tools
+     * @param {AgentSessionsApiListToolsAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listToolsAgentsSessions(requestParameters?: AgentSessionsApiListToolsAgentsSessionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<ListToolsResponse>;
+    /**
+     * Update session metadata.  Only user_memory can be updated. To change agent configuration, create a new session.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Update request  Returns:     PatchSessionResponse with update timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X PATCH http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_memory\": {           \"preferences\": {\"language\": \"en\", \"domain\": \"tech\"}         }       }\'     ```
+     * @summary Patch Session
+     * @param {AgentSessionsApiPatchSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    patchSessionAgents(requestParameters: AgentSessionsApiPatchSessionAgentsRequest, options?: RawAxiosRequestConfig): AxiosPromise<PatchSessionResponse>;
+    /**
+     * Respond to a pending confirmation for a write operation.  When the agent requests a write operation (create, update, delete), the stream pauses and emits a `confirmation_required` event. The user must call this endpoint to approve or deny the action.  After responding, this endpoint returns a new SSE stream that continues the agent\'s execution from where it paused.  ## Confirmation Workflow  1. User sends message via POST /sessions/{id}/messages 2. Agent proposes a write operation 3. Stream emits `confirmation_required` event with `confirmation_id` 4. User calls this endpoint with `approved: true/false` 5. This endpoint returns SSE stream continuing the agent\'s work 6. If approved, agent executes the tool and continues 7. If denied, agent acknowledges and continues without executing  ## Confirmation Expiration  Confirmations expire after 5 minutes. Attempting to respond to an expired confirmation returns a 400 error.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     confirmation_id: Confirmation identifier from `confirmation_required` event     payload: Approval/denial decision  Returns:     StreamingResponse with SSE events (continuation of agent execution)  Raises:     NotFoundError: If session or confirmation not found     ValidationError: If confirmation already processed or expired  Example:     ```bash     # Approve a pending action     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc/confirmations/conf_xyz \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"approved\": true}\'      # SSE Output (continuation):     event: tool_result     data: {\"tool_name\": \"delete_collection\", \"success\": true, \"result\": {...}}      event: token     data: {\"content\": \"I\'ve deleted the collection as requested.\"}      event: done     data: {}     ```
+     * @summary Respond To Confirmation
+     * @param {AgentSessionsApiRespondToConfirmationAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    respondToConfirmationAgentsSessions(requestParameters: AgentSessionsApiRespondToConfirmationAgentsSessionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<any>;
+    /**
+     * Send a message to the agent and stream the response.  This endpoint streams Server-Sent Events (SSE) back to the client as the agent processes the message through its workflow.  ## SSE Event Types  **Core Events:** - `intent`: Intent classification result (emitted first)     - `{intent, confidence, category, reasoning, context_scope}` - `thinking`: Agent is analyzing/planning     - `{step, message}` - `tool_call`: Agent is calling a tool     - `{tool_name, tool_call_id, inputs}` - `tool_result`: Tool execution completed     - `{tool_name, tool_call_id, success, output, latency_ms}` - `token`: Response token (streaming)     - `{content}` - `message`: Final response content     - `{content, message_id, is_final}` - `session_name`: Auto-generated session name (first message only)     - `{session_name}` - `done`: Processing complete     - `{latency_ms, tool_calls_made, message_id, retriever_summary, data_accessed_via_retriever}` - `error`: Error occurred     - `{message, recoverable}`  **Retriever Events (IMPORTANT - Primary Data Pathway):** - `retriever_execution`: Retriever was used for data access     - `{tool_name, execution_id, retriever_id, is_adhoc, documents_returned, latency_ms, message}`     - Emitted whenever data is accessed via retriever (saved or ad-hoc) - `pipeline_config`: Ad-hoc retriever configuration     - `{tool_name, config, message}`     - Contains the exact pipeline config users can save as a named retriever  **Retriever Summary in `done` Event:** ```json {   \"retriever_summary\": {     \"used_retrievers\": true,     \"retriever_count\": 2,     \"saved_retrievers\": 1,     \"adhoc_retrievers\": 1,     \"total_documents\": 25,     \"executions\": [...]   },   \"data_accessed_via_retriever\": true } ```  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Message request  Returns:     StreamingResponse with SSE events  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/messages \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"content\": \"Find videos about machine learning\",         \"stream\": true       }\'      # SSE Output:     event: intent     data: {\"intent\": \"retriever_search\", \"confidence\": 0.92, \"category\": \"retriever\"}      event: thinking     data: {\"step\": \"processing\", \"message\": \"Analyzing your request...\"}      event: tool_call     data: {\"tool_name\": \"execute_retriever\", \"tool_call_id\": \"run_abc\", \"inputs\": {...}}      event: tool_result     data: {\"tool_name\": \"execute_retriever\", \"success\": true, \"output\": {...}}      event: retriever_execution     data: {\"tool_name\": \"execute_retriever\", \"is_adhoc\": false, \"documents_returned\": 5}      event: message     data: {\"content\": \"I found 5 videos about machine learning...\", \"is_final\": true}      event: done     data: {\"latency_ms\": 1250.5, \"data_accessed_via_retriever\": true, \"retriever_summary\": {...}}     ```
+     * @summary Send Message
+     * @param {AgentSessionsApiSendMessageAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    sendMessageAgentsSessions(requestParameters: AgentSessionsApiSendMessageAgentsSessionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<any>;
+    /**
+     * Submit feedback on an assistant message.  When positive feedback is received, the conversation exchange is stored to memory for future context. When negative feedback is received, the exchange is NOT stored. This enables learning from quality interactions.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Feedback request  Returns:     SubmitFeedbackResponse with feedback status  Raises:     NotFoundError: If session or message not found  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/feedback \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"message_id\": \"msg_xyz789\",         \"rating\": \"positive\",         \"feedback_text\": \"Very helpful response!\"       }\'     ```
+     * @summary Submit Feedback
+     * @param {AgentSessionsApiSubmitFeedbackAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitFeedbackAgentsSessions(requestParameters: AgentSessionsApiSubmitFeedbackAgentsSessionsRequest, options?: RawAxiosRequestConfig): AxiosPromise<SubmitFeedbackResponse>;
+    /**
+     * Terminate a session and kill its actor.  This permanently ends the session and releases all associated resources.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     TerminateSessionResponse with termination timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X DELETE http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Terminate Session
+     * @param {AgentSessionsApiTerminateSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    terminateSessionAgents(requestParameters: AgentSessionsApiTerminateSessionAgentsRequest, options?: RawAxiosRequestConfig): AxiosPromise<TerminateSessionResponse>;
+};
+/**
+ * Request parameters for createSessionAgents operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiCreateSessionAgentsRequest
+ */
+export interface AgentSessionsApiCreateSessionAgentsRequest {
+    /**
+     *
+     * @type {CreateSessionRequest}
+     * @memberof AgentSessionsApiCreateSessionAgents
+     */
+    readonly createSessionRequest: CreateSessionRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiCreateSessionAgents
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiCreateSessionAgents
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiCreateSessionAgents
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for detectIntentAgentsSessions operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiDetectIntentAgentsSessionsRequest
+ */
+export interface AgentSessionsApiDetectIntentAgentsSessionsRequest {
+    /**
+     *
+     * @type {DetectIntentRequest}
+     * @memberof AgentSessionsApiDetectIntentAgentsSessions
+     */
+    readonly detectIntentRequest: DetectIntentRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiDetectIntentAgentsSessions
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiDetectIntentAgentsSessions
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiDetectIntentAgentsSessions
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for getHistoryAgentsSessions operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiGetHistoryAgentsSessionsRequest
+ */
+export interface AgentSessionsApiGetHistoryAgentsSessionsRequest {
+    /**
+     * Session ID
+     * @type {string}
+     * @memberof AgentSessionsApiGetHistoryAgentsSessions
+     */
+    readonly sessionId: string;
+    /**
+     * Maximum messages to return
+     * @type {number}
+     * @memberof AgentSessionsApiGetHistoryAgentsSessions
+     */
+    readonly limit?: number;
+    /**
+     * Pagination offset
+     * @type {number}
+     * @memberof AgentSessionsApiGetHistoryAgentsSessions
+     */
+    readonly offset?: number;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiGetHistoryAgentsSessions
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiGetHistoryAgentsSessions
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiGetHistoryAgentsSessions
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for getSessionAgents operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiGetSessionAgentsRequest
+ */
+export interface AgentSessionsApiGetSessionAgentsRequest {
+    /**
+     * Session ID
+     * @type {string}
+     * @memberof AgentSessionsApiGetSessionAgents
+     */
+    readonly sessionId: string;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiGetSessionAgents
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiGetSessionAgents
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiGetSessionAgents
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for listSessionsAgents operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiListSessionsAgentsRequest
+ */
+export interface AgentSessionsApiListSessionsAgentsRequest {
+    /**
+     *
+     * @type {number}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly limit?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly offset?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly cursor?: string;
+    /**
+     *
+     * @type {boolean}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly includeTotal?: boolean;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly xNamespace?: string;
+    /**
+     *
+     * @type {ListSessionsRequest}
+     * @memberof AgentSessionsApiListSessionsAgents
+     */
+    readonly listSessionsRequest?: ListSessionsRequest;
+}
+/**
+ * Request parameters for listToolsAgentsSessions operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiListToolsAgentsSessionsRequest
+ */
+export interface AgentSessionsApiListToolsAgentsSessionsRequest {
+    /**
+     * Filter by tool category
+     * @type {string}
+     * @memberof AgentSessionsApiListToolsAgentsSessions
+     */
+    readonly category?: string;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiListToolsAgentsSessions
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiListToolsAgentsSessions
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiListToolsAgentsSessions
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for patchSessionAgents operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiPatchSessionAgentsRequest
+ */
+export interface AgentSessionsApiPatchSessionAgentsRequest {
+    /**
+     * Session ID
+     * @type {string}
+     * @memberof AgentSessionsApiPatchSessionAgents
+     */
+    readonly sessionId: string;
+    /**
+     *
+     * @type {PatchSessionRequest}
+     * @memberof AgentSessionsApiPatchSessionAgents
+     */
+    readonly patchSessionRequest: PatchSessionRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiPatchSessionAgents
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiPatchSessionAgents
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiPatchSessionAgents
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for respondToConfirmationAgentsSessions operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiRespondToConfirmationAgentsSessionsRequest
+ */
+export interface AgentSessionsApiRespondToConfirmationAgentsSessionsRequest {
+    /**
+     * Session ID
+     * @type {string}
+     * @memberof AgentSessionsApiRespondToConfirmationAgentsSessions
+     */
+    readonly sessionId: string;
+    /**
+     * Confirmation ID
+     * @type {string}
+     * @memberof AgentSessionsApiRespondToConfirmationAgentsSessions
+     */
+    readonly confirmationId: string;
+    /**
+     *
+     * @type {ConfirmationRequest}
+     * @memberof AgentSessionsApiRespondToConfirmationAgentsSessions
+     */
+    readonly confirmationRequest: ConfirmationRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiRespondToConfirmationAgentsSessions
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiRespondToConfirmationAgentsSessions
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiRespondToConfirmationAgentsSessions
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for sendMessageAgentsSessions operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiSendMessageAgentsSessionsRequest
+ */
+export interface AgentSessionsApiSendMessageAgentsSessionsRequest {
+    /**
+     * Session ID
+     * @type {string}
+     * @memberof AgentSessionsApiSendMessageAgentsSessions
+     */
+    readonly sessionId: string;
+    /**
+     *
+     * @type {SendMessageRequest}
+     * @memberof AgentSessionsApiSendMessageAgentsSessions
+     */
+    readonly sendMessageRequest: SendMessageRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiSendMessageAgentsSessions
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiSendMessageAgentsSessions
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiSendMessageAgentsSessions
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for submitFeedbackAgentsSessions operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiSubmitFeedbackAgentsSessionsRequest
+ */
+export interface AgentSessionsApiSubmitFeedbackAgentsSessionsRequest {
+    /**
+     * Session ID
+     * @type {string}
+     * @memberof AgentSessionsApiSubmitFeedbackAgentsSessions
+     */
+    readonly sessionId: string;
+    /**
+     *
+     * @type {SubmitFeedbackRequest}
+     * @memberof AgentSessionsApiSubmitFeedbackAgentsSessions
+     */
+    readonly submitFeedbackRequest: SubmitFeedbackRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiSubmitFeedbackAgentsSessions
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiSubmitFeedbackAgentsSessions
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiSubmitFeedbackAgentsSessions
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * Request parameters for terminateSessionAgents operation in AgentSessionsApi.
+ * @export
+ * @interface AgentSessionsApiTerminateSessionAgentsRequest
+ */
+export interface AgentSessionsApiTerminateSessionAgentsRequest {
+    /**
+     * Session ID
+     * @type {string}
+     * @memberof AgentSessionsApiTerminateSessionAgents
+     */
+    readonly sessionId: string;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof AgentSessionsApiTerminateSessionAgents
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentSessionsApiTerminateSessionAgents
+     */
+    readonly authorization2?: string;
+    /**
+     * REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like \&#39;my-namespace\&#39;
+     * @type {string}
+     * @memberof AgentSessionsApiTerminateSessionAgents
+     */
+    readonly xNamespace?: string;
+}
+/**
+ * AgentSessionsApi - object-oriented interface
+ * @export
+ * @class AgentSessionsApi
+ * @extends {BaseAPI}
+ */
+export declare class AgentSessionsApi extends BaseAPI {
+    /**
+     * Create a new agent session.  A session represents a stateful conversation with an AI agent that can call tools to search data, filter results, and perform multi-step reasoning.  Args:     request: FastAPI request with tenant context     payload: Session creation request  Returns:     CreateSessionResponse with session metadata  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"agent_config\": {           \"model\": \"claude-3-5-sonnet-20241022\",           \"temperature\": 0.7,           \"available_tools\": [\"search_retrievers\", \"execute_retriever\"]         },         \"quotas\": {           \"max_messages\": 100,           \"max_tokens_total\": 100000         }       }\'     ```
+     * @summary Create Session
+     * @param {AgentSessionsApiCreateSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    createSessionAgents(requestParameters: AgentSessionsApiCreateSessionAgentsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CreateSessionResponse, any, {}>>;
+    /**
+     * Detect user intent from natural language request.  This endpoint analyzes a user\'s request to determine whether they want to: - Execute queries on existing data (execution mode) - Create new resources/infrastructure (setup mode) - Or if the request is ambiguous and needs clarification  It performs keyword analysis and checks existing collections to provide intelligent classification and recommendations.  Args:     request: FastAPI request with tenant context     payload: Intent detection request with user\'s input  Returns:     IntentClassification with detected intent and recommendations  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/intent/detect \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_request\": \"I want to search videos by faces\",         \"include_collection_analysis\": true       }\'     ```
+     * @summary Detect Intent
+     * @param {AgentSessionsApiDetectIntentAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    detectIntentAgentsSessions(requestParameters: AgentSessionsApiDetectIntentAgentsSessionsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<IntentClassification, any, {}>>;
+    /**
+     * Get conversation history for a session.  Returns messages in chronological order (oldest first).  Args:     request: FastAPI request with tenant context     session_id: Session identifier     limit: Maximum messages to return (default: 50, max: 200)     offset: Pagination offset (default: 0)  Returns:     GetHistoryResponse with message history  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET \"http://localhost:8000/v1/agents/sessions/ses_abc123/history?limit=20&offset=0\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get History
+     * @param {AgentSessionsApiGetHistoryAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    getHistoryAgentsSessions(requestParameters: AgentSessionsApiGetHistoryAgentsSessionsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GetHistoryResponse, any, {}>>;
+    /**
+     * Get session metadata by ID.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     GetSessionResponse with session metadata  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X GET http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Get Session
+     * @param {AgentSessionsApiGetSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    getSessionAgents(requestParameters: AgentSessionsApiGetSessionAgentsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GetSessionResponse, any, {}>>;
+    /**
+     * List agent sessions in the namespace.  Args:     request: FastAPI request with tenant context     list_request: Optional filters and sorting     pagination: Pagination parameters  Returns:     ListSessionsResponse with session list  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/list \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"status\": \"active\"}\'     ```
+     * @summary List Sessions
+     * @param {AgentSessionsApiListSessionsAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    listSessionsAgents(requestParameters?: AgentSessionsApiListSessionsAgentsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ListSessionsResponse, any, {}>>;
+    /**
+     * List all available agent tools.  Use this endpoint to discover available tools before creating a session.  Tool Categories: - search: Tools for searching data (execute_retriever) - read: Tools for reading resources (list_*, get_*) - create: Tools for creating resources (create_*) - requires confirmation - update: Tools for updating resources (update_*) - requires confirmation - delete: Tools for deleting resources (delete_*) - requires confirmation - upload: Tools for file uploads (upload_object)  Note: Write operations (create, update, delete) require user confirmation via the /confirmations endpoint before execution.  Args:     request: FastAPI request with tenant context     category: Optional filter by tool category  Returns:     ListToolsResponse with available tools  Example:     ```bash     # List all tools     curl -X GET http://localhost:8000/v1/agents/tools \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"      # List only search tools     curl -X GET \"http://localhost:8000/v1/agents/tools?category=search\" \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary List Tools
+     * @param {AgentSessionsApiListToolsAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    listToolsAgentsSessions(requestParameters?: AgentSessionsApiListToolsAgentsSessionsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ListToolsResponse, any, {}>>;
+    /**
+     * Update session metadata.  Only user_memory can be updated. To change agent configuration, create a new session.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Update request  Returns:     PatchSessionResponse with update timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X PATCH http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"user_memory\": {           \"preferences\": {\"language\": \"en\", \"domain\": \"tech\"}         }       }\'     ```
+     * @summary Patch Session
+     * @param {AgentSessionsApiPatchSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    patchSessionAgents(requestParameters: AgentSessionsApiPatchSessionAgentsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PatchSessionResponse, any, {}>>;
+    /**
+     * Respond to a pending confirmation for a write operation.  When the agent requests a write operation (create, update, delete), the stream pauses and emits a `confirmation_required` event. The user must call this endpoint to approve or deny the action.  After responding, this endpoint returns a new SSE stream that continues the agent\'s execution from where it paused.  ## Confirmation Workflow  1. User sends message via POST /sessions/{id}/messages 2. Agent proposes a write operation 3. Stream emits `confirmation_required` event with `confirmation_id` 4. User calls this endpoint with `approved: true/false` 5. This endpoint returns SSE stream continuing the agent\'s work 6. If approved, agent executes the tool and continues 7. If denied, agent acknowledges and continues without executing  ## Confirmation Expiration  Confirmations expire after 5 minutes. Attempting to respond to an expired confirmation returns a 400 error.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     confirmation_id: Confirmation identifier from `confirmation_required` event     payload: Approval/denial decision  Returns:     StreamingResponse with SSE events (continuation of agent execution)  Raises:     NotFoundError: If session or confirmation not found     ValidationError: If confirmation already processed or expired  Example:     ```bash     # Approve a pending action     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc/confirmations/conf_xyz \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{\"approved\": true}\'      # SSE Output (continuation):     event: tool_result     data: {\"tool_name\": \"delete_collection\", \"success\": true, \"result\": {...}}      event: token     data: {\"content\": \"I\'ve deleted the collection as requested.\"}      event: done     data: {}     ```
+     * @summary Respond To Confirmation
+     * @param {AgentSessionsApiRespondToConfirmationAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    respondToConfirmationAgentsSessions(requestParameters: AgentSessionsApiRespondToConfirmationAgentsSessionsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<any, any, {}>>;
+    /**
+     * Send a message to the agent and stream the response.  This endpoint streams Server-Sent Events (SSE) back to the client as the agent processes the message through its workflow.  ## SSE Event Types  **Core Events:** - `intent`: Intent classification result (emitted first)     - `{intent, confidence, category, reasoning, context_scope}` - `thinking`: Agent is analyzing/planning     - `{step, message}` - `tool_call`: Agent is calling a tool     - `{tool_name, tool_call_id, inputs}` - `tool_result`: Tool execution completed     - `{tool_name, tool_call_id, success, output, latency_ms}` - `token`: Response token (streaming)     - `{content}` - `message`: Final response content     - `{content, message_id, is_final}` - `session_name`: Auto-generated session name (first message only)     - `{session_name}` - `done`: Processing complete     - `{latency_ms, tool_calls_made, message_id, retriever_summary, data_accessed_via_retriever}` - `error`: Error occurred     - `{message, recoverable}`  **Retriever Events (IMPORTANT - Primary Data Pathway):** - `retriever_execution`: Retriever was used for data access     - `{tool_name, execution_id, retriever_id, is_adhoc, documents_returned, latency_ms, message}`     - Emitted whenever data is accessed via retriever (saved or ad-hoc) - `pipeline_config`: Ad-hoc retriever configuration     - `{tool_name, config, message}`     - Contains the exact pipeline config users can save as a named retriever  **Retriever Summary in `done` Event:** ```json {   \"retriever_summary\": {     \"used_retrievers\": true,     \"retriever_count\": 2,     \"saved_retrievers\": 1,     \"adhoc_retrievers\": 1,     \"total_documents\": 25,     \"executions\": [...]   },   \"data_accessed_via_retriever\": true } ```  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Message request  Returns:     StreamingResponse with SSE events  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -N -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/messages \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"content\": \"Find videos about machine learning\",         \"stream\": true       }\'      # SSE Output:     event: intent     data: {\"intent\": \"retriever_search\", \"confidence\": 0.92, \"category\": \"retriever\"}      event: thinking     data: {\"step\": \"processing\", \"message\": \"Analyzing your request...\"}      event: tool_call     data: {\"tool_name\": \"execute_retriever\", \"tool_call_id\": \"run_abc\", \"inputs\": {...}}      event: tool_result     data: {\"tool_name\": \"execute_retriever\", \"success\": true, \"output\": {...}}      event: retriever_execution     data: {\"tool_name\": \"execute_retriever\", \"is_adhoc\": false, \"documents_returned\": 5}      event: message     data: {\"content\": \"I found 5 videos about machine learning...\", \"is_final\": true}      event: done     data: {\"latency_ms\": 1250.5, \"data_accessed_via_retriever\": true, \"retriever_summary\": {...}}     ```
+     * @summary Send Message
+     * @param {AgentSessionsApiSendMessageAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    sendMessageAgentsSessions(requestParameters: AgentSessionsApiSendMessageAgentsSessionsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<any, any, {}>>;
+    /**
+     * Submit feedback on an assistant message.  When positive feedback is received, the conversation exchange is stored to memory for future context. When negative feedback is received, the exchange is NOT stored. This enables learning from quality interactions.  Args:     request: FastAPI request with tenant context     session_id: Session identifier     payload: Feedback request  Returns:     SubmitFeedbackResponse with feedback status  Raises:     NotFoundError: If session or message not found  Example:     ```bash     curl -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/feedback \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\" \\       -H \"Content-Type: application/json\" \\       -d \'{         \"message_id\": \"msg_xyz789\",         \"rating\": \"positive\",         \"feedback_text\": \"Very helpful response!\"       }\'     ```
+     * @summary Submit Feedback
+     * @param {AgentSessionsApiSubmitFeedbackAgentsSessionsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    submitFeedbackAgentsSessions(requestParameters: AgentSessionsApiSubmitFeedbackAgentsSessionsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SubmitFeedbackResponse, any, {}>>;
+    /**
+     * Terminate a session and kill its actor.  This permanently ends the session and releases all associated resources.  Args:     request: FastAPI request with tenant context     session_id: Session identifier  Returns:     TerminateSessionResponse with termination timestamp  Raises:     NotFoundError: If session not found  Example:     ```bash     curl -X DELETE http://localhost:8000/v1/agents/sessions/ses_abc123 \\       -H \"Authorization: Bearer {api_key}\" \\       -H \"X-Namespace: {namespace_id}\"     ```
+     * @summary Terminate Session
+     * @param {AgentSessionsApiTerminateSessionAgentsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentSessionsApi
+     */
+    terminateSessionAgents(requestParameters: AgentSessionsApiTerminateSessionAgentsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<TerminateSessionResponse, any, {}>>;
+}
+//# sourceMappingURL=agent-sessions-api.d.ts.map