heyyumi 0.1.1 → 0.1.2
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 +5 -5
- package/package.json +2 -2
- package/src/commands.js +22 -7
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
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 **
|
|
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.
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
12
|
npx -y heyyumi login # once: Google sign-in in the browser, a key is made for you
|
|
@@ -18,7 +18,7 @@ Works with any agent that runs shell commands and reads JSON: Claude Code, Codex
|
|
|
18
18
|
|
|
19
19
|
## What your agent gets
|
|
20
20
|
|
|
21
|
-
**Real data, cross-checked.**
|
|
21
|
+
**Real data, cross-checked.** 371,000+ restaurants, 138,000+ cafes and 37,000+ bars. More than 432,000 of them are confirmed by more than one independent source, and every record carries a confidence score and a last-seen date. Menus, prices, opening hours, last orders and break times are included wherever they are known. Nothing is invented: there are no star ratings, and a missing field means "unknown", never "no".
|
|
22
22
|
|
|
23
23
|
**Ask in your own language.** Dish names in English, romanized Korean, Japanese or Chinese are mapped to the Korean dish through an official government list of 800 Korean dishes and their foreign names. `bibimbap`, `ビビンバ` and `拌饭` all become 비빔밥. Places can be typed the same way: `Hongdae`, `Gangnam Station`, `Jeju Airport`.
|
|
24
24
|
|
|
@@ -59,7 +59,7 @@ $ npx -y heyyumi search bibimbap --region Myeongdong --page-size 3 --fields core
|
|
|
59
59
|
"distanceM": 241,
|
|
60
60
|
"placeUrl": "https://heyyumi.ai/en/places/8392850",
|
|
61
61
|
"matchReason": "name",
|
|
62
|
-
"yumiBooking": { "canRequest": true, "requestHours": "
|
|
62
|
+
"yumiBooking": { "canRequest": true, "requestHours": "10:00-20:00 KST" }
|
|
63
63
|
},
|
|
64
64
|
{
|
|
65
65
|
"name": "방이옥 종로점",
|
|
@@ -126,7 +126,7 @@ Flags may use dashes or underscores (`--page-size` = `--page_size`). Bare flags
|
|
|
126
126
|
|
|
127
127
|
## Rules for agents
|
|
128
128
|
|
|
129
|
-
- Only send `reserve` for venues whose result shows `yumiBooking.canRequest: true`. Confirm time, party size, name and phone with the user before sending; it reaches a real venue. Venues with `requestHours`
|
|
129
|
+
- Only send `reserve` for venues whose result shows `yumiBooking.canRequest: true`. Confirm time, party size, name and phone with the user before sending; it reaches a real venue. Venues with `requestHours` review requests in those hours (Korea time). A request sent outside them comes back with `cli.deferred: true` and `cli.reviewStartsAt`: it is held, and the guest gets the answer by text or email, so don't wait for it now.
|
|
130
130
|
- A request starts as `pending`. Say it is booked only after `wait` returns `status: "confirmed"`. `cancelled` means the venue declined (relay `declineReason` if present); `expired` means no answer in time.
|
|
131
131
|
- `open_at` means the venue is open at that time, not that a table is free. Only a reservation answer says that.
|
|
132
132
|
- There are no star ratings (`rating` is always null). Do not invent one, and do not attribute review counts to any map platform.
|
|
@@ -164,6 +164,6 @@ Not in a terminal? The same tools are available as an MCP server for ChatGPT, Cl
|
|
|
164
164
|
|
|
165
165
|
**中文** · 不会韩语也没关系。这个 CLI 让 AI 助手在韩国 54 万多家经过核实的餐厅、咖啡馆和酒吧中搜索,并直接发送订位请求。可以用中文菜名搜索(例如“拌饭”),5 分钟内就能知道是否订位成功。
|
|
166
166
|
|
|
167
|
-
**Español** · Tu IA encuentra y reserva restaurantes reales en Corea sin que sepas coreano: más de
|
|
167
|
+
**Español** · Tu IA encuentra y reserva restaurantes reales en Corea sin que sepas coreano: más de 546.000 locales verificados, búsqueda por nombre de plato en tu idioma y solicitudes de reserva con respuesta en 5 minutos.
|
|
168
168
|
|
|
169
169
|
MIT License · © 2026 Hide Me Please, Inc.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "heyyumi",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "Your AI finds and books real Korean restaurants, no Korean needed.
|
|
3
|
+
"version": "0.1.2",
|
|
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": {
|
|
7
7
|
"heyyumi": "bin/heyyumi.js"
|
package/src/commands.js
CHANGED
|
@@ -22,6 +22,26 @@ function pick(obj, key) {
|
|
|
22
22
|
return undefined;
|
|
23
23
|
}
|
|
24
24
|
|
|
25
|
+
// A request sent outside the venue's request hours is held until reviewStartsAt, so waiting
|
|
26
|
+
// now would only time out; the guest gets the answer by text or email.
|
|
27
|
+
function withReserveNext(data) {
|
|
28
|
+
const id = pick(data, "reservationId") ?? pick(data, "id");
|
|
29
|
+
if (!id || !data || typeof data !== "object" || Array.isArray(data) || pick(data, "settled") === true) return data;
|
|
30
|
+
const reviewStartsAt = pick(data, "reviewStartsAt");
|
|
31
|
+
if (typeof reviewStartsAt === "string") {
|
|
32
|
+
return {
|
|
33
|
+
...data,
|
|
34
|
+
cli: {
|
|
35
|
+
deferred: true,
|
|
36
|
+
reviewStartsAt,
|
|
37
|
+
next: `npx -y heyyumi reservation ${id}`,
|
|
38
|
+
note: "Request received outside the venue's request hours. The venue reviews it from reviewStartsAt and the guest gets the result by text or email. Do not wait now; check later with the next command.",
|
|
39
|
+
},
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
return { ...data, cli: { next: `npx -y heyyumi wait ${id}` } };
|
|
43
|
+
}
|
|
44
|
+
|
|
25
45
|
function requirePositional(positionals, name, example) {
|
|
26
46
|
const v = positionals[0];
|
|
27
47
|
if (!v) throw usageError(`Missing ${name}. Example: ${example}`);
|
|
@@ -188,12 +208,7 @@ const commands = {
|
|
|
188
208
|
for (const [flag, key] of Object.entries(optional)) {
|
|
189
209
|
if (typeof flags[flag] === "string") args[key] = flags[flag];
|
|
190
210
|
}
|
|
191
|
-
|
|
192
|
-
const id = pick(data, "reservationId") ?? pick(data, "id");
|
|
193
|
-
if (id && data && typeof data === "object" && !Array.isArray(data) && pick(data, "settled") !== true) {
|
|
194
|
-
return { ...data, cli: { next: `npx -y heyyumi wait ${id}` } };
|
|
195
|
-
}
|
|
196
|
-
return data;
|
|
211
|
+
return withReserveNext(await tool("request_reservation", args));
|
|
197
212
|
},
|
|
198
213
|
|
|
199
214
|
async reservation({ positionals }) {
|
|
@@ -294,4 +309,4 @@ Exit codes: 0 ok · 1 server/tool error · 2 usage · 3 not signed in (run: npx
|
|
|
294
309
|
HEYYUMI_API_KEY=hmp_... skips sign-in and uses a dashboard key instead.
|
|
295
310
|
`;
|
|
296
311
|
|
|
297
|
-
module.exports = { commands, HELP, pick, checkOwnFlags };
|
|
312
|
+
module.exports = { commands, HELP, pick, checkOwnFlags, withReserveNext };
|