@liquidmetal-ai/drizzle 0.3.5 → 0.4.1

package/src/liquidmetal/v1alpha1/search_agent_pb.ts

@@ -4,49 +4,51 @@
 
 import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv1";
 import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
+import type { BucketLocator, BucketResponse } from "./bucket_name_pb.js";
+import { file_liquidmetal_v1alpha1_bucket_name } from "./bucket_name_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**
  * Describes the file liquidmetal/v1alpha1/search_agent.proto.
  */
 export const file_liquidmetal_v1alpha1_search_agent: GenFile = /*@__PURE__*/
-  fileDesc("CidsaXF1aWRtZXRhbC92MWFscGhhMS9zZWFyY2hfYWdlbnQucHJvdG8SFGxpcXVpZG1ldGFsLnYxYWxwaGExIogBChNEb2N1bWVudENoYXRSZXF1ZXN0EhEKCWJ1Y2tldF9pZBgBIAEoCRIRCglvYmplY3RfaWQYAiABKAkSDQoFaW5wdXQYAyABKAkSEgoKcmVxdWVzdF9pZBgEIAEoCRIPCgd1c2VyX2lkGAUgASgJEhcKD29yZ2FuaXphdGlvbl9pZBgGIAEoCSImChREb2N1bWVudENoYXRSZXNwb25zZRIOCgZhbnN3ZXIYASABKAkicwoQUmFnU2VhcmNoUmVxdWVzdBINCgVpbnB1dBgBIAEoCRISCgpyZXF1ZXN0X2lkGAIgASgJEhIKCmJ1Y2tldF9pZHMYAyADKAkSDwoHdXNlcl9pZBgEIAEoCRIXCg9vcmdhbml6YXRpb25faWQYBSABKAkiRgoRUmFnU2VhcmNoUmVzcG9uc2USMQoHcmVzdWx0cxgBIAMoCzIgLmxpcXVpZG1ldGFsLnYxYWxwaGExLlRleHRSZXN1bHQiLgoMU291cmNlUmVzdWx0Eg4KBmJ1Y2tldBgBIAEoCRIOCgZvYmplY3QYAiABKAkinAIKClRleHRSZXN1bHQSHAoPY2h1bmtfc2lnbmF0dXJlGAEgASgJSACIAQESEQoEdGV4dBgCIAEoCUgBiAEBEjIKBnNvdXJjZRgDIAEoCzIiLmxpcXVpZG1ldGFsLnYxYWxwaGExLlNvdXJjZVJlc3VsdBIeChFwYXlsb2FkX3NpZ25hdHVyZRgEIAEoCUgCiAEBEhIKBXNjb3JlGAUgASgBSAOIAQESEgoFZW1iZWQYBiABKAlIBIgBARIRCgR0eXBlGAcgASgJSAWIAQFCEgoQX2NodW5rX3NpZ25hdHVyZUIHCgVfdGV4dEIUChJfcGF5bG9hZF9zaWduYXR1cmVCCAoGX3Njb3JlQggKBl9lbWJlZEIHCgVfdHlwZSJnCg5QYWdpbmF0aW9uSW5mbxINCgV0b3RhbBgBIAEoBRIMCgRwYWdlGAIgASgFEhEKCXBhZ2Vfc2l6ZRgDIAEoBRITCgt0b3RhbF9wYWdlcxgEIAEoBRIQCghoYXNfbW9yZRgFIAEoCCJ5ChhDcmVhdGVQYWdlU3VtbWFyeVJlcXVlc3QSDAoEcGFnZRgBIAEoBRIRCglwYWdlX3NpemUYAiABKAUSEgoKcmVxdWVzdF9pZBgDIAEoCRIPCgd1c2VyX2lkGAQgASgJEhcKD29yZ2FuaXphdGlvbl9pZBgFIAEoCSIsChlDcmVhdGVQYWdlU3VtbWFyeVJlc3BvbnNlEg8KB3N1bW1hcnkYASABKAkifAoZUnVuU3VwZXJ2aXNvckFnZW50UmVxdWVzdBINCgVpbnB1dBgBIAEoCRISCgpyZXF1ZXN0X2lkGAIgASgJEhIKCmJ1Y2tldF9pZHMYAyADKAkSDwoHdXNlcl9pZBgEIAEoCRIXCg9vcmdhbml6YXRpb25faWQYBSABKAkiiQEKGlJ1blN1cGVydmlzb3JBZ2VudFJlc3BvbnNlEjEKB3Jlc3VsdHMYASADKAsyIC5saXF1aWRtZXRhbC52MWFscGhhMS5UZXh0UmVzdWx0EjgKCnBhZ2luYXRpb24YAiABKAsyJC5saXF1aWRtZXRhbC52MWFscGhhMS5QYWdpbmF0aW9uSW5mbyKcAQoaR2V0UGFnaW5hdGVkUmVzdWx0c1JlcXVlc3QSEgoKcmVxdWVzdF9pZBgBIAEoCRIRCgRwYWdlGAIgASgFSACIAQESFgoJcGFnZV9zaXplGAMgASgFSAGIAQESDwoHdXNlcl9pZBgEIAEoCRIXCg9vcmdhbml6YXRpb25faWQYBSABKAlCBwoFX3BhZ2VCDAoKX3BhZ2Vfc2l6ZSKKAQobR2V0UGFnaW5hdGVkUmVzdWx0c1Jlc3BvbnNlEjEKB3Jlc3VsdHMYASADKAsyIC5saXF1aWRtZXRhbC52MWFscGhhMS5UZXh0UmVzdWx0EjgKCnBhZ2luYXRpb24YAiABKAsyJC5saXF1aWRtZXRhbC52MWFscGhhMS5QYWdpbmF0aW9uSW5mbzLEBAoSU2VhcmNoQWdlbnRTZXJ2aWNlEmUKDERvY3VtZW50Q2hhdBIpLmxpcXVpZG1ldGFsLnYxYWxwaGExLkRvY3VtZW50Q2hhdFJlcXVlc3QaKi5saXF1aWRtZXRhbC52MWFscGhhMS5Eb2N1bWVudENoYXRSZXNwb25zZRJcCglSYWdTZWFyY2gSJi5saXF1aWRtZXRhbC52MWFscGhhMS5SYWdTZWFyY2hSZXF1ZXN0GicubGlxdWlkbWV0YWwudjFhbHBoYTEuUmFnU2VhcmNoUmVzcG9uc2USdAoRQ3JlYXRlUGFnZVN1bW1hcnkSLi5saXF1aWRtZXRhbC52MWFscGhhMS5DcmVhdGVQYWdlU3VtbWFyeVJlcXVlc3QaLy5saXF1aWRtZXRhbC52MWFscGhhMS5DcmVhdGVQYWdlU3VtbWFyeVJlc3BvbnNlEncKElJ1blN1cGVydmlzb3JBZ2VudBIvLmxpcXVpZG1ldGFsLnYxYWxwaGExLlJ1blN1cGVydmlzb3JBZ2VudFJlcXVlc3QaMC5saXF1aWRtZXRhbC52MWFscGhhMS5SdW5TdXBlcnZpc29yQWdlbnRSZXNwb25zZRJ6ChNHZXRQYWdpbmF0ZWRSZXN1bHRzEjAubGlxdWlkbWV0YWwudjFhbHBoYTEuR2V0UGFnaW5hdGVkUmVzdWx0c1JlcXVlc3QaMS5saXF1aWRtZXRhbC52MWFscGhhMS5HZXRQYWdpbmF0ZWRSZXN1bHRzUmVzcG9uc2VCnQEKGGNvbS5saXF1aWRtZXRhbC52MWFscGhhMUIQU2VhcmNoQWdlbnRQcm90b1ABogIDTFhYqgIUTGlxdWlkbWV0YWwuVjFhbHBoYTHKAhRMaXF1aWRtZXRhbFxWMWFscGhhMeICIExpcXVpZG1ldGFsXFYxYWxwaGExXEdQQk1ldGFkYXRh6gIVTGlxdWlkbWV0YWw6OlYxYWxwaGExYgZwcm90bzM");
+  fileDesc("CidsaXF1aWRtZXRhbC92MWFscGhhMS9zZWFyY2hfYWdlbnQucHJvdG8SFGxpcXVpZG1ldGFsLnYxYWxwaGExIrMBChNEb2N1bWVudENoYXRSZXF1ZXN0EjwKD2J1Y2tldF9sb2NhdGlvbhgBIAEoCzIjLmxpcXVpZG1ldGFsLnYxYWxwaGExLkJ1Y2tldExvY2F0b3ISEQoJb2JqZWN0X2lkGAIgASgJEg0KBWlucHV0GAMgASgJEhIKCnJlcXVlc3RfaWQYBCABKAkSDwoHdXNlcl9pZBgFIAEoCRIXCg9vcmdhbml6YXRpb25faWQYBiABKAkiJgoURG9jdW1lbnRDaGF0UmVzcG9uc2USDgoGYW5zd2VyGAEgASgJIp4BChBSYWdTZWFyY2hSZXF1ZXN0Eg0KBWlucHV0GAEgASgJEhIKCnJlcXVlc3RfaWQYAiABKAkSPQoQYnVja2V0X2xvY2F0aW9ucxgDIAMoCzIjLmxpcXVpZG1ldGFsLnYxYWxwaGExLkJ1Y2tldExvY2F0b3ISDwoHdXNlcl9pZBgEIAEoCRIXCg9vcmdhbml6YXRpb25faWQYBSABKAkiRgoRUmFnU2VhcmNoUmVzcG9uc2USMQoHcmVzdWx0cxgBIAMoCzIgLmxpcXVpZG1ldGFsLnYxYWxwaGExLlRleHRSZXN1bHQiVAoMU291cmNlUmVzdWx0EjQKBmJ1Y2tldBgBIAEoCzIkLmxpcXVpZG1ldGFsLnYxYWxwaGExLkJ1Y2tldFJlc3BvbnNlEg4KBm9iamVjdBgCIAEoCSKcAgoKVGV4dFJlc3VsdBIcCg9jaHVua19zaWduYXR1cmUYASABKAlIAIgBARIRCgR0ZXh0GAIgASgJSAGIAQESMgoGc291cmNlGAMgASgLMiIubGlxdWlkbWV0YWwudjFhbHBoYTEuU291cmNlUmVzdWx0Eh4KEXBheWxvYWRfc2lnbmF0dXJlGAQgASgJSAKIAQESEgoFc2NvcmUYBSABKAFIA4gBARISCgVlbWJlZBgGIAEoCUgEiAEBEhEKBHR5cGUYByABKAlIBYgBAUISChBfY2h1bmtfc2lnbmF0dXJlQgcKBV90ZXh0QhQKEl9wYXlsb2FkX3NpZ25hdHVyZUIICgZfc2NvcmVCCAoGX2VtYmVkQgcKBV90eXBlImcKDlBhZ2luYXRpb25JbmZvEg0KBXRvdGFsGAEgASgFEgwKBHBhZ2UYAiABKAUSEQoJcGFnZV9zaXplGAMgASgFEhMKC3RvdGFsX3BhZ2VzGAQgASgFEhAKCGhhc19tb3JlGAUgASgIInkKGENyZWF0ZVBhZ2VTdW1tYXJ5UmVxdWVzdBIMCgRwYWdlGAEgASgFEhEKCXBhZ2Vfc2l6ZRgCIAEoBRISCgpyZXF1ZXN0X2lkGAMgASgJEg8KB3VzZXJfaWQYBCABKAkSFwoPb3JnYW5pemF0aW9uX2lkGAUgASgJIiwKGUNyZWF0ZVBhZ2VTdW1tYXJ5UmVzcG9uc2USDwoHc3VtbWFyeRgBIAEoCSKnAQoZUnVuU3VwZXJ2aXNvckFnZW50UmVxdWVzdBINCgVpbnB1dBgBIAEoCRISCgpyZXF1ZXN0X2lkGAIgASgJEj0KEGJ1Y2tldF9sb2NhdGlvbnMYAyADKAsyIy5saXF1aWRtZXRhbC52MWFscGhhMS5CdWNrZXRMb2NhdG9yEg8KB3VzZXJfaWQYBCABKAkSFwoPb3JnYW5pemF0aW9uX2lkGAUgASgJIokBChpSdW5TdXBlcnZpc29yQWdlbnRSZXNwb25zZRIxCgdyZXN1bHRzGAEgAygLMiAubGlxdWlkbWV0YWwudjFhbHBoYTEuVGV4dFJlc3VsdBI4CgpwYWdpbmF0aW9uGAIgASgLMiQubGlxdWlkbWV0YWwudjFhbHBoYTEuUGFnaW5hdGlvbkluZm8inAEKGkdldFBhZ2luYXRlZFJlc3VsdHNSZXF1ZXN0EhIKCnJlcXVlc3RfaWQYASABKAkSEQoEcGFnZRgCIAEoBUgAiAEBEhYKCXBhZ2Vfc2l6ZRgDIAEoBUgBiAEBEg8KB3VzZXJfaWQYBCABKAkSFwoPb3JnYW5pemF0aW9uX2lkGAUgASgJQgcKBV9wYWdlQgwKCl9wYWdlX3NpemUiigEKG0dldFBhZ2luYXRlZFJlc3VsdHNSZXNwb25zZRIxCgdyZXN1bHRzGAEgAygLMiAubGlxdWlkbWV0YWwudjFhbHBoYTEuVGV4dFJlc3VsdBI4CgpwYWdpbmF0aW9uGAIgASgLMiQubGlxdWlkbWV0YWwudjFhbHBoYTEuUGFnaW5hdGlvbkluZm8y2gUKElNlYXJjaEFnZW50U2VydmljZRKEAQoMRG9jdW1lbnRDaGF0EikubGlxdWlkbWV0YWwudjFhbHBoYTEuRG9jdW1lbnRDaGF0UmVxdWVzdBoqLmxpcXVpZG1ldGFsLnYxYWxwaGExLkRvY3VtZW50Q2hhdFJlc3BvbnNlIh2C0+STAhc6ASoiEi92MS9kb2N1bWVudF9xdWVyeRJ5CglSYWdTZWFyY2gSJi5saXF1aWRtZXRhbC52MWFscGhhMS5SYWdTZWFyY2hSZXF1ZXN0GicubGlxdWlkbWV0YWwudjFhbHBoYTEuUmFnU2VhcmNoUmVzcG9uc2UiG4LT5JMCFToBKiIQL3YxL2NodW5rX3NlYXJjaBKTAQoRQ3JlYXRlUGFnZVN1bW1hcnkSLi5saXF1aWRtZXRhbC52MWFscGhhMS5DcmVhdGVQYWdlU3VtbWFyeVJlcXVlc3QaLy5saXF1aWRtZXRhbC52MWFscGhhMS5DcmVhdGVQYWdlU3VtbWFyeVJlc3BvbnNlIh2C0+STAhc6ASoiEi92MS9zdW1tYXJpemVfcGFnZRKOAQoSUnVuU3VwZXJ2aXNvckFnZW50Ei8ubGlxdWlkbWV0YWwudjFhbHBoYTEuUnVuU3VwZXJ2aXNvckFnZW50UmVxdWVzdBowLmxpcXVpZG1ldGFsLnYxYWxwaGExLlJ1blN1cGVydmlzb3JBZ2VudFJlc3BvbnNlIhWC0+STAg86ASoiCi92MS9zZWFyY2gSmgEKE0dldFBhZ2luYXRlZFJlc3VsdHMSMC5saXF1aWRtZXRhbC52MWFscGhhMS5HZXRQYWdpbmF0ZWRSZXN1bHRzUmVxdWVzdBoxLmxpcXVpZG1ldGFsLnYxYWxwaGExLkdldFBhZ2luYXRlZFJlc3VsdHNSZXNwb25zZSIegtPkkwIYOgEqIhMvdjEvc2VhcmNoX2dldF9wYWdlQusBChhjb20ubGlxdWlkbWV0YWwudjFhbHBoYTFCEFNlYXJjaEFnZW50UHJvdG9QAVpMZ2l0aHViLmNvbS9saXF1aWRtZXRhbC1haS9wcm90b2dlbjIvbGlxdWlkbWV0YWwvdjFhbHBoYTE7bGlxdWlkbWV0YWx2MWFscGhhMaICA0xYWKoCFExpcXVpZG1ldGFsLlYxYWxwaGExygIUTGlxdWlkbWV0YWxcVjFhbHBoYTHiAiBMaXF1aWRtZXRhbFxWMWFscGhhMVxHUEJNZXRhZGF0YeoCFUxpcXVpZG1ldGFsOjpWMWFscGhhMWIGcHJvdG8z", [file_liquidmetal_v1alpha1_bucket_name]);
 
 /**
- * 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;
    */
