@liquidmetal-ai/drizzle 0.3.5 → 0.4.1

package/dist/liquidmetal/v1alpha1/search_agent_pb.d.ts

@@ -1,41 +1,42 @@
 import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { BucketLocator, BucketResponse } from "./bucket_name_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file liquidmetal/v1alpha1/search_agent.proto.
  */
 export declare const file_liquidmetal_v1alpha1_search_agent: GenFile;
 /**
- * DocumentChatRequest initiates or continues a conversation about a specific document.
- * The system maintains conversation context for natural, flowing dialogue about
- * document content.
- *
  * @generated from message liquidmetal.v1alpha1.DocumentChatRequest
  */
 export type DocumentChatRequest = Message<"liquidmetal.v1alpha1.DocumentChatRequest"> & {
     /**
-     * The storage bucket containing the target document
-     * Must be a valid, registered Smart Bucket
+     * __DESCRIPTION__ The storage bucket containing the target document. Must be a valid, registered Smart Bucket. Used to identify which bucket to query against
+     * __EXAMPLE__ {"bucket": {"name": "my-bucket", "version": "01jtgtraw3b5qbahrhvrj3ygbb", "applicationName": "my-app"}}
+     * __REQUIRED__ TRUE
      *
-     * @generated from field: string bucket_id = 1;
+     * @generated from field: liquidmetal.v1alpha1.BucketLocator bucket_location = 1;
      */
-    bucketId: string;
+    bucketLocation?: BucketLocator;
     /**
-     * Document identifier within the bucket
-     * Typically matches the storage path or key
+     * __DESCRIPTION__ Document identifier within the bucket. Typically matches the storage path or key. Used to identify which document to chat with
+     * __EXAMPLE__ "document.pdf"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string object_id = 2;
      */
     objectId: string;
     /**
-     * User's input or question about the document
-     * Can be natural language questions, commands, or requests
+     * __DESCRIPTION__ User's input or question about the document. Can be natural language questions, commands, or requests. The system will process this against the document content
+     * __EXAMPLE__ "What are the key points in this document?"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string input = 3;
      */
     input: string;
     /**
-     * Conversation session identifier
-     * Use the same ID for follow-up questions to maintain context
+     * __DESCRIPTION__ Client-provided conversation session identifier. Required for maintaining context in follow-up questions. We recommend using a UUID or ULID for this value
+     * __EXAMPLE__ "123e4567-e89b-12d3-a456-426614174000"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string request_id = 4;
      */
@@ -55,20 +56,12 @@ export type DocumentChatRequest = Message<"liquidmetal.v1alpha1.DocumentChatRequ
  */
 export declare const DocumentChatRequestSchema: GenMessage<DocumentChatRequest>;
 /**
- * DocumentChatResponse contains the AI's response based on document content
- * and conversation context. Responses are generated considering both the
- * current question and previous conversation history.
- *
  * @generated from message liquidmetal.v1alpha1.DocumentChatResponse
  */
 export type DocumentChatResponse = Message<"liquidmetal.v1alpha1.DocumentChatResponse"> & {
     /**
-     * AI-generated response that may include:
-     * - Direct document quotes
-     * - Content summaries
-     * - Contextual explanations
-     * - References to specific sections
-     * - Related content suggestions
+     * __DESCRIPTION__ AI-generated response that may include direct document quotes, content summaries, contextual explanations, references to specific sections, and related content suggestions
+     * __EXAMPLE__ "Based on the document, the key points are..."
      *
      * @generated from field: string answer = 1;
      */
@@ -80,34 +73,33 @@ export type DocumentChatResponse = Message<"liquidmetal.v1alpha1.DocumentChatRes
  */
 export declare const DocumentChatResponseSchema: GenMessage<DocumentChatResponse>;
 /**
- * RagSearchRequest enables semantic search across document collections using
- * natural language queries. The system automatically optimizes the search
- * strategy based on the query content.
- *
  * @generated from message liquidmetal.v1alpha1.RagSearchRequest
  */
 export type RagSearchRequest = Message<"liquidmetal.v1alpha1.RagSearchRequest"> & {
     /**
-     * Natural language query or question
-     * Can include complex criteria and relationships
+     * __DESCRIPTION__ Natural language query or question. Can include complex criteria and relationships. The system will optimize the search strategy based on this input
+     * __EXAMPLE__ "Find documents about revenue in Q4 2023"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string input = 1;
      */
     input: string;
     /**
-     * Search session identifier for result tracking
-     * Used for pagination and result caching
+     * __DESCRIPTION__ Client-provided search session identifier. Required for pagination and result tracking. We recommend using a UUID or ULID for this value
+     * __EXAMPLE__ "123e4567-e89b-12d3-a456-426614174000"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string request_id = 2;
      */
     requestId: string;
     /**
-     * Bucket IDs to search
-     * If provided, the search will only return results from these buckets
+     * __DESCRIPTION__ The buckets to search. If provided, the search will only return results from these buckets
+     * __EXAMPLE__ [{"bucket": {"name": "my-bucket", "version": "01jtgtraw3b5qbahrhvrj3ygbb", "applicationName": "my-app"}}]
+     * __REQUIRED__ TRUE
      *
-     * @generated from field: repeated string bucket_ids = 3;
+     * @generated from field: repeated liquidmetal.v1alpha1.BucketLocator bucket_locations = 3;
      */
-    bucketIds: string[];
+    bucketLocations: BucketLocator[];
     /**
      * @generated from field: string user_id = 4;
      */
@@ -123,16 +115,12 @@ export type RagSearchRequest = Message<"liquidmetal.v1alpha1.RagSearchRequest">
  */
 export declare const RagSearchRequestSchema: GenMessage<RagSearchRequest>;
 /**
- * RagSearchResponse provides semantically relevant results with metadata
- * and relevance scoring. Results are automatically filtered for PII
- * and ranked by relevance.
- *
  * @generated from message liquidmetal.v1alpha1.RagSearchResponse
  */
 export type RagSearchResponse = Message<"liquidmetal.v1alpha1.RagSearchResponse"> & {
     /**
-     * Ordered list of relevant text segments
-     * Each result includes full context and metadata
+     * __DESCRIPTION__ Ordered list of relevant text segments. Each result includes full context and metadata
+     * __EXAMPLE__ [{"chunkSignature": "chunk_123abc", "text": "Sample text", "score": 0.95}]
      *
      * @generated from field: repeated liquidmetal.v1alpha1.TextResult results = 1;
      */
@@ -148,13 +136,15 @@ export declare const RagSearchResponseSchema: GenMessage<RagSearchResponse>;
  */
 export type SourceResult = Message<"liquidmetal.v1alpha1.SourceResult"> & {
     /**
-     * The bucket identifier containing this result
+     * __DESCRIPTION__ The bucket information containing this result
+     * __EXAMPLE__ {"moduleId": "01jt3vs2nyt2xwk2f54x2bkn84", "bucketName": "mr-bucket"}
      *
-     * @generated from field: string bucket = 1;
+     * @generated from field: liquidmetal.v1alpha1.BucketResponse bucket = 1;
      */
-    bucket: string;
+    bucket?: BucketResponse;
     /**
-     * The object key within the bucket
+     * __DESCRIPTION__ The object key within the bucket
+     * __EXAMPLE__ "document.pdf"
      *
      * @generated from field: string object = 2;
      */
@@ -166,59 +156,54 @@ export type SourceResult = Message<"liquidmetal.v1alpha1.SourceResult"> & {
  */
 export declare const SourceResultSchema: GenMessage<SourceResult>;
 /**
- * TextResult represents a single search result with comprehensive metadata
- * and relevance information. This structure provides all necessary context
- * for understanding and displaying the result.
- *
  * @generated from message liquidmetal.v1alpha1.TextResult
  */
 export type TextResult = Message<"liquidmetal.v1alpha1.TextResult"> & {
     /**
-     * Unique identifier for this text segment
-     * Used for deduplication and result tracking
+     * __DESCRIPTION__ Unique identifier for this text segment. Used for deduplication and result tracking
+     * __EXAMPLE__ "51abb575a5e438a2db5fa064611995dfd76aa14d9e4b2a44c29a6374203126a5"
      *
      * @generated from field: optional string chunk_signature = 1;
      */
     chunkSignature?: string;
     /**
-     * The actual content of the result
-     * May be a document excerpt or full content
+     * __DESCRIPTION__ The actual content of the result. May be a document excerpt or full content
+     * __EXAMPLE__ "This is a sample text chunk from the document"
      *
      * @generated from field: optional string text = 2;
      */
     text?: string;
     /**
-     * List of source document references
-     * Contains bucket and object information for each source
-     * Multiple sources may be provided for results aggregated across documents
+     * __DESCRIPTION__ Source document references. Contains bucket and object information
+     * __EXAMPLE__ {"bucket": {"moduleId": "01jt3vs2nyt2xwk2f54x2bkn84", "bucketName": "mr-bucket"}, "object": "document.pdf"}
      *
      * @generated from field: liquidmetal.v1alpha1.SourceResult source = 3;
      */
     source?: SourceResult;
     /**
-     * Parent document identifier
-     * Links related content chunks together
+     * __DESCRIPTION__ Parent document identifier. Links related content chunks together
+     * __EXAMPLE__ "e2ec3b118e205ff5d627e0c866224a25ba52e6d3ab758a3ef3d49e80908d7444"
      *
      * @generated from field: optional string payload_signature = 4;
      */
     payloadSignature?: string;
     /**
-     * Relevance score (0.0 to 1.0)
-     * Higher scores indicate better matches
+     * __DESCRIPTION__ Relevance score (0.0 to 1.0). Higher scores indicate better matches
+     * __EXAMPLE__ 0.95
      *
      * @generated from field: optional double score = 5;
      */
     score?: number;
     /**
-     * Vector representation for similarity matching
-     * Used in semantic search operations
+     * __DESCRIPTION__ Vector representation for similarity matching. Used in semantic search operations
+     * __EXAMPLE__ "base64_encoded_vector_data"
      *
      * @generated from field: optional string embed = 6;
      */
     embed?: string;
     /**
-     * Content MIME type
-     * Helps with proper result rendering
+     * __DESCRIPTION__ Content MIME type. Helps with proper result rendering
+     * __EXAMPLE__ "application/pdf"
      *
      * @generated from field: optional string type = 7;
      */
@@ -230,42 +215,40 @@ export type TextResult = Message<"liquidmetal.v1alpha1.TextResult"> & {
  */
 export declare const TextResultSchema: GenMessage<TextResult>;
 /**
- * PaginationInfo provides detailed pagination metadata for implementing
- * UI controls and managing result navigation. Supports both traditional
- * pagination and infinite scroll patterns.
- *
  * @generated from message liquidmetal.v1alpha1.PaginationInfo
  */
 export type PaginationInfo = Message<"liquidmetal.v1alpha1.PaginationInfo"> & {
     /**
-     * Total number of available results
+     * __DESCRIPTION__ Total number of available results
+     * __EXAMPLE__ 1020
      *
      * @generated from field: int32 total = 1;
      */
     total: number;
     /**
-     * Current page number (1-based)
+     * __DESCRIPTION__ Current page number (1-based)
+     * __EXAMPLE__ 1
      *
      * @generated from field: int32 page = 2;
      */
     page: number;
     /**
-     * Results per page
-     * May be adjusted for performance
+     * __DESCRIPTION__ Results per page. May be adjusted for performance
+     * __EXAMPLE__ 15
      *
      * @generated from field: int32 page_size = 3;
      */
     pageSize: number;
     /**
-     * Total available pages
-     * Calculated as ceil(total/page_size)
+     * __DESCRIPTION__ Total available pages. Calculated as ceil(total/pageSize)
+     * __EXAMPLE__ 68
      *
      * @generated from field: int32 total_pages = 4;
      */
     totalPages: number;
     /**
-     * Indicates more results available
-     * Used for infinite scroll implementation
+     * __DESCRIPTION__ Indicates more results available. Used for infinite scroll implementation
+     * __EXAMPLE__ true
      *
      * @generated from field: bool has_more = 5;
      */
@@ -277,27 +260,29 @@ export type PaginationInfo = Message<"liquidmetal.v1alpha1.PaginationInfo"> & {
  */
 export declare const PaginationInfoSchema: GenMessage<PaginationInfo>;
 /**
- * CreatePageSummaryRequest requests an AI-generated summary of search results
- * for a specific page. Helps users quickly understand large result sets.
- *
  * @generated from message liquidmetal.v1alpha1.CreatePageSummaryRequest
  */
 export type CreatePageSummaryRequest = Message<"liquidmetal.v1alpha1.CreatePageSummaryRequest"> & {
     /**
-     * Target page number (1-based)
+     * __DESCRIPTION__ Target page number (1-based)
+     * __EXAMPLE__ 1
+     * __REQUIRED__ TRUE
      *
      * @generated from field: int32 page = 1;
      */
     page: number;
     /**
-     * Results per page
-     * Affects summary granularity
+     * __DESCRIPTION__ Results per page. Affects summary granularity
+     * __EXAMPLE__ 10
+     * __REQUIRED__ TRUE
      *
      * @generated from field: int32 page_size = 2;
      */
     pageSize: number;
     /**
-     * Original search session identifier
+     * __DESCRIPTION__ Original search session identifier from the initial search
+     * __EXAMPLE__ "123e4567-e89b-12d3-a456-426614174000"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string request_id = 3;
      */
@@ -317,18 +302,12 @@ export type CreatePageSummaryRequest = Message<"liquidmetal.v1alpha1.CreatePageS
  */
 export declare const CreatePageSummaryRequestSchema: GenMessage<CreatePageSummaryRequest>;
 /**
- * CreatePageSummaryResponse provides an AI-generated overview of the
- * search results page, highlighting key themes and patterns.
- *
  * @generated from message liquidmetal.v1alpha1.CreatePageSummaryResponse
  */
 export type CreatePageSummaryResponse = Message<"liquidmetal.v1alpha1.CreatePageSummaryResponse"> & {
     /**
-     * AI-generated summary including:
-     * - Key themes and topics
-     * - Content type distribution
-     * - Important findings
-     * - Document relationships
+     * __DESCRIPTION__ AI-generated summary including key themes and topics, content type distribution, important findings, and document relationships
+     * __EXAMPLE__ "The search results contain information about..."
      *
      * @generated from field: string summary = 1;
      */
@@ -340,34 +319,33 @@ export type CreatePageSummaryResponse = Message<"liquidmetal.v1alpha1.CreatePage
  */
 export declare const CreatePageSummaryResponseSchema: GenMessage<CreatePageSummaryResponse>;
 /**
- * RunSupervisorAgentRequest initiates a new semantic search operation
- * using natural language queries. The supervisor coordinates multiple
- * search strategies for comprehensive results.
- *
  * @generated from message liquidmetal.v1alpha1.RunSupervisorAgentRequest
  */
 export type RunSupervisorAgentRequest = Message<"liquidmetal.v1alpha1.RunSupervisorAgentRequest"> & {
     /**
-     * Natural language search query
-     * Can include complex criteria
+     * __DESCRIPTION__ Natural language search query that can include complex criteria. Supports queries like finding documents with specific content types, PII, or semantic meaning
+     * __EXAMPLE__ "Show me documents containing credit card numbers or social security numbers"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string input = 1;
      */
     input: string;
     /**
-     * Search session identifier
-     * Used for result tracking
+     * __DESCRIPTION__ Client-provided search session identifier. Required for pagination and result tracking. We recommend using a UUID or ULID for this value
+     * __EXAMPLE__ "123e4567-e89b-12d3-a456-426614174000"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string request_id = 2;
      */
     requestId: string;
     /**
-     * Bucket IDs to search
-     * If provided, the search will only return results from these buckets
+     * __DESCRIPTION__ The buckets to search. If provided, the search will only return results from these buckets
+     * __EXAMPLE__ [{"bucket": {"name": "my-bucket", "version": "01jtgtraw3b5qbahrhvrj3ygbb", "applicationName": "my-app"}}]
+     * __REQUIRED__ TRUE
      *
-     * @generated from field: repeated string bucket_ids = 3;
+     * @generated from field: repeated liquidmetal.v1alpha1.BucketLocator bucket_locations = 3;
      */
-    bucketIds: string[];
+    bucketLocations: BucketLocator[];
     /**
      * @generated from field: string user_id = 4;
      */
@@ -383,20 +361,19 @@ export type RunSupervisorAgentRequest = Message<"liquidmetal.v1alpha1.RunSupervi
  */
 export declare const RunSupervisorAgentRequestSchema: GenMessage<RunSupervisorAgentRequest>;
 /**
- * RunSupervisorAgentResponse provides the initial set of search results
- * along with pagination information for result navigation.
- *
  * @generated from message liquidmetal.v1alpha1.RunSupervisorAgentResponse
  */
 export type RunSupervisorAgentResponse = Message<"liquidmetal.v1alpha1.RunSupervisorAgentResponse"> & {
     /**
-     * Matched results with metadata
+     * __DESCRIPTION__ Matched results with metadata
+     * __EXAMPLE__ [{"chunkSignature": "chunk_123abc", "text": "Sample text", "score": 0.95}]
      *
      * @generated from field: repeated liquidmetal.v1alpha1.TextResult results = 1;
      */
     results: TextResult[];
     /**
-     * Pagination details for result navigation
+     * __DESCRIPTION__ Pagination details for result navigation
+     * __EXAMPLE__ {"total": 100, "page": 1, "pageSize": 10, "totalPages": 10, "hasMore": true}
      *
      * @generated from field: liquidmetal.v1alpha1.PaginationInfo pagination = 2;
      */
@@ -408,26 +385,29 @@ export type RunSupervisorAgentResponse = Message<"liquidmetal.v1alpha1.RunSuperv
  */
 export declare const RunSupervisorAgentResponseSchema: GenMessage<RunSupervisorAgentResponse>;
 /**
- * GetPaginatedResultsRequest retrieves additional pages from a previous
- * search operation. Maintains result consistency across pages.
- *
  * @generated from message liquidmetal.v1alpha1.GetPaginatedResultsRequest
  */
 export type GetPaginatedResultsRequest = Message<"liquidmetal.v1alpha1.GetPaginatedResultsRequest"> & {
     /**
-     * Original search session identifier
+     * __DESCRIPTION__ Original search session identifier from the initial search
+     * __EXAMPLE__ "123e4567-e89b-12d3-a456-426614174000"
+     * __REQUIRED__ TRUE
      *
      * @generated from field: string request_id = 1;
      */
     requestId: string;
     /**
-     * Requested page number
+     * __DESCRIPTION__ Requested page number
+     * __EXAMPLE__ 2
+     * __REQUIRED__ TRUE
      *
      * @generated from field: optional int32 page = 2;
      */
     page?: number;
     /**
-     * Results per page
+     * __DESCRIPTION__ Results per page
+     * __EXAMPLE__ 10
+     * __REQUIRED__ TRUE
      *
      * @generated from field: optional int32 page_size = 3;
      */
@@ -447,20 +427,19 @@ export type GetPaginatedResultsRequest = Message<"liquidmetal.v1alpha1.GetPagina
  */
 export declare const GetPaginatedResultsRequestSchema: GenMessage<GetPaginatedResultsRequest>;
 /**
- * GetPaginatedResultsResponse provides the requested page of results
- * with updated pagination information.
- *
  * @generated from message liquidmetal.v1alpha1.GetPaginatedResultsResponse
  */
 export type GetPaginatedResultsResponse = Message<"liquidmetal.v1alpha1.GetPaginatedResultsResponse"> & {
     /**
-     * Page results with full metadata
+     * __DESCRIPTION__ Page results with full metadata
+     * __EXAMPLE__ [{"chunkSignature": "chunk_123abc", "text": "Sample text", "score": 0.95}]
      *
      * @generated from field: repeated liquidmetal.v1alpha1.TextResult results = 1;
      */
     results: TextResult[];
     /**
-     * Updated pagination information
+     * __DESCRIPTION__ Updated pagination information
+     * __EXAMPLE__ {"total": 100, "page": 2, "pageSize": 10, "totalPages": 10, "hasMore": true}
      *
      * @generated from field: liquidmetal.v1alpha1.PaginationInfo pagination = 2;
      */
@@ -472,41 +451,29 @@ export type GetPaginatedResultsResponse = Message<"liquidmetal.v1alpha1.GetPagin
  */
 export declare const GetPaginatedResultsResponseSchema: GenMessage<GetPaginatedResultsResponse>;
 /**
- * SearchAgentService provides the core functionality for Smart Buckets - Raindrop's intelligent
- * object storage service designed specifically for AI applications. When files are uploaded
- * to a Smart Bucket, they undergo advanced AI decomposition that analyzes and indexes content
- * using state-of-the-art AI models. This includes:
- *
- * - Automated document indexing and processing
- * - Extraction of structured data
- * - Processing through specialized AI models
- * - Storage in optimized formats for AI querying
- * - Automatic PII detection and classification
- *
- * The service supports multiple file types including:
- * - application/pdf
- * - image/jpeg, image/png
- * - audio/webm, audio/wav, audio/mp4, audio/mpeg
- * - text/plain
+ * __TITLE__ Query
+ * The query endpoints provide advanced AI-driven search, conversation, and summarization capabilities for documents and media stored in SmartBuckets.
+ * It enables users and agents to interact naturally with content through conversational chat (DocumentChat), semantic search (RagSearch), and multi-modal queries across text, images, and audio (document_query). The service also supports intelligent summarization of search results (summarize_page) and paginated result navigation.
+ * Designed for seamless integration into AI workflows, these endpoints make complex document exploration, PII detection, and knowledge extraction accessible via simple APIs, eliminating the need for custom pipelines or infrastructure.
  *
  * @generated from service liquidmetal.v1alpha1.SearchAgentService
  */
 export declare const SearchAgentService: GenService<{
     /**
-     * DocumentChat enables natural conversational interactions with documents stored in Smart Buckets.
-     * This creates an intelligent interface for document exploration through natural dialogue, allowing
-     * users to ask questions, request summaries, and extract insights from any supported document type.
+     * Enables natural conversational interactions with documents stored in SmartBuckets. This endpoint allows users
+     * to ask questions, request summaries, and explore document content through an intuitive conversational interface.
+     * The system understands context and can handle complex queries about document contents.
      *
-     * The chat system maintains conversation context, enabling follow-up questions and deep exploration
+     * The query system maintains conversation context throught the request_id, enabling follow-up questions and deep exploration
      * of document content. It works across all supported file types and automatically handles multi-page
-     * documents, making complex document interaction as simple as having a conversation.
+     * documents, making complex file interaction as simple as having a conversation.
      *
      * The system will:
-     * - Maintain conversation history for context
-     * - Process questions against document content
+     * - Maintain conversation history for context when using the same request_id
+     * - Process questions against file content
      * - Generate contextual, relevant responses
-     * - Handle document references and citations
-     * - Support multi-turn conversations about document content
+     *
+     * Document query is supported for all file types, including PDFs, images, and audio files.
      *
      * @generated from rpc liquidmetal.v1alpha1.SearchAgentService.DocumentChat
      */
@@ -516,22 +483,13 @@ export declare const SearchAgentService: GenService<{
         output: typeof DocumentChatResponseSchema;
     };
     /**
-     * RagSearch (Retrieval-Augmented Generation) provides an advanced search capability that serves
-     * as a complete drop-in replacement for traditional RAG pipelines. This system enables AI agents
-     * to leverage private data stored in Smart Buckets with zero additional configuration.
-     *
-     * The RAG system automatically:
-     * - Processes and indexes uploaded content
-     * - Maintains optimal chunk sizes (max 450 tokens)
-     * - Handles document metadata
-     * - Provides relevance scoring
-     * - Manages document versioning
+     * Chunk Search provides search capabilities that serve as a complete
+     * drop-in replacement for traditional RAG pipelines. This system enables
+     * AI agents to leverage private data stored in SmartBuckets with zero
+     * additional configuration.
      *
-     * This creates a foundation for:
-     * - Training AI models with private data
-     * - Building intelligent knowledge bases
-     * - Creating context-aware chatbots
-     * - Implementing semantic search systems
+     * Each input query is processed by our AI agent to determine the best way to search the data.
+     * The system will then return the most relevant results from the data ranked by relevance on the input query.
      *
      * @generated from rpc liquidmetal.v1alpha1.SearchAgentService.RagSearch
      */
@@ -541,9 +499,9 @@ export declare const SearchAgentService: GenService<{
         output: typeof RagSearchResponseSchema;
     };
     /**
-     * CreatePageSummary generates intelligent summaries of search result pages, helping users
+     * Generates intelligent summaries of search result pages, helping users
      * quickly understand large result sets without reading through every document. The system
-     * analyzes the content of all results on a given page and generates a comprehensive overview.
+     * analyzes the content of all results on a given page and generates a detailed overview.
      *
      * The summary system:
      * - Identifies key themes and topics
@@ -566,22 +524,22 @@ export declare const SearchAgentService: GenService<{
         output: typeof CreatePageSummaryResponseSchema;
     };
     /**
-     * RunSupervisorAgent is the primary search interface for Smart Buckets, providing
-     * advanced semantic search capabilities that go far beyond traditional keyword matching.
-     * The supervisor agent orchestrates multiple specialized search strategies to provide
-     * comprehensive, intelligent results.
+     * Primary search endpoint that provides advanced search capabilities across all document types stored in SmartBuckets.
+     *
+     * Supports recursive object search within objects, enabling nested content search like embedded images, text content,
+     * and personally identifiable information (PII).
      *
      * The system supports complex queries like:
-     * - "Show me documents containing credit card numbers or social security numbers"
-     * - "Find images of landscapes taken during sunset"
-     * - "Get documents mentioning revenue forecasts from Q4 2023"
-     * - "Find me all PDF documents that contain pictures of a cat"
+     * - 'Show me documents containing credit card numbers or social security numbers'
+     * - 'Find images of landscapes taken during sunset'
+     * - 'Get documents mentioning revenue forecasts from Q4 2023'
+     * - 'Find me all PDF documents that contain pictures of a cat'
+     * - 'Find me all audio files that contain information about the weather in SF in 2024'
      *
      * Key capabilities:
      * - Natural language query understanding
-     * - Content-based search across text and images
-     * - Automatic PII detection and filtering
-     * - Cross-document relationship analysis
+     * - Content-based search across text, images, and audio
+     * - Automatic PII detection
      * - Multi-modal search (text, images, audio)
      *
      * @generated from rpc liquidmetal.v1alpha1.SearchAgentService.RunSupervisorAgent
@@ -592,16 +550,9 @@ export declare const SearchAgentService: GenService<{
         output: typeof RunSupervisorAgentResponseSchema;
     };
     /**
-     * GetPaginatedResults enables efficient navigation through large result sets while
-     * maintaining search context and result relevance. This method is optimized for
-     * handling large document collections and implementing modern UI patterns.
-     *
-     * Features:
-     * - Consistent result ordering
-     * - Configurable page sizes
-     * - Efficient result caching
-     * - Cursor-based pagination
-     * - Support for infinite scroll
+     * Retrieve additional pages from a previous search. This endpoint enables
+     * navigation through large result sets while maintaining search context and result relevance.
+     * Retrieving paginated results requires a valid request_id from a previously completed search.
      *
      * @generated from rpc liquidmetal.v1alpha1.SearchAgentService.GetPaginatedResults
      */