@wix/ditto-codegen-public 1.0.50 → 1.0.52

package/dist/out.js

@@ -77576,9 +77576,9 @@ var require_types_impl = __commonJS({
   }
 });
 
-// dist/system-prompts/servicePlugin/servicePluginDocLoader.js
-var require_servicePluginDocLoader = __commonJS({
-  "dist/system-prompts/servicePlugin/servicePluginDocLoader.js"(exports2) {
+// dist/system-prompts/docLoader.js
+var require_docLoader = __commonJS({
+  "dist/system-prompts/docLoader.js"(exports2) {
     "use strict";
     var __createBinding2 = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
@@ -77617,11 +77617,57 @@ var require_servicePluginDocLoader = __commonJS({
         return result;
       };
     })();
+    var __importDefault2 = exports2 && exports2.__importDefault || function(mod2) {
+      return mod2 && mod2.__esModule ? mod2 : { "default": mod2 };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.DocType = void 0;
+    exports2.loadDocumentation = loadDocumentation;
+    var path_1 = __importDefault2(require("path"));
+    var fs4 = __importStar2(require("fs"));
+    var DocType;
+    (function(DocType2) {
+      DocType2["API"] = "api";
+      DocType2["SERVICE_PLUGIN"] = "service-plugin";
+    })(DocType || (exports2.DocType = DocType = {}));
+    function loadDocumentation(items, mapping, docType) {
+      if (!items || items.length === 0) {
+        return "";
+      }
+      const loadedDocs = /* @__PURE__ */ new Set();
+      let combinedContent = "";
+      for (const item of items) {
+        const docFileName = mapping[item];
+        if (docFileName && !loadedDocs.has(docFileName)) {
+          try {
+            const docsSubDir = docType === DocType.API ? "api-docs" : "service-plugins";
+            const docPath = path_1.default.join(__dirname, "docs-output", docsSubDir, docFileName);
+            if (fs4.existsSync(docPath)) {
+              const docContent = fs4.readFileSync(docPath, "utf8");
+              combinedContent += docContent + "\n";
+              loadedDocs.add(docFileName);
+              console.log(`\u2713 Loaded ${docType} documentation: ${docFileName}`);
+            } else {
+              console.warn(`\u26A0 ${docType} documentation not found: ${docPath}`);
+            }
+          } catch (error) {
+            console.error(`\u2717 Failed to load ${docType} documentation for ${item}:`, error);
+          }
+        }
+      }
+      return combinedContent.trim();
+    }
+  }
+});
+
+// dist/system-prompts/servicePlugin/servicePluginDocLoader.js
+var require_servicePluginDocLoader = __commonJS({
+  "dist/system-prompts/servicePlugin/servicePluginDocLoader.js"(exports2) {
+    "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.isSPIName = isSPIName;
     exports2.loadServicePluginDocumentation = loadServicePluginDocumentation;
-    var fs4 = __importStar2(require("fs"));
-    var path2 = __importStar2(require("path"));
+    var docLoader_1 = require_docLoader();
     function isSPIName(value) {
       const validSPINames = [
         "ecom.shippingRates.getShippingRates",
@@ -77654,31 +77700,7 @@ var require_servicePluginDocLoader = __commonJS({
       "ecom.catalog.getCatalogItems": "ecom-catalog-doc.txt"
     };
     function loadServicePluginDocumentation(spiNames) {
-      if (!spiNames || spiNames.length === 0) {
-        return "";
-      }
-      const docsDir = path2.join(__dirname, "docs-output", "service-plugins");
-      const loadedDocs = /* @__PURE__ */ new Set();
-      let combinedContent = "";
-      for (const spiName of spiNames) {
-        const docFileName = SPI_TO_DOC_MAPPING[spiName];
-        if (docFileName && !loadedDocs.has(docFileName)) {
-          try {
-            const docPath = path2.join(docsDir, docFileName);
-            if (fs4.existsSync(docPath)) {
-              const docContent = fs4.readFileSync(docPath, "utf8");
-              combinedContent += docContent + "\n";
-              loadedDocs.add(docFileName);
-              console.log(`\u2713 Loaded service plugin documentation: ${docFileName}`);
-            } else {
-              console.warn(`\u26A0 Service plugin documentation not found: ${docPath}`);
-            }
-          } catch (error) {
-            console.error(`\u2717 Failed to load service plugin documentation for ${spiName}:`, error);
-          }
-        }
-      }
-      return combinedContent.trim();
+      return (0, docLoader_1.loadDocumentation)(spiNames, SPI_TO_DOC_MAPPING, docLoader_1.DocType.SERVICE_PLUGIN);
     }
   }
 });
@@ -120427,6 +120449,7 @@ var require_load_examples = __commonJS({
       types2[types2["ServicePluginExtension"] = 3] = "ServicePluginExtension";
       types2[types2["CustomElementPlugin"] = 4] = "CustomElementPlugin";
       types2[types2["CustomElementWidget"] = 5] = "CustomElementWidget";
+      types2[types2["BackendEvent"] = 6] = "BackendEvent";
     })(types || (exports2.types = types = {}));
     var appsExamples = {
       AIChatbot: {
@@ -120581,6 +120604,24 @@ var require_load_examples = __commonJS({
             "event-countdown/src/site/embedded-scripts/countdown-timer/embedded.html"
           ]
         }
+      },
+      ProductCreatedLogger: {
+        path: "product-created-logger",
+        description: "A webhook that logs product changes",
+        files: {
+          [types.BackendEvent]: [
+            "product-created-logger/src/backend/events/product-created-logger/event.ts"
+          ]
+        }
+      },
+      ContactCreatedLogger: {
+        path: "contact-created-logger",
+        description: "A webhook that logs contact created",
+        files: {
+          [types.BackendEvent]: [
+            "contact-created-logger/src/backend/events/contact-created-logger/event.ts"
+          ]
+        }
       }
     };
     exports2.examples = {
@@ -120604,7 +120645,11 @@ var require_load_examples = __commonJS({
       ],
       [types.ServicePluginExtension]: [appsExamples.SPISExample],
       [types.CustomElementPlugin]: [appsExamples.InventoryCountdown],
-      [types.CustomElementWidget]: [appsExamples.CustomElementWidget]
+      [types.CustomElementWidget]: [appsExamples.CustomElementWidget],
+      [types.BackendEvent]: [
+        appsExamples.ProductCreatedLogger,
+        appsExamples.ContactCreatedLogger
+      ]
     };
     var loadExamples = (pluginTypes) => {
       const examplesAppsBasePath = path_1.default.join(__dirname, "examples-apps");
@@ -124916,6 +124961,174 @@ var require_SiteComponentAgent = __commonJS({
   }
 });
 
+// dist/system-prompts/apiDocLoader.js
+var require_apiDocLoader = __commonJS({
+  "dist/system-prompts/apiDocLoader.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.loadApiDocumentation = loadApiDocumentation;
+    var docLoader_1 = require_docLoader();
+    var API_TO_DOC_MAPPING = {
+      "stores.productsV3.updateProduct": "stores-productsV3-updateProduct-doc.txt",
+      "stores.products.onProductCreated": "stores-productV3-onProductCreated-doc.txt",
+      "data.items.onDataItemCreated": "data-items-onDataItemCreated.txt",
+      "crm.contacts.onContactCreated": "crm-contacts-onContactCreated-doc.txt"
+    };
+    function loadApiDocumentation(apiNames) {
+      return (0, docLoader_1.loadDocumentation)(apiNames, API_TO_DOC_MAPPING, docLoader_1.DocType.API);
+    }
+  }
+});
+
+// dist/system-prompts/backendEvent/backendEventPrompt.js
+var require_backendEventPrompt = __commonJS({
+  "dist/system-prompts/backendEvent/backendEventPrompt.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.backendEventPrompt = void 0;
+    var apiDocLoader_1 = require_apiDocLoader();
+    var backendEventPrompt = (apiNames) => {
+      const apiDocs = (0, apiDocLoader_1.loadApiDocumentation)(apiNames);
+      return `<BACKEND_EVENT_PROMPT>
+<role>
+You are a Wix backend event handler generator. Create event extensions for Wix CLI apps using the JavaScript SDK. Events are triggered when specific conditions on the app or user's site are met.
+</role>
+
+<event_handler_patterns>
+- Use the correct SDK import for the service (e.g., import { products } from '@wix/stores')
+- Implement event listeners using the .on[EventName]() pattern
+- Always use async functions for event handlers
+- Include proper error handling and logging
+- Follow Wix backend event naming conventions
+- Events are triggered automatically when conditions are met
+</event_handler_patterns>
+
+<implementation_guidelines>
+- Import the appropriate SDK module at the top of the file
+- Use descriptive function names that indicate the event being handled
+- Include console.log statements for debugging and monitoring
+- Handle both success and error cases appropriately
+- Use TypeScript types when available for better type safety
+- Follow the async/await pattern for any asynchronous operations
+- CRITICAL: Always check the exact TypeScript type structure before accessing any properties
+- DO NOT assume event structure - the event parameter type (e.g., ProductCreatedEnvelope) determines available fields
+- Use TypeScript IntelliSense or check the SDK documentation for the exact property names
+- ALWAYS check the TypeScript type definition for the exact property names and structure
+- Common event envelope patterns: event.data, event.metadata (NOT event.entity)
+- Property names vary by event type - never assume standard names like 'id' or 'name'
+- When in doubt, log the entire event object first to inspect its structure
+- DO NOT access any properties without verifying they exist in the type definition
+- Use optional chaining (?.) for all property access to prevent runtime errors
+- Reference the corresponding SDK submodule category for event-specific information
+- Events run automatically when triggered - no manual invocation needed
+</implementation_guidelines>
+
+<api_docs>
+${apiDocs}
+</api_docs>
+</BACKEND_EVENT_PROMPT>`;
+    };
+    exports2.backendEventPrompt = backendEventPrompt;
+  }
+});
+
+// dist/agents/BackendEventAgent.js
+var require_BackendEventAgent = __commonJS({
+  "dist/agents/BackendEventAgent.js"(exports2) {
+    "use strict";
+    var __createBinding2 = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __setModuleDefault2 = exports2 && exports2.__setModuleDefault || (Object.create ? (function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    }) : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar2 = exports2 && exports2.__importStar || /* @__PURE__ */ (function() {
+      var 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 ownKeys2(o);
+      };
+      return function(mod2) {
+        if (mod2 && mod2.__esModule) return mod2;
+        var result = {};
+        if (mod2 != null) {
+          for (var k = ownKeys2(mod2), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding2(result, mod2, k[i]);
+        }
+        __setModuleDefault2(result, mod2);
+        return result;
+      };
+    })();
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.BackendEventAgent = void 0;
+    var anthropic_1 = require_dist5();
+    var ai_1 = require_dist9();
+    var utils_1 = require_utils14();
+    var backendEventPrompt_1 = require_backendEventPrompt();
+    var load_examples_1 = __importStar2(require_load_examples());
+    var BackendEventAgent = class {
+      constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.name = "BackendEventAgent";
+      }
+      buildSystemPrompt(apiNames = []) {
+        return (0, backendEventPrompt_1.backendEventPrompt)(apiNames);
+      }
+      async generate(params) {
+        const { blueprint } = params;
+        const examples = (0, load_examples_1.default)([load_examples_1.types.BackendEvent]);
+        const allApiNames = params.extension.relatedApis?.map((api) => api.name).filter((name) => !!name) || [];
+        const systemPrompt = `${this.buildSystemPrompt(allApiNames)}
+${examples}
+`;
+        const appName = blueprint?.appName ? `'${blueprint.appName}'` : "";
+        const primaryAction = `Customize backend event scaffolding for the app ${appName}`;
+        const userMessage = (0, utils_1.buildUserPromptForCodeGenerationAgent)(params, primaryAction);
+        const model = (0, anthropic_1.createAnthropic)({ apiKey: this.apiKey })("claude-sonnet-4-20250514");
+        const result = await (0, ai_1.generateObject)({
+          model,
+          schema: utils_1.FileSchema,
+          messages: [
+            {
+              role: "system",
+              content: systemPrompt,
+              providerOptions: (0, utils_1.withCaching)("1h")
+            },
+            {
+              role: "user",
+              content: userMessage
+            }
+          ],
+          experimental_telemetry: {
+            isEnabled: true,
+            functionId: this.name
+          },
+          maxOutputTokens: 1e4,
+          maxRetries: 3,
+          temperature: 0
+        });
+        return result.object.files;
+      }
+    };
+    exports2.BackendEventAgent = BackendEventAgent;
+    exports2.default = BackendEventAgent;
+  }
+});
+
 // dist/system-prompts/backend/backendApi.js
 var require_backendApi = __commonJS({
   "dist/system-prompts/backend/backendApi.js"(exports2) {
@@ -128248,6 +128461,7 @@ var require_AgentsFactory = __commonJS({
     var CMSAgent_1 = require_CMSAgent();
     var CMSDataAgent_1 = require_CMSDataAgent();
     var SiteComponentAgent_1 = __importDefault2(require_SiteComponentAgent());
+    var BackendEventAgent_1 = __importDefault2(require_BackendEventAgent());
     var BackendApiAgent_1 = require_BackendApiAgent();
     var IterationAgent_1 = __importDefault2(require_IterationAgent());
     var CustomElementAgent_1 = __importDefault2(require_CustomElementAgent());
@@ -128279,6 +128493,8 @@ var require_AgentsFactory = __commonJS({
             return new AutoPatternsGenerator_1.AutoPatternsGenerator();
           case types_1.ExtensionType.SITE_COMPONENT:
             return new SiteComponentAgent_1.default(this.apiKey);
+          case types_1.ExtensionType.BACKEND_EVENT:
+            return new BackendEventAgent_1.default(this.apiKey);
           case types_1.ExtensionType.SITE_WIDGET:
             return new CustomElementAgent_1.default(this.apiKey);
           case types_1.ExtensionType.BACKEND_API:
@@ -130869,7 +131085,7 @@ var require_extensionGenerators = __commonJS({
             const servicePluginType = this.getServicePluginType(extension);
             const builderMethod = this.servicePluginBuilderMap[servicePluginType];
             const extensionConfig = this.createServicePluginData(name, scaffoldDir, id, servicePluginType);
-            writeExtensionFile({
+            return writeExtensionFile({
               outputPath,
               name,
               builderMethodName: builderMethod,
@@ -130877,12 +131093,11 @@ var require_extensionGenerators = __commonJS({
               extensionType: extension.type,
               scaffoldDir
             });
-            break;
           }
           case types_1.ExtensionType.DASHBOARD_PAGE: {
             const name = extension.name || "My Backoffice Page";
             const extensionConfig = this.createDashboardPageData(id, name, scaffoldDir);
-            writeExtensionFile({
+            return writeExtensionFile({
               outputPath,
               name,
               builderMethodName: "backofficePage",
@@ -130890,12 +131105,11 @@ var require_extensionGenerators = __commonJS({
               extensionType: extension.type,
               scaffoldDir
             });
-            break;
           }
           case types_1.ExtensionType.SITE_COMPONENT: {
             const name = extension.name || "My Site Component";
             const extensionConfig = this.createSiteComponentData(name, scaffoldDir, id);
-            writeExtensionFile({
+            return writeExtensionFile({
               outputPath,
               name,
               builderMethodName: "siteComponent",
@@ -130903,12 +131117,11 @@ var require_extensionGenerators = __commonJS({
               extensionType: extension.type,
               scaffoldDir
             });
-            break;
           }
           case types_1.ExtensionType.SITE_WIDGET: {
             const name = extension.name || "My Site Widget";
             const extensionConfig = this.createCustomElementData(id, name, scaffoldDir);
-            writeExtensionFile({
+            return writeExtensionFile({
               outputPath,
               name,
               builderMethodName: "customElement",
@@ -130916,7 +131129,6 @@ var require_extensionGenerators = __commonJS({
               extensionType: extension.type,
               scaffoldDir
             });
-            break;
           }
           case types_1.ExtensionType.EMBEDDED_SCRIPT: {
             const name = extension.name || "My Embedded Script";
@@ -130925,7 +131137,7 @@ var require_extensionGenerators = __commonJS({
               scriptType: EmbeddedScriptAgent_1.EmbeddedScriptType.ESSENTIAL
             };
             const extensionConfig = this.createEmbeddedScriptData(id, name, scaffoldDir, placement, scriptType);
-            writeExtensionFile({
+            return writeExtensionFile({
               outputPath,
               name,
               builderMethodName: "embeddedScript",
@@ -130933,12 +131145,48 @@ var require_extensionGenerators = __commonJS({
               extensionType: extension.type,
               scaffoldDir
             });
-            break;
           }
+          case types_1.ExtensionType.BACKEND_EVENT: {
+            const name = extension.name || "My Backend Event";
+            const extensionConfig = this.createBackendEventData(id, extension.relatedApis || [], scaffoldDir);
+            return writeExtensionFile({
+              outputPath,
+              name,
+              builderMethodName: "webhook",
+              extensionConfig,
+              extensionType: extension.type,
+              scaffoldDir
+            });
+          }
+          case types_1.ExtensionType.BACKEND_API:
+          case types_1.ExtensionType.WEBHOOK:
+          case types_1.ExtensionType.WEB_METHODS:
+          case types_1.ExtensionType.DASHBOARD_PLUGIN:
+          case types_1.ExtensionType.DASHBOARD_MODAL:
+            return null;
           default:
             console.log(`Skipping extension type: ${extension.type}. It doesn't need presence in the extensions.ts file (e.g. Backend API is astro only)`);
-            return;
+            return null;
+        }
+      }
+      static createBackendEventData(id, relatedApis, scaffoldDir) {
+        const slug = this.getSlugFromBlueprint(relatedApis || []);
+        const source = getScaffoldPath(scaffoldDir, "event.ts");
+        return { id, slug, source };
+      }
+      static getSlugFromBlueprint(relatedApis) {
+        if (!Array.isArray(relatedApis) || relatedApis.length === 0) {
+          throw new Error("Backend event extension must have at least one related API");
         }
+        for (const api of relatedApis) {
+          const apiName = api?.name;
+          if (!apiName)
+            continue;
+          const slug = this.apiToSlug[apiName];
+          if (slug)
+            return slug;
+        }
+        throw new Error("No valid slug found for backend event");
       }
       static getServicePluginType(ext) {
         if (!ext.relatedSpis || ext.relatedSpis.length !== 1) {
@@ -130951,7 +131199,7 @@ var require_extensionGenerators = __commonJS({
         throw new Error("No valid service plugin type found for service plugin");
       }
       static createServicePluginData(name, scaffoldDir, id, servicePluginType) {
-        const source = "./" + path_1.default.join(scaffoldDir, "plugin.ts").replace(/^src\//, "");
+        const source = getScaffoldPath(scaffoldDir, "plugin.ts");
         switch (servicePluginType) {
           case "ecom-shipping-rates":
             return {
@@ -130975,7 +131223,7 @@ var require_extensionGenerators = __commonJS({
       }
       static createDashboardPageData(id, name, scaffoldDir) {
         const routePath = name.toLowerCase().replace(/\s+/g, "-");
-        const component = "./" + path_1.default.join(scaffoldDir, "page.tsx").replace(/^src\//, "");
+        const component = getScaffoldPath(scaffoldDir, "page.tsx");
         return {
           id,
           title: name,
@@ -130985,7 +131233,7 @@ var require_extensionGenerators = __commonJS({
       }
       static createCustomElementData(id, name, scaffoldDir) {
         const kebabCaseComponentName = (0, ditto_scaffolding_2.toKebabCase)(name);
-        const componentPath = "./" + path_1.default.join(scaffoldDir, "widget.tsx").replace(/^src\//, "");
+        const componentPath = getScaffoldPath(scaffoldDir, "widget.tsx");
         return {
           id,
           name,
@@ -131000,7 +131248,7 @@ var require_extensionGenerators = __commonJS({
       }
       static createSiteComponentData(name, scaffoldDir, id) {
         const kebabCaseComponentName = (0, ditto_scaffolding_2.toKebabCase)(name);
-        const componentPath = "./" + path_1.default.join(scaffoldDir, "component.tsx").replace(/^src\//, "");
+        const componentPath = getScaffoldPath(scaffoldDir, "component.tsx");
         return {
           id,
           description: name,
@@ -131017,7 +131265,7 @@ var require_extensionGenerators = __commonJS({
         };
       }
       static createEmbeddedScriptData(id, name, scaffoldDir, placement, scriptType) {
-        const source = "./" + path_1.default.join(scaffoldDir, "embedded.html").replace(/^src\//, "");
+        const source = getScaffoldPath(scaffoldDir, "embedded.html");
         return {
           id,
           name,
@@ -131036,6 +131284,14 @@ var require_extensionGenerators = __commonJS({
       "gift-cards-provider": "ecomGiftCardsProvider",
       "ecom-payment-settings": "ecomPaymentSettings"
     };
+    ExtensionFactory.apiToSlug = {
+      "stores.productsV3.onProductCreated": "wix.stores.catalog.v3.product_created",
+      "crm.contacts.onContactCreated": "wix.contacts.v4.contact_created",
+      "data.items.onDataItemCreated": "wix.data.v2.data_item_created"
+    };
+    function getScaffoldPath(scaffoldDir, file) {
+      return "./" + path_1.default.join(scaffoldDir, file).replace(/^src\//, "");
+    }
     function writeExtensionFile({ outputPath, name, builderMethodName, extensionConfig, extensionType, scaffoldDir }) {
       const sanitizedName = name.replace(/[^a-zA-Z0-9\s-_]/g, "").trim();
       if (!sanitizedName) {
@@ -137665,6 +137921,64 @@ export default appBuilder;
   }
 });
 
+// dist/file-collector.js
+var require_file_collector = __commonJS({
+  "dist/file-collector.js"(exports2) {
+    "use strict";
+    var __importDefault2 = exports2 && exports2.__importDefault || function(mod2) {
+      return mod2 && mod2.__esModule ? mod2 : { "default": mod2 };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.captureExistingFiles = captureExistingFiles;
+    exports2.determineFileOperation = determineFileOperation;
+    exports2.collectAllCreatedFiles = collectAllCreatedFiles;
+    var fs_1 = __importDefault2(require("fs"));
+    var path_1 = __importDefault2(require("path"));
+    function captureExistingFiles(filePaths, outputPath) {
+      const existingFiles = /* @__PURE__ */ new Set();
+      filePaths.forEach((filePath) => {
+        const fullPath = path_1.default.join(outputPath, filePath);
+        if (fs_1.default.existsSync(fullPath)) {
+          existingFiles.add(fullPath);
+        }
+      });
+      return existingFiles;
+    }
+    function determineFileOperation(filePath, outputPath, existingFiles) {
+      const fullPath = path_1.default.join(outputPath, filePath);
+      return existingFiles.has(fullPath) ? "update" : "insert";
+    }
+    function collectAllCreatedFiles(options) {
+      const { scaffolds = [], agentFiles, extensionFilePath, outputPath, existingFiles } = options;
+      const allCreatedFiles = [];
+      scaffolds.forEach((s) => {
+        allCreatedFiles.push({
+          path: s.path,
+          operation: "insert",
+          // Scaffolds are always new files
+          content: s.content
+        });
+      });
+      agentFiles.forEach((file) => {
+        const hasScaffold = scaffolds.some((s) => s.path === file.path);
+        allCreatedFiles.push({
+          ...file,
+          operation: hasScaffold ? "insert" : determineFileOperation(file.path || "", outputPath, existingFiles)
+        });
+      });
+      if (extensionFilePath) {
+        allCreatedFiles.push({
+          path: extensionFilePath,
+          operation: determineFileOperation(extensionFilePath, outputPath, existingFiles),
+          content: fs_1.default.readFileSync(path_1.default.join(outputPath, extensionFilePath), "utf-8")
+        });
+      }
+      const uniqueFiles = Array.from(new Map(allCreatedFiles.map((file) => [file.path, file])).values());
+      return uniqueFiles;
+    }
+  }
+});
+
 // dist/orchestrator.js
 var require_orchestrator = __commonJS({
   "dist/orchestrator.js"(exports2) {
@@ -137684,6 +137998,7 @@ var require_orchestrator = __commonJS({
     var FixerFactory_1 = __importDefault2(require_FixerFactory());
     var extensionGenerators_1 = require_extensionGenerators();
     var extensionIndexer_1 = require_extensionIndexer();
+    var file_collector_1 = require_file_collector();
     var MAX_ERRORS_PER_BATCH = 20;
     var DittoOrchestrator = class extends events_1.EventEmitter {
       constructor(agentsFactory, apiKey) {
@@ -137699,6 +138014,41 @@ var require_orchestrator = __commonJS({
       emitEvent(event, payload) {
         return super.emit(event, payload);
       }
+      /**
+       * Finalize the code generation for an extension by:
+       * 1. Capturing which files existed before generation
+       * 2. Writing the generated files to disk
+       * 3. Generating the extension registration file
+       * 4. Collecting all created files with correct operation types
+       * 5. Emitting the agent:done event
+       *
+       * This wraps the common pattern used in all process* methods.
+       */
+      finalizeExtensionGeneration(options) {
+        const { extension, agentName, agentFiles, scaffolds = [], scaffoldPath, outputPath, generatedConfig } = options;
+        const filesToCheck = agentFiles.map((f) => f.path || "");
+        const existingFiles = (0, file_collector_1.captureExistingFiles)(filesToCheck, outputPath);
+        this.writeFile(agentFiles, outputPath);
+        const extensionFilePath = extensionGenerators_1.ExtensionFactory.generateExtension({
+          extension,
+          outputPath,
+          scaffoldPath,
+          generatedConfig
+        });
+        const allCreatedFiles = (0, file_collector_1.collectAllCreatedFiles)({
+          scaffolds,
+          agentFiles,
+          extensionFilePath,
+          outputPath,
+          existingFiles
+        });
+        this.emitEvent("agent:done", {
+          extension,
+          name: agentName,
+          files: allCreatedFiles
+        });
+        return extensionFilePath;
+      }
       writeFile(files, outputPath) {
         if (!files) {
           console.warn("\u26A0\uFE0F Skipping file operation: no files provided");
@@ -137852,22 +138202,19 @@ var require_orchestrator = __commonJS({
           basePath: outputPath,
           planAndResources
         });
-        this.writeFile(files, outputPath);
-        extensionGenerators_1.ExtensionFactory.generateExtension({
+        this.finalizeExtensionGeneration({
           extension,
-          outputPath,
+          agentName: embeddedScriptAgent.name,
+          agentFiles: files,
+          scaffolds: [scaffold],
           scaffoldPath: scaffold.path,
+          outputPath,
           generatedConfig: {
             type: types_1.ExtensionType.EMBEDDED_SCRIPT,
             scriptType,
             placement
           }
         });
-        this.emitEvent("agent:done", {
-          extension,
-          name: embeddedScriptAgent.name,
-          files
-        });
       }
       async processDashboardPage(opts) {
         const { extension, blueprint, outputPath, planAndResources } = opts;
@@ -137903,17 +138250,13 @@ var require_orchestrator = __commonJS({
           decision,
           extensionName: extension.name || ""
         });
-        this.writeFile(files, outputPath);
         const pagePath = files[0].path || "";
-        extensionGenerators_1.ExtensionFactory.generateExtension({
+        this.finalizeExtensionGeneration({
           extension,
-          outputPath,
-          scaffoldPath: pagePath
-        });
-        this.emitEvent("agent:done", {
-          extension,
-          name: "AutoPatternsGenerator",
-          files
+          agentName: "AutoPatternsGenerator",
+          agentFiles: files,
+          scaffoldPath: pagePath,
+          outputPath
         });
       }
       async processServicePlugin({ extension, blueprint, outputPath, planAndResources }) {
@@ -137945,13 +138288,14 @@ var require_orchestrator = __commonJS({
           planAndResources,
           basePath: outputPath
         });
-        this.writeFile(files, outputPath);
-        extensionGenerators_1.ExtensionFactory.generateExtension({
+        this.finalizeExtensionGeneration({
           extension,
-          outputPath,
-          scaffoldPath: scaffold.path
+          agentName: agent.name,
+          agentFiles: files,
+          scaffolds,
+          scaffoldPath: scaffold.path,
+          outputPath
         });
-        this.emitEvent("agent:done", { extension, name: agent.name, files });
       }
       async processStandardExtension({ extension, blueprint, outputPath, planAndResources }) {
         this.emitEvent("scaffold:start", { extension });
@@ -137973,13 +138317,14 @@ var require_orchestrator = __commonJS({
           planAndResources,
           basePath: outputPath
         });
-        this.writeFile(files, outputPath);
-        extensionGenerators_1.ExtensionFactory.generateExtension({
+        this.finalizeExtensionGeneration({
           extension,
-          outputPath,
-          scaffoldPath: scaffold.path
+          agentName: agent.name,
+          agentFiles: files,
+          scaffolds,
+          scaffoldPath: scaffold.path,
+          outputPath
         });
-        this.emitEvent("agent:done", { extension, name: agent.name, files });
       }
       async processMultipleServicePluginScaffolds({ extension, blueprint, outputPath, planAndResources, scaffolds }) {
         if (!extension.relatedSpis || extension.relatedSpis.length === 0) {
@@ -138006,16 +138351,13 @@ var require_orchestrator = __commonJS({
             planAndResources,
             basePath: outputPath
           });
-          this.writeFile(files, outputPath);
-          extensionGenerators_1.ExtensionFactory.generateExtension({
-            extension: spiExtension,
-            outputPath,
-            scaffoldPath: scaffold.path
-          });
-          this.emitEvent("agent:done", {
+          this.finalizeExtensionGeneration({
             extension: spiExtension,
-            name: agent.name,
-            files
+            agentName: agent.name,
+            agentFiles: files,
+            scaffolds: [scaffold],
+            scaffoldPath: scaffold.path,
+            outputPath
           });
         });
         await Promise.all(parallelTasks);
@@ -138052,16 +138394,13 @@ var require_orchestrator = __commonJS({
             relevantFilePaths: paths,
             basePath: outputPath
           });
-          this.writeFile(files, outputPath);
-          extensionGenerators_1.ExtensionFactory.generateExtension({
+          this.finalizeExtensionGeneration({
             extension,
-            outputPath,
-            scaffoldPath: scaffold.path
-          });
-          this.emitEvent("agent:done", {
-            extension,
-            name: agent.name,
-            files
+            agentName: agent.name,
+            agentFiles: files,
+            scaffolds,
+            scaffoldPath: scaffold.path,
+            outputPath
           });
         } else {
           const agent = this.agentsFactory.getAgent(extension);