@wix/ditto-codegen-public 1.0.161 → 1.0.163

package/dist/out.js

@@ -112150,6 +112150,7 @@ var require_SystemPromptBuilder = __commonJS({
       GeneralAgentType2["EXTENSION_SELECTOR"] = "EXTENSION_SELECTOR";
       GeneralAgentType2["ITERATION_AGENT"] = "ITERATION_AGENT";
       GeneralAgentType2["AUTO_PATTERN_DECISION"] = "AUTO_PATTERN_DECISION";
+      GeneralAgentType2["SDK_PICKER"] = "SDK_PICKER";
     })(GeneralAgentType || (exports2.GeneralAgentType = GeneralAgentType = {}));
     var toPromptTag = (fromPromptType) => {
       return `${fromPromptType}_PROMPT`;
@@ -116416,9 +116417,392 @@ var require_load_examples = __commonJS({
   }
 });
 
-// dist/system-prompts/common/docLoader.js
-var require_docLoader = __commonJS({
-  "dist/system-prompts/common/docLoader.js"(exports2) {
+// dist/system-prompts/sdk/sdkConfig.js
+var require_sdkConfig = __commonJS({
+  "dist/system-prompts/sdk/sdkConfig.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.SDK_METHODS_CONFIG = exports2.getTag = void 0;
+    var getTag = ({ apiName }) => {
+      return apiName.replace(/\./g, "_");
+    };
+    exports2.getTag = getTag;
+    exports2.SDK_METHODS_CONFIG = {
+      // Products V3
+      "stores.productsV3.queryProducts": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/query-products",
+        fileName: "stores-productsV3-queryProducts-doc.txt"
+      },
+      "stores.productsV3.searchProducts": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/search-products",
+        fileName: "stores-productsV3-searchProducts-doc.txt"
+      },
+      "stores.productsV3.getProduct": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/get-product",
+        fileName: "stores-productsV3-getProduct-doc.txt"
+      },
+      "stores.productsV3.createProduct": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/create-product",
+        fileName: "stores-productsV3-createProduct-doc.txt"
+      },
+      "stores.productsV3.updateProduct": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/update-product",
+        fileName: "stores-productsV3-updateProduct-doc.txt"
+      },
+      "stores.productsV3.deleteProduct": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/delete-product",
+        fileName: "stores-productsV3-deleteProduct-doc.txt"
+      },
+      // Product Variants
+      "stores.readOnlyVariantsV3.queryVariants": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/read-only-variants-v3/query-variants",
+        fileName: "stores-readOnlyVariantsV3-queryVariants-doc.txt"
+      },
+      "stores.readOnlyVariantsV3.searchVariants": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/read-only-variants-v3/search-variants",
+        fileName: "stores-readOnlyVariantsV3-searchVariants-doc.txt"
+      },
+      // Inventory
+      "stores.inventory.queryInventory": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/inventory/query-inventory",
+        fileName: "stores-inventory-queryInventory-doc.txt"
+      },
+      "stores.inventory.updateInventoryVariants": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/inventory/update-inventory-variants",
+        fileName: "stores-inventory-updateInventoryVariants-doc.txt"
+      },
+      "stores.inventoryItemsV3.queryInventoryItems": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/inventory-items-v3/query-inventory-items",
+        fileName: "stores-inventoryItemsV3-queryInventoryItems-doc.txt"
+      },
+      "stores.inventoryItemsV3.updateInventoryItem": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/inventory-items-v3/update-inventory-item",
+        fileName: "stores-inventoryItemsV3-updateInventoryItem-doc.txt"
+      },
+      // Cart Operations
+      "ecom.cart.createCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/create-cart",
+        fileName: "ecom-cart-createCart-doc.txt"
+      },
+      "ecom.cart.updateCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/update-cart",
+        fileName: "ecom-cart-updateCart-doc.txt"
+      },
+      "ecom.cart.getCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/get-cart",
+        fileName: "ecom-cart-getCart-doc.txt"
+      },
+      "ecom.cart.deleteCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/delete-cart",
+        fileName: "ecom-cart-deleteCart-doc.txt"
+      },
+      "ecom.cart.addToCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/add-to-cart",
+        fileName: "ecom-cart-addToCart-doc.txt"
+      },
+      "ecom.cart.removeLineItemsFromCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/remove-line-items",
+        fileName: "ecom-cart-removeLineItemsFromCart-doc.txt"
+      },
+      "ecom.cart.createCheckout": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/create-checkout",
+        fileName: "ecom-cart-createCheckout-doc.txt"
+      },
+      "ecom.currentCart.getCurrentCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/current-cart/get-current-cart",
+        fileName: "ecom-currentCart-getCurrentCart-doc.txt"
+      },
+      "ecom.currentCart.updateCurrentCart": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/current-cart/update-current-cart",
+        fileName: "ecom-currentCart-updateCurrentCart-doc.txt"
+      },
+      // Checkout
+      "ecom.checkout.createCheckout": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/create-checkout",
+        fileName: "ecom-checkout-createCheckout-doc.txt"
+      },
+      "ecom.checkout.getCheckout": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/get-checkout",
+        fileName: "ecom-checkout-getCheckout-doc.txt"
+      },
+      "ecom.checkout.updateCheckout": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/update-checkout",
+        fileName: "ecom-checkout-updateCheckout-doc.txt"
+      },
+      "ecom.checkout.addToCheckout": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/add-to-checkout",
+        fileName: "ecom-checkout-addToCheckout-doc.txt"
+      },
+      "ecom.checkout.removeLineItemsFromCheckout": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/remove-line-items",
+        fileName: "ecom-checkout-removeLineItemsFromCheckout-doc.txt"
+      },
+      // Orders
+      "ecom.orders.getOrder": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/get-order",
+        fileName: "ecom-orders-getOrder-doc.txt"
+      },
+      "ecom.orders.searchOrders": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/search-orders",
+        fileName: "ecom-orders-searchOrders-doc.txt"
+      },
+      "ecom.orders.updateOrder": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/update-order",
+        fileName: "ecom-orders-updateOrder-doc.txt"
+      },
+      "ecom.orders.bulkUpdateOrders": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/bulk-update-orders",
+        fileName: "ecom-orders-bulkUpdateOrders-doc.txt"
+      },
+      "ecom.orders.cancelOrder": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/cancel-order",
+        fileName: "ecom-orders-cancelOrder-doc.txt"
+      },
+      // Collections
+      "stores.collections.queryCollections": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/collections/query-collections",
+        fileName: "stores-collections-queryCollections-doc.txt"
+      },
+      "stores.collections.getCollection": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/collections/get-collection",
+        fileName: "stores-collections-getCollection-doc.txt"
+      },
+      "stores.collections.createCollection": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/products/create-collection",
+        fileName: "stores-collections-createCollection-doc.txt"
+      },
+      "stores.collections.updateCollection": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/products/update-collection",
+        fileName: "stores-collections-updateCollection-doc.txt"
+      },
+      "stores.collections.addProductsToCollection": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/products/add-products-to-collection",
+        fileName: "stores-collections-addProductsToCollection-doc.txt"
+      },
+      "stores.collections.removeProductsFromCollection": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/products/remove-products-from-collection",
+        fileName: "stores-collections-removeProductsFromCollection-doc.txt"
+      },
+      // Search
+      "search.wixSiteSearch.search": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/search/wix-site-search/search",
+        fileName: "search-wixSiteSearch-search-doc.txt"
+      },
+      // Data Management
+      "data.items.query": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/query",
+        fileName: "data-items-query-doc.txt"
+      },
+      "data.items.insert": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/insert",
+        fileName: "data-items-insert-doc.txt"
+      },
+      "data.items.update": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/update",
+        fileName: "data-items-update-doc.txt"
+      },
+      "data.items.remove": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/remove",
+        fileName: "data-items-remove-doc.txt"
+      },
+      "data.items.get": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/get",
+        fileName: "data-items-get-doc.txt"
+      },
+      // Webhooks - Cart
+      "ecom.cart.onCartCreated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/on-cart-created",
+        fileName: "ecom-cart-onCartCreated-doc.txt",
+        example: `import { cart } from "@wix/ecom";
+
+    cart.onCartCreated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "ecom.cart.onCartUpdated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/cart/on-cart-updated",
+        fileName: "ecom-cart-onCartUpdated-doc.txt",
+        example: `import { cart } from "@wix/ecom";
+
+    cart.onCartUpdated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      // Webhooks - Checkout
+      "ecom.checkout.onCheckoutCreated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/on-checkout-created",
+        fileName: "ecom-checkout-onCheckoutCreated-doc.txt",
+        example: `import { checkout } from "@wix/ecom";
+
+    checkout.onCheckoutCreated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "ecom.checkout.onCheckoutUpdated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/on-checkout-updated",
+        fileName: "ecom-checkout-onCheckoutUpdated-doc.txt",
+        example: `import { checkout } from "@wix/ecom";
+
+    checkout.onCheckoutUpdated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "ecom.checkout.onCheckoutCompleted": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/on-checkout-completed",
+        fileName: "ecom-checkout-onCheckoutCompleted-doc.txt",
+        example: `import { checkout } from "@wix/ecom";
+
+    checkout.onCheckoutCompleted((event) => {
+      // handle your event here
+    });
+    `
+      },
+      // Webhooks - Orders
+      "ecom.orders.onOrderCreated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/on-order-created",
+        fileName: "ecom-orders-onOrderCreated-doc.txt",
+        example: `import { orders } from "@wix/pricing-plans";
+
+    orders.onOrderCreated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "ecom.orders.onOrderUpdated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/on-order-updated",
+        fileName: "ecom-orders-onOrderUpdated-doc.txt",
+        example: `import { orders } from "@wix/pricing-plans";
+
+    orders.onOrderUpdated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      // Webhooks - Products
+      "stores.productsV3.onProductCreated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/on-product-created",
+        fileName: "stores-productsV3-onProductCreated-doc.txt",
+        example: `import { productsV3 } from "@wix/stores";
+
+    productsV3.onProductCreated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "stores.productsV3.onProductDeleted": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/on-product-deleted",
+        fileName: "stores-productsV3-onProductDeleted-doc.txt",
+        example: `import { productsV3 } from "@wix/stores";
+
+    productsV3.onProductDeleted((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "stores.productsV3.onProductUpdated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/on-product-updated",
+        fileName: "stores-productsV3-onProductUpdated-doc.txt",
+        example: `import { productsV3 } from "@wix/stores";
+
+    productsV3.onProductUpdated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      // Webhooks - CRM
+      "crm.contacts.onContactCreated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/on-contact-created",
+        fileName: "crm-contacts-onContactCreated-doc.txt",
+        example: `import { contacts } from "@wix/crm";
+
+    contacts.onContactCreated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "crm.contacts.onContactUpdated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/on-contact-updated",
+        fileName: "crm-contacts-onContactUpdated-doc.txt",
+        example: `import { contacts } from "@wix/crm";
+
+    contacts.onContactUpdated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "crm.contacts.onContactDeleted": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/on-contact-deleted",
+        fileName: "crm-contacts-onContactDeleted-doc.txt",
+        example: `import { contacts } from "@wix/crm";
+
+    contacts.onContactDeleted((event) => {
+      // handle your event here
+    });
+    `
+      },
+      // Webhooks - Data
+      "data.items.onDataItemCreated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/on-data-item-created",
+        fileName: "data-items-onDataItemCreated-doc.txt",
+        example: `import { items } from "@wix/data";
+
+    items.onDataItemCreated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "data.items.onDataItemUpdated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/on-data-item-updated",
+        fileName: "data-items-onDataItemUpdated-doc.txt",
+        example: `import { items } from "@wix/data";
+
+    items.onDataItemUpdated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "data.items.onDataItemDeleted": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/data/items/on-data-item-deleted",
+        fileName: "data-items-onDataItemDeleted-doc.txt",
+        example: `import { items } from "@wix/data";
+
+    items.onDataItemDeleted((event) => {
+      // handle your event here
+    });
+    `
+      },
+      // Webhooks - Bookings
+      "bookings.bookings.onBookingCreated": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings/on-booking-created",
+        fileName: "bookings-bookings-onBookingCreated-doc.txt",
+        example: `import { bookings } from "@wix/bookings";
+
+    bookings.onBookingCreated((event) => {
+      // handle your event here
+    });
+    `
+      },
+      "bookings.bookings.onBookingCanceled": {
+        url: "https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings/on-booking-canceled",
+        fileName: "bookings-bookings-onBookingCanceled-doc.txt",
+        example: `import { bookings } from "@wix/bookings";
+
+    bookings.onBookingCanceled((event) => {
+      // handle your event here
+    });
+    `
+      }
+    };
+  }
+});
+
+// dist/system-prompts/sdk/apiDocLoader.js
+var require_apiDocLoader = __commonJS({
+  "dist/system-prompts/sdk/apiDocLoader.js"(exports2) {
     "use strict";
     var __createBinding2 = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
@@ -116461,86 +116845,51 @@ var require_docLoader = __commonJS({
       return mod2 && mod2.__esModule ? mod2 : { "default": mod2 };
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.DocType = void 0;
-    exports2.loadDocumentation = loadDocumentation;
+    exports2.loadApiDocumentation = void 0;
+    var sdkConfig_1 = require_sdkConfig();
     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) {
+    var DATA_API_NAMES = [
+      "data.items.query",
+      "data.items.insert",
+      "data.items.remove",
+      "data.items.update",
+      "data.items.get"
+    ];
+    var loadApiDocumentation = ({ apiNames, useData }) => {
+      const apisToLoad = useData ? Array.from(/* @__PURE__ */ new Set([...apiNames, ...DATA_API_NAMES])) : apiNames;
+      return loadDocumentation({
+        apiNames: apisToLoad,
+        apiMethods: sdkConfig_1.SDK_METHODS_CONFIG
+      });
+    };
+    exports2.loadApiDocumentation = loadApiDocumentation;
+    var loadDocumentation = ({ apiNames, apiMethods }) => {
+      if (!apiNames || apiNames.length === 0) {
         return "";
       }
       const loadedDocs = /* @__PURE__ */ new Set();
       let combinedContent = "";
-      for (const item of items) {
-        const docFileName = mapping[item];
-        if (docFileName && !loadedDocs.has(docFileName)) {
+      for (const apiName of apiNames) {
+        const config = apiMethods[apiName];
+        if (config && !loadedDocs.has(config.fileName)) {
           try {
-            const docsSubDir = docType === DocType.API ? "api-docs" : "service-plugins";
-            const docPath = path_1.default.join(__dirname, "docs-output", docsSubDir, docFileName);
+            const docPath = path_1.default.join(__dirname, "docs-output", "api-docs", config.fileName);
             if (fs4.existsSync(docPath)) {
               const docContent = fs4.readFileSync(docPath, "utf8");
               combinedContent += docContent + "\n";
-              loadedDocs.add(docFileName);
-              console.log(`\u2713 Loaded ${docType} documentation: ${docFileName}`);
+              loadedDocs.add(config.fileName);
+              console.log(`\u2713 Loaded API documentation: ${config.fileName}`);
             } else {
-              console.warn(`\u26A0 ${docType} documentation not found: ${docPath}`);
+              console.warn(`\u26A0 API documentation not found: ${docPath}`);
             }
           } catch (error) {
-            console.error(`\u2717 Failed to load ${docType} documentation for ${item}:`, error);
+            console.error(`\u2717 Failed to load API documentation for ${apiName}:`, error);
           }
         }
       }
       return combinedContent.trim();
-    }
-  }
-});
-
-// dist/system-prompts/common/apiDocLoader.js
-var require_apiDocLoader = __commonJS({
-  "dist/system-prompts/common/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.productsV3.onProductCreated": "stores-productV3-onProductCreated-doc.txt",
-      "data.items.onDataItemCreated": "data-items-onDataItemCreated.txt",
-      "data.items.query": "data-items-query-doc.txt",
-      "data.items.insert": "data-items-insert-doc.txt",
-      "data.items.remove": "data-items-remove-doc.txt",
-      "data.items.update": "data-items-update-doc.txt",
-      "data.items.get": "data-items-get-doc.txt",
-      "crm.contacts.onContactCreated": "crm-contacts-onContactCreated-doc.txt",
-      "ecom.cart.onCartCreated": "ecom-cart-onCartCreated-doc.txt",
-      "ecom.cart.onCartUpdated": "ecom-cart-onCartUpdated-doc.txt",
-      "ecom.currentCart.getCurrentCart": "ecom-currentCart-getCurrentCart-doc.txt",
-      "ecom.currentCart.updateCurrentCart": "ecom-currentCart-updateCurrentCart-doc.txt"
     };
-    var DATA_API_NAMES = [
-      "data.items.query",
-      "data.items.insert",
-      "data.items.remove",
-      "data.items.update",
-      "data.items.get"
-    ];
-    function loadApiDocumentation(apiNames, useData, loadAllApiDocs) {
-      let apisToLoad = [];
-      if (loadAllApiDocs) {
-        apisToLoad = Object.keys(API_TO_DOC_MAPPING);
-      } else if (useData) {
-        apisToLoad = Array.from(/* @__PURE__ */ new Set([...apiNames, ...DATA_API_NAMES]));
-      } else {
-        apisToLoad = apiNames;
-      }
-      const apiDocs = (0, docLoader_1.loadDocumentation)(apisToLoad, API_TO_DOC_MAPPING, docLoader_1.DocType.API);
-      return apiDocs || "";
-    }
   }
 });
 
@@ -116646,7 +116995,10 @@ ${(0, error_handling_1.errorHandling)()}`;
         if (this.apiNames.length === 0 && !this.useData && !this.useIteration) {
           return this;
         }
-        const apiDocs = (0, apiDocLoader_1.loadApiDocumentation)(this.apiNames, this.useData, this.useIteration);
+        const apiDocs = (0, apiDocLoader_1.loadApiDocumentation)({
+          apiNames: this.apiNames,
+          useData: this.useData
+        });
         if (apiDocs) {
           this.withSection(SystemPromptBuilder_1.CommonSections.API_DOCS, apiDocs);
         }
@@ -117275,6 +117627,83 @@ var require_CustomElementAgent2 = __commonJS({
   }
 });
 
+// dist/system-prompts/common/docLoader.js
+var require_docLoader = __commonJS({
+  "dist/system-prompts/common/docLoader.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;
+      };
+    })();
+    var __importDefault2 = exports2 && exports2.__importDefault || function(mod2) {
+      return mod2 && mod2.__esModule ? mod2 : { "default": mod2 };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.loadDocumentation = loadDocumentation;
+    var path_1 = __importDefault2(require("path"));
+    var fs4 = __importStar2(require("fs"));
+    function loadDocumentation(items, mapping) {
+      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 docPath = path_1.default.join(__dirname, "docs-output", "service-plugins", 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 ${item}:`, error);
+          }
+        }
+      }
+      return combinedContent.trim();
+    }
+  }
+});
+
 // dist/system-prompts/servicePlugin/servicePluginDocLoader.js
 var require_servicePluginDocLoader = __commonJS({
   "dist/system-prompts/servicePlugin/servicePluginDocLoader.js"(exports2) {
@@ -117297,7 +117726,7 @@ var require_servicePluginDocLoader = __commonJS({
       "ecom.catalog.getCatalogItems": "ecom-catalog-doc.txt"
     };
     function loadServicePluginDocumentation(spiNames) {
-      return (0, docLoader_1.loadDocumentation)(spiNames, SPI_TO_DOC_MAPPING, docLoader_1.DocType.SERVICE_PLUGIN);
+      return (0, docLoader_1.loadDocumentation)(spiNames, SPI_TO_DOC_MAPPING);
     }
   }
 });
@@ -118172,15 +118601,15 @@ var require_utils11 = __commonJS({
   }
 });
 
-// dist/agents/Iteration/iterationAgentsTools.js
-var require_iterationAgentsTools = __commonJS({
-  "dist/agents/Iteration/iterationAgentsTools.js"(exports2) {
+// dist/agents/Iteration/utils/extensionFormatters.js
+var require_extensionFormatters = __commonJS({
+  "dist/agents/Iteration/utils/extensionFormatters.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.formatIterationPlanExtension = void 0;
     exports2.formatEvaluationResultsExtensions = formatEvaluationResultsExtensions;
     exports2.formatContextExtensions = formatContextExtensions;
     exports2.formatScannedExtensions = formatScannedExtensions;
-    exports2.buildContextSections = buildContextSections;
     var utils_1 = require_utils11();
     function formatEvaluationResultsExtensions(extensions) {
       if (!extensions || extensions.length === 0)
@@ -118197,6 +118626,25 @@ var require_iterationAgentsTools = __commonJS({
         return lines.join("\n");
       }).join("\n\n");
     }
+    var formatIterationPlanExtension = ({ ext, id, outputPath }) => {
+      const lines = [
+        `**ID: ${id}**`,
+        `- Name: ${ext.extension.name}`,
+        `- Type: ${ext.extension.type}`,
+        `- Description: ${ext.extension.description}`
+      ];
+      const relevantFilesContent = (0, utils_1.loadRelevantFilesAsString)(ext.paths || [], outputPath);
+      if (relevantFilesContent && relevantFilesContent !== "None") {
+        lines.push(`- Relevant Files Content:
+${relevantFilesContent}`);
+      }
+      if (ext.extension.relatedSpis && ext.extension.relatedSpis.length > 0) {
+        lines.push(`- Current SPIs: ${ext.extension.relatedSpis.map((spi) => spi.name).join(", ")}`);
+      }
+      lines.push("");
+      return lines;
+    };
+    exports2.formatIterationPlanExtension = formatIterationPlanExtension;
     function formatContextExtensions(extensions) {
       if (!extensions || extensions.length === 0)
         return "None";
@@ -118221,6 +118669,15 @@ var require_iterationAgentsTools = __commonJS({
         return lines.join("\n");
       }).join("\n\n");
     }
+  }
+});
+
+// dist/agents/Iteration/utils/contextBuilders.js
+var require_contextBuilders = __commonJS({
+  "dist/agents/Iteration/utils/contextBuilders.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.buildContextSections = buildContextSections;
     function formatChatHistory(chatHistory) {
       return (chatHistory || []).map((message) => `${message.role.toUpperCase()}: ${message.text}`).join("\n\n");
     }
@@ -118261,7 +118718,8 @@ var require_IterationAgent = __commonJS({
     var ditto_codegen_types_12 = require_dist();
     var constants_1 = require_constants4();
     var codeGenerationService_12 = require_codeGenerationService();
-    var iterationAgentsTools_1 = require_iterationAgentsTools();
+    var extensionFormatters_1 = require_extensionFormatters();
+    var contextBuilders_1 = require_contextBuilders();
     var CurrentExtensionSchema = zod_1.z.object({
       extensionType: zod_1.z.enum(codegen_common_logic_1.codeGenerationExtensionTypes).describe("The extension kind to trigger"),
       name: zod_1.z.string().describe("A descriptive name for this extension"),
@@ -118310,13 +118768,13 @@ var require_IterationAgent = __commonJS({
         };
       }
       buildUserPrompt({ chatHistory, currentUserRequest, previousResources, extensionSelectorResult }) {
-        const sections = (0, iterationAgentsTools_1.buildContextSections)(chatHistory, currentUserRequest, previousResources);
+        const sections = (0, contextBuilders_1.buildContextSections)(chatHistory, currentUserRequest, previousResources);
         sections.push(`
 Relevant Existing Extensions:
-${(0, iterationAgentsTools_1.formatEvaluationResultsExtensions)(extensionSelectorResult.extensionsToModify)}`);
+${(0, extensionFormatters_1.formatEvaluationResultsExtensions)(extensionSelectorResult.extensionsToModify)}`);
         sections.push(`
 Context Extensions (already exist, don't need changes):
-${(0, iterationAgentsTools_1.formatContextExtensions)(extensionSelectorResult.contextExtensions)}`);
+${(0, extensionFormatters_1.formatContextExtensions)(extensionSelectorResult.contextExtensions)}`);
         return sections.join("\n\n");
       }
       async generate({ currentUserRequest, chatHistory, extensionSelectorResult, previousResources }) {
@@ -119672,7 +120130,8 @@ var require_ExtensionSelectorAgent = __commonJS({
     var ditto_codegen_types_12 = require_dist();
     var extension_selector_prompt_1 = require_extension_selector_prompt();
     var ditto_codegen_types_2 = require_dist();
-    var iterationAgentsTools_1 = require_iterationAgentsTools();
+    var contextBuilders_1 = require_contextBuilders();
+    var extensionFormatters_1 = require_extensionFormatters();
     var dedent_1 = __importDefault2(require_dedent());
     var customAnthropicProvider_1 = require_customAnthropicProvider();
     var constants_1 = require_constants4();
@@ -119767,10 +120226,10 @@ var require_ExtensionSelectorAgent = __commonJS({
         return submitCall.input;
       }
       buildUserPrompt({ chatHistory, currentUserRequest, previousResources, extensions, outputPath }) {
-        const sections = (0, iterationAgentsTools_1.buildContextSections)(chatHistory, currentUserRequest, previousResources);
+        const sections = (0, contextBuilders_1.buildContextSections)(chatHistory, currentUserRequest, previousResources);
         sections.push(`
 Extensions to Evaluate:
-${(0, iterationAgentsTools_1.formatScannedExtensions)(extensions, outputPath)}`);
+${(0, extensionFormatters_1.formatScannedExtensions)(extensions, outputPath)}`);
         return sections.join("\n\n");
       }
       async generate({ outputPath, extensions, chatHistory, currentUserRequest, previousResources }) {
@@ -119831,6 +120290,388 @@ ${(0, iterationAgentsTools_1.formatScannedExtensions)(extensions, outputPath)}`)
   }
 });
 
+// dist/system-prompts/sdkPickerAgent/sdk-picker-agent-instructions.js
+var require_sdk_picker_agent_instructions = __commonJS({
+  "dist/system-prompts/sdkPickerAgent/sdk-picker-agent-instructions.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.sdkPickerAgentApiDocsStructure = exports2.sdkPickerAgentConstraints = exports2.sdkPickerAgentRole = void 0;
+    exports2.sdkPickerAgentRole = `You are an SDK Picker Agent for a Wix app code generation system.
+Your job is to analyze an iteration plan and determine which Wix SDK APIs each extension needs to use.
+
+Given an iteration plan with current and additional extensions (each with a unique ID):
+1. **Review pre-loaded source code** to understand current implementation (for modifications)
+2. **Read relevant API documentation** using the read_api_doc tool to understand available Wix SDK methods
+3. **Analyze each extension's purpose** (from relevantUserRequest/description) to determine what APIs it needs
+4. **Score each API** based on its relevance and importance (0-100)
+5. **Return extension IDs with their related APIs, reasons, and scores**
+
+**CRITICAL GUIDELINES:**
+
+**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
+- Configuration/settings pages that only modify app settings DO NOT need relatedApis
+
+**How to Determine Needed APIs:**
+1. Read the extension's relevantUserRequest/description carefully
+2. If modifying existing code (currentExtensions), review the pre-loaded source files first
+3. Identify what Wix data/services the extension needs to interact with
+4. Use read_api_doc to explore available APIs for that domain
+5. Select the specific API methods needed (e.g., 'ecom.orders.getOrder', 'stores.productsV3.queryProducts')
+
+**IMPORTANT - Webhook Methods:**
+- **Webhook methods (e.g., data.items.onDataItemUpdated, ecom.orders.onOrderCreated) should ONLY be used for BACKEND_EVENT extensions**
+- Webhooks are event listeners that trigger when something happens in Wix (data updated, order created, etc.)
+- Common webhook patterns: \`on[Entity][Action]\` (e.g., onDataItemUpdated, onOrderCreated, onProductUpdated)
+- Only suggest webhooks when the extension type is specifically BACKEND_EVENT and needs to react to events in real-time
+
+**How to Score APIs (0-100):**
+- **90-100**: Critical/Core - Absolutely required for the extension to function
+- **70-89**: Important - Significantly enhances functionality, hard to work without
+- **50-69**: Useful - Adds value but alternatives exist
+- **30-49**: Optional - Nice to have, provides additional features
+- **0-29**: Low priority - Edge cases or rarely used
+
+**Scoring Considerations:**
+- Is it required or optional for the core functionality?
+- How frequently will it be called?
+- Are there alternative approaches without this API?
+- Does it directly fulfill the user's request?
+- Is it the primary data source or supplementary?
+
+**API Documentation Structure:**
+- API docs are organized by domain (ecom, stores, data, members, etc.)
+- Each file contains documentation for a specific API method
+- File naming pattern: {domain}-{method}-doc.txt (e.g., 'ecom-orders-getOrder-doc.txt')
+- Always read the full documentation before deciding to use an API
+
+**Source Code Analysis:**
+- Relevant source files are pre-loaded in the system prompt for your review
+- Look for existing API imports and usage patterns
+- Understand data flow and dependencies
+- Identify gaps where new APIs are needed
+
+**Output Format:**
+- Return an array of objects with 'id' and 'relatedApis' fields
+- Each relatedApi must include: api (name), reason (why it's needed), and score (0-100)
+- Use the exact IDs provided in the input (e.g., 'current-0', 'current-1', 'additional-0')
+- Only include extensions that need APIs
+- Be precise and intentional with API selections
+- **The system will automatically select the top 5 highest-scoring APIs per extension**`;
+    exports2.sdkPickerAgentConstraints = `- **REVIEW PRE-LOADED CODE**: Relevant source files are already loaded in the system prompt - review them first
+- **READ BEFORE DECIDING**: Always read API documentation before adding relatedApis to an extension
+- **BE SPECIFIC**: Use exact API method names from the documentation (e.g., 'ecom.orders.getOrder', not just 'orders')
+- **SCORE ACCURATELY**: Give honest scores - don't inflate scores, be realistic about importance
+- **BE MINIMAL BUT THOROUGH**: List all relevant APIs, but the system will keep only top 5 per extension
+- **EXPLAIN CLEARLY**: Each API must have a clear reason explaining its specific purpose
+- **UNDERSTAND CONTEXT**: Read the extension's description/relevantUserRequest to understand what it needs to do
+- **NO GUESSING**: If you're unsure about an API, read its documentation first
+- **CHECK EXISTING**: For modifications, check what APIs are already being used in the pre-loaded source files
+- **AVAILABLE APIS ONLY**: Only use APIs from the available documentation - don't invent API names`;
+    var sdkPickerAgentApiDocsStructure = ({ apiDocsStructure }) => `**Available API Documentation Files:**
+
+${apiDocsStructure}
+
+Use the read_api_doc tool with the file name to read any of these documentation files.`;
+    exports2.sdkPickerAgentApiDocsStructure = sdkPickerAgentApiDocsStructure;
+  }
+});
+
+// dist/system-prompts/sdkPickerAgent/sdk-picker-agent-prompt.js
+var require_sdk_picker_agent_prompt = __commonJS({
+  "dist/system-prompts/sdkPickerAgent/sdk-picker-agent-prompt.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.sdkPickerAgentPrompt = void 0;
+    var SystemPromptBuilder_1 = require_SystemPromptBuilder();
+    var sdk_picker_agent_instructions_1 = require_sdk_picker_agent_instructions();
+    var sdkPickerAgentPrompt = ({ apiDocsStructure }) => {
+      const systemPrompt = new SystemPromptBuilder_1.SystemPromptBuilder({
+        agentType: SystemPromptBuilder_1.GeneralAgentType.SDK_PICKER
+      }).withRole(sdk_picker_agent_instructions_1.sdkPickerAgentRole).withSection("constraints", sdk_picker_agent_instructions_1.sdkPickerAgentConstraints).withSection("api_docs_structure", (0, sdk_picker_agent_instructions_1.sdkPickerAgentApiDocsStructure)({ apiDocsStructure }));
+      return systemPrompt.compose();
+    };
+    exports2.sdkPickerAgentPrompt = sdkPickerAgentPrompt;
+  }
+});
+
+// dist/agents/Iteration/utils/apiHelpers.js
+var require_apiHelpers = __commonJS({
+  "dist/agents/Iteration/utils/apiHelpers.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.createApiMap = exports2.getValidExtensionIds = void 0;
+    var getValidExtensionIds = ({ iterationPlan }) => {
+      const validIds = /* @__PURE__ */ new Set();
+      iterationPlan.currentExtensions.forEach((_, idx) => {
+        validIds.add(`current-${idx}`);
+      });
+      iterationPlan.additionalExtensions.forEach((_, idx) => {
+        validIds.add(`additional-${idx}`);
+      });
+      return validIds;
+    };
+    exports2.getValidExtensionIds = getValidExtensionIds;
+    var createApiMap = ({ apiResult }) => {
+      const apiMap = /* @__PURE__ */ new Map();
+      apiResult.extensions.forEach((ext) => {
+        if (ext.relatedApis && ext.relatedApis.length > 0) {
+          const topApis = ext.relatedApis.sort((a, b) => b.score - a.score).slice(0, 5);
+          apiMap.set(ext.id, topApis);
+        }
+      });
+      return apiMap;
+    };
+    exports2.createApiMap = createApiMap;
+  }
+});
+
+// dist/agents/Iteration/SDKPickerAgent.js
+var require_SDKPickerAgent = __commonJS({
+  "dist/agents/Iteration/SDKPickerAgent.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.SDKPickerAgent = void 0;
+    var zod_1 = require_zod();
+    var sdk_picker_agent_prompt_1 = require_sdk_picker_agent_prompt();
+    var ditto_codegen_types_12 = require_dist();
+    var constants_1 = require_constants4();
+    var ai_1 = require_dist8();
+    var customAnthropicProvider_1 = require_customAnthropicProvider();
+    var path_1 = __importDefault2(require("path"));
+    var fs_1 = __importDefault2(require("fs"));
+    var tree_node_cli_1 = __importDefault2(require_src32());
+    var sdkConfig_1 = require_sdkConfig();
+    var extensionFormatters_1 = require_extensionFormatters();
+    var apiHelpers_1 = require_apiHelpers();
+    var apiHelpers_2 = require_apiHelpers();
+    var TOOL_NAMES = {
+      READ_API_DOC: "read_api_doc",
+      SUBMIT_PLAN: "submit_plan"
+    };
+    var API_NAMES = Object.keys(sdkConfig_1.SDK_METHODS_CONFIG);
+    var apiWithScoreSchema = zod_1.z.object({
+      api: zod_1.z.enum(API_NAMES).describe("The Wix API method name"),
+      reason: zod_1.z.string().describe("Clear explanation of why this API is needed for this extension and how it will be used"),
+      score: zod_1.z.number().min(0).max(100).describe("Relevance score from 0-100. Higher scores indicate more critical/relevant APIs. Consider: necessity (is it required?), frequency of use, impact on functionality, and whether there are alternatives.")
+    });
+    var extensionApiResultSchema = zod_1.z.object({
+      id: zod_1.z.string().describe("Unique identifier for this extension (use index-based ID like 'current-0', 'current-1', 'additional-0', etc.)"),
+      relatedApis: zod_1.z.array(apiWithScoreSchema).optional().describe("Optional array of Wix APIs with reasoning and scores. Read the API docs using read_api_doc tool to understand the APIs before specifying them. Leave empty if no APIs are needed.")
+    });
+    var sdkPickerResultSchema = zod_1.z.object({
+      extensions: zod_1.z.array(extensionApiResultSchema).describe("Array of extensions with their IDs and related APIs")
+    });
+    var readApiDocSchema = zod_1.z.object({
+      fileName: zod_1.z.string().describe("Name of the API documentation file to read (e.g., 'ecom-orders-getOrder-doc.txt')")
+    });
+    var validateExtensionIds = ({ result, validIds }) => {
+      return result.extensions.filter((ext) => !validIds.has(ext.id)).map((ext) => ext.id);
+    };
+    var SDKPickerAgent = class {
+      constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.name = "SDKPickerAgent";
+      }
+      async generate({ iterationPlan, outputPath }) {
+        if (iterationPlan.currentExtensions.length === 0 && iterationPlan.additionalExtensions.length === 0) {
+          return iterationPlan;
+        }
+        const apiDocsStructure = this.generateApiDocsFolderStructure();
+        const userMessage = this.buildUserPrompt({ iterationPlan, outputPath });
+        const systemPrompt = this.buildSystemPrompt({ apiDocsStructure });
+        try {
+          const model = (0, customAnthropicProvider_1.createCustomText)()(constants_1.LLM_MODELS.CLAUDE_3_5_HAIKU_LATEST, {
+            agentName: this.name
+          });
+          const result = await (0, ai_1.generateText)({
+            model,
+            tools: {
+              [TOOL_NAMES.READ_API_DOC]: this.createReadApiDocTool(),
+              [TOOL_NAMES.SUBMIT_PLAN]: this.createSubmitPlanTool({
+                iterationPlan
+              })
+            },
+            stopWhen: this.createStopCondition(),
+            messages: [
+              {
+                role: "system",
+                content: systemPrompt,
+                providerOptions: (0, ditto_codegen_types_12.withCaching)("1h")
+              },
+              { role: "user", content: userMessage }
+            ],
+            maxRetries: 3,
+            temperature: 0,
+            experimental_telemetry: { isEnabled: true, functionId: this.name }
+          });
+          const apiResult = this.extractSDKPickerResult({
+            toolCalls: result.toolCalls
+          });
+          if (!apiResult) {
+            throw new Error("Failed to extract SDK picker result from tool calls");
+          }
+          return this.mergeApisIntoIterationPlan({ iterationPlan, apiResult });
+        } catch (error) {
+          throw (0, ditto_codegen_types_12.toCodegenError)(error);
+        }
+      }
+      buildSystemPrompt({ apiDocsStructure }) {
+        return (0, sdk_picker_agent_prompt_1.sdkPickerAgentPrompt)({ apiDocsStructure });
+      }
+      buildUserPrompt({ iterationPlan, outputPath }) {
+        const sections = [
+          "## Iteration Plan to Enrich with Related APIs\n"
+        ];
+        if (iterationPlan.currentExtensions.length > 0) {
+          sections.push("### Current Extensions (to be modified):\n");
+          iterationPlan.currentExtensions.forEach((ext, idx) => {
+            sections.push(...(0, extensionFormatters_1.formatIterationPlanExtension)({
+              ext,
+              id: `current-${idx}`,
+              outputPath
+            }));
+          });
+        }
+        if (iterationPlan.additionalExtensions.length > 0) {
+          sections.push("### Additional Extensions (to be created):\n");
+          iterationPlan.additionalExtensions.forEach((ext, idx) => {
+            sections.push(...(0, extensionFormatters_1.formatIterationPlanExtension)({
+              ext,
+              id: `additional-${idx}`,
+              outputPath
+            }));
+          });
+        }
+        sections.push(`### Summary:
+${iterationPlan.summary}
+`);
+        return sections.join("\n");
+      }
+      getApiDocsDirectory() {
+        return path_1.default.join(__dirname, "docs-output", "api-docs");
+      }
+      generateApiDocsFolderStructure() {
+        const apiDocsPath = this.getApiDocsDirectory();
+        try {
+          return (0, tree_node_cli_1.default)(apiDocsPath, {
+            allFiles: true,
+            maxDepth: 3
+          });
+        } catch (error) {
+          console.error("Error generating api-docs folder structure:", error);
+          return "";
+        }
+      }
+      readApiDoc({ fileName }) {
+        try {
+          const apiDocsDir = this.getApiDocsDirectory();
+          const fullPath = path_1.default.join(apiDocsDir, fileName);
+          const normalizedFullPath = path_1.default.resolve(fullPath);
+          const normalizedApiDocsDir = path_1.default.resolve(apiDocsDir);
+          if (!normalizedFullPath.startsWith(normalizedApiDocsDir)) {
+            return {
+              error: `Access denied: Files outside api-docs folder are not allowed`
+            };
+          }
+          if (!fs_1.default.existsSync(fullPath)) {
+            return { error: `API documentation not found: ${fileName}` };
+          }
+          const content = fs_1.default.readFileSync(fullPath, "utf8");
+          return { fileName, content };
+        } catch (error) {
+          return {
+            error: `Failed to read API documentation: ${JSON.stringify(error)}`
+          };
+        }
+      }
+      createReadApiDocTool() {
+        return {
+          description: "Read Wix API documentation to understand available SDK methods, parameters, and return types. Use this when you need to know how to work with specific Wix APIs.",
+          inputSchema: readApiDocSchema,
+          execute: async ({ fileName }) => this.readApiDoc({ fileName })
+        };
+      }
+      createSubmitPlanTool({ iterationPlan }) {
+        return {
+          description: "Submit your final SDK picker results with extension IDs and their related APIs.",
+          inputSchema: sdkPickerResultSchema,
+          execute: async (params) => {
+            const validIds = (0, apiHelpers_1.getValidExtensionIds)({ iterationPlan });
+            const invalidIds = validateExtensionIds({ result: params, validIds });
+            if (invalidIds.length > 0) {
+              return {
+                error: `Invalid extension IDs found: ${invalidIds.join(", ")}. Valid IDs are: ${Array.from(validIds).join(", ")}`
+              };
+            }
+            return params;
+          }
+        };
+      }
+      createStopCondition() {
+        return ({ steps }) => {
+          const lastStep = steps[steps.length - 1];
+          const hasSuccessfulSubmit = lastStep?.toolCalls.some((toolCall) => toolCall.toolName === TOOL_NAMES.SUBMIT_PLAN && !("invalid" in toolCall) && !("error" in toolCall)) ?? false;
+          return hasSuccessfulSubmit;
+        };
+      }
+      extractSDKPickerResult({ toolCalls }) {
+        const submitCall = toolCalls.find((call) => call.toolName === TOOL_NAMES.SUBMIT_PLAN);
+        if (!submitCall) {
+          console.error("No submit_plan tool call found");
+          return null;
+        }
+        return submitCall.input;
+      }
+      mergeApisIntoIterationPlan({ iterationPlan, apiResult }) {
+        const apiMap = (0, apiHelpers_2.createApiMap)({ apiResult });
+        const enrichedCurrentExtensions = iterationPlan.currentExtensions.map((currentExtension, idx) => {
+          const relatedApis = apiMap.get(`current-${idx}`);
+          return {
+            ...currentExtension,
+            extension: this.enrichExtensionWithApis({
+              extension: currentExtension.extension,
+              relatedApis
+            })
+          };
+        });
+        const enrichedAdditionalExtensions = iterationPlan.additionalExtensions.map((additionalExtension, idx) => {
+          const relatedApis = apiMap.get(`additional-${idx}`);
+          return {
+            ...additionalExtension,
+            extension: this.enrichExtensionWithApis({
+              extension: additionalExtension.extension,
+              relatedApis
+            })
+          };
+        });
+        return {
+          currentExtensions: enrichedCurrentExtensions,
+          additionalExtensions: enrichedAdditionalExtensions,
+          summary: iterationPlan.summary
+        };
+      }
+      enrichExtensionWithApis({ extension, relatedApis }) {
+        if (!relatedApis || relatedApis.length === 0) {
+          return extension;
+        }
+        return {
+          ...extension,
+          relatedApis: relatedApis.map((apiWithScore) => ({
+            name: apiWithScore.api,
+            purpose: apiWithScore.reason
+          }))
+        };
+      }
+    };
+    exports2.SDKPickerAgent = SDKPickerAgent;
+  }
+});
+
 // dist/agents/AgentsFactory.js
 var require_AgentsFactory = __commonJS({
   "dist/agents/AgentsFactory.js"(exports2) {
@@ -119845,6 +120686,7 @@ var require_AgentsFactory = __commonJS({
     var ExtensionSelectorAgent_1 = require_ExtensionSelectorAgent();
     var AgentsRegistry_1 = require_AgentsRegistry();
     var ditto_codegen_types_12 = require_dist();
+    var SDKPickerAgent_1 = require_SDKPickerAgent();
     var AgentsFactory = class {
       constructor(apiKey, useIteration = false) {
         this.apiKey = apiKey;
@@ -119877,6 +120719,8 @@ var require_AgentsFactory = __commonJS({
             return new AutoPatternsGenerator_1.AutoPatternsGenerator();
           case "EXTENSION_SELECTOR":
             return new ExtensionSelectorAgent_1.ExtensionSelectorAgent(this.apiKey);
+          case "SDK_PICKER":
+            return new SDKPickerAgent_1.SDKPickerAgent(this.apiKey);
           default:
             throw new ditto_codegen_types_12.AgentConfigurationError(`Unsupported extension type for AI customization: ${extension.type}`, { extensionType: extension.type });
         }
@@ -349629,7 +350473,13 @@ var require_IterationOrchestrator = __commonJS({
           previousResources
         });
         this.validateEmbeddedScriptConstraint(extensions, iterationPlan);
-        return iterationPlan;
+        const sdkPickerAgent = this.agentsFactory.getAgent({ type: "SDK_PICKER" });
+        const enrichedIterationPlan = await sdkPickerAgent.generate({
+          iterationPlan,
+          outputPath
+        });
+        console.log("Final iteration plan:", JSON.stringify(enrichedIterationPlan, null, 2));
+        return enrichedIterationPlan;
       }
       validateEmbeddedScriptConstraint(extensions, iterationPlan) {
         const hasExistingEmbeddedScript = extensions.some((ext) => ext.type === types_1.ExtensionType.EMBEDDED_SCRIPT);