@elizaos/plugin-knowledge 1.0.5 → 1.0.6

package/dist/{chunk-MFXNKYBS.js → chunk-536BD2UA.js}

@@ -303,6 +303,10 @@ async function fetchUrlContent(url) {
     throw new Error(`Failed to fetch content from URL: ${error.message}`);
   }
 }
+function looksLikeBase64(content) {
+  const base64Regex = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+  return content && content.length > 0 && base64Regex.test(content.replace(/\s/g, "")) || false;
+}
 
 // src/docs-loader.ts
 function getKnowledgePath() {
@@ -513,7 +517,8 @@ export {
   isBinaryContentType,
   normalizeS3Url,
   fetchUrlContent,
+  looksLikeBase64,
   getKnowledgePath,
   loadDocsFromPath
 };
-//# sourceMappingURL=chunk-MFXNKYBS.js.map
+//# sourceMappingURL=chunk-536BD2UA.js.map

package/dist/{chunk-MFXNKYBS.js.map → chunk-536BD2UA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/docs-loader.ts","../src/utils.ts"],"sourcesContent":["import { logger, UUID, createUniqueUuid } from \"@elizaos/core\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { KnowledgeService } from \"./service.ts\";\nimport { AddKnowledgeOptions } from \"./types.ts\";\nimport { isBinaryContentType } from './utils.ts';\n\n/**\n * Get the knowledge path from environment or default to ./docs\n */\nexport function getKnowledgePath(): string {\n  const envPath = process.env.KNOWLEDGE_PATH;\n\n  if (envPath) {\n    // Resolve relative paths from current working directory\n    const resolvedPath = path.resolve(envPath);\n\n    if (!fs.existsSync(resolvedPath)) {\n      logger.warn(`Knowledge path from environment variable does not exist: ${resolvedPath}`);\n      logger.warn('Please create the directory or update KNOWLEDGE_PATH environment variable');\n    }\n\n    return resolvedPath;\n  }\n\n  // Default to docs folder in current working directory\n  const defaultPath = path.join(process.cwd(), 'docs');\n\n  if (!fs.existsSync(defaultPath)) {\n    logger.info(`Default docs folder does not exist at: ${defaultPath}`);\n    logger.info('To use the knowledge plugin, either:');\n    logger.info('1. Create a \"docs\" folder in your project root');\n    logger.info('2. Set KNOWLEDGE_PATH environment variable to your documents folder');\n  }\n\n  return defaultPath;\n}\n\n/**\n * Load documents from the knowledge path\n */\nexport async function loadDocsFromPath(\n  service: KnowledgeService,\n  agentId: UUID,\n  worldId?: UUID\n): Promise<{ total: number; successful: number; failed: number }> {\n  const docsPath = getKnowledgePath();\n\n  if (!fs.existsSync(docsPath)) {\n    logger.warn(`Knowledge path does not exist: ${docsPath}`);\n    return { total: 0, successful: 0, failed: 0 };\n  }\n\n  logger.info(`Loading documents from: ${docsPath}`);\n\n  // Get all files recursively\n  const files = getAllFiles(docsPath);\n\n  if (files.length === 0) {\n    logger.info('No files found in knowledge path');\n    return { total: 0, successful: 0, failed: 0 };\n  }\n\n  logger.info(`Found ${files.length} files to process`);\n\n  let successful = 0;\n  let failed = 0;\n\n  for (const filePath of files) {\n    try {\n      const fileName = path.basename(filePath);\n      const fileExt = path.extname(filePath).toLowerCase();\n\n      // Skip hidden files and directories\n      if (fileName.startsWith('.')) {\n        continue;\n      }\n\n      // Determine content type\n      const contentType = getContentType(fileExt);\n\n      // Skip unsupported file types\n      if (!contentType) {\n        logger.debug(`Skipping unsupported file type: ${filePath}`);\n        continue;\n      }\n\n      // Read file\n      const fileBuffer = fs.readFileSync(filePath);\n\n      // Check if file is binary using the same logic as the service\n      const isBinary = isBinaryContentType(contentType, fileName);\n\n      // For text files, read as UTF-8 string directly\n      // For binary files, convert to base64\n      const content = isBinary ? fileBuffer.toString('base64') : fileBuffer.toString('utf-8');\n\n      // Create knowledge options\n      const knowledgeOptions: AddKnowledgeOptions = {\n        clientDocumentId: createUniqueUuid(agentId, `docs-${fileName}-${Date.now()}`) as UUID,\n        contentType,\n        originalFilename: fileName,\n        worldId: worldId || agentId,\n        content,\n        roomId: agentId,\n        entityId: agentId,\n      };\n\n      // Process the document\n      logger.debug(`Processing document: ${fileName}`);\n      const result = await service.addKnowledge(knowledgeOptions);\n\n      logger.info(`Successfully processed ${fileName}: ${result.fragmentCount} fragments created`);\n      successful++;\n    } catch (error) {\n      logger.error(`Failed to process file ${filePath}:`, error);\n      failed++;\n    }\n  }\n\n  logger.info(\n    `Document loading complete: ${successful} successful, ${failed} failed out of ${files.length} total`\n  );\n\n  return {\n    total: files.length,\n    successful,\n    failed,\n  };\n}\n\n/**\n * Recursively get all files in a directory\n */\nfunction getAllFiles(dirPath: string, files: string[] = []): string[] {\n  try {\n    const entries = fs.readdirSync(dirPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = path.join(dirPath, entry.name);\n\n      if (entry.isDirectory()) {\n        // Skip node_modules and other common directories\n        if (!['node_modules', '.git', '.vscode', 'dist', 'build'].includes(entry.name)) {\n          getAllFiles(fullPath, files);\n        }\n      } else if (entry.isFile()) {\n        files.push(fullPath);\n      }\n    }\n  } catch (error) {\n    logger.error(`Error reading directory ${dirPath}:`, error);\n  }\n\n  return files;\n}\n\n/**\n * Get content type based on file extension\n */\nfunction getContentType(extension: string): string | null {\n  const contentTypes: Record<string, string> = {\n    // Text documents\n    '.txt': 'text/plain',\n    '.md': 'text/markdown',\n    '.markdown': 'text/markdown',\n    '.tson': 'text/plain',\n    '.xml': 'application/xml',\n    '.csv': 'text/csv',\n    '.tsv': 'text/tab-separated-values',\n    '.log': 'text/plain',\n\n    // Web files\n    '.html': 'text/html',\n    '.htm': 'text/html',\n    '.css': 'text/css',\n    '.scss': 'text/x-scss',\n    '.sass': 'text/x-sass',\n    '.less': 'text/x-less',\n\n    // JavaScript/TypeScript\n    '.js': 'text/javascript',\n    '.jsx': 'text/javascript',\n    '.ts': 'text/typescript',\n    '.tsx': 'text/typescript',\n    '.mjs': 'text/javascript',\n    '.cjs': 'text/javascript',\n    '.vue': 'text/x-vue',\n    '.svelte': 'text/x-svelte',\n    '.astro': 'text/x-astro',\n\n    // Python\n    '.py': 'text/x-python',\n    '.pyw': 'text/x-python',\n    '.pyi': 'text/x-python',\n\n    // Java/Kotlin/Scala\n    '.java': 'text/x-java',\n    '.kt': 'text/x-kotlin',\n    '.kts': 'text/x-kotlin',\n    '.scala': 'text/x-scala',\n\n    // C/C++/C#\n    '.c': 'text/x-c',\n    '.cpp': 'text/x-c++',\n    '.cc': 'text/x-c++',\n    '.cxx': 'text/x-c++',\n    '.h': 'text/x-c',\n    '.hpp': 'text/x-c++',\n    '.cs': 'text/x-csharp',\n\n    // Other languages\n    '.php': 'text/x-php',\n    '.rb': 'text/x-ruby',\n    '.go': 'text/x-go',\n    '.rs': 'text/x-rust',\n    '.swift': 'text/x-swift',\n    '.r': 'text/x-r',\n    '.R': 'text/x-r',\n    '.m': 'text/x-objectivec',\n    '.mm': 'text/x-objectivec',\n    '.clj': 'text/x-clojure',\n    '.cljs': 'text/x-clojure',\n    '.ex': 'text/x-elixir',\n    '.exs': 'text/x-elixir',\n    '.lua': 'text/x-lua',\n    '.pl': 'text/x-perl',\n    '.pm': 'text/x-perl',\n    '.dart': 'text/x-dart',\n    '.hs': 'text/x-haskell',\n    '.elm': 'text/x-elm',\n    '.ml': 'text/x-ocaml',\n    '.fs': 'text/x-fsharp',\n    '.fsx': 'text/x-fsharp',\n    '.vb': 'text/x-vb',\n    '.pas': 'text/x-pascal',\n    '.d': 'text/x-d',\n    '.nim': 'text/x-nim',\n    '.zig': 'text/x-zig',\n    '.jl': 'text/x-julia',\n    '.tcl': 'text/x-tcl',\n    '.awk': 'text/x-awk',\n    '.sed': 'text/x-sed',\n\n    // Shell scripts\n    '.sh': 'text/x-sh',\n    '.bash': 'text/x-sh',\n    '.zsh': 'text/x-sh',\n    '.fish': 'text/x-fish',\n    '.ps1': 'text/x-powershell',\n    '.bat': 'text/x-batch',\n    '.cmd': 'text/x-batch',\n\n    // Config files\n    '.json': 'application/json',\n    '.yaml': 'text/x-yaml',\n    '.yml': 'text/x-yaml',\n    '.toml': 'text/x-toml',\n    '.ini': 'text/x-ini',\n    '.cfg': 'text/x-ini',\n    '.conf': 'text/x-ini',\n    '.env': 'text/plain',\n    '.gitignore': 'text/plain',\n    '.dockerignore': 'text/plain',\n    '.editorconfig': 'text/plain',\n    '.properties': 'text/x-properties',\n\n    // Database\n    '.sql': 'text/x-sql',\n\n    // Binary documents\n    '.pdf': 'application/pdf',\n    '.doc': 'application/msword',\n    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  };\n\n  return contentTypes[extension] || null;\n}\n","import { Buffer } from 'node:buffer';\nimport * as mammoth from 'mammoth';\nimport { logger } from '@elizaos/core';\nimport { getDocument, PDFDocumentProxy } from 'pdfjs-dist/legacy/build/pdf.mjs';\nimport type { TextItem, TextMarkedContent } from 'pdfjs-dist/types/src/display/api';\n\nconst PLAIN_TEXT_CONTENT_TYPES = [\n  'application/typescript',\n  'text/typescript',\n  'text/x-python',\n  'application/x-python-code',\n  'application/yaml',\n  'text/yaml',\n  'application/x-yaml',\n  'application/json',\n  'text/markdown',\n  'text/csv',\n];\n\nconst MAX_FALLBACK_SIZE_BYTES = 5 * 1024 * 1024; // 5 MB\nconst BINARY_CHECK_BYTES = 1024; // Check first 1KB for binary indicators\n\n/**\n * Extracts text content from a file buffer based on its content type.\n * Supports DOCX, plain text, and provides a fallback for unknown types.\n * PDF should be handled by `convertPdfToTextFromBuffer`.\n */\nexport async function extractTextFromFileBuffer(\n  fileBuffer: Buffer,\n  contentType: string,\n  originalFilename: string // For logging and context\n): Promise<string> {\n  const lowerContentType = contentType.toLowerCase();\n  logger.debug(\n    `[TextUtil] Attempting to extract text from ${originalFilename} (type: ${contentType})`\n  );\n\n  if (\n    lowerContentType === 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'\n  ) {\n    logger.debug(`[TextUtil] Extracting text from DOCX ${originalFilename} via mammoth.`);\n    try {\n      const result = await mammoth.extractRawText({ buffer: fileBuffer });\n      logger.debug(\n        `[TextUtil] DOCX text extraction complete for ${originalFilename}. Text length: ${result.value.length}`\n      );\n      return result.value;\n    } catch (docxError: any) {\n      const errorMsg = `[TextUtil] Failed to parse DOCX file ${originalFilename}: ${docxError.message}`;\n      logger.error(errorMsg, docxError.stack);\n      throw new Error(errorMsg);\n    }\n  } else if (\n    lowerContentType === 'application/msword' ||\n    originalFilename.toLowerCase().endsWith('.doc')\n  ) {\n    // For .doc files, we'll store the content as-is, and just add a message\n    // The frontend will handle the display appropriately\n    logger.debug(`[TextUtil] Handling Microsoft Word .doc file: ${originalFilename}`);\n\n    // We'll add a descriptive message as a placeholder\n    return `[Microsoft Word Document: ${originalFilename}]\\n\\nThis document was indexed for search but cannot be displayed directly in the browser. The original document content is preserved for retrieval purposes.`;\n  } else if (\n    lowerContentType.startsWith('text/') ||\n    PLAIN_TEXT_CONTENT_TYPES.includes(lowerContentType)\n  ) {\n    logger.debug(\n      `[TextUtil] Extracting text from plain text compatible file ${originalFilename} (type: ${contentType})`\n    );\n    return fileBuffer.toString('utf-8');\n  } else {\n    logger.warn(\n      `[TextUtil] Unsupported content type: \"${contentType}\" for ${originalFilename}. Attempting fallback to plain text.`\n    );\n\n    if (fileBuffer.length > MAX_FALLBACK_SIZE_BYTES) {\n      const sizeErrorMsg = `[TextUtil] File ${originalFilename} (type: ${contentType}) exceeds maximum size for fallback (${MAX_FALLBACK_SIZE_BYTES} bytes). Cannot process as plain text.`;\n      logger.error(sizeErrorMsg);\n      throw new Error(sizeErrorMsg);\n    }\n\n    // Simple binary detection: check for null bytes in the first N bytes\n    const initialBytes = fileBuffer.subarray(0, Math.min(fileBuffer.length, BINARY_CHECK_BYTES));\n    if (initialBytes.includes(0)) {\n      // Check for NUL byte\n      const binaryHeuristicMsg = `[TextUtil] File ${originalFilename} (type: ${contentType}) appears to be binary based on initial byte check. Cannot process as plain text.`;\n      logger.error(binaryHeuristicMsg);\n      throw new Error(binaryHeuristicMsg);\n    }\n\n    try {\n      const textContent = fileBuffer.toString('utf-8');\n      if (textContent.includes('\\ufffd')) {\n        // Replacement character, indicating potential binary or wrong encoding\n        const binaryErrorMsg = `[TextUtil] File ${originalFilename} (type: ${contentType}) seems to be binary or has encoding issues after fallback to plain text (detected \\ufffd).`;\n        logger.error(binaryErrorMsg);\n        throw new Error(binaryErrorMsg); // Throw error for likely binary content\n      }\n      logger.debug(\n        `[TextUtil] Successfully processed unknown type ${contentType} as plain text after fallback for ${originalFilename}.`\n      );\n      return textContent;\n    } catch (fallbackError: any) {\n      // If the initial toString failed or if we threw due to \\ufffd\n      const finalErrorMsg = `[TextUtil] Unsupported content type: ${contentType} for ${originalFilename}. Fallback to plain text also failed or indicated binary content.`;\n      logger.error(finalErrorMsg, fallbackError.message ? fallbackError.stack : undefined);\n      throw new Error(finalErrorMsg);\n    }\n  }\n}\n\n/**\n * Converts a PDF file buffer to text content.\n * Requires pdfjs-dist to be properly configured, especially its worker.\n */\n/**\n * Converts a PDF Buffer to text with enhanced formatting preservation.\n *\n * @param {Buffer} pdfBuffer - The PDF Buffer to convert to text\n * @param {string} [filename] - Optional filename for logging purposes\n * @returns {Promise<string>} Text content of the PDF\n */\nexport async function convertPdfToTextFromBuffer(\n  pdfBuffer: Buffer,\n  filename?: string\n): Promise<string> {\n  const docName = filename || 'unnamed-document';\n  logger.debug(`[PdfService] Starting conversion for ${docName}`);\n\n  try {\n    const uint8Array = new Uint8Array(pdfBuffer);\n    const pdf: PDFDocumentProxy = await getDocument({ data: uint8Array }).promise;\n    const numPages = pdf.numPages;\n    const textPages: string[] = [];\n\n    for (let pageNum = 1; pageNum <= numPages; pageNum++) {\n      logger.debug(`[PdfService] Processing page ${pageNum}/${numPages}`);\n      const page = await pdf.getPage(pageNum);\n      const textContent = await page.getTextContent();\n\n      // Group text items by their y-position to maintain line structure\n      const lineMap = new Map<number, TextItem[]>();\n\n      textContent.items.filter(isTextItem).forEach((item) => {\n        // Round y-position to account for small variations in the same line\n        const yPos = Math.round(item.transform[5]);\n        if (!lineMap.has(yPos)) {\n          lineMap.set(yPos, []);\n        }\n        lineMap.get(yPos)!.push(item);\n      });\n\n      // Sort lines by y-position (top to bottom) and items within lines by x-position (left to right)\n      const sortedLines = Array.from(lineMap.entries())\n        .sort((a, b) => b[0] - a[0]) // Reverse sort for top-to-bottom\n        .map(([_, items]) =>\n          items\n            .sort((a, b) => a.transform[4] - b.transform[4])\n            .map((item) => item.str)\n            .join(' ')\n        );\n\n      textPages.push(sortedLines.join('\\n'));\n    }\n\n    const fullText = textPages.join('\\n\\n').replace(/\\s+/g, ' ').trim();\n    logger.debug(`[PdfService] Conversion complete for ${docName}, length: ${fullText.length}`);\n    return fullText;\n  } catch (error: any) {\n    logger.error(`[PdfService] Error converting PDF ${docName}:`, error.message);\n    throw new Error(`Failed to convert PDF to text: ${error.message}`);\n  }\n}\n\n/**\n * Determines if a file should be treated as binary based on its content type and filename\n * @param contentType MIME type of the file\n * @param filename Original filename\n * @returns True if the file should be treated as binary (base64 encoded)\n */\nexport function isBinaryContentType(contentType: string, filename: string): boolean {\n  // Text-based content types that should NOT be treated as binary\n  const textContentTypes = [\n    'text/',\n    'application/json',\n    'application/xml',\n    'application/javascript',\n    'application/typescript',\n    'application/x-yaml',\n    'application/x-sh',\n  ];\n\n  // Check if it's a text-based MIME type\n  const isTextMimeType = textContentTypes.some((type) => contentType.includes(type));\n  if (isTextMimeType) {\n    return false;\n  }\n\n  // Binary content types\n  const binaryContentTypes = [\n    'application/pdf',\n    'application/msword',\n    'application/vnd.openxmlformats-officedocument',\n    'application/vnd.ms-excel',\n    'application/vnd.ms-powerpoint',\n    'application/zip',\n    'application/x-zip-compressed',\n    'application/octet-stream',\n    'image/',\n    'audio/',\n    'video/',\n  ];\n\n  // Check MIME type\n  const isBinaryMimeType = binaryContentTypes.some((type) => contentType.includes(type));\n\n  if (isBinaryMimeType) {\n    return true;\n  }\n\n  // Check file extension as fallback\n  const fileExt = filename.split('.').pop()?.toLowerCase() || '';\n\n  // Text file extensions that should NOT be treated as binary\n  const textExtensions = [\n    'txt',\n    'md',\n    'markdown',\n    'json',\n    'xml',\n    'html',\n    'htm',\n    'css',\n    'js',\n    'ts',\n    'jsx',\n    'tsx',\n    'yaml',\n    'yml',\n    'toml',\n    'ini',\n    'cfg',\n    'conf',\n    'sh',\n    'bash',\n    'zsh',\n    'fish',\n    'py',\n    'rb',\n    'go',\n    'rs',\n    'java',\n    'c',\n    'cpp',\n    'h',\n    'hpp',\n    'cs',\n    'php',\n    'sql',\n    'r',\n    'swift',\n    'kt',\n    'scala',\n    'clj',\n    'ex',\n    'exs',\n    'vim',\n    'env',\n    'gitignore',\n    'dockerignore',\n    'editorconfig',\n    'log',\n    'csv',\n    'tsv',\n    'properties',\n    'gradle',\n    'sbt',\n    'makefile',\n    'dockerfile',\n    'vagrantfile',\n    'gemfile',\n    'rakefile',\n    'podfile',\n    'csproj',\n    'vbproj',\n    'fsproj',\n    'sln',\n    'pom',\n  ];\n\n  // If it's a known text extension, it's not binary\n  if (textExtensions.includes(fileExt)) {\n    return false;\n  }\n\n  // Binary file extensions\n  const binaryExtensions = [\n    'pdf',\n    'docx',\n    'doc',\n    'xls',\n    'xlsx',\n    'ppt',\n    'pptx',\n    'zip',\n    'rar',\n    '7z',\n    'tar',\n    'gz',\n    'bz2',\n    'xz',\n    'jpg',\n    'jpeg',\n    'png',\n    'gif',\n    'bmp',\n    'svg',\n    'ico',\n    'webp',\n    'mp3',\n    'mp4',\n    'avi',\n    'mov',\n    'wmv',\n    'flv',\n    'wav',\n    'flac',\n    'ogg',\n    'exe',\n    'dll',\n    'so',\n    'dylib',\n    'bin',\n    'dat',\n    'db',\n    'sqlite',\n  ];\n\n  return binaryExtensions.includes(fileExt);\n}\n\n/**\n * Check if the input is a TextItem.\n *\n * @param item - The input item to check.\n * @returns A boolean indicating if the input is a TextItem.\n */\nfunction isTextItem(item: TextItem | TextMarkedContent): item is TextItem {\n  return 'str' in item;\n}\n\n/**\n * Normalizes an S3 URL by removing query parameters (signature, etc.)\n * This allows for consistent URL comparison regardless of presigned URL parameters\n * @param url The S3 URL to normalize\n * @returns The normalized URL containing only the origin and pathname\n */\nexport function normalizeS3Url(url: string): string {\n  try {\n    const urlObj = new URL(url);\n    return `${urlObj.origin}${urlObj.pathname}`;\n  } catch (error) {\n    logger.warn(`[URL NORMALIZER] Failed to parse URL: ${url}. Returning original.`);\n    return url;\n  }\n}\n\n/**\n * Fetches content from a URL and converts it to base64 format\n * @param url The URL to fetch content from\n * @returns An object containing the base64 content and content type\n */\nexport async function fetchUrlContent(\n  url: string\n): Promise<{ content: string; contentType: string }> {\n  logger.debug(`[URL FETCHER] Fetching content from URL: ${url}`);\n\n  try {\n    // Fetch the URL with timeout\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), 30000); // 30 second timeout\n\n    const response = await fetch(url, {\n      signal: controller.signal,\n      headers: {\n        'User-Agent': 'Eliza-Knowledge-Plugin/1.0',\n      },\n    });\n    clearTimeout(timeoutId);\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch URL: ${response.status} ${response.statusText}`);\n    }\n\n    // Get content type from response headers\n    const contentType = response.headers.get('content-type') || 'application/octet-stream';\n    logger.debug(`[URL FETCHER] Content type from server: ${contentType} for URL: ${url}`);\n\n    // Get content as ArrayBuffer\n    const arrayBuffer = await response.arrayBuffer();\n    const buffer = Buffer.from(arrayBuffer);\n\n    // Convert to base64\n    const base64Content = buffer.toString('base64');\n\n    logger.debug(\n      `[URL FETCHER] Successfully fetched content from URL: ${url} (${buffer.length} bytes)`\n    );\n    return {\n      content: base64Content,\n      contentType,\n    };\n  } catch (error: any) {\n    logger.error(`[URL FETCHER] Error fetching content from URL ${url}: ${error.message}`);\n    throw new Error(`Failed to fetch content from URL: ${error.message}`);\n  }\n}\n"],"mappings":"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","names":["logger","logger"]}
+{"version":3,"sources":["../src/docs-loader.ts","../src/utils.ts"],"sourcesContent":["import { logger, UUID, createUniqueUuid } from \"@elizaos/core\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { KnowledgeService } from \"./service.ts\";\nimport { AddKnowledgeOptions } from \"./types.ts\";\nimport { isBinaryContentType } from './utils.ts';\n\n/**\n * Get the knowledge path from environment or default to ./docs\n */\nexport function getKnowledgePath(): string {\n  const envPath = process.env.KNOWLEDGE_PATH;\n\n  if (envPath) {\n    // Resolve relative paths from current working directory\n    const resolvedPath = path.resolve(envPath);\n\n    if (!fs.existsSync(resolvedPath)) {\n      logger.warn(`Knowledge path from environment variable does not exist: ${resolvedPath}`);\n      logger.warn('Please create the directory or update KNOWLEDGE_PATH environment variable');\n    }\n\n    return resolvedPath;\n  }\n\n  // Default to docs folder in current working directory\n  const defaultPath = path.join(process.cwd(), 'docs');\n\n  if (!fs.existsSync(defaultPath)) {\n    logger.info(`Default docs folder does not exist at: ${defaultPath}`);\n    logger.info('To use the knowledge plugin, either:');\n    logger.info('1. Create a \"docs\" folder in your project root');\n    logger.info('2. Set KNOWLEDGE_PATH environment variable to your documents folder');\n  }\n\n  return defaultPath;\n}\n\n/**\n * Load documents from the knowledge path\n */\nexport async function loadDocsFromPath(\n  service: KnowledgeService,\n  agentId: UUID,\n  worldId?: UUID\n): Promise<{ total: number; successful: number; failed: number }> {\n  const docsPath = getKnowledgePath();\n\n  if (!fs.existsSync(docsPath)) {\n    logger.warn(`Knowledge path does not exist: ${docsPath}`);\n    return { total: 0, successful: 0, failed: 0 };\n  }\n\n  logger.info(`Loading documents from: ${docsPath}`);\n\n  // Get all files recursively\n  const files = getAllFiles(docsPath);\n\n  if (files.length === 0) {\n    logger.info('No files found in knowledge path');\n    return { total: 0, successful: 0, failed: 0 };\n  }\n\n  logger.info(`Found ${files.length} files to process`);\n\n  let successful = 0;\n  let failed = 0;\n\n  for (const filePath of files) {\n    try {\n      const fileName = path.basename(filePath);\n      const fileExt = path.extname(filePath).toLowerCase();\n\n      // Skip hidden files and directories\n      if (fileName.startsWith('.')) {\n        continue;\n      }\n\n      // Determine content type\n      const contentType = getContentType(fileExt);\n\n      // Skip unsupported file types\n      if (!contentType) {\n        logger.debug(`Skipping unsupported file type: ${filePath}`);\n        continue;\n      }\n\n      // Read file\n      const fileBuffer = fs.readFileSync(filePath);\n\n      // Check if file is binary using the same logic as the service\n      const isBinary = isBinaryContentType(contentType, fileName);\n\n      // For text files, read as UTF-8 string directly\n      // For binary files, convert to base64\n      const content = isBinary ? fileBuffer.toString('base64') : fileBuffer.toString('utf-8');\n\n      // Create knowledge options\n      const knowledgeOptions: AddKnowledgeOptions = {\n        clientDocumentId: createUniqueUuid(agentId, `docs-${fileName}-${Date.now()}`) as UUID,\n        contentType,\n        originalFilename: fileName,\n        worldId: worldId || agentId,\n        content,\n        roomId: agentId,\n        entityId: agentId,\n      };\n\n      // Process the document\n      logger.debug(`Processing document: ${fileName}`);\n      const result = await service.addKnowledge(knowledgeOptions);\n\n      logger.info(`Successfully processed ${fileName}: ${result.fragmentCount} fragments created`);\n      successful++;\n    } catch (error) {\n      logger.error(`Failed to process file ${filePath}:`, error);\n      failed++;\n    }\n  }\n\n  logger.info(\n    `Document loading complete: ${successful} successful, ${failed} failed out of ${files.length} total`\n  );\n\n  return {\n    total: files.length,\n    successful,\n    failed,\n  };\n}\n\n/**\n * Recursively get all files in a directory\n */\nfunction getAllFiles(dirPath: string, files: string[] = []): string[] {\n  try {\n    const entries = fs.readdirSync(dirPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = path.join(dirPath, entry.name);\n\n      if (entry.isDirectory()) {\n        // Skip node_modules and other common directories\n        if (!['node_modules', '.git', '.vscode', 'dist', 'build'].includes(entry.name)) {\n          getAllFiles(fullPath, files);\n        }\n      } else if (entry.isFile()) {\n        files.push(fullPath);\n      }\n    }\n  } catch (error) {\n    logger.error(`Error reading directory ${dirPath}:`, error);\n  }\n\n  return files;\n}\n\n/**\n * Get content type based on file extension\n */\nfunction getContentType(extension: string): string | null {\n  const contentTypes: Record<string, string> = {\n    // Text documents\n    '.txt': 'text/plain',\n    '.md': 'text/markdown',\n    '.markdown': 'text/markdown',\n    '.tson': 'text/plain',\n    '.xml': 'application/xml',\n    '.csv': 'text/csv',\n    '.tsv': 'text/tab-separated-values',\n    '.log': 'text/plain',\n\n    // Web files\n    '.html': 'text/html',\n    '.htm': 'text/html',\n    '.css': 'text/css',\n    '.scss': 'text/x-scss',\n    '.sass': 'text/x-sass',\n    '.less': 'text/x-less',\n\n    // JavaScript/TypeScript\n    '.js': 'text/javascript',\n    '.jsx': 'text/javascript',\n    '.ts': 'text/typescript',\n    '.tsx': 'text/typescript',\n    '.mjs': 'text/javascript',\n    '.cjs': 'text/javascript',\n    '.vue': 'text/x-vue',\n    '.svelte': 'text/x-svelte',\n    '.astro': 'text/x-astro',\n\n    // Python\n    '.py': 'text/x-python',\n    '.pyw': 'text/x-python',\n    '.pyi': 'text/x-python',\n\n    // Java/Kotlin/Scala\n    '.java': 'text/x-java',\n    '.kt': 'text/x-kotlin',\n    '.kts': 'text/x-kotlin',\n    '.scala': 'text/x-scala',\n\n    // C/C++/C#\n    '.c': 'text/x-c',\n    '.cpp': 'text/x-c++',\n    '.cc': 'text/x-c++',\n    '.cxx': 'text/x-c++',\n    '.h': 'text/x-c',\n    '.hpp': 'text/x-c++',\n    '.cs': 'text/x-csharp',\n\n    // Other languages\n    '.php': 'text/x-php',\n    '.rb': 'text/x-ruby',\n    '.go': 'text/x-go',\n    '.rs': 'text/x-rust',\n    '.swift': 'text/x-swift',\n    '.r': 'text/x-r',\n    '.R': 'text/x-r',\n    '.m': 'text/x-objectivec',\n    '.mm': 'text/x-objectivec',\n    '.clj': 'text/x-clojure',\n    '.cljs': 'text/x-clojure',\n    '.ex': 'text/x-elixir',\n    '.exs': 'text/x-elixir',\n    '.lua': 'text/x-lua',\n    '.pl': 'text/x-perl',\n    '.pm': 'text/x-perl',\n    '.dart': 'text/x-dart',\n    '.hs': 'text/x-haskell',\n    '.elm': 'text/x-elm',\n    '.ml': 'text/x-ocaml',\n    '.fs': 'text/x-fsharp',\n    '.fsx': 'text/x-fsharp',\n    '.vb': 'text/x-vb',\n    '.pas': 'text/x-pascal',\n    '.d': 'text/x-d',\n    '.nim': 'text/x-nim',\n    '.zig': 'text/x-zig',\n    '.jl': 'text/x-julia',\n    '.tcl': 'text/x-tcl',\n    '.awk': 'text/x-awk',\n    '.sed': 'text/x-sed',\n\n    // Shell scripts\n    '.sh': 'text/x-sh',\n    '.bash': 'text/x-sh',\n    '.zsh': 'text/x-sh',\n    '.fish': 'text/x-fish',\n    '.ps1': 'text/x-powershell',\n    '.bat': 'text/x-batch',\n    '.cmd': 'text/x-batch',\n\n    // Config files\n    '.json': 'application/json',\n    '.yaml': 'text/x-yaml',\n    '.yml': 'text/x-yaml',\n    '.toml': 'text/x-toml',\n    '.ini': 'text/x-ini',\n    '.cfg': 'text/x-ini',\n    '.conf': 'text/x-ini',\n    '.env': 'text/plain',\n    '.gitignore': 'text/plain',\n    '.dockerignore': 'text/plain',\n    '.editorconfig': 'text/plain',\n    '.properties': 'text/x-properties',\n\n    // Database\n    '.sql': 'text/x-sql',\n\n    // Binary documents\n    '.pdf': 'application/pdf',\n    '.doc': 'application/msword',\n    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  };\n\n  return contentTypes[extension] || null;\n}\n","import { Buffer } from 'node:buffer';\nimport * as mammoth from 'mammoth';\nimport { logger } from '@elizaos/core';\nimport { getDocument, PDFDocumentProxy } from 'pdfjs-dist/legacy/build/pdf.mjs';\nimport type { TextItem, TextMarkedContent } from 'pdfjs-dist/types/src/display/api';\n\nconst PLAIN_TEXT_CONTENT_TYPES = [\n  'application/typescript',\n  'text/typescript',\n  'text/x-python',\n  'application/x-python-code',\n  'application/yaml',\n  'text/yaml',\n  'application/x-yaml',\n  'application/json',\n  'text/markdown',\n  'text/csv',\n];\n\nconst MAX_FALLBACK_SIZE_BYTES = 5 * 1024 * 1024; // 5 MB\nconst BINARY_CHECK_BYTES = 1024; // Check first 1KB for binary indicators\n\n/**\n * Extracts text content from a file buffer based on its content type.\n * Supports DOCX, plain text, and provides a fallback for unknown types.\n * PDF should be handled by `convertPdfToTextFromBuffer`.\n */\nexport async function extractTextFromFileBuffer(\n  fileBuffer: Buffer,\n  contentType: string,\n  originalFilename: string // For logging and context\n): Promise<string> {\n  const lowerContentType = contentType.toLowerCase();\n  logger.debug(\n    `[TextUtil] Attempting to extract text from ${originalFilename} (type: ${contentType})`\n  );\n\n  if (\n    lowerContentType === 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'\n  ) {\n    logger.debug(`[TextUtil] Extracting text from DOCX ${originalFilename} via mammoth.`);\n    try {\n      const result = await mammoth.extractRawText({ buffer: fileBuffer });\n      logger.debug(\n        `[TextUtil] DOCX text extraction complete for ${originalFilename}. Text length: ${result.value.length}`\n      );\n      return result.value;\n    } catch (docxError: any) {\n      const errorMsg = `[TextUtil] Failed to parse DOCX file ${originalFilename}: ${docxError.message}`;\n      logger.error(errorMsg, docxError.stack);\n      throw new Error(errorMsg);\n    }\n  } else if (\n    lowerContentType === 'application/msword' ||\n    originalFilename.toLowerCase().endsWith('.doc')\n  ) {\n    // For .doc files, we'll store the content as-is, and just add a message\n    // The frontend will handle the display appropriately\n    logger.debug(`[TextUtil] Handling Microsoft Word .doc file: ${originalFilename}`);\n\n    // We'll add a descriptive message as a placeholder\n    return `[Microsoft Word Document: ${originalFilename}]\\n\\nThis document was indexed for search but cannot be displayed directly in the browser. The original document content is preserved for retrieval purposes.`;\n  } else if (\n    lowerContentType.startsWith('text/') ||\n    PLAIN_TEXT_CONTENT_TYPES.includes(lowerContentType)\n  ) {\n    logger.debug(\n      `[TextUtil] Extracting text from plain text compatible file ${originalFilename} (type: ${contentType})`\n    );\n    return fileBuffer.toString('utf-8');\n  } else {\n    logger.warn(\n      `[TextUtil] Unsupported content type: \"${contentType}\" for ${originalFilename}. Attempting fallback to plain text.`\n    );\n\n    if (fileBuffer.length > MAX_FALLBACK_SIZE_BYTES) {\n      const sizeErrorMsg = `[TextUtil] File ${originalFilename} (type: ${contentType}) exceeds maximum size for fallback (${MAX_FALLBACK_SIZE_BYTES} bytes). Cannot process as plain text.`;\n      logger.error(sizeErrorMsg);\n      throw new Error(sizeErrorMsg);\n    }\n\n    // Simple binary detection: check for null bytes in the first N bytes\n    const initialBytes = fileBuffer.subarray(0, Math.min(fileBuffer.length, BINARY_CHECK_BYTES));\n    if (initialBytes.includes(0)) {\n      // Check for NUL byte\n      const binaryHeuristicMsg = `[TextUtil] File ${originalFilename} (type: ${contentType}) appears to be binary based on initial byte check. Cannot process as plain text.`;\n      logger.error(binaryHeuristicMsg);\n      throw new Error(binaryHeuristicMsg);\n    }\n\n    try {\n      const textContent = fileBuffer.toString('utf-8');\n      if (textContent.includes('\\ufffd')) {\n        // Replacement character, indicating potential binary or wrong encoding\n        const binaryErrorMsg = `[TextUtil] File ${originalFilename} (type: ${contentType}) seems to be binary or has encoding issues after fallback to plain text (detected \\ufffd).`;\n        logger.error(binaryErrorMsg);\n        throw new Error(binaryErrorMsg); // Throw error for likely binary content\n      }\n      logger.debug(\n        `[TextUtil] Successfully processed unknown type ${contentType} as plain text after fallback for ${originalFilename}.`\n      );\n      return textContent;\n    } catch (fallbackError: any) {\n      // If the initial toString failed or if we threw due to \\ufffd\n      const finalErrorMsg = `[TextUtil] Unsupported content type: ${contentType} for ${originalFilename}. Fallback to plain text also failed or indicated binary content.`;\n      logger.error(finalErrorMsg, fallbackError.message ? fallbackError.stack : undefined);\n      throw new Error(finalErrorMsg);\n    }\n  }\n}\n\n/**\n * Converts a PDF file buffer to text content.\n * Requires pdfjs-dist to be properly configured, especially its worker.\n */\n/**\n * Converts a PDF Buffer to text with enhanced formatting preservation.\n *\n * @param {Buffer} pdfBuffer - The PDF Buffer to convert to text\n * @param {string} [filename] - Optional filename for logging purposes\n * @returns {Promise<string>} Text content of the PDF\n */\nexport async function convertPdfToTextFromBuffer(\n  pdfBuffer: Buffer,\n  filename?: string\n): Promise<string> {\n  const docName = filename || 'unnamed-document';\n  logger.debug(`[PdfService] Starting conversion for ${docName}`);\n\n  try {\n    const uint8Array = new Uint8Array(pdfBuffer);\n    const pdf: PDFDocumentProxy = await getDocument({ data: uint8Array }).promise;\n    const numPages = pdf.numPages;\n    const textPages: string[] = [];\n\n    for (let pageNum = 1; pageNum <= numPages; pageNum++) {\n      logger.debug(`[PdfService] Processing page ${pageNum}/${numPages}`);\n      const page = await pdf.getPage(pageNum);\n      const textContent = await page.getTextContent();\n\n      // Group text items by their y-position to maintain line structure\n      const lineMap = new Map<number, TextItem[]>();\n\n      textContent.items.filter(isTextItem).forEach((item) => {\n        // Round y-position to account for small variations in the same line\n        const yPos = Math.round(item.transform[5]);\n        if (!lineMap.has(yPos)) {\n          lineMap.set(yPos, []);\n        }\n        lineMap.get(yPos)!.push(item);\n      });\n\n      // Sort lines by y-position (top to bottom) and items within lines by x-position (left to right)\n      const sortedLines = Array.from(lineMap.entries())\n        .sort((a, b) => b[0] - a[0]) // Reverse sort for top-to-bottom\n        .map(([_, items]) =>\n          items\n            .sort((a, b) => a.transform[4] - b.transform[4])\n            .map((item) => item.str)\n            .join(' ')\n        );\n\n      textPages.push(sortedLines.join('\\n'));\n    }\n\n    const fullText = textPages.join('\\n\\n').replace(/\\s+/g, ' ').trim();\n    logger.debug(`[PdfService] Conversion complete for ${docName}, length: ${fullText.length}`);\n    return fullText;\n  } catch (error: any) {\n    logger.error(`[PdfService] Error converting PDF ${docName}:`, error.message);\n    throw new Error(`Failed to convert PDF to text: ${error.message}`);\n  }\n}\n\n/**\n * Determines if a file should be treated as binary based on its content type and filename\n * @param contentType MIME type of the file\n * @param filename Original filename\n * @returns True if the file should be treated as binary (base64 encoded)\n */\nexport function isBinaryContentType(contentType: string, filename: string): boolean {\n  // Text-based content types that should NOT be treated as binary\n  const textContentTypes = [\n    'text/',\n    'application/json',\n    'application/xml',\n    'application/javascript',\n    'application/typescript',\n    'application/x-yaml',\n    'application/x-sh',\n  ];\n\n  // Check if it's a text-based MIME type\n  const isTextMimeType = textContentTypes.some((type) => contentType.includes(type));\n  if (isTextMimeType) {\n    return false;\n  }\n\n  // Binary content types\n  const binaryContentTypes = [\n    'application/pdf',\n    'application/msword',\n    'application/vnd.openxmlformats-officedocument',\n    'application/vnd.ms-excel',\n    'application/vnd.ms-powerpoint',\n    'application/zip',\n    'application/x-zip-compressed',\n    'application/octet-stream',\n    'image/',\n    'audio/',\n    'video/',\n  ];\n\n  // Check MIME type\n  const isBinaryMimeType = binaryContentTypes.some((type) => contentType.includes(type));\n\n  if (isBinaryMimeType) {\n    return true;\n  }\n\n  // Check file extension as fallback\n  const fileExt = filename.split('.').pop()?.toLowerCase() || '';\n\n  // Text file extensions that should NOT be treated as binary\n  const textExtensions = [\n    'txt',\n    'md',\n    'markdown',\n    'json',\n    'xml',\n    'html',\n    'htm',\n    'css',\n    'js',\n    'ts',\n    'jsx',\n    'tsx',\n    'yaml',\n    'yml',\n    'toml',\n    'ini',\n    'cfg',\n    'conf',\n    'sh',\n    'bash',\n    'zsh',\n    'fish',\n    'py',\n    'rb',\n    'go',\n    'rs',\n    'java',\n    'c',\n    'cpp',\n    'h',\n    'hpp',\n    'cs',\n    'php',\n    'sql',\n    'r',\n    'swift',\n    'kt',\n    'scala',\n    'clj',\n    'ex',\n    'exs',\n    'vim',\n    'env',\n    'gitignore',\n    'dockerignore',\n    'editorconfig',\n    'log',\n    'csv',\n    'tsv',\n    'properties',\n    'gradle',\n    'sbt',\n    'makefile',\n    'dockerfile',\n    'vagrantfile',\n    'gemfile',\n    'rakefile',\n    'podfile',\n    'csproj',\n    'vbproj',\n    'fsproj',\n    'sln',\n    'pom',\n  ];\n\n  // If it's a known text extension, it's not binary\n  if (textExtensions.includes(fileExt)) {\n    return false;\n  }\n\n  // Binary file extensions\n  const binaryExtensions = [\n    'pdf',\n    'docx',\n    'doc',\n    'xls',\n    'xlsx',\n    'ppt',\n    'pptx',\n    'zip',\n    'rar',\n    '7z',\n    'tar',\n    'gz',\n    'bz2',\n    'xz',\n    'jpg',\n    'jpeg',\n    'png',\n    'gif',\n    'bmp',\n    'svg',\n    'ico',\n    'webp',\n    'mp3',\n    'mp4',\n    'avi',\n    'mov',\n    'wmv',\n    'flv',\n    'wav',\n    'flac',\n    'ogg',\n    'exe',\n    'dll',\n    'so',\n    'dylib',\n    'bin',\n    'dat',\n    'db',\n    'sqlite',\n  ];\n\n  return binaryExtensions.includes(fileExt);\n}\n\n/**\n * Check if the input is a TextItem.\n *\n * @param item - The input item to check.\n * @returns A boolean indicating if the input is a TextItem.\n */\nfunction isTextItem(item: TextItem | TextMarkedContent): item is TextItem {\n  return 'str' in item;\n}\n\n/**\n * Normalizes an S3 URL by removing query parameters (signature, etc.)\n * This allows for consistent URL comparison regardless of presigned URL parameters\n * @param url The S3 URL to normalize\n * @returns The normalized URL containing only the origin and pathname\n */\nexport function normalizeS3Url(url: string): string {\n  try {\n    const urlObj = new URL(url);\n    return `${urlObj.origin}${urlObj.pathname}`;\n  } catch (error) {\n    logger.warn(`[URL NORMALIZER] Failed to parse URL: ${url}. Returning original.`);\n    return url;\n  }\n}\n\n/**\n * Fetches content from a URL and converts it to base64 format\n * @param url The URL to fetch content from\n * @returns An object containing the base64 content and content type\n */\nexport async function fetchUrlContent(\n  url: string\n): Promise<{ content: string; contentType: string }> {\n  logger.debug(`[URL FETCHER] Fetching content from URL: ${url}`);\n\n  try {\n    // Fetch the URL with timeout\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), 30000); // 30 second timeout\n\n    const response = await fetch(url, {\n      signal: controller.signal,\n      headers: {\n        'User-Agent': 'Eliza-Knowledge-Plugin/1.0',\n      },\n    });\n    clearTimeout(timeoutId);\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch URL: ${response.status} ${response.statusText}`);\n    }\n\n    // Get content type from response headers\n    const contentType = response.headers.get('content-type') || 'application/octet-stream';\n    logger.debug(`[URL FETCHER] Content type from server: ${contentType} for URL: ${url}`);\n\n    // Get content as ArrayBuffer\n    const arrayBuffer = await response.arrayBuffer();\n    const buffer = Buffer.from(arrayBuffer);\n\n    // Convert to base64\n    const base64Content = buffer.toString('base64');\n\n    logger.debug(\n      `[URL FETCHER] Successfully fetched content from URL: ${url} (${buffer.length} bytes)`\n    );\n    return {\n      content: base64Content,\n      contentType,\n    };\n  } catch (error: any) {\n    logger.error(`[URL FETCHER] Error fetching content from URL ${url}: ${error.message}`);\n    throw new Error(`Failed to fetch content from URL: ${error.message}`);\n  }\n}\n\nexport function looksLikeBase64(content?: string | null): boolean {\n  // const base64Regex = /^[A-Za-z0-9+/]+=*$/; // This is the old regex\n  // https://stackoverflow.com/questions/475074/regex-to-parse-or-validate-base64-data\n  const base64Regex = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;\n  return content && content.length > 0 && base64Regex.test(content.replace(/\\s/g, '')) || false;\n}"],"mappings":";AAAA,SAAS,UAAAA,SAAc,wBAAwB;AAC/C,YAAY,QAAQ;AACpB,YAAY,UAAU;;;ACFtB,SAAS,cAAc;AACvB,YAAY,aAAa;AACzB,SAAS,cAAc;AACvB,SAAS,mBAAqC;AAG9C,IAAM,2BAA2B;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,0BAA0B,IAAI,OAAO;AAC3C,IAAM,qBAAqB;AAO3B,eAAsB,0BACpB,YACA,aACA,kBACiB;AACjB,QAAM,mBAAmB,YAAY,YAAY;AACjD,SAAO;AAAA,IACL,8CAA8C,gBAAgB,WAAW,WAAW;AAAA,EACtF;AAEA,MACE,qBAAqB,2EACrB;AACA,WAAO,MAAM,wCAAwC,gBAAgB,eAAe;AACpF,QAAI;AACF,YAAM,SAAS,MAAc,uBAAe,EAAE,QAAQ,WAAW,CAAC;AAClE,aAAO;AAAA,QACL,gDAAgD,gBAAgB,kBAAkB,OAAO,MAAM,MAAM;AAAA,MACvG;AACA,aAAO,OAAO;AAAA,IAChB,SAAS,WAAgB;AACvB,YAAM,WAAW,wCAAwC,gBAAgB,KAAK,UAAU,OAAO;AAC/F,aAAO,MAAM,UAAU,UAAU,KAAK;AACtC,YAAM,IAAI,MAAM,QAAQ;AAAA,IAC1B;AAAA,EACF,WACE,qBAAqB,wBACrB,iBAAiB,YAAY,EAAE,SAAS,MAAM,GAC9C;AAGA,WAAO,MAAM,iDAAiD,gBAAgB,EAAE;AAGhF,WAAO,6BAA6B,gBAAgB;AAAA;AAAA;AAAA,EACtD,WACE,iBAAiB,WAAW,OAAO,KACnC,yBAAyB,SAAS,gBAAgB,GAClD;AACA,WAAO;AAAA,MACL,8DAA8D,gBAAgB,WAAW,WAAW;AAAA,IACtG;AACA,WAAO,WAAW,SAAS,OAAO;AAAA,EACpC,OAAO;AACL,WAAO;AAAA,MACL,yCAAyC,WAAW,SAAS,gBAAgB;AAAA,IAC/E;AAEA,QAAI,WAAW,SAAS,yBAAyB;AAC/C,YAAM,eAAe,mBAAmB,gBAAgB,WAAW,WAAW,wCAAwC,uBAAuB;AAC7I,aAAO,MAAM,YAAY;AACzB,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAGA,UAAM,eAAe,WAAW,SAAS,GAAG,KAAK,IAAI,WAAW,QAAQ,kBAAkB,CAAC;AAC3F,QAAI,aAAa,SAAS,CAAC,GAAG;AAE5B,YAAM,qBAAqB,mBAAmB,gBAAgB,WAAW,WAAW;AACpF,aAAO,MAAM,kBAAkB;AAC/B,YAAM,IAAI,MAAM,kBAAkB;AAAA,IACpC;AAEA,QAAI;AACF,YAAM,cAAc,WAAW,SAAS,OAAO;AAC/C,UAAI,YAAY,SAAS,QAAQ,GAAG;AAElC,cAAM,iBAAiB,mBAAmB,gBAAgB,WAAW,WAAW;AAChF,eAAO,MAAM,cAAc;AAC3B,cAAM,IAAI,MAAM,cAAc;AAAA,MAChC;AACA,aAAO;AAAA,QACL,kDAAkD,WAAW,qCAAqC,gBAAgB;AAAA,MACpH;AACA,aAAO;AAAA,IACT,SAAS,eAAoB;AAE3B,YAAM,gBAAgB,wCAAwC,WAAW,QAAQ,gBAAgB;AACjG,aAAO,MAAM,eAAe,cAAc,UAAU,cAAc,QAAQ,MAAS;AACnF,YAAM,IAAI,MAAM,aAAa;AAAA,IAC/B;AAAA,EACF;AACF;AAaA,eAAsB,2BACpB,WACA,UACiB;AACjB,QAAM,UAAU,YAAY;AAC5B,SAAO,MAAM,wCAAwC,OAAO,EAAE;AAE9D,MAAI;AACF,UAAM,aAAa,IAAI,WAAW,SAAS;AAC3C,UAAM,MAAwB,MAAM,YAAY,EAAE,MAAM,WAAW,CAAC,EAAE;AACtE,UAAM,WAAW,IAAI;AACrB,UAAM,YAAsB,CAAC;AAE7B,aAAS,UAAU,GAAG,WAAW,UAAU,WAAW;AACpD,aAAO,MAAM,gCAAgC,OAAO,IAAI,QAAQ,EAAE;AAClE,YAAM,OAAO,MAAM,IAAI,QAAQ,OAAO;AACtC,YAAM,cAAc,MAAM,KAAK,eAAe;AAG9C,YAAM,UAAU,oBAAI,IAAwB;AAE5C,kBAAY,MAAM,OAAO,UAAU,EAAE,QAAQ,CAAC,SAAS;AAErD,cAAM,OAAO,KAAK,MAAM,KAAK,UAAU,CAAC,CAAC;AACzC,YAAI,CAAC,QAAQ,IAAI,IAAI,GAAG;AACtB,kBAAQ,IAAI,MAAM,CAAC,CAAC;AAAA,QACtB;AACA,gBAAQ,IAAI,IAAI,EAAG,KAAK,IAAI;AAAA,MAC9B,CAAC;AAGD,YAAM,cAAc,MAAM,KAAK,QAAQ,QAAQ,CAAC,EAC7C,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAC1B;AAAA,QAAI,CAAC,CAAC,GAAG,KAAK,MACb,MACG,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAC9C,IAAI,CAAC,SAAS,KAAK,GAAG,EACtB,KAAK,GAAG;AAAA,MACb;AAEF,gBAAU,KAAK,YAAY,KAAK,IAAI,CAAC;AAAA,IACvC;AAEA,UAAM,WAAW,UAAU,KAAK,MAAM,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AAClE,WAAO,MAAM,wCAAwC,OAAO,aAAa,SAAS,MAAM,EAAE;AAC1F,WAAO;AAAA,EACT,SAAS,OAAY;AACnB,WAAO,MAAM,qCAAqC,OAAO,KAAK,MAAM,OAAO;AAC3E,UAAM,IAAI,MAAM,kCAAkC,MAAM,OAAO,EAAE;AAAA,EACnE;AACF;AAQO,SAAS,oBAAoB,aAAqB,UAA2B;AAElF,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,QAAM,iBAAiB,iBAAiB,KAAK,CAAC,SAAS,YAAY,SAAS,IAAI,CAAC;AACjF,MAAI,gBAAgB;AAClB,WAAO;AAAA,EACT;AAGA,QAAM,qBAAqB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,QAAM,mBAAmB,mBAAmB,KAAK,CAAC,SAAS,YAAY,SAAS,IAAI,CAAC;AAErF,MAAI,kBAAkB;AACpB,WAAO;AAAA,EACT;AAGA,QAAM,UAAU,SAAS,MAAM,GAAG,EAAE,IAAI,GAAG,YAAY,KAAK;AAG5D,QAAM,iBAAiB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,MAAI,eAAe,SAAS,OAAO,GAAG;AACpC,WAAO;AAAA,EACT;AAGA,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,SAAO,iBAAiB,SAAS,OAAO;AAC1C;AAQA,SAAS,WAAW,MAAsD;AACxE,SAAO,SAAS;AAClB;AAQO,SAAS,eAAe,KAAqB;AAClD,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,WAAO,GAAG,OAAO,MAAM,GAAG,OAAO,QAAQ;AAAA,EAC3C,SAAS,OAAO;AACd,WAAO,KAAK,yCAAyC,GAAG,uBAAuB;AAC/E,WAAO;AAAA,EACT;AACF;AAOA,eAAsB,gBACpB,KACmD;AACnD,SAAO,MAAM,4CAA4C,GAAG,EAAE;AAE9D,MAAI;AAEF,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,GAAK;AAE5D,UAAM,WAAW,MAAM,MAAM,KAAK;AAAA,MAChC,QAAQ,WAAW;AAAA,MACnB,SAAS;AAAA,QACP,cAAc;AAAA,MAChB;AAAA,IACF,CAAC;AACD,iBAAa,SAAS;AAEtB,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,wBAAwB,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,IAClF;AAGA,UAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAC5D,WAAO,MAAM,2CAA2C,WAAW,aAAa,GAAG,EAAE;AAGrF,UAAM,cAAc,MAAM,SAAS,YAAY;AAC/C,UAAM,SAAS,OAAO,KAAK,WAAW;AAGtC,UAAM,gBAAgB,OAAO,SAAS,QAAQ;AAE9C,WAAO;AAAA,MACL,wDAAwD,GAAG,KAAK,OAAO,MAAM;AAAA,IAC/E;AACA,WAAO;AAAA,MACL,SAAS;AAAA,MACT;AAAA,IACF;AAAA,EACF,SAAS,OAAY;AACnB,WAAO,MAAM,iDAAiD,GAAG,KAAK,MAAM,OAAO,EAAE;AACrF,UAAM,IAAI,MAAM,qCAAqC,MAAM,OAAO,EAAE;AAAA,EACtE;AACF;AAEO,SAAS,gBAAgB,SAAkC;AAGhE,QAAM,cAAc;AACpB,SAAO,WAAW,QAAQ,SAAS,KAAK,YAAY,KAAK,QAAQ,QAAQ,OAAO,EAAE,CAAC,KAAK;AAC1F;;;AD7ZO,SAAS,mBAA2B;AACzC,QAAM,UAAU,QAAQ,IAAI;AAE5B,MAAI,SAAS;AAEX,UAAM,eAAoB,aAAQ,OAAO;AAEzC,QAAI,CAAI,cAAW,YAAY,GAAG;AAChC,MAAAC,QAAO,KAAK,4DAA4D,YAAY,EAAE;AACtF,MAAAA,QAAO,KAAK,2EAA2E;AAAA,IACzF;AAEA,WAAO;AAAA,EACT;AAGA,QAAM,cAAmB,UAAK,QAAQ,IAAI,GAAG,MAAM;AAEnD,MAAI,CAAI,cAAW,WAAW,GAAG;AAC/B,IAAAA,QAAO,KAAK,0CAA0C,WAAW,EAAE;AACnE,IAAAA,QAAO,KAAK,sCAAsC;AAClD,IAAAA,QAAO,KAAK,gDAAgD;AAC5D,IAAAA,QAAO,KAAK,qEAAqE;AAAA,EACnF;AAEA,SAAO;AACT;AAKA,eAAsB,iBACpB,SACA,SACA,SACgE;AAChE,QAAM,WAAW,iBAAiB;AAElC,MAAI,CAAI,cAAW,QAAQ,GAAG;AAC5B,IAAAA,QAAO,KAAK,kCAAkC,QAAQ,EAAE;AACxD,WAAO,EAAE,OAAO,GAAG,YAAY,GAAG,QAAQ,EAAE;AAAA,EAC9C;AAEA,EAAAA,QAAO,KAAK,2BAA2B,QAAQ,EAAE;AAGjD,QAAM,QAAQ,YAAY,QAAQ;AAElC,MAAI,MAAM,WAAW,GAAG;AACtB,IAAAA,QAAO,KAAK,kCAAkC;AAC9C,WAAO,EAAE,OAAO,GAAG,YAAY,GAAG,QAAQ,EAAE;AAAA,EAC9C;AAEA,EAAAA,QAAO,KAAK,SAAS,MAAM,MAAM,mBAAmB;AAEpD,MAAI,aAAa;AACjB,MAAI,SAAS;AAEb,aAAW,YAAY,OAAO;AAC5B,QAAI;AACF,YAAM,WAAgB,cAAS,QAAQ;AACvC,YAAM,UAAe,aAAQ,QAAQ,EAAE,YAAY;AAGnD,UAAI,SAAS,WAAW,GAAG,GAAG;AAC5B;AAAA,MACF;AAGA,YAAM,cAAc,eAAe,OAAO;AAG1C,UAAI,CAAC,aAAa;AAChB,QAAAA,QAAO,MAAM,mCAAmC,QAAQ,EAAE;AAC1D;AAAA,MACF;AAGA,YAAM,aAAgB,gBAAa,QAAQ;AAG3C,YAAM,WAAW,oBAAoB,aAAa,QAAQ;AAI1D,YAAM,UAAU,WAAW,WAAW,SAAS,QAAQ,IAAI,WAAW,SAAS,OAAO;AAGtF,YAAM,mBAAwC;AAAA,QAC5C,kBAAkB,iBAAiB,SAAS,QAAQ,QAAQ,IAAI,KAAK,IAAI,CAAC,EAAE;AAAA,QAC5E;AAAA,QACA,kBAAkB;AAAA,QAClB,SAAS,WAAW;AAAA,QACpB;AAAA,QACA,QAAQ;AAAA,QACR,UAAU;AAAA,MACZ;AAGA,MAAAA,QAAO,MAAM,wBAAwB,QAAQ,EAAE;AAC/C,YAAM,SAAS,MAAM,QAAQ,aAAa,gBAAgB;AAE1D,MAAAA,QAAO,KAAK,0BAA0B,QAAQ,KAAK,OAAO,aAAa,oBAAoB;AAC3F;AAAA,IACF,SAAS,OAAO;AACd,MAAAA,QAAO,MAAM,0BAA0B,QAAQ,KAAK,KAAK;AACzD;AAAA,IACF;AAAA,EACF;AAEA,EAAAA,QAAO;AAAA,IACL,8BAA8B,UAAU,gBAAgB,MAAM,kBAAkB,MAAM,MAAM;AAAA,EAC9F;AAEA,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb;AAAA,IACA;AAAA,EACF;AACF;AAKA,SAAS,YAAY,SAAiB,QAAkB,CAAC,GAAa;AACpE,MAAI;AACF,UAAM,UAAa,eAAY,SAAS,EAAE,eAAe,KAAK,CAAC;AAE/D,eAAW,SAAS,SAAS;AAC3B,YAAM,WAAgB,UAAK,SAAS,MAAM,IAAI;AAE9C,UAAI,MAAM,YAAY,GAAG;AAEvB,YAAI,CAAC,CAAC,gBAAgB,QAAQ,WAAW,QAAQ,OAAO,EAAE,SAAS,MAAM,IAAI,GAAG;AAC9E,sBAAY,UAAU,KAAK;AAAA,QAC7B;AAAA,MACF,WAAW,MAAM,OAAO,GAAG;AACzB,cAAM,KAAK,QAAQ;AAAA,MACrB;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,IAAAA,QAAO,MAAM,2BAA2B,OAAO,KAAK,KAAK;AAAA,EAC3D;AAEA,SAAO;AACT;AAKA,SAAS,eAAe,WAAkC;AACxD,QAAM,eAAuC;AAAA;AAAA,IAE3C,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,aAAa;AAAA,IACb,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA;AAAA,IAGR,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AAAA;AAAA,IAGT,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,UAAU;AAAA;AAAA,IAGV,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,QAAQ;AAAA;AAAA,IAGR,SAAS;AAAA,IACT,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA;AAAA,IAGV,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,OAAO;AAAA;AAAA,IAGP,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,OAAO;AAAA,IACP,OAAO;AAAA,IACP,UAAU;AAAA,IACV,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,OAAO;AAAA,IACP,SAAS;AAAA,IACT,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA;AAAA,IAGR,OAAO;AAAA,IACP,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA;AAAA,IAGR,SAAS;AAAA,IACT,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,eAAe;AAAA;AAAA,IAGf,QAAQ;AAAA;AAAA,IAGR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,SAAS;AAAA,EACX;AAEA,SAAO,aAAa,SAAS,KAAK;AACpC;","names":["logger","logger"]}

