@wix/ditto-codegen-public 1.0.210 → 1.0.211

package/dist/out.js

@@ -39046,6 +39046,35 @@ var require_generate_text_helpers = __commonJS({
   }
 });
 
+// ../codegen-common-logic/dist/extension-type-documentation.js
+var require_extension_type_documentation = __commonJS({
+  "../codegen-common-logic/dist/extension-type-documentation.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getExtensionTypeDocumentation = getExtensionTypeDocumentation;
+    var types_1 = require_types_impl();
+    var DashboardPageAgent_1 = require_DashboardPageAgent();
+    var SiteComponentAgent_1 = require_SiteComponentAgent();
+    var CustomElementAgent_1 = require_CustomElementAgent();
+    var SPIAgent_1 = require_SPIAgent();
+    var BackendEventAgent_1 = require_BackendEventAgent();
+    var BackendApiAgent_1 = require_BackendApiAgent();
+    var EmbeddedScriptAgent_1 = require_EmbeddedScriptAgent();
+    var EXTENSION_TYPE_TO_DOCUMENTATION = {
+      [types_1.ExtensionType.DASHBOARD_PAGE]: DashboardPageAgent_1.getDashboardPageAgentDocumentation,
+      [types_1.ExtensionType.SITE_COMPONENT]: SiteComponentAgent_1.getSiteComponentAgentDocumentation,
+      [types_1.ExtensionType.SITE_WIDGET]: CustomElementAgent_1.getCustomElementAgentDocumentation,
+      [types_1.ExtensionType.SERVICE_PLUGIN]: SPIAgent_1.getSPIAgentDocumentation,
+      [types_1.ExtensionType.BACKEND_EVENT]: BackendEventAgent_1.getBackendEventAgentDocumentation,
+      [types_1.ExtensionType.BACKEND_API]: BackendApiAgent_1.getBackendApiAgentDocumentation,
+      [types_1.ExtensionType.EMBEDDED_SCRIPT]: EmbeddedScriptAgent_1.getEmbeddedScriptAgentDocumentation
+    };
+    function getExtensionTypeDocumentation(type) {
+      return EXTENSION_TYPE_TO_DOCUMENTATION[type]();
+    }
+  }
+});
+
 // ../codegen-common-logic/dist/index.js
 var require_dist9 = __commonJS({
   "../codegen-common-logic/dist/index.js"(exports2) {
@@ -39086,6 +39115,7 @@ var require_dist9 = __commonJS({
     __exportStar2(require_system_prompts(), exports2);
     __exportStar2(require_sdkConfig(), exports2);
     __exportStar2(require_generate_text_helpers(), exports2);
+    __exportStar2(require_extension_type_documentation(), exports2);
   }
 });
 
@@ -94767,16 +94797,25 @@ var require_sdkEnricher = __commonJS({
   "../sdk-picker/dist/sdkEnricher.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.filterApisByScore = filterApisByScore;
     exports2.fetchDocumentationForApis = fetchDocumentationForApis;
     var MAX_APIS_PER_EXTENSION = 10;
     var MIN_API_SCORE = 50;
+    function filterApisByScore(apiResult) {
+      return {
+        extensions: apiResult.extensions.map((ext) => ({
+          id: ext.id,
+          relatedApis: (ext.relatedApis ?? []).filter((api) => api.score >= MIN_API_SCORE).sort((a, b) => b.score - a.score).slice(0, MAX_APIS_PER_EXTENSION)
+        }))
+      };
+    }
     async function fetchDocumentationForApis(apiResult, mcpClient) {
-      const enrichedExtensions = await Promise.all(apiResult.extensions.map(async (ext) => {
+      const filtered = filterApisByScore(apiResult);
+      const enrichedExtensions = await Promise.all(filtered.extensions.map(async (ext) => {
         if (!ext.relatedApis || ext.relatedApis.length === 0) {
           return { id: ext.id, relatedApis: [] };
         }
-        const topApis = ext.relatedApis.filter((api) => api.score > MIN_API_SCORE).sort((a, b) => b.score - a.score).slice(0, MAX_APIS_PER_EXTENSION);
-        const enrichedApis = await Promise.all(topApis.map((api) => fetchApiDocumentation(api, mcpClient)));
+        const enrichedApis = await Promise.all(ext.relatedApis.map((api) => fetchApiDocumentation(api, mcpClient)));
         return { id: ext.id, relatedApis: enrichedApis };
       }));
       return { extensions: enrichedExtensions };
@@ -94865,6 +94904,7 @@ Given an array of extensions (each with a unique ID):
 **When to Add relatedApis:**
 - **Only add relatedApis when the extension needs to interact with Wix platform data/services**
 - Extensions that need to query/modify Wix data (products, orders, collections, members, etc.) NEED relatedApis
+- For SERVICE_PLUGIN: usually just 1 SPI (the handler)
 
 **When NOT to Add relatedApis (leave empty array):**
 - **Simple code/text changes** - Changing strings, labels, titles in source code (e.g., "change title from X to Y")
@@ -94897,10 +94937,8 @@ Given an array of extensions (each with a unique ID):
 **Output Format:**
 - Return an array of objects with 'id' and 'relatedApis' fields
 - Each relatedApi must include: api (name), reason (why it's needed), score (0-100), and docsUrl (REQUIRED)
-- Use the exact IDs provided in the input (e.g., 'current-0', 'current-1', 'additional-0')
-- Only include extensions that need APIs
-- **The system will automatically select the top 10 highest-scoring APIs per extension**
-- **Suggest at least 5 relevant APIs per extension** (unless it's a pure UI/styling change)`;
+- Use the exact IDs provided in the input (e.g., 'ext-0', 'ext-1', 'current-0', 'additional-0')
+- Only include extensions that need APIs`;
     exports2.sdkPickerAgentCriticalRules = `**docsUrl Requirements:**
 - **NEVER use introduction/overview pages** - URLs ending in /introduction, /overview, /about are NOT useful for code generation
 - **ALWAYS provide specific method documentation URLs** that contain actual implementation details
@@ -94921,6 +94959,11 @@ Given an array of extensions (each with a unique ID):
   - \`data.items.bulkInsert\`, \`data.items.bulkUpdate\`
 - **Exception:** Only suggest collection creation if the use case EXPLICITLY requires dynamic collection creation at runtime
 
+**Service Plugins (SPIs) - BE MINIMAL:**
+- **For SERVICE_PLUGIN extensions, suggest ONLY the primary SPI handler**
+- **DO NOT suggest unrelated SPIs**
+- **One SPI per service plugin is usually enough** - the SPI handler is the core functionality
+
 **Use V3 APIs:**
 - **ALWAYS use V3 versions for products** - our platform uses V3 exclusively
 - **For products:** \`stores.productsV3.queryProducts\`, \`stores.productsV3.getProduct\`, \`stores.productsV3.createProduct\`, etc.
@@ -95016,6 +95059,29 @@ var require_sdk_picker_agent_prompt = __commonJS({
   }
 });
 
+// ../sdk-picker/dist/extension-documentation.js
+var require_extension_documentation = __commonJS({
+  "../sdk-picker/dist/extension-documentation.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getExtensionTypesDocumentation = getExtensionTypesDocumentation;
+    var codegen_common_logic_1 = require_dist9();
+    function getExtensionTypesDocumentation(types) {
+      if (types.length === 0) {
+        return "";
+      }
+      const supportedTypes = types.filter((type) => codegen_common_logic_1.codeGenerationExtensionTypes.includes(type));
+      const extensionDocs = supportedTypes.map((type) => (0, codegen_common_logic_1.getExtensionTypeDocumentation)(type)).join("\n\n");
+      if (!extensionDocs) {
+        return "";
+      }
+      return `Understanding what each extension type does will help you find the right APIs:
+
+${extensionDocs}`;
+    }
+  }
+});
+
 // ../sdk-picker/dist/SDKPickerAgent.js
 var require_SDKPickerAgent = __commonJS({
   "../sdk-picker/dist/SDKPickerAgent.js"(exports2) {
@@ -95028,13 +95094,14 @@ var require_SDKPickerAgent = __commonJS({
     var tools_1 = require_tools3();
     var sdkEnricher_1 = require_sdkEnricher();
     var sdk_picker_agent_prompt_1 = require_sdk_picker_agent_prompt();
+    var extension_documentation_1 = require_extension_documentation();
     var SDKPickerAgent = class {
       constructor(model) {
         this.name = "SDKPickerAgent";
         this.mcpClient = new WixMCPClient_1.WixMCPClient();
         this.model = model;
       }
-      async generate({ validIds, extensionDocumentation, userPrompt }) {
+      async generate({ validIds, extensionTypes, userPrompt, skipDocumentationFetch = false }) {
         if (validIds.length === 0) {
           return { extensions: [] };
         }
@@ -95044,6 +95111,7 @@ var require_SDKPickerAgent = __commonJS({
             mcpClient: this.mcpClient,
             validIds
           });
+          const extensionDocumentation = (0, extension_documentation_1.getExtensionTypesDocumentation)(extensionTypes);
           const result = await (0, codegen_common_logic_1.generateAgentText)({
             agentName: this.name,
             model: this.model,
@@ -95056,6 +95124,9 @@ var require_SDKPickerAgent = __commonJS({
           if (!apiResult) {
             throw new Error("Failed to extract SDK picker result from tool calls");
           }
+          if (skipDocumentationFetch) {
+            return (0, sdkEnricher_1.filterApisByScore)(apiResult);
+          }
           return await (0, sdkEnricher_1.fetchDocumentationForApis)(apiResult, this.mcpClient);
         } catch (error) {
           throw (0, ditto_codegen_types_12.toCodegenError)(error);
@@ -95196,20 +95267,9 @@ var require_SDKPickerAgent2 = __commonJS({
     var constants_1 = require_constants();
     var customAnthropicProvider_1 = require_customAnthropicProvider();
     var extensionFormatters_1 = require_extensionFormatters();
-    var AgentsRegistry_1 = require_AgentsRegistry();
     var SDKPickerAgent = class {
       constructor() {
         this.name = "SDKPickerAgent";
-        this.getExtensionTypeDocumentation = (iterationPlan) => {
-          const extensionTypes = this.extractExtensionTypes(iterationPlan);
-          if (extensionTypes.length === 0) {
-            return "";
-          }
-          const extensionDocs = extensionTypes.map((type) => (0, AgentsRegistry_1.getAgentDocumentation)(type)).join("\n\n");
-          return `Understanding what each extension type does will help you find the right APIs:
-
-${extensionDocs}`;
-        };
       }
       buildValidIds(iterationPlan) {
         const ids = [];
@@ -95272,13 +95332,13 @@ ${iterationPlan.summary}
         const model = (0, customAnthropicProvider_1.createCustomTextModel)()(constants_1.LLM_MODELS.CLAUDE_HAIKU_4_5, {
           agentName: this.name
         });
-        const extensionDocumentation = this.getExtensionTypeDocumentation(iterationPlan);
+        const extensionTypes = this.extractExtensionTypes(iterationPlan);
         const userPrompt = this.buildUserPrompt({ iterationPlan, outputPath });
         const agent = new ditto_sdk_picker_1.SDKPickerAgent(model);
         try {
           const apiResult = await agent.generate({
             validIds,
-            extensionDocumentation,
+            extensionTypes,
             userPrompt
           });
           return apiResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.210",
+  "version": "1.0.211",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -24,5 +24,5 @@
     "@wix/ditto-codegen": "1.0.0",
     "esbuild": "^0.27.2"
   },
-  "falconPackageHash": "780d2f5de94ce57968d85c4f521db22e1be0fbf8e0e50f49fea20479"
+  "falconPackageHash": "28f61ae966170c9695138b56544ff9a1b9d9f35c6e8b68320142432d"
 }