@nexo-labs/payload-typesense 1.7.4 → 1.9.0

package/dist/index.d.mts

@@ -99,7 +99,7 @@ interface TokenUsage {
 /**
  * Service types for spending tracking
  */
-type ServiceType = 'openai_embedding' | 'openai_llm';
+type ServiceType = 'openai_embedding' | 'openai_llm' | 'gemini_embedding' | 'gemini_llm';
 /**
  * Spending entry for tracking AI service costs
  */
@@ -110,14 +110,21 @@ interface SpendingEntry {
   cost_usd?: number;
   timestamp: string;
 }
+/**
+ * Error data structure for SSE events
+ */
+interface SSEErrorData {
+  error: string;
+  message?: string;
+  chatId?: string;
+  [key: string]: unknown;
+}
 /**
  * SSE event structure
  */
 interface SSEEvent {
   type: SSEEventType;
-  data: string | ChunkSource[] | {
-    error: string;
-  } | UsageInfo;
+  data: string | ChunkSource[] | SSEErrorData | UsageInfo;
 }
 /**
  * Typesense search hit document (chunk-specific)
@@ -169,6 +176,8 @@ interface TypesenseQueryConfig {
   kResults?: number;
   /** Advanced search config */
   advancedConfig?: AdvancedSearchConfig;
+  /** Taxonomy slugs to filter RAG content */
+  taxonomySlugs?: string[];
 }
 /**
  * Embedding result with usage tracking
@@ -219,7 +228,7 @@ interface RAGCallbacks {
     reset_at?: string;
   }>;
   /** Save chat session function (optional) */
-  saveChatSession?: (payload: Payload, userId: string | number, conversationId: string, userMessage: string, assistantMessage: string, sources: ChunkSource[], spending: SpendingEntry[], collectionName: CollectionSlug) => Promise<void>;
+  saveChatSession?: (payload: Payload, userId: string | number, conversationId: string, userMessage: string, assistantMessage: string, sources: ChunkSource[], spending: SpendingEntry[], collectionName: CollectionSlug, agentSlug?: string) => Promise<void>;
   /** Create embedding spending function (optional) */
   createEmbeddingSpending?: (model: string, tokens: number) => SpendingEntry;
   /** Estimate tokens from text function (optional) */
@@ -236,10 +245,14 @@ interface RAGConfig {
   /** Advanced search settings */
   advanced?: AdvancedSearchConfig;
 }
