@tks/wayfinder 0.3.0 → 0.3.1

package/README.md

@@ -118,6 +118,12 @@ Search nearby coffee spots:
 wayfinder places --near "Shinjuku, Tokyo" --type coffee --limit 5
 ```
 
+Narrow results to walking-distance intent:
+
+```bash
+wayfinder places --near "Domino Park, Brooklyn, NY" --range walk
+```
+
 Structured places output for scripting:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tks/wayfinder",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Travel search for your terminal and your AI agents",
   "repository": {
     "type": "git",

package/src/cli.ts

@@ -22,7 +22,7 @@ interface RunOptions {
   promptImpl?: (prompt: string) => Promise<string>;
 }
 
-const HELP_TEXT = `wayfinder v0.3.0 travel search
+const HELP_TEXT = `wayfinder v0.3.1 travel search
 
 Usage:
   wayfinder setup [--reset]
@@ -30,7 +30,7 @@ Usage:
   wayfinder flights one-way --from SFO --to JFK --date 2026-03-21 [filters]
   wayfinder flights booking --from SFO --to JFK --date 2026-03-21 --token <BOOKING_TOKEN> [--token <BOOKING_TOKEN>] [--json]
   wayfinder hotels --where "New York, NY" --check-in 2026-03-21 --check-out 2026-03-23 [filters]
-  wayfinder places --near "Shinjuku, Tokyo" [--type restaurant|coffee] [--limit N] [--json]
+  wayfinder places --near "Shinjuku, Tokyo" [--type restaurant|coffee] [--range walk] [--limit N] [--json]
 
 Setup:
   Runs interactive key setup and stores your SerpApi key in local config.
@@ -72,6 +72,7 @@ Places required:
 
 Places optional filters:
   --type <restaurant|coffee> Place type (default restaurant)
+  --range <walk>            Heuristic nearby scope; "walk" narrows to walking-distance intent
   --limit <N>               Maximum number of results (default 10)
 
 Output:

package/src/parse.ts

@@ -6,6 +6,7 @@ import {
   HotelQuery,
   ParsedArgs,
   PlaceQuery,
+  PlaceRange,
   PlaceType,
 } from "./types";
 
@@ -47,6 +48,7 @@ interface PlaceRawOptions {
   near?: string;
   type?: string;
   limit?: string;
+  range?: string;
   outputJson: boolean;
   help: boolean;
 }
@@ -339,6 +341,9 @@ function parsePlacesArgs(args: string[]): ParsedArgs {
       case "--limit":
         raw.limit = value;
         break;
+      case "--range":
+        raw.range = value;
+        break;
       default:
         throw new CliError(`Unknown flag: ${token}`, ExitCode.InvalidInput);
     }
@@ -497,11 +502,13 @@ function buildPlaceQuery(raw: PlaceRawOptions): PlaceQuery {
   const near = normalizeLocation(raw.near);
   const type = raw.type ? normalizePlaceType(raw.type) : "restaurant";
   const limit = raw.limit ? normalizeLimit(raw.limit, "--limit") : 10;
+  const range = raw.range ? normalizePlaceRange(raw.range) : undefined;
 
   return {
     near,
     type,
     limit,
+    range,
   };
 }
 
@@ -658,6 +665,15 @@ function normalizePlaceType(value: string): PlaceType {
   return normalized;
 }
 
+function normalizePlaceRange(value: string): PlaceRange {
+  const normalized = value.trim().toLowerCase();
+  if (normalized !== "walk") {
+    throw new CliError("--range must be: walk", ExitCode.InvalidInput);
+  }
+
+  return normalized;
+}
+
 function normalizeTime(value: string, flagName: string): number {
   const match = /^([01]\d|2[0-3]):([0-5]\d)$/.exec(value);
   if (!match) {

package/src/serpapi.ts

@@ -387,10 +387,11 @@ function buildHotelRequestUrl(query: HotelQuery, apiKey: string): string {
 function buildPlaceRequestUrl(query: PlaceQuery, apiKey: string): string {
   const url = new URL("https://serpapi.com/search.json");
   const searchTerm = query.type === "coffee" ? "coffee" : "restaurants";
+  const rangePrefix = query.range === "walk" ? "within walking distance " : "";
 
   url.searchParams.set("engine", "google_maps");
   url.searchParams.set("type", "search");
-  url.searchParams.set("q", `${searchTerm} near ${query.near}`);
+  url.searchParams.set("q", `${rangePrefix}${searchTerm} near ${query.near}`);
   url.searchParams.set("api_key", apiKey);
   return url.toString();
 }

package/src/types.ts

@@ -31,11 +31,13 @@ export interface HotelQuery {
 }
 
 export type PlaceType = "restaurant" | "coffee";
+export type PlaceRange = "walk";
 
 export interface PlaceQuery {
   near: string;
   type: PlaceType;
   limit: number;
+  range?: PlaceRange;
 }
 
 export interface ParsedArgsHelp {