@framers/agentos-ext-trulia-search 0.1.0 → 0.1.2

package/README.md

@@ -61,4 +61,4 @@ At least one key is needed for results. Without either, the tool returns empty l
 
 ## License
 
-MIT
+Apache-2.0

package/manifest.json

@@ -2,12 +2,12 @@
   "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
   "id": "com.framers.tools.trulia-search",
   "name": "Trulia Property Search",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Search real estate properties on Trulia with RapidAPI or Firecrawl scrape fallback.",
-  "author": { "name": "Manic Agency LLC", "url": "https://manic.agency" },
-  "license": "MIT",
+  "author": { "name": "Frame", "url": "https://frame.dev" },
+  "license": "Apache-2.0",
   "keywords": ["trulia", "real-estate", "property", "search", "housing"],
-  "agentosVersion": "^2.0.0",
+  "agentosVersion": ">=0.10.40",
   "categories": ["tool", "research"],
   "platforms": [],
   "sdk": "none",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos-ext-trulia-search",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Search real estate properties on Trulia by location, price, bedrooms, and property type",
   "type": "module",
   "main": "dist/index.js",
@@ -14,7 +14,7 @@
     "./package.json": "./package.json"
   },
   "peerDependencies": {
-    "@framers/agentos": "^0.5.2"
+    "@framers/agentos": ">=0.10.40"
   },
   "keywords": [
     "agentos",
@@ -24,22 +24,34 @@
     "real-estate",
     "property-search"
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/framersai/agentos-extensions.git",
+    "url": "git+https://github.com/framerslab/agentos-extensions.git",
     "directory": "registry/curated/research/trulia-search"
   },
-  "homepage": "https://github.com/framersai/agentos-extensions/tree/master/registry/curated/research/trulia-search#readme",
+  "homepage": "https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/research/trulia-search#readme",
   "bugs": {
-    "url": "https://github.com/framersai/agentos-extensions/issues"
+    "url": "https://github.com/framerslab/agentos-extensions/issues"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@framers/agentos": "^0.13.40",
+    "@types/node": "^20.12.12",
+    "rimraf": "^5.0.7",
+    "typescript": "^5.4.5",
+    "vitest": "^3.2.7"
   },
   "scripts": {
     "build": "tsc",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "clean": "rimraf dist"
   }
 }

package/src/TruliaSearchTool.ts

