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 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 **543,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.
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.** 367,000+ restaurants, 138,000+ cafes and 36,000+ bars. More than 424,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".
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": "11:00-21:00 KST" }
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` take requests only in those hours (Korea time).
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 543.000 locales verificados, búsqueda por nombre de plato en tu idioma y solicitudes de reserva con respuesta en 5 minutos.
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.1",
4
- "description": "Your AI finds and books real Korean restaurants, no Korean needed. 543,000+ verified venues; search, details and table requests as JSON for any agent.",
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
- const data = await tool("request_reservation", args);
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 };