@oomol-lab/open-connector 1.9.1 → 1.9.3

package/src/providers/litescrape/amazon-schemas.js

@@ -0,0 +1,358 @@
+import { s } from "../../core/json-schema.js";
+export const amazonTools = [
+    {
+        name: "amazon_autocomplete",
+        path: "/api/amazon/autocomplete",
+        description: "Get Amazon search suggestions for a prefix and department. This upstream API is Alpha.",
+        input: s.object("Amazon Autocomplete parameters.", {
+            amazon_domain: s.string("Amazon storefront hostname."),
+            k: s.string("Partial search text to complete.", { minLength: 1 }),
+            amazon_department: s.string("Department alias used to narrow suggestions; aps searches all departments.", {
+                minLength: 1,
+                pattern: "^[a-zA-Z0-9_-]+$",
+            }),
+        }, { required: ["k"] }),
+        asyncInput: s.object("Amazon Autocomplete asynchronous parameters.", {
+            amazon_domain: s.string("Amazon storefront hostname."),
+            k: s.string("Partial search text to complete.", { minLength: 1 }),
+            amazon_department: s.string("Department alias used to narrow suggestions; aps searches all departments.", {
+                minLength: 1,
+                pattern: "^[a-zA-Z0-9_-]+$",
+            }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["k"] }),
+        output: s.looseObject("Amazon Autocomplete response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            suggestions: s.nullable(s.array("suggestions value.", s.looseObject("suggestions value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "amazon_featured_reviews",
+        path: "/api/amazon/featured-reviews",
+        description: "Get the featured reviews for an Amazon product. This upstream API is Alpha.",
+        input: s.object("Amazon Featured Reviews parameters.", {
+            asin: s.string("Ten-character product ASIN in the selected Amazon storefront.\n\nAmazon chooses review order. Sorting, star filters and verified-purchase filters are not supported.", { pattern: "^[A-Z0-9]{10}$" }),
+            amazon_domain: s.nullable(s.withEnum(s.unknown("Amazon storefront hostname. Omit for amazon.com. Supported on 23 storefronts; amazon.cn is not supported.\n\nUse an ASIN available in the selected storefront. Featured reviews can include international reviews. If featured reviews are unavailable, the request returns a failure rather than an empty review list."), [
+                "amazon.ae",
+                "amazon.ca",
+                "amazon.co.jp",
+                "amazon.co.uk",
+                "amazon.co.za",
+                "amazon.com",
+                "amazon.com.au",
+                "amazon.com.be",
+                "amazon.com.br",
+                "amazon.com.mx",
+                "amazon.com.tr",
+                "amazon.de",
+                "amazon.eg",
+                "amazon.es",
+                "amazon.fr",
+                "amazon.ie",
+                "amazon.in",
+                "amazon.it",
+                "amazon.nl",
+                "amazon.pl",
+                "amazon.sa",
+                "amazon.se",
+                "amazon.sg",
+            ])),
+        }, { required: ["asin"] }),
+        asyncInput: s.object("Amazon Featured Reviews asynchronous parameters.", {
+            asin: s.string("Ten-character product ASIN in the selected Amazon storefront.\n\nAmazon chooses review order. Sorting, star filters and verified-purchase filters are not supported.", { pattern: "^[A-Z0-9]{10}$" }),
+            amazon_domain: s.withEnum(s.unknown("Amazon storefront hostname. Omit for amazon.com. Supported on 23 storefronts; amazon.cn is not supported.\n\nUse an ASIN available in the selected storefront. Featured reviews can include international reviews. If featured reviews are unavailable, the request returns a failure rather than an empty review list."), [
+                "amazon.ae",
+                "amazon.ca",
+                "amazon.co.jp",
+                "amazon.co.uk",
+                "amazon.co.za",
+                "amazon.com",
+                "amazon.com.au",
+                "amazon.com.be",
+                "amazon.com.br",
+                "amazon.com.mx",
+                "amazon.com.tr",
+                "amazon.de",
+                "amazon.eg",
+                "amazon.es",
+                "amazon.fr",
+                "amazon.ie",
+                "amazon.in",
+                "amazon.it",
+                "amazon.nl",
+                "amazon.pl",
+                "amazon.sa",
+                "amazon.se",
+                "amazon.sg",
+            ]),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["asin"] }),
+        output: s.looseObject("Amazon Featured Reviews response.", {
+            source: s.withEnum(s.unknown("source value."), [
+                "amazon.ae",
+                "amazon.ca",
+                "amazon.co.jp",
+                "amazon.co.uk",
+                "amazon.co.za",
+                "amazon.com",
+                "amazon.com.au",
+                "amazon.com.be",
+                "amazon.com.br",
+                "amazon.com.mx",
+                "amazon.com.tr",
+                "amazon.de",
+                "amazon.eg",
+                "amazon.es",
+                "amazon.fr",
+                "amazon.ie",
+                "amazon.in",
+                "amazon.it",
+                "amazon.nl",
+                "amazon.pl",
+                "amazon.sa",
+                "amazon.se",
+                "amazon.sg",
+            ]),
+            asin: s.string("asin value."),
+            view: s.literal("featured", {
+                description: "view value.",
+            }),
+            coverage: s.literal("featured", {
+                description: "coverage value.",
+            }),
+            reviews: s.array("reviews value.", s.looseObject("reviews value. item.", {})),
+            pagination: s.looseObject("pagination value.", {}),
+            search_metadata: s.looseObject("search metadata value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "amazon_media_reviews",
+        path: "/api/amazon/media-reviews",
+        description: "Get Amazon reviews that include photos or videos. This upstream API is Alpha.",
+        input: s.object("Amazon Media Reviews parameters.", {
+            asin: s.nullable(s.string("Ten-character product ASIN in the selected Amazon storefront. Required for the first page.", {
+                pattern: "^[A-Z0-9]{10}$",
+            })),
+            amazon_domain: s.nullable(s.withEnum(s.unknown("Amazon storefront hostname. Omit for amazon.com. Supported on 23 storefronts; amazon.cn is not supported. Send page_token alone on continuation.\n\nUse an ASIN available in the selected storefront. Only reviews containing the selected media are returned. Review availability varies by storefront, product and request."), [
+                "amazon.ae",
+                "amazon.ca",
+                "amazon.co.jp",
+                "amazon.co.uk",
+                "amazon.co.za",
+                "amazon.com",
+                "amazon.com.au",
+                "amazon.com.be",
+                "amazon.com.br",
+                "amazon.com.mx",
+                "amazon.com.tr",
+                "amazon.de",
+                "amazon.eg",
+                "amazon.es",
+                "amazon.fr",
+                "amazon.ie",
+                "amazon.in",
+                "amazon.it",
+                "amazon.nl",
+                "amazon.pl",
+                "amazon.sa",
+                "amazon.se",
+                "amazon.sg",
+            ])),
+            view: s.nullable(s.withEnum(s.unknown("Media filter: media (default) for images and videos, images, or videos. Only reviews containing the selected media are returned.\n\nAmazon chooses review order. Sorting, star filters and verified-purchase filters are not supported."), ["media", "images", "videos"])),
+            page_token: s.nullable(s.string("Opaque continuation from pagination.next_page_token. Send it alone to fetch the next media-review page.\n\nPages can repeat a review when its media spans pages. Deduplicate by review id. If media reviews are unavailable, the request returns a failure rather than an empty review list.", { minLength: 5, maxLength: 8196, pattern: "^ar1\\.[A-Za-z0-9_-]+$" })),
+        }, { required: [] }),
+        asyncInput: s.object("Amazon Media Reviews asynchronous parameters.", {
+            asin: s.string("Ten-character product ASIN in the selected Amazon storefront. Required for the first page.", {
+                pattern: "^[A-Z0-9]{10}$",
+            }),
+            amazon_domain: s.withEnum(s.unknown("Amazon storefront hostname. Omit for amazon.com. Supported on 23 storefronts; amazon.cn is not supported. Send page_token alone on continuation.\n\nUse an ASIN available in the selected storefront. Only reviews containing the selected media are returned. Review availability varies by storefront, product and request."), [
+                "amazon.ae",
+                "amazon.ca",
+                "amazon.co.jp",
+                "amazon.co.uk",
+                "amazon.co.za",
+                "amazon.com",
+                "amazon.com.au",
+                "amazon.com.be",
+                "amazon.com.br",
+                "amazon.com.mx",
+                "amazon.com.tr",
+                "amazon.de",
+                "amazon.eg",
+                "amazon.es",
+                "amazon.fr",
+                "amazon.ie",
+                "amazon.in",
+                "amazon.it",
+                "amazon.nl",
+                "amazon.pl",
+                "amazon.sa",
+                "amazon.se",
+                "amazon.sg",
+            ]),
+            view: s.withEnum(s.unknown("Media filter: media (default) for images and videos, images, or videos. Only reviews containing the selected media are returned.\n\nAmazon chooses review order. Sorting, star filters and verified-purchase filters are not supported."), ["media", "images", "videos"]),
+            page_token: s.string("Opaque continuation from pagination.next_page_token. Send it alone to fetch the next media-review page.\n\nPages can repeat a review when its media spans pages. Deduplicate by review id. If media reviews are unavailable, the request returns a failure rather than an empty review list.", { minLength: 5, maxLength: 8196, pattern: "^ar1\\.[A-Za-z0-9_-]+$" }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: [] }),
+        output: s.looseObject("Amazon Media Reviews response.", {
+            source: s.withEnum(s.unknown("source value."), [
+                "amazon.ae",
+                "amazon.ca",
+                "amazon.co.jp",
+                "amazon.co.uk",
+                "amazon.co.za",
+                "amazon.com",
+                "amazon.com.au",
+                "amazon.com.be",
+                "amazon.com.br",
+                "amazon.com.mx",
+                "amazon.com.tr",
+                "amazon.de",
+                "amazon.eg",
+                "amazon.es",
+                "amazon.fr",
+                "amazon.ie",
+                "amazon.in",
+                "amazon.it",
+                "amazon.nl",
+                "amazon.pl",
+                "amazon.sa",
+                "amazon.se",
+                "amazon.sg",
+            ]),
+            asin: s.string("asin value."),
+            view: s.withEnum(s.unknown("view value."), ["media", "images", "videos"]),
+            coverage: s.literal("reviews_with_media", {
+                description: "coverage value.",
+            }),
+            reviews: s.array("reviews value.", s.looseObject("reviews value. item.", {})),
+            pagination: s.looseObject("pagination value.", {}),
+            search_metadata: s.looseObject("search metadata value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "amazon_product",
+        path: "/api/amazon/product",
+        description: "Get an Amazon product page, with optional seller offers. This upstream API is Alpha.",
+        input: s.object("Amazon Product parameters.", {
+            amazon_domain: s.string("Amazon storefront hostname."),
+            language: s.nullable(s.string("Storefront locale, such as en_US or ja_JP.", {
+                pattern: "^[a-z]{2}_[A-Z]{2}$",
+            })),
+            delivery_zip: s.nullable(s.string("Postal code used to determine delivery eligibility.", {
+                minLength: 1,
+                maxLength: 32,
+            })),
+            shipping_location: s.nullable(s.string("Two-letter destination country code.", { pattern: "^[A-Z]{2}$" })),
+            asin: s.string("Ten-character Amazon product identifier.", { pattern: "^[A-Z0-9]{10}$" }),
+            other_sellers: s.boolean("Fetch additional seller offers for this item."),
+            all_related_products: s.boolean("Fetch every page exposed by related-product carousels."),
+        }, { required: ["asin"] }),
+        asyncInput: s.object("Amazon Product asynchronous parameters.", {
+            amazon_domain: s.string("Amazon storefront hostname."),
+            language: s.string("Storefront locale, such as en_US or ja_JP.", {
+                pattern: "^[a-z]{2}_[A-Z]{2}$",
+            }),
+            delivery_zip: s.string("Postal code used to determine delivery eligibility.", {
+                minLength: 1,
+                maxLength: 32,
+            }),
+            shipping_location: s.string("Two-letter destination country code.", {
+                pattern: "^[A-Z]{2}$",
+            }),
+            asin: s.string("Ten-character Amazon product identifier.", { pattern: "^[A-Z0-9]{10}$" }),
+            other_sellers: s.boolean("Fetch additional seller offers for this item."),
+            all_related_products: s.boolean("Fetch every page exposed by related-product carousels."),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["asin"] }),
+        output: s.looseObject("Amazon Product response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            product_results: s.nullable(s.looseObject("product results value.", {})),
+            about_item: s.nullable(s.array("about item value.", s.string("about item value. item."))),
+            product_details: s.nullable(s.looseObject("product details value.", {})),
+            related_products: s.nullable(s.array("related products value.", s.looseObject("related products value. item.", {}))),
+            other_sellers: s.nullable(s.array("other sellers value.", s.looseObject("other sellers value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "amazon_search",
+        path: "/api/amazon/search",
+        description: "Search Amazon products. This upstream API is Alpha.",
+        input: s.object("Amazon Search parameters.", {
+            amazon_domain: s.string("Amazon storefront hostname."),
+            language: s.nullable(s.string("Storefront locale, such as en_US or ja_JP.", {
+                pattern: "^[a-z]{2}_[A-Z]{2}$",
+            })),
+            delivery_zip: s.nullable(s.string("Postal code used to determine delivery eligibility.", {
+                minLength: 1,
+                maxLength: 32,
+            })),
+            shipping_location: s.nullable(s.string("Two-letter destination country code.", { pattern: "^[A-Z]{2}$" })),
+            k: s.nullable(s.string("Search words. Supply either k or node.", { minLength: 1 })),
+            node: s.nullable(s.string("Browse category ID. Supply either node or k.", { pattern: "^[0-9]+$" })),
+            s: s.withEnum(s.unknown("Ordering for the product listings."), [
+                "relevanceblender",
+                "price-asc-rank",
+                "price-desc-rank",
+                "review-rank",
+                "date-desc-rank",
+                "exact-aware-popularity-rank",
+            ]),
+            rh: s.nullable(s.string("Comma-separated Amazon filter tokens, such as n:16318031,p_72:1248897011.")),
+            dc: s.boolean("Keep results tied to the original spelling of the query."),
+            page: s.integer("Result page to retrieve, starting at 1.", { minimum: 1 }),
+        }, { required: [] }),
+        asyncInput: s.object("Amazon Search asynchronous parameters.", {
+            amazon_domain: s.string("Amazon storefront hostname."),
+            language: s.string("Storefront locale, such as en_US or ja_JP.", {
+                pattern: "^[a-z]{2}_[A-Z]{2}$",
+            }),
+            delivery_zip: s.string("Postal code used to determine delivery eligibility.", {
+                minLength: 1,
+                maxLength: 32,
+            }),
+            shipping_location: s.string("Two-letter destination country code.", {
+                pattern: "^[A-Z]{2}$",
+            }),
+            k: s.string("Search words. Supply either k or node.", { minLength: 1 }),
+            node: s.string("Browse category ID. Supply either node or k.", { pattern: "^[0-9]+$" }),
+            s: s.withEnum(s.unknown("Ordering for the product listings."), [
+                "relevanceblender",
+                "price-asc-rank",
+                "price-desc-rank",
+                "review-rank",
+                "date-desc-rank",
+                "exact-aware-popularity-rank",
+            ]),
+            rh: s.string("Comma-separated Amazon filter tokens, such as n:16318031,p_72:1248897011."),
+            dc: s.boolean("Keep results tied to the original spelling of the query."),
+            page: s.integer("Result page to retrieve, starting at 1.", { minimum: 1 }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: [] }),
+        output: s.looseObject("Amazon Search response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            search_information: s.nullable(s.looseObject("search information value.", {})),
+            organic_results: s.nullable(s.array("organic results value.", s.looseObject("organic results value. item.", {}))),
+            product_ads: s.nullable(s.array("product ads value.", s.looseObject("product ads value. item.", {}))),
+            pagination: s.nullable(s.looseObject("pagination value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/apartments-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const apartmentsTools: DataTool[];

package/src/providers/litescrape/apartments-schemas.js

@@ -0,0 +1,45 @@
+import { s } from "../../core/json-schema.js";
+export const apartmentsTools = [
+    {
+        name: "apartments_property",
+        path: "/api/apartments/property",
+        description: "Get an Apartments.com property by URL. This upstream API is Alpha.",
+        input: s.object("Apartments.com Property parameters.", {
+            url: s.string("Apartments.com property URL ending in its seven-character listing ID, without query parameters.\n\nAlpha: availability may vary by location or property. Returns available fields for the requested property. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 2048 }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Apartments.com Property asynchronous parameters.", {
+            url: s.string("Apartments.com property URL ending in its seven-character listing ID, without query parameters.\n\nAlpha: availability may vary by location or property. Returns available fields for the requested property. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 2048 }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["url"] }),
+        output: s.looseObject("Apartments.com Property response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            property: s.looseObject("property value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apartments_search",
+        path: "/api/apartments/search",
+        description: "Search Apartments.com listings from a search URL. This upstream API is Alpha.",
+        input: s.object("Apartments.com Search parameters.", {
+            url: s.string("Apartments.com location search URL, including any price, bedroom, amenity or page filters.\n\nAlpha: availability may vary by location or property. Use the site URL to set filters or select a page. Follow pagination.next when present. Page links and total counts are included when available. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 4096 }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Apartments.com Search asynchronous parameters.", {
+            url: s.string("Apartments.com location search URL, including any price, bedroom, amenity or page filters.\n\nAlpha: availability may vary by location or property. Use the site URL to set filters or select a page. Follow pagination.next when present. Page links and total counts are included when available. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 4096 }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["url"] }),
+        output: s.looseObject("Apartments.com Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            properties: s.array("properties value.", s.looseObject("properties value. item.", {})),
+            search_information: s.looseObject("search information value.", {}),
+            pagination: s.looseObject("pagination value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/apple-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const appleTools: DataTool[];

package/src/providers/litescrape/apple-schemas.js

@@ -0,0 +1,215 @@
+import { s } from "../../core/json-schema.js";
+export const appleTools = [
+    {
+        name: "apple_app_store_product",
+        path: "/api/apple/app-store/product",
+        description: "Get an App Store app's details, ratings and version history.",
+        input: s.object("Apple App Store Product parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            type: s.literal("app", {
+                description: "App product type. Only app is supported.",
+            }),
+        }, { required: ["product_id"] }),
+        asyncInput: s.object("Apple App Store Product asynchronous parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            type: s.literal("app", {
+                description: "App product type. Only app is supported.",
+            }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["product_id"] }),
+        output: s.looseObject("Apple App Store Product response.", {
+            age_rating: s.nullable(s.string("age rating value.")),
+            description: s.nullable(s.string("description value.")),
+            developer: s.nullable(s.looseObject("developer value.", {})),
+            featured_in: s.nullable(s.array("featured in value.", s.looseObject("featured in value. item.", {}))),
+            id: s.nullable(s.string("id value.")),
+            in_app_purchases: s.nullable(s.string("in app purchases value.")),
+            information: s.nullable(s.looseObject("information value.", {})),
+            ipad_screenshots: s.nullable(s.array("ipad screenshots value.", s.string("ipad screenshots value. item."))),
+            iphone_screenshots: s.nullable(s.array("iphone screenshots value.", s.string("iphone screenshots value. item."))),
+            logo: s.nullable(s.string("logo value.")),
+            more_by_this_developer: s.nullable(s.looseObject("more by this developer value.", {})),
+            price: s.nullable(s.string("price value.")),
+            privacy: s.nullable(s.looseObject("privacy value.", {})),
+            rating: s.nullable(s.number("rating value.")),
+            rating_count: s.nullable(s.string("rating count value.")),
+            ratings_and_reviews: s.nullable(s.looseObject("ratings and reviews value.", {})),
+            snippet: s.nullable(s.string("snippet value.")),
+            title: s.nullable(s.string("title value.")),
+            version_history: s.nullable(s.array("version history value.", s.looseObject("version history value. item.", {}))),
+            you_may_also_like: s.nullable(s.looseObject("you may also like value.", {})),
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_app_store_reviews",
+        path: "/api/apple/app-store/reviews",
+        description: "Get reviews for an App Store app.",
+        input: s.object("Apple App Store Reviews parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            sort: s.withEnum(s.unknown("mostrecent or mosthelpful. Apple's Mac storefront always returns newest first."), [
+                "mostrecent",
+                "mosthelpful",
+            ]),
+            page: s.integer("One-based page number, from 1 through 2,147,483,647. Exhausted pages return an empty review list.", { minimum: 1, maximum: 2147483647 }),
+        }, { required: ["product_id"] }),
+        asyncInput: s.object("Apple App Store Reviews asynchronous parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            sort: s.withEnum(s.unknown("mostrecent or mosthelpful. Apple's Mac storefront always returns newest first."), [
+                "mostrecent",
+                "mosthelpful",
+            ]),
+            page: s.integer("One-based page number, from 1 through 2,147,483,647. Exhausted pages return an empty review list.", { minimum: 1, maximum: 2147483647 }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["product_id"] }),
+        output: s.looseObject("Apple App Store Reviews response.", {
+            reviews: s.nullable(s.array("reviews value.", s.looseObject("reviews value. item.", {}))),
+            search_information: s.nullable(s.looseObject("search information value.", {})),
+            raises: s.nullable(s.looseObject("raises value.", {})),
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_app_store_search",
+        path: "/api/apple/app-store/search",
+        description: "Search the App Store for iPhone, iPad and Mac apps.",
+        input: s.object("Apple App Store Search parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            term: s.string("Search term with 1 to 2,048 UTF-8 bytes of printable text, and at most 4,096 bytes after URL encoding.", { minLength: 1, maxLength: 2048 }),
+            lang: s.string("Language-region code, such as en-us or fr-fr.", {
+                pattern: "^[a-zA-Z]{2,3}-[a-zA-Z]{2}$",
+            }),
+            num: s.integer("Maximum results after filtering, from 1 through 200.", {
+                minimum: 1,
+                maximum: 200,
+            }),
+            disallow_explicit: s.boolean("Exclude explicit results when true."),
+            property: s.nullable(s.literal("developer", {
+                description: "Use developer to match developer names, ignoring case.",
+            })),
+            category_id: s.nullable(s.integer("Filter results by a native genre identifier, from 1 through 2,147,483,647.", {
+                minimum: 1,
+                maximum: 2147483647,
+            })),
+            device: s.withEnum(s.unknown("mobile for iPhone apps, tablet for iPad apps, or desktop for Mac apps."), [
+                "mobile",
+                "tablet",
+                "desktop",
+            ]),
+        }, { required: ["term"] }),
+        asyncInput: s.object("Apple App Store Search asynchronous parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            term: s.string("Search term with 1 to 2,048 UTF-8 bytes of printable text, and at most 4,096 bytes after URL encoding.", { minLength: 1, maxLength: 2048 }),
+            lang: s.string("Language-region code, such as en-us or fr-fr.", {
+                pattern: "^[a-zA-Z]{2,3}-[a-zA-Z]{2}$",
+            }),
+            num: s.integer("Maximum results after filtering, from 1 through 200.", {
+                minimum: 1,
+                maximum: 200,
+            }),
+            disallow_explicit: s.boolean("Exclude explicit results when true."),
+            property: s.literal("developer", {
+                description: "Use developer to match developer names, ignoring case.",
+            }),
+            category_id: s.integer("Filter results by a native genre identifier, from 1 through 2,147,483,647.", {
+                minimum: 1,
+                maximum: 2147483647,
+            }),
+            device: s.withEnum(s.unknown("mobile for iPhone apps, tablet for iPad apps, or desktop for Mac apps."), [
+                "mobile",
+                "tablet",
+                "desktop",
+            ]),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["term"] }),
+        output: s.looseObject("Apple App Store Search response.", {
+            organic_results: s.nullable(s.array("organic results value.", s.looseObject("organic results value. item.", {}))),
+            search_information: s.nullable(s.looseObject("search information value.", {})),
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_maps_places",
+        path: "/api/apple/maps/places",
+        description: "Search Apple Maps places.",
+        input: s.object("Apple Maps Places parameters.", {
+            muid: s.string("One or more Apple Maps unique place identifiers.\n\nSeparate multiple identifiers with commas. Accepted batch size: 1 through 50 unsigned 64-bit decimal IDs. Example: 4372355869446211302."),
+            locale: s.string("Controls Apple Maps language and regional formatting.\n\nExamples: en-US, fr-FR, ja-JP, and zh-TW."),
+        }, { required: ["muid"] }),
+        asyncInput: s.object("Apple Maps Places asynchronous parameters.", {
+            muid: s.string("One or more Apple Maps unique place identifiers.\n\nSeparate multiple identifiers with commas. Accepted batch size: 1 through 50 unsigned 64-bit decimal IDs. Example: 4372355869446211302."),
+            locale: s.string("Controls Apple Maps language and regional formatting.\n\nExamples: en-US, fr-FR, ja-JP, and zh-TW."),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["muid"] }),
+        output: s.looseObject("Apple Maps Places response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            place_results: s.nullable(s.array("place results value.", s.looseObject("place results value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_maps_reviews",
+        path: "/api/apple/maps/reviews",
+        description: "Get Apple ratings and reviews for an Apple Maps place.",
+        input: s.object("Apple Maps Reviews parameters.", {
+            muid: s.string("Exactly one unsigned 64-bit decimal Apple Maps MUID."),
+            locale: s.string("Apple Maps language and regional formatting."),
+        }, { required: ["muid"] }),
+        asyncInput: s.object("Apple Maps Reviews asynchronous parameters.", {
+            muid: s.string("Exactly one unsigned 64-bit decimal Apple Maps MUID."),
+            locale: s.string("Apple Maps language and regional formatting."),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["muid"] }),
+        output: s.looseObject("Apple Maps Reviews response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            search_information: s.nullable(s.looseObject("search information value.", {})),
+            place_info: s.nullable(s.looseObject("place info value.", {})),
+            reviews: s.nullable(s.array("reviews value.", s.looseObject("reviews value. item.", {}))),
+            ratings: s.nullable(s.looseObject("ratings value.", {})),
+            rating_summary: s.nullable(s.looseObject("rating summary value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/ashby-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const ashbyTools: DataTool[];