+/**
+ * Function that retrieves agents dynamically (e.g. from DB)
+ */
+type AgentProvider = (payload: Payload) => Promise<AgentConfig[]>;
 interface RAGFeatureConfig extends RAGConfig {
   enabled: boolean;
   callbacks?: RAGCallbacks;
-  agents: AgentConfig[];
+  agents: AgentConfig[] | AgentProvider;
 }
 type TypesenseProtocol = "http" | "https";
 type TypesenseNode = {
@@ -264,7 +277,7 @@ type TypesenseConnectionConfig = {
 /**
  * Configuration for a single conversational agent
  */
-interface AgentConfig {
+interface AgentConfig<SearchCollections extends readonly string[] = string[]> {
   /**
    * Unique identifier for the agent (used in API requests)
    */
@@ -273,12 +286,12 @@ interface AgentConfig {
    * Display name for the agent (shown in UI)
    * If not provided, slug will be used.
    */
-  name?: string;
+  name: string;
   /**
    * Optional API Key for the LLM provider.
    * If provided, this overrides the global embedding provider API key for this agent.
    */
-  apiKey?: string;
+  apiKey: string;
   /**
    * System prompt that defines the agent's personality and constraints
    */
@@ -290,7 +303,7 @@ interface AgentConfig {
   /**
    * Collections this agent is allowed to search in
    */
-  searchCollections: string[];
+  searchCollections: SearchCollections[number][];
   /**
    * Maximum context size in bytes. Default: 65536 (64KB)
    */
@@ -299,19 +312,72 @@ interface AgentConfig {
    * TTL for conversation history in seconds. Default: 86400 (24h)
    */
   ttl?: number;
-  /**
-   * Name of the conversation history collection. Default: 'conversation_history'
-   */
-  historyCollection?: string;
   /**
    * Number of chunks to retrieve for RAG context. Default: 10
    */
   kResults?: number;
+  /**
+   * Welcome message title displayed when starting a new chat
+   */
+  welcomeTitle?: string;
+  /**
+   * Welcome message subtitle displayed when starting a new chat
+   */
+  welcomeSubtitle?: string;
+  /**
+   * Suggested questions displayed to help users get started
+   */
+  suggestedQuestions?: Array<{
+    /**
+     * The full prompt text to send when clicked
+     */
+    prompt: string;
+    /**
+     * Short title for the suggestion
+     */
+    title: string;
+    /**
+     * Brief description of what the question is about
+     */
+    description: string;
+  }>;
+  /**
+   * Avatar URL for the agent (displayed in chat header and floating button)
+   * If not provided, a default avatar will be used
+   */
+  avatar?: string;
+  /**
+   * Taxonomy slugs to filter RAG content.
+   * If empty/undefined, searches all content.
+   */
+  taxonomySlugs?: string[];
+  /**
+   * Maximum number of tokens the LLM can generate in responses.
+   * Default: 16000 (suitable for most use cases)
+   * Lower values save costs but may truncate responses.
+   * Higher values allow longer responses but cost more.
+   */
+  maxTokens?: number;
+  /**
+   * Temperature controls randomness in the model's output.
+   * Range: 0.0 to 2.0
+   * - Lower values (e.g., 0.3): More focused and deterministic
+   * - Higher values (e.g., 0.9): More creative and varied
+   * Default: 0.7
+   */
+  temperature?: number;
+  /**
+   * Top-p (nucleus sampling) controls diversity.
+   * Range: 0.0 to 1.0
+   * Default: 0.95
+   */
+  topP?: number;
 }
 //#endregion
 //#region src/plugin/rag-types.d.ts
 /**
  * Search feature configuration for the Typesense RAG plugin
+ * ...
  */
 interface TypesenseSearchConfig {
   /** Enable search endpoints */
@@ -328,12 +394,7 @@ interface TypesenseSearchConfig {
 }
 /**
  * Configuration for the Typesense RAG plugin
- *
- * This plugin handles all Typesense-specific functionality:
- * - Search endpoints
- * - RAG endpoints
- * - Schema synchronization
- * - Agent synchronization
+ * ...
  */
 interface TypesenseRAGPluginConfig<TSlug extends CollectionSlug> {
   /** Typesense connection configuration */
@@ -350,7 +411,7 @@ interface TypesenseRAGPluginConfig<TSlug extends CollectionSlug> {
   /** Search configuration */
   search?: TypesenseSearchConfig;
   /** RAG agent configurations */
-  agents?: AgentConfig[];
+  agents?: AgentConfig[] | AgentProvider;
   /** Callback functions for permissions, session management, etc. */
   callbacks?: RAGCallbacks;
   /** Hybrid search configuration */
@@ -376,14 +437,14 @@ interface TypesenseRAGPluginConfig<TSlug extends CollectionSlug> {
  */
 declare function createTypesenseRAGPlugin<TConfig extends Config, TSlug extends CollectionSlug>(config: TypesenseRAGPluginConfig<TSlug>): (payloadConfig: TConfig) => TConfig;
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/TypesenseError.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/TypesenseError.d.ts
 declare class TypesenseError extends Error {
   httpStatus?: number;
   httpBody?: string;
   constructor(message?: string, httpBody?: string, httpStatus?: number);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/ApiCall.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/ApiCall.d.ts
 interface Node extends NodeConfiguration {
   isHealthy: boolean;
   index: string | number;
@@ -507,7 +568,7 @@ declare class ApiCall implements HttpClient {
   private invokeOnErrorCallback;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Types.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Types.d.ts
 type DropTokensMode = "right_to_left" | "left_to_right" | "both_sides:3";
 type OperationMode = "off" | "always" | "fallback";
 type CommaSeparated<T extends string, ToExtend, OriginalString extends string = T, Previous extends string[] = []> = T extends `${infer Start},${infer Rest}` ? TrimString<Start> extends ToExtend ? CommaSeparated<Rest, ToExtend, OriginalString, [...Previous, TrimString<Start>]> : {
@@ -676,7 +737,7 @@ type MultiSearchResultsParameters<T extends DocumentSchema[], Infix extends stri
 type Whitespace = " " | "\n" | "\t";
 type TrimString<S extends string> = S extends `${Whitespace}${infer S}` ? TrimString<S> : S extends `${infer S}${Whitespace}` ? TrimString<S> : S;
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/RequestWithCache.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/RequestWithCache.d.ts
 declare class RequestWithCache {
   private responseCache;
   private responsePromiseCache;
@@ -689,7 +750,7 @@ interface CacheOptions$1 {
   maxSize?: number;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/SearchOnlyDocuments.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/SearchOnlyDocuments.d.ts
 declare class SearchOnlyDocuments<T extends DocumentSchema> implements SearchableDocuments<T> {
   protected collectionName: string;
   protected apiCall: ApiCall;
@@ -705,7 +766,7 @@ declare class SearchOnlyDocuments<T extends DocumentSchema> implements Searchabl
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Documents.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Documents.d.ts
 type DeleteQuery = {
   truncate?: true;
 } | {
@@ -885,7 +946,7 @@ declare class Documents<T extends DocumentSchema = object> extends SearchOnlyDoc
   exportStream(options?: DocumentsExportParameters): Promise<ReadStream>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Configuration.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Configuration.d.ts
 interface NodeConfiguration {
   host: string;
   port: number;
@@ -1025,7 +1086,7 @@ declare class Configuration {
   private shuffleArray;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Override.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Override.d.ts
 interface OverrideSchema extends OverrideCreateSchema {
   id: string;
 }
@@ -1042,7 +1103,7 @@ declare class Override {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Overrides.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Overrides.d.ts
 interface OverrideRuleQuerySchema {
   query?: string;
   match?: "exact" | "contains";
@@ -1085,7 +1146,7 @@ declare class Overrides {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Synonym.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Synonym.d.ts
 interface SynonymSchema extends SynonymCreateSchema {
   id: string;
 }
@@ -1102,7 +1163,7 @@ declare class Synonym {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Synonyms.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Synonyms.d.ts
 interface SynonymCreateSchema {
   synonyms: string[];
   root?: string;
@@ -1122,7 +1183,7 @@ declare class Synonyms {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Document.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Document.d.ts
 declare class Document<T extends DocumentSchema = object> {
   private collectionName;
   private documentId;
@@ -1134,7 +1195,7 @@ declare class Document<T extends DocumentSchema = object> {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Collection.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Collection.d.ts
 type FieldType = "string" | "int32" | "int64" | "float" | "bool" | "geopoint" | "geopolygon" | "geopoint[]" | "string[]" | "int32[]" | "int64[]" | "float[]" | "bool[]" | "object" | "object[]" | "auto" | "string*" | "image";
 interface CollectionFieldSchema extends Partial<Pick<BaseCollectionCreateSchema, "token_separators" | "symbols_to_index">> {
   name: string;
@@ -1190,7 +1251,7 @@ declare class Collection<T extends DocumentSchema = object> {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Collections.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Collections.d.ts
 interface BaseCollectionCreateSchema {
   name: string;
   default_sorting_field?: string;
@@ -1229,7 +1290,7 @@ declare class Collections {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Aliases.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Aliases.d.ts
 interface CollectionAliasCreateSchema {
   collection_name: string;
 }
@@ -1248,7 +1309,7 @@ declare class Aliases {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Alias.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Alias.d.ts
 declare class Alias {
   private name;
   private apiCall;
@@ -1258,7 +1319,7 @@ declare class Alias {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Key.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Key.d.ts
 interface KeyCreateSchema {
   actions: Actions[] | (string & {})[];
   collections: string[];
@@ -1291,7 +1352,7 @@ declare class Key {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Keys.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Keys.d.ts
 interface KeysRetrieveSchema {
   keys: KeySchema[];
 }
@@ -1309,7 +1370,7 @@ declare class Keys {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Debug.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Debug.d.ts
 interface DebugResponseSchema {
   state: number;
   version: string;
@@ -1320,7 +1381,7 @@ declare class Debug {
   retrieve(): Promise<DebugResponseSchema>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Metrics.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Metrics.d.ts
 interface MetricsResponse {
   [key: `system_cpu${number}_active_percentage`]: string;
   system_cpu_active_percentage: string;
@@ -1346,7 +1407,7 @@ declare class Metrics {
   retrieve(): Promise<MetricsResponse>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Stats.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Stats.d.ts
 interface EndpointStats {
   [endpoint: string]: number;
 }
@@ -1371,7 +1432,7 @@ declare class Metrics$1 {
   retrieve(): Promise<StatsResponse>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Health.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Health.d.ts
 interface HealthResponse {
   ok: boolean;
 }
@@ -1381,14 +1442,14 @@ declare class Health {
   retrieve(): Promise<HealthResponse>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Operations.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Operations.d.ts
 declare class Operations {
   private apiCall;
   constructor(apiCall: ApiCall);
   perform(operationName: "vote" | "snapshot" | "cache/clear" | "schema_changes" | (string & {}), queryParameters?: Record<string, any>): Promise<any>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/MultiSearch.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/MultiSearch.d.ts
 declare class MultiSearch {
   private apiCall;
   private configuration;
@@ -1405,7 +1466,7 @@ declare class MultiSearch {
   private isStreamingRequest;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Preset.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Preset.d.ts
 interface PresetSchema<T extends DocumentSchema> extends PresetCreateSchema<T, string> {
   name: string;
 }
@@ -1421,7 +1482,7 @@ declare class Preset {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Presets.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Presets.d.ts
 interface PresetCreateSchema<T extends DocumentSchema, Infix extends string> {
   value: SearchParams$1<T, Infix> | MultiSearchRequestsSchema<T, Infix>;
 }
@@ -1437,7 +1498,7 @@ declare class Presets {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/AnalyticsRule.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/AnalyticsRule.d.ts
 interface AnalyticsRuleCreateSchema {
   type: "popular_queries" | "nohits_queries" | "counter" | "log";
   params: {
@@ -1473,7 +1534,7 @@ declare class AnalyticsRule {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/AnalyticsRules.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/AnalyticsRules.d.ts
 interface AnalyticsRulesRetrieveSchema {
   rules: AnalyticsRuleSchema[];
 }
@@ -1486,14 +1547,14 @@ declare class AnalyticsRules {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/AnalyticsEvent.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/AnalyticsEvent.d.ts
 interface AnalyticsEventCreateSchema {
   type: string;
   name: string;
   data: Record<string, unknown>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/AnalyticsEvents.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/AnalyticsEvents.d.ts
 declare class AnalyticsEvents {
   private readonly apiCall;
   constructor(apiCall: ApiCall);
@@ -1502,7 +1563,7 @@ declare class AnalyticsEvents {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Analytics.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Analytics.d.ts
 declare class Analytics {
   private readonly apiCall;
   private readonly _analyticsRules;
@@ -1515,7 +1576,7 @@ declare class Analytics {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Stopword.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Stopword.d.ts
 interface StopwordSchema {
   id: string;
   stopwords: string[] | {
@@ -1536,7 +1597,7 @@ declare class Stopword {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Stopwords.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Stopwords.d.ts
 interface StopwordCreateSchema {
   stopwords: string[];
   locale?: string;
@@ -1553,7 +1614,7 @@ declare class Stopwords {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/ConversationModel.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/ConversationModel.d.ts
 interface ConversationModelCreateSchema {
   id?: string;
   model_name: string;
@@ -1584,7 +1645,7 @@ declare class ConversationModel {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/ConversationModels.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/ConversationModels.d.ts
 declare class ConversationModels {
   private readonly apiCall;
   constructor(apiCall: ApiCall);
@@ -1594,7 +1655,7 @@ declare class ConversationModels {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Conversation.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Conversation.d.ts
 interface ConversationDeleteSchema {
   id: number;
 }
@@ -1617,7 +1678,7 @@ declare class Conversation {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Conversations.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Conversations.d.ts
 interface ConversationsRetrieveSchema {
   conversations: ConversationSchema[];
 }
@@ -1632,7 +1693,7 @@ declare class Conversations {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/StemmingDictionary.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/StemmingDictionary.d.ts
 interface StemmingDictionaryCreateSchema {
   root: string;
   word: string;
@@ -1649,7 +1710,7 @@ declare class StemmingDictionary {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/StemmingDictionaries.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/StemmingDictionaries.d.ts
 interface StemmingDictionariesRetrieveSchema {
   dictionaries: string[];
 }
@@ -1662,7 +1723,7 @@ declare class StemmingDictionaries {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Stemming.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Stemming.d.ts
 declare class Stemming {
   private readonly apiCall;
   private readonly _stemmingDictionaries;
@@ -1673,7 +1734,7 @@ declare class Stemming {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/NLSearchModels.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/NLSearchModels.d.ts
 interface NLSearchModelBase {
   model_name: string;
   api_key?: string;
@@ -1710,7 +1771,7 @@ declare class NLSearchModels {
   static get RESOURCEPATH(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/NLSearchModel.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/NLSearchModel.d.ts
 type NLSearchModelUpdateSchema = NLSearchModelBase;
 interface NLSearchModelDeleteSchema {
   id: string;
@@ -1725,7 +1786,7 @@ declare class NLSearchModel {
   private endpointPath;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Client.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Client.d.ts
 declare class Client {
   configuration: Configuration;
   apiCall: ApiCall;
@@ -1768,7 +1829,7 @@ declare class Client {
   nlSearchModels(id: string): NLSearchModel;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/SearchOnlyCollection.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/SearchOnlyCollection.d.ts
 declare class SearchOnlyCollection<T extends DocumentSchema> {
   private readonly name;
   private readonly apiCall;
@@ -1778,7 +1839,7 @@ declare class SearchOnlyCollection<T extends DocumentSchema> {
   documents(): SearchableDocuments<T>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/SearchClient.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/SearchClient.d.ts
 declare class SearchClient {
   readonly multiSearch: MultiSearch;
   private readonly configuration;
@@ -1789,31 +1850,31 @@ declare class SearchClient {
   collections<TDocumentSchema extends DocumentSchema>(collectionName: string): SearchOnlyCollection<TDocumentSchema>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/HTTPError.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/HTTPError.d.ts
 declare class HTTPError extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/MissingConfigurationError.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/MissingConfigurationError.d.ts
 declare class MissingConfigurationError extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/ObjectAlreadyExists.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ObjectAlreadyExists.d.ts
 declare class ObjectAlreadyExists extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/ObjectNotFound.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ObjectNotFound.d.ts
 declare class ObjectNotFound extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/ObjectUnprocessable.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ObjectUnprocessable.d.ts
 declare class ObjectUnprocessable extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/RequestMalformed.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/RequestMalformed.d.ts
 declare class RequestMalformed extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/RequestUnauthorized.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/RequestUnauthorized.d.ts
 declare class RequestUnauthorized extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/ServerError.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ServerError.d.ts
 declare class ServerError extends TypesenseError {}
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense/Errors/ImportError.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ImportError.d.ts
 interface ImportErrorPayload {
   documentsInJSONLFormat: string | ReadStream$1;
   options: DocumentImportParameters;
@@ -1829,7 +1890,7 @@ declare namespace index_d_exports {
   export { HTTPError, ImportError, MissingConfigurationError, ObjectAlreadyExists, ObjectNotFound, ObjectUnprocessable, RequestMalformed, RequestUnauthorized, ServerError, TypesenseError };
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.4/node_modules/typesense/lib/Typesense.d.ts
+//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense.d.ts
 declare const _default: {
   Client: typeof Client;
   SearchClient: typeof SearchClient;
@@ -2381,6 +2442,8 @@ type RAGSearchConfig = {
     prefix?: boolean;
     dropTokensThreshold?: number;
   };
+  /** Taxonomy slugs to filter RAG content */
+  taxonomySlugs?: string[];
 };
 /**
  * Request parameters for RAG chat
@@ -2555,8 +2618,9 @@ interface ChatMessageWithSources {
  * @param sources - Source chunks used for the response
  * @param spending - Token spending entries
  * @param collectionName - Collection name for sessions (default: 'chat-sessions')
+ * @param agentSlug - Slug of the agent used in this conversation (optional)
  */
-declare function saveChatSession(payload: Payload, userId: string | number, conversationId: string, userMessage: string, assistantMessage: string, sources: ChunkSource[], spending: SpendingEntry[], collectionName: CollectionSlug): Promise<void>;
+declare function saveChatSession(payload: Payload, userId: string | number, conversationId: string, userMessage: string, assistantMessage: string, sources: ChunkSource[], spending: SpendingEntry[], collectionName: CollectionSlug, agentSlug?: string): Promise<void>;
 //#endregion
 //#region src/features/rag/endpoints/types.d.ts
 /**
@@ -2644,6 +2708,10 @@ declare function createRAGPayloadHandlers<TSlug extends CollectionSlug>(config:
 }>;
 //#endregion
 //#region src/core/config/constants.d.ts
+/**
+ * Constants for payload-typesense plugin
+ * Centralizes all magic numbers and configuration defaults
+ */
 /**
  * Default alpha value for hybrid search (0 = pure semantic, 1 = pure keyword)
  */
@@ -2673,5 +2741,5 @@ declare const DEFAULT_SESSION_TTL_SEC: number;
  */
 declare const DEFAULT_RAG_LLM_MODEL = "gpt-4o-mini";
 //#endregion
-export { type ApiContext, type ApiResponse, type AuthenticateMethod, type BaseDocument, type BaseSearchInputProps, type CacheEntry, type CacheOptions, type ChatMessageWithSources, type ChatSessionData, type ChunkFetchConfig, type ChunkFetchResult, type ConversationEvent, DEFAULT_CACHE_TTL_MS, DEFAULT_HYBRID_SEARCH_ALPHA, DEFAULT_RAG_CONTEXT_LIMIT, DEFAULT_RAG_LLM_MODEL, DEFAULT_RAG_MAX_TOKENS, DEFAULT_SEARCH_LIMIT, DEFAULT_SESSION_TTL_SEC, type ErrorResponse, type HealthCheckResponse, type ModularPluginConfig, type PayloadDocument, type RAGChatRequest, type RAGSearchConfig, type RAGSearchResult, type SearchFeatureConfig, type SearchParams, type SearchResponse, type SearchResult, type SessionConfig, type StreamProcessingResult, type SuggestResponse, type SuggestResult, type SyncFeatureConfig, TypesenseAdapter, type TypesenseChunkDocument, type TypesenseConnectionConfig, type TypesenseDocument, type TypesenseFieldMapping, type TypesenseFieldType, type TypesenseRAGPluginConfig, type TypesenseSearchConfig, buildContextText, buildConversationalUrl, buildHybridSearchParams, buildMultiSearchRequestBody, buildMultiSearchRequests, closeSession, createRAGPayloadHandlers, createSSEForwardStream, createSearchEndpoints, createTypesenseAdapter, createTypesenseAdapterFromClient, createTypesenseClient, createTypesenseRAGPlugin, deleteDocumentFromTypesense, ensureConversationCollection, executeRAGSearch, extractSourcesFromResults, fetchChunkById, formatSSEEvent, generateEmbedding, generateEmbeddingWithUsage, generateEmbeddingsBatchWithUsage, getActiveSession, getDefaultRAGConfig, getSessionByConversationId, jsonResponse, mergeRAGConfigWithDefaults, parseConversationEvent, processConversationStream, saveChatSession, sendSSEEvent, testTypesenseConnection };
+export { type AgentConfig, type AgentProvider, type ApiContext, type ApiResponse, type AuthenticateMethod, type BaseDocument, type BaseSearchInputProps, type CacheEntry, type CacheOptions, type ChatMessageWithSources, type ChatSessionData, type ChunkFetchConfig, type ChunkFetchResult, type ConversationEvent, DEFAULT_CACHE_TTL_MS, DEFAULT_HYBRID_SEARCH_ALPHA, DEFAULT_RAG_CONTEXT_LIMIT, DEFAULT_RAG_LLM_MODEL, DEFAULT_RAG_MAX_TOKENS, DEFAULT_SEARCH_LIMIT, DEFAULT_SESSION_TTL_SEC, type ErrorResponse, type HealthCheckResponse, type ModularPluginConfig, type PayloadDocument, type RAGChatRequest, type RAGSearchConfig, type RAGSearchResult, type SearchFeatureConfig, type SearchParams, type SearchResponse, type SearchResult, type SessionConfig, type StreamProcessingResult, type SuggestResponse, type SuggestResult, type SyncFeatureConfig, TypesenseAdapter, type TypesenseChunkDocument, type TypesenseConnectionConfig, type TypesenseDocument, type TypesenseFieldMapping, type TypesenseFieldType, type TypesenseRAGPluginConfig, type TypesenseSearchConfig, buildContextText, buildConversationalUrl, buildHybridSearchParams, buildMultiSearchRequestBody, buildMultiSearchRequests, closeSession, createRAGPayloadHandlers, createSSEForwardStream, createSearchEndpoints, createTypesenseAdapter, createTypesenseAdapterFromClient, createTypesenseClient, createTypesenseRAGPlugin, deleteDocumentFromTypesense, ensureConversationCollection, executeRAGSearch, extractSourcesFromResults, fetchChunkById, formatSSEEvent, generateEmbedding, generateEmbeddingWithUsage, generateEmbeddingsBatchWithUsage, getActiveSession, getDefaultRAGConfig, getSessionByConversationId, jsonResponse, mergeRAGConfigWithDefaults, parseConversationEvent, processConversationStream, saveChatSession, sendSSEEvent, testTypesenseConnection };
 //# sourceMappingURL=index.d.mts.map