@oomol-lab/open-connector 1.9.1 → 1.9.2

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

@@ -0,0 +1,300 @@
+import { s } from "../../core/json-schema.js";
+export const ebayTools = [
+    {
+        name: "ebay_product",
+        path: "/api/ebay/product",
+        description: "Get an eBay listing by item ID.",
+        input: s.object("eBay Product parameters.", {
+            ebay_domain: s.withEnum(s.unknown("eBay marketplace hostname."), [
+                "ebay.com",
+                "ebay.co.uk",
+                "ebay.ca",
+                "ebay.com.au",
+                "ebay.de",
+                "ebay.fr",
+                "ebay.it",
+                "ebay.es",
+                "ebay.at",
+                "ebay.be",
+                "ebay.ch",
+                "ebay.ie",
+                "ebay.nl",
+                "ebay.com.hk",
+                "ebay.com.my",
+                "ebay.pl",
+                "ebay.com.sg",
+            ]),
+            product_id: s.string("12-digit eBay listing ID from search results or an /itm/ URL.", {
+                pattern: "^[0-9]{12}$",
+            }),
+            locale: s.nullable(s.string("Country code for eBay's localized interface, e.g. US, JP, CA.")),
+            lang: s.nullable(s.string("Interface language override; requires locale and ebay.com.", {
+                maxLength: 12,
+                pattern: "^[a-z]{2,3}(?:-[A-Za-z]{2,4})?$",
+            })),
+            shipping_country: s.nullable(s.string("Two-letter destination country code for shipping calculations.")),
+        }, { required: ["product_id"] }),
+        asyncInput: s.object("eBay Product asynchronous parameters.", {
+            ebay_domain: s.withEnum(s.unknown("eBay marketplace hostname."), [
+                "ebay.com",
+                "ebay.co.uk",
+                "ebay.ca",
+                "ebay.com.au",
+                "ebay.de",
+                "ebay.fr",
+                "ebay.it",
+                "ebay.es",
+                "ebay.at",
+                "ebay.be",
+                "ebay.ch",
+                "ebay.ie",
+                "ebay.nl",
+                "ebay.com.hk",
+                "ebay.com.my",
+                "ebay.pl",
+                "ebay.com.sg",
+            ]),
+            product_id: s.string("12-digit eBay listing ID from search results or an /itm/ URL.", {
+                pattern: "^[0-9]{12}$",
+            }),
+            locale: s.string("Country code for eBay's localized interface, e.g. US, JP, CA."),
+            lang: s.string("Interface language override; requires locale and ebay.com.", {
+                maxLength: 12,
+                pattern: "^[a-z]{2,3}(?:-[A-Za-z]{2,4})?$",
+            }),
+            shipping_country: s.string("Two-letter destination country code for shipping calculations."),
+            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("eBay Product response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            product_results: s.looseObject("product results value.", {}),
+            seller_results: s.nullable(s.looseObject("seller results value.", {})),
+            related_products: s.nullable(s.array("related products value.", s.looseObject("related products value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "ebay_search",
+        path: "/api/ebay/search",
+        description: "Search eBay listings by keyword or category.",
+        input: s.object("eBay Search parameters.", {
+            ebay_domain: s.withEnum(s.unknown("eBay marketplace hostname."), [
+                "ebay.com",
+                "ebay.co.uk",
+                "ebay.ca",
+                "ebay.com.au",
+                "ebay.de",
+                "ebay.fr",
+                "ebay.it",
+                "ebay.es",
+                "ebay.at",
+                "ebay.be",
+                "ebay.ch",
+                "ebay.ie",
+                "ebay.nl",
+                "ebay.com.hk",
+                "ebay.com.my",
+                "ebay.pl",
+                "ebay.com.sg",
+            ]),
+            _nkw: s.nullable(s.string("Search keywords. Required unless category_id is supplied.", {
+                minLength: 1,
+                maxLength: 500,
+            })),
+            category_id: s.nullable(s.integer("eBay category ID.", { minimum: 1, maximum: 2147483647 })),
+            _pgn: s.integer("Result page, starting at 1.", { minimum: 1, maximum: 2147483647 }),
+            _ipg: s.withEnum(s.unknown("Requested results per page. eBay may adjust the page size."), [25, 50, 100, 200]),
+            _sop: s.withEnum(s.unknown("Sort: 12 best match, 1 ending soonest, 10 newly listed, 7 nearest, 15/16 total price ascending/descending, 2/3 item price ascending/descending, 18/19 condition new/used first. Availability depends on marketplace."), [1, 2, 3, 7, 10, 12, 15, 16, 18, 19]),
+            _udlo: s.nullable(s.number("Minimum item price.", { minimum: 0 })),
+            _udhi: s.nullable(s.number("Maximum item price.", { minimum: 0 })),
+            buying_format: s.nullable(s.withEnum(s.unknown("Auction, Buy It Now (BIN), or accepts offers (BO)."), ["Auction", "BIN", "BO"])),
+            LH_ItemCondition: s.nullable(s.string("Condition IDs joined with |, such as 1000|3000.", {
+                pattern: "^[0-9]{1,4}(\\|[0-9]{1,4}){0,9}$",
+            })),
+            _stpos: s.nullable(s.string("Destination postal code used by eBay for shipping estimates.", {
+                minLength: 1,
+                maxLength: 20,
+            })),
+            _salic: s.nullable(s.integer("eBay item-location country ID, e.g. 1 US, 2 Canada, 3 UK.")),
+            _blrs: s.nullable(s.literal("spell_auto_correct", {
+                description: "Exclude automatic spelling corrections.",
+            })),
+            show_only: s.nullable(s.string("Comma-separated filters: FR, RPA, AS, Savings, SaleItems, Lots, Charity, AV, FS, LPickup.", {
+                maxLength: 100,
+            })),
+            _sasl: s.nullable(s.string("Comma-separated eBay seller usernames.", { maxLength: 1000 })),
+            _saslop: s.withEnum(s.unknown("Include (1) or exclude (2) the sellers in _sasl."), [1, 2]),
+            popular_filters: s.nullable(s.string("eBay aspect filters as key=value pairs joined with &, with multiple values joined by |. Percent-encoded names are accepted.", { maxLength: 4000 })),
+            _dmd: s.nullable(s.withEnum(s.unknown("Result layout."), ["Grid", "List"])),
+            LH_PrefLoc: s.nullable(s.withEnum(s.unknown("Item location relative to the marketplace."), ["Domestic", "Regional", "Worldwide"])),
+        }, { required: [] }),
+        asyncInput: s.object("eBay Search asynchronous parameters.", {
+            ebay_domain: s.withEnum(s.unknown("eBay marketplace hostname."), [
+                "ebay.com",
+                "ebay.co.uk",
+                "ebay.ca",
+                "ebay.com.au",
+                "ebay.de",
+                "ebay.fr",
+                "ebay.it",
+                "ebay.es",
+                "ebay.at",
+                "ebay.be",
+                "ebay.ch",
+                "ebay.ie",
+                "ebay.nl",
+                "ebay.com.hk",
+                "ebay.com.my",
+                "ebay.pl",
+                "ebay.com.sg",
+            ]),
+            _nkw: s.string("Search keywords. Required unless category_id is supplied.", {
+                minLength: 1,
+                maxLength: 500,
+            }),
+            category_id: s.integer("eBay category ID.", { minimum: 1, maximum: 2147483647 }),
+            _pgn: s.integer("Result page, starting at 1.", { minimum: 1, maximum: 2147483647 }),
+            _ipg: s.withEnum(s.unknown("Requested results per page. eBay may adjust the page size."), [25, 50, 100, 200]),
+            _sop: s.withEnum(s.unknown("Sort: 12 best match, 1 ending soonest, 10 newly listed, 7 nearest, 15/16 total price ascending/descending, 2/3 item price ascending/descending, 18/19 condition new/used first. Availability depends on marketplace."), [1, 2, 3, 7, 10, 12, 15, 16, 18, 19]),
+            _udlo: s.number("Minimum item price.", { minimum: 0 }),
+            _udhi: s.number("Maximum item price.", { minimum: 0 }),
+            buying_format: s.withEnum(s.unknown("Auction, Buy It Now (BIN), or accepts offers (BO)."), [
+                "Auction",
+                "BIN",
+                "BO",
+            ]),
+            LH_ItemCondition: s.string("Condition IDs joined with |, such as 1000|3000.", {
+                pattern: "^[0-9]{1,4}(\\|[0-9]{1,4}){0,9}$",
+            }),
+            _stpos: s.string("Destination postal code used by eBay for shipping estimates.", {
+                minLength: 1,
+                maxLength: 20,
+            }),
+            _salic: s.integer("eBay item-location country ID, e.g. 1 US, 2 Canada, 3 UK."),
+            _blrs: s.literal("spell_auto_correct", {
+                description: "Exclude automatic spelling corrections.",
+            }),
+            show_only: s.string("Comma-separated filters: FR, RPA, AS, Savings, SaleItems, Lots, Charity, AV, FS, LPickup.", { maxLength: 100 }),
+            _sasl: s.string("Comma-separated eBay seller usernames.", { maxLength: 1000 }),
+            _saslop: s.withEnum(s.unknown("Include (1) or exclude (2) the sellers in _sasl."), [1, 2]),
+            popular_filters: s.string("eBay aspect filters as key=value pairs joined with &, with multiple values joined by |. Percent-encoded names are accepted.", { maxLength: 4000 }),
+            _dmd: s.withEnum(s.unknown("Result layout."), ["Grid", "List"]),
+            LH_PrefLoc: s.withEnum(s.unknown("Item location relative to the marketplace."), [
+                "Domestic",
+                "Regional",
+                "Worldwide",
+            ]),
+            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("eBay Search response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            search_information: s.looseObject("search information value.", {}),
+            organic_results: s.array("organic results value.", s.looseObject("organic results value. item.", {})),
+            categories: s.nullable(s.array("categories value.", s.looseObject("categories value. item.", {}))),
+            related_searches: s.nullable(s.array("related searches value.", s.looseObject("related searches value. item.", {}))),
+            pagination: s.looseObject("pagination value.", {}),
+            litescrape_pagination: s.nullable(s.looseObject("litescrape pagination value.", {})),
+            deals: s.nullable(s.looseObject("deals value.", {})),
+            inline_categories: s.nullable(s.array("inline categories value.", s.looseObject("inline categories value. item.", {}))),
+            inline_results: s.nullable(s.array("inline results value.", s.looseObject("inline results value. item.", {}))),
+            popular_filters: s.nullable(s.array("popular filters value.", s.looseObject("popular filters value. item.", {}))),
+            related_items: s.nullable(s.array("related items value.", s.looseObject("related items value. item.", {}))),
+            review_highlights: s.nullable(s.array("review highlights value.", s.looseObject("review highlights value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "ebay_seller",
+        path: "/api/ebay/seller",
+        description: "Get an eBay seller's profile and listings.",
+        input: s.object("eBay Seller parameters.", {
+            ebay_domain: s.withEnum(s.unknown("eBay marketplace hostname."), [
+                "ebay.com",
+                "ebay.co.uk",
+                "ebay.ca",
+                "ebay.com.au",
+                "ebay.de",
+                "ebay.fr",
+                "ebay.it",
+                "ebay.es",
+                "ebay.at",
+                "ebay.be",
+                "ebay.ch",
+                "ebay.ie",
+                "ebay.nl",
+                "ebay.com.hk",
+                "ebay.com.my",
+                "ebay.pl",
+                "ebay.com.sg",
+            ]),
+            seller_id: s.string("Seller username for type=user, or the store URL slug for type=store.", {
+                pattern: "^[A-Za-z0-9][A-Za-z0-9_.*-]{0,99}$",
+            }),
+            type: s.withEnum(s.unknown("Public seller profile type."), ["user", "store"]),
+            _pgn: s.integer("Result page, starting at 1.", { minimum: 1, maximum: 2147483647 }),
+            _ipg: s.withEnum(s.unknown("Products per page."), [24, 48, 72]),
+            _sop: s.withEnum(s.unknown("Sort: 12 best match, 1 ending soonest, 7 nearest, 10 newly listed, 15/16 total price ascending/descending."), [1, 7, 10, 12, 15, 16]),
+            buying_format: s.withEnum(s.unknown("All listings (0), Buy It Now (1), or auctions (2)."), [0, 1, 2]),
+            LH_ItemCondition: s.nullable(s.string("Condition IDs joined with |: 3 new, 4 used, 10 unspecified.", {
+                maxLength: 20,
+                pattern: "^(?:3|4|10)(?:\\|(?:3|4|10))*$",
+            })),
+            free_shipping: s.boolean("Only products with free shipping."),
+        }, { required: ["seller_id", "type"] }),
+        asyncInput: s.object("eBay Seller asynchronous parameters.", {
+            ebay_domain: s.withEnum(s.unknown("eBay marketplace hostname."), [
+                "ebay.com",
+                "ebay.co.uk",
+                "ebay.ca",
+                "ebay.com.au",
+                "ebay.de",
+                "ebay.fr",
+                "ebay.it",
+                "ebay.es",
+                "ebay.at",
+                "ebay.be",
+                "ebay.ch",
+                "ebay.ie",
+                "ebay.nl",
+                "ebay.com.hk",
+                "ebay.com.my",
+                "ebay.pl",
+                "ebay.com.sg",
+            ]),
+            seller_id: s.string("Seller username for type=user, or the store URL slug for type=store.", {
+                pattern: "^[A-Za-z0-9][A-Za-z0-9_.*-]{0,99}$",
+            }),
+            type: s.withEnum(s.unknown("Public seller profile type."), ["user", "store"]),
+            _pgn: s.integer("Result page, starting at 1.", { minimum: 1, maximum: 2147483647 }),
+            _ipg: s.withEnum(s.unknown("Products per page."), [24, 48, 72]),
+            _sop: s.withEnum(s.unknown("Sort: 12 best match, 1 ending soonest, 7 nearest, 10 newly listed, 15/16 total price ascending/descending."), [1, 7, 10, 12, 15, 16]),
+            buying_format: s.withEnum(s.unknown("All listings (0), Buy It Now (1), or auctions (2)."), [0, 1, 2]),
+            LH_ItemCondition: s.string("Condition IDs joined with |: 3 new, 4 used, 10 unspecified.", {
+                maxLength: 20,
+                pattern: "^(?:3|4|10)(?:\\|(?:3|4|10))*$",
+            }),
+            free_shipping: s.boolean("Only products with free shipping."),
+            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: ["seller_id", "type"] }),
+        output: s.looseObject("eBay Seller response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            seller_results: s.looseObject("seller results value.", {}),
+            product_results: s.array("product results value.", s.looseObject("product results value. item.", {})),
+            featured_categories: s.nullable(s.array("featured categories value.", s.looseObject("featured categories value. item.", {}))),
+            about: s.nullable(s.looseObject("about value.", {})),
+            feedback: s.nullable(s.looseObject("feedback value.", {})),
+            pagination: s.looseObject("pagination value.", {}),
+            litescrape_pagination: s.nullable(s.looseObject("litescrape pagination value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

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

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

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

@@ -0,0 +1,52 @@
+import { s } from "../../core/json-schema.js";
+export const etsyTools = [
+    {
+        name: "etsy_product",
+        path: "/api/etsy/product",
+        description: "Get an Etsy listing's details and price. This upstream API is Alpha.",
+        input: s.object("Etsy Product parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Etsy Product asynchronous parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                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("Etsy Product response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            product: s.looseObject("product value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "etsy_search",
+        path: "/api/etsy/search",
+        description: "Search Etsy listings with prices. This upstream API is Alpha.",
+        input: s.object("Etsy Search parameters.", {
+            query: s.string("Product keywords to search for.", { minLength: 1, maxLength: 500 }),
+            page: s.integer("One-based result page.", { minimum: 1, maximum: 100 }),
+        }, { required: ["query"] }),
+        asyncInput: s.object("Etsy Search asynchronous parameters.", {
+            query: s.string("Product keywords to search for.", { minLength: 1, maxLength: 500 }),
+            page: s.integer("One-based result page.", { minimum: 1, maximum: 100 }),
+            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: ["query"] }),
+        output: s.looseObject("Etsy Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            products: s.array("products value.", s.looseObject("products value. item.", {})),
+            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/eventbrite-schemas.d.ts

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

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

@@ -0,0 +1,43 @@
+import { s } from "../../core/json-schema.js";
+export const eventbriteTools = [
+    {
+        name: "eventbrite_search",
+        path: "/api/eventbrite/search",
+        description: "Search Eventbrite events by location and keyword.",
+        input: s.object("Eventbrite Search parameters.", {
+            location: s.string("Eventbrite location slug, such as tx--austin, ny--new-york, or online.", {
+                maxLength: 150,
+                pattern: "^[a-z0-9]+(?:-[a-z0-9]+|--[a-z0-9]+)*$",
+            }),
+            q: s.string("Search keywords, such as music or python workshops.", {
+                minLength: 1,
+                maxLength: 200,
+                pattern: "^\\S+(?: \\S+)*$",
+            }),
+            page: s.integer("Results page, starting at 1.", { minimum: 1, maximum: 100 }),
+        }, { required: [] }),
+        asyncInput: s.object("Eventbrite Search asynchronous parameters.", {
+            location: s.string("Eventbrite location slug, such as tx--austin, ny--new-york, or online.", {
+                maxLength: 150,
+                pattern: "^[a-z0-9]+(?:-[a-z0-9]+|--[a-z0-9]+)*$",
+            }),
+            q: s.string("Search keywords, such as music or python workshops.", {
+                minLength: 1,
+                maxLength: 200,
+                pattern: "^\\S+(?: \\S+)*$",
+            }),
+            page: s.integer("Results page, starting at 1.", { minimum: 1, maximum: 100 }),
+            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("Eventbrite Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            organic_results: s.array("organic results value.", s.looseObject("organic results value. item.", {})),
+            promoted_results: s.array("promoted results value.", s.looseObject("promoted results value. item.", {})),
+            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/executors.d.ts

@@ -0,0 +1,4 @@
+import type { CredentialValidators, ProviderExecutors, ProviderProxyExecutor } from "../../core/types.ts";
+export declare const credentialValidators: CredentialValidators;
+export declare const executors: ProviderExecutors;
+export declare const proxy: ProviderProxyExecutor;

package/src/providers/litescrape/executors.js

@@ -0,0 +1,138 @@
+import { optionalRecord, optionalString } from "../../core/cast.js";
+import { randomUUIDv7 } from "../../core/uuid-v7.js";
+import { requiredResponseRecord, isAbortLikeError, runProviderRequest, ProviderRequestError, providerInputError, providerResponseError, defineApiKeyProviderExecutors, defineProviderProxy, } from "../provider-runtime.js";
+import { litescrapeActions } from "./actions.js";
+import { litescrapeEndpointByName, litescrapeToolByName } from "./actions.js";
+const baseUrl = "https://api.litescrape.com";
+async function request(apiKey, name, input, fetcher, validating = false, parentSignal) {
+    const endpoint = litescrapeEndpointByName.get(name);
+    const body = { ...input };
+    let path = endpoint.path;
+    const headers = new Headers({ accept: "application/json" });
+    if (name !== "submit_feedback")
+        headers.set("authorization", `Bearer ${apiKey}`);
+    for (const key of ["job_id", "token"]) {
+        if (!path.includes(`{${key}}`))
+            continue;
+        const value = String(input[key]);
+        if (value === "." || value === "..")
+            throw providerInputError("Invalid path identifier");
+        path = path.replace(`{${key}}`, encodeURIComponent(value));
+        delete body[key];
+    }
+    let payload = body;
+    if (endpoint.path.endsWith("/async")) {
+        payload = optionalRecord(input.body);
+        headers.set("Idempotency-Key", optionalString(input.idempotencyKey) ?? randomUUIDv7());
+        if (input.batchId !== undefined)
+            headers.set("X-Litescrape-Batch-Id", String(input.batchId));
+        if (input.batchSize !== undefined)
+            headers.set("X-Litescrape-Batch-Size", String(input.batchSize));
+    }
+    if (name === "disable_auto_top_up")
+        payload = { enabled: false };
+    const url = new URL(path, baseUrl);
+    if (endpoint.method === "GET") {
+        for (const [key, value] of Object.entries(body))
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+    }
+    else if (!endpoint.path.endsWith("/async") && body.timeout !== undefined) {
+        url.searchParams.set("timeout", String(body.timeout));
+        delete body.timeout;
+    }
+    const timeoutMs = litescrapeToolByName.has(name) ? 100000 : undefined;
+    return runProviderRequest({ label: "Litescrape", timeoutMs, signal: parentSignal }, async (signal) => {
+        if (endpoint.method !== "GET")
+            headers.set("content-type", "application/json");
+        const response = await fetcher(url, {
+            method: endpoint.method,
+            headers,
+            body: endpoint.method === "GET" ? undefined : JSON.stringify(payload),
+            signal,
+        });
+        const result = await response.json().catch((error) => {
+            if (isAbortLikeError(error))
+                throw error;
+            return undefined;
+        });
+        if (!response.ok) {
+            const object = optionalRecord(result);
+            const detail = [
+                optionalString(object?.error_code),
+                optionalString(object?.error),
+                optionalString(object?.message),
+            ]
+                .filter(Boolean)
+                .join(": ");
+            const credentialFailure = ["invalid_key", "invalid_api_key", "api_key_disabled"].includes(optionalString(object?.error_code) ?? "");
+            throw new ProviderRequestError(credentialFailure && validating ? 400 : response.status, `Litescrape request failed (${response.status})${detail ? `: ${detail}` : ""}`, undefined, credentialFailure ? (validating ? "invalid_input" : "authorization_failed") : "provider_error");
+        }
+        const object = requiredResponseRecord(result, "Litescrape response");
+        if (endpoint.path.endsWith("/async") && !optionalString(object.job_id))
+            throw providerResponseError("Litescrape asynchronous response is missing job_id");
+        if (name === "get_job" && !optionalString(object.state))
+            throw providerResponseError("Litescrape job response is missing state");
+        return object;
+    });
+}
+async function normalizeScreenshot(value, transitFiles) {
+    const encoded = optionalString(value.screenshot_base64);
+    if (encoded === undefined)
+        return value;
+    if (!transitFiles)
+        throw new ProviderRequestError(500, "Litescrape screenshots require file transit and execution context", undefined, "provider_error");
+    const bytes = Buffer.from(encoded, "base64");
+    if (bytes.length < 8 || !bytes.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])))
+        throw providerResponseError("Litescrape returned an invalid PNG screenshot");
+    const file = await transitFiles.create(new File([bytes], "litescrape-screenshot.png", { type: "image/png" }));
+    const { screenshot_base64: _, ...rest } = value;
+    return { ...rest, screenshot: { url: file.downloadUrl, mimeType: "image/png" } };
+}
+async function execute(actionName, values, context) {
+    const { apiKey, fetcher } = context;
+    const endpoint = litescrapeEndpointByName.get(actionName);
+    if (!endpoint)
+        throw providerInputError(`Unknown Litescrape action: ${actionName}`);
+    const data = values;
+    if (actionName === "google_search" || actionName === "submit_google_search") {
+        const search = actionName === "google_search" ? data : optionalRecord(data.body);
+        if (!["q", "ludocid", "kgmid", "page_token"].some((key) => optionalString(search[key])?.trim()))
+            throw providerInputError("Provide q, ludocid, kgmid or page_token");
+        if (search.page_token &&
+            Object.entries(search).some(([key, value]) => key !== "page_token" && key !== "timeout" && value != null))
+            throw providerInputError("Send page_token without other search parameters");
+    }
+    if (actionName === "setup_auto_top_up" && Number(data.monthly_limit_cents) < Number(data.top_up_cents))
+        throw providerInputError("monthly_limit_cents must cover one top-up");
+    const isScreenshot = actionName === "web_screenshot" || actionName === "submit_web_screenshot";
+    if (isScreenshot && !context.transitFiles)
+        throw new ProviderRequestError(500, "Litescrape screenshots require file transit and execution context", undefined, "provider_error");
+    const result = await request(apiKey, actionName, data, fetcher, undefined, context.signal);
+    if (actionName === "get_job" || actionName === "submit_web_screenshot") {
+        const response = optionalRecord(result.response);
+        if (response && result.state === "succeeded")
+            return {
+                ...result,
+                response: await normalizeScreenshot(response, context.transitFiles),
+            };
+    }
+    if (actionName === "web_screenshot" && !optionalString(result.screenshot_base64))
+        throw providerResponseError("Litescrape screenshot response is missing screenshot_base64");
+    return actionName === "web_screenshot" ? normalizeScreenshot(result, context.transitFiles) : result;
+}
+export const credentialValidators = {
+    async apiKey(input, { fetcher, signal }) {
+        await request(input.apiKey, "get_key_status", {}, fetcher, true, signal);
+        return { profile: { displayName: "Litescrape API Key" }, grantedScopes: [], metadata: {} };
+    },
+};
+export const executors = defineApiKeyProviderExecutors("litescrape", Object.fromEntries(litescrapeActions.map((action) => [action.name, (values, context) => execute(action.name, values, context)])));
+export const proxy = defineProviderProxy({
+    service: "litescrape",
+    baseUrl: baseUrl,
+    auth: { type: "api_key_authorization", prefix: "Bearer " },
+    customizeRequest({ headers }) {
+        headers.set("accept", "application/json");
+    },
+});

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

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