package/dist/{docs-loader-AEQHIBO4.js → docs-loader-IBTEOAYT.js}

@@ -1,9 +1,9 @@
 import {
   getKnowledgePath,
   loadDocsFromPath
-} from "./chunk-MFXNKYBS.js";
+} from "./chunk-536BD2UA.js";
 export {
   getKnowledgePath,
   loadDocsFromPath
 };
-//# sourceMappingURL=docs-loader-AEQHIBO4.js.map
+//# sourceMappingURL=docs-loader-IBTEOAYT.js.map

package/dist/index.d.ts

@@ -98,6 +98,8 @@ interface TextGenerationOptions {
  * Options for adding knowledge to the system
  */
 interface AddKnowledgeOptions {
+    /** Agent ID from the frontend - if not provided, will use runtime.agentId */
+    agentId?: UUID;
     worldId: UUID;
     roomId: UUID;
     entityId: UUID;

package/dist/index.html

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Agent Plugin View</title>
-    <script type="module" crossorigin src="./assets/index-DZQIX0Kb.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-C77XebWS.css">
+    <script type="module" crossorigin src="./assets/index-DlJcnv-R.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-DiVvUMt0.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/index.js

@@ -4,8 +4,9 @@ import {
   fetchUrlContent,
   isBinaryContentType,
   loadDocsFromPath,
+  looksLikeBase64,
   normalizeS3Url
-} from "./chunk-MFXNKYBS.js";
+} from "./chunk-536BD2UA.js";
 
 // src/index.ts
 import { logger as logger6 } from "@elizaos/core";
@@ -1264,9 +1265,9 @@ var KnowledgeService = class _KnowledgeService extends Service {
    * @returns Promise with document processing result
    */
   async addKnowledge(options) {
-    const agentId = this.runtime.agentId;
+    const agentId = options.agentId || this.runtime.agentId;
     logger3.info(
-      `KnowledgeService (agent: ${agentId}) processing document for public addKnowledge: ${options.originalFilename}, type: ${options.contentType}`
+      `KnowledgeService processing document for agent: ${agentId}, file: ${options.originalFilename}, type: ${options.contentType}`
     );
     try {
       const existingDocument = await this.runtime.getMemoryById(options.clientDocumentId);
@@ -1302,6 +1303,7 @@ var KnowledgeService = class _KnowledgeService extends Service {
    * @returns Promise with document processing result
    */
   async processDocument({
+    agentId: passedAgentId,
     clientDocumentId,
     contentType,
     originalFilename,
@@ -1311,10 +1313,10 @@ var KnowledgeService = class _KnowledgeService extends Service {
     entityId,
     metadata
   }) {
-    const agentId = this.runtime.agentId;
+    const agentId = passedAgentId || this.runtime.agentId;
     try {
       logger3.debug(
-        `KnowledgeService: Processing document ${originalFilename} (type: ${contentType}) via processDocument`
+        `KnowledgeService: Processing document ${originalFilename} (type: ${contentType}) via processDocument for agent: ${agentId}`
       );
       let fileBuffer = null;
       let extractedText;
@@ -1343,9 +1345,7 @@ var KnowledgeService = class _KnowledgeService extends Service {
         extractedText = await extractTextFromDocument(fileBuffer, contentType, originalFilename);
         documentContentToStore = extractedText;
       } else {
-        const base64Regex = /^[A-Za-z0-9+/]+=*$/;
-        const looksLikeBase64 = content && content.length > 0 && base64Regex.test(content.replace(/\s/g, ""));
-        if (looksLikeBase64) {
+        if (looksLikeBase64(content)) {
           try {
             const decodedBuffer = Buffer.from(content, "base64");
             const decodedText = decodedBuffer.toString("utf8");
@@ -1678,8 +1678,9 @@ var KnowledgeService = class _KnowledgeService extends Service {
    */
   async getMemories(params) {
     return this.runtime.getMemories({
-      ...params
+      ...params,
       // includes tableName, roomId, count, end
+      agentId: this.runtime.agentId
     });
   }
   /**
@@ -2633,7 +2634,7 @@ var KnowledgeTestSuite = class {
 var tests_default = new KnowledgeTestSuite();
 
 // src/actions.ts
-import { logger as logger4, createUniqueUuid as createUniqueUuid2 } from "@elizaos/core";
+import { logger as logger4, stringToUuid } from "@elizaos/core";
 import * as fs2 from "fs";
 import * as path2 from "path";
 var processKnowledgeAction = {
@@ -2734,7 +2735,7 @@ var processKnowledgeAction = {
         else if ([".txt", ".md", ".tson", ".xml", ".csv"].includes(fileExt))
           contentType = "text/plain";
         const knowledgeOptions = {
-          clientDocumentId: createUniqueUuid2(runtime.agentId + fileName + Date.now(), fileName),
+          clientDocumentId: stringToUuid(runtime.agentId + fileName + Date.now()),
           contentType,
           originalFilename: fileName,
           worldId: runtime.agentId,
@@ -2761,7 +2762,7 @@ var processKnowledgeAction = {
           return;
         }
         const knowledgeOptions = {
-          clientDocumentId: createUniqueUuid2(runtime.agentId + "text" + Date.now(), "user-knowledge"),
+          clientDocumentId: stringToUuid(runtime.agentId + "text" + Date.now() + "user-knowledge"),
           contentType: "text/plain",
           originalFilename: "user-knowledge.txt",
           worldId: runtime.agentId,
@@ -2902,7 +2903,7 @@ ${formattedResults}`
 var knowledgeActions = [processKnowledgeAction, searchKnowledgeAction];
 
 // src/routes.ts
-import { MemoryType as MemoryType4, createUniqueUuid as createUniqueUuid3, logger as logger5 } from "@elizaos/core";
+import { createUniqueUuid as createUniqueUuid2, logger as logger5, ModelType as ModelType4 } from "@elizaos/core";
 import fs3 from "fs";
 import path3 from "path";
 import multer from "multer";
@@ -2978,37 +2979,32 @@ async function uploadKnowledgeHandler(req, res, runtime) {
       if (!files || files.length === 0) {
         return sendError(res, 400, "NO_FILES", "No files uploaded");
       }
+      const agentId = req.body.agentId || req.query.agentId;
+      if (!agentId) {
+        logger5.error("[KNOWLEDGE UPLOAD HANDLER] No agent ID provided in request");
+        return sendError(
+          res,
+          400,
+          "MISSING_AGENT_ID",
+          "Agent ID is required for uploading knowledge"
+        );
+      }
+      const worldId = req.body.worldId || agentId;
+      logger5.info(`[KNOWLEDGE UPLOAD HANDLER] Processing upload for agent: ${agentId}`);
       const processingPromises = files.map(async (file, index) => {
         let knowledgeId;
         const originalFilename = file.originalname;
-        const agentId = req.body.agentId || req.query.agentId || runtime.agentId;
-        const worldId = req.body.worldId || agentId;
         const filePath = file.path;
-        knowledgeId = req.body?.documentIds && req.body.documentIds[index] || req.body?.documentId || createUniqueUuid3(runtime, `knowledge-${originalFilename}-${Date.now()}`);
+        knowledgeId = req.body?.documentIds && req.body.documentIds[index] || req.body?.documentId || createUniqueUuid2(runtime, `knowledge-${originalFilename}-${Date.now()}`);
+        logger5.debug(
+          `[KNOWLEDGE UPLOAD HANDLER] File: ${originalFilename}, Agent ID: ${agentId}, World ID: ${worldId}, Knowledge ID: ${knowledgeId}`
+        );
         try {
           const fileBuffer = await fs3.promises.readFile(filePath);
-          const fileExt = file.originalname.split(".").pop()?.toLowerCase() || "";
-          const filename = file.originalname;
-          const title = filename.replace(`.${fileExt}`, "");
           const base64Content = fileBuffer.toString("base64");
-          const knowledgeItem = {
-            id: knowledgeId,
-            content: {
-              text: base64Content
-            },
-            metadata: {
-              type: MemoryType4.DOCUMENT,
-              timestamp: Date.now(),
-              source: "upload",
-              filename,
-              fileExt,
-              title,
-              path: originalFilename,
-              fileType: file.mimetype,
-              fileSize: file.size
-            }
-          };
           const addKnowledgeOpts = {
+            agentId,
+            // Pass the agent ID from frontend
             clientDocumentId: knowledgeId,
             // This is knowledgeItem.id
             contentType: file.mimetype,
@@ -3053,11 +3049,21 @@ async function uploadKnowledgeHandler(req, res, runtime) {
       if (fileUrls.length === 0) {
         return sendError(res, 400, "MISSING_URL", "File URL is required");
       }
-      const agentId = req.body.agentId || req.query.agentId || runtime.agentId;
+      const agentId = req.body.agentId || req.query.agentId;
+      if (!agentId) {
+        logger5.error("[KNOWLEDGE URL HANDLER] No agent ID provided in request");
+        return sendError(
+          res,
+          400,
+          "MISSING_AGENT_ID",
+          "Agent ID is required for uploading knowledge from URLs"
+        );
+      }
+      logger5.info(`[KNOWLEDGE URL HANDLER] Processing URL upload for agent: ${agentId}`);
       const processingPromises = fileUrls.map(async (fileUrl) => {
         try {
           const normalizedUrl = normalizeS3Url(fileUrl);
-          const knowledgeId = createUniqueUuid3(runtime, normalizedUrl);
+          const knowledgeId = createUniqueUuid2(runtime, normalizedUrl);
           const urlObject = new URL(fileUrl);
           const pathSegments = urlObject.pathname.split("/");
           const encodedFilename = pathSegments[pathSegments.length - 1] || "document.pdf";
@@ -3086,6 +3092,8 @@ async function uploadKnowledgeHandler(req, res, runtime) {
             }
           }
           const addKnowledgeOpts = {
+            agentId,
+            // Pass the agent ID from frontend
             clientDocumentId: knowledgeId,
             contentType,
             originalFilename,
@@ -3157,7 +3165,7 @@ async function getKnowledgeDocumentsHandler(req, res, runtime) {
     if (fileUrls && fileUrls.length > 0) {
       const normalizedRequestUrls = fileUrls.map((url) => normalizeS3Url(url));
       const urlBasedIds = normalizedRequestUrls.map(
-        (url) => createUniqueUuid3(runtime, url)
+        (url) => createUniqueUuid2(runtime, url)
       );
       filteredMemories = memories.filter(
         (memory) => urlBasedIds.includes(memory.id) || // If the ID corresponds directly
@@ -3404,6 +3412,87 @@ async function getKnowledgeChunksHandler(req, res, runtime) {
     sendError(res, 500, "RETRIEVAL_ERROR", "Failed to retrieve knowledge chunks", error.message);
   }
 }
+async function searchKnowledgeHandler(req, res, runtime) {
+  const service = runtime.getService(KnowledgeService.serviceType);
+  if (!service) {
+    return sendError(res, 500, "SERVICE_NOT_FOUND", "KnowledgeService not found");
+  }
+  try {
+    const searchText = req.query.q;
+    const parsedThreshold = req.query.threshold ? Number.parseFloat(req.query.threshold) : NaN;
+    let matchThreshold = Number.isNaN(parsedThreshold) ? 0.5 : parsedThreshold;
+    matchThreshold = Math.max(0, Math.min(1, matchThreshold));
+    const parsedLimit = req.query.limit ? Number.parseInt(req.query.limit, 10) : NaN;
+    let limit = Number.isNaN(parsedLimit) ? 20 : parsedLimit;
+    limit = Math.max(1, Math.min(100, limit));
+    const agentId = req.query.agentId || runtime.agentId;
+    if (!searchText || searchText.trim().length === 0) {
+      return sendError(res, 400, "INVALID_QUERY", "Search query cannot be empty");
+    }
+    if (req.query.threshold && (parsedThreshold < 0 || parsedThreshold > 1)) {
+      logger5.debug(
+        `[KNOWLEDGE SEARCH] Threshold value ${parsedThreshold} was clamped to ${matchThreshold}`
+      );
+    }
+    if (req.query.limit && (parsedLimit < 1 || parsedLimit > 100)) {
+      logger5.debug(`[KNOWLEDGE SEARCH] Limit value ${parsedLimit} was clamped to ${limit}`);
+    }
+    logger5.debug(
+      `[KNOWLEDGE SEARCH] Searching for: "${searchText}" with threshold: ${matchThreshold}, limit: ${limit}`
+    );
+    const embedding = await runtime.useModel(ModelType4.TEXT_EMBEDDING, {
+      text: searchText
+    });
+    const results = await runtime.searchMemories({
+      tableName: "knowledge",
+      embedding,
+      query: searchText,
+      count: limit,
+      match_threshold: matchThreshold,
+      roomId: agentId
+    });
+    const enhancedResults = await Promise.all(
+      results.map(async (fragment) => {
+        let documentTitle = "Unknown Document";
+        let documentFilename = "unknown";
+        if (fragment.metadata && typeof fragment.metadata === "object" && "documentId" in fragment.metadata) {
+          const documentId = fragment.metadata.documentId;
+          try {
+            const document = await runtime.getMemoryById(documentId);
+            if (document && document.metadata) {
+              documentTitle = document.metadata.title || document.metadata.filename || documentTitle;
+              documentFilename = document.metadata.filename || documentFilename;
+            }
+          } catch (e) {
+            logger5.debug(`Could not fetch document ${documentId} for fragment`);
+          }
+        }
+        return {
+          id: fragment.id,
+          content: fragment.content,
+          similarity: fragment.similarity || 0,
+          metadata: {
+            ...fragment.metadata || {},
+            documentTitle,
+            documentFilename
+          }
+        };
+      })
+    );
+    logger5.info(
+      `[KNOWLEDGE SEARCH] Found ${enhancedResults.length} results for query: "${searchText}"`
+    );
+    sendSuccess(res, {
+      query: searchText,
+      threshold: matchThreshold,
+      results: enhancedResults,
+      count: enhancedResults.length
+    });
+  } catch (error) {
+    logger5.error("[KNOWLEDGE SEARCH] Error searching knowledge:", error);
+    sendError(res, 500, "SEARCH_ERROR", "Failed to search knowledge", error.message);
+  }
+}
 async function uploadKnowledgeWithMulter(req, res, runtime) {
   const upload = createUploadMiddleware(runtime);
   const uploadArray = upload.array(
@@ -3455,6 +3544,11 @@ var knowledgeRoutes = [
     type: "GET",
     path: "/knowledges",
     handler: getKnowledgeChunksHandler
+  },
+  {
+    type: "GET",
+    path: "/search",
+    handler: searchKnowledgeHandler
   }
 ];
 
@@ -3503,7 +3597,7 @@ var knowledgePlugin = {
             try {
               const service = runtime.getService(KnowledgeService.serviceType);
               if (service instanceof KnowledgeService) {
-                const { loadDocsFromPath: loadDocsFromPath2 } = await import("./docs-loader-AEQHIBO4.js");
+                const { loadDocsFromPath: loadDocsFromPath2 } = await import("./docs-loader-IBTEOAYT.js");
                 const result = await loadDocsFromPath2(service, runtime.agentId);
                 if (result.successful > 0) {
                   logger6.info(`Loaded ${result.successful} documents from docs folder on startup`);