@danceiny/gotry 0.0.1-rc.21 → 0.0.1-rc.24

package/dist/src/flight-pack-adapter.js

@@ -0,0 +1,54 @@
+import { FLIGHT_PACK_VERSION } from './flight-pack-contract.js';
+import { isKnownZoneLoose } from './tz-resolver.js';
+export class WorkWindowPrecedenceError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'WorkWindowPrecedenceError';
+        this.code = code;
+    }
+}
+/**
+ * Merge the user's schedule onto a parsed flight-pack window.
+ *
+ * v2 pack metadata owns the home zone. The profile contributes only schedule
+ * fields; its legacy numeric offset is intentionally ignored on that path.
+ * Legacy v1 keeps the adapter's historical numeric replacement behavior.
+ */
+export function mergeProfileWorkWindow(spec, profileWindow) {
+    // Vacation is an explicit profile fact, not an omitted schedule. It clears
+    // any pack window for both versions before the version-specific merge.
+    if (profileWindow?.vacation === true)
+        return { ...spec, workWindow: undefined };
+    if (spec[FLIGHT_PACK_VERSION] === 2) {
+        if (!profileWindow)
+            return spec;
+        const packWindow = spec.workWindow;
+        if (!packWindow?.homeZone || !isKnownZoneLoose(packWindow.homeZone)) {
+            throw new WorkWindowPrecedenceError('v2_profile_requires_pack_home_zone', 'v2 profile schedule requires a valid explicit pack work_window.home_zone');
+        }
+        const workWindow = {
+            ...packWindow,
+            startMin: profileWindow.startMin,
+            endMin: profileWindow.endMin,
+            workdays: profileWindow.workdays,
+        };
+        return { ...spec, workWindow };
+    }
+    // v1 adapter behavior: profile replaces the legacy pack window; no profile
+    // clears it as the existing adapters historically did.
+    if (!profileWindow)
+        return { ...spec, workWindow: undefined };
+    if (typeof profileWindow.homeTzOffsetMin !== 'number') {
+        throw new WorkWindowPrecedenceError('v1_profile_requires_numeric_home_offset', 'v1 profile work window requires homeTzOffsetMin');
+    }
+    return {
+        ...spec,
+        workWindow: {
+            homeTzOffsetMin: profileWindow.homeTzOffsetMin,
+            startMin: profileWindow.startMin,
+            endMin: profileWindow.endMin,
+            workdays: profileWindow.workdays,
+        },
+    };
+}

package/dist/src/flight-pack-contract.js

@@ -0,0 +1,2 @@
+/** Internal flight-pack provenance; symbol properties stay out of JSON/public tool schemas. */
+export const FLIGHT_PACK_VERSION = Symbol('gotry.flightPackVersion');

package/dist/src/gotry-backend.js

