@wix/mcp 1.0.74 → 1.0.76

package/build/cjs/index.cjs

@@ -36336,26 +36336,54 @@ var getTruncatedResultHint = ({
   ].join("\n");
 };
 var SECTION_DELIMITER_RE = /^--- .+ ---$/;
-var SECTION_LINE_LIMITS = {
+var SECTION_LINE_FLOORS = {
   first_example: 15,
   response_shape: 15,
   description: 15,
   other: 5
 };
+var CODE_FENCE_RE = /^(`{3,}|~{3,})/;
+var findOpenFence = (lines) => {
+  let openFence = null;
+  for (const line of lines) {
+    const match = line.match(CODE_FENCE_RE);
+    if (match) {
+      if (!openFence) {
+        openFence = match[1];
+      } else if (line.trim() === openFence) {
+        openFence = null;
+      }
+    }
+  }
+  return openFence;
+};
+var INCOMPLETE_SNIPPET_MARKER = "... snippet cut here \u2014 INCOMPLETE example, do not use as-is; read the full doc for the complete example ...";
+var truncateLines = (lines, limit) => {
+  const kept = lines.slice(0, limit);
+  const moreCount = lines.length - kept.length;
+  const openFence = findOpenFence(kept);
+  if (!openFence) return { lines: kept, moreCount };
+  return {
+    lines: moreCount > 0 ? [...kept, INCOMPLETE_SNIPPET_MARKER, openFence] : [...kept, openFence],
+    moreCount
+  };
+};
 var getSectionType = (header, isFirstExample) => {
   if (isFirstExample && /code example/i.test(header)) return "first_example";
   if (/response shape/i.test(header)) return "response_shape";
   if (/description/i.test(header)) return "description";
   return "other";
 };
-var formatMethodContent = (content, sourceUrl, fallbackLineLimit) => {
+var formatMethodContent = (content, sourceUrl, requestedLineLimit) => {
   const lines = content.split("\n");
   const firstDelimiterIdx = lines.findIndex(
     (line) => SECTION_DELIMITER_RE.test(line)
   );
   if (firstDelimiterIdx === -1) {
-    const truncated = lines.slice(0, fallbackLineLimit);
-    const moreCount = lines.length - truncated.length;
+    const { lines: truncated, moreCount } = truncateLines(
+      lines,
+      requestedLineLimit
+    );
     const hint2 = sourceUrl ? ["", ...methodHintLines(sourceUrl)].join("\n") : "";
     const suffix = moreCount > 0 ? `
 
@@ -36373,9 +36401,8 @@ var formatMethodContent = (content, sourceUrl, fallbackLineLimit) => {
     if (!currentHeader) return;
     const type = getSectionType(currentHeader, isFirstExample);
     if (type === "first_example") isFirstExample = false;
-    const limit = SECTION_LINE_LIMITS[type];
-    const truncated = currentLines.slice(0, limit);
-    const moreCount = currentLines.length - truncated.length;
+    const limit = Math.max(SECTION_LINE_FLOORS[type], requestedLineLimit);
+    const { lines: truncated, moreCount } = truncateLines(currentLines, limit);
     let out = currentHeader + "\n" + truncated.join("\n");
     if (moreCount > 0) {
       out += `
@@ -36422,21 +36449,21 @@ var formatResultsContent = (resultsFromKbs, maxResults, linesInEachResult = void
           linesInEachResult
         );
       } else {
-        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 ? [
+        const { lines: truncated, moreCount } = truncateLines(
+          newContent.split("\n"),
+          linesInEachResult
+        );
+        const moreLinesText = moreCount > 0 ? [
           `
 
-... ${moreLines} more lines ...`,
+... ${moreCount} more lines ...`,
           getTruncatedResultHint({
             kbName: result.kbName,
             content: result.entry.content,
             url: sourceUrl
           })
         ].join("") : "";
-        newContent = `${newContent}${moreLinesText}`;
+        newContent = `${truncated.join("\n")}${moreLinesText}`;
       }
     }
     return {

package/build/cjs/toolkit.cjs

@@ -16067,26 +16067,54 @@ var getTruncatedResultHint = ({
   ].join("\n");
 };
 var SECTION_DELIMITER_RE = /^--- .+ ---$/;
-var SECTION_LINE_LIMITS = {
+var SECTION_LINE_FLOORS = {
   first_example: 15,
   response_shape: 15,
   description: 15,
   other: 5
 };
+var CODE_FENCE_RE = /^(`{3,}|~{3,})/;
+var findOpenFence = (lines) => {
+  let openFence = null;
+  for (const line of lines) {
+    const match = line.match(CODE_FENCE_RE);
+    if (match) {
+      if (!openFence) {
+        openFence = match[1];
+      } else if (line.trim() === openFence) {
+        openFence = null;
+      }
+    }
+  }
+  return openFence;
+};
+var INCOMPLETE_SNIPPET_MARKER = "... snippet cut here \u2014 INCOMPLETE example, do not use as-is; read the full doc for the complete example ...";
+var truncateLines = (lines, limit) => {
+  const kept = lines.slice(0, limit);
+  const moreCount = lines.length - kept.length;
+  const openFence = findOpenFence(kept);
+  if (!openFence) return { lines: kept, moreCount };
+  return {
+    lines: moreCount > 0 ? [...kept, INCOMPLETE_SNIPPET_MARKER, openFence] : [...kept, openFence],
+    moreCount
+  };
+};
 var getSectionType = (header, isFirstExample) => {
   if (isFirstExample && /code example/i.test(header)) return "first_example";
   if (/response shape/i.test(header)) return "response_shape";
   if (/description/i.test(header)) return "description";
   return "other";
 };
-var formatMethodContent = (content, sourceUrl, fallbackLineLimit) => {
+var formatMethodContent = (content, sourceUrl, requestedLineLimit) => {
   const lines = content.split("\n");
   const firstDelimiterIdx = lines.findIndex(
     (line) => SECTION_DELIMITER_RE.test(line)
   );
   if (firstDelimiterIdx === -1) {
-    const truncated = lines.slice(0, fallbackLineLimit);
-    const moreCount = lines.length - truncated.length;
+    const { lines: truncated, moreCount } = truncateLines(
+      lines,
+      requestedLineLimit
+    );
     const hint2 = sourceUrl ? ["", ...methodHintLines(sourceUrl)].join("\n") : "";
     const suffix = moreCount > 0 ? `
 
@@ -16104,9 +16132,8 @@ var formatMethodContent = (content, sourceUrl, fallbackLineLimit) => {
     if (!currentHeader) return;
     const type = getSectionType(currentHeader, isFirstExample);
     if (type === "first_example") isFirstExample = false;
-    const limit = SECTION_LINE_LIMITS[type];
-    const truncated = currentLines.slice(0, limit);
-    const moreCount = currentLines.length - truncated.length;
+    const limit = Math.max(SECTION_LINE_FLOORS[type], requestedLineLimit);
+    const { lines: truncated, moreCount } = truncateLines(currentLines, limit);
     let out = currentHeader + "\n" + truncated.join("\n");
     if (moreCount > 0) {
       out += `
@@ -16153,21 +16180,21 @@ var formatResultsContent = (resultsFromKbs, maxResults, linesInEachResult = void
           linesInEachResult
         );
       } else {
-        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 ? [
+        const { lines: truncated, moreCount } = truncateLines(
+          newContent.split("\n"),
+          linesInEachResult
+        );
+        const moreLinesText = moreCount > 0 ? [
           `
 
-... ${moreLines} more lines ...`,
+... ${moreCount} more lines ...`,
           getTruncatedResultHint({
             kbName: result.kbName,
             content: result.entry.content,
             url: sourceUrl
           })
         ].join("") : "";
-        newContent = `${newContent}${moreLinesText}`;
+        newContent = `${truncated.join("\n")}${moreLinesText}`;
       }
     }
     return {

package/build/dts/docs/searchFormatting.d.ts

@@ -17,6 +17,7 @@ export type RankedSearchResult = {
         overallMatchScore: number;
     };
 };
+export declare const INCOMPLETE_SNIPPET_MARKER = "... snippet cut here \u2014 INCOMPLETE example, do not use as-is; read the full doc for the complete example ...";
 export declare const formatResultsContent: (resultsFromKbs: Record<string, {
     results: Omit<RankedSearchResult, "kbName">[];
 }>, maxResults: number, linesInEachResult?: number | undefined) => string;

package/build/dts/docs/searchFormatting.js

@@ -77,12 +77,52 @@ const getTruncatedResultHint = ({ kbName, content, url }) => {
     ].join('\n');
 };
 const SECTION_DELIMITER_RE = /^--- .+ ---$/;
-const SECTION_LINE_LIMITS = {
+// Budget contract (mirrors docs-search-server's format-utils): each section
+// gets up to the caller's requested lines-per-result, but never less than its
+// floor — a tiny budget can't cut the one thing a section exists for, and a
+// larger budget exposes more of every section.
+const SECTION_LINE_FLOORS = {
     first_example: 15,
     response_shape: 15,
     description: 15,
     other: 5
 };
+const CODE_FENCE_RE = /^(`{3,}|~{3,})/;
+const findOpenFence = (lines) => {
+    let openFence = null;
+    for (const line of lines) {
+        const match = line.match(CODE_FENCE_RE);
+        if (match) {
+            if (!openFence) {
+                openFence = match[1];
+            }
+            else if (line.trim() === openFence) {
+                openFence = null;
+            }
+        }
+    }
+    return openFence;
+};
+// A fence left open by truncation means the snippet inside is NOT the complete
+// example — closing it silently produces a runnable-looking fragment with
+// required inputs missing. Say so inside the fence, where anyone copying the
+// block will see it.
+export const INCOMPLETE_SNIPPET_MARKER = '... snippet cut here — INCOMPLETE example, do not use as-is; read the full doc for the complete example ...';
+const truncateLines = (lines, limit) => {
+    const kept = lines.slice(0, limit);
+    const moreCount = lines.length - kept.length;
+    const openFence = findOpenFence(kept);
+    if (!openFence)
+        return { lines: kept, moreCount };
+    // moreCount > 0 means the cut landed inside the fence; otherwise the source
+    // itself left the fence open and it just needs closing.
+    return {
+        lines: moreCount > 0
+            ? [...kept, INCOMPLETE_SNIPPET_MARKER, openFence]
+            : [...kept, openFence],
+        moreCount
+    };
+};
 const getSectionType = (header, isFirstExample) => {
     if (isFirstExample && /code example/i.test(header))
         return 'first_example';
@@ -92,12 +132,11 @@ const getSectionType = (header, isFirstExample) => {
         return 'description';
     return 'other';
 };
-const formatMethodContent = (content, sourceUrl, fallbackLineLimit) => {
+const formatMethodContent = (content, sourceUrl, requestedLineLimit) => {
     const lines = content.split('\n');
     const firstDelimiterIdx = lines.findIndex((line) => SECTION_DELIMITER_RE.test(line));
     if (firstDelimiterIdx === -1) {
-        const truncated = lines.slice(0, fallbackLineLimit);
-        const moreCount = lines.length - truncated.length;
+        const { lines: truncated, moreCount } = truncateLines(lines, requestedLineLimit);
         const hint = sourceUrl
             ? ['', ...methodHintLines(sourceUrl)].join('\n')
             : '';
@@ -117,9 +156,8 @@ const formatMethodContent = (content, sourceUrl, fallbackLineLimit) => {
         const type = getSectionType(currentHeader, isFirstExample);
         if (type === 'first_example')
             isFirstExample = false;
-        const limit = SECTION_LINE_LIMITS[type];
-        const truncated = currentLines.slice(0, limit);
-        const moreCount = currentLines.length - truncated.length;
+        const limit = Math.max(SECTION_LINE_FLOORS[type], requestedLineLimit);
+        const { lines: truncated, moreCount } = truncateLines(currentLines, limit);
         let out = currentHeader + '\n' + truncated.join('\n');
         if (moreCount > 0) {
             out += `\n\n... ${moreCount} more lines ...`;
@@ -156,13 +194,10 @@ export const formatResultsContent = (resultsFromKbs, maxResults, linesInEachResu
                 newContent = formatMethodContent(newContent, sourceUrl, linesInEachResult);
             }
             else {
-                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
+                const { lines: truncated, moreCount } = truncateLines(newContent.split('\n'), linesInEachResult);
+                const moreLinesText = moreCount > 0
                     ? [
-                        `\n\n... ${moreLines} more lines ...`,
+                        `\n\n... ${moreCount} more lines ...`,
                         getTruncatedResultHint({
                             kbName: result.kbName,
                             content: result.entry.content,
@@ -170,7 +205,7 @@ export const formatResultsContent = (resultsFromKbs, maxResults, linesInEachResu
                         })
                     ].join('')
                     : '';
-                newContent = `${newContent}${moreLinesText}`;
+                newContent = `${truncated.join('\n')}${moreLinesText}`;
             }
         }
         return {

package/build/dts/index.d.ts

@@ -16,6 +16,7 @@ export type { Logger } from './infra/logger.js';
 export { attachConsoleLogger } from './infra/logger.js';
 export { createBiLogger } from './infra/bi-logger.js';
 export { createToolBiEvent, createExecuteWixAPICallToolBiEvent } from './infra/tool-bi.js';
+export type { WixToolCallResult, WixToolContentBlock, WixToolAnnotations } from './toolkit-types.js';
 export { createWixToolkit, extractText, type WixTool, type WixToolkit, type WixToolkitOptions, type WixToolkitHooks, type WixToolkitAuth, type WixToolkitDocsConfig, type WixToolkitApiConfig } from './toolkit.js';
 export { fetchRecipesIndex, fetchArticle, RECIPES_INDEX_URL } from './docs/fetch-article.js';
 export { generateDocsNavigationTree, fetchMenuContent, MENU_CONTENT_THRESHOLD, normalizeMenuContent, summarizeLargeMenu, parseDirectChildren } from './docs/normalize-menu-content.js';

package/build/dts/index.js

@@ -18,7 +18,6 @@ export { attachConsoleLogger } from './infra/logger.js';
 // logger defaults instead of wiring their own.
 export { createBiLogger } from './infra/bi-logger.js';
 export { createToolBiEvent, createExecuteWixAPICallToolBiEvent } from './infra/tool-bi.js';
-// Toolkit exports
 export { createWixToolkit, extractText } from './toolkit.js';
 // Docs fetch utilities
 export { fetchRecipesIndex, fetchArticle, RECIPES_INDEX_URL } from './docs/fetch-article.js';

package/build/dts/infra/tool-bi.d.ts

@@ -1,12 +1,12 @@
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { WixToolCallResult } from '../toolkit-types.js';
 import { wixMcpRequestSrc39Evid1607, executeWixApiToolRequestSrc39Evid1612 } from '@wix/bi-logger-api-infra-data/v2';
 /**
- * Safely extract all text content from a CallToolResult.
+ * Safely extract all text content from a WixToolCallResult.
  * Filters out non-text content blocks (images, audio, resources)
  * and concatenates text blocks with newlines.
  */
-export declare function extractText(result: CallToolResult): string;
-export declare function formatToolResultAdditionalFields(result: CallToolResult): string | undefined;
+export declare function extractText(result: WixToolCallResult): string;
+export declare function formatToolResultAdditionalFields(result: WixToolCallResult): string | undefined;
 export declare function createToolBiEvent(params: Parameters<typeof wixMcpRequestSrc39Evid1607>[0]): import("@wix/bi-logger-api-infra-data/v2/types").LogObject<import("@wix/bi-logger-api-infra-data/v2/types").wixMcpRequestSrc39Evid1607Params>;
 export declare function createExecuteWixAPICallToolBiEvent(params: Parameters<typeof executeWixApiToolRequestSrc39Evid1612>[0]): import("@wix/bi-logger-api-infra-data/v2/types").LogObject<import("@wix/bi-logger-api-infra-data/v2/types").executeWixApiToolRequestSrc39Evid1612Params>;
 //# sourceMappingURL=tool-bi.d.ts.map

package/build/dts/infra/tool-bi.js

@@ -1,6 +1,6 @@
 import { wixMcpRequestSrc39Evid1607, executeWixApiToolRequestSrc39Evid1612 } from '@wix/bi-logger-api-infra-data/v2';
 /**
- * Safely extract all text content from a CallToolResult.
+ * Safely extract all text content from a WixToolCallResult.
  * Filters out non-text content blocks (images, audio, resources)
  * and concatenates text blocks with newlines.
  */