@@ -1,135 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Trulia property search tool.
- *
- * Uses RapidAPI Trulia endpoint when available, falls back to
- * Firecrawl scrape of trulia.com search results.
- *
- * @module agentos-ext-trulia-search/TruliaSearchTool
- */
-
-import type { TruliaSearchInput, TruliaSearchOutput, TruliaListing } from './types.js';
-
-/** ITool implementation for Trulia real estate search. */
-export class TruliaSearchTool {
-  readonly id = 'trulia_search';
-  readonly name = 'trulia_search';
-  readonly displayName = 'Trulia Property Search';
-  readonly description = 'Search for real estate properties by location, price, bedrooms, and property type.';
-  readonly parameters = {
-    type: 'object' as const,
-    properties: {
-      location: { type: 'string', description: 'City, state or zip code (e.g., "Austin, TX")' },
-      propertyType: { type: 'string', enum: ['house', 'apartment', 'condo', 'townhouse', 'land'], description: 'Property type filter' },
-      minPrice: { type: 'number', description: 'Minimum price' },
-      maxPrice: { type: 'number', description: 'Maximum price' },
-      bedrooms: { type: 'number', description: 'Minimum bedrooms' },
-      bathrooms: { type: 'number', description: 'Minimum bathrooms' },
-      maxResults: { type: 'number', description: 'Maximum results (default: 20)' },
-    },
-    required: ['location'],
-  };
-
-  private truliaRapidApiKey?: string;
-  private firecrawlApiKey?: string;
-
-  constructor(config?: { truliaRapidApiKey?: string; firecrawlApiKey?: string }) {
-    this.truliaRapidApiKey = config?.truliaRapidApiKey ?? process.env.TRULIA_RAPIDAPI_KEY;
-    this.firecrawlApiKey = config?.firecrawlApiKey ?? process.env.FIRECRAWL_API_KEY;
-  }
-
-  async execute(input: TruliaSearchInput): Promise<TruliaSearchOutput> {
-    const maxResults = input.maxResults ?? 20;
-
-    if (this.truliaRapidApiKey) {
-      return this.searchViaRapidApi(input, maxResults);
-    }
-
-    if (this.firecrawlApiKey) {
-      return this.searchViaFirecrawlScrape(input, maxResults);
-    }
-
-    return { listings: [], totalResults: 0, location: input.location };
-  }
-
-  /** Search via RapidAPI Trulia endpoint. */
-  private async searchViaRapidApi(input: TruliaSearchInput, maxResults: number): Promise<TruliaSearchOutput> {
-    const params = new URLSearchParams({ location: input.location });
-    if (input.propertyType) params.set('type', input.propertyType);
-    if (input.minPrice) params.set('minPrice', String(input.minPrice));
-    if (input.maxPrice) params.set('maxPrice', String(input.maxPrice));
-    if (input.bedrooms) params.set('beds', String(input.bedrooms));
-    if (input.bathrooms) params.set('baths', String(input.bathrooms));
-    params.set('limit', String(maxResults));
-
-    const res = await fetch(`https://trulia-com4.p.rapidapi.com/properties/search?${params}`, {
-      headers: {
-        'x-rapidapi-key': this.truliaRapidApiKey!,
-        'x-rapidapi-host': 'trulia-com4.p.rapidapi.com',
-      },
-    });
-
-    if (!res.ok) throw new Error(`Trulia RapidAPI error: ${res.status}`);
-
-    const data = (await res.json()) as {
-      data?: Array<{
-        address?: string; price?: number; bedrooms?: number; bathrooms?: number;
-        sqft?: number; url?: string; photo?: string; listedDate?: string; propertyType?: string;
-      }>;
-      total?: number;
-    };
-
-    const listings: TruliaListing[] = (data.data ?? []).map((p) => ({
-      address: p.address ?? '',
-      price: p.price ?? 0,
-      beds: p.bedrooms ?? 0,
-      baths: p.bathrooms ?? 0,
-      sqft: p.sqft ?? 0,
-      url: p.url ?? '',
-      imageUrl: p.photo,
-      listingDate: p.listedDate ?? '',
-      propertyType: p.propertyType ?? 'house',
-    }));
-
-    return { listings, totalResults: data.total ?? listings.length, location: input.location };
-  }
-
-  /** Fallback: scrape trulia.com via Firecrawl. */
-  private async searchViaFirecrawlScrape(input: TruliaSearchInput, maxResults: number): Promise<TruliaSearchOutput> {
-    const locationSlug = input.location.toLowerCase().replace(/[,\s]+/g, '-').replace(/-+/g, '-');
-    const url = `https://www.trulia.com/${locationSlug}/`;
-
-    const res = await fetch('https://api.firecrawl.dev/v1/scrape', {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${this.firecrawlApiKey}`,
-      },
-      body: JSON.stringify({ url, formats: ['markdown'] }),
-    });
-
-    if (!res.ok) return { listings: [], totalResults: 0, location: input.location };
-
-    const data = (await res.json()) as { data?: { markdown?: string } };
-    const markdown = data.data?.markdown ?? '';
-
-    const listings: TruliaListing[] = [];
-    const pricePattern = /\$[\d,]+/g;
-    const prices = markdown.match(pricePattern) ?? [];
-
-    for (let i = 0; i < Math.min(prices.length, maxResults); i++) {
-      listings.push({
-        address: `Listing ${i + 1} in ${input.location}`,
-        price: parseInt(prices[i].replace(/[$,]/g, ''), 10),
-        beds: input.bedrooms ?? 0,
-        baths: input.bathrooms ?? 0,
-        sqft: 0,
-        url,
-        listingDate: new Date().toISOString(),
-        propertyType: input.propertyType ?? 'house',
-      });
-    }
-
-    return { listings, totalResults: listings.length, location: input.location };
-  }
-}

package/src/index.ts

@@ -1,20 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Extension pack factory for Trulia property search.
- * @module agentos-ext-trulia-search
- */
-
-import { TruliaSearchTool } from './TruliaSearchTool.js';
-
-export { TruliaSearchTool } from './TruliaSearchTool.js';
-export type { TruliaSearchInput, TruliaSearchOutput, TruliaListing } from './types.js';
-
-/** Create the Trulia search extension pack. */
-export function createExtensionPack(ctx?: { config?: { truliaRapidApiKey?: string; firecrawlApiKey?: string } }) {
-  const tool = new TruliaSearchTool(ctx?.config);
-  return {
-    name: '@framers/agentos-ext-trulia-search',
-    version: '0.1.0',
-    descriptors: [{ id: 'trulia_search', kind: 'tool' as const, priority: 50, payload: tool }],
-  };
-}

package/src/types.ts

@@ -1,36 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Types for the Trulia real estate search extension.
- * @module agentos-ext-trulia-search/types
- */
-
-/** Input for trulia_search tool. */
-export interface TruliaSearchInput {
-  location: string;
-  propertyType?: 'house' | 'apartment' | 'condo' | 'townhouse' | 'land';
-  minPrice?: number;
-  maxPrice?: number;
-  bedrooms?: number;
-  bathrooms?: number;
-  maxResults?: number;
-}
-
-/** A single property listing. */
-export interface TruliaListing {
-  address: string;
-  price: number;
-  beds: number;
-  baths: number;
-  sqft: number;
-  url: string;
-  imageUrl?: string;
-  listingDate: string;
-  propertyType: string;
-}
-
-/** Output of trulia_search. */
-export interface TruliaSearchOutput {
-  listings: TruliaListing[];
-  totalResults: number;
-  location: string;
-}

package/test/TruliaSearchTool.spec.ts

@@ -1,62 +0,0 @@
-// @ts-nocheck
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { TruliaSearchTool } from '../src/TruliaSearchTool.js';
-
-describe('TruliaSearchTool', () => {
-  const originalFetch = globalThis.fetch;
-
-  afterEach(() => {
-    globalThis.fetch = originalFetch;
-  });
-
-  it('has correct tool metadata', () => {
-    const tool = new TruliaSearchTool();
-    expect(tool.id).toBe('trulia_search');
-    expect(tool.name).toBe('trulia_search');
-    expect(tool.parameters.required).toContain('location');
-  });
-
-  it('returns empty listings when no API keys configured', async () => {
-    const tool = new TruliaSearchTool({ truliaRapidApiKey: undefined, firecrawlApiKey: undefined });
-    const result = await tool.execute({ location: 'Austin, TX' });
-    expect(result.listings).toEqual([]);
-    expect(result.location).toBe('Austin, TX');
-  });
-
-  it('searches via RapidAPI when key is provided', async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({
-        data: [
-          { address: '123 Main St', price: 350000, bedrooms: 3, bathrooms: 2, sqft: 1500, url: 'https://trulia.com/p/1', propertyType: 'house' },
-          { address: '456 Oak Ave', price: 420000, bedrooms: 4, bathrooms: 3, sqft: 2200, url: 'https://trulia.com/p/2', propertyType: 'house' },
-        ],
-        total: 2,
-      }),
-    });
-
-    const tool = new TruliaSearchTool({ truliaRapidApiKey: 'test-key' });
-    const result = await tool.execute({ location: 'Austin, TX', bedrooms: 3 });
-
-    expect(result.listings.length).toBe(2);
-    expect(result.listings[0].address).toBe('123 Main St');
-    expect(result.listings[0].price).toBe(350000);
-    expect(result.totalResults).toBe(2);
-  });
-
-  it('falls back to Firecrawl scrape when no RapidAPI key', async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({
-        data: { markdown: 'Property 1 $250,000 3 bed\nProperty 2 $350,000 4 bed\nProperty 3 $450,000 5 bed' },
-      }),
-    });
-
-    const tool = new TruliaSearchTool({ firecrawlApiKey: 'fc-key' });
-    const result = await tool.execute({ location: 'Austin, TX', maxResults: 2 });
-
-    expect(result.listings.length).toBe(2);
-    expect(result.listings[0].price).toBe(250000);
-    expect(result.listings[1].price).toBe(350000);
-  });
-});

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["src"],
-  "exclude": ["dist", "test", "node_modules"]
-}