@wix/mcp 1.0.5 → 1.0.7

package/build/docs/docs.js

@@ -1,448 +0,0 @@
-import { z } from 'zod';
-import { runSemanticSearchAndFormat } from './semanticSearch.js';
-import { logger } from '../logger.js';
-import { captureException } from '@sentry/node';
-export const VALID_DOCS_TOOLS = [
-    'WDS',
-    'REST',
-    'SDK',
-    'BUILD_APPS',
-    'WIX_HEADLESS',
-    'BUSINESS_SOLUTIONS'
-];
-export const addDocsTools = (server, allowedTools = [
-    'WDS',
-    'REST',
-    'SDK',
-    'BUILD_APPS',
-    'WIX_HEADLESS',
-    'BUSINESS_SOLUTIONS'
-]) => {
-    // WDS Documentation
-    if (allowedTools.includes('WDS')) {
-        server.tool('SearchWixWDSDocumentation', [
-            'Searches the Wix Design System Documentation for components and patterns.',
-            'Use this tool when you need to understand or implement UI components and design patterns in a Wix project.',
-            'Search for specific component names, patterns, or UI requirements.',
-            "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
-        ].join('\n'), {
-            searchTerm: z
-                .string()
-                .describe('The search term to search for in the Wix Design System Documentation'),
-            maxResults: z
-                .number()
-                .describe('The maximum number of results to return, default is 5, max is 15')
-                .min(1)
-                .max(15)
-                .optional()
-                .default(10)
-        }, async ({ searchTerm, maxResults }) => {
-            try {
-                logger.log(`Searching for ${searchTerm} in Wix WDS`);
-                const result = await runSemanticSearchAndFormat({
-                    toolName: 'WDS',
-                    toolParams: {
-                        searchTerm: searchTerm
-                    },
-                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: result
-                        }
-                    ]
-                };
-            }
-            catch (error) {
-                // panorama.errorMonitor().reportError(error);
-                captureException(error, {
-                    tags: {
-                        componentId: 'SearchWixWDSDocumentation',
-                        toolName: 'SearchWixWDSDocumentation'
-                    }
-                });
-                logger.error(`Error searching for ${searchTerm} in Wix WDS: ${error}`);
-                return {
-                    isError: true,
-                    content: [{ type: 'text', text: 'Error: ' + error.message }]
-                };
-            }
-        });
-    }
-    // REST Documentation
-    if (allowedTools.includes('REST')) {
-        server.tool('SearchWixRESTDocumentation', [
-            'Searches the official Wix REST API documentation.',
-            'Use this tool whenever you need to to interact with the Wix platform via HTTP requests.',
-            "Specify the API endpoint, resource, or action you need information about (e.g., 'get site details endpoint', 'create data collection', 'update product API', 'REST authentication').",
-            "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
-        ].join('\n'), {
-            searchTerm: z
-                .string()
-                .describe('The search term to search for in the Wix REST API Documentation'),
-            maxResults: z
-                .number()
-                .describe('The maximum number of results to return, default is 5, max is 15')
-                .min(1)
-                .max(15)
-                .optional()
-                .default(10)
-        }, async ({ searchTerm, maxResults }) => {
-            try {
-                logger.log(`Searching for ${searchTerm} in Wix REST API`);
-                const result = await runSemanticSearchAndFormat({
-                    toolName: 'REST',
-                    toolParams: {
-                        searchTerm: searchTerm
-                    },
-                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15)),
-                    linesInEachResult: 15
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: result
-                        },
-                        {
-                            type: 'text',
-                            text: 'Next, you MUST use the ReadFullDocsArticle tool if you want to read the full documentation for a specific article or method.'
-                        }
-                    ]
-                };
-            }
-            catch (error) {
-                // panorama.errorMonitor().reportError(error);
-                captureException(error, {
-                    tags: {
-                        componentId: 'SearchWixRESTDocumentation',
-                        toolName: 'SearchWixRESTDocumentation'
-                    }
-                });
-                logger.error(`Error searching for ${searchTerm} in Wix REST API: ${error}`);
-                return {
-                    isError: true,
-                    content: [{ type: 'text', text: 'Error: ' + error.message }]
-                };
-            }
-        });
-    }
-    if (allowedTools.includes('BUSINESS_SOLUTIONS')) {
-        server.tool('WixBusinessFlowsDocumentation', [
-            'This tool provides step-by-step recipes for setting up complex Wix business solutions that involve multiple API calls.',
-            'It excels at guiding the creation of features like booking systems with payments.',
-            'For example, it can guide the setup of a service in Wix Bookings where customers can pay using Wix Payments, such as creating a bookable yoga class',
-            'It searches the Wix Business Solutions documentation for these integrated workflows involving services, bookings, payments, stores, blogs, and more.',
-            'This tool returns a list of articles that are potentially relevant to the input search term.',
-            '**IMPORTANT NOTES:**',
-            '1. Before attempting to implement a multi step API calls on Wix, YOU MUST TRY THIS TOOL FIRST.',
-            '2. Out of the returned list of articles that you will receive, you MUST select the most relevant one and use the ReadFullDocsArticle tool to fetch it.'
-        ].join('\n'), {
-            searchTerm: z
-                .string()
-                .describe('The search term for the required sample flow (e.g. "setup a new business")'),
-            maxResults: z
-                .number()
-                .describe('The maximum number of results to return, default is 5, max is 15')
-                .min(1)
-                .max(15)
-                .optional()
-                .default(5)
-        }, async ({ searchTerm, maxResults }) => {
-            try {
-                logger.log(`Searching for ${searchTerm} in Wix Sample Flows`);
-                const result = await runSemanticSearchAndFormat({
-                    toolName: 'BUSINESS_SOLUTIONS',
-                    toolParams: {
-                        searchTerm: '**RECIPE**:  Business Recipes - full setup flow for::: ' +
-                            searchTerm
-                    },
-                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: result
-                        },
-                        {
-                            type: 'text',
-                            text: `Out of the included list of articles, you **MUST** select the one that is most relevant to the user's request and use the ReadFullDocsArticle tool to fetch it.`
-                        }
-                    ]
-                };
-            }
-            catch (error) {
-                // panorama.errorMonitor().reportError(error);
-                captureException(error, {
-                    tags: {
-                        componentId: 'SearchWixSampleFlowsDocumentation',
-                        toolName: 'SearchWixSampleFlowsDocumentation'
-                    }
-                });
-                logger.error(`Error searching for ${searchTerm} in Wix Sample Flows: ${error}`);
-                return {
-                    isError: true,
-                    content: [{ type: 'text', text: 'Error: ' + error.message }]
-                };
-            }
-        });
-    }
-    // SDK Documentation
-    if (allowedTools.includes('SDK')) {
-        server.tool('SearchWixSDKDocumentation', [
-            'Searches the official Wix javascript SDK documentation.',
-            'Use this tool whenever you need to write or modify Wix related SDK code.',
-            "Specify the SDK module, function, or feature you need information about (e.g., 'how to query all items from a data collection?', 'how to use wix-stores-backend', 'authentication methods in the SDK').",
-            "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
-        ].join('\n'), {
-            searchTerm: z
-                .string()
-                .describe('The search term to search for in the Wix SDK Documentation'),
-            maxResults: z
-                .number()
-                .describe('The maximum number of results to return, default is 5, max is 15')
-                .min(1)
-                .max(15)
-                .optional()
-                .default(5)
-        }, async ({ searchTerm, maxResults }) => {
-            try {
-                logger.log(`Searching for ${searchTerm} in Wix SDK`);
-                // panorama
-                //   .transaction('SearchWixSDKDocumentation')
-                //   .start({ maxResults });
-                const result = await runSemanticSearchAndFormat({
-                    toolName: 'SDK',
-                    toolParams: {
-                        searchTerm: searchTerm
-                    },
-                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15)),
-                    linesInEachResult: 15
-                });
-                // panorama
-                //   .transaction('SearchWixSDKDocumentation')
-                //   .finish({ maxResults });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: result
-                        },
-                        {
-                            type: 'text',
-                            text: 'Next, you MUST use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method.'
-                        }
-                    ]
-                };
-            }
-            catch (error) {
-                // panorama.errorMonitor().reportError(error);
-                captureException(error, {
-                    tags: {
-                        componentId: 'SearchWixSDKDocumentation',
-                        toolName: 'SearchWixSDKDocumentation'
-                    }
-                });
-                logger.error(`Error searching for ${searchTerm} in Wix SDK: ${error}`);
-                return {
-                    isError: true,
-                    content: [{ type: 'text', text: 'Error: ' + error.message }]
-                };
-            }
-        });
-    }
-    // Build Apps Documentation
-    if (allowedTools.includes('BUILD_APPS')) {
-        server.tool('SearchBuildAppsDocumentation', [
-            'Searches the official Build Apps documentation.',
-            'Use this tool when you need to understand or implement Wix CLI applications related code.',
-            'The search term should be a specific Wix CLI command or specific topic related to Wix CLI applications or its ecosystem (e.g. deployment, creating new extensions etc).',
-            "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
-        ].join('\n'), {
-            searchTerm: z
-                .string()
-                .describe('The search term to search for in the Build Apps Documentation'),
-            maxResults: z
-                .number()
-                .describe('The maximum number of results to return, default is 5, max is 15')
-                .min(1)
-                .max(15)
-                .optional()
-                .default(5)
-        }, async ({ searchTerm, maxResults }) => {
-            try {
-                logger.log(`Searching for ${searchTerm} in Build Apps`);
-                const result = await runSemanticSearchAndFormat({
-                    toolName: 'BUILD_APPS',
-                    toolParams: {
-                        searchTerm: `wix cli docs for ${searchTerm}`
-                    },
-                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: result
-                        }
-                    ]
-                };
-            }
-            catch (error) {
-                // panorama.errorMonitor().reportError(error);
-                captureException(error, {
-                    tags: {
-                        componentId: 'SearchBuildAppsDocumentation',
-                        toolName: 'SearchBuildAppsDocumentation'
-                    }
-                });
-                logger.error(`Error searching for ${searchTerm} in Build Apps: ${error}`);
-                return {
-                    content: [{ type: 'text', text: 'Error: ' + error.message }]
-                };
-            }
-        });
-    }
-    // Wix Headless Documentation
-    if (allowedTools.includes('WIX_HEADLESS')) {
-        server.tool('SearchWixHeadlessDocumentation', [
-            'Searches the official Wix Headless Documentation.',
-            'Use this tool when you need to understand or implement Headless related code.',
-            'The search term should be a specific Wix Headless topic or feature you need information about.',
-            "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
-        ].join('\n'), {
-            searchTerm: z
-                .string()
-                .describe('The search term to search for in the Headless Documentation'),
-            maxResults: z
-                .number()
-                .describe('The maximum number of results to return, default is 5, max is 15')
-                .min(1)
-                .max(15)
-                .optional()
-                .default(5)
-        }, async ({ searchTerm, maxResults }) => {
-            try {
-                logger.log(`Searching for ${searchTerm} in Headless`);
-                const result = await runSemanticSearchAndFormat({
-                    toolName: 'WIX_HEADLESS',
-                    toolParams: {
-                        searchTerm: searchTerm
-                    },
-                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: result
-                        }
-                    ]
-                };
-            }
-            catch (error) {
-                // panorama.errorMonitor().reportError(error);
-                captureException(error, {
-                    tags: {
-                        componentId: 'SearchWixHeadlessDocumentation',
-                        toolName: 'SearchWixHeadlessDocumentation'
-                    }
-                });
-                logger.error(`Error searching for ${searchTerm} in Wix Headless: ${error}`);
-                return {
-                    content: [{ type: 'text', text: 'Error: ' + error.message }]
-                };
-            }
-        });
-    }
-    server.tool('ReadFullDocsArticle', [
-        'Fetches the full Wix docs article or method article.',
-        'Use this tool when you read a summary of a docs article or method article, you have the docs url and want to read the full article.'
-    ].join('\n'), {
-        articleUrl: z
-            .string()
-            .describe('The URL of the docs article or method article to fetch. Should be something like https://dev.wix.com/docs/.../.../...')
-    }, async ({ articleUrl }) => {
-        try {
-            const articleContent = await fetchArticleContent(articleUrl, 'article');
-            if (!articleContent) {
-                throw new Error('Article content is empty');
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: articleContent
-                    },
-                    {
-                        type: 'text',
-                        text: [
-                            '---',
-                            'Next, if you are dealing with a method - you MUST call ReadFullDocsMethodSchema tool - it will give you the full request schema for the method.'
-                        ].join('\n')
-                    }
-                ]
-            };
-        }
-        catch (error) {
-            logger.error(`Error fetching article content or method schema for ${articleUrl}: ${error}`);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Could not fetch article content, you should try completing the task without it.'
-                    }
-                ]
-            };
-        }
-    });
-    server.tool('ReadFullDocsMethodSchema', [
-        'Fetches the full method schema for a given method. Always use it before calling the method.',
-        'This will give you the entire request/response schema with all the fields and their descriptions.'
-    ].join('\n'), {
-        articleUrl: z
-            .string()
-            .describe('The URL of the documentation to fetch. Should be something like https://dev.wix.com/docs/.../.../...')
-    }, async ({ articleUrl }) => {
-        try {
-            const articleContent = await fetchArticleContent(articleUrl, 'methodSchema');
-            if (!articleContent) {
-                throw new Error('Method schema is empty');
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: articleContent
-                    }
-                ]
-            };
-        }
-        catch (error) {
-            logger.error(`Error fetching method schema for ${articleUrl}: ${error}`);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Could not fetch method schema, you should try completing the task without it.'
-                    }
-                ]
-            };
-        }
-    });
-};
-async function fetchArticleContent(articleUrl, mode) {
-    // https://dev.wix.com/digor/api/get-article-content?articleUrl=https://dev.wix.com/docs/rest/business-solutions/blog/draft-posts/create-draft-post&schema=true
-    const url = new URL(`https://dev.wix.com/digor/api/get-article-content`);
-    url.searchParams.set('articleUrl', articleUrl);
-    const schema = mode === 'methodSchema' ? 'true' : 'false';
-    url.searchParams.set('schema', schema);
-    logger.log(`Fetching resource from docs ${url.toString()}`);
-    const response = await fetch(url.toString());
-    const data = await response.json();
-    logger.log(`Fetched resource from docs: ${data.articleContent}`);
-    return data.articleContent;
-}

