@wix/mcp 1.0.23 → 1.0.24

package/build/bin-standalone.js

@@ -207,7 +207,7 @@ var require_toPropertyKey = __commonJS({
 var require_defineProperty = __commonJS({
   "../../node_modules/@babel/runtime/helpers/defineProperty.js"(exports, module) {
     var toPropertyKey = require_toPropertyKey();
-    function _defineProperty(e, r, t) {
+    function _defineProperty2(e, r, t) {
       return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
         value: t,
         enumerable: true,
@@ -215,7 +215,7 @@ var require_defineProperty = __commonJS({
         writable: true
       }) : e[r] = t, e;
     }
-    module.exports = _defineProperty, module.exports.__esModule = true, module.exports["default"] = module.exports;
+    module.exports = _defineProperty2, module.exports.__esModule = true, module.exports["default"] = module.exports;
   }
 });
 
@@ -1721,7 +1721,7 @@ function __importStar(mod) {
   if (mod && mod.__esModule) return mod;
   var result = {};
   if (mod != null) {
-    for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+    for (var k = ownKeys2(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
   }
   __setModuleDefault(result, mod);
   return result;
@@ -1805,7 +1805,7 @@ function __rewriteRelativeImportExtension(path3, preserveJsx) {
   }
   return path3;
 }
-var extendStatics, __assign, __createBinding, __setModuleDefault, ownKeys, _SuppressedError, tslib_es6_default;
+var extendStatics, __assign, __createBinding, __setModuleDefault, ownKeys2, _SuppressedError, tslib_es6_default;
 var init_tslib_es6 = __esm({
   "../../node_modules/tslib/tslib.es6.mjs"() {
     extendStatics = function(d, b) {
@@ -1844,13 +1844,13 @@ var init_tslib_es6 = __esm({
     }) : function(o, v) {
       o["default"] = v;
     };
-    ownKeys = function(o) {
-      ownKeys = Object.getOwnPropertyNames || function(o2) {
+    ownKeys2 = function(o) {
+      ownKeys2 = Object.getOwnPropertyNames || function(o2) {
         var ar = [];
         for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
         return ar;
       };
-      return ownKeys(o);
+      return ownKeys2(o);
     };
     _SuppressedError = typeof SuppressedError === "function" ? SuppressedError : function(error, suppressed, message) {
       var e = new Error(message);
@@ -10317,7 +10317,6 @@ var runSemanticSearch = async (toolName, toolParams, maxResults = 20, rerank = f
       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") {
@@ -10432,6 +10431,22 @@ var GET_ARTICLE_CONTENT_URL = `${RAW_DOCS_API_URL}/get-article-content`;
 var PORTAL_INDEX_URL = `${RAW_DOCS_API_URL}/portal-index`;
 
 // src/docs/fetch-article.ts
+var PICASSO_URL_PREFIX = "https://dev.wix.com/docs/picasso/";
+function applyPicassoUrlOverride(articleUrl, picassoPortalUrl) {
+  if (!picassoPortalUrl) {
+    return articleUrl;
+  }
+  if (articleUrl.startsWith(PICASSO_URL_PREFIX)) {
+    const baseUrl = picassoPortalUrl.replace(/\/$/, "");
+    const pathAfterPicasso = articleUrl.slice(PICASSO_URL_PREFIX.length);
+    const overriddenUrl = `${baseUrl}/${pathAfterPicasso}`;
+    logger.log(
+      `[Picasso URL Override] Redirecting ${articleUrl} to ${overriddenUrl}`
+    );
+    return overriddenUrl;
+  }
+  return articleUrl;
+}
 async function fetchArticleContentFromDigor(httpClient, articleUrl, mode, stripHeader = false) {
   const url = new URL(GET_ARTICLE_CONTENT_URL);
   url.searchParams.set("articleUrl", articleUrl);
@@ -10451,7 +10466,20 @@ async function fetchArticleContentFromDigor(httpClient, articleUrl, mode, stripH
   }
   return data.articleContent;
 }
-async function fetchArticleContent(httpClient, articleUrl, mode, stripHeader = false) {
+async function fetchArticleContent(httpClient, articleUrl, mode, stripHeader = false, picassoPortalUrl) {
+  const effectiveUrl = applyPicassoUrlOverride(articleUrl, picassoPortalUrl);
+  const isOverridden = effectiveUrl !== articleUrl;
+  if (isOverridden) {
+    try {
+      const { data: doc } = await httpClient.get(effectiveUrl);
+      return doc;
+    } catch (error) {
+      console.warn(
+        `[fetch] Override failed for ${effectiveUrl}, falling back to ${articleUrl}:`,
+        error instanceof Error ? error.message : error
+      );
+    }
+  }
   if (mode === "raw") {
     let parsedUrl;
     try {
@@ -10476,117 +10504,365 @@ async function fetchArticleContent(httpClient, articleUrl, mode, stripHeader = f
   );
 }
 
-// src/docs/get-to-know.ts
-var DEFAULT_DOC_URLS = [
+// ../../node_modules/dedent/dist/dedent.mjs
+function ownKeys(object, enumerableOnly) {
+  var keys = Object.keys(object);
+  if (Object.getOwnPropertySymbols) {
+    var symbols = Object.getOwnPropertySymbols(object);
+    enumerableOnly && (symbols = symbols.filter(function(sym) {
+      return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+    })), keys.push.apply(keys, symbols);
+  }
+  return keys;
+}
+function _objectSpread(target) {
+  for (var i = 1; i < arguments.length; i++) {
+    var source = null != arguments[i] ? arguments[i] : {};
+    i % 2 ? ownKeys(Object(source), true).forEach(function(key) {
+      _defineProperty(target, key, source[key]);
+    }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function(key) {
+      Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+    });
+  }
+  return target;
+}
+function _defineProperty(obj, key, value) {
+  key = _toPropertyKey(key);
+  if (key in obj) {
+    Object.defineProperty(obj, key, { value, enumerable: true, configurable: true, writable: true });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+function _toPropertyKey(arg) {
+  var key = _toPrimitive(arg, "string");
+  return typeof key === "symbol" ? key : String(key);
+}
+function _toPrimitive(input, hint) {
+  if (typeof input !== "object" || input === null) return input;
+  var prim = input[Symbol.toPrimitive];
+  if (prim !== void 0) {
+    var res = prim.call(input, hint || "default");
+    if (typeof res !== "object") return res;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return (hint === "string" ? String : Number)(input);
+}
+var dedent = createDedent({});
+var dedent_default = dedent;
+function createDedent(options) {
+  dedent2.withOptions = (newOptions) => createDedent(_objectSpread(_objectSpread({}, options), newOptions));
+  return dedent2;
+  function dedent2(strings, ...values) {
+    const raw = typeof strings === "string" ? [strings] : strings.raw;
+    const {
+      alignValues = false,
+      escapeSpecialCharacters = Array.isArray(strings),
+      trimWhitespace = true
+    } = options;
+    let result = "";
+    for (let i = 0; i < raw.length; i++) {
+      let next = raw[i];
+      if (escapeSpecialCharacters) {
+        next = next.replace(/\\\n[ \t]*/g, "").replace(/\\`/g, "`").replace(/\\\$/g, "$").replace(/\\\{/g, "{");
+      }
+      result += next;
+      if (i < values.length) {
+        const value = alignValues ? alignValue(values[i], result) : values[i];
+        result += value;
+      }
+    }
+    const lines = result.split("\n");
+    let mindent = null;
+    for (const l of lines) {
+      const m = l.match(/^(\s+)\S+/);
+      if (m) {
+        const indent = m[1].length;
+        if (!mindent) {
+          mindent = indent;
+        } else {
+          mindent = Math.min(mindent, indent);
+        }
+      }
+    }
+    if (mindent !== null) {
+      const m = mindent;
+      result = lines.map((l) => l[0] === " " || l[0] === "	" ? l.slice(m) : l).join("\n");
+    }
+    if (trimWhitespace) {
+      result = result.trim();
+    }
+    if (escapeSpecialCharacters) {
+      result = result.replace(/\\n/g, "\n");
+    }
+    if (typeof Bun !== "undefined") {
+      result = result.replace(
+        // Matches e.g. \\u{1f60a} or \\u5F1F
+        /\\u(?:\{([\da-fA-F]{1,6})\}|([\da-fA-F]{4}))/g,
+        (_, braced, unbraced) => {
+          var _ref;
+          const hex = (_ref = braced !== null && braced !== void 0 ? braced : unbraced) !== null && _ref !== void 0 ? _ref : "";
+          return String.fromCodePoint(parseInt(hex, 16));
+        }
+      );
+    }
+    return result;
+  }
+}
+function alignValue(value, precedingText) {
+  if (typeof value !== "string" || !value.includes("\n")) {
+    return value;
+  }
+  const currentLine = precedingText.slice(precedingText.lastIndexOf("\n") + 1);
+  const indentMatch = currentLine.match(/^(\s+)/);
+  if (indentMatch) {
+    const indent = indentMatch[1];
+    return value.replace(/\n/g, `
+${indent}`);
+  }
+  return value;
+}
+
+// src/config/default-config.ts
+var SYSTEM_REMINDER = dedent_default`
+  <system-reminder>
+  Wix MCP Site Management Flows:
+  - RECIPE BASED (PREFERRED!): WixREADME() -> find relevant recipe for the user's prompt/task -> read recipe using ReadFullDocsArticle() -> call API using CallWixSiteAPI() based on the recipe
+  - EXAMPLE BASED: WixREADME() -> no relevant recipe found for user's prompt/task -> SearchWixRESTDocumentation() -> find relevant method -> read method article using ReadFullDocsArticle() to get method code examples -> call API using CallWixSiteAPI() based on the method code examples
+  - SCHEMA BASED, FALLBACK: WixREADME() -> no relevant recipe found for user's prompt/task -> SearchWixRESTDocumentation() -> find relevant method -> read method article using ReadFullDocsArticle() -> no method code examples found -> read method schema using ReadFullDocsMethodSchema() -> call API using CallWixSiteAPI() based on the schema
+  </system-reminder>
+`;
+var defaultToolDescriptions = {
+  WixREADME: dedent_default`
+    # Tool: WixREADME
+    **Directive:** \`WixREADME\` is the **MANDATORY FIRST STEP** for all Wix-related tasks. Its output (including relevant linked documents) provides foundational context for all other Wix tools. Adherence to this protocol is **NON-NEGOTIABLE**.
+    ${SYSTEM_REMINDER}
+  `,
+  SearchWixRESTDocumentation: dedent_default`
+    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.
+    ${SYSTEM_REMINDER}
+  `,
+  ReadFullDocsArticle: dedent_default`
+    Fetches the full Wix docs article or method article with code examples for using the method.
+    Docs articles looks like this: https://dev.wix.com/docs/... and they can either be general docs articles or method articles.
+    ${SYSTEM_REMINDER}
+  `,
+  ReadFullDocsMethodSchema: dedent_default`
+    Fetches the full method schema for a given method.
+    This will give you the entire request/response schema with all the fields and their descriptions.
+    ${SYSTEM_REMINDER}
+  `,
+  CallWixSiteAPI: dedent_default`
+    Call Wix apis on a business or site. Use this to create, read, update, and delete data and other Wix entities in your Wix site,
+    The API endpoint url param MUST ALWAYS be taken from the conversation context.
+    By conversation context we mean the endpoint url was given in the user prompt or got into the conversation context by the "WixREADME" tool or by the "SearchWixRESTDocumentation" tool or by the "ReadFullDocsArticle" tool.
+    Error Handling:
+    If the error is related to missing installed app or "WDE0110: Wix Code not enabled", you should install the missing app by using ReadFullDocsArticle tool to fetch the article - https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_wix.devcenter.apps.installer.v1.AppsInstallerService.InstallApp
+    **Note:** there is no need to check if an app is installed/ Wix Code enabled in advance, just call the API and handle the error if it occurs, the API error message will state it clearly.
+    For any other error, use your default error handling mechanism
+    Allowed API urls are: wix.com, dev.wix.com, manage.wix.com, editor.wix.com, wixapis.com
+    Docs urls like https://dev.wix.com/docs/... are not api urls, if you want to read the docs, use the "ReadFullDocsArticle" tool
+    ${SYSTEM_REMINDER}
+  `,
+  ListWixSites: dedent_default`
+    List Wix sites for the current user, by default it will return all sites, but you can filter by name
+    ${SYSTEM_REMINDER}
+  `,
+  ManageWixSite: dedent_default`
+    Use account level API in order to create a site, update a site and publish site.
+    The API endpoint url param MUST ALWAYS be taken from the conversation context.
+    By conversation context we mean the endpoint url was given in the user prompt or got into the conversation context by the "WixREADME" tool or by the "SearchWixRESTDocumentation" tool or by the "ReadFullDocsArticle" tool.
+    ${SYSTEM_REMINDER}
+  `,
+  UploadImageToWixSite: dedent_default`
+    Upload an image file to a Wix site Media Manager.
+    This tool accepts an image from the user and uploads it to the specified Wix site.
+    Returns the uploaded file URL (wixstatic.com) and media ID that can be used in other Wix APIs.
+    Use this when the user wants to upload a local image to their Wix site.
+  `,
+  SupportAndFeedback: dedent_default`
+    If the user would like to provide Wix with some feedback (good or bad), about the tools in Wix MCP,
+    for example they used the tools provided, and they reflected satisfaction or dissatisfaction with the tools.
+    Also, if you encounter too many errors tyring to call the Wix API, you can also suggest the user to provide feedback to Wix using this tool.
+    **IMPORTANT NOTE**
+    This tool is not sending the message, but formats it in order to another tool to actually send it
+  `
+};
+var defaultReadmeDocs = [
   {
-    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/get-to-know-wix-llm-instructions",
-    action: "include"
+    action: "text",
+    content: dedent_default`
+      <system>
+      
+      The main goal of the WixREADME tool is to help you manage your Wix business by making API calls to the Wix API.
+      
+      A common flow would be:
+      1. User asks you to do something,
+      2. You use the "WixREADME" tool to get the context,
+      3. You find a relevant recipe in the recipes index,
+      4. You use the "ReadFullDocsArticle" tool to get the full recipe,
+      5. You use the "CallWixSiteAPI" tool to call the API (No need to search or read the full schema, just call the API according to the recipe)
+      
+      Another flow would be:
+      1. User asks you to do something,
+      2. You use the "WixREADME" tool to get the context,
+      3. You do not find a relevant recipe in the recipes index,
+      4. You use the "SearchWixRESTDocumentation" tool to search for the API you should invoke,
+      5. You read the relevant articles using the "ReadFullDocsArticle" tool,
+      6. You find a relevant code example in the articles,
+      7. You use the "CallWixSiteAPI" tool to call the API. (No need to read the full schema, just call the API according to the code example)
+
+      Fallback flow (No relevant recipe or code example found, or you failed using the other flows):
+      1. User asks you to do something,
+      2. You use the "WixREADME" tool to get the context,
+      3. You do not find a relevant recipe in the recipes index,
+      4. You use the "SearchWixRESTDocumentation" tool to search for the API you should invoke,
+      5. You read the relevant articles using the "ReadFullDocsArticle" tool,
+      6. You do not find a relevant code example in the articles,
+      7. You use the "ReadFullDocsMethodSchema" tool to get the full method schema,
+      8. You use the "CallWixSiteAPI" tool to call the API. (No need to search or read the full schema, just call the API according to the method schema)
+      </system>
+    `
   },
   {
-    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-concepts",
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/recipes-v2/manage/management-recipes-index",
     action: "include"
   },
   {
     url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-business-solutions",
     action: "index",
     title: "Wix Business Solutions",
-    description: `This document provides an overview of the all business solutions available in Wix.
-  
-Use this document under the following scenarios:
-1. The user asks general questions about Wix business solutions.
-2. The user asks about a specific business solution, and you want to provide a high-level overview of it.
-3. The user looks for a specific business solution, and you want to provide a list of all available solutions.
-
-Please note that this is a large document. Only use it for the scenarios mentioned above.`
-  },
-  {
-    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-business-solutions-recipes",
-    action: "include"
+    description: dedent_default`
+      This document provides an overview of the all business solutions available in Wix.
+
+      Use this document under the following scenarios:
+      1. The user asks general questions about Wix business solutions.
+      2. The user asks about a specific business solution, and you want to provide a high-level overview of it.
+      3. The user looks for a specific business solution, and you want to provide a list of all available solutions.
+
+      Please note that this is a large document. Only use it for the scenarios mentioned above.
+    `
   }
 ];
-var DESCRIPTION = `# Tool: WixREADME
-
-**Directive:** \`WixREADME\` is the **MANDATORY FIRST STEP** for all Wix-related tasks EXCEPT when the user explicitly asks to build/create a site - in which case you should use the \`WixSiteBuilderWidget\` tool directly. Its output (including relevant linked documents) provides foundational context for all other Wix tools. Adherence to this protocol is **NON-NEGOTIABLE**.
-
-**Operational Protocol (Strictly Sequential):**
-
-1.  **Execute \`WixREADME\`:**
-    * **Action:** Invoke \`WixREADME\`.
-    * **Constraint:** MUST complete successfully. NO other Wix tool before this.
-
-2.  **Process \`WixREADME\` Output (Link Identification & Relevance Assessment):**
-    * **A. Identify Candidate Links:** Scan \`WixREADME\` output. Extract *only* URLs found within \`<urls>{urls}</urls>\` tags. Ignore all other URLs.
-    * **B. Assess Relevance:** For EACH candidate URL from (A), assess its relevance to the **current user's specific prompt/task**.
-    * **Outcome:** A list of *relevant* document URLs. If no links are found in \`<urls>\` tags or none are deemed relevant, note this and proceed to Step 4.
-
-3.  **Fetch Relevant Documents (via \`ReadFullDocsArticle\`):**
-    * **Condition:** ONLY if Step 2B identified one or more *relevant* URLs.
-    * **Action:** For EACH *relevant* URL, invoke \`ReadFullDocsArticle\` to fetch its full content.
-    * **Constraint:** All *relevant* documents MUST be fetched before Step 4.
-
-4.  **Proceed with Other Wix Tools:**
-    * **Condition:** ONLY after completing Steps 1, 2, and 3 (if Step 3 was applicable).
-    * **Action:** Use other Wix tools as needed, utilizing the full context from \`WixREADME\` and fetched relevant documents.
-
-**Summary of Critical Rules:**
-* \`WixREADME\` is **ALWAYS FIRST**.
-* Analyze \`WixREADME\` output: Extract links *only* from \`<urls>{urls}</urls>\` tags.
-* Assess relevance of *each* extracted link against the user's current task.
-* Fetch **ONLY RELEVANT** linked documents using \`ReadFullDocsArticle\` before any other Wix tool.
-* **FAILURE TO FOLLOW THIS EXACT SEQUENCE WILL LEAD TO ERRORS.** Strict adherence is mandatory.`;
-var WixREADME_DEPENDENT_DESCRIPTION = "**Dependency:** Must be used after 'WixREADME' has successfully run.";
-async function addGetToKnowTools(server2, disableTools = [], toolDescriptions, readmeDocs) {
+
+// src/docs/get-to-know.ts
+async function addGetToKnowTools(server2, disableTools = [], toolDescriptions, readmeDocs, authStrategy, picassoPortalUrl) {
   if (disableTools.includes("WixREADME")) {
     return;
   }
-  const docsToUse = readmeDocs && readmeDocs.length > 0 ? readmeDocs : DEFAULT_DOC_URLS;
+  const docsToUse = readmeDocs ?? defaultReadmeDocs;
   server2.tool(
     "WixREADME",
-    toolDescriptions?.["WixREADME"] ?? DESCRIPTION,
+    toolDescriptions?.["WixREADME"] ?? defaultToolDescriptions.WixREADME,
     {},
     { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
     async (_, { httpClient }) => {
-      try {
-        const contents = await Promise.all(
-          docsToUse.map(async ({ url, action, description, title }) => {
-            if (action === "index") {
-              return {
-                type: "text",
-                text: `## ${title}
+      const contents = await Promise.all(
+        docsToUse.map(
+          async ({
+            url,
+            action,
+            description,
+            title,
+            content,
+            method,
+            body
+          }) => {
+            try {
+              if (action === "index") {
+                return {
+                  type: "text",
+                  text: `## ${title}
 
 <urls>
 ${url}
 </urls>
 
 ${description ?? ""}`
+                };
+              }
+              if (action === "text") {
+                const textContent = title ? `## ${title}
+
+${content ?? ""}` : content ?? "";
+                return {
+                  type: "text",
+                  text: textContent
+                };
+              }
+              if (action === "api") {
+                if (!url) {
+                  throw new Error('URL is required for "api" action');
+                }
+                if (!authStrategy) {
+                  throw new Error(
+                    'Authentication strategy is required for "api" action. The "api" action cannot be used without proper authentication configuration.'
+                  );
+                }
+                const httpMethod = method ?? "GET";
+                const accountHeaders = await authStrategy.getAccountAuthHeaders();
+                const response = await httpClient.request({
+                  url,
+                  method: httpMethod,
+                  headers: {
+                    ...accountHeaders,
+                    ...body ? { "Content-Type": "application/json" } : {}
+                  },
+                  data: httpMethod === "GET" ? void 0 : body
+                });
+                const responseText = typeof response.data === "string" ? response.data : JSON.stringify(response.data, null, 2);
+                const textContent = title ? `## ${title}
+
+${responseText}` : responseText;
+                return {
+                  type: "text",
+                  text: textContent
+                };
+              }
+              if (!url) {
+                throw new Error('URL is required for "include" action');
+              }
+              const fetchedContent = await fetchArticleContent(
+                httpClient,
+                url,
+                "article",
+                true,
+                picassoPortalUrl
+              );
+              return {
+                type: "text",
+                text: fetchedContent
+              };
+            } catch (error) {
+              const errorMsg = error.message;
+              const identifier = title ?? url ?? action;
+              if (action === "api") {
+                console.error(
+                  `[WixREADME] API call failed for "${identifier}": ${errorMsg}`
+                );
+                return null;
+              }
+              return {
+                type: "text",
+                text: `## Error loading "${identifier}"
+
+Failed to fetch content: ${errorMsg}`
               };
             }
-            const content = await fetchArticleContent(
-              httpClient,
-              url,
-              "article",
-              true
-            );
-            return {
-              type: "text",
-              text: content
-            };
-          })
-        );
-        return {
-          content: contents
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [
-            {
-              type: "text",
-              text: `Error fetching the document: ${error.message}`
-            }
-          ]
-        };
-      }
+          }
+        )
+      );
+      const filteredContents = contents.filter(
+        (item) => item !== null
+      );
+      const concatenatedText = filteredContents.map((item) => item.text).join("\n\n");
+      return {
+        content: [{ type: "text", text: concatenatedText }]
+      };
     }
   );
 }
@@ -10699,11 +10975,20 @@ var addDocsTools = (server2, allowedTools = [
     createWixBusinessGuideEnabled = true,
     disableTools,
     toolDescriptions,
-    readmeDocs
+    readmeDocs,
+    authStrategy,
+    picassoPortalUrl
   } = options;
   const getDescription = (toolName, defaultDesc) => toolDescriptions?.[toolName] ?? defaultDesc;
   if (getToKnowWixEnabled && !disableTools?.includes("WixREADME")) {
-    addGetToKnowTools(server2, disableTools || [], toolDescriptions, readmeDocs);
+    addGetToKnowTools(
+      server2,
+      disableTools || [],
+      toolDescriptions,
+      readmeDocs,
+      authStrategy,
+      picassoPortalUrl
+    );
   }
   if (createWixBusinessGuideEnabled && !disableTools?.includes("CreateWixBusinessGuide")) {
     addCreateWixBusinessGuideTools(
@@ -10713,16 +10998,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (allowedTools.includes("WDS") && !disableTools?.includes("SearchWixWDSDocumentation")) {
-    const defaultWdsDesc = [
-      "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.",
-      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
-    ].join("\n");
     server2.tool(
       "SearchWixWDSDocumentation",
-      getDescription("SearchWixWDSDocumentation", defaultWdsDesc),
+      getDescription(
+        "SearchWixWDSDocumentation",
+        defaultToolDescriptions.SearchWixWDSDocumentation ?? ""
+      ),
       {
         searchTerm: z.string().describe(
           "The search term to search for in the Wix Design System Documentation"
@@ -10770,16 +11051,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (allowedTools.includes("REST") && !disableTools?.includes("SearchWixRESTDocumentation")) {
-    const defaultRestDesc = [
-      "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.",
-      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
-    ].join("\n");
     server2.tool(
       "SearchWixRESTDocumentation",
-      getDescription("SearchWixRESTDocumentation", defaultRestDesc),
+      getDescription(
+        "SearchWixRESTDocumentation",
+        defaultToolDescriptions.SearchWixRESTDocumentation
+      ),
       {
         searchTerm: z.string().describe(
           "The search term to search for in the Wix REST API Documentation"
@@ -10805,10 +11082,6 @@ var addDocsTools = (server2, allowedTools = [
               {
                 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."
               }
             ]
           };
@@ -10832,19 +11105,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (allowedTools.includes("BUSINESS_SOLUTIONS") && !getToKnowWixEnabled && !disableTools?.includes("WixBusinessFlowsDocumentation")) {
-    const defaultBusinessDesc = [
-      "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");
     server2.tool(
       "WixBusinessFlowsDocumentation",
-      getDescription("WixBusinessFlowsDocumentation", defaultBusinessDesc),
+      getDescription(
+        "WixBusinessFlowsDocumentation",
+        defaultToolDescriptions.WixBusinessFlowsDocumentation ?? ""
+      ),
       {
         searchTerm: z.string().describe(
           'The search term for the required sample flow (e.g. "setup a new business")'
@@ -10868,11 +11134,10 @@ var addDocsTools = (server2, allowedTools = [
             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.`
+                text: [
+                  result,
+                  `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.`
+                ].join("\n\n")
               }
             ]
           };
@@ -10896,16 +11161,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (allowedTools.includes("SDK") && !disableTools?.includes("SearchWixSDKDocumentation")) {
-    const defaultSdkDesc = [
-      "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.",
-      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
-    ].join("\n");
     server2.tool(
       "SearchWixSDKDocumentation",
-      getDescription("SearchWixSDKDocumentation", defaultSdkDesc),
+      getDescription(
+        "SearchWixSDKDocumentation",
+        defaultToolDescriptions.SearchWixSDKDocumentation ?? ""
+      ),
       {
         searchTerm: z.string().describe(
           "The search term to search for in the Wix SDK Documentation"
@@ -10932,11 +11193,10 @@ var addDocsTools = (server2, allowedTools = [
             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."
+                text: [
+                  result,
+                  "you should use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method."
+                ].join("\n---\n")
               }
             ]
           };
@@ -10960,16 +11220,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (allowedTools.includes("BUILD_APPS") && !disableTools?.includes("SearchBuildAppsDocumentation")) {
-    const defaultBuildAppsDesc = [
-      "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.",
-      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
-    ].join("\n");
     server2.tool(
       "SearchBuildAppsDocumentation",
-      getDescription("SearchBuildAppsDocumentation", defaultBuildAppsDesc),
+      getDescription(
+        "SearchBuildAppsDocumentation",
+        defaultToolDescriptions.SearchBuildAppsDocumentation ?? ""
+      ),
       {
         searchTerm: z.string().describe(
           "The search term to search for in the Build Apps Documentation"
@@ -11016,16 +11272,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (allowedTools.includes("WIX_HEADLESS") && !disableTools?.includes("SearchWixHeadlessDocumentation")) {
-    const defaultHeadlessDesc = [
-      "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.",
-      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
-    ].join("\n");
     server2.tool(
       "SearchWixHeadlessDocumentation",
-      getDescription("SearchWixHeadlessDocumentation", defaultHeadlessDesc),
+      getDescription(
+        "SearchWixHeadlessDocumentation",
+        defaultToolDescriptions.SearchWixHeadlessDocumentation ?? ""
+      ),
       {
         searchTerm: z.string().describe(
           "The search term to search for in the Headless Documentation"
@@ -11072,16 +11324,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (allowedTools.includes("VELO") && !disableTools?.includes("SearchWixVeloDocumentation")) {
-    const defaultVeloDesc = [
-      "Searches the official Velo documentation.",
-      "Use this tool when you need to understand or implement Velo related code.",
-      "The search term should be a specific Velo 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.",
-      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
-    ].join("\n");
     server2.tool(
       "SearchWixVeloDocumentation",
-      getDescription("SearchWixVeloDocumentation", defaultVeloDesc),
+      getDescription(
+        "SearchWixVeloDocumentation",
+        defaultToolDescriptions.SearchWixVeloDocumentation ?? ""
+      ),
       {
         searchTerm: z.string().describe("The search term to search for in the Velo Documentation"),
         maxResults: z.number().describe(
@@ -11106,11 +11354,10 @@ var addDocsTools = (server2, allowedTools = [
             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."
+                text: [
+                  result,
+                  "you should use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method."
+                ].join("\n---\n")
               }
             ]
           };
@@ -11132,14 +11379,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (!disableTools?.includes("ReadFullDocsArticle")) {
-    const defaultReadArticleDesc = [
-      "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.",
-      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
-    ].join("\n");
     server2.tool(
       "ReadFullDocsArticle",
-      getDescription("ReadFullDocsArticle", defaultReadArticleDesc),
+      getDescription(
+        "ReadFullDocsArticle",
+        defaultToolDescriptions.ReadFullDocsArticle
+      ),
       {
         articleUrl: z.string().url().describe(
           "The URL of the docs article or method article to fetch. Should be something like https://dev.wix.com/docs/.../.../..."
@@ -11151,7 +11396,9 @@ var addDocsTools = (server2, allowedTools = [
           const articleContent = await fetchArticleContent(
             httpClient,
             articleUrl,
-            "article"
+            "article",
+            false,
+            picassoPortalUrl
           );
           if (!articleContent) {
             throw new Error("Article content is empty");
@@ -11161,13 +11408,6 @@ var addDocsTools = (server2, allowedTools = [
               {
                 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")
               }
             ]
           };
@@ -11188,13 +11428,12 @@ var addDocsTools = (server2, allowedTools = [
     );
   }
   if (!disableTools?.includes("ReadFullDocsMethodSchema")) {
-    const defaultMethodSchemaDesc = [
-      "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");
     server2.tool(
       "ReadFullDocsMethodSchema",
-      getDescription("ReadFullDocsMethodSchema", defaultMethodSchemaDesc),
+      getDescription(
+        "ReadFullDocsMethodSchema",
+        defaultToolDescriptions.ReadFullDocsMethodSchema
+      ),
       {
         articleUrl: z.string().url().describe(
           "The URL of the documentation to fetch. Should be something like https://dev.wix.com/docs/.../.../..."
@@ -11206,7 +11445,9 @@ var addDocsTools = (server2, allowedTools = [
           const articleContent = await fetchArticleContent(
             httpClient,
             articleUrl,
-            "methodSchema"
+            "methodSchema",
+            false,
+            picassoPortalUrl
           );
           if (!articleContent) {
             throw new Error("Method schema is empty");
@@ -11356,8 +11597,10 @@ function addCliTools(server2, allowedTools = ["CLI_COMMAND"], isWixOne2 = false)
           logger.log(`RunWixCliCommand: stderr: ${stderr}`);
           return {
             content: [
-              { type: "text", text: stdout },
-              ...stderr ? [{ type: "text", text: `Error: ${stderr}` }] : []
+              {
+                type: "text",
+                text: stderr ? [stdout, `Error: ${stderr}`].join("\n\n") : stdout
+              }
             ]
           };
         } catch (error) {
@@ -11474,6 +11717,14 @@ var WixMcpServer = class extends McpServer {
   setClientNameGetter(getClientName) {
     this.getClientName = getClientName;
   }
+  getWidgetExtras() {
+    return {
+      biContext: {
+        userId: this.getUserId?.() ?? "",
+        sessionId: this.sessionId
+      }
+    };
+  }
   tool(...args) {
     const cbIndex = args.findIndex((arg) => typeof arg === "function");
     if (cbIndex !== -1) {
@@ -11656,7 +11907,7 @@ var addDocsResources = async (server2, portals) => {
 
 // src/api-call/index.ts
 var import_http_client2 = __toESM(require_index_node2(), 1);
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 
 // src/tool-utils.ts
 var safeParseJSON = (text) => {
@@ -11697,6 +11948,13 @@ var handleWixAPIResponse = async (response) => {
 };
 
 // src/api-call/validation.ts
+var ALLOWED_HOSTNAMES = [
+  "wix.com",
+  "dev.wix.com",
+  "manage.wix.com",
+  "editor.wix.com",
+  "wixapis.com"
+];
 function isApiUrlAllowed(url) {
   let parsedUrl;
   try {
@@ -11707,13 +11965,6 @@ function isApiUrlAllowed(url) {
       error: `Invalid URL format: ${url}`
     };
   }
-  const ALLOWED_HOSTNAMES = [
-    "wix.com",
-    "dev.wix.com",
-    "manage.wix.com",
-    "editor.wix.com",
-    "wixapis.com"
-  ];
   const hostname = parsedUrl.hostname.replace("www.", "");
   const isAllowedHostname = ALLOWED_HOSTNAMES.some(
     (domain) => hostname === domain
@@ -11729,38 +11980,219 @@ function isApiUrlAllowed(url) {
   };
 }
 
+// src/api-call/upload-image-tool.ts
+import { z as z3 } from "zod";
+var TOOL_NAME = "UploadImageToWixSite";
+var POLL_TIMEOUT_MS = 1e4;
+var POLL_INTERVAL_MS = 1e3;
+async function waitForFileReady(httpClient, fileId, authHeaders, timeoutMs = POLL_TIMEOUT_MS) {
+  const startTime = Date.now();
+  while (Date.now() - startTime < timeoutMs) {
+    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    try {
+      const response = await httpClient.get(
+        `https://www.wixapis.com/site-media/v1/files/get-file-by-id?fileId=${encodeURIComponent(fileId)}`,
+        { headers: authHeaders }
+      );
+      const file = response.data?.file;
+      if (file && file.operationStatus !== "PENDING") {
+        return file;
+      }
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+function addUploadImageTool(server2, strategy, options) {
+  const description = options?.description ?? defaultToolDescriptions.UploadImageToWixSite;
+  const hints = {
+    readOnlyHint: options?.hints?.readOnlyHint ?? false,
+    destructiveHint: options?.hints?.destructiveHint ?? false,
+    openWorldHint: options?.hints?.openWorldHint ?? false
+  };
+  server2.registerTool(
+    TOOL_NAME,
+    {
+      title: "Upload Image to Wix Site",
+      description,
+      inputSchema: {
+        siteId: z3.string().describe("The ID of the Wix site to upload to"),
+        image: z3.object({
+          download_url: z3.string().url(),
+          file_id: z3.string()
+        }).describe("The image file provided by the user"),
+        displayName: z3.string().optional().describe(
+          "Optional display name for the file in Media Manager. If not provided, uses the original filename."
+        )
+      },
+      _meta: {
+        "openai/fileParams": ["image"],
+        "openai/toolInvocation/invoking": "Uploading image to Wix Media Manager...",
+        "openai/toolInvocation/invoked": "Image uploaded successfully"
+      },
+      annotations: hints
+    },
+    async ({
+      siteId,
+      image,
+      displayName
+    }, { httpClient, setToolBiParams }) => {
+      logger.log(
+        `Uploading image to Wix site: ${siteId}, file_id: ${image.file_id}`
+      );
+      setToolBiParams({ siteId });
+      try {
+        const importResponse = await httpClient.post(
+          "https://www.wixapis.com/site-media/v1/files/import",
+          {
+            url: image.download_url,
+            ...displayName ? { displayName } : {}
+          },
+          {
+            headers: {
+              ...await strategy.getSiteAuthHeaders(siteId),
+              "Content-Type": "application/json"
+            }
+          }
+        );
+        let file = importResponse.data?.file;
+        if (!file) {
+          return {
+            isError: true,
+            content: [
+              {
+                type: "text",
+                text: "Failed to upload image: No file returned from Wix API"
+              }
+            ]
+          };
+        }
+        if (file.operationStatus === "PENDING") {
+          const authHeaders = await strategy.getSiteAuthHeaders(siteId);
+          const updatedFile = await waitForFileReady(
+            httpClient,
+            file.id,
+            authHeaders
+          );
+          if (updatedFile) {
+            file = updatedFile;
+          }
+        }
+        const result = {
+          id: file.id,
+          displayName: file.displayName,
+          url: file.url,
+          operationStatus: file.operationStatus,
+          mediaType: file.mediaType,
+          sourceUrl: file.sourceUrl,
+          ...file.media?.image?.image ? {
+            width: file.media.image.image.width,
+            height: file.media.image.image.height
+          } : {}
+        };
+        logger.log(`Image uploaded successfully: ${JSON.stringify(result)}`);
+        let responseText = `Image uploaded successfully!
+
+`;
+        responseText += `**Media ID:** ${result.id}
+`;
+        responseText += `**URL:** ${result.url}
+`;
+        responseText += `**Status:** ${result.operationStatus}
+`;
+        if (result.width && result.height) {
+          responseText += `**Dimensions:** ${result.width}x${result.height}
+`;
+        }
+        if (result.operationStatus === "PENDING") {
+          responseText += `
+**Note:** The file is still being processed (timeout reached). `;
+          responseText += `You can use the URL immediately, but some operations may require waiting for status to become READY.`;
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: responseText
+            }
+          ],
+          structuredContent: result
+        };
+      } catch (error) {
+        const errorMessage = `Failed to upload image to Wix: ${error}`;
+        logger.error(errorMessage);
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: errorMessage
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+
 // src/api-call/index.ts
-function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "ListWixSites", "ManageWixSite"], disableTools = [], toolDescriptions) {
+var MAX_RESPONSE_SIZE = 5e4;
+function formatApiResponse(responseData) {
+  if (typeof responseData === "string" && responseData.trim().startsWith("<!DOCTYPE")) {
+    return {
+      text: "Error: API returned HTML instead of JSON. This usually means the URL is incorrect or points to a web page instead of an API endpoint. Please verify the URL.",
+      isError: true
+    };
+  }
+  let responseText = JSON.stringify(responseData);
+  if (responseText.length > MAX_RESPONSE_SIZE) {
+    responseText = responseText.slice(0, MAX_RESPONSE_SIZE) + `
+...[TRUNCATED - response was ${responseText.length} chars, showing first ${MAX_RESPONSE_SIZE}]`;
+  }
+  return { text: responseText, isError: false };
+}
+function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "ListWixSites", "ManageWixSite"], disableTools = [], enableTools = [], toolDescriptions, toolHints) {
+  const effectiveAllowedTools = [
+    .../* @__PURE__ */ new Set([...allowedTools, ...enableTools])
+  ].filter((tool) => !disableTools.includes(tool));
+  const getHints = (toolName, defaults) => ({
+    readOnlyHint: toolHints?.[toolName]?.readOnlyHint ?? defaults.readOnlyHint,
+    destructiveHint: toolHints?.[toolName]?.destructiveHint ?? defaults.destructiveHint,
+    openWorldHint: toolHints?.[toolName]?.openWorldHint ?? defaults.openWorldHint
+  });
   const getDescription = (toolName, defaultDesc) => toolDescriptions?.[toolName] ?? defaultDesc;
-  if (allowedTools.includes("CallWixSiteAPI") && !disableTools.includes("CallWixSiteAPI")) {
-    const defaultCallApiDesc = [
-      "Call Wix apis on a business or site. Use this to create, read, update, and delete data and other Wix entities in your Wix site,",
-      `You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`,
-      "Error Handling:",
-      'If the error is related to missing installed app or "WDE0110: Wix Code not enabled", you should install the missing app by using ReadFullDocsArticle tool to fetch the article - https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_wix.devcenter.apps.installer.v1.AppsInstallerService.InstallApp',
-      "**Note:** there is no need to check if an app is installed/ Wix Code enabled in advance, just call the API and handle the error if it occurs, the API error message will state it clearly.",
-      "For any other error, use your default error handling mechanism"
-    ].join("\n");
+  if (effectiveAllowedTools.includes("CallWixSiteAPI") && !disableTools.includes("CallWixSiteAPI")) {
     server2.tool(
       "CallWixSiteAPI",
-      getDescription("CallWixSiteAPI", defaultCallApiDesc),
+      getDescription("CallWixSiteAPI", defaultToolDescriptions.CallWixSiteAPI),
       {
-        siteId: z3.string().describe("The id of the site selected using site selection tool"),
-        url: z3.string().url().describe(
-          "The url of the api to call - ALWAYS get the information from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL"
+        siteId: z4.string().describe("The id of the site selected using site selection tool"),
+        url: z4.string().url().describe(
+          [
+            "The url of the api to call - ALWAYS get the API url from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL",
+            'NEVER guess the API url, ALWAYS get it from the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "ReadFullDocsArticle" tool',
+            `Allowed API urls are: ${ALLOWED_HOSTNAMES.join(", ")}`,
+            `Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool`
+          ].join("\n")
         ),
-        method: z3.string().describe(
+        method: z4.string().describe(
           "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)"
         ),
-        body: z3.string().optional().describe(
-          "A string representing of a valid JSON object to describe the body of the request"
+        body: z4.object({}).passthrough().optional().describe(
+          'The request body object. YOU MUST NEVER MAKE UP A BODY - this should be based on the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "ReadFullDocsArticle" tool or from the "ReadFullDocsMethodSchema" tool - i.e based on the API docs. YOU MUST NEVER ASSUME YOU KNOW WHAT THE SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT.'
         )
       },
-      { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+      getHints("CallWixSiteAPI", {
+        readOnlyHint: false,
+        destructiveHint: true,
+        openWorldHint: false
+      }),
       async ({ url, body, method, siteId }, { httpClient, setToolBiParams }) => {
-        logger.log(
-          `Calling Wix Site API: ${siteId} ${url}, body: ${JSON.stringify(body)}`
-        );
+        const requestHeaders = {
+          ...await strategy.getSiteAuthHeaders(siteId),
+          ...body ? { "Content-Type": "application/json" } : {}
+        };
         const { isAllowed, error: urlError } = isApiUrlAllowed(url);
         if (!isAllowed) {
           return {
@@ -11777,20 +12209,29 @@ function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "Li
           const response = await httpClient.request({
             url,
             method,
-            headers: {
-              ...await strategy.getSiteAuthHeaders(siteId),
-              ...body ? { "Content-Type": "application/json" } : {}
-            },
+            headers: requestHeaders,
             data: method === "GET" ? void 0 : body
           });
           const requestId = response.headers?.["x-wix-request-id"];
           setToolBiParams({ requestId, siteId });
           const responseData = await handleWixAPIResponse(response);
+          const formatted = formatApiResponse(responseData);
+          if (formatted.isError) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: formatted.text
+                }
+              ],
+              isError: true
+            };
+          }
           return {
             content: [
               {
                 type: "text",
-                text: `Wix Site API call successful: ${JSON.stringify(responseData)}`
+                text: `Wix Site API call successful: ${formatted.text}`
               }
             ]
           };
@@ -11800,9 +12241,9 @@ function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "Li
             requestId = error.requestId;
           }
           setToolBiParams({ requestId, siteId });
+          const response = error.response;
           const errorMessage = `Failed to call Wix Site API: ${error}. ${requestId ? `Request ID: ${requestId}` : ""}`;
           logger.error(errorMessage);
-          const response = error.response;
           if (!response) {
             throw new Error(errorMessage);
           }
@@ -11811,19 +12252,22 @@ function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "Li
       }
     );
   }
-  if (allowedTools.includes("ListWixSites") && !disableTools.includes("ListWixSites")) {
-    const defaultListSitesDesc = "List Wix sites for the current user, by default it will return all sites, but you can filter by name";
+  if (effectiveAllowedTools.includes("ListWixSites") && !disableTools.includes("ListWixSites")) {
     server2.tool(
       "ListWixSites",
-      getDescription("ListWixSites", defaultListSitesDesc),
+      getDescription("ListWixSites", defaultToolDescriptions.ListWixSites),
       {
-        nameSearch: z3.string().optional().describe(
+        nameSearch: z4.string().optional().describe(
           "optional filer by name, if not provided all sites will be returned"
         ),
         // Hack for Cursor ignoring tools with no params (when nameSearch is optional)
-        alwaysTrue: z3.boolean().describe("Always pass true to this parameter")
+        alwaysTrue: z4.boolean().describe("Always pass true to this parameter")
       },
-      { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+      getHints("ListWixSites", {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      }),
       async ({ nameSearch }, { httpClient }) => {
         const sitesRes = await httpClient.post(
           "https://www.wixapis.com/site-list/v2/sites/query",
@@ -11856,36 +12300,36 @@ function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "Li
           content: [
             {
               type: "text",
-              text: JSON.stringify(result)
-            },
-            {
-              type: "text",
-              text: "if there is more than one site returned, the user should pick one from a list, list the sites (only name) for the user and ask them to pick one,If more than 20 are found you should list all 20 and suggest to search by the name of the site they are looking for"
+              text: [
+                JSON.stringify(result),
+                "if there is more than one site returned, the user should pick one from a list, list the sites (only name) for the user and ask them to pick one, If more than 20 are found you should list all 20 and suggest to search by the name of the site they are looking for"
+              ].join("\n\n")
             }
           ]
         };
       }
     );
   }
-  if (allowedTools.includes("ManageWixSite") && !disableTools.includes("ManageWixSite")) {
-    const defaultManageSiteDesc = `Use account level API in order to create a site, update a site and publish site.
-    ALWAYS use "SearchWixRESTDocumentation" to search for the API you should invoke, NEVER GUESS THE SITE API URL
-    You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`;
+  if (effectiveAllowedTools.includes("ManageWixSite") && !disableTools.includes("ManageWixSite")) {
     server2.tool(
       "ManageWixSite",
-      getDescription("ManageWixSite", defaultManageSiteDesc),
+      getDescription("ManageWixSite", defaultToolDescriptions.ManageWixSite),
       {
-        url: z3.string().url().describe(
+        url: z4.string().url().describe(
           "The url of the api to call - ALWAYS get the information from the Wix REST docs DONT GUESS IT, the URL MUST BE ABSOLUTE URL"
         ),
-        method: z3.string().describe(
+        method: z4.string().describe(
           "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)"
         ),
-        body: z3.string().optional().describe(
-          "A string representing of a valid JSON object to describe the body of the request"
+        body: z4.object({}).passthrough().optional().describe(
+          'The request body object. YOU MUST NEVER MAKE UP A BODY - this should be based on the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "ReadFullDocsArticle" tool or from the "ReadFullDocsMethodSchema" tool - i.e based on the API docs. YOU MUST NEVER ASSUME YOU KNOW WHAT THE SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT.'
         )
       },
-      { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+      getHints("ManageWixSite", {
+        readOnlyHint: false,
+        destructiveHint: true,
+        openWorldHint: false
+      }),
       async ({ url, body, method }, { httpClient }) => {
         logger.log(
           `Calling Wix Account level API: ${url}, body: ${JSON.stringify(body)}`
@@ -11913,11 +12357,23 @@ function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "Li
             data: method === "GET" ? void 0 : body
           });
           const responseData = await handleWixAPIResponse(response);
+          const formatted = formatApiResponse(responseData);
+          if (formatted.isError) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: formatted.text
+                }
+              ],
+              isError: true
+            };
+          }
           return {
             content: [
               {
                 type: "text",
-                text: `Wix Account API call successful: ${JSON.stringify(responseData)}`
+                text: `Wix Account API call successful: ${formatted.text}`
               }
             ]
           };
@@ -11932,6 +12388,12 @@ function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "Li
       }
     );
   }
+  if (effectiveAllowedTools.includes("UploadImageToWixSite") && !disableTools.includes("UploadImageToWixSite")) {
+    addUploadImageTool(server2, strategy, {
+      description: getDescription("UploadImageToWixSite", ""),
+      hints: toolHints?.["UploadImageToWixSite"]
+    });
+  }
 }
 
 // src/docs/velo-readme.ts