@minded-ai/mindedjs 3.1.31 → 3.1.32

package/dist/platform/mindedConnectionTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"mindedConnectionTypes.js","sourceRoot":"","sources":["../../src/platform/mindedConnectionTypes.ts"],"names":[],"mappings":";;;AAaA,IAAY,iCAyEX;AAzED,WAAY,iCAAiC;IAC3C,kEAA6B,CAAA;IAC7B,gEAA2B,CAAA;IAC3B,gFAA2C,CAAA;IAC3C,gFAA2C,CAAA;IAC3C,oFAA+C,CAAA;IAC/C,wFAAmD,CAAA;IACnD,4DAAuB,CAAA;IACvB,oEAA+B,CAAA;IAC/B,sDAAiB,CAAA;IACjB,0EAAqC,CAAA;IACrC,cAAc;IACd,kFAA6C,CAAA;IAC7C,sEAAiC,CAAA;IACjC,wEAAmC,CAAA;IACnC,oFAA+C,CAAA;IAC/C,8EAAyC,CAAA;IACzC,QAAQ;IACR,0EAAqC,CAAA;IACrC,4EAAuC,CAAA;IACvC,gFAA2C,CAAA;IAC3C,4EAAuC,CAAA;IACvC,8EAAyC,CAAA;IACzC,8FAAyD,CAAA;IACzD,sEAAiC,CAAA;IACjC,eAAe;IACf,kEAA6B,CAAA;IAC7B,wFAAmD,CAAA;IACnD,gEAA2B,CAAA;IAC3B,kEAA6B,CAAA;IAC7B,oEAA+B,CAAA;IAC/B,gEAA2B,CAAA;IAC3B,wEAAmC,CAAA;IACnC,kFAA6C,CAAA;IAC7C,sFAAiD,CAAA;IACjD,gFAA2C,CAAA;IAC3C,wFAAmD,CAAA;IACnD,kFAA6C,CAAA;IAC7C,+BAA+B;IAC/B,sGAAiE,CAAA;IACjE,sFAAiD,CAAA;IACjD,4FAAuD,CAAA;IACvD,4FAAuD,CAAA;IACvD,oGAA+D,CAAA;IAC/D,4FAAuD,CAAA;IACvD,sGAAiE,CAAA;IACjE,sGAAiE,CAAA;IACjE,iBAAiB;IACjB,kEAA6B,CAAA;IAC7B,4EAAuC,CAAA;IACvC,YAAY;IACZ,wEAAmC,CAAA;IACnC,uBAAuB;IACvB,gEAA2B,CAAA;IAC3B,wBAAwB;IACxB,gGAA2D,CAAA;IAC3D,kBAAkB;IAClB,oFAA+C,CAAA;IAC/C,WAAW;IACX,wEAAmC,CAAA;IACnC,cAAc;IACd,gFAA2C,CAAA;IAC3C,sBAAsB;IACtB,0EAAqC,CAAA;IACrC,mBAAmB;IACnB,0EAAqC,CAAA;IACrC,8EAAyC,CAAA;IACzC,iBAAiB;IACjB,8EAAyC,CAAA;IACzC,4FAAuD,CAAA;IACvD,8EAAyC,CAAA;IACzC,yBAAyB;IACzB,4EAAuC,CAAA;AACzC,CAAC,EAzEW,iCAAiC,iDAAjC,iCAAiC,QAyE5C;AA2gBD,oBAAoB;AACpB,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,6DAA2C,CAAA;IAC3C,wCAAwC;AAC1C,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}
+{"version":3,"file":"mindedConnectionTypes.js","sourceRoot":"","sources":["../../src/platform/mindedConnectionTypes.ts"],"names":[],"mappings":";;;AAaA,IAAY,iCA6EX;AA7ED,WAAY,iCAAiC;IAC3C,kEAA6B,CAAA;IAC7B,gEAA2B,CAAA;IAC3B,gFAA2C,CAAA;IAC3C,gFAA2C,CAAA;IAC3C,oFAA+C,CAAA;IAC/C,wFAAmD,CAAA;IACnD,4DAAuB,CAAA;IACvB,oEAA+B,CAAA;IAC/B,sDAAiB,CAAA;IACjB,0EAAqC,CAAA;IACrC,cAAc;IACd,kFAA6C,CAAA;IAC7C,sEAAiC,CAAA;IACjC,wEAAmC,CAAA;IACnC,oFAA+C,CAAA;IAC/C,8EAAyC,CAAA;IACzC,QAAQ;IACR,0EAAqC,CAAA;IACrC,4EAAuC,CAAA;IACvC,gFAA2C,CAAA;IAC3C,4EAAuC,CAAA;IACvC,8EAAyC,CAAA;IACzC,8FAAyD,CAAA;IACzD,sEAAiC,CAAA;IACjC,eAAe;IACf,kEAA6B,CAAA;IAC7B,wFAAmD,CAAA;IACnD,gEAA2B,CAAA;IAC3B,kEAA6B,CAAA;IAC7B,oEAA+B,CAAA;IAC/B,gEAA2B,CAAA;IAC3B,wEAAmC,CAAA;IACnC,kFAA6C,CAAA;IAC7C,sFAAiD,CAAA;IACjD,gFAA2C,CAAA;IAC3C,wFAAmD,CAAA;IACnD,kFAA6C,CAAA;IAC7C,+BAA+B;IAC/B,sGAAiE,CAAA;IACjE,sFAAiD,CAAA;IACjD,4FAAuD,CAAA;IACvD,4FAAuD,CAAA;IACvD,oGAA+D,CAAA;IAC/D,4FAAuD,CAAA;IACvD,sGAAiE,CAAA;IACjE,sGAAiE,CAAA;IACjE,iBAAiB;IACjB,kEAA6B,CAAA;IAC7B,8FAA8F;IAC9F,4EAAuC,CAAA;IACvC,qBAAqB;IACrB,wFAAmD,CAAA;IACnD,kHAA6E,CAAA;IAC7E,YAAY;IACZ,wEAAmC,CAAA;IACnC,uBAAuB;IACvB,gEAA2B,CAAA;IAC3B,wBAAwB;IACxB,gGAA2D,CAAA;IAC3D,kBAAkB;IAClB,oFAA+C,CAAA;IAC/C,WAAW;IACX,wEAAmC,CAAA;IACnC,cAAc;IACd,gFAA2C,CAAA;IAC3C,sBAAsB;IACtB,0EAAqC,CAAA;IACrC,mBAAmB;IACnB,0EAAqC,CAAA;IACrC,8EAAyC,CAAA;IACzC,iBAAiB;IACjB,8EAAyC,CAAA;IACzC,4FAAuD,CAAA;IACvD,8EAAyC,CAAA;IACzC,yBAAyB;IACzB,4EAAuC,CAAA;AACzC,CAAC,EA7EW,iCAAiC,iDAAjC,iCAAiC,QA6E5C;AA8nBD,oBAAoB;AACpB,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,6DAA2C,CAAA;IAC3C,wCAAwC;AAC1C,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}

package/dist/toolsLibrary/knowledgeBase.d.ts

@@ -0,0 +1,123 @@
+import { KnowledgeBaseFilter, KnowledgeBaseRetrievalResult, KnowledgeBaseCitation } from '../platform/mindedConnectionTypes';
+/**
+ * Retrieve relevant documents from a knowledge base without generation.
+ *
+ * This function queries a knowledge base and returns matching document chunks based on
+ * the given query, with support for filtering and controlling the number of results.
+ *
+ * @param params - The retrieval parameters
+ * @param params.knowledgeBaseId - Optional ID of the knowledge base to query. If omitted, the backend
+ * will auto-select the knowledge base if exactly one exists for the agent. If 0 or >1 knowledge bases
+ * exist, an error will be thrown requiring you to pass knowledgeBaseId explicitly.
+ * @param params.environment - The environment (e.g., 'development', 'production')
+ * @param params.query - The search query string
+ * @param params.numberOfResults - Optional number of results to return (default: 5)
+ * @param params.filters - Optional filters for metadata-based filtering
+ * @param timeoutMs - Optional timeout in milliseconds (default: 30000)
+ *
+ * @returns Promise that resolves with retrieval results including content, metadata, and scores
+ *
+ * @throws {Error} When the retrieval fails or when knowledgeBaseId is omitted and 0 or >1 KBs exist
+ *
+ * @example
+ * ```typescript
+ * import { retrieveFromKnowledgeBase } from '@minded-ai/mindedjs';
+ *
+ * // With explicit knowledgeBaseId
+ * const results = await retrieveFromKnowledgeBase({
+ *   knowledgeBaseId: 'kb-123',
+ *   environment: 'production',
+ *   query: 'How do I reset my password?',
+ *   numberOfResults: 10,
+ *   filters: {
+ *     equals: { key: 'category', value: 'support' }
+ *   }
+ * });
+ *
+ * // Without knowledgeBaseId (auto-selects if agent has exactly 1 KB)
+ * const results2 = await retrieveFromKnowledgeBase({
+ *   environment: 'production',
+ *   query: 'What are the shipping options?',
+ *   numberOfResults: 5
+ * });
+ *
+ * for (const result of results.retrievalResults) {
+ *   console.log(result.content.text, result.score);
+ * }
+ * ```
+ */
+export declare function retrieveFromKnowledgeBase(params: {
+    knowledgeBaseId?: string;
+    environment: string;
+    query: string;
+    numberOfResults?: number;
+    filters?: KnowledgeBaseFilter;
+}, timeoutMs?: number): Promise<{
+    retrievalResults: KnowledgeBaseRetrievalResult[];
+    nextToken?: string;
+}>;
+/**
+ * Retrieve documents and generate a response using a knowledge base with citations.
+ *
+ * This function queries a knowledge base, retrieves relevant documents, and generates
+ * a response using an LLM, including citations that reference the source documents.
+ *
+ * @param params - The retrieval and generation parameters
+ * @param params.knowledgeBaseId - Optional ID of the knowledge base to query. If omitted, the backend
+ * will auto-select the knowledge base if exactly one exists for the agent. If 0 or >1 knowledge bases
+ * exist, an error will be thrown requiring you to pass knowledgeBaseId explicitly.
+ * @param params.environment - The environment (e.g., 'development', 'production')
+ * @param params.query - The search query string
+ * @param params.modelArn - Optional model ARN to use for generation (defaults to configured model)
+ * @param params.numberOfResults - Optional number of results to retrieve (default: 5)
+ * @param params.filters - Optional filters for metadata-based filtering
+ * @param timeoutMs - Optional timeout in milliseconds (default: 60000 for generation)
+ *
+ * @returns Promise that resolves with the generated output, citations, and optional session ID
+ *
+ * @throws {Error} When the retrieval or generation fails or when knowledgeBaseId is omitted and 0 or >1 KBs exist
+ *
+ * @example
+ * ```typescript
+ * import { retrieveAndGenerateFromKnowledgeBase } from '@minded-ai/mindedjs';
+ *
+ * // With explicit knowledgeBaseId
+ * const result = await retrieveAndGenerateFromKnowledgeBase({
+ *   knowledgeBaseId: 'kb-123',
+ *   environment: 'production',
+ *   query: 'Summarize the refund policy',
+ *   numberOfResults: 5
+ * });
+ *
+ * // Without knowledgeBaseId (auto-selects if agent has exactly 1 KB)
+ * const result2 = await retrieveAndGenerateFromKnowledgeBase({
+ *   environment: 'production',
+ *   query: 'What are the warranty terms?',
+ *   numberOfResults: 5
+ * });
+ *
+ * console.log('Response:', result.output);
+ * console.log('Citations:', result.citations.length);
+ *
+ * // Access citation details
+ * for (const citation of result.citations) {
+ *   console.log('Cited text:', citation.generatedResponsePart.textResponsePart.text);
+ *   for (const ref of citation.retrievedReferences) {
+ *     console.log('Source:', ref.location.s3Location.uri);
+ *   }
+ * }
+ * ```
+ */
+export declare function retrieveAndGenerateFromKnowledgeBase(params: {
+    knowledgeBaseId?: string;
+    environment: string;
+    query: string;
+    modelArn?: string;
+    numberOfResults?: number;
+    filters?: KnowledgeBaseFilter;
+}, timeoutMs?: number): Promise<{
+    output: string | null;
+    citations: KnowledgeBaseCitation[];
+    sessionId?: string;
+}>;
+//# sourceMappingURL=knowledgeBase.d.ts.map

package/dist/toolsLibrary/knowledgeBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeBase.d.ts","sourceRoot":"","sources":["../../src/toolsLibrary/knowledgeBase.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EAKtB,MAAM,mCAAmC,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE;IACN,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,EACD,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC;IAAE,gBAAgB,EAAE,4BAA4B,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCnF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,oCAAoC,CACxD,MAAM,EAAE;IACN,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,EACD,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C5F"}

package/dist/toolsLibrary/knowledgeBase.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retrieveFromKnowledgeBase = retrieveFromKnowledgeBase;
+exports.retrieveAndGenerateFromKnowledgeBase = retrieveAndGenerateFromKnowledgeBase;
+const mindedConnection_1 = require("../platform/mindedConnection");
+const mindedConnectionTypes_1 = require("../platform/mindedConnectionTypes");
+const logger_1 = require("../utils/logger");
+/**
+ * Retrieve relevant documents from a knowledge base without generation.
+ *
+ * This function queries a knowledge base and returns matching document chunks based on
+ * the given query, with support for filtering and controlling the number of results.
+ *
+ * @param params - The retrieval parameters
+ * @param params.knowledgeBaseId - Optional ID of the knowledge base to query. If omitted, the backend
+ * will auto-select the knowledge base if exactly one exists for the agent. If 0 or >1 knowledge bases
+ * exist, an error will be thrown requiring you to pass knowledgeBaseId explicitly.
+ * @param params.environment - The environment (e.g., 'development', 'production')
+ * @param params.query - The search query string
+ * @param params.numberOfResults - Optional number of results to return (default: 5)
+ * @param params.filters - Optional filters for metadata-based filtering
+ * @param timeoutMs - Optional timeout in milliseconds (default: 30000)
+ *
+ * @returns Promise that resolves with retrieval results including content, metadata, and scores
+ *
+ * @throws {Error} When the retrieval fails or when knowledgeBaseId is omitted and 0 or >1 KBs exist
+ *
+ * @example
+ * ```typescript
+ * import { retrieveFromKnowledgeBase } from '@minded-ai/mindedjs';
+ *
+ * // With explicit knowledgeBaseId
+ * const results = await retrieveFromKnowledgeBase({
+ *   knowledgeBaseId: 'kb-123',
+ *   environment: 'production',
+ *   query: 'How do I reset my password?',
+ *   numberOfResults: 10,
+ *   filters: {
+ *     equals: { key: 'category', value: 'support' }
+ *   }
+ * });
+ *
+ * // Without knowledgeBaseId (auto-selects if agent has exactly 1 KB)
+ * const results2 = await retrieveFromKnowledgeBase({
+ *   environment: 'production',
+ *   query: 'What are the shipping options?',
+ *   numberOfResults: 5
+ * });
+ *
+ * for (const result of results.retrievalResults) {
+ *   console.log(result.content.text, result.score);
+ * }
+ * ```
+ */
+async function retrieveFromKnowledgeBase(params, timeoutMs = 30000) {
+    var _a;
+    try {
+        const request = {
+            type: mindedConnectionTypes_1.mindedConnectionSocketMessageType.KNOWLEDGE_BASE_RETRIEVE,
+            ...(params.knowledgeBaseId && { knowledgeBaseId: params.knowledgeBaseId }),
+            environment: params.environment,
+            query: params.query,
+            numberOfResults: params.numberOfResults,
+            filters: params.filters,
+        };
+        const response = await (0, mindedConnection_1.awaitEmit)(mindedConnectionTypes_1.mindedConnectionSocketMessageType.KNOWLEDGE_BASE_RETRIEVE, request, timeoutMs);
+        if (response.error) {
+            throw new Error(`Knowledge base retrieval failed: ${response.error}`);
+        }
+        logger_1.logger.debug({
+            msg: '[KnowledgeBase] Retrieval completed',
+            knowledgeBaseId: params.knowledgeBaseId,
+            resultsFound: ((_a = response.retrievalResults) === null || _a === void 0 ? void 0 : _a.length) || 0,
+        });
+        return {
+            retrievalResults: response.retrievalResults || [],
+            nextToken: response.nextToken,
+        };
+    }
+    catch (err) {
+        logger_1.logger.error({
+            msg: '[KnowledgeBase] Error retrieving from knowledge base',
+            err,
+            knowledgeBaseId: params.knowledgeBaseId,
+            query: params.query,
+        });
+        throw new Error(`Failed to retrieve from knowledge base: ${err instanceof Error ? err.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Retrieve documents and generate a response using a knowledge base with citations.
+ *
+ * This function queries a knowledge base, retrieves relevant documents, and generates
+ * a response using an LLM, including citations that reference the source documents.
+ *
+ * @param params - The retrieval and generation parameters
+ * @param params.knowledgeBaseId - Optional ID of the knowledge base to query. If omitted, the backend
+ * will auto-select the knowledge base if exactly one exists for the agent. If 0 or >1 knowledge bases
+ * exist, an error will be thrown requiring you to pass knowledgeBaseId explicitly.
+ * @param params.environment - The environment (e.g., 'development', 'production')
+ * @param params.query - The search query string
+ * @param params.modelArn - Optional model ARN to use for generation (defaults to configured model)
+ * @param params.numberOfResults - Optional number of results to retrieve (default: 5)
+ * @param params.filters - Optional filters for metadata-based filtering
+ * @param timeoutMs - Optional timeout in milliseconds (default: 60000 for generation)
+ *
+ * @returns Promise that resolves with the generated output, citations, and optional session ID
+ *
+ * @throws {Error} When the retrieval or generation fails or when knowledgeBaseId is omitted and 0 or >1 KBs exist
+ *
+ * @example
+ * ```typescript
+ * import { retrieveAndGenerateFromKnowledgeBase } from '@minded-ai/mindedjs';
+ *
+ * // With explicit knowledgeBaseId
+ * const result = await retrieveAndGenerateFromKnowledgeBase({
+ *   knowledgeBaseId: 'kb-123',
+ *   environment: 'production',
+ *   query: 'Summarize the refund policy',
+ *   numberOfResults: 5
+ * });
+ *
+ * // Without knowledgeBaseId (auto-selects if agent has exactly 1 KB)
+ * const result2 = await retrieveAndGenerateFromKnowledgeBase({
+ *   environment: 'production',
+ *   query: 'What are the warranty terms?',
+ *   numberOfResults: 5
+ * });
+ *
+ * console.log('Response:', result.output);
+ * console.log('Citations:', result.citations.length);
+ *
+ * // Access citation details
+ * for (const citation of result.citations) {
+ *   console.log('Cited text:', citation.generatedResponsePart.textResponsePart.text);
+ *   for (const ref of citation.retrievedReferences) {
+ *     console.log('Source:', ref.location.s3Location.uri);
+ *   }
+ * }
+ * ```
+ */
+async function retrieveAndGenerateFromKnowledgeBase(params, timeoutMs = 60000) {
+    var _a, _b;
+    try {
+        const request = {
+            type: mindedConnectionTypes_1.mindedConnectionSocketMessageType.KNOWLEDGE_BASE_RETRIEVE_AND_GENERATE,
+            ...(params.knowledgeBaseId && { knowledgeBaseId: params.knowledgeBaseId }),
+            environment: params.environment,
+            query: params.query,
+            modelArn: params.modelArn,
+            numberOfResults: params.numberOfResults,
+            filters: params.filters,
+        };
+        const response = await (0, mindedConnection_1.awaitEmit)(mindedConnectionTypes_1.mindedConnectionSocketMessageType.KNOWLEDGE_BASE_RETRIEVE_AND_GENERATE, request, timeoutMs);
+        if (response.error) {
+            throw new Error(`Knowledge base retrieve and generate failed: ${response.error}`);
+        }
+        logger_1.logger.debug({
+            msg: '[KnowledgeBase] Retrieve and generate completed',
+            knowledgeBaseId: params.knowledgeBaseId,
+            hasOutput: !!response.output,
+            citationsCount: ((_a = response.citations) === null || _a === void 0 ? void 0 : _a.length) || 0,
+        });
+        return {
+            output: (_b = response.output) !== null && _b !== void 0 ? _b : null,
+            citations: response.citations || [],
+            sessionId: response.sessionId,
+        };
+    }
+    catch (err) {
+        logger_1.logger.error({
+            msg: '[KnowledgeBase] Error in retrieve and generate from knowledge base',
+            err,
+            knowledgeBaseId: params.knowledgeBaseId,
+            query: params.query,
+        });
+        throw new Error(`Failed to retrieve and generate from knowledge base: ${err instanceof Error ? err.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=knowledgeBase.js.map

package/dist/toolsLibrary/knowledgeBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeBase.js","sourceRoot":"","sources":["../../src/toolsLibrary/knowledgeBase.ts"],"names":[],"mappings":"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"}

package/dist/utils/rag.d.ts

@@ -0,0 +1,16 @@
+import type { RagDefaultsConfig } from '../platform/mindedConnectionTypes';
+import type { State } from '../types/LangGraph.types';
+interface RetrieveAndInjectDefaultRagContextParams<Memory extends Record<string, any>> {
+    state: State<Memory>;
+    ragDefaults: RagDefaultsConfig | null;
+}
+/**
+ * Retrieve context from default knowledge bases and inject as system message.
+ * Called after TRIGGER_EVENT.
+ *
+ * @param state - Current agent state
+ * @returns The updated state with injected context message, or original state if no results
+ */
+export declare const retrieveAndInjectDefaultRagContext: <Memory extends Record<string, any>>({ state, ragDefaults, }: RetrieveAndInjectDefaultRagContextParams<Memory>) => Promise<State<Memory>>;
+export {};
+//# sourceMappingURL=rag.d.ts.map

package/dist/utils/rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.d.ts","sourceRoot":"","sources":["../../src/utils/rag.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqD,iBAAiB,EAAkB,MAAM,mCAAmC,CAAC;AAE9I,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAwHtD,UAAU,wCAAwC,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACnF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,GAAU,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,yBAG1F,wCAAwC,CAAC,MAAM,CAAC,KAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CA8G1E,CAAC"}

package/dist/utils/rag.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retrieveAndInjectDefaultRagContext = void 0;
+const messages_1 = require("@langchain/core/messages");
+const uuid_1 = require("uuid");
+const config_1 = require("../platform/config");
+const knowledgeBase_1 = require("../toolsLibrary/knowledgeBase");
+const logger_1 = require("./logger");
+const getNestedValue = ({ obj, path }) => {
+    return path.split('.').reduce((current, key) => {
+        if (current === undefined || current === null)
+            return undefined;
+        return current[key];
+    }, obj);
+};
+const resolveRagFilters = ({ filters, memory }) => {
+    if (!filters || filters.length === 0) {
+        return undefined;
+    }
+    const resolvedFilters = [];
+    for (const filter of filters) {
+        // Check if value is a chip pattern like {state.memory.language}
+        const chipPattern = /^\{state\.memory\.([^}]+)\}$/;
+        const match = filter.value.match(chipPattern);
+        let resolvedValue;
+        if (match) {
+            // Extract the memory path (e.g., "language" or "user.preferences.lang")
+            const memoryPath = match[1];
+            const memoryValue = getNestedValue({ obj: memory, path: memoryPath });
+            if (memoryValue === undefined || memoryValue === null) {
+                // Skip this filter entry if memory value is missing
+                logger_1.logger.debug({
+                    msg: '[Agent] Skipping RAG filter - memory value not found',
+                    filterKey: filter.key,
+                    memoryPath,
+                });
+                continue;
+            }
+            resolvedValue = String(memoryValue);
+        }
+        else {
+            // Plain string value
+            resolvedValue = filter.value;
+        }
+        // Create the knowledge base filter based on operator
+        const knowledgeBaseFilter = {};
+        switch (filter.operator) {
+            case 'equals':
+                knowledgeBaseFilter.equals = { key: filter.key, value: resolvedValue };
+                break;
+            case 'notEquals':
+                knowledgeBaseFilter.notEquals = { key: filter.key, value: resolvedValue };
+                break;
+            case 'greaterThan':
+                knowledgeBaseFilter.greaterThan = { key: filter.key, value: resolvedValue };
+                break;
+            case 'lessThan':
+                knowledgeBaseFilter.lessThan = { key: filter.key, value: resolvedValue };
+                break;
+        }
+        resolvedFilters.push(knowledgeBaseFilter);
+    }
+    if (resolvedFilters.length === 0) {
+        return undefined;
+    }
+    // Combine all filters with andAll
+    if (resolvedFilters.length === 1) {
+        return resolvedFilters[0];
+    }
+    return { andAll: resolvedFilters };
+};
+/**
+ * Get the source name from a retrieval result.
+ * Uses documentName from metadata, falling back to the last path segment of s3Location.uri.
+ */
+const getSourceName = (result) => {
+    var _a, _b, _c;
+    if ((_a = result.metadata) === null || _a === void 0 ? void 0 : _a.documentName) {
+        return result.metadata.documentName;
+    }
+    // Fallback to last segment of S3 URI
+    const uri = ((_c = (_b = result.location) === null || _b === void 0 ? void 0 : _b.s3Location) === null || _c === void 0 ? void 0 : _c.uri) || '';
+    const segments = uri.split('/');
+    return segments[segments.length - 1] || 'Unknown Source';
+};
+/**
+ * Format RAG retrieval results into a markdown string for injection.
+ */
+const formatRagResultsToMarkdown = (allResults) => {
+    if (allResults.length === 0) {
+        return '';
+    }
+    let markdown = '### Below are details that may be related to the query:\n\n';
+    for (const result of allResults) {
+        markdown += `#### Source: ${result.source}\n`;
+        markdown += `${result.content}\n\n`;
+    }
+    return markdown.trim();
+};
+/**
+ * Retrieve context from default knowledge bases and inject as system message.
+ * Called after TRIGGER_EVENT.
+ *
+ * @param state - Current agent state
+ * @returns The updated state with injected context message, or original state if no results
+ */
+const retrieveAndInjectDefaultRagContext = async ({ state, ragDefaults, }) => {
+    var _a, _b;
+    // Get query from the last user message or triggerBody content
+    let query;
+    try {
+        const lastUserMessage = state.messages.filter((m) => m.getType() === 'human').slice(-1)[0];
+        query = typeof (lastUserMessage === null || lastUserMessage === void 0 ? void 0 : lastUserMessage.content) === 'string' ? lastUserMessage.content : JSON.stringify(lastUserMessage.content);
+        if (!query) {
+            return state;
+        }
+    }
+    catch (err) {
+        logger_1.logger.error({ msg: '[Agent] Error retrieving and injecting default RAG context', err });
+        return state;
+    }
+    const { runLocally, env } = (0, config_1.getConfig)();
+    // Determine which environment's config to use
+    // For production runtime, always use production config
+    // For local/dev, use the configured environment
+    const configEnv = !runLocally && env === 'production' ? 'production' : env || 'development';
+    const envConfig = ragDefaults === null || ragDefaults === void 0 ? void 0 : ragDefaults[configEnv];
+    // Check if RAG defaults are configured and enabled for this environment
+    if (!(envConfig === null || envConfig === void 0 ? void 0 : envConfig.enabled) || !((_a = envConfig.knowledgeBases) === null || _a === void 0 ? void 0 : _a.length)) {
+        return state;
+    }
+    // Collect all retrieval results across all KBs
+    const allResults = [];
+    for (const kbConfig of envConfig.knowledgeBases) {
+        try {
+            // Use the KB-specific environment for retrieval
+            // This allows querying a different KB environment than the config environment
+            const targetEnvironment = kbConfig.environment || configEnv;
+            // Resolve filters with memory values
+            const resolvedFilters = resolveRagFilters({ filters: kbConfig.filters, memory: state.memory });
+            logger_1.logger.debug({
+                msg: '[Agent] Retrieving from default knowledge base',
+                knowledgeBaseId: kbConfig.knowledgeBaseId,
+                environment: targetEnvironment,
+                numberOfResults: kbConfig.numberOfResults,
+                minScore: kbConfig.minScore,
+                hasFilters: !!resolvedFilters,
+                configuredFilters: ((_b = kbConfig.filters) === null || _b === void 0 ? void 0 : _b.length) || 0,
+                resolvedFilters: resolvedFilters ? JSON.stringify(resolvedFilters) : undefined,
+            });
+            // Call the retrieval API
+            const response = await (0, knowledgeBase_1.retrieveFromKnowledgeBase)({
+                knowledgeBaseId: kbConfig.knowledgeBaseId,
+                environment: targetEnvironment,
+                query,
+                numberOfResults: kbConfig.numberOfResults,
+                filters: resolvedFilters,
+            });
+            // Filter by minScore and format results
+            for (const result of response.retrievalResults || []) {
+                // Skip results below minScore threshold
+                if (kbConfig.minScore !== undefined && result.score < kbConfig.minScore) {
+                    logger_1.logger.debug({
+                        msg: '[Agent] Skipping RAG result below minScore',
+                        score: result.score,
+                        minScore: kbConfig.minScore,
+                    });
+                    continue;
+                }
+                allResults.push({
+                    source: getSourceName(result),
+                    content: result.content.text,
+                });
+            }
+        }
+        catch (err) {
+            // Log error but continue with other KBs
+            logger_1.logger.error({
+                msg: '[Agent] Error retrieving from default knowledge base',
+                knowledgeBaseId: kbConfig.knowledgeBaseId,
+                err,
+            });
+        }
+    }
+    // If no results, return original state
+    if (allResults.length === 0) {
+        logger_1.logger.debug({ msg: '[Agent] No RAG results to inject' });
+        return state;
+    }
+    // Format results to markdown
+    const contextMarkdown = formatRagResultsToMarkdown(allResults);
+    // Inject as a separate system message
+    const contextMessage = new messages_1.SystemMessage({
+        content: contextMarkdown,
+        id: (0, uuid_1.v4)(),
+    });
+    // Add the context message to the state
+    state.messages.push(contextMessage);
+    logger_1.logger.debug({
+        msg: '[Agent] Injected RAG context as system message',
+        resultsCount: allResults.length,
+    });
+    return state;
+};
+exports.retrieveAndInjectDefaultRagContext = retrieveAndInjectDefaultRagContext;
+//# sourceMappingURL=rag.js.map

package/dist/utils/rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.js","sourceRoot":"","sources":["../../src/utils/rag.ts"],"names":[],"mappings":"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"}

package/docs/SUMMARY.md

@@ -25,16 +25,22 @@
 - [Debugging](sdk/debugging.md)
 - [Memory](sdk/memory.md)
 - [Events](sdk/events.md)
+- [Knowledge Base RAG API](sdk/knowledge-base-rag.md)
 - [Logging](sdk/logging.md)
 - [Parallel LLM Requests](sdk/parallel-llm.md)
 
+## API
+
+- [Overview](api/overview.md)
+- [Analytics API](api/analytics.md)
+- [Knowledge API](api/knowledge.md)
+
 ## Platform
 
 - [Secrets](platform/secrets.md)
-- [REST API](platform/api.md)
+- [Knowledge Bases](platform/knowledge-bases.md)
 - [PII Masking](platform/pii-masking.md)
 - [Operator](platform/operator.md)
-- [Browser Task](platform/browserTask.md)
 - [SSO (Single Sign-On)](platform/sso.md)
 - [On-prem Deployment](platform/on-prem.md)
 - [Security Architecture](platform/security-architecture.md)