@@ -0,0 +1,70 @@
+/**
+ * gotry-backend 统一入口(founder 口径:「我只允许一个 gotry 包装出来的服务」)。
+ *
+ * 一个进程、一个 HTTP 服务面;能力 = 模块(booking-copilot、session-search,后续
+ * a2a 协议端口亦归此服务),模块自带鉴权/探活,内核只做路由分发。hotel-be 是
+ * 外层 BFF,只认本服务。
+ *
+ * 端口:GOTRY_BACKEND_PORT > GOTRY_BOOKING_COPILOT_PORT > 3082(向后兼容:
+ * 默认与既有 booking-copilot 部署同端口,路由合同不变,hotel-be BFF 零改动)。
+ *
+ * 环境变量:
+ *   booking-copilot 模块:GOTRY_BOOKING_COPILOT_API_KEY/STATE_ROOT/INGRESS_MODE/
+ *     ARTIFACT_ID + DEEPSEEK/LLM keys(dsh planner,同独立部署)
+ *   session-search 模块:GOTRY_BACKEND_SESSION_API_KEY(缺 = 该模块 fail-closed 503)、
+ *     GOTRY_SESSION_TRANSPORT=cdp、CHROME_USER_DATA_DIR、GOTRY_SESSION_AUDIT_PATH
+ *
+ * 运行:node bin/gotry-backend.js(编译产物)或 tsx ts/src/gotry-backend.ts(源码形态)。
+ */
+import { startBookingCopilotModule } from './backend/modules/booking-copilot.js';
+import { startBookingExecutorModule } from './backend/modules/booking-executor.js';
+import { startSessionSearchModule } from './backend/modules/session-search.js';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { closeBackend, createBackendServer } from './backend/kernel.js';
+export async function startGotryBackendFromEnvironment(env = process.env) {
+    const modules = [];
+    modules.push(await startBookingCopilotModule(env));
+    modules.push(startSessionSearchModule({
+        apiKey: () => env.GOTRY_BACKEND_SESSION_API_KEY ?? '',
+        auditPath: env.GOTRY_SESSION_AUDIT_PATH,
+    }));
+    modules.push(startBookingExecutorModule({
+        apiKey: () => env.GOTRY_BACKEND_BOOKING_API_KEY ?? '',
+        evidenceDir: () => env.GOTRY_BACKEND_EVIDENCE_DIR ?? '/var/lib/gotry-backend/booking-evidence',
+    }));
+    const port = Number(env.GOTRY_BACKEND_PORT ?? env.GOTRY_BOOKING_COPILOT_PORT ?? 3082);
+    const handle = await createBackendServer({
+        modules,
+        host: env.GOTRY_BACKEND_HOST ?? '127.0.0.1',
+        port: Number.isSafeInteger(port) && port > 0 ? port : 3082,
+    });
+    return {
+        port: handle.port,
+        moduleNames: handle.moduleNames,
+        close: () => closeBackend(handle, modules),
+    };
+}
+async function runCli() {
+    const handle = await startGotryBackendFromEnvironment();
+    process.stderr.write(`[gotry-backend] listening on http://127.0.0.1:${handle.port}; modules=${handle.moduleNames.join(',')}\n`);
+    let stopping = false;
+    const stop = () => {
+        if (stopping)
+            return;
+        stopping = true;
+        void handle.close().then(() => process.exit(0), (error) => {
+            process.stderr.write(`[gotry-backend] shutdown failed: ${error instanceof Error ? error.message : String(error)}\n`);
+            process.exit(1);
+        });
+    };
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+}
+const invokedPath = process.argv[1] ? resolve(process.argv[1]) : '';
+if (invokedPath === fileURLToPath(import.meta.url)) {
+    runCli().catch((error) => {
+        process.stderr.write(`[gotry-backend] startup failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    });
+}

package/dist/src/hotel-date-gate.js

@@ -0,0 +1,118 @@
+/**
+ * 酒店日期校验闸(issue #283):`gotry_hotel_search` 在派发供应商 CLI 前必须先确认
+ * 「完整、有效且退房晚于入住」。缺/空/单侧/类型错/不可解析/倒序/同日/不存在的日历
+ * 日期(如 2026-02-30、2026-13-01),任一命中即返回可行动的 input_required,
+ * 绝不发供应商命令。有效自然语言日期复用既有 `buildTimeAnchor` /
+ * `resolveSlotDate`(已含严格 ISO 校验),不动时间锚点/slot-spec/其它工具。
+ *
+ * 失败原因(顺序决策,一次问清):
+ *   missing(字段未传)> blank(空字符串)> type(非字符串)> unresolved(词表外/不存在的日历)> 倒序/同日
+ *   - 同侧 缺失 + 另一侧 空串 → 两端均报缺,两轮往返压成一次
+ *   - 五字段契约:reason(最小语义根因)/missing(需补齐的字段)/raw(用户原话)/message(可行动指引)/evidence(落账标签)
+ */
+import { buildTimeAnchor, isRealIsoDate } from './time-anchor.js';
+import { resolveSlotDate } from './slot-spec.js';
+/**
+ * 闸主入口。返回 success 表示闸通过,绝对日期可直接进入供应商查询;
+ * 返回 failure 表示闸失败,工具层应原样回传 input_required,不调 interpretEffect、
+ * 不写延迟日志。
+ */
+export function evaluateHotelStayDates(rawCheckIn, rawCheckOut, opts = {}) {
+    const anchor = buildTimeAnchor(opts.now ?? new Date());
+    const checkInStr = typeof rawCheckIn === 'string' ? rawCheckIn.trim() : '';
+    const checkOutStr = typeof rawCheckOut === 'string' ? rawCheckOut.trim() : '';
+    const raw = {
+        checkIn: typeof rawCheckIn === 'string' ? rawCheckIn : undefined,
+        checkOut: typeof rawCheckOut === 'string' ? rawCheckOut : undefined,
+    };
+    const checkInProvided = rawCheckIn !== undefined;
+    const checkOutProvided = rawCheckOut !== undefined;
+    const checkInIsString = typeof rawCheckIn === 'string';
+    const checkOutIsString = typeof rawCheckOut === 'string';
+    const checkInBlank = checkInIsString && checkInStr === '';
+    const checkOutBlank = checkOutIsString && checkOutStr === '';
+    const checkInTypeError = checkInProvided && !checkInIsString;
+    const checkOutTypeError = checkOutProvided && !checkOutIsString;
+    // 两端均缺失或一侧缺失+另一侧空串 → 一次报齐缺的两侧(避免两轮往返)
+    const bothNeedQuery = !checkInProvided && (!checkOutProvided || checkOutBlank)
+        || !checkOutProvided && (!checkInProvided || checkInBlank);
+    // 两端均空字符串(都已传但都是空串) → 同样报齐
+    if (bothNeedQuery || (checkInBlank && checkOutBlank)) {
+        const reason = !checkInProvided || checkInBlank ? 'check_in_blank' : 'check_out_blank';
+        return fail(reason, ['checkIn', 'checkOut'], '请告诉 gotry 入住日和退房日(具体日期,例如 2026-09-18);完整、有效且退房晚于入住才能查询酒店,缺一不查', `[hotel-date-gate@input_required:${reason}:both]`, raw);
+    }
+    // 单侧缺失(另一侧已正常传入) → 报缺的一侧
+    if (!checkInProvided) {
+        return fail('check_in_missing', ['checkIn'], '请告诉 gotry 入住日(具体日期,例如 2026-09-18);退房日已收到,但缺入住日无法判定窗口', '[hotel-date-gate@input_required:check_in_missing]', raw);
+    }
+    if (!checkOutProvided) {
+        return fail('check_out_missing', ['checkOut'], '请告诉 gotry 退房日(具体日期,例如 2026-09-20);入住日已收到,但缺退房日无法判定窗口', '[hotel-date-gate@input_required:check_out_missing]', raw);
+    }
+    // 类型错误(字段已传但不是字符串) → 按 blank 同形 + 标注类型,提示用户形态
+    if (checkInTypeError) {
+        return fail('check_in_blank', ['checkIn'], '入住日格式不对(应为日期字符串,例如 2026-09-18)——请向用户确认具体日期', '[hotel-date-gate@input_required:check_in_blank:type]', raw);
+    }
+    if (checkOutTypeError) {
+        return fail('check_out_blank', ['checkOut'], '退房日格式不对(应为日期字符串,例如 2026-09-20)——请向用户确认具体日期', '[hotel-date-gate@input_required:check_out_blank:type]', raw);
+    }
+    // 单侧空字符串(另一侧已正常传入)
+    if (checkInBlank) {
+        return fail('check_in_blank', ['checkIn'], '请告诉 gotry 入住日(具体日期,例如 2026-09-18);不要留空,不要猜日期', '[hotel-date-gate@input_required:check_in_blank]', raw);
+    }
+    if (checkOutBlank) {
+        return fail('check_out_blank', ['checkOut'], '请告诉 gotry 退房日(具体日期,例如 2026-09-20);不要留空,不要猜日期', '[hotel-date-gate@input_required:check_out_blank]', raw);
+    }
+    // 解析:复用 slot-spec 词表;词表外/不存在的日历日 → unresolved
+    const inRes = resolveSlotDate(checkInStr, anchor);
+    const outRes = resolveSlotDate(checkOutStr, anchor);
+    // 终消费层严格校验(issue #283 红线):resolveSlotDate 的 +N 算术(addDaysYmd) 可能
+    // 溢出产生 Invalid Date("NaN-NaN-NaN"),或 JS 自动进位跨千年("10000-01-01")。
+    // 词表外/不存在的日历日/算术溢出 一律归 unresolved,不发供应商命令。
+    if (inRes.kind === 'unresolved' || !isStrictIsoYmd(inRes.date)) {
+        return fail('check_in_unresolved', ['checkIn'], `入住日「${inRes.raw}」不是合法的具体日期——请给完整日期(例如 2026-09-18);不接受「近期」「明天之前」这类模糊表达,也不接受 2026-02-30 这类不存在的日历日`, '[hotel-date-gate@input_required:check_in_unresolved]', raw);
+    }
+    if (outRes.kind === 'unresolved' || !isStrictIsoYmd(outRes.date)) {
+        return fail('check_out_unresolved', ['checkOut'], `退房日「${outRes.raw}」不是合法的具体日期——请给完整日期(例如 2026-09-20);不接受「近期」「下周末」这类模糊表达,也不接受 2026-13-01 这类不存在的日历日`, '[hotel-date-gate@input_required:check_out_unresolved]', raw);
+    }
+    // 退房必须晚于入住;同日视为 0 晚
+    if (outRes.date <= inRes.date) {
+        const sameDay = outRes.date === inRes.date;
+        return fail('check_out_not_after_check_in', ['checkOut'], sameDay
+            ? `退房日(${outRes.date})与入住日(${inRes.date})相同,0 晚没有意义——请告诉 gotry 退房日应该晚于入住日`
+            : `退房日(${outRes.date})早于入住日(${inRes.date}),顺序反了——请告诉 gotry 正确的退房日(应该晚于入住)`, sameDay
+            ? '[hotel-date-gate@input_required:check_out_not_after_check_in:same_day]'
+            : '[hotel-date-gate@input_required:check_out_not_after_check_in:reversed]', raw);
+    }
+    // 通过:绝对日期已就位;slot 解析过程产生的原话 → 绝对日期 注记回显
+    const notes = [];
+    if (inRes.raw !== inRes.date)
+        notes.push(`slot-resolved: ${inRes.raw} → ${inRes.date}`);
+    if (outRes.raw !== outRes.date)
+        notes.push(`slot-resolved: ${outRes.raw} → ${outRes.date}`);
+    return { ok: true, checkIn: inRes.date, checkOut: outRes.date, notes };
+}
+function fail(reason, missing, message, evidence, raw) {
+    return { ok: false, verdict: 'input_required', reason, missing, raw, message, evidence };
+}
+/**
+ * 闸终消费层严格校验(issue #283 红线第二层,parseAbsoluteDate 词表口径之外):
+ *   1. 必须是字符串且匹配 `YYYY-MM-DD`(4-2-2 数字,前导零),拒 null/NaN/越界格式
+ *      (addDaysYmd 溢出产生 "NaN-NaN-NaN",JS 自动进位跨千年产生 "10000-01-01")。
+ *   2. 年份 1-9999;复用 `isRealIsoDate` 拒不存在的日历日(2026-02-30 / 2025-02-29 等)。
+ * 仅供 evaluateHotelStayDates 在 resolveSlotDate 返回后使用;其它层不要复用此 helper。
+ */
+function isStrictIsoYmd(s) {
+    if (typeof s !== 'string')
+        return false;
+    const m = s.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+    if (!m)
+        return false;
+    const y = Number(m[1]);
+    const mo = Number(m[2]);
+    const d = Number(m[3]);
+    if (!Number.isFinite(y) || !Number.isFinite(mo) || !Number.isFinite(d))
+        return false;
+    if (y < 1 || y > 9999)
+        return false;
+    return isRealIsoDate(y, mo, d);
+}

package/dist/src/i18n.js

@@ -1,3 +1,13 @@
+/**
+ * i18n 消息目录(README Known limitation「zh-CN 体验」的工程清偿件):
+ * GoTry 自有「确定性输出面」= 求解 answer_md(候选/航班链两渲染)+ 放宽建议文案
+ * + 排除理由。LLM 人格面(对话语言)由模型跟随用户语言,不在此层。
+ *
+ * 契约:
+ *   - 默认 `zh-CN`,模板与历次金标准逐字节一致(engine/unified 金标准套件即回归闸);
+ *   - `GOTRY_LOCALE=en`(或 setLocale)切英文;键缺失回退 zh 再回退键名——en 目录不齐不算错;
+ *   - 插值 `{var}`;数字/时刻在调用点格式化,catalog 只管词序与措辞。
+ */
 const ZH = {
     'md.header': '> 憧憬:{note}',
     'md.constraints': '> 已识别约束:窗口 {days} 天 | 预算 ¥{budget} | 动机(休整改写需求 {hours}h 有效休整)',
@@ -26,7 +36,8 @@ const ZH = {
     'sg.wish_reason_engine': '动机谱系 {weights} 下,{days} 天窗口装不下这个目的地',
     'sg.wish_reason_window': '{days} 天窗口装不下(目的需 {minDays} 天)',
     'un.workwindow_reason': '周{wd} {dep} 起飞落在工作窗口(当地 {start}-{end})内',
-    'un.redflag_redeye': '{leg} 落地精力仅 {pct}%(红眼后直奔事务,当日不宜安排重要会议)'
+    'un.workwindow_unresolvable_reason': 'home zone 投影失败:{reason}',
+    'un.redflag_redeye': '{leg} 落地精力仅 {pct}%(红眼后直奔事务,当日不宜安排重要会议)',
 };
 const EN = {
     'md.header': '> Aspiration: {note}',
@@ -56,7 +67,8 @@ const EN = {
     'sg.wish_reason_engine': 'under motivation weights {weights}, a {days}-day window cannot fit this destination',
     'sg.wish_reason_window': '{days}-day window cannot fit (the purpose needs {minDays} days)',
     'un.workwindow_reason': 'Departs {dep} on weekday {wd}, inside your work window (local {start}-{end})',
-    'un.redflag_redeye': '{leg} lands with only {pct}% energy (red-eye then straight to business — no big meetings that day)'
+    'un.workwindow_unresolvable_reason': 'home zone projection failed: {reason}',
+    'un.redflag_redeye': '{leg} lands with only {pct}% energy (red-eye then straight to business — no big meetings that day)',
 };
 let locale = process.env['GOTRY_LOCALE'] === 'en' ? 'en' : 'zh-CN';
 export function getLocale() {
@@ -65,13 +77,12 @@ export function getLocale() {
 export function setLocale(l) {
     locale = l;
 }
+/** 词条渲染:en 缺键回退 zh,再回退键名;插值 {var},缺变量原样保留 `{var}`。 */
 export function t(key, vars = {}) {
     const tpl = (locale === 'en' ? EN[key] : undefined) ?? ZH[key] ?? String(key);
-    return tpl.replace(/\{(\w+)\}/g, (_, k)=>k in vars ? String(vars[k]) : `{${k}}`);
+    return tpl.replace(/\{(\w+)\}/g, (_, k) => (k in vars ? String(vars[k]) : `{${k}}`));
 }
+/** en 目录完备性检查:缺键即列出(测试闸用,运行时回退而非抛错) */
 export function enCoverage() {
-    return Object.keys(ZH).filter((k)=>EN[k] === undefined);
+    return Object.keys(ZH).filter(k => EN[k] === undefined);
 }
-
-
-//# sourceURL=ts/src/i18n.ts