package/build/docs/long-content.js

@@ -1 +0,0 @@
-export const LONG_KB_CONTENT = "# Method name:\n\ncrm.contacts.queryContacts(options: QueryContactsOptions)\n\n# Method Link:\n\nhttps://dev.wix.com/docs/sdk/backend-modules/crm/contacts/query-contacts\n\n# Method Description:\n\nCreates a query to retrieve a list of contacts.\n\nThe `queryContacts()` function builds a query to retrieve a list of contacts and returns a `ContactsQueryBuilder` object.\n\nThe returned object contains the query definition, which is typically used to run the query using the `find()` function.\n\nYou can refine the query by chaining `ContactsQueryBuilder` functions onto the query. `ContactsQueryBuilder` functions enable you to sort, filter, and control the results `queryContacts()` returns.\n\n`queryContacts()` runs with these `ContactsQueryBuilder` defaults, which you can override:\n\n- `skip(0)`\n- `limit(50)`\n- `descending(\"_createdDate\")`\n\nThe functions that are chained to `queryContacts()` are applied in the order they are called. For example, if you apply `ascending('info.company')` and then `descending('info.name.last')`, the results are sorted first by the company name, and then, if there are multiple results with the same company, the items are sorted by last name.\n\n\n|PROPERTY\t|SUPPORTED FILTERS & SORTING\t\n|:---:|:---:|\n|`_id`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists)|\n|`_createdDate`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`gt()`](/contacts-query-builder/gt),[`lt()`](/contacts-query-builder/lt),[`ge()`](/contacts-query-builder/ge),[`le()`](/contacts-query-builder/le),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`_updatedDate`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`gt()`](/contacts-query-builder/gt),[`lt()`](/contacts-query-builder/lt),[`ge()`](/contacts-query-builder/ge),[`le()`](/contacts-query-builder/le)|\n|`lastActivity.activityDate`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`gt()`](/contacts-query-builder/gt),[`lt()`](/contacts-query-builder/lt),[`ge()`](/contacts-query-builder/ge),[`le()`](/contacts-query-builder/le),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`primaryInfo.email`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists),[`startsWith()`](/contacts-query-builder/starts-with),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`primaryInfo.phone`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists),[`startsWith()`](/contacts-query-builder/starts-with)|\n|`info.name.first`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists),[`startsWith()`](/contacts-query-builder/starts-with),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`info.name.last`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists),[`startsWith()`](/contacts-query-builder/starts-with),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`info.company`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists),[`startsWith()`](/contacts-query-builder/starts-with),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`info.jobTitle`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists),[`startsWith()`](/contacts-query-builder/starts-with),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`info.birthdate`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`ascending()`](/contacts-query-builder/ascending),[`descending()`](/contacts-query-builder/descending)|\n|`info.locale`|[`eq()`](/contacts-query-builder/eq),[`ne()`](/contacts-query-builder/ne),[`in()`](/contacts-query-builder/in),[`exists()`](/contacts-query-builder/exists)|\n\n# Method Permissions:\n\n- Manage Events\n- Read Contacts\n- Read Members and Contacts - all read permissions\n- Manage Restaurants - all permissions\n- Manage Contacts\n- Set Up Automations\n- Manage Members and Contacts - all permissions\n\n# Method Permissions Scopes IDs:\n\n- SCOPE.EVENTS.MANAGE-EVENTS\n- SCOPE.DC-CONTACTS.READ-CONTACTS\n- SCOPE.DC-CONTACTS-MEGA.READ-MEMBERS-CONTACTS\n- SCOPE.RESTAURANTS.MEGA-SCOPES\n- SCOPE.DC-CONTACTS.MANAGE-CONTACTS\n- SCOPE.CRM.SETUP-AUTOMATIONS\n- SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS\n\n# Method Schema Summary:\n\n# API Method Summary: `queryContacts`\n\n## Method Signature\n```javascript\ncrm.contacts.queryContacts(options)\n```\n\n## Description\nThe `queryContacts()` method creates a query to retrieve a list of contacts and returns a `ContactsQueryBuilder` object. This object allows for further refinement of the query through chaining methods to sort, filter, and control the results. The default settings for the query are:\n- `skip(0)`\n- `limit(50)`\n- `descending(\"_createdDate\")`\n\n## Parameters\n- **options**: `QueryContactsOptions`\n  - Description: Options for querying contacts.\n\n## Return Type\n- **REFERENCE<ContactsQueryBuilder>**: The method returns a `ContactsQueryBuilder` object that can be used to refine the query further.\n\n## Supported Filters & Sorting\nThe following properties can be used for filtering and sorting, along with their supported functions:\n\n| Property                     | Supported Functions                                                                                      |\n|------------------------------|---------------------------------------------------------------------------------------------------------|\n| `_id`                        | `eq()`, `ne()`, `in()`, `exists()`                                                                      |\n| `_createdDate`              | `eq()`, `ne()`, `gt()`, `lt()`, `ge()`, `le()`, `ascending()`, `descending()`                          |\n| `_updatedDate`              | `eq()`, `ne()`, `gt()`, `lt()`, `ge()`, `le()`                                                          |\n| `lastActivity.activityDate`  | `eq()`, `ne()`, `gt()`, `lt()`, `ge()`, `le()`, `ascending()`, `descending()`                          |\n| `primaryInfo.email`         | `eq()`, `ne()`, `in()`, `exists()`, `startsWith()`, `ascending()`, `descending()`                      |\n| `primaryInfo.phone`         | `eq()`, `ne()`, `in()`, `exists()`, `startsWith()`                                                    |\n| `info.name.first`           | `eq()`, `ne()`, `in()`, `exists()`, `startsWith()`, `ascending()`, `descending()`                      |\n| `info.name.last`            | `eq()`, `ne()`, `in()`, `exists()`, `startsWith()`, `ascending()`, `descending()`                      |\n| `info.company`              | `eq()`, `ne()`, `in()`, `exists()`, `startsWith()`, `ascending()`, `descending()`                      |\n| `info.jobTitle`             | `eq()`, `ne()`, `in()`, `exists()`, `startsWith()`, `ascending()`, `descending()`                      |\n| `info.birthdate`            | `eq()`, `ne()`, `ascending()`, `descending()`                                                           |\n| `info.locale`               | `eq()`, `ne()`, `in()`, `exists()`                                                                      |\n\n## Enum Properties\nThe following properties have limited allowed values (enums):\n\n- **lastActivity.activityType**: \n  - Valid values: `ARENA_NEW_LEAD`, `BOOKINGS_APPOINTMENT`, `CASHIER_BUTTON_PURCHASE`, `CONTACT_CREATED`, `CONTACT_MERGED`, `ECOM_CART_ABANDON`, `ECOM_CHECKOUT_BUYER`, `ECOM_PURCHASE`, `EVENTS_RSVP`, `FORM_SUBMITTED`, `GENERAL`, `HOTELS_CANCEL`, `HOTELS_CONFIRMATION`, `HOTELS_PURCHASE`, `HOTELS_RESERVATION`, `INBOX_FORM_SUBMITTED`, `INBOX_MESSAGE_FROM_CUSTOMER`, `INBOX_MESSAGE_TO_CUSTOMER`, `INBOX_PAYMENT_REQUEST_PAID`, `INVOICE_OVERDUE`, `INVOICE_PAY`, `MEMBER_LOGIN`, `MEMBER_REGISTER`, `MEMBER_STATUS_CHANGED`, `NEWSLETTER_SUBSCRIPTION_FORM_SUBMITTED`, `NEWSLETTER_SUBSCRIPTION_NOT_SET`, `NEWSLETTER_SUBSCRIPTION_PENDING`, `NEWSLETTER_SUBSCRIPTION_SUBSCRIBE`, `NEWSLETTER_SUBSCRIPTION_UNSUBSCRIBE`, `PHONE_SUBSCRIPTION_NOT_SET`, `PHONE_SUBSCRIPTION_PENDING`, `PHONE_SUBSCRIPTION_SUBSCRIBE`, `PHONE_SUBSCRIPTION_UNSUBSCRIBE`, `PRICE_QUOTE_ACCEPT`, `PRICE_QUOTE_EXPIRE`, `RESTAURANTS_ORDER`, `RESTAURANTS_RESERVATION`, `SHOUTOUT_CLICK`, `SHOUTOUT_OPEN`, `VIDEO_PURCHASE`, `VIDEO_RENT`\n\n- **primaryEmail.deliverabilityStatus**: \n  - Valid values: `BOUNCED`, `INACTIVE`, `NOT_SET`, `SPAM_COMPLAINT`, `VALID`\n\n- **primaryEmail.subscriptionStatus**: \n  - Valid values: `NOT_SET`, `NO_SUBSCRIPTION_STATUS`, `PENDING`, `SUBSCRIBED`, `UNSUBSCRIBED`\n\n- **primaryPhone.subscriptionStatus**: \n  - Valid values: `NOT_SET`, `NO_SUBSCRIPTION_STATUS`\n\n- **info.emails.items[].tag**: \n  - Valid values: `HOME`, `MAIN`, `UNTAGGED`, `WORK`\n\n- **info.phones.items[].tag**: \n  - Valid values: `FAX`, `HOME`, `MAIN`, `MOBILE`, `UNTAGGED`, `WORK`\n\n- **items[].info.addresses.items[].tag**: \n  - Valid values: `BILLING`, `HOME`, `SHIPPING`, `UNTAGGED`, `WORK`\n\n**Note**: Ensure to use the correct enum values when filtering or sorting based on these properties. \n\n## Possible Errors\nThe following errors may occur when using this method:\n- **400 INVALID_ARGUMENT**: Various application codes indicating unsupported filter value types, unsupported filter values, unsupported filter operators, unsupported filter fields, malformed filters, illegal limits, or unsupported sort fields.\n\n# Method Code Examples:\n\n## queryContacts\n\n```javascript\nimport { contacts } from '@wix/crm';\n\nasync function queryContacts() {\n  const { items } = await contacts.queryContacts().find();\n};\n```\n\n\n\n## default\n\n```javascript\ntry {\n      const { items } = await contacts.queryContacts().find();\n      return items;\n    } catch (error) {\n      console.error(error);\n      throw error;\n   }\n````";

