@oomol-lab/open-connector 1.9.0 → 1.9.2

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

@@ -0,0 +1,153 @@
+import { s } from "../../core/json-schema.js";
+export const levelsTools = [
+    {
+        name: "levels_search",
+        path: "/api/levels/search",
+        description: "Search Levels.fyi jobs by company, location, level and pay.",
+        input: s.object("Levels.fyi Search parameters.", {
+            q: s.nullable(s.string("Job title, keywords or company; omit to browse.", {
+                minLength: 1,
+                maxLength: 512,
+            })),
+            page: s.integer("One-based results page. Use next_page from the response to continue.", {
+                minimum: 1,
+            }),
+            company: s.nullable(s.string("Company slug, such as google.", { pattern: "^[a-z0-9][a-z0-9-]{0,127}$" })),
+            location: s.nullable(s.string("Levels.fyi location slug, such as united-states; not a free-text city name.", {
+                pattern: "^[a-z0-9][a-z0-9-]{0,127}$",
+            })),
+            sort: s.withEnum(s.unknown("Result ordering."), ["relevance", "date_published", "total_compensation"]),
+            limit: s.integer("Companies per page; jobs are grouped by company.", {
+                minimum: 1,
+                maximum: 20,
+            }),
+            jobs_per_company: s.integer("Maximum matching jobs included for each company.", {
+                minimum: 1,
+                maximum: 15,
+            }),
+            companies: s.nullable(s.array("Company slugs as a JSON array; mutually exclusive with company. A single company advances jobs instead of company groups.", s.string("companies value. item.", { pattern: "^[a-z0-9][a-z0-9-]{0,127}$" }), { minItems: 1, maxItems: 100 })),
+            locations: s.nullable(s.array('City, state or country slugs as a JSON array, such as ["united-states","canada"]. Mutually exclusive with location.', s.string("locations value. item.", { pattern: "^[a-z0-9][a-z0-9-]{0,127}$" }), { minItems: 1, maxItems: 100 })),
+            job_families: s.nullable(s.array('Job-family slugs as a JSON array, such as ["software-engineer"].', s.string("job families value. item.", { pattern: "^[a-z0-9][a-z0-9-]{0,127}$" }), { minItems: 1, maxItems: 100 })),
+            levels: s.nullable(s.array("Standard seniority levels as a JSON array.", s.withEnum(s.unknown("levels value. item."), [
+                "internship",
+                "entry",
+                "mid_staff",
+                "principal",
+                "manager",
+                "director",
+                "executive",
+            ]), { minItems: 1, maxItems: 100 })),
+            employment_types: s.nullable(s.array("Employment types as a JSON array.", s.withEnum(s.unknown("employment types value. item."), [
+                "full_time",
+                "part_time",
+                "contract",
+                "temporary",
+                "internship",
+                "volunteer",
+                "other",
+            ]), { minItems: 1, maxItems: 100 })),
+            work_arrangements: s.nullable(s.array("Work arrangements as a JSON array.", s.withEnum(s.unknown("work arrangements value. item."), ["remote", "office", "hybrid"]), { minItems: 1, maxItems: 100 })),
+            min_base_compensation: s.nullable(s.integer("Minimum annual base compensation in USD.", { minimum: 0 })),
+            min_total_compensation: s.nullable(s.integer("Minimum median annual total compensation in USD; may include Levels.fyi estimates.", {
+                minimum: 0,
+            })),
+            company_types: s.nullable(s.array("Company types as a JSON array.", s.withEnum(s.unknown("company types value. item."), [
+                "private",
+                "public",
+                "nonprofit",
+                "government",
+                "education",
+                "delisted",
+            ]), { minItems: 1, maxItems: 100 })),
+            company_sizes: s.nullable(s.array("Company sizes as a JSON array: seed 1–50, early 51–200, mid 201–1,000, large 1,001–10,000, enterprise 10,001+ employees.", s.withEnum(s.unknown("company sizes value. item."), ["seed", "early", "mid", "large", "enterprise"]), { minItems: 1, maxItems: 100 })),
+            company_valuations: s.nullable(s.array("Company valuation ranges in USD as a JSON array of [minimum, maximum] pairs.", s.array("company valuations value. item.", s.integer("company valuations value. item. item."), {
+                minItems: 2,
+                maxItems: 2,
+            }), { minItems: 1, maxItems: 100 })),
+            perk_ids: s.nullable(s.array("Benefit IDs as a JSON array, for example 58 remote work, 4 retirement plan, 35 paid time off, 22 health insurance.", s.integer("perk ids value. item."), { minItems: 1, maxItems: 100 })),
+            posted_within: s.nullable(s.integer("Maximum posting age in posted_within_unit units.", { minimum: 1 })),
+            posted_within_unit: s.withEnum(s.unknown("Unit for posted_within."), ["days", "weeks", "months"]),
+        }, { required: [] }),
+        asyncInput: s.object("Levels.fyi Search asynchronous parameters.", {
+            q: s.string("Job title, keywords or company; omit to browse.", {
+                minLength: 1,
+                maxLength: 512,
+            }),
+            page: s.integer("One-based results page. Use next_page from the response to continue.", {
+                minimum: 1,
+            }),
+            company: s.string("Company slug, such as google.", {
+                pattern: "^[a-z0-9][a-z0-9-]{0,127}$",
+            }),
+            location: s.string("Levels.fyi location slug, such as united-states; not a free-text city name.", {
+                pattern: "^[a-z0-9][a-z0-9-]{0,127}$",
+            }),
+            sort: s.withEnum(s.unknown("Result ordering."), ["relevance", "date_published", "total_compensation"]),
+            limit: s.integer("Companies per page; jobs are grouped by company.", {
+                minimum: 1,
+                maximum: 20,
+            }),
+            jobs_per_company: s.integer("Maximum matching jobs included for each company.", {
+                minimum: 1,
+                maximum: 15,
+            }),
+            companies: s.array("Company slugs as a JSON array; mutually exclusive with company. A single company advances jobs instead of company groups.", s.string("companies value. item.", { pattern: "^[a-z0-9][a-z0-9-]{0,127}$" }), { minItems: 1, maxItems: 100 }),
+            locations: s.array('City, state or country slugs as a JSON array, such as ["united-states","canada"]. Mutually exclusive with location.', s.string("locations value. item.", { pattern: "^[a-z0-9][a-z0-9-]{0,127}$" }), { minItems: 1, maxItems: 100 }),
+            job_families: s.array('Job-family slugs as a JSON array, such as ["software-engineer"].', s.string("job families value. item.", { pattern: "^[a-z0-9][a-z0-9-]{0,127}$" }), { minItems: 1, maxItems: 100 }),
+            levels: s.array("Standard seniority levels as a JSON array.", s.withEnum(s.unknown("levels value. item."), [
+                "internship",
+                "entry",
+                "mid_staff",
+                "principal",
+                "manager",
+                "director",
+                "executive",
+            ]), { minItems: 1, maxItems: 100 }),
+            employment_types: s.array("Employment types as a JSON array.", s.withEnum(s.unknown("employment types value. item."), [
+                "full_time",
+                "part_time",
+                "contract",
+                "temporary",
+                "internship",
+                "volunteer",
+                "other",
+            ]), { minItems: 1, maxItems: 100 }),
+            work_arrangements: s.array("Work arrangements as a JSON array.", s.withEnum(s.unknown("work arrangements value. item."), ["remote", "office", "hybrid"]), { minItems: 1, maxItems: 100 }),
+            min_base_compensation: s.integer("Minimum annual base compensation in USD.", {
+                minimum: 0,
+            }),
+            min_total_compensation: s.integer("Minimum median annual total compensation in USD; may include Levels.fyi estimates.", { minimum: 0 }),
+            company_types: s.array("Company types as a JSON array.", s.withEnum(s.unknown("company types value. item."), [
+                "private",
+                "public",
+                "nonprofit",
+                "government",
+                "education",
+                "delisted",
+            ]), { minItems: 1, maxItems: 100 }),
+            company_sizes: s.array("Company sizes as a JSON array: seed 1–50, early 51–200, mid 201–1,000, large 1,001–10,000, enterprise 10,001+ employees.", s.withEnum(s.unknown("company sizes value. item."), ["seed", "early", "mid", "large", "enterprise"]), { minItems: 1, maxItems: 100 }),
+            company_valuations: s.array("Company valuation ranges in USD as a JSON array of [minimum, maximum] pairs.", s.array("company valuations value. item.", s.integer("company valuations value. item. item."), {
+                minItems: 2,
+                maxItems: 2,
+            }), { minItems: 1, maxItems: 100 }),
+            perk_ids: s.array("Benefit IDs as a JSON array, for example 58 remote work, 4 retirement plan, 35 paid time off, 22 health insurance.", s.integer("perk ids value. item."), { minItems: 1, maxItems: 100 }),
+            posted_within: s.integer("Maximum posting age in posted_within_unit units.", {
+                minimum: 1,
+            }),
+            posted_within_unit: s.withEnum(s.unknown("Unit for posted_within."), ["days", "weeks", "months"]),
+            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("Levels.fyi Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            jobs_results: s.array("jobs results value.", s.looseObject("jobs results value. item.", {})),
+            search_information: s.looseObject("search information value.", {}),
+            pagination: s.looseObject("pagination value.", {}),
+            litescrape_pagination: s.looseObject("litescrape pagination value.", {}),
+            available_filters: s.nullable(s.array("available filters value.", s.looseObject("available filters value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

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

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

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

@@ -0,0 +1,107 @@
+import { s } from "../../core/json-schema.js";
+export const naverTools = [
+    {
+        name: "naver_ai_overview",
+        path: "/api/naver/ai-overview",
+        description: "Get Naver AI Briefing answers with citations.",
+        input: s.object("Naver AI Overview parameters.", {
+            query: s.nullable(s.string("Query for an AI Briefing; excludes page_token.", {
+                minLength: 1,
+                maxLength: 4096,
+            })),
+            page_token: s.nullable(s.string("Business AI Briefing continuation from ai_briefing.page_token; excludes query.", {
+                minLength: 1,
+                maxLength: 2048,
+            })),
+        }, { required: [] }),
+        asyncInput: s.object("Naver AI Overview asynchronous parameters.", {
+            query: s.string("Query for an AI Briefing; excludes page_token.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            page_token: s.string("Business AI Briefing continuation from ai_briefing.page_token; excludes query.", {
+                minLength: 1,
+                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: [] }),
+        output: s.looseObject("Naver AI Overview response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            markdown: s.nullable(s.string("markdown value.")),
+            text_blocks: s.array("text blocks value.", s.looseObject("text blocks value. item.", {})),
+            references: s.array("references value.", s.looseObject("references value. item.", {})),
+            media: s.array("media value.", s.looseObject("media value. item.", {})),
+            related_questions: s.nullable(s.array("related questions value.", s.looseObject("related questions value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "naver_search",
+        path: "/api/naver/search",
+        description: "Search Naver web, news, video and image results.",
+        input: s.object("Naver Search parameters.", {
+            query: s.string("Search query, including Naver search operators.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            start: s.nullable(s.integer("Result offset; takes precedence over page.", { minimum: 0 })),
+            page: s.nullable(s.integer("Page number, starting at 1.", { minimum: 1 })),
+            num: s.nullable(s.integer("Image result limit; defaults to 50 for images.", { minimum: 1, maximum: 100 })),
+            where: s.withEnum(s.unknown("Search type: nexearch (general search), web, video, news, or image."), [
+                "nexearch",
+                "web",
+                "video",
+                "news",
+                "image",
+            ]),
+            sort_by: s.nullable(s.withEnum(s.unknown("News: 0 relevance (default), 1 latest, 2 oldest. Other types: r relevance (default), dd latest."), ["r", "dd", "0", "1", "2"])),
+            period: s.string("Time window: all, 1h, 1d, 1w, 1m, 3m, 6m, 1y, or fromYYYYMMDDtoYYYYMMDD. News also accepts 2h, 3h, 4h, 5h, and 6h."),
+        }, { required: ["query"] }),
+        asyncInput: s.object("Naver Search asynchronous parameters.", {
+            query: s.string("Search query, including Naver search operators.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            start: s.integer("Result offset; takes precedence over page.", { minimum: 0 }),
+            page: s.integer("Page number, starting at 1.", { minimum: 1 }),
+            num: s.integer("Image result limit; defaults to 50 for images.", {
+                minimum: 1,
+                maximum: 100,
+            }),
+            where: s.withEnum(s.unknown("Search type: nexearch (general search), web, video, news, or image."), [
+                "nexearch",
+                "web",
+                "video",
+                "news",
+                "image",
+            ]),
+            sort_by: s.withEnum(s.unknown("News: 0 relevance (default), 1 latest, 2 oldest. Other types: r relevance (default), dd latest."), ["r", "dd", "0", "1", "2"]),
+            period: s.string("Time window: all, 1h, 1d, 1w, 1m, 3m, 6m, 1y, or fromYYYYMMDDtoYYYYMMDD. News also accepts 2h, 3h, 4h, 5h, and 6h."),
+            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("Naver Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            organic_results: s.nullable(s.array("organic results value.", s.looseObject("organic results value. item.", {}))),
+            news_results: s.nullable(s.array("news results value.", s.looseObject("news results value. item.", {}))),
+            video_results: s.nullable(s.array("video results value.", s.looseObject("video results value. item.", {}))),
+            images_results: s.nullable(s.array("images results value.", s.looseObject("images results value. item.", {}))),
+            ads_results: s.nullable(s.array("ads results value.", s.looseObject("ads results value. item.", {}))),
+            post_results: s.nullable(s.array("post results value.", s.looseObject("post results value. item.", {}))),
+            shopping_results: s.nullable(s.array("shopping results value.", s.looseObject("shopping results value. item.", {}))),
+            booking_results: s.nullable(s.array("booking results value.", s.looseObject("booking results value. item.", {}))),
+            dictionary_results: s.nullable(s.array("dictionary results value.", s.looseObject("dictionary results value. item.", {}))),
+            knowledge_graph: s.nullable(s.looseObject("knowledge graph value.", {})),
+            related_searches: s.nullable(s.array("related searches value.", s.looseObject("related searches value. item.", {}))),
+            related_results: s.nullable(s.array("related results value.", s.looseObject("related results value. item.", {}))),
+            ai_briefing: s.nullable(s.looseObject("ai briefing value.", {})),
+            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/realtor-schemas.d.ts

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

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

@@ -0,0 +1,47 @@
+import { s } from "../../core/json-schema.js";
+export const realtorTools = [
+    {
+        name: "realtor_property",
+        path: "/api/realtor/property",
+        description: "Get a Realtor.com property by URL. This upstream API is Alpha.",
+        input: s.object("Realtor.com Property parameters.", {
+            url: s.string("Realtor.com property URL under /realestateandhomes-detail/, without query parameters.\n\nAlpha: availability may vary by location or property. Returns available fields for the requested property.", { maxLength: 2048 }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Realtor.com Property asynchronous parameters.", {
+            url: s.string("Realtor.com property URL under /realestateandhomes-detail/, without query parameters.\n\nAlpha: availability may vary by location or property. Returns available fields for the requested property.", { 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("Realtor.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: "realtor_search",
+        path: "/api/realtor/search",
+        description: "Search Realtor.com listings from a search URL. This upstream API is Alpha.",
+        input: s.object("Realtor.com Search parameters.", {
+            limit: s.integer("Listings per results page, from 1 to 200.", { minimum: 1, maximum: 200 }),
+            url: s.string("Realtor.com city_STATE or ZIP search URL under /realestateandhomes-search/ or /apartments/.\n\nAlpha: availability may vary by location or property. Supported URL filters: price, beds, baths, sqft, type-single-family-home, show-recently-sold and pg-1 through pg-100. Unsupported filters and query parameters are rejected. Follow pagination.next when present. Bedroom filters require whole numbers.", { maxLength: 4096 }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Realtor.com Search asynchronous parameters.", {
+            limit: s.integer("Listings per results page, from 1 to 200.", { minimum: 1, maximum: 200 }),
+            url: s.string("Realtor.com city_STATE or ZIP search URL under /realestateandhomes-search/ or /apartments/.\n\nAlpha: availability may vary by location or property. Supported URL filters: price, beds, baths, sqft, type-single-family-home, show-recently-sold and pg-1 through pg-100. Unsupported filters and query parameters are rejected. Follow pagination.next when present. Bedroom filters require whole numbers.", { 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("Realtor.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/redfin-schemas.d.ts

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

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

@@ -0,0 +1,112 @@
+import { s } from "../../core/json-schema.js";
+export const redfinTools = [
+    {
+        name: "redfin_property",
+        path: "/api/redfin/property",
+        description: "Get a Redfin property by listing URL.",
+        input: s.object("Redfin Property parameters.", {
+            url: s.string("Redfin property URL ending in /home/<property_id>.", { maxLength: 2048 }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Redfin Property asynchronous parameters.", {
+            url: s.string("Redfin property URL ending in /home/<property_id>.", { 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("Redfin 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: "redfin_search",
+        path: "/api/redfin/search",
+        description: "Search Redfin homes for sale or recently sold.",
+        input: s.object("Redfin Search parameters.", {
+            min_price: s.nullable(s.integer("Minimum listing price in US dollars.", { minimum: 0 })),
+            max_price: s.nullable(s.integer("Maximum listing price in US dollars.", { minimum: 0 })),
+            min_beds: s.nullable(s.integer("Minimum number of bedrooms.", { minimum: 0, maximum: 20 })),
+            max_beds: s.nullable(s.integer("Maximum number of bedrooms.", { minimum: 0, maximum: 20 })),
+            min_baths: s.nullable(s.number("Minimum number of bathrooms.", { minimum: 0, maximum: 20 })),
+            min_sqft: s.nullable(s.integer("Minimum interior area in square feet.", { minimum: 0 })),
+            max_sqft: s.nullable(s.integer("Maximum interior area in square feet.", { minimum: 0 })),
+            url: s.nullable(s.string("Redfin city, ZIP, county or neighborhood search URL. Existing URL filters are retained unless overridden.\n\nSupply one location: a region URL, region_id with region_type, or map_bounds.", { maxLength: 2048 })),
+            region_id: s.nullable(s.integer("Redfin region identifier; requires region_type.", { exclusiveMinimum: 0 })),
+            region_type: s.nullable(s.withEnum(s.unknown("Region kind: 1 neighborhood, 2 ZIP region, 5 county, 6 city, 11 state.\n\nA ZIP region identifier differs from the ZIP code. Use a Redfin ZIP search URL if the region identifier is unknown."), [1, 2, 5, 6, 11])),
+            map_bounds: s.nullable(s.string("Map rectangle as north,east,south,west.")),
+            status: s.nullable(s.withEnum(s.unknown("Listing status. Defaults to for_sale when no URL is supplied."), ["for_sale", "sold"])),
+            sold_within_days: s.nullable(s.integer("Sold listings from the last N days; requires status=sold. Defaults to 180 for sold searches.", {
+                minimum: 1,
+                maximum: 365,
+            })),
+            property_type: s.nullable(s.withEnum(s.unknown("Restrict results to one property type."), [
+                "house",
+                "condo",
+                "townhouse",
+                "multi_family",
+                "land",
+                "other",
+                "manufactured",
+                "co_op",
+            ])),
+            sort: s.nullable(s.withEnum(s.unknown("Result ordering. Defaults to recommended when no URL is supplied."), [
+                "recommended",
+                "newest",
+                "price_asc",
+                "price_desc",
+                "sqft",
+            ])),
+            limit: s.integer("Maximum homes returned. Narrow the region or map bounds when results reach this limit.\n\nThe response does not advertise pagination or a total count. If search_information.possibly_truncated is true, narrow the location or filters.", { minimum: 1, maximum: 350 }),
+        }, { required: [] }),
+        asyncInput: s.object("Redfin Search asynchronous parameters.", {
+            min_price: s.integer("Minimum listing price in US dollars.", { minimum: 0 }),
+            max_price: s.integer("Maximum listing price in US dollars.", { minimum: 0 }),
+            min_beds: s.integer("Minimum number of bedrooms.", { minimum: 0, maximum: 20 }),
+            max_beds: s.integer("Maximum number of bedrooms.", { minimum: 0, maximum: 20 }),
+            min_baths: s.number("Minimum number of bathrooms.", { minimum: 0, maximum: 20 }),
+            min_sqft: s.integer("Minimum interior area in square feet.", { minimum: 0 }),
+            max_sqft: s.integer("Maximum interior area in square feet.", { minimum: 0 }),
+            url: s.string("Redfin city, ZIP, county or neighborhood search URL. Existing URL filters are retained unless overridden.\n\nSupply one location: a region URL, region_id with region_type, or map_bounds.", { maxLength: 2048 }),
+            region_id: s.integer("Redfin region identifier; requires region_type.", {
+                exclusiveMinimum: 0,
+            }),
+            region_type: s.withEnum(s.unknown("Region kind: 1 neighborhood, 2 ZIP region, 5 county, 6 city, 11 state.\n\nA ZIP region identifier differs from the ZIP code. Use a Redfin ZIP search URL if the region identifier is unknown."), [1, 2, 5, 6, 11]),
+            map_bounds: s.string("Map rectangle as north,east,south,west."),
+            status: s.withEnum(s.unknown("Listing status. Defaults to for_sale when no URL is supplied."), [
+                "for_sale",
+                "sold",
+            ]),
+            sold_within_days: s.integer("Sold listings from the last N days; requires status=sold. Defaults to 180 for sold searches.", { minimum: 1, maximum: 365 }),
+            property_type: s.withEnum(s.unknown("Restrict results to one property type."), [
+                "house",
+                "condo",
+                "townhouse",
+                "multi_family",
+                "land",
+                "other",
+                "manufactured",
+                "co_op",
+            ]),
+            sort: s.withEnum(s.unknown("Result ordering. Defaults to recommended when no URL is supplied."), [
+                "recommended",
+                "newest",
+                "price_asc",
+                "price_desc",
+                "sqft",
+            ]),
+            limit: s.integer("Maximum homes returned. Narrow the region or map bounds when results reach this limit.\n\nThe response does not advertise pagination or a total count. If search_information.possibly_truncated is true, narrow the location or filters.", { minimum: 1, maximum: 350 }),
+            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("Redfin 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.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/shared.d.ts

@@ -0,0 +1,9 @@
+import type { JsonSchema } from "../../core/types.ts";
+export interface DataTool {
+    name: string;
+    path: string;
+    description: string;
+    input: JsonSchema;
+    asyncInput: JsonSchema;
+    output: JsonSchema;
+}

package/src/providers/litescrape/shared.js

@@ -0,0 +1 @@
+export {};

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

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

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

@@ -0,0 +1,72 @@
+import { s } from "../../core/json-schema.js";
+export const sproutsTools = [
+    {
+        name: "sprouts_product",
+        path: "/api/sprouts/product",
+        description: "Get a Sprouts product's details, price and availability. This upstream API is Alpha.",
+        input: s.object("Sprouts Product parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            store_id: s.nullable(s.string("Sprouts store location ID, such as 17650. Selects that store's in-store catalog.", {
+                minLength: 1,
+                maxLength: 8,
+                pattern: "^[0-9]{1,8}$",
+            })),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Sprouts Product asynchronous parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            store_id: s.string("Sprouts store location ID, such as 17650. Selects that store's in-store catalog.", {
+                minLength: 1,
+                maxLength: 8,
+                pattern: "^[0-9]{1,8}$",
+            }),
+            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("Sprouts 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: "sprouts_search",
+        path: "/api/sprouts/search",
+        description: "Search Sprouts products with prices and availability. This upstream API is Alpha.",
+        input: s.object("Sprouts 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 }),
+            store_id: s.nullable(s.string("Sprouts store location ID, such as 17650. Selects that store's in-store catalog.", {
+                minLength: 1,
+                maxLength: 8,
+                pattern: "^[0-9]{1,8}$",
+            })),
+        }, { required: ["query"] }),
+        asyncInput: s.object("Sprouts 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 }),
+            store_id: s.string("Sprouts store location ID, such as 17650. Selects that store's in-store catalog.", {
+                minLength: 1,
+                maxLength: 8,
+                pattern: "^[0-9]{1,8}$",
+            }),
+            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("Sprouts 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/target-schemas.d.ts

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

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

@@ -0,0 +1,56 @@
+import { s } from "../../core/json-schema.js";
+export const targetTools = [
+    {
+        name: "target_product",
+        path: "/api/target/product",
+        description: "Get a product sold by the US retailer Target, with its details, price and availability. This upstream API is Alpha.",
+        input: s.object("Target Product parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            store_id: s.nullable(s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" })),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Target Product asynchronous parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            store_id: s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" }),
+            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("Target 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: "target_search",
+        path: "/api/target/search",
+        description: "Search products sold by the US retailer Target, with prices and availability. This upstream API is Alpha.",
+        input: s.object("Target 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 }),
+            store_id: s.nullable(s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" })),
+        }, { required: ["query"] }),
+        asyncInput: s.object("Target 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 }),
+            store_id: s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" }),
+            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("Target 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/tiktok-schemas.d.ts

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