@opentabs-dev/opentabs-plugin-zillow 0.0.74

package/dist/tools/search-by-owner.js

@@ -0,0 +1,78 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { search, REGION_TYPE_MAP } from '../zillow-api.js';
+import { listingSchema, mapListing } from './schemas.js';
+export const searchByOwner = defineTool({
+    name: 'search_by_owner',
+    displayName: 'Search For Sale by Owner',
+    description: 'Search for properties listed for sale by owner (FSBO) on Zillow. Requires either a region_id (from search_locations) or map_bounds.',
+    summary: 'Find for-sale-by-owner listings',
+    icon: 'user-check',
+    group: 'Search',
+    input: z.object({
+        region_id: z
+            .number()
+            .int()
+            .optional()
+            .describe('Zillow region ID (from search_locations). Required if map_bounds is not provided.'),
+        region_type: z
+            .string()
+            .optional()
+            .describe('Region type: "city", "county", "zipcode", "neighborhood" (default "city")'),
+        map_bounds: z
+            .object({
+            west: z.number().describe('Western longitude'),
+            east: z.number().describe('Eastern longitude'),
+            south: z.number().describe('Southern latitude'),
+            north: z.number().describe('Northern latitude'),
+        })
+            .optional()
+            .describe('Map bounding box. Required if region_id is not provided.'),
+        min_price: z.number().optional().describe('Minimum price in dollars'),
+        max_price: z.number().optional().describe('Maximum price in dollars'),
+        min_beds: z.number().int().optional().describe('Minimum bedrooms'),
+        sort: z
+            .enum(['globalrelevanceex', 'days', 'pricea', 'priced', 'size'])
+            .optional()
+            .describe('Sort order (default "globalrelevanceex")'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total FSBO listings'),
+        listings: z.array(listingSchema).describe('For-sale-by-owner listings'),
+    }),
+    handle: async (params) => {
+        if (!params.region_id && !params.map_bounds) {
+            throw ToolError.validation('Either region_id or map_bounds is required.');
+        }
+        const filterState = {
+            isForSaleByOwner: { value: true },
+            isForSaleByAgent: { value: false },
+            isNewConstruction: { value: false },
+            isComingSoon: { value: false },
+            isAuction: { value: false },
+            isForSaleForeclosure: { value: false },
+        };
+        if (params.sort)
+            filterState.sortSelection = { value: params.sort };
+        if (params.min_price || params.max_price)
+            filterState.price = { min: params.min_price, max: params.max_price };
+        if (params.min_beds)
+            filterState.beds = { min: params.min_beds };
+        const bounds = params.map_bounds ?? { west: -122.5, east: -122.3, south: 37.7, north: 37.8 };
+        const data = await search({
+            pagination: params.page && params.page > 1 ? { currentPage: params.page } : undefined,
+            mapBounds: bounds,
+            regionSelection: params.region_id
+                ? [{ regionId: params.region_id, regionType: REGION_TYPE_MAP[params.region_type ?? 'city'] ?? 6 }]
+                : undefined,
+            filterState,
+            isMapVisible: true,
+        }, { cat1: ['listResults', 'total'] });
+        return {
+            total: data.categoryTotals?.cat1?.totalResultCount ?? data.cat1?.searchResults?.listResults?.length ?? 0,
+            listings: (data.cat1?.searchResults?.listResults ?? []).map(mapListing),
+        };
+    },
+});
+//# sourceMappingURL=search-by-owner.js.map

package/dist/tools/search-by-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-by-owner.js","sourceRoot":"","sources":["../../src/tools/search-by-owner.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-for-rent.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export declare const searchForRent: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    region_id: z.ZodOptional<z.ZodNumber>;
+    region_type: z.ZodOptional<z.ZodString>;
+    map_bounds: z.ZodOptional<z.ZodObject<{
+        west: z.ZodNumber;
+        east: z.ZodNumber;
+        south: z.ZodNumber;
+        north: z.ZodNumber;
+    }, z.core.$strip>>;
+    min_price: z.ZodOptional<z.ZodNumber>;
+    max_price: z.ZodOptional<z.ZodNumber>;
+    min_beds: z.ZodOptional<z.ZodNumber>;
+    min_baths: z.ZodOptional<z.ZodNumber>;
+    min_sqft: z.ZodOptional<z.ZodNumber>;
+    max_sqft: z.ZodOptional<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        beds: "beds";
+        baths: "baths";
+        globalrelevanceex: "globalrelevanceex";
+        days: "days";
+        pricea: "pricea";
+        priced: "priced";
+        size: "size";
+    }>>;
+    page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    listings: z.ZodArray<z.ZodObject<{
+        zpid: z.ZodString;
+        address: z.ZodString;
+        street: z.ZodString;
+        city: z.ZodString;
+        state: z.ZodString;
+        zipcode: z.ZodString;
+        price: z.ZodString;
+        price_raw: z.ZodNumber;
+        beds: z.ZodNumber;
+        baths: z.ZodNumber;
+        sqft: z.ZodNumber;
+        status: z.ZodString;
+        status_text: z.ZodString;
+        home_type: z.ZodString;
+        days_on_zillow: z.ZodNumber;
+        zestimate: z.ZodNumber;
+        rent_zestimate: z.ZodNumber;
+        tax_assessed_value: z.ZodNumber;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        image_url: z.ZodString;
+        detail_url: z.ZodString;
+        is_saved: z.ZodBoolean;
+        has_3d_model: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-for-rent.d.ts.map

package/dist/tools/search-for-rent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-for-rent.d.ts","sourceRoot":"","sources":["../../src/tools/search-for-rent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsFxB,CAAC"}

package/dist/tools/search-for-rent.js

@@ -0,0 +1,86 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { search, REGION_TYPE_MAP } from '../zillow-api.js';
+import { listingSchema, mapListing } from './schemas.js';
+export const searchForRent = defineTool({
+    name: 'search_for_rent',
+    displayName: 'Search For Rent',
+    description: 'Search for rental properties on Zillow. Requires either a region_id (from search_locations) or map_bounds. Supports filtering by price, beds, baths, and more. Returns up to 41 results per page.',
+    summary: 'Search rental properties',
+    icon: 'building',
+    group: 'Search',
+    input: z.object({
+        region_id: z
+            .number()
+            .int()
+            .optional()
+            .describe('Zillow region ID (from search_locations). Required if map_bounds is not provided.'),
+        region_type: z
+            .string()
+            .optional()
+            .describe('Region type: "city", "county", "zipcode", "neighborhood" (default "city")'),
+        map_bounds: z
+            .object({
+            west: z.number().describe('Western longitude'),
+            east: z.number().describe('Eastern longitude'),
+            south: z.number().describe('Southern latitude'),
+            north: z.number().describe('Northern latitude'),
+        })
+            .optional()
+            .describe('Map bounding box. Required if region_id is not provided.'),
+        min_price: z.number().optional().describe('Minimum monthly rent in dollars'),
+        max_price: z.number().optional().describe('Maximum monthly rent in dollars'),
+        min_beds: z.number().int().optional().describe('Minimum bedrooms'),
+        min_baths: z.number().int().optional().describe('Minimum bathrooms'),
+        min_sqft: z.number().optional().describe('Minimum square footage'),
+        max_sqft: z.number().optional().describe('Maximum square footage'),
+        sort: z
+            .enum(['globalrelevanceex', 'days', 'pricea', 'priced', 'size', 'beds', 'baths'])
+            .optional()
+            .describe('Sort order (default "globalrelevanceex"). "days"=Newest, "pricea"=Price low-high, "priced"=Price high-low'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total number of matching rentals'),
+        listings: z.array(listingSchema).describe('Rental listings'),
+    }),
+    handle: async (params) => {
+        if (!params.region_id && !params.map_bounds) {
+            throw ToolError.validation('Either region_id or map_bounds is required.');
+        }
+        const filterState = {
+            isForRent: { value: true },
+            isForSaleByAgent: { value: false },
+            isForSaleByOwner: { value: false },
+            isNewConstruction: { value: false },
+            isComingSoon: { value: false },
+            isAuction: { value: false },
+            isForSaleForeclosure: { value: false },
+        };
+        if (params.sort)
+            filterState.sortSelection = { value: params.sort };
+        if (params.min_price || params.max_price)
+            filterState.price = { min: params.min_price, max: params.max_price };
+        if (params.min_beds)
+            filterState.beds = { min: params.min_beds };
+        if (params.min_baths)
+            filterState.baths = { min: params.min_baths };
+        if (params.min_sqft || params.max_sqft)
+            filterState.sqft = { min: params.min_sqft, max: params.max_sqft };
+        const bounds = params.map_bounds ?? { west: -122.5, east: -122.3, south: 37.7, north: 37.8 };
+        const data = await search({
+            pagination: params.page && params.page > 1 ? { currentPage: params.page } : undefined,
+            mapBounds: bounds,
+            regionSelection: params.region_id
+                ? [{ regionId: params.region_id, regionType: REGION_TYPE_MAP[params.region_type ?? 'city'] ?? 6 }]
+                : undefined,
+            filterState,
+            isMapVisible: true,
+        }, { cat1: ['listResults', 'total'] });
+        return {
+            total: data.categoryTotals?.cat1?.totalResultCount ?? data.cat1?.searchResults?.listResults?.length ?? 0,
+            listings: (data.cat1?.searchResults?.listResults ?? []).map(mapListing),
+        };
+    },
+});
+//# sourceMappingURL=search-for-rent.js.map

package/dist/tools/search-for-rent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-for-rent.js","sourceRoot":"","sources":["../../src/tools/search-for-rent.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-for-sale.d.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+export declare const searchForSale: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    region_id: z.ZodOptional<z.ZodNumber>;
+    region_type: z.ZodOptional<z.ZodString>;
+    map_bounds: z.ZodOptional<z.ZodObject<{
+        west: z.ZodNumber;
+        east: z.ZodNumber;
+        south: z.ZodNumber;
+        north: z.ZodNumber;
+    }, z.core.$strip>>;
+    min_price: z.ZodOptional<z.ZodNumber>;
+    max_price: z.ZodOptional<z.ZodNumber>;
+    min_beds: z.ZodOptional<z.ZodNumber>;
+    max_beds: z.ZodOptional<z.ZodNumber>;
+    min_baths: z.ZodOptional<z.ZodNumber>;
+    min_sqft: z.ZodOptional<z.ZodNumber>;
+    max_sqft: z.ZodOptional<z.ZodNumber>;
+    home_type: z.ZodOptional<z.ZodEnum<{
+        single_family: "single_family";
+        condo: "condo";
+        townhouse: "townhouse";
+        multi_family: "multi_family";
+        lot_land: "lot_land";
+        manufactured: "manufactured";
+    }>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        beds: "beds";
+        baths: "baths";
+        globalrelevanceex: "globalrelevanceex";
+        days: "days";
+        pricea: "pricea";
+        priced: "priced";
+        size: "size";
+        zest: "zest";
+        zesta: "zesta";
+        lot: "lot";
+    }>>;
+    page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    listings: z.ZodArray<z.ZodObject<{
+        zpid: z.ZodString;
+        address: z.ZodString;
+        street: z.ZodString;
+        city: z.ZodString;
+        state: z.ZodString;
+        zipcode: z.ZodString;
+        price: z.ZodString;
+        price_raw: z.ZodNumber;
+        beds: z.ZodNumber;
+        baths: z.ZodNumber;
+        sqft: z.ZodNumber;
+        status: z.ZodString;
+        status_text: z.ZodString;
+        home_type: z.ZodString;
+        days_on_zillow: z.ZodNumber;
+        zestimate: z.ZodNumber;
+        rent_zestimate: z.ZodNumber;
+        tax_assessed_value: z.ZodNumber;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        image_url: z.ZodString;
+        detail_url: z.ZodString;
+        is_saved: z.ZodBoolean;
+        has_3d_model: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-for-sale.d.ts.map

package/dist/tools/search-for-sale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-for-sale.d.ts","sourceRoot":"","sources":["../../src/tools/search-for-sale.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgGxB,CAAC"}

package/dist/tools/search-for-sale.js

@@ -0,0 +1,98 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { search, REGION_TYPE_MAP } from '../zillow-api.js';
+import { listingSchema, mapListing } from './schemas.js';
+export const searchForSale = defineTool({
+    name: 'search_for_sale',
+    displayName: 'Search For Sale',
+    description: 'Search for properties currently for sale on Zillow. Requires either a region_id (from search_locations) or map_bounds. Supports filtering by price, beds, baths, square footage, home type, and more. Returns up to 41 results per page with pagination support.',
+    summary: 'Search properties for sale',
+    icon: 'home',
+    group: 'Search',
+    input: z.object({
+        region_id: z
+            .number()
+            .int()
+            .optional()
+            .describe('Zillow region ID (from search_locations). Required if map_bounds is not provided.'),
+        region_type: z
+            .string()
+            .optional()
+            .describe('Region type: "city", "county", "zipcode", "neighborhood" (default "city")'),
+        map_bounds: z
+            .object({
+            west: z.number().describe('Western longitude'),
+            east: z.number().describe('Eastern longitude'),
+            south: z.number().describe('Southern latitude'),
+            north: z.number().describe('Northern latitude'),
+        })
+            .optional()
+            .describe('Map bounding box. Required if region_id is not provided.'),
+        min_price: z.number().optional().describe('Minimum price in dollars'),
+        max_price: z.number().optional().describe('Maximum price in dollars'),
+        min_beds: z.number().int().optional().describe('Minimum bedrooms'),
+        max_beds: z.number().int().optional().describe('Maximum bedrooms'),
+        min_baths: z.number().int().optional().describe('Minimum bathrooms'),
+        min_sqft: z.number().optional().describe('Minimum square footage'),
+        max_sqft: z.number().optional().describe('Maximum square footage'),
+        home_type: z
+            .enum(['single_family', 'condo', 'townhouse', 'multi_family', 'lot_land', 'manufactured'])
+            .optional()
+            .describe('Property type filter'),
+        sort: z
+            .enum(['globalrelevanceex', 'days', 'pricea', 'priced', 'zest', 'zesta', 'size', 'lot', 'beds', 'baths'])
+            .optional()
+            .describe('Sort order (default "globalrelevanceex" = Homes for You). "days"=Newest, "pricea"=Price low-high, "priced"=Price high-low, "zest"=Zestimate high-low'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total number of matching listings'),
+        listings: z.array(listingSchema).describe('Property listings'),
+    }),
+    handle: async (params) => {
+        if (!params.region_id && !params.map_bounds) {
+            throw ToolError.validation('Either region_id or map_bounds is required.');
+        }
+        const filterState = {};
+        if (params.sort)
+            filterState.sortSelection = { value: params.sort };
+        if (params.min_price || params.max_price)
+            filterState.price = { min: params.min_price, max: params.max_price };
+        if (params.min_beds)
+            filterState.beds = { min: params.min_beds };
+        if (params.max_beds)
+            filterState.beds = { ...filterState.beds, max: params.max_beds };
+        if (params.min_baths)
+            filterState.baths = { min: params.min_baths };
+        if (params.min_sqft || params.max_sqft)
+            filterState.sqft = { min: params.min_sqft, max: params.max_sqft };
+        if (params.home_type) {
+            const typeMap = {
+                single_family: 'isSingleFamily',
+                condo: 'isCondo',
+                townhouse: 'isTownhouse',
+                multi_family: 'isMultiFamily',
+                lot_land: 'isLotLand',
+                manufactured: 'isManufactured',
+            };
+            const key = typeMap[params.home_type];
+            if (key)
+                filterState[key] = { value: true };
+        }
+        const bounds = params.map_bounds ?? { west: -122.5, east: -122.3, south: 37.7, north: 37.8 };
+        const data = await search({
+            pagination: params.page && params.page > 1 ? { currentPage: params.page } : undefined,
+            mapBounds: bounds,
+            regionSelection: params.region_id
+                ? [{ regionId: params.region_id, regionType: REGION_TYPE_MAP[params.region_type ?? 'city'] ?? 6 }]
+                : undefined,
+            filterState,
+            isMapVisible: true,
+        }, { cat1: ['listResults', 'total'], cat2: ['total'] });
+        return {
+            total: data.categoryTotals?.cat1?.totalResultCount ?? data.cat1?.searchResults?.listResults?.length ?? 0,
+            listings: (data.cat1?.searchResults?.listResults ?? []).map(mapListing),
+        };
+    },
+});
+//# sourceMappingURL=search-for-sale.js.map

package/dist/tools/search-for-sale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-for-sale.js","sourceRoot":"","sources":["../../src/tools/search-for-sale.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-foreclosures.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export declare const searchForeclosures: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    region_id: z.ZodOptional<z.ZodNumber>;
+    region_type: z.ZodOptional<z.ZodString>;
+    map_bounds: z.ZodOptional<z.ZodObject<{
+        west: z.ZodNumber;
+        east: z.ZodNumber;
+        south: z.ZodNumber;
+        north: z.ZodNumber;
+    }, z.core.$strip>>;
+    min_price: z.ZodOptional<z.ZodNumber>;
+    max_price: z.ZodOptional<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        globalrelevanceex: "globalrelevanceex";
+        days: "days";
+        pricea: "pricea";
+        priced: "priced";
+    }>>;
+    page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    listings: z.ZodArray<z.ZodObject<{
+        zpid: z.ZodString;
+        address: z.ZodString;
+        street: z.ZodString;
+        city: z.ZodString;
+        state: z.ZodString;
+        zipcode: z.ZodString;
+        price: z.ZodString;
+        price_raw: z.ZodNumber;
+        beds: z.ZodNumber;
+        baths: z.ZodNumber;
+        sqft: z.ZodNumber;
+        status: z.ZodString;
+        status_text: z.ZodString;
+        home_type: z.ZodString;
+        days_on_zillow: z.ZodNumber;
+        zestimate: z.ZodNumber;
+        rent_zestimate: z.ZodNumber;
+        tax_assessed_value: z.ZodNumber;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        image_url: z.ZodString;
+        detail_url: z.ZodString;
+        is_saved: z.ZodBoolean;
+        has_3d_model: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-foreclosures.d.ts.map

package/dist/tools/search-foreclosures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-foreclosures.d.ts","sourceRoot":"","sources":["../../src/tools/search-foreclosures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4E7B,CAAC"}

package/dist/tools/search-foreclosures.js

@@ -0,0 +1,75 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { search, REGION_TYPE_MAP } from '../zillow-api.js';
+import { listingSchema, mapListing } from './schemas.js';
+export const searchForeclosures = defineTool({
+    name: 'search_foreclosures',
+    displayName: 'Search Foreclosures',
+    description: 'Search for foreclosure and pre-foreclosure properties on Zillow. Requires either a region_id (from search_locations) or map_bounds.',
+    summary: 'Find foreclosure properties',
+    icon: 'alert-triangle',
+    group: 'Search',
+    input: z.object({
+        region_id: z
+            .number()
+            .int()
+            .optional()
+            .describe('Zillow region ID (from search_locations). Required if map_bounds is not provided.'),
+        region_type: z
+            .string()
+            .optional()
+            .describe('Region type: "city", "county", "zipcode", "neighborhood" (default "city")'),
+        map_bounds: z
+            .object({
+            west: z.number().describe('Western longitude'),
+            east: z.number().describe('Eastern longitude'),
+            south: z.number().describe('Southern latitude'),
+            north: z.number().describe('Northern latitude'),
+        })
+            .optional()
+            .describe('Map bounding box. Required if region_id is not provided.'),
+        min_price: z.number().optional().describe('Minimum price in dollars'),
+        max_price: z.number().optional().describe('Maximum price in dollars'),
+        sort: z
+            .enum(['globalrelevanceex', 'days', 'pricea', 'priced'])
+            .optional()
+            .describe('Sort order (default "globalrelevanceex")'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total foreclosure listings'),
+        listings: z.array(listingSchema).describe('Foreclosure listings'),
+    }),
+    handle: async (params) => {
+        if (!params.region_id && !params.map_bounds) {
+            throw ToolError.validation('Either region_id or map_bounds is required.');
+        }
+        const filterState = {
+            isForSaleForeclosure: { value: true },
+            isForSaleByAgent: { value: false },
+            isForSaleByOwner: { value: false },
+            isNewConstruction: { value: false },
+            isComingSoon: { value: false },
+            isAuction: { value: false },
+        };
+        if (params.sort)
+            filterState.sortSelection = { value: params.sort };
+        if (params.min_price || params.max_price)
+            filterState.price = { min: params.min_price, max: params.max_price };
+        const bounds = params.map_bounds ?? { west: -122.5, east: -122.3, south: 37.7, north: 37.8 };
+        const data = await search({
+            pagination: params.page && params.page > 1 ? { currentPage: params.page } : undefined,
+            mapBounds: bounds,
+            regionSelection: params.region_id
+                ? [{ regionId: params.region_id, regionType: REGION_TYPE_MAP[params.region_type ?? 'city'] ?? 6 }]
+                : undefined,
+            filterState,
+            isMapVisible: true,
+        }, { cat1: ['listResults', 'total'] });
+        return {
+            total: data.categoryTotals?.cat1?.totalResultCount ?? data.cat1?.searchResults?.listResults?.length ?? 0,
+            listings: (data.cat1?.searchResults?.listResults ?? []).map(mapListing),
+        };
+    },
+});
+//# sourceMappingURL=search-foreclosures.js.map

package/dist/tools/search-foreclosures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-foreclosures.js","sourceRoot":"","sources":["../../src/tools/search-foreclosures.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-locations.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const searchLocations: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    locations: z.ZodArray<z.ZodObject<{
+        display: z.ZodString;
+        type: z.ZodString;
+        city: z.ZodString;
+        state: z.ZodString;
+        county: z.ZodString;
+        region_id: z.ZodNumber;
+        region_type: z.ZodString;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        zpid: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-locations.d.ts.map

package/dist/tools/search-locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-locations.d.ts","sourceRoot":"","sources":["../../src/tools/search-locations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;kBAkB1B,CAAC"}

package/dist/tools/search-locations.js

@@ -0,0 +1,23 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { autocomplete } from '../zillow-api.js';
+import { locationSchema, mapLocation } from './schemas.js';
+export const searchLocations = defineTool({
+    name: 'search_locations',
+    displayName: 'Search Locations',
+    description: 'Search for cities, ZIP codes, neighborhoods, and addresses on Zillow. Returns location suggestions with region IDs that can be used with search tools. Use this to resolve a location name to a region_id before calling search_for_sale, search_for_rent, or search_recently_sold.',
+    summary: 'Search for cities, ZIP codes, neighborhoods, and addresses',
+    icon: 'map-pin',
+    group: 'Search',
+    input: z.object({
+        query: z.string().min(1).describe('Location search text (e.g., "San Francisco", "94107", "Mission District")'),
+    }),
+    output: z.object({
+        locations: z.array(locationSchema).describe('Matching locations'),
+    }),
+    handle: async (params) => {
+        const results = await autocomplete(params.query);
+        return { locations: results.map(mapLocation) };
+    },
+});
+//# sourceMappingURL=search-locations.js.map

package/dist/tools/search-locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-locations.js","sourceRoot":"","sources":["../../src/tools/search-locations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EACT,qRAAqR;IACvR,OAAO,EAAE,4DAA4D;IACrE,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2EAA2E,CAAC;KAC/G,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;KAClE,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;IACjD,CAAC;CACF,CAAC,CAAC"}