@wix/ditto-codegen-public 1.0.196 → 1.0.197

package/dist/out.js

@@ -39863,33 +39863,57 @@ Given the full chat history, current user request, and all project files:
 4. Propose new extensions that need to be CREATED for functionality not covered by existing ones (additionalExtensions)
 
 **CRITICAL RULES:**
-- **ONLY RETURN EXTENSIONS THAT NEED CODE CHANGES** - Do NOT return extensions just because:
+
+**#1 - ONLY CREATE WHAT THE USER EXPLICITLY ASKS FOR:**
+- **DO NOT ADD EXTRA EXTENSIONS** that the user did not request
+- If the user asks for a specific extension type, create ONLY that extension type
+- Do NOT add "helper" extensions, "management" dashboards, or "companion" extensions unless explicitly requested
+- Respect the user's intent - if they want a simple widget, give them a simple widget, not a widget + dashboard + backend
+- **EXCEPTION**: If the user's request CANNOT work without an additional extension (technical requirement), then add it
+
+**#2 - ONLY RETURN EXTENSIONS THAT NEED CODE CHANGES** - Do NOT return extensions just because:
   * You need to verify or validate against them
   * They contain information you need to reference
   * You want to check their configuration
   * They are related but don't need modification
-- **DEFAULT TO MODIFYING EXISTING EXTENSIONS** - Always prefer updating existing extensions over creating new ones
-- **AVOID DUPLICATING THE SAME EXTENSION** - Be careful about creating duplicates:
+
+**#3 - DEFAULT TO MODIFYING EXISTING EXTENSIONS** - Always prefer updating existing extensions over creating new ones
+
+**#4 - AVOID DUPLICATING THE SAME EXTENSION** - Be careful about creating duplicates:
   * If "Relevant Existing Extensions" shows an extension that can handle the request, modify it in currentExtensions
   * Don't create a new extension to do the exact same thing as an existing one
   * HOWEVER: If the user uses keywords like "new", "create", "add", "another" with an extension type, CREATE it in additionalExtensions
-- **DETECTING NEW EXTENSION REQUESTS - Look for these KEYWORDS:**
+
+**#5 - DETECTING NEW EXTENSION REQUESTS - Look for these KEYWORDS:**
   * "a new [extension type]" \u2192 CREATE new extension in additionalExtensions
   * "create a [extension type]" \u2192 CREATE new extension in additionalExtensions
   * "add a [extension type]" \u2192 CREATE new extension in additionalExtensions
   * "another [extension type]" \u2192 CREATE new extension in additionalExtensions
   * If user mentions "new" or "create" or "add" before an extension type, they want a NEW separate one
   * Even if purpose seems similar to existing, if they say "new/create/add", honor that request
-- **Examples:**
+
+**Examples:**
   * "add animation duration" + existing dashboard \u2192 modify existing dashboard ONLY
   * "add animation duration AND a new dashboard" \u2192 modify existing + create NEW dashboard
   * "add animation duration AND create a dashboard" \u2192 modify existing + create NEW dashboard
   * "add X, and a new dashboard page to manage Y" \u2192 modify existing (if applicable) + create NEW dashboard (user said "new")
-- **Only create new extensions (additionalExtensions) when:**
+  * "create a widget that shows countdown" \u2192 create ONLY the widget, do NOT add dashboard unless requested
+
+**#6 - Only create new extensions (additionalExtensions) when:**
   1. The user EXPLICITLY uses keywords "new", "create", "add", or "another" before an extension type
   2. OR: The functionality truly does NOT exist in any current extension
