heyyumi 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,11 +6,12 @@
6
6
 
7
7
  **Your AI finds and books real Korean restaurants, no Korean needed.**
8
8
 
9
- Ask your agent for *"bibimbap near Myeongdong"*, *"a place BTS's Jin goes to for naengmyeon"* or *"somewhere open for dinner in Hongdae where nobody minds that I don't speak Korean"*. HeyYumi answers from verified data on **546,000+ restaurants, cafes and bars across Korea**, and sends the table request to the restaurant itself. Within 5 minutes you know whether the table is yours.
9
+ Ask your agent for *"bibimbap near Myeongdong"*, *"a place BTS's Jin goes to for naengmyeon"* or *"somewhere open for dinner in Hongdae where nobody minds that I don't speak Korean"*. HeyYumi answers from verified data on **546,000+ restaurants, cafes and bars across Korea**, and sends the table request to the restaurant itself. Within 5 minutes you know whether the table is yours. It finds hair salons, nail, lash and waxing shops and skin care the same way: *"my hair has gotten long, should I get a cut today?"*
10
10
 
11
11
  ```bash
12
12
  npx -y heyyumi login # once: Google sign-in in the browser, a key is made for you
13
13
  npx -y heyyumi search bibimbap --region Myeongdong
14
+ npx -y heyyumi search --region Seongsu --business_category salon # hair salons; beauty = every beauty kind
14
15
  npx -y heyyumi reserve <placeId> --time "2026-10-25 19:00" --party 2 --phone +1-415-555-0100 --email you@example.com
15
16
  ```
16
17
 
@@ -106,7 +107,7 @@ npx -y heyyumi place <placeId> --fields all # menu, hours, attributes,
106
107
  | `search [KEYWORD] --region NAME [filters]` | Shortlist venues. `--region` takes Korean or romanized names, stations and landmarks (`Hongdae`, `강남역`, `제주공항`). Every `search_places` filter works as a flag (see `heyyumi tools search_places`). Returns 10 venues unless `--page-size` is given. |
107
108
  | `nearby --lat --lng [--radius] [--sort distance\|discovery]` | Venues around a point. |
108
109
  | `place ID [--fields all]` | Full details for one venue. |
109
- | `photos ID` | The owner's photo URLs. |
110
+ | `photos ID` | Photo URLs: the owner's, plus food photos and videos from credited creators (with their @handle and post link). |
110
111
  | `regions NAME` · `categories` · `stats` | Region lookup, category list, coverage numbers. |
111
112
  | `reserve ID --time --party --phone [--name --email --note --lang]` | Send a table request. Times without an offset are Korea time. `--email` is required for non-Korean phone numbers. |
112
113
  | `wait RESERVATION_ID [--timeout 110]` | Wait for the venue's answer. Re-run if `cli.settled` is false. |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "heyyumi",
3
- "version": "0.1.3",
4
- "description": "Your AI finds and books real Korean restaurants, no Korean needed. 546,000+ verified venues; search, details and table requests as JSON for any agent.",
3
+ "version": "0.1.5",
4
+ "description": "Your AI finds and books real Korean restaurants and hair & nail salons, no Korean needed. 546,000+ verified venues; search, details and reservation requests as JSON for any agent.",
5
5
  "license": "MIT",
