heyyumi 0.1.3 → 0.1.4
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 +1 -1
- package/package.json +1 -1
- package/src/commands.js +37 -9
package/README.md
CHANGED
|
@@ -106,7 +106,7 @@ npx -y heyyumi place <placeId> --fields all # menu, hours, attributes,
|
|
|
106
106
|
| `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
107
|
| `nearby --lat --lng [--radius] [--sort distance\|discovery]` | Venues around a point. |
|
|
108
108
|
| `place ID [--fields all]` | Full details for one venue. |
|
|
109
|
-
| `photos ID` |
|
|
109
|
+
| `photos ID` | Photo URLs: the owner's, plus food photos and videos from credited creators (with their @handle and post link). |
|
|
110
110
|
| `regions NAME` · `categories` · `stats` | Region lookup, category list, coverage numbers. |
|
|
111
111
|
| `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
112
|
| `wait RESERVATION_ID [--timeout 110]` | Wait for the venue's answer. Re-run if `cli.settled` is false. |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "heyyumi",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
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.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"bin": {
|
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 = {
|
|
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
|
-
//
|
|
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
|
-
|
|
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,7 +349,7 @@ 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
|
|
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] ...
|
|
@@ -329,7 +357,7 @@ Search & details:
|
|
|
329
357
|
--region takes Korean or romanized names, stations and landmarks (Hongdae, 강남역, 제주공항).
|
|
330
358
|
heyyumi nearby --lat 37.5665 --lng 126.978 [--radius 800] [--sort discovery]
|
|
331
359
|
heyyumi place PLACE_ID [--fields all]
|
|
332
|
-
heyyumi photos PLACE_ID
|
|
360
|
+
heyyumi photos PLACE_ID [--limit 6] [--category interior]
|
|
333
361
|
heyyumi regions NAME | categories | stats
|
|
334
362
|
|
|
335
363
|
Table requests (read "heyyumi guide reserve" first; ask the user before sending):
|
|
@@ -351,4 +379,4 @@ Exit codes: 0 ok · 1 server/tool error · 2 usage · 3 not signed in (run: npx
|
|
|
351
379
|
HEYYUMI_API_KEY=hmp_... skips sign-in and uses a dashboard key instead.
|
|
352
380
|
`;
|
|
353
381
|
|
|
354
|
-
module.exports = { commands, HELP, pick, checkOwnFlags, withReserveNext };
|
|
382
|
+
module.exports = { commands, HELP, pick, checkOwnFlags, withReserveNext, photosResult };
|