composio-scavio 0.5.3 → 0.6.1

package/dist/index.d.cts

@@ -36,6 +36,8 @@ interface BuildScavioToolkitOptions {
     enableCapterra?: boolean;
     enableGoogleAds?: boolean;
     enableMetaAds?: boolean;
+    enableHeb?: boolean;
+    enableKroger?: 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 +54,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,8 @@ interface BuildScavioToolkitOptions {
     enableCapterra?: boolean;
     enableGoogleAds?: boolean;
     enableMetaAds?: boolean;
+    enableHeb?: boolean;
+    enableKroger?: 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 +54,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,8 @@ function buildScavioToolkit(options = {}) {
     enableCapterra = false,
     enableGoogleAds = false,
     enableMetaAds = false,
+    enableHeb = false,
+    enableKroger = false,
     enableCrawl = false,
     pollIntervalMs = JOB_POLL_INTERVAL_MS,
     all = false
@@ -1568,7 +1570,7 @@ function buildScavioToolkit(options = {}) {
           page: onum("Results page, 1-based."),
           count: onum("Results per page, 1-28. Defaults to 24; Target rejects anything above 28 outright."),
           sort: ostr("Result sort order. Defaults to 'relevance'. Accepted values: 'relevance', 'featured', 'price_low', 'price_high', 'rating_high', 'best_seller', 'newest'."),
-          store_id: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991', the store target.com uses with no store context.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991', the store target.com uses with no store context.")
         }),
         (i) => client.target.search(i)
       ),
@@ -1581,7 +1583,7 @@ function buildScavioToolkit(options = {}) {
           page: onum("Results page, 1-based."),
           count: onum("Results per page, 1-28. Defaults to 24; Target rejects anything above 28 outright."),
           sort: ostr("Result sort order. Defaults to 'relevance'. Accepted values: 'relevance', 'featured', 'price_low', 'price_high', 'rating_high', 'best_seller', 'newest'."),
-          store_id: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991'.")
         }),
         (i) => client.target.category(i)
       ),
@@ -1591,7 +1593,7 @@ function buildScavioToolkit(options = {}) {
         "Target product details by TCIN: price, rating, images, specifications, variants, return policy, fulfillment. seller_id/seller_name are null for stock sold by Target. Costs 1 credit.",
         z.object({
           tcin: str("Target catalog id (tcin, e.g. '1010453160'). A colour/size child tcin is answered by its variation parent, with the child present in 'variants'."),
-          store_id: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991'.")
         }),
         (i) => client.target.product(i)
       ),
@@ -1602,9 +1604,21 @@ function buildScavioToolkit(options = {}) {
         z.object({
           tcin: str("Target catalog id (tcin, e.g. '1010453160')."),
           limit: onum("Trim the returned reviews to at most this many (1 or greater). Target publishes 8 anonymously and offers no paging, so this only trims."),
-          store_id: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991'.")
         }),
         (i) => client.target.reviews(i)
+      ),
+      tool(
+        "TARGET_AVAILABILITY",
+        "Scavio Target Availability",
+        "In-store stock for a Target product at every store near a ZIP: units available, in-store, pickup, curbside and ship-to-store status, distance, address and hours. Costs 1 credit.",
+        z.object({
+          tcin: str("Target catalog id (tcin, e.g. '85978609')."),
+          zip: str("5-digit US ZIP code to search around."),
+          radius: onum("Search radius in miles, 1-100. Defaults to 25. At most 20 stores."),
+          store_id: ostr("Return only this Target store. It must be within radius of zip.")
+        }),
+        (i) => client.target.availability(i)
       )
     );
   }
@@ -2446,6 +2460,67 @@ 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. 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. Server default 30.")
+        }),
+        (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. 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 (numeric id at the end of a product URL). Requires slug."),
+          slug: ostr("Product slug (readable part of the URL). Required with product_id.")
+        }),
+        (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 || enableExtract) {
     tools.push(
       tool(
@@ -2549,7 +2624,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
   });
 }