@@ -71,20 +73,12 @@ export const DocumentChatRequestSchema: GenMessage<DocumentChatRequest> = /*@__P
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 0);
 
 /**
- * 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;
    */
@@ -99,36 +93,35 @@ export const DocumentChatResponseSchema: GenMessage<DocumentChatResponse> = /*@_
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 1);
 
 /**
- * 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;
@@ -149,16 +142,12 @@ export const RagSearchRequestSchema: GenMessage<RagSearchRequest> = /*@__PURE__*
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 2);
 
 /**
- * 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;
    */
@@ -177,14 +166,16 @@ export const RagSearchResponseSchema: GenMessage<RagSearchResponse> = /*@__PURE_
  */
 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;
    */
@@ -199,65 +190,60 @@ export const SourceResultSchema: GenMessage<SourceResult> = /*@__PURE__*/
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 4);
 
 /**
- * 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;
    */
@@ -272,46 +258,44 @@ export const TextResultSchema: GenMessage<TextResult> = /*@__PURE__*/
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 5);
 
 /**
- * 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;
    */
@@ -326,29 +310,31 @@ export const PaginationInfoSchema: GenMessage<PaginationInfo> = /*@__PURE__*/
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 6);
 
 /**
- * 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;
    */
@@ -373,18 +359,12 @@ export const CreatePageSummaryRequestSchema: GenMessage<CreatePageSummaryRequest
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 7);
 
 /**
- * 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;
    */
@@ -399,36 +379,35 @@ export const CreatePageSummaryResponseSchema: GenMessage<CreatePageSummaryRespon
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 8);
 
 /**
- * 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;
@@ -449,21 +428,20 @@ export const RunSupervisorAgentRequestSchema: GenMessage<RunSupervisorAgentReque
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 9);
 
 /**
- * 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;
    */
@@ -478,28 +456,31 @@ export const RunSupervisorAgentResponseSchema: GenMessage<RunSupervisorAgentResp
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 10);
 
 /**
- * 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;
    */
@@ -524,21 +505,20 @@ export const GetPaginatedResultsRequestSchema: GenMessage<GetPaginatedResultsReq
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 11);
 
 /**
- * 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;
    */
@@ -553,41 +533,29 @@ export const GetPaginatedResultsResponseSchema: GenMessage<GetPaginatedResultsRe
   messageDesc(file_liquidmetal_v1alpha1_search_agent, 12);
 
 /**
- * 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 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
    */
@@ -597,22 +565,13 @@ export 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
    */
@@ -622,9 +581,9 @@ export 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
@@ -647,22 +606,22 @@ export 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
@@ -673,16 +632,9 @@ export 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
    */