-- **If an extension already exists AND user doesn't use "new/create/add" keywords, MODIFY IT instead**
-- **When in doubt about "new" keyword presence, FAVOR CREATING the new extension - missing user intent is worse than creating extra**
+  3. AND: The user actually requested that type of functionality
+
+**#7 - If an extension already exists AND user doesn't use "new/create/add" keywords, MODIFY IT instead**
+
+**EXTENSION TYPE RULES & USAGE NOTES:**
+- Use **SITE_COMPONENT** ONLY when React is EXPLICITLY requested by the user. If React is not explicitly mentioned, use **SITE_WIDGET** instead.
+- Use **DASHBOARD_PAGE** for admin tasks and configuration - but ONLY if the user requests admin/management capabilities.
+- Use **SERVICE_PLUGIN** for platform-level logic (tax/shipping/pricing/validation) - match SPI use cases to appropriate plugin types.
+- If the user prompt contains trigger patterns like "when", "after", "automatically when", or "trigger on [event]", include a **BACKEND_EVENT** extension.
+- **Backend API (HTTP Endpoints)**: Suggest them ONLY when the user prompt EXPLICITLY requests a backend, a server, or an endpoint.
+- **EMBEDDED_SCRIPT + DASHBOARD_PAGE**: MANDATORY - Every EMBEDDED_SCRIPT MUST be paired with at least one DASHBOARD_PAGE to manage configuration. This is a technical requirement, not optional.
+- **SITE_WIDGET does NOT need DASHBOARD_PAGE**: Site Widgets have a built-in settings panel in the Wix Editor. Do NOT add Dashboard Page unless user EXPLICITLY requests centralized/shared database configuration.
 
 **IMPORTANT**: Before deciding on extensions, check if this is a data-only operation (handled by PlannerAgent). See common scenarios below.
 
