@juspay/neurolink 9.32.0 → 9.33.0

package/dist/client/rag/retrieval/vectorQueryTool.js

@@ -1,307 +0,0 @@
-/**
- * Vector Query Tool
- *
- * Provides semantic search capabilities for RAG pipelines.
- * Integrates with vector stores and supports metadata filtering and reranking.
- */
-import { randomUUID } from "crypto";
-import { z } from "zod";
-import { ProviderFactory } from "../../factories/providerFactory.js";
-import { logger } from "../../utils/logger.js";
-import { rerank } from "../reranker/reranker.js";
-/**
- * Creates a vector query tool for semantic search
- * Follows NeuroLink's factory pattern
- *
- * @param config - Tool configuration
- * @param vectorStore - Vector store instance or resolver function
- * @returns Tool object with execute method
- */
-export function createVectorQueryTool(config, vectorStore) {
-    const { id = `vector-query-${randomUUID().slice(0, 8)}`, description = "Access the knowledge base to find information needed to answer user questions", indexName, embeddingModel, enableFilter = false, includeVectors = false, includeSources = true, topK = 10, reranker: rerankerConfig, providerOptions, } = config;
-    return {
-        name: id,
-        description,
-        parameters: z.object({
-            query: z
-                .string()
-                .describe("The search query to find relevant information"),
-            ...(enableFilter
-                ? {
-                    filter: z
-                        .record(z.string(), z.unknown())
-                        .optional()
-                        .describe("Metadata filters to narrow down results"),
-                }
-                : {}),
-            topK: z
-                .number()
-                .optional()
-                .describe(`Number of results to return (default: ${topK})`),
-        }),
-        /**
-         * Execute the vector query
-         * @param params - Query parameters
-         * @param context - Optional request context
-         * @returns Query results with relevant context
-         */
-        execute: async (params, context) => {
-            const startTime = Date.now();
-            try {
-                // Resolve vector store if it's a function
-                const store = typeof vectorStore === "function"
-                    ? vectorStore(context || {})
-                    : vectorStore;
-                // Generate query embedding
-                const embeddingProvider = await ProviderFactory.createProvider(embeddingModel.provider, embeddingModel.modelName);
-                // Check if provider has embed method
-                if (typeof embeddingProvider.embed !==
-                    "function") {
-                    throw new Error(`Provider ${embeddingModel.provider} does not support embeddings`);
-                }
-                const queryEmbedding = await embeddingProvider.embed(params.query);
-                // Query the vector store
-                let results = await store.query({
-                    indexName,
-                    queryVector: queryEmbedding,
-                    topK: params.topK || topK,
-                    filter: params.filter,
-                    includeVectors,
-                    ...providerOptions,
-                });
-                let reranked = false;
-                // Apply reranking if configured
-                if (rerankerConfig && results.length > 0) {
-                    const rerankerModel = await ProviderFactory.createProvider(rerankerConfig.model.provider, rerankerConfig.model.modelName);
-                    const rerankedResults = await rerank(results, params.query, rerankerModel, {
-                        weights: rerankerConfig.weights,
-                        topK: rerankerConfig.topK,
-                        queryEmbedding,
-                    });
-                    results = rerankedResults.map((r) => r.result);
-                    reranked = true;
-                }
-                // Format results
-                const relevantContext = results
-                    .map((r, i) => `[${i + 1}] ${r.metadata?.text || r.text || ""}`)
-                    .join("\n\n");
-                const queryTime = Date.now() - startTime;
-                logger.info("[VectorQueryTool] Query completed", {
-                    query: params.query.slice(0, 50),
-                    resultsCount: results.length,
-                    queryTime,
-                    reranked,
-                    filtered: !!params.filter,
-                });
-                return {
-                    relevantContext,
-                    sources: includeSources ? results : [],
-                    totalResults: results.length,
-                    metadata: {
-                        queryTime,
-                        reranked,
-                        filtered: !!params.filter,
-                    },
-                };
-            }
-            catch (error) {
-                logger.error("[VectorQueryTool] Query failed", {
-                    query: params.query.slice(0, 50),
-                    error: error instanceof Error ? error.message : String(error),
-                });
-                throw error;
-            }
-        },
-    };
-}
-/**
- * In-memory vector store implementation for testing and development
- */
-export class InMemoryVectorStore {
-    vectors = new Map();
-    /**
-     * Add vectors to an index
-     */
-    async upsert(indexName, items) {
-        let index = this.vectors.get(indexName);
-        if (!index) {
-            index = new Map();
-            this.vectors.set(indexName, index);
-        }
-        for (const item of items) {
-            index.set(item.id, {
-                vector: item.vector,
-                metadata: item.metadata || {},
-            });
-        }
-    }
-    /**
-     * Query vectors by similarity
-     */
-    async query(params) {
-        const { indexName, queryVector, topK = 10, filter, includeVectors = false, } = params;
-        const index = this.vectors.get(indexName);
-        if (!index) {
-            return [];
-        }
-        // Calculate similarities
-        const results = [];
-        for (const [id, data] of index) {
-            // Apply filter if provided
-            if (filter && !this.matchesFilter(data.metadata, filter)) {
-                continue;
-            }
-            const score = this.cosineSimilarity(queryVector, data.vector);
-            results.push({
-                id,
-                score,
-                metadata: data.metadata,
-                ...(includeVectors ? { vector: data.vector } : {}),
-            });
-        }
-        // Sort by score descending and take top K
-        results.sort((a, b) => b.score - a.score);
-        return results.slice(0, topK).map((r) => ({
-            id: r.id,
-            score: r.score,
-            text: r.metadata.text,
-            metadata: r.metadata,
-            ...(includeVectors ? { vector: r.vector } : {}),
-        }));
-    }
-    /**
-     * Delete vectors from an index
-     */
-    async delete(indexName, ids) {
-        const index = this.vectors.get(indexName);
-        if (!index) {
-            return;
-        }
-        for (const id of ids) {
-            index.delete(id);
-        }
-    }
-    /**
-     * Check if metadata matches filter
-     */
-    matchesFilter(metadata, filter) {
-        for (const [key, value] of Object.entries(filter)) {
-            if (key.startsWith("$")) {
-                // Logical operators
-                switch (key) {
-                    case "$and":
-                        if (!value.every((f) => this.matchesFilter(metadata, f))) {
-                            return false;
-                        }
-                        break;
-                    case "$or":
-                        if (!value.some((f) => this.matchesFilter(metadata, f))) {
-                            return false;
-                        }
-                        break;
-                    case "$not":
-                        if (this.matchesFilter(metadata, value)) {
-                            return false;
-                        }
-                        break;
-                }
-            }
-            else {
-                // Field comparison
-                const fieldValue = metadata[key];
-                if (typeof value === "object" && value !== null) {
-                    // Comparison operators
-                    const ops = value;
-                    if ("$eq" in ops && fieldValue !== ops.$eq) {
-                        return false;
-                    }
-                    if ("$ne" in ops && fieldValue === ops.$ne) {
-                        return false;
-                    }
-                    if ("$gt" in ops &&
-                        (typeof fieldValue !== "number" ||
-                            fieldValue <= ops.$gt)) {
-                        return false;
-                    }
-                    if ("$gte" in ops &&
-                        (typeof fieldValue !== "number" ||
-                            fieldValue < ops.$gte)) {
-                        return false;
-                    }
-                    if ("$lt" in ops &&
-                        (typeof fieldValue !== "number" ||
-                            fieldValue >= ops.$lt)) {
-                        return false;
-                    }
-                    if ("$lte" in ops &&
-                        (typeof fieldValue !== "number" ||
-                            fieldValue > ops.$lte)) {
-                        return false;
-                    }
-                    if ("$in" in ops && !ops.$in.includes(fieldValue)) {
-                        return false;
-                    }
-                    if ("$nin" in ops && ops.$nin.includes(fieldValue)) {
-                        return false;
-                    }
-                    if ("$exists" in ops &&
-                        (ops.$exists ? fieldValue === undefined : fieldValue !== undefined)) {
-                        return false;
-                    }
-                    if ("$contains" in ops &&
-                        (typeof fieldValue !== "string" ||
-                            !fieldValue.includes(ops.$contains))) {
-                        return false;
-                    }
-                    if ("$regex" in ops) {
-                        const pattern = ops.$regex;
-                        let regexMatches = false;
-                        // Guard against ReDoS: reject excessively long patterns and limit
-                        // the tested string length to prevent pathological backtracking.
-                        if (pattern.length <= 200) {
-                            try {
-                                const re = new RegExp(pattern);
-                                const testValue = typeof fieldValue === "string"
-                                    ? fieldValue.slice(0, 10_000)
-                                    : "";
-                                regexMatches = re.test(testValue);
-                            }
-                            catch {
-                                // Invalid regex pattern — treat as non-match
-                                regexMatches = false;
-                            }
-                        }
-                        if (!regexMatches) {
-                            return false;
-                        }
-                    }
-                }
-                else {
-                    // Direct equality
-                    if (fieldValue !== value) {
-                        return false;
-                    }
-                }
-            }
-        }
-        return true;
-    }
-    /**
-     * Calculate cosine similarity between two vectors
-     */
-    cosineSimilarity(a, b) {
-        if (a.length !== b.length) {
-            return 0;
-        }
-        let dotProduct = 0;
-        let normA = 0;
-        let normB = 0;
-        for (let i = 0; i < a.length; i++) {
-            dotProduct += a[i] * b[i];
-            normA += a[i] * a[i];
-            normB += b[i] * b[i];
-        }
-        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
-        return denominator === 0 ? 0 : dotProduct / denominator;
-    }
-}

package/dist/client/rag/types.js

@@ -1,8 +0,0 @@
-/**
- * RAG Document Processing Types
- *
- * Comprehensive type definitions for RAG (Retrieval-Augmented Generation)
- * document processing, including chunking strategies, metadata extraction,
- * vector queries, and Graph RAG support.
- */
-export {};

package/dist/client/sdk/toolRegistration.js

@@ -1,377 +0,0 @@
-/**
- * NeuroLink SDK Tool Registration API
- * Simple interface for developers to register custom tools
- */
-import { logger } from "../utils/logger.js";
-import { createMCPServerInfo } from "../utils/mcpDefaults.js";
-import { validateToolName, validateToolDescription, } from "../utils/parameterValidation.js";
-import { convertZodToJsonSchema, isZodSchema, } from "../utils/schemaConversion.js";
-/**
- * Configuration constants for tool validation
- */
-const envDescValue = parseInt(process.env.NEUROLINK_TOOL_DESCRIPTION_MAX_LENGTH || "200", 10);
-// Allow 0 to mean unlimited (no length restriction)
-const DEFAULT_DESCRIPTION_MAX_LENGTH = Number.isInteger(envDescValue) && envDescValue >= 0 ? envDescValue : 200;
-const envNameValue = parseInt(process.env.NEUROLINK_TOOL_NAME_MAX_LENGTH || "50", 10);
-// Allow 0 to mean unlimited (no length restriction)
-const DEFAULT_NAME_MAX_LENGTH = Number.isInteger(envNameValue) && envNameValue >= 0 ? envNameValue : 50;
-/**
- * Enhanced validation configuration
- */
-const VALIDATION_CONFIG = {
-    // Tool name constraints
-    NAME_MIN_LENGTH: 2,
-    NAME_MAX_LENGTH: DEFAULT_NAME_MAX_LENGTH,
-    // Description constraints
-    DESCRIPTION_MIN_LENGTH: 10,
-    DESCRIPTION_MAX_LENGTH: DEFAULT_DESCRIPTION_MAX_LENGTH,
-    // Reserved tool names that cannot be used
-    RESERVED_NAMES: new Set([
-        "system",
-        "internal",
-        "core",
-        "ai",
-        "assistant",
-        "help",
-        "debug",
-        "test",
-        "mock",
-        "default",
-        "config",
-        "admin",
-        "root",
-        "neurolink",
-    ]),
-    // Recommended tool name patterns
-    RECOMMENDED_PATTERNS: [
-        "get_data",
-        "fetch_info",
-        "calculate_value",
-        "send_message",
-        "create_item",
-        "update_record",
-        "delete_file",
-        "validate_input",
-    ],
-    // Pre-compiled regex patterns for performance optimization
-    COMPILED_PATTERN_REGEXES: [
-        "get_data",
-        "fetch_info",
-        "calculate_value",
-        "send_message",
-        "create_item",
-        "update_record",
-        "delete_file",
-        "validate_input",
-    ].map((pattern) => new RegExp(pattern.replace(/_/g, "[_-]"), "i")),
-};
-/**
- * Creates a MCPServerInfo from a set of tools
- */
-export function createMCPServerFromTools(serverId, tools, metadata) {
-    const mcpTools = [];
-    for (const [name, tool] of Object.entries(tools)) {
-        mcpTools.push({
-            name,
-            description: tool.description || name,
-            inputSchema: tool.parameters
-                ? convertSchemaToJsonSchema(tool.parameters)
-                : {},
-        });
-    }
-    // SMART DEFAULTS: Use utility to eliminate manual MCPServerInfo creation
-    return createMCPServerInfo({
-        id: serverId,
-        name: metadata?.title || serverId,
-        tools: mcpTools,
-        description: metadata?.description || serverId,
-        category: metadata?.category,
-        // Detect category based on context if not provided
-        isExternal: metadata?.category === "external",
-        isBuiltIn: metadata?.category === "built-in",
-        isCustomTool: false,
-    });
-}
-/**
- * Helper to convert schema parameters to JSON Schema format
- */
-function convertSchemaToJsonSchema(schema) {
-    if (isZodSchema(schema)) {
-        return convertZodToJsonSchema(schema);
-    }
-    // If it's already a JSON Schema object, return as-is
-    if (schema && typeof schema === "object") {
-        return schema;
-    }
-    // Return empty object if no schema
-    return {};
-}
-/**
- * Helper to create a tool with type safety
- */
-export function createTool(config) {
-    return config;
-}
-/**
- * Helper to create a validated tool with suggested improvements
- */
-export function createValidatedTool(name, config, options = {}) {
-    const { strict = true, suggestions = true } = options;
-    try {
-        // Validate the tool
-        validateTool(name, config);
-        // Provide helpful suggestions if enabled
-        if (suggestions) {
-            provideToolSuggestions(name, config);
-        }
-        logger.debug(`Tool '${name}' created and validated successfully`);
-        return config;
-    }
-    catch (error) {
-        if (strict) {
-            throw error;
-        }
-        // Log warning but continue in non-strict mode
-        logger.warn(`Tool '${name}' validation failed in non-strict mode`, {
-            error: error instanceof Error ? error.message : String(error),
-        });
-        return config;
-    }
-}
-/**
- * Provide helpful suggestions for tool improvement
- */
-function provideToolSuggestions(name, tool) {
-    const suggestions = [];
-    // Check for common improvements
-    if (!tool.parameters) {
-        suggestions.push("Consider adding a parameters schema using Zod for better type safety and validation");
-    }
-    if (!tool.metadata?.category) {
-        suggestions.push("Adding a category in metadata helps organize tools: { metadata: { category: 'data' } }");
-    }
-    if (!tool.metadata?.version) {
-        suggestions.push("Adding a version helps track tool updates: { metadata: { version: '1.0.0' } }");
-    }
-    // Check description quality
-    const description = tool.description.toLowerCase();
-    if (!description.includes("return") && !description.includes("result")) {
-        suggestions.push("Consider describing what the tool returns for better AI understanding");
-    }
-    if (suggestions.length > 0) {
-        logger.debug(`Tool '${name}' suggestions for improvement:`, {
-            suggestions: suggestions.slice(0, 3), // Limit to avoid spam
-        });
-    }
-}
-/**
- * Helper to create a tool with typed parameters
- */
-export function createTypedTool(config) {
-    // Wrap the typed execute to match SimpleTool's signature.
-    // The Zod schema validates params at runtime, so the cast within the wrapper is safe.
-    const wrappedExecute = async (params, context) => {
-        const result = await config.execute(params, context);
-        return result;
-    };
-    return {
-        description: config.description,
-        parameters: config.parameters,
-        execute: wrappedExecute,
-        ...(config.metadata && { metadata: config.metadata }),
-    };
-}
-/**
- * Enhanced tool name validation using centralized utilities
- */
-function validateToolNameLegacy(name) {
-    const error = validateToolName(name);
-    if (error) {
-        throw error;
-    }
-    // Additional legacy-specific validations
-    const trimmedName = name.trim();
-    // Naming convention suggestions using pre-compiled patterns for performance
-    const hasGoodPattern = VALIDATION_CONFIG.COMPILED_PATTERN_REGEXES.some((patternRegex) => {
-        return patternRegex.test(trimmedName);
-    });
-    if (!hasGoodPattern && trimmedName.length > 10) {
-        logger.debug(`Tool name '${name}' could follow recommended patterns for better clarity. ` +
-            `Consider patterns like: ${VALIDATION_CONFIG.RECOMMENDED_PATTERNS.slice(0, 4).join(", ")}`);
-    }
-}
-/**
- * Enhanced description validation using centralized utilities
- */
-function validateToolDescriptionLegacy(name, description) {
-    const error = validateToolDescription(description);
-    if (error) {
-        throw new Error(`Tool '${name}': ${error.message}`);
-    }
-    // Additional legacy-specific validations
-    const trimmedDescription = description.trim();
-    // Quality suggestions
-    const hasActionWord = /^(get|fetch|calculate|send|create|update|delete|validate|process|generate|parse|convert)/i.test(trimmedDescription);
-    if (!hasActionWord) {
-        logger.debug(`Tool '${name}' description could start with an action word (get, fetch, calculate, etc.) for better clarity: "${trimmedDescription.substring(0, 30)}..."`);
-    }
-}
-/**
- * Validate tool configuration with detailed error messages
- */
-export function validateTool(name, tool) {
-    // Enhanced tool name validation using centralized utilities
-    validateToolNameLegacy(name);
-    // Validate tool object
-    if (!tool || typeof tool !== "object") {
-        throw new Error(`Tool '${name}' must be an object with description and execute properties. Received: ${typeof tool}. ` +
-            `Expected format: { description: "Tool description", execute: async (params) => { ... } }`);
-    }
-    // Enhanced description validation using centralized utilities
-    validateToolDescriptionLegacy(name, tool.description);
-    // Validate execute function with signature guidance
-    if (typeof tool.execute !== "function") {
-        throw new Error(`Tool '${name}' must have an execute function. ` +
-            `Expected signature: async (params?: ToolArgs) => Promise<unknown>. ` +
-            `Received: ${typeof tool.execute}. ` +
-            `Example: { execute: async (params) => { return { success: true, data: result }; } }`);
-    }
-    // Check for common mistake: using 'schema' instead of 'parameters'
-    if ("schema" in tool && !("parameters" in tool)) {
-        throw new Error(`Tool '${name}' uses 'schema' property, but NeuroLink expects 'parameters'. ` +
-            `Please change 'schema' to 'parameters' and use a Zod schema: ` +
-            `{ parameters: z.object({ ... }), execute: ... } ` +
-            `See documentation: https://docs.neurolink.com/tools`);
-    }
-    // Validate parameters schema if provided - support both Zod and custom schemas
-    if (tool.parameters) {
-        if (typeof tool.parameters !== "object") {
-            throw new Error(`Tool '${name}' parameters must be an object. ` +
-                `Received: ${typeof tool.parameters}`);
-        }
-        // Check for common schema validation methods (Zod uses 'parse', others might use 'validate')
-        const params = tool.parameters;
-        const hasValidationMethod = typeof params.parse === "function" ||
-            typeof params.validate === "function" ||
-            "_def" in params; // Zod schemas have _def property
-        // Check for plain JSON schema objects (common mistake)
-        if ("type" in params && "properties" in params && !hasValidationMethod) {
-            throw new Error(`Tool '${name}' appears to use a plain JSON schema object as parameters. ` +
-                `NeuroLink requires a Zod schema for proper type validation and tool integration. ` +
-                `Please change from:\n` +
-                `  { type: 'object', properties: { ... } }\n` +
-                `To:\n` +
-                `  z.object({ fieldName: z.string() })\n` +
-                `Import Zod with: import { z } from 'zod'`);
-        }
-        if (!hasValidationMethod) {
-            const errorMessage = typeof params.parse === "function" || "_def" in params
-                ? `Tool '${name}' has a Zod-like schema but validation failed. Ensure it's a valid Zod schema: z.object({ ... })`
-                : typeof params.validate === "function"
-                    ? `Tool '${name}' has a validate method but it may not be callable. Ensure: { parameters: { validate: (data) => { ... } } }`
-                    : `Tool '${name}' parameters must be a schema object with validation. ` +
-                        `Supported formats:\n` +
-                        `• Zod schema: { parameters: z.object({ value: z.string() }) }\n` +
-                        `• Custom schema: { parameters: { validate: (data) => { ... } } }\n` +
-                        `• Custom schema: { parameters: { parse: (data) => { ... } } }`;
-            throw new Error(errorMessage);
-        }
-    }
-    // Validate metadata if provided
-    if (tool.metadata) {
-        if (typeof tool.metadata !== "object" || Array.isArray(tool.metadata)) {
-            throw new Error(`Tool '${name}' metadata must be an object. Received: ${typeof tool.metadata}. ` +
-                `Example: { category: "data", version: "1.0.0", author: "team@company.com" }`);
-        }
-        // Validate metadata fields
-        if (tool.metadata.version && typeof tool.metadata.version !== "string") {
-            throw new Error(`Tool '${name}' metadata.version must be a string. Received: ${typeof tool.metadata.version}. ` +
-                `Example: "1.0.0", "2.1.3-beta"`);
-        }
-        if (tool.metadata.category && typeof tool.metadata.category !== "string") {
-            throw new Error(`Tool '${name}' metadata.category must be a string. Received: ${typeof tool.metadata.category}. ` +
-                `Example: "data", "communication", "utility"`);
-        }
-        if (tool.metadata.tags && !Array.isArray(tool.metadata.tags)) {
-            throw new Error(`Tool '${name}' metadata.tags must be an array of strings. Received: ${typeof tool.metadata.tags}. ` +
-                `Example: ["api", "external", "web"]`);
-        }
-    }
-    // Success feedback for debugging
-    logger.debug(`Tool '${name}' validation passed`, {
-        nameLength: name.length,
-        descriptionLength: tool.description.length,
-        hasParameters: !!tool.parameters,
-        hasMetadata: !!tool.metadata,
-    });
-}
-/**
- * Utility to validate multiple tools at once
- */
-export function validateTools(tools) {
-    const valid = [];
-    const invalid = [];
-    for (const [name, tool] of Object.entries(tools)) {
-        try {
-            validateTool(name, tool);
-            valid.push(name);
-        }
-        catch (error) {
-            invalid.push({
-                name,
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    }
-    logger.debug(`Bulk validation completed`, {
-        validCount: valid.length,
-        invalidCount: invalid.length,
-        totalTools: Object.keys(tools).length,
-    });
-    return { valid, invalid };
-}
-/**
- * Get validation configuration for external inspection
- */
-export function getValidationConfig() {
-    return { ...VALIDATION_CONFIG };
-}
-/**
- * Check if a tool name is available (not reserved)
- */
-export function isToolNameAvailable(name) {
-    if (!name || typeof name !== "string") {
-        return false;
-    }
-    const trimmedName = name.trim().toLowerCase();
-    return (trimmedName.length >= VALIDATION_CONFIG.NAME_MIN_LENGTH &&
-        trimmedName.length <= VALIDATION_CONFIG.NAME_MAX_LENGTH &&
-        !VALIDATION_CONFIG.RESERVED_NAMES.has(trimmedName) &&
-        /^[a-zA-Z0-9_-]+$/.test(trimmedName));
-}
-/**
- * Suggest alternative tool names if the provided name is invalid
- */
-export function suggestToolNames(baseName) {
-    if (!baseName || typeof baseName !== "string") {
-        return VALIDATION_CONFIG.RECOMMENDED_PATTERNS.slice(0, 3);
-    }
-    const cleanBase = baseName.toLowerCase().replace(/[^a-z0-9]/g, "_");
-    const suggestions = [];
-    // Add suffixes if the name is reserved
-    if (VALIDATION_CONFIG.RESERVED_NAMES.has(cleanBase)) {
-        suggestions.push(`${cleanBase}_tool`, `custom_${cleanBase}`, `${cleanBase}_helper`);
-    }
-    // Add pattern-based suggestions
-    const patterns = ["get_", "fetch_", "create_", "update_"];
-    patterns.forEach((pattern) => {
-        if (!cleanBase.startsWith(pattern.slice(0, -1))) {
-            suggestions.push(`${pattern}${cleanBase}`);
-        }
-    });
-    // Add recommended patterns if no good suggestions
-    if (suggestions.length === 0) {
-        suggestions.push(...VALIDATION_CONFIG.RECOMMENDED_PATTERNS.slice(0, 3));
-    }
-    return suggestions.slice(0, 5); // Limit to 5 suggestions
-}