6
6
  "bin": {
7
7
  "heyyumi": "bin/heyyumi.js"
@@ -32,6 +32,9 @@
32
32
  "seoul",
33
33
  "restaurant",
34
34
  "reservation",
35
+ "beauty",
36
+ "hair-salon",
37
+ "nail-salon",
35
38
  "booking",
36
39
  "travel",
37
40
  "ai-agent",
package/src/commands.js CHANGED
@@ -93,7 +93,28 @@ const CLI_FOR_TOOL = {
93
93
  request_live_status: "npx -y heyyumi live",
94
94
  wait_for_live_status: "npx -y heyyumi live-wait",
95
95
  };
96
- const GUIDE_TOPICS = { search: "search_places", place: "get_place", reserve: "request_reservation", live: "request_live_status" };
96
+ const GUIDE_TOPICS = {
97
+ search: "search_places",
98
+ place: "get_place",
99
+ photos: "show_place_photos",
100
+ reserve: "request_reservation",
101
+ live: "request_live_status",
102
+ };
103
+
104
+ /**
105
+ * show_place_photos answers with one JSON block plus base64 thumbnails. A terminal agent gets the JSON
106
+ * (full-size urls, credit, postUrl, videoUrl, ambassadorPosts, the server note) and no thumbnails.
107
+ */
108
+ function photosResult(data) {
109
+ const parts = Array.isArray(data) ? data : [data];
110
+ const json = parts.find((p) => p && typeof p === "object" && p.type !== "image") || {};
111
+ return {
112
+ ...json,
113
+ cli: {
114
+ note: "Thumbnails are left out of CLI output. Show each photo `url` as a link; for items with `credit`, put the credit next to the photo and link `postUrl`.",
115
+ },
116
+ };
117
+ }
97
118
 
98
119
  // Commands that build tool arguments by hand. Anything else they get is a typo, and a dropped
99
120
  // `--nme` would book under no name, so reject it. Commands not listed forward flags to the tool,
@@ -102,7 +123,7 @@ const OWN_FLAGS = {
102
123
  login: ["client-name", "no-browser", "timeout", "force"],
103
124
  logout: [],
104
125
  status: [],
105
- photos: [],
126
+ photos: ["category", "limit"],
106
127
  categories: [],
107
128
  stats: [],
108
129
  reserve: ["time", "party", "phone", "name", "email", "note", "lang", "idempotency-key"],
@@ -186,10 +207,17 @@ const commands = {
186
207
  return tool("get_place", { id, ...flagsToToolArgs(flags) });
187
208
  },
188
209
 
189
- // Photo URLs via get_place; the photo tool returns base64 thumbnails, which do not belong in a terminal.
190
- async photos({ positionals }) {
210
+ // The photo tool also lists ambassador photos with their credit, and says what to do when there are none.
211
+ async photos({ positionals, flags }) {
191
212
  const id = requirePositional(positionals, "place id", "heyyumi photos 21853004");
192
- return tool("get_place", { id, fields: "photos" });
213
+ const args = { id };
214
+ if (flags.category !== undefined) args.category = String(flags.category);
215
+ if (flags.limit !== undefined) {
216
+ const n = Number(flags.limit);
217
+ if (!Number.isInteger(n) || n < 1) throw usageError("--limit must be a whole number, e.g. --limit 6");
218
+ args.limit = n;
219
+ }
220
+ return photosResult(await tool("show_place_photos", args));
193
221
  },
194
222
 
195
223
  async regions({ positionals, flags }) {
@@ -304,7 +332,7 @@ const commands = {
304
332
  instructions: init?.instructions || "",
305
333
  commands: CLI_FOR_TOOL,
306
334
  topics: Object.fromEntries(Object.keys(GUIDE_TOPICS).map((k) => [k, `npx -y heyyumi guide ${k}`])),
307
- note: "These rules come from the HeyYumi server and stay current. They name MCP tools; run the matching command from `commands` (reserve takes --time --party --phone --name --email --note --lang). Read `guide reserve` before sending a table request and `guide live` before asking a venue.",
335
+ note: "These rules come from the HeyYumi server and stay current. They name MCP tools; run the matching command from `commands` (reserve takes --time --party --phone --name --email --note --lang; photos takes --category --limit). Read `guide reserve` before sending a table request and `guide live` before asking a venue.",
308
336
  };
309
337
  },
310
338
 
@@ -321,15 +349,17 @@ Sign in (once per machine; opens Google sign-in, finishes on its own):
321
349
 
322
350
  Rules for agents (from the server, always current):
323
351
  heyyumi guide read once per task
324
- heyyumi guide search|place|reserve|live rules for one step
352
+ heyyumi guide search|place|photos|reserve|live rules for one step
325
353
 
326
354
  Search & details:
327
355
  heyyumi search [KEYWORD] --region 을지로 [--subtype korean_bbq] [--open_at "2026-10-25 19:00"] [--parking] ...
328
356
  Any search_places filter works as a flag (see: heyyumi tools search_places). 10 results unless --page-size.
329
357
  --region takes Korean or romanized names, stations and landmarks (Hongdae, 강남역, 제주공항).
358
+ Hair, nails, lashes, waxing, skin care: add --business_category salon|nail|lash|waxing|esthetic|beauty.
359
+ Each search returns one kind only; without it you get restaurants, cafes and bars.
330
360
  heyyumi nearby --lat 37.5665 --lng 126.978 [--radius 800] [--sort discovery]
331
361
  heyyumi place PLACE_ID [--fields all]
332
- heyyumi photos PLACE_ID
362
+ heyyumi photos PLACE_ID [--limit 6] [--category interior]
333
363
  heyyumi regions NAME | categories | stats
334
364
 
335
365
  Table requests (read "heyyumi guide reserve" first; ask the user before sending):
@@ -351,4 +381,4 @@ Exit codes: 0 ok · 1 server/tool error · 2 usage · 3 not signed in (run: npx
351
381
  HEYYUMI_API_KEY=hmp_... skips sign-in and uses a dashboard key instead.
352
382
  `;
353
383
 
354
- module.exports = { commands, HELP, pick, checkOwnFlags, withReserveNext };
384
+ module.exports = { commands, HELP, pick, checkOwnFlags, withReserveNext, photosResult };