@@ -39934,7 +39958,8 @@ ${(0, codegen_common_logic_1.getExtensionDecisionMatrix)()}`;
     exports2.iterationAgentCommonUseCasesGuide = iterationAgentCommonUseCasesGuideConst;
     exports2.iterationAgentChatHistoryContext = (0, iterationScenarios_1.getChatHistoryContext)();
     exports2.iterationAgentExtensionSelectionLogic = iterationAgentExtensionSelectionLogicConst;
-    var getIterationAgentConstraints = (supportedTypes) => `- **CRITICAL - AVOID UNNECESSARY DUPLICATION**: Only propose additionalExtensions if existing ones CANNOT fulfill the user's request. Review "Relevant Existing Extensions" carefully. If an existing extension can handle the request, MODIFY it instead of creating new.
+    var getIterationAgentConstraints = (supportedTypes) => `- **CRITICAL - ONLY CREATE WHAT USER EXPLICITLY REQUESTS**: Do NOT add extra extensions the user didn't ask for. If user asks for a widget, create only the widget. If user asks for a dashboard, create only the dashboard. Do not assume they need "helper" or "management" extensions.
+- **CRITICAL - AVOID UNNECESSARY DUPLICATION**: Only propose additionalExtensions if existing ones CANNOT fulfill the user's request. Review "Relevant Existing Extensions" carefully. If an existing extension can handle the request, MODIFY it instead of creating new.
 - **SMART DUPLICATION DETECTION**: When deciding between modifying vs creating:
   * If user says "add X feature" and an extension exists that handles X \u2192 modify the existing extension in currentExtensions
   * If user says "add X AND create a new Y" where Y is explicitly requested as NEW \u2192 modify existing for X + create new for Y in additionalExtensions
@@ -73062,6 +73087,227 @@ var require_AgentsRegistry = __commonJS({
   }
 });
 
+// dist/system-prompts/iterationAgent/iteration-examples.js
+var require_iteration_examples = __commonJS({
+  "dist/system-prompts/iterationAgent/iteration-examples.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.iterationAgentExamples = void 0;
+    var types_1 = require_types_impl();
+    var simpleWidgetExample = {
+      currentExtensions: [],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.SITE_WIDGET,
+          name: "Countdown Timer",
+          relevantUserRequest: "Display a countdown timer widget on the site"
+        }
+      ],
+      summary: "User wants a countdown timer widget on their site."
+    };
+    var reactComponentExample = {
+      currentExtensions: [],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.SITE_COMPONENT,
+          name: "Countdown Timer",
+          relevantUserRequest: "Display a countdown timer as a React component on the site"
+        }
+      ],
+      summary: "User wants a React countdown timer component on their site."
+    };
+    var popupWithDashboardExample = {
+      currentExtensions: [],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.EMBEDDED_SCRIPT,
+          name: "Promotional Popup",
+          relevantUserRequest: "Display a promotional popup overlay on the site"
+        },
+        {
+          extensionType: types_1.ExtensionType.DASHBOARD_PAGE,
+          name: "Popup Manager",
+          relevantUserRequest: "Admin interface to configure popup content, timing, and activation settings"
+        }
+      ],
+      summary: "User wants a promotional popup. EMBEDDED_SCRIPT requires a DASHBOARD_PAGE for configuration."
+    };
+    var modifyExistingExample = {
+      currentExtensions: [
+        {
+          extensionType: types_1.ExtensionType.SERVICE_PLUGIN,
+          name: "Handling Fees Calculator",
+          paths: ["src/backend/service-plugins/fees/plugin.ts"],
+          relevantUserRequest: "Update the fee amount from $5 to $10"
+        }
+      ],
+      additionalExtensions: [],
+      summary: "User wants to update the existing fee amount in the service plugin."
+    };
+    var eventTriggerExample = {
+      currentExtensions: [],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.BACKEND_EVENT,
+          name: "Contact Creation Logger",
+          relevantUserRequest: "Listen for contact creation events and log new contacts automatically"
+        }
+      ],
+      summary: "User wants automatic logging when contacts are created."
+    };
+    var widgetWithDashboardExample = {
+      currentExtensions: [],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.SITE_WIDGET,
+          name: "Product Showcase",
+          relevantUserRequest: "Display featured products in a widget on the site"
+        },
+        {
+          extensionType: types_1.ExtensionType.DASHBOARD_PAGE,
+          name: "Featured Products Manager",
+          relevantUserRequest: "Admin interface to select and manage which products are featured"
+        }
+      ],
+      summary: "User wants a product showcase widget with a dashboard for managing featured products."
+    };
+    var modifyAndCreateExample = {
+      currentExtensions: [
+        {
+          extensionType: types_1.ExtensionType.DASHBOARD_PAGE,
+          name: "Settings Dashboard",
+          paths: ["src/dashboard/pages/settings/page.tsx"],
+          relevantUserRequest: "Add a color picker input to the settings form"
+        }
+      ],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.DASHBOARD_PAGE,
+          name: "Analytics Dashboard",
+          relevantUserRequest: "Create a new dashboard page for viewing analytics data"
+        }
+      ],
+      summary: "User wants to modify existing settings dashboard and create a new analytics dashboard."
+    };
+    var servicePluginExample = {
+      currentExtensions: [],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.SERVICE_PLUGIN,
+          name: "Custom Shipping Rates",
+          relatedSpis: ["ecom.shippingRates.getShippingRates"],
+          relevantUserRequest: "Calculate custom shipping rates based on destination region"
+        }
+      ],
+      summary: "User wants custom shipping rate calculations at checkout."
+    };
+    var fixedFeesWithDashboardExample = {
+      currentExtensions: [],
+      additionalExtensions: [
+        {
+          extensionType: types_1.ExtensionType.SERVICE_PLUGIN,
+          name: "Fixed Shipping Fees",
+          relatedSpis: ["ecom.additionalFees.calculateAdditionalFees"],
+          relevantUserRequest: "Apply fixed-cost shipping fees at checkout by reading fee configuration from database"
+        },
+        {
+          extensionType: types_1.ExtensionType.DASHBOARD_PAGE,
+          name: "Shipping Fees Manager",
+          relevantUserRequest: "Admin interface to create, edit, and delete fixed shipping fees stored in a database collection"
+        }
+      ],
+      summary: "User wants a fixed-cost shipping fees system with Additional Fees SPI and a dashboard to manage fee configurations stored in a database."
+    };
+    exports2.iterationAgentExamples = `### Example 1: Simple Widget Request (NO extra extensions)
+**User Request:** "I want to add a countdown timer to my site"
+**Existing Extensions:** None
+
+**Expected Output:**
+${JSON.stringify(simpleWidgetExample, null, 2)}
+**Why:** User asked for a widget only. Do NOT add a dashboard - SITE_WIDGET has built-in settings panel.
+
+---
+
+### Example 2: Widget with Explicit React Request
+**User Request:** "Create a countdown timer React component for my site"
+**Existing Extensions:** None
+
+**Expected Output:**
+${JSON.stringify(reactComponentExample, null, 2)}
+**Why:** User explicitly said "React", so use SITE_COMPONENT instead of SITE_WIDGET.
+
+---
+
+### Example 3: Popup Request (MANDATORY Dashboard Pairing)
+**User Request:** "I want a promotional popup on my site"
+**Existing Extensions:** None
+
+**Expected Output:**
+${JSON.stringify(popupWithDashboardExample, null, 2)}
+**Why:** EMBEDDED_SCRIPT MUST always be paired with DASHBOARD_PAGE - this is a technical requirement.
+
+---
+
+### Example 4: Modify Existing Extension
+**User Request:** "Change the fee from $5 to $10"
+**Existing Extensions:** SERVICE_PLUGIN "Handling Fees Calculator" at src/backend/service-plugins/fees/
+
+**Expected Output:**
+${JSON.stringify(modifyExistingExample, null, 2)}
+**Why:** Modify existing extension instead of creating new one. User didn't ask for anything new.
+
+---
+
+### Example 5: Event Trigger Pattern
+**User Request:** "When a new contact is created, log it automatically"
+**Existing Extensions:** None
+
+**Expected Output:**
+${JSON.stringify(eventTriggerExample, null, 2)}
+**Why:** Trigger pattern "when...created" indicates BACKEND_EVENT. No dashboard needed unless requested.
+
+---
+
+### Example 6: Explicit Dashboard Request with Widget
+**User Request:** "Create a product showcase widget AND a dashboard to manage featured products"
+**Existing Extensions:** None
+
+**Expected Output:**
+${JSON.stringify(widgetWithDashboardExample, null, 2)}
+**Why:** User explicitly asked for BOTH a widget AND a dashboard - honor both requests.
+
+---
+
+### Example 7: Add Feature to Existing + Create New
+**User Request:** "Add a color picker to the existing dashboard, and create a new analytics dashboard"
+**Existing Extensions:** DASHBOARD_PAGE "Settings Dashboard" at src/dashboard/pages/settings/
+
+**Expected Output:**
+${JSON.stringify(modifyAndCreateExample, null, 2)}
+**Why:** User said "add to existing" (modify) AND "create a new" (additional). Honor both.
+
+---
+
+### Example 8: Service Plugin for eCommerce
+**User Request:** "I need custom shipping rates based on destination"
+**Existing Extensions:** None
+
+**Expected Output:**
+${JSON.stringify(servicePluginExample, null, 2)}
+**Why:** User asked for shipping rates logic only. Do NOT add dashboard unless explicitly requested.
+
+---
+
+### Example 9: Full eCommerce Solution with SPI + Dashboard + Database
+**User Request:** "Build an app that adds fixed-cost shipping fees at checkout using the Additional Fees SPI. The app should save the fee description text and amount in a dedicated database collection. Also provide the user with a dashboard to manage these fixed fees."
+**Existing Extensions:** None
+
+**Expected Output:**
+${JSON.stringify(fixedFeesWithDashboardExample, null, 2)}
+**Why:** User explicitly requested BOTH a SERVICE_PLUGIN (Additional Fees SPI) AND a DASHBOARD_PAGE to manage fees. The database collection is handled by the Planner agent - no separate extension needed for CMS.`;
+  }
+});
+
 // dist/system-prompts/iterationAgent/iteration-agent-prompt.js
 var require_iteration_agent_prompt = __commonJS({
   "dist/system-prompts/iterationAgent/iteration-agent-prompt.js"(exports2) {
@@ -73071,6 +73317,7 @@ var require_iteration_agent_prompt = __commonJS({
     var codegen_common_logic_1 = require_dist9();
     var iterartion_agent_instructions_1 = require_iterartion_agent_instructions();
     var AgentsRegistry_1 = require_AgentsRegistry();
+    var iteration_examples_1 = require_iteration_examples();
     var iterationAgentPrompt = () => {
       const supportedTypes = (0, AgentsRegistry_1.getSupportedExtensionTypes)().join(", ");
       const supportedExtensions = (0, AgentsRegistry_1.generateSupportedExtensionsSection)();
@@ -73078,7 +73325,7 @@ var require_iteration_agent_prompt = __commonJS({
       const keyPoints = (0, iterartion_agent_instructions_1.getIterationAgentKeyPoints)(supportedTypes);
       const systemPrompt = new codegen_common_logic_1.SystemPromptBuilder({
         agentType: codegen_common_logic_1.GeneralAgentType.ITERATION_AGENT
-      }).withRole(iterartion_agent_instructions_1.iterationAgentRole).withSection("chat_history_context", iterartion_agent_instructions_1.iterationAgentChatHistoryContext).withSection("common_iteration_scenarios", iterartion_agent_instructions_1.iterationAgentCommonScenariosDocumentation).withSection("quick_decision_guide", iterartion_agent_instructions_1.iterationAgentQuickDecisionGuide).withSection("common_use_cases_guide", iterartion_agent_instructions_1.iterationAgentCommonUseCasesGuide).withSection("supported_extension_types", supportedExtensions).withSection("extension_selection_logic", iterartion_agent_instructions_1.iterationAgentExtensionSelectionLogic).withSection("constraints", constraints).withSection("key_points", keyPoints);
+      }).withRole(iterartion_agent_instructions_1.iterationAgentRole).withSection("chat_history_context", iterartion_agent_instructions_1.iterationAgentChatHistoryContext).withSection("common_iteration_scenarios", iterartion_agent_instructions_1.iterationAgentCommonScenariosDocumentation).withSection("quick_decision_guide", iterartion_agent_instructions_1.iterationAgentQuickDecisionGuide).withSection("common_use_cases_guide", iterartion_agent_instructions_1.iterationAgentCommonUseCasesGuide).withSection("supported_extension_types", supportedExtensions).withSection("extension_selection_logic", iterartion_agent_instructions_1.iterationAgentExtensionSelectionLogic).withSection("constraints", constraints).withSection("key_points", keyPoints).withExamples(iteration_examples_1.iterationAgentExamples);
       return systemPrompt.compose();
     };
     exports2.iterationAgentPrompt = iterationAgentPrompt;
@@ -73266,7 +73513,7 @@ var require_IterationAgent = __commonJS({
   "dist/agents/Iteration/IterationAgent.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.IterationAgent = void 0;
+    exports2.IterationAgent = exports2.IterationPlanSchema = void 0;
     var zod_1 = require_zod();
     var ai_1 = require_dist8();
     var iteration_agent_prompt_1 = require_iteration_agent_prompt();
@@ -73291,7 +73538,7 @@ var require_IterationAgent = __commonJS({
       relatedSpis: zod_1.z.array(zod_1.z.string()).optional().describe("Optional value, only for SPI extensions - specify the SPI types"),
       relevantUserRequest: zod_1.z.string().describe("What part of the user request this extension should do, do not reference other extensions.")
     });
-    var IterationPlanSchema = zod_1.z.object({
+    exports2.IterationPlanSchema = zod_1.z.object({
       currentExtensions: zod_1.z.array(CurrentExtensionSchema).describe("Existing extensions to be triggered, return [] if no existing extensions are needed"),
       additionalExtensions: zod_1.z.array(AdditionalExtensionSchema).describe("New extensions to be created, return [] if no new extensions are needed"),
       summary: zod_1.z.string().describe("Summary of the chat with the user request")
@@ -73374,7 +73621,7 @@ ${(0, extensionFormatters_1.formatContextExtensions)(extensionSelectorResult.con
           systemPrompt: this.buildSystemPrompt(),
           provider: constants_1.LLM_PROVIDERS.ANTHROPIC,
           model: constants_1.LLM_MODELS.CLAUDE_3_5_HAIKU_LATEST,
-          schema: IterationPlanSchema,
+          schema: exports2.IterationPlanSchema,
           agentName: this.name,
           experimental_repairText: this.repairNameTooLong
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.196",
+  "version": "1.0.197",
   "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.25.9"
   },
-  "falconPackageHash": "e9a4627816f3b173ce107beedd4b417293a1cb27a8d04eb4ce405b0b"
+  "falconPackageHash": "b19d9ec4dad95f06bab6e6d83ce26a53a04edea1f5128c85acdb0ba5"
 }