@oomol-lab/open-connector 1.9.1 → 1.9.2

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

@@ -0,0 +1,130 @@
+import { s } from "../../core/json-schema.js";
+export const yelpTools = [
+    {
+        name: "yelp_place",
+        path: "/api/yelp/place",
+        description: "Get a Yelp business's details and menu.",
+        input: s.object("Yelp Place parameters.", {
+            place_id: s.string("Required Yelp encoded business ID or business alias."),
+            yelp_domain: s.string("Supported localized Yelp hostname."),
+            business_alert: s.boolean("Include business alert information when available."),
+            full_menu: s.boolean("Fetch the full menu when available; otherwise return place details with an explanation."),
+            menu_name: s.nullable(s.string("Select a named menu when more than one is available. Requires full_menu=true.")),
+        }, { required: ["place_id"] }),
+        asyncInput: s.object("Yelp Place asynchronous parameters.", {
+            place_id: s.string("Required Yelp encoded business ID or business alias."),
+            yelp_domain: s.string("Supported localized Yelp hostname."),
+            business_alert: s.boolean("Include business alert information when available."),
+            full_menu: s.boolean("Fetch the full menu when available; otherwise return place details with an explanation."),
+            menu_name: s.string("Select a named menu when more than one is available. Requires full_menu=true."),
+            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: ["place_id"] }),
+        output: s.looseObject("Yelp Place 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_results: s.nullable(s.looseObject("place results value.", {})),
+            full_menu_results: s.nullable(s.looseObject("full menu results value.", {})),
+            error: s.nullable(s.string("error value.")),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "yelp_reviews",
+        path: "/api/yelp/reviews",
+        description: "Get reviews for a Yelp business.",
+        input: s.object("Yelp Reviews parameters.", {
+            place_id: s.string("Required encoded Yelp business identifier."),
+            yelp_domain: s.string("Supported localized Yelp hostname."),
+            hl: s.string("Review language such as en or fr-FR."),
+            q: s.nullable(s.string("Search review text for these terms.")),
+            sortby: s.withEnum(s.unknown("Yelp review ordering."), [
+                "relevance_desc",
+                "date_desc",
+                "date_asc",
+                "rating_desc",
+                "rating_asc",
+                "elites_desc",
+            ]),
+            rating: s.nullable(s.string("Comma-separated ratings from 1 through 5.")),
+            not_recommended: s.boolean("Fetch reviews that Yelp does not recommend."),
+            not_recommended_start: s.nullable(s.integer("Offset within not-recommended reviews. Requires not_recommended=true.")),
+            start: s.integer("Review offset from 0 through 10,000."),
+            num: s.integer("Review count from 1 through 49."),
+        }, { required: ["place_id"] }),
+        asyncInput: s.object("Yelp Reviews asynchronous parameters.", {
+            place_id: s.string("Required encoded Yelp business identifier."),
+            yelp_domain: s.string("Supported localized Yelp hostname."),
+            hl: s.string("Review language such as en or fr-FR."),
+            q: s.string("Search review text for these terms."),
+            sortby: s.withEnum(s.unknown("Yelp review ordering."), [
+                "relevance_desc",
+                "date_desc",
+                "date_asc",
+                "rating_desc",
+                "rating_asc",
+                "elites_desc",
+            ]),
+            rating: s.string("Comma-separated ratings from 1 through 5."),
+            not_recommended: s.boolean("Fetch reviews that Yelp does not recommend."),
+            not_recommended_start: s.integer("Offset within not-recommended reviews. Requires not_recommended=true."),
+            start: s.integer("Review offset from 0 through 10,000."),
+            num: s.integer("Review count from 1 through 49."),
+            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: ["place_id"] }),
+        output: s.looseObject("Yelp 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.", {})),
+            review_languages: s.nullable(s.array("review languages value.", s.looseObject("review languages value. item.", {}))),
+            reviews: s.nullable(s.array("reviews value.", s.looseObject("reviews 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",
+            }),
+        }),
+    },
+    {
+        name: "yelp_search",
+        path: "/api/yelp/search",
+        description: "Search Yelp businesses by location and category.",
+        input: s.object("Yelp Search parameters.", {
+            find_desc: s.nullable(s.string("Business name, category, or search terms.")),
+            find_loc: s.string("Required Yelp search location."),
+            yelp_domain: s.string("Supported Yelp hostname. Results use the language of the selected domain."),
+            l: s.nullable(s.string("Optional Yelp-native map bounds token.")),
+            cflt: s.nullable(s.string("Yelp category identifier containing letters, numbers, _ or -.")),
+            sortby: s.withEnum(s.unknown("Native Yelp ordering."), ["recommended", "rating", "review_count"]),
+            attrs: s.nullable(s.string("Yelp-native comma-separated attribute filters.")),
+            start: s.integer("Result offset from 0 through 10,000."),
+        }, { required: ["find_loc"] }),
+        asyncInput: s.object("Yelp Search asynchronous parameters.", {
+            find_desc: s.string("Business name, category, or search terms."),
+            find_loc: s.string("Required Yelp search location."),
+            yelp_domain: s.string("Supported Yelp hostname. Results use the language of the selected domain."),
+            l: s.string("Optional Yelp-native map bounds token."),
+            cflt: s.string("Yelp category identifier containing letters, numbers, _ or -."),
+            sortby: s.withEnum(s.unknown("Native Yelp ordering."), ["recommended", "rating", "review_count"]),
+            attrs: s.string("Yelp-native comma-separated attribute filters."),
+            start: s.integer("Result offset from 0 through 10,000."),
+            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: ["find_loc"] }),
+        output: s.looseObject("Yelp 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.", {})),
+            filters: s.nullable(s.looseObject("filters value.", {})),
+            ads_results: s.nullable(s.array("ads results value.", s.looseObject("ads results value. item.", {}))),
+            organic_results: s.nullable(s.array("organic results value.", s.looseObject("organic results value. item.", {}))),
+            pagination: s.nullable(s.looseObject("pagination value.", {})),
+            litescrape_pagination: s.nullable(s.looseObject("litescrape pagination value.", {})),
+            related_links: s.nullable(s.array("related links value.", s.looseObject("related links value. item.", {}))),
+            faqs: s.nullable(s.array("faqs value.", s.looseObject("faqs value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

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

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

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

@@ -0,0 +1,128 @@
+import { s } from "../../core/json-schema.js";
+export const youtubeTools = [
+    {
+        name: "youtube_channel",
+        path: "/api/youtube/channel",
+        description: "Get a YouTube channel's profile, videos, Shorts, playlists and posts.",
+        input: s.object("YouTube Channel parameters.", {
+            channel_id: s.nullable(s.string("Channel handle (with or without @) or a UC channel ID. Required on the first page; omit with next_page_token.\n\nRequired on the first page. Use a handle such as @veritasium or a UC channel ID; full URLs are not accepted.", { minLength: 1, maxLength: 100 })),
+            tab: s.nullable(s.withEnum(s.unknown("Channel content tab. Defaults to videos. Omit when using search_query or next_page_token. Not every channel offers every tab.\n\nA channel without the requested tab returns an empty content group with search_information.tab_available set to false."), ["videos", "shorts", "streams", "podcasts", "playlists", "posts"])),
+            sort: s.nullable(s.withEnum(s.unknown("videos, shorts and streams accept latest, popular or oldest; playlists accept dd (newest playlist) or lad (last video added). Omit with podcasts, posts, search_query or next_page_token.\n\nVideos, Shorts and streams default to latest. Playlists default to dd. Sorting uses the choices offered by YouTube."), ["latest", "popular", "oldest", "dd", "lad"])),
+            search_query: s.nullable(s.string("Search within this channel for matching videos and playlists. Cannot be combined with tab or sort. Omit with next_page_token.\n\nOmit tab and sort when searching. Matching videos and playlists appear in search_results.", { minLength: 1, maxLength: 2048 })),
+            hl: s.nullable(s.string("Interface language, such as en or pt-BR. Defaults to en. Omit with next_page_token.", {
+                pattern: "^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8}){0,2}$",
+            })),
+            gl: s.nullable(s.string("Two-letter country code. Defaults to US. Omit with next_page_token.", {
+                pattern: "^[A-Za-z]{2}$",
+            })),
+            about: s.nullable(s.boolean("Include additional public channel details, such as country, join date, total views and links. Defaults to false. Omit with next_page_token.\n\nChannel profile data is returned on the first page. about=true includes additional public details. Continuation pages return content only.")),
+            next_page_token: s.nullable(s.string("Opaque pagination.next_page_token from this endpoint. Send it alone to continue the channel feed with its original settings. Tokens expire after one hour.\n\nSend next_page_token alone. The token preserves the channel, selected tab or search, sorting and locale. Use POST for long tokens. Stop when pagination.next_page_token is absent.", { minLength: 1, maxLength: 32768, pattern: "^ct2_[A-Za-z0-9_-]{100,}$" })),
+        }, { required: [] }),
+        asyncInput: s.object("YouTube Channel asynchronous parameters.", {
+            channel_id: s.string("Channel handle (with or without @) or a UC channel ID. Required on the first page; omit with next_page_token.\n\nRequired on the first page. Use a handle such as @veritasium or a UC channel ID; full URLs are not accepted.", { minLength: 1, maxLength: 100 }),
+            tab: s.withEnum(s.unknown("Channel content tab. Defaults to videos. Omit when using search_query or next_page_token. Not every channel offers every tab.\n\nA channel without the requested tab returns an empty content group with search_information.tab_available set to false."), ["videos", "shorts", "streams", "podcasts", "playlists", "posts"]),
+            sort: s.withEnum(s.unknown("videos, shorts and streams accept latest, popular or oldest; playlists accept dd (newest playlist) or lad (last video added). Omit with podcasts, posts, search_query or next_page_token.\n\nVideos, Shorts and streams default to latest. Playlists default to dd. Sorting uses the choices offered by YouTube."), ["latest", "popular", "oldest", "dd", "lad"]),
+            search_query: s.string("Search within this channel for matching videos and playlists. Cannot be combined with tab or sort. Omit with next_page_token.\n\nOmit tab and sort when searching. Matching videos and playlists appear in search_results.", { minLength: 1, maxLength: 2048 }),
+            hl: s.string("Interface language, such as en or pt-BR. Defaults to en. Omit with next_page_token.", {
+                pattern: "^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8}){0,2}$",
+            }),
+            gl: s.string("Two-letter country code. Defaults to US. Omit with next_page_token.", {
+                pattern: "^[A-Za-z]{2}$",
+            }),
+            about: s.boolean("Include additional public channel details, such as country, join date, total views and links. Defaults to false. Omit with next_page_token.\n\nChannel profile data is returned on the first page. about=true includes additional public details. Continuation pages return content only."),
+            next_page_token: s.string("Opaque pagination.next_page_token from this endpoint. Send it alone to continue the channel feed with its original settings. Tokens expire after one hour.\n\nSend next_page_token alone. The token preserves the channel, selected tab or search, sorting and locale. Use POST for long tokens. Stop when pagination.next_page_token is absent.", { minLength: 1, maxLength: 32768, pattern: "^ct2_[A-Za-z0-9_-]{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("YouTube Channel response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            search_information: s.looseObject("search information value.", {}),
+            channel_results: s.nullable(s.looseObject("channel results value.", {})),
+            videos_results: s.nullable(s.array("videos results value.", s.looseObject("videos results value. item.", {}))),
+            shorts_results: s.nullable(s.array("shorts results value.", s.looseObject("shorts results value. item.", {}))),
+            streams_results: s.nullable(s.array("streams results value.", s.looseObject("streams results value. item.", {}))),
+            podcasts_results: s.nullable(s.array("podcasts results value.", s.looseObject("podcasts results value. item.", {}))),
+            playlists_results: s.nullable(s.array("playlists results value.", s.looseObject("playlists results value. item.", {}))),
+            posts_results: s.nullable(s.array("posts results value.", s.looseObject("posts results value. item.", {}))),
+            search_results: s.nullable(s.array("search results value.", s.anyOf("search results value. item.", [
+                s.looseObject("search results value. item.", {}),
+                s.looseObject("search results value. item.", {}),
+            ]))),
+            filters: s.nullable(s.array("filters value.", s.looseObject("filters 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",
+            }),
+        }),
+    },
+    {
+        name: "youtube_search",
+        path: "/api/youtube/search",
+        description: "Search YouTube videos, channels, playlists and Shorts.",
+        input: s.object("YouTube Search parameters.", {
+            type: s.nullable(s.withEnum(s.unknown("Result type. Omit for mixed results. Movies appear in video_results.\n\nChannels and playlists cannot use upload_date, duration or features. Shorts cannot use duration. Movies cannot use live, subtitles, creative_commons or 3d features."), ["video", "shorts", "channel", "playlist", "movie"])),
+            upload_date: s.nullable(s.withEnum(s.unknown("Limit results by upload date."), ["today", "this_week", "this_month", "this_year"])),
+            duration: s.nullable(s.withEnum(s.unknown("Video duration: under 3 minutes, 3–20 minutes, or over 20 minutes."), [
+                "under_3_min",
+                "between_3_and_20_min",
+                "over_20_min",
+            ])),
+            features: s.nullable(s.string("Comma-separated features: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr, location. Combined features must all match.", { minLength: 1, maxLength: 160 })),
+            sort_by: s.nullable(s.withEnum(s.unknown("YouTube ranking: relevance (default) or popularity. Popularity is not a strict numerical view-count sort.\n\nUses YouTube's current ranking choices. The removed upload-date/rating sorts and last-hour upload filter are not supported named values."), ["relevance", "popularity"])),
+            q: s.nullable(s.string("Search query. Required for the first page; omit with page_token.\n\nRequired on the first page.", {
+                minLength: 1,
+                maxLength: 2048,
+            })),
+            hl: s.nullable(s.string("YouTube interface language, such as en or pt-BR. Defaults to en. Omit with page_token.", {
+                pattern: "^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8}){0,2}$",
+            })),
+            gl: s.nullable(s.string("Two-letter country code. Defaults to US. Omit with page_token.", {
+                pattern: "^[A-Za-z]{2}$",
+            })),
+            sp: s.nullable(s.string("Advanced YouTube filter token from a results URL. Use either sp or named filters, never both. Omit with page_token.\n\nUse either sp or named filters, never both. Raw or once-URL-encoded values from a YouTube results URL are accepted.", { minLength: 1, maxLength: 2048, pattern: "^[a-zA-Z0-9_+/=%-]+$" })),
+            page_token: s.nullable(s.string("Opaque next_page_token from the preceding response. Send it alone to continue the same search; tokens expire after one hour.\n\nSend page_token alone, without query, locale or filter parameters. It preserves all filters. Use POST for long tokens. Pagination ends when pagination.next_page_token is absent.", { minLength: 1, maxLength: 32768, pattern: "^ct2_[A-Za-z0-9_-]{100,}$" })),
+        }, { required: [] }),
+        asyncInput: s.object("YouTube Search asynchronous parameters.", {
+            type: s.withEnum(s.unknown("Result type. Omit for mixed results. Movies appear in video_results.\n\nChannels and playlists cannot use upload_date, duration or features. Shorts cannot use duration. Movies cannot use live, subtitles, creative_commons or 3d features."), ["video", "shorts", "channel", "playlist", "movie"]),
+            upload_date: s.withEnum(s.unknown("Limit results by upload date."), [
+                "today",
+                "this_week",
+                "this_month",
+                "this_year",
+            ]),
+            duration: s.withEnum(s.unknown("Video duration: under 3 minutes, 3–20 minutes, or over 20 minutes."), [
+                "under_3_min",
+                "between_3_and_20_min",
+                "over_20_min",
+            ]),
+            features: s.string("Comma-separated features: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr, location. Combined features must all match.", { minLength: 1, maxLength: 160 }),
+            sort_by: s.withEnum(s.unknown("YouTube ranking: relevance (default) or popularity. Popularity is not a strict numerical view-count sort.\n\nUses YouTube's current ranking choices. The removed upload-date/rating sorts and last-hour upload filter are not supported named values."), ["relevance", "popularity"]),
+            q: s.string("Search query. Required for the first page; omit with page_token.\n\nRequired on the first page.", {
+                minLength: 1,
+                maxLength: 2048,
+            }),
+            hl: s.string("YouTube interface language, such as en or pt-BR. Defaults to en. Omit with page_token.", {
+                pattern: "^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8}){0,2}$",
+            }),
+            gl: s.string("Two-letter country code. Defaults to US. Omit with page_token.", {
+                pattern: "^[A-Za-z]{2}$",
+            }),
+            sp: s.string("Advanced YouTube filter token from a results URL. Use either sp or named filters, never both. Omit with page_token.\n\nUse either sp or named filters, never both. Raw or once-URL-encoded values from a YouTube results URL are accepted.", { minLength: 1, maxLength: 2048, pattern: "^[a-zA-Z0-9_+/=%-]+$" }),
+            page_token: s.string("Opaque next_page_token from the preceding response. Send it alone to continue the same search; tokens expire after one hour.\n\nSend page_token alone, without query, locale or filter parameters. It preserves all filters. Use POST for long tokens. Pagination ends when pagination.next_page_token is absent.", { minLength: 1, maxLength: 32768, pattern: "^ct2_[A-Za-z0-9_-]{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("YouTube Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            search_information: s.looseObject("search information value.", {}),
+            video_results: s.array("video results value.", s.looseObject("video results value. item.", {})),
+            channel_results: s.array("channel results value.", s.looseObject("channel results value. item.", {})),
+            playlist_results: s.array("playlist results value.", s.looseObject("playlist results value. item.", {})),
+            shorts_results: s.array("shorts results value.", s.looseObject("shorts 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/zillow-schemas.d.ts

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

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

@@ -0,0 +1,128 @@
+import { s } from "../../core/json-schema.js";
+export const zillowTools = [
+    {
+        name: "zillow_locations",
+        path: "/api/zillow/locations",
+        description: "Get Zillow region and address suggestions.",
+        input: s.object("Zillow Locations parameters.", {
+            q: s.nullable(s.string("City, ZIP code, neighborhood or street address. Required on the first page; omit with page_token.", { minLength: 1, maxLength: 200 })),
+            type: s.nullable(s.withEnum(s.unknown("Find regions or addresses. Defaults to regions; omit with page_token.\n\nRegion suggestions include Zillow region IDs. Address suggestions return names; this route does not return property ZPIDs or coordinates."), ["regions", "addresses"])),
+            limit: s.nullable(s.integer("Suggestions per page, from 1 to 100. Defaults to 10; omit with page_token.\n\nFollow pagination.next or send pagination.next_page_token as page_token. Each lookup supports up to 1,000 suggestions; if pagination.possibly_truncated is true, refine q.", { minimum: 1, maximum: 100 })),
+            page_token: s.nullable(s.string("Opaque next_page_token from the preceding response. Send it alone to continue the same lookup.\n\nContinue the same query, suggestion type and page size without repeating previously returned suggestions. If pagination.next is null while has_more is true, send page_token through POST JSON.", { minLength: 1, maxLength: 32768 })),
+        }, { required: [] }),
+        asyncInput: s.object("Zillow Locations asynchronous parameters.", {
+            q: s.string("City, ZIP code, neighborhood or street address. Required on the first page; omit with page_token.", { minLength: 1, maxLength: 200 }),
+            type: s.withEnum(s.unknown("Find regions or addresses. Defaults to regions; omit with page_token.\n\nRegion suggestions include Zillow region IDs. Address suggestions return names; this route does not return property ZPIDs or coordinates."), ["regions", "addresses"]),
+            limit: s.integer("Suggestions per page, from 1 to 100. Defaults to 10; omit with page_token.\n\nFollow pagination.next or send pagination.next_page_token as page_token. Each lookup supports up to 1,000 suggestions; if pagination.possibly_truncated is true, refine q.", { minimum: 1, maximum: 100 }),
+            page_token: s.string("Opaque next_page_token from the preceding response. Send it alone to continue the same lookup.\n\nContinue the same query, suggestion type and page size without repeating previously returned suggestions. If pagination.next is null while has_more is true, send page_token through POST JSON.", { minLength: 1, maxLength: 32768 }),
+            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("Zillow Locations response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            locations: s.array("locations value.", s.looseObject("locations 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",
+            }),
+        }),
+    },
+    {
+        name: "zillow_property",
+        path: "/api/zillow/property",
+        description: "Get a Zillow property by ID or URL.",
+        input: s.object("Zillow Property parameters.", {
+            zpid: s.nullable(s.integer("Zillow property identifier. Supply zpid or url.", { exclusiveMinimum: 0 })),
+            url: s.nullable(s.string("Zillow homedetails URL. Supply url or zpid.\n\nSupply exactly one of url or zpid. Apartment building URLs are not property-detail URLs.", { maxLength: 2048 })),
+        }, { required: [] }),
+        asyncInput: s.object("Zillow Property asynchronous parameters.", {
+            zpid: s.integer("Zillow property identifier. Supply zpid or url.", { exclusiveMinimum: 0 }),
+            url: s.string("Zillow homedetails URL. Supply url or zpid.\n\nSupply exactly one of url or zpid. Apartment building URLs are not property-detail URLs.", { 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("Zillow 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: "zillow_search",
+        path: "/api/zillow/search",
+        description: "Search Zillow homes for sale, for rent or recently sold.",
+        input: s.object("Zillow Search parameters.", {
+            min_price: s.nullable(s.integer("Minimum listing price in US dollars.\n\nFor rental searches, prices are monthly rent 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 })),
+            q: s.nullable(s.string("City, ZIP code, neighborhood or address. Supply q or map_bounds.\n\nSupply exactly one of q or map_bounds.", { minLength: 1, maxLength: 200 })),
+            map_bounds: s.nullable(s.string("Map rectangle as north,east,south,west.")),
+            status: s.withEnum(s.unknown("Listing status."), ["for_sale", "for_rent", "sold"]),
+            property_type: s.nullable(s.withEnum(s.unknown("Restrict results to one property type."), [
+                "house",
+                "condo",
+                "townhouse",
+                "multi_family",
+                "land",
+                "manufactured",
+                "apartment",
+            ])),
+            sort: s.withEnum(s.unknown("Order of matching listings."), [
+                "recommended",
+                "newest",
+                "price_asc",
+                "price_desc",
+                "beds",
+                "sqft",
+            ]),
+            page: s.integer("Result page, starting at 1; Zillow caps searches at 20 pages.\n\nFollow pagination.next for another page. A search exposes at most 20 pages.", { minimum: 1, maximum: 20 }),
+        }, { required: [] }),
+        asyncInput: s.object("Zillow Search asynchronous parameters.", {
+            min_price: s.integer("Minimum listing price in US dollars.\n\nFor rental searches, prices are monthly rent 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 }),
+            q: s.string("City, ZIP code, neighborhood or address. Supply q or map_bounds.\n\nSupply exactly one of q or map_bounds.", { minLength: 1, maxLength: 200 }),
+            map_bounds: s.string("Map rectangle as north,east,south,west."),
+            status: s.withEnum(s.unknown("Listing status."), ["for_sale", "for_rent", "sold"]),
+            property_type: s.withEnum(s.unknown("Restrict results to one property type."), [
+                "house",
+                "condo",
+                "townhouse",
+                "multi_family",
+                "land",
+                "manufactured",
+                "apartment",
+            ]),
+            sort: s.withEnum(s.unknown("Order of matching listings."), [
+                "recommended",
+                "newest",
+                "price_asc",
+                "price_desc",
+                "beds",
+                "sqft",
+            ]),
+            page: s.integer("Result page, starting at 1; Zillow caps searches at 20 pages.\n\nFollow pagination.next for another page. A search exposes at most 20 pages.", { minimum: 1, maximum: 20 }),
+            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("Zillow 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/ziprecruiter-schemas.d.ts

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

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

@@ -0,0 +1,96 @@
+import { s } from "../../core/json-schema.js";
+export const ziprecruiterTools = [
+    {
+        name: "ziprecruiter_search",
+        path: "/api/ziprecruiter/search",
+        description: "Search ZipRecruiter jobs in the US and Canada by keyword and location.",
+        input: s.object("ZipRecruiter Search parameters.", {
+            q: s.string("Job title, keywords, or company to search for.", {
+                minLength: 1,
+                maxLength: 512,
+            }),
+            page: s.integer("One-based results page. Use next_page from the response to continue.", {
+                minimum: 1,
+            }),
+            location: s.string("City and state or ZIP code, for example New York, NY.", {
+                minLength: 1,
+                maxLength: 512,
+            }),
+            radius: s.nullable(s.integer("Search radius in miles. Use 5000 for any distance.", {
+                minimum: 0,
+                maximum: 5000,
+            })),
+            days: s.nullable(s.integer("Maximum posting age in days.", { minimum: 1 })),
+            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",
+                "contract_to_hire",
+                "temporary",
+                "as_needed",
+                "other",
+            ]), { minItems: 1, maxItems: 100 })),
+            location_type: s.nullable(s.withEnum(s.unknown("On-site, remote-only, or hybrid jobs."), ["no_remote", "only_remote", "hybrid"])),
+            salary_min: s.nullable(s.integer("Lower bound for the job's maximum annualized pay, in the location's currency.", { minimum: 0 })),
+            salary_max: s.nullable(s.integer("Upper bound for the job's maximum annualized pay.", { minimum: 0 })),
+            experience_level: s.nullable(s.withEnum(s.unknown("Experience/seniority class."), ["no_experience", "junior", "mid", "senior"])),
+            easy_apply: s.boolean("Require ZipRecruiter's quick application."),
+        }, { required: ["q", "location"] }),
+        asyncInput: s.object("ZipRecruiter Search asynchronous parameters.", {
+            q: s.string("Job title, keywords, or company to search for.", {
+                minLength: 1,
+                maxLength: 512,
+            }),
+            page: s.integer("One-based results page. Use next_page from the response to continue.", {
+                minimum: 1,
+            }),
+            location: s.string("City and state or ZIP code, for example New York, NY.", {
+                minLength: 1,
+                maxLength: 512,
+            }),
+            radius: s.integer("Search radius in miles. Use 5000 for any distance.", {
+                minimum: 0,
+                maximum: 5000,
+            }),
+            days: s.integer("Maximum posting age in days.", { minimum: 1 }),
+            employment_types: s.array("Employment types as a JSON array.", s.withEnum(s.unknown("employment types value. item."), [
+                "full_time",
+                "part_time",
+                "contract",
+                "contract_to_hire",
+                "temporary",
+                "as_needed",
+                "other",
+            ]), { minItems: 1, maxItems: 100 }),
+            location_type: s.withEnum(s.unknown("On-site, remote-only, or hybrid jobs."), [
+                "no_remote",
+                "only_remote",
+                "hybrid",
+            ]),
+            salary_min: s.integer("Lower bound for the job's maximum annualized pay, in the location's currency.", {
+                minimum: 0,
+            }),
+            salary_max: s.integer("Upper bound for the job's maximum annualized pay.", { minimum: 0 }),
+            experience_level: s.withEnum(s.unknown("Experience/seniority class."), [
+                "no_experience",
+                "junior",
+                "mid",
+                "senior",
+            ]),
+            easy_apply: s.boolean("Require ZipRecruiter's quick application."),
+            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: ["q", "location"] }),
+        output: s.looseObject("ZipRecruiter 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/magichour/actions.d.ts

@@ -0,0 +1,22 @@
+import type { ActionDefinition, JsonSchema } from "../../core/types.ts";
+export interface MagicHourRoute {
+    path: string;
+    method: string;
+    parameters: Array<{
+        name: string;
+        in: string;
+    }>;
+    body: boolean;
+}
+interface MagicHourDefinition {
+    name: string;
+    description: string;
+    operationType: ActionDefinition["operationType"];
+    route: MagicHourRoute;
+    inputSchema: JsonSchema;
+    outputSchema: JsonSchema;
+}
+declare const definitions: MagicHourDefinition[];
+export declare const magicHourRoutes: Map<string, (typeof definitions)[number]["route"]>;
+export declare const magicHourActions: ActionDefinition[];
+export {};