composio-scavio 0.6.0 → 0.6.2

package/dist/index.d.cts

@@ -36,6 +36,9 @@ interface BuildScavioToolkitOptions {
     enableCapterra?: boolean;
     enableGoogleAds?: boolean;
     enableMetaAds?: boolean;
+    enableHeb?: boolean;
+    enableKroger?: boolean;
+    enableDecathlon?: boolean;
     /**
      * Website map, crawl and batch extract (five tools: MAP_WEBSITE, CRAWL_WEBSITE,
      * CRAWL_STATUS, BATCH_EXTRACT, BATCH_STATUS). Opt-in: a crawl bills per page.
@@ -52,7 +55,7 @@ interface BuildScavioToolkitOptions {
 /**
  * Build a Composio custom toolkit exposing Scavio search tools.
  *
- * Scavio is a single Search API over Google, YouTube, Amazon, Walmart, Reddit,
+ * Scavio is a single Search API over Google, YouTube, Amazon, Walmart, HEB, Kroger, Reddit,
  * TikTok, TikTok Shop, Instagram, X and LinkedIn; this toolkit covers all ten.
  * Pass to `composio.create(userId, { experimental:
  * { customToolkits: [toolkit] } })`. Agent-facing slugs are prefixed `LOCAL_SCAVIO_`.

package/dist/index.d.ts

@@ -36,6 +36,9 @@ interface BuildScavioToolkitOptions {
     enableCapterra?: boolean;
     enableGoogleAds?: boolean;
     enableMetaAds?: boolean;
+    enableHeb?: boolean;
+    enableKroger?: boolean;
+    enableDecathlon?: boolean;
     /**
      * Website map, crawl and batch extract (five tools: MAP_WEBSITE, CRAWL_WEBSITE,
      * CRAWL_STATUS, BATCH_EXTRACT, BATCH_STATUS). Opt-in: a crawl bills per page.
@@ -52,7 +55,7 @@ interface BuildScavioToolkitOptions {
 /**
  * Build a Composio custom toolkit exposing Scavio search tools.
  *
- * Scavio is a single Search API over Google, YouTube, Amazon, Walmart, Reddit,
+ * Scavio is a single Search API over Google, YouTube, Amazon, Walmart, HEB, Kroger, Reddit,
  * TikTok, TikTok Shop, Instagram, X and LinkedIn; this toolkit covers all ten.
  * Pass to `composio.create(userId, { experimental:
  * { customToolkits: [toolkit] } })`. Agent-facing slugs are prefixed `LOCAL_SCAVIO_`.

package/dist/index.js

@@ -104,6 +104,9 @@ function buildScavioToolkit(options = {}) {
     enableCapterra = false,
     enableGoogleAds = false,
     enableMetaAds = false,
+    enableHeb = false,
+    enableKroger = false,
+    enableDecathlon = false,
     enableCrawl = false,
     pollIntervalMs = JOB_POLL_INTERVAL_MS,
     all = false
@@ -2458,6 +2461,95 @@ function buildScavioToolkit(options = {}) {
       )
     );
   }
+  if (all || enableHeb) {
+    tools.push(
+      tool(
+        "HEB_SEARCH",
+        "Scavio HEB Search",
+        "Search HEB grocery products: price in cents, sale status, unit price, size, UPC, stock, EBT/SNAP eligibility, aisle location and product URL. Pass store_id for one store's prices, stock and assortment. Costs 2 credits.",
+        z.object({
+          query: str("Search keywords (1-200 characters)."),
+          page: onum("Results page, 1-based (1-100)."),
+          page_size: onum("Results per page, 1-60. Defaults to 60."),
+          store_id: ostr("HEB store number from the HEB stores tool (store_number), e.g. '441'. Prices, stock, aisle location and assortment come from that store; the store used is echoed in data.store {store_id, name}. US only. Omit for HEB's default store.")
+        }),
+        (i) => client.heb.search(i)
+      ),
+      tool(
+        "HEB_PRODUCT",
+        "Scavio HEB Product",
+        "Full HEB product detail: nutrition facts, ingredients, description, images, similar products, coupons, EBT/SNAP eligibility and breadcrumbs. Pass product_url (from search) or slug + product_id; with store_id, product_id alone works and price, stock and aisle are for that store. Costs 2 credits.",
+        z.object({
+          product_url: ostr("Full or relative product URL from heb.com. Preferred over slug + product_id."),
+          product_id: ostr("HEB product id. Needs slug, unless store_id is set (then product_id alone works)."),
+          slug: ostr("Product slug (readable part of the URL). Required with product_id unless store_id is set."),
+          store_id: ostr("HEB store number from the HEB stores tool (store_number), e.g. '441'. Prices, stock, aisle location and assortment come from that store; the store used is echoed in data.store {store_id, name}. US only. Omit for HEB's default store.")
+        }),
+        (i) => client.heb.product(i)
+      ),
+      tool(
+        "HEB_STORES",
+        "Scavio HEB Stores",
+        "HEB stores near a US ZIP code or city: store number, address, phone, hours, pharmacy availability, fulfillment channels, distance and store URL. Pass zip or city. Costs 2 credits.",
+        z.object({
+          zip: ostr("5-digit US ZIP code (e.g. '78701')."),
+          city: ostr("City name (e.g. 'Austin'). Pass zip or city.")
+        }),
+        (i) => client.heb.stores(i)
+      )
+    );
+  }
+  if (all || enableKroger) {
+    tools.push(
+      tool(
+        "KROGER_SEARCH",
+        "Scavio Kroger Search",
+        "Search Kroger grocery products: price in cents, promo price, n-for deals, unit price, size, UPC, stock, SNAP eligibility, dietary info, rating and category. Kroger operates Kroger, Ralphs, Fred Meyer, Harris Teeter, King Soopers and Fry's. Costs 2 credits.",
+        z.object({
+          query: str("Search keywords (1-200 characters)."),
+          page: onum("Results page, 1-based (1-100).")
+        }),
+        (i) => client.kroger.search(i)
+      ),
+      tool(
+        "KROGER_PRODUCT",
+        "Scavio Kroger Product",
+        "Full Kroger product detail by URL or UPC: nutrition facts, allergens, ingredients, nutrients with daily values, description, images, rating distribution, store aisle, stock, dietary flags, SNAP eligibility, dimensions and country of origin. Costs 2 credits.",
+        z.object({
+          product_url: ostr("Full or relative product URL from kroger.com. Preferred."),
+          upc: ostr("Kroger product UPC (from search or product URLs: /p/{slug}/{upc})."),
+          slug: ostr("Product slug for readable URL. Optional with upc.")
+        }),
+        (i) => client.kroger.product(i)
+      )
+    );
+  }
+  if (all || enableDecathlon) {
+    tools.push(
+      tool(
+        "DECATHLON_SEARCH",
+        "Scavio Decathlon Search",
+        "Search Decathlon products by keyword across 7 country domains (FR, ES, IT, IN, UK, PT, NET). Returns product name, brand, price (cents), currency, availability, rating, review count and image. Costs 2 credits.",
+        z.object({
+          query: str("Search keywords (1-200 characters)."),
+          country: z.enum(["fr", "es", "it", "in", "uk", "pt", "net"]).describe("Country domain."),
+          page: onum("Results page, 1-based (1-50).")
+        }),
+        (i) => client.decathlon.search(i)
+      ),
+      tool(
+        "DECATHLON_PRODUCT",
+        "Scavio Decathlon Product",
+        "Full Decathlon product detail by URL or product ID: description, images, SKU, GTIN, color, price (cents), list price, availability, offers/variants, rating, review count, category and breadcrumbs. Costs 2 credits.",
+        z.object({
+          product_url: ostr("Full or relative product URL from any Decathlon domain. Preferred."),
+          product_id: ostr("Decathlon numeric product ID."),
+          country: z.enum(["fr", "es", "it", "in", "uk", "pt", "net"]).describe("Country domain.")
+        }),
+        (i) => client.decathlon.product(i)
+      )
+    );
+  }
   if (all || enableExtract) {
     tools.push(
       tool(
@@ -2561,7 +2653,7 @@ function buildScavioToolkit(options = {}) {
   }
   return experimental_createToolkit("SCAVIO", {
     name: "Scavio",
-    description: "Real-time structured search over 31 platforms - Google (SERP, AI Mode, Maps, Shopping, Flights, Hotels, News, Trends), YouTube, Amazon, Walmart, eBay, Target, Home Depot, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, Threads, Kuaishou, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library - plus extract, which reads any URL as Markdown, plain text or raw HTML, and website map, crawl and batch extract.",
+    description: "Real-time structured search over 33 platforms - Google (SERP, AI Mode, Maps, Shopping, Flights, Hotels, News, Trends), YouTube, Amazon, Walmart, eBay, Target, Home Depot, HEB, Kroger, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, Threads, Kuaishou, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library - plus extract, which reads any URL as Markdown, plain text or raw HTML, and website map, crawl and batch extract.",
     tools
   });
 }