package/build/docs/semanticSearch.js

@@ -1,108 +0,0 @@
-import { logger } from '../logger.js';
-export const MAX_CONTENT_LENGTH = 10000;
-export const DEFAULT_MAX_RESULTS = 10;
-const runSemanticSearch = async (toolName, toolParams, maxResults = 20, rerank = false) => {
-    const startTime = new Date().getTime();
-    const url = new URL(`https://www.wixapis.com/mcp-docs-search/v1/search?maxResults=${maxResults}&rerank=${rerank}`);
-    if (toolName === 'SDK') {
-        url.searchParams.append('kbName', 'SDK_SCHEMAS_KB_ID');
-        url.searchParams.append('kbName', 'SDK_DOCS_KB_ID');
-    }
-    else if (toolName === 'REST' || toolName === 'BUSINESS_SOLUTIONS') {
-        if (toolName === 'REST') {
-            url.searchParams.append('kbName', 'REST_METHODS_KB_ID');
-        }
-        url.searchParams.append('kbName', 'REST_DOCS_KB_ID');
-        url.searchParams.append('kbName', 'MCP_REST_RECIPES_KB_ID');
-    }
-    else if (toolName === 'WDS') {
-        url.searchParams.append('kbName', 'WDS_DOCS_KB_ID');
-    }
-    else if (toolName === 'BUILD_APPS') {
-        url.searchParams.append('kbName', 'BUILD_APPS_KB_ID');
-    }
-    else if (toolName === 'WIX_HEADLESS') {
-        url.searchParams.append('kbName', 'HEADLESS_KB_ID');
-    }
-    for (const [key, value] of Object.entries(toolParams)) {
-        url.searchParams.append(key, value);
-    }
-    logger.log('Running RAG search', url.toString());
-    const response = await fetch(url.toString(), {
-        headers: {
-            'Content-Type': 'application/json',
-            'x-time-budget': '180000',
-            'x-wix-time-budget': '180000'
-        }
-    });
-    if (!response.ok) {
-        logger.error(`Failed to run rag search: ${response.statusText}`);
-        throw new Error(`Failed to run rag search: ${response.statusText}`);
-    }
-    const data = await response.json();
-    const endTime = new Date().getTime();
-    const timeTaskFormatted = (endTime - startTime) / 1000;
-    logger.log('Ran RAG search successfully with params', JSON.stringify(toolParams), timeTaskFormatted, typeof data);
-    return data?.results;
-};
-const getContentFromChunkedContent = (chunkedContent) => {
-    let content = '';
-    for (const chunk of chunkedContent) {
-        if (content.length + chunk.length > MAX_CONTENT_LENGTH) {
-            break;
-        }
-        content += '\n\n---\n\n' + chunk;
-    }
-    return content;
-};
-const formatResultsContent = (resultsFromKbs, maxResults, linesInEachResult = undefined) => {
-    // First, take the results from all KBs and sort them by overallMatchScore
-    const allResults = Object.entries(resultsFromKbs)
-        .map(([, { results }]) => results)
-        .flat();
-    if (allResults.length === 0) {
-        throw new Error('No result from search');
-    }
-    const sortedResults = allResults.sort((a, b) => b.scoresInfo.overallMatchScore - a.scoresInfo.overallMatchScore);
-    // Take the top maxResults results
-    const topResults = sortedResults.slice(0, maxResults);
-    // Concatenate the content of the top results
-    const concatenatedContent = topResults
-        .map((result) => {
-        let newContent = result.entry.content;
-        if (linesInEachResult) {
-            const totalLines = newContent.split('\n').length;
-            const linesToTake = Math.min(linesInEachResult, totalLines);
-            newContent = newContent.split('\n').slice(0, linesToTake).join('\n');
-            const moreLines = totalLines - linesToTake;
-            const moreLinesText = moreLines > 0 ? `\n\n... ${moreLines} more lines ...` : '';
-            newContent = `${newContent}${moreLinesText}`;
-        }
-        return {
-            ...result,
-            entry: {
-                ...result.entry,
-                content: newContent
-            }
-        };
-    })
-        .map((result) => {
-        const content = result.entry.content;
-        const chunkedContent = result.entry.chunkedContent;
-        if (content.length > MAX_CONTENT_LENGTH) {
-            logger.log(`Content is too long, using chunked content`, {
-                contentLength: content.length,
-                chunkedContentLength: chunkedContent.length
-            });
-            return getContentFromChunkedContent(chunkedContent);
-        }
-        return content;
-    })
-        .join('\n\n---\n\n');
-    return concatenatedContent;
-};
-export const runSemanticSearchAndFormat = async ({ toolName, toolParams, maxResults = DEFAULT_MAX_RESULTS, rerank, linesInEachResult }) => {
-    const results = await runSemanticSearch(toolName, toolParams, maxResults, rerank);
-    const maxResultsToUse = Math.min(maxResults, DEFAULT_MAX_RESULTS);
-    return formatResultsContent(results, maxResultsToUse, linesInEachResult);
-};