@danceiny/gotry 0.0.1-rc.14 → 0.0.1-rc.16

package/dist/src/index.js

@@ -5,7 +5,6 @@ import { ensureStateDir, recordLatency } from './bridge.js';
 import { segmentsFromCandidate, solveChoiceSegment } from './unified.js';
 import { checkConnectivity } from '../scripts/skeleton-check.js';
 import { parseCandidate, parseRequest } from './model.js';
-import { searchHotels as hbcliSearchHotels } from '../capabilities/hbcli.js';
 import { installProcessGuards, guardToolExecute } from '../capabilities/incident-log.js';
 import { interpretArgs } from './tool-packet.js';
 import { projectUtility } from './memory-utility.js';
@@ -14,15 +13,28 @@ import { resolveTimelineDate } from './travel-timeline.js';
 import { ensureLedger, readCompanionsWithFallback, readMotivationWithFallback, readTripsWithFallback, readWishPoolWithFallback } from './state-ledger.js';
 import { buildTimeAnchor } from './time-anchor.js';
 import { resolveSlotDate } from './slot-spec.js';
-import { geocodePlace, getForecast, getClimate, wmoLabel } from '../capabilities/weather.js';
-import { verifyFlight } from '../capabilities/opensky.js';
+import { wmoLabel } from '../capabilities/weather.js';
 import { anythingSearch } from '../capabilities/anything.js';
 import { readUrl, reach, reachStatus } from '../capabilities/agent-reach.js';
 import { videoSubtitle, githubSearch } from '../capabilities/agent-reach-deep.js';
-import { flyaiSearch } from '../capabilities/flyai.js';
-import { sessionFlightSearch } from '../capabilities/session-search.js';
 import { sessionLogin } from '../capabilities/session-login.js';
 import { createConsentGate, approvalFromContext } from '../capabilities/session-consent.js';
+import { listArtifacts, readArtifact } from '../capabilities/artifacts.js';
+import { interpretEffect, declinedObservation } from '../capabilities/effect.js';
+import { appendFacts, loadFactRegistry } from '../capabilities/fact-log.js';
+import { factsFromFlyai, factsFromSession } from './bookable-facts.js';
+import { gateArtifact } from './artifact-gate.js';
+let airlineAirportMapCache = null;
+async function loadAirlineAirportMap() {
+    if (airlineAirportMapCache) return airlineAirportMapCache;
+    try {
+        const { readFile } = await import('node:fs/promises');
+        airlineAirportMapCache = JSON.parse(await readFile(join(import.meta.dirname, '..', '..', 'data', 'airline-airports.json'), 'utf-8'));
+        return airlineAirportMapCache;
+    } catch  {
+        return null;
+    }
+}
 export const name = 'gotry-tools';
 export const inject = [
     'tools',
@@ -548,16 +560,20 @@ export function apply(ctx, config) {
                 if (r.raw !== r.date) dateNotes.push(`slot-resolved: ${r.raw} → ${r.date}`);
                 return r.date;
             };
-            const resp = await hbcliSearchHotels({
-                destination: q.destination,
-                checkIn: resolveDate(q.checkIn),
-                checkOut: resolveDate(q.checkOut),
-                adults: q.adults
-            }, {
-                hbcliBin: config.hbcliBin,
-                timeoutMs: config.timeoutMs,
-                fallbackPath
+            const itp = await interpretEffect({
+                effect: 'HBCLI_HOTEL_SEARCH',
+                params: {
+                    destination: q.destination,
+                    checkIn: resolveDate(q.checkIn),
+                    checkOut: resolveDate(q.checkOut),
+                    adults: q.adults,
+                    hbcliBin: config.hbcliBin,
+                    timeoutMs: config.timeoutMs,
+                    fallbackPath
+                }
             });
+            if (!itp.result) return declinedObservation('HBCLI_HOTEL_SEARCH', itp.trace);
+            const resp = itp.result;
             const dir = await ensureStateDir(config.stateRoot);
             const isLive = resp.via === 'hbcli-realtime';
             const evidence = isLive ? resp.evidence : '[静态包:估算]';
@@ -671,7 +687,14 @@ export function apply(ctx, config) {
             let placeLabel = q.place ?? `${q.lat},${q.lng}`;
             if (lat === undefined || lng === undefined) {
                 if (!q.place) throw new Error('gotry_weather_check requires place name or lat/lng');
-                const geo = await geocodePlace(q.place);
+                const geoItp = await interpretEffect({
+                    effect: 'WEATHER_GEOCODE',
+                    params: {
+                        name: q.place
+                    }
+                });
+                if (!geoItp.result) return declinedObservation('WEATHER_GEOCODE', geoItp.trace);
+                const geo = geoItp.result;
                 if (!geo.ok || geo.results.length === 0) {
                     return JSON.parse(JSON.stringify({
                         ok: false,
@@ -685,15 +708,23 @@ export function apply(ctx, config) {
                 placeLabel = `${hit.name}(${hit.admin1 ?? hit.country ?? ''})`;
             }
             const isClimate = q.mode === 'climate' || q.month !== undefined && q.mode !== 'forecast';
-            const r = isClimate ? await getClimate({
-                latitude: lat,
-                longitude: lng
-            }, q.month ?? new Date().getMonth() + 1) : await getForecast({
-                latitude: lat,
-                longitude: lng
-            }, {
-                days: q.days
+            const wxItp = isClimate ? await interpretEffect({
+                effect: 'WEATHER_CLIMATE',
+                params: {
+                    latitude: lat,
+                    longitude: lng,
+                    month: q.month ?? new Date().getMonth() + 1
+                }
+            }) : await interpretEffect({
+                effect: 'WEATHER_FORECAST',
+                params: {
+                    latitude: lat,
+                    longitude: lng,
+                    days: q.days
+                }
             });
+            if (!wxItp.result) return declinedObservation(isClimate ? 'WEATHER_CLIMATE' : 'WEATHER_FORECAST', wxItp.trace);
+            const r = wxItp.result;
             const dir = await ensureStateDir(config.stateRoot);
             await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, `weather:${r.via}`).catch(()=>{});
             const dailyLines = (r.daily ?? []).slice(0, 7).map((d)=>`${d.date} ${d.tempMinC.toFixed(0)}–${d.tempMaxC.toFixed(0)}°C ${wmoLabel(d.weatherCode)}${d.precipProbMaxPct !== null ? ` 降水概率${d.precipProbMaxPct}%` : ''}`);
@@ -761,11 +792,16 @@ export function apply(ctx, config) {
                     summary: 'callsign 必填'
                 }));
             }
-            const r = await verifyFlight({
-                callsign: q.callsign,
-                airport: q.airport,
-                timeoutMs: q.timeoutMs
+            const itp = await interpretEffect({
+                effect: 'OPENSKY_FLIGHT_VERIFY',
+                params: {
+                    callsign: q.callsign,
+                    airport: q.airport,
+                    timeoutMs: q.timeoutMs
+                }
             });
+            if (!itp.result) return declinedObservation('OPENSKY_FLIGHT_VERIFY', itp.trace);
+            const r = itp.result;
             const dir = await ensureStateDir(config.stateRoot);
             await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, `flight_verify:${r.via}`).catch(()=>{});
             const summary = r.verdict === 'observed' ? `${r.callsign} 当前 ADS-B 观测命中 (${r.hits?.length ?? 0} 架)${r.airport ? ` 在 ${r.airport}` : ''}\n${r.evidence}` : r.verdict === 'not_observed' ? `${r.callsign} 当前观测列表未见(ADS-B 覆盖有限,不否定该航班存在)\n${r.evidence}` : `${r.callsign} OpenSky 不可用:${r.error}\n${r.evidence}`;
@@ -841,13 +877,18 @@ export function apply(ctx, config) {
                         };
                     }
                 }
-                const r = await flyaiSearch({
-                    kind: 'hotel',
-                    destName: dest,
-                    checkInDate: q.checkIn,
-                    checkOutDate: q.checkOut,
-                    keyWords: q.keyWords
+                const itp = await interpretEffect({
+                    effect: 'FLYAI_SEARCH',
+                    params: {
+                        kind: 'hotel',
+                        destName: dest,
+                        checkInDate: q.checkIn,
+                        checkOutDate: q.checkOut,
+                        keyWords: q.keyWords
+                    }
                 });
+                if (!itp.result) return declinedObservation('FLYAI_SEARCH', itp.trace);
+                const r = itp.result;
                 const top = (r.hotels ?? []).slice(0, 8).map((o)=>`${o.name}${o.star ? `(${o.star})` : ''} ${o.priceRaw ?? '价待询'}${o.poi ? ` · ${o.poi}` : ''}`);
                 const summary = r.verdict === 'hit' ? `${dest} 酒店(飞猪官方只读)前 ${top.length} 家(价格多为打码,真实价以 jumpUrl 为准):\n${top.join('\n')}\n${r.evidence}` : `${dest} 酒店无结果或失败:${r.error ?? 'miss'} ${r.evidence}`;
                 return JSON.parse(JSON.stringify({
@@ -872,12 +913,24 @@ export function apply(ctx, config) {
                     summary: `未发起查询:日期 ${q.date} 已是过去(今天 ${todayYmd}),过去不存在在售机/火车票。` + `多为用户时间表达未带年份所致——向用户确认年份(或按未来最近的同月日修正)后再查。`
                 }));
             }
-            const r = await flyaiSearch({
+            const itp = await interpretEffect({
+                effect: 'FLYAI_SEARCH',
+                params: {
+                    kind,
+                    origin: q.from,
+                    destination: q.to,
+                    depDate: q.date
+                }
+            });
+            if (!itp.result) return declinedObservation('FLYAI_SEARCH', itp.trace);
+            const r = itp.result;
+            const avMap = await loadAirlineAirportMap();
+            await appendFacts(config.stateRoot ?? '.', factsFromFlyai({
                 kind,
                 origin: q.from,
                 destination: q.to,
-                depDate: q.date
-            });
+                date: q.date
+            }, r, new Date().toISOString(), avMap?.city_alias));
             const top = (r.options ?? []).slice(0, 8).map((o)=>`${o.no} ${o.name} ${o.depDateTime.slice(11, 16)}→${o.arrDateTime.slice(11, 16)} ¥${o.price}`);
             const label = kind === 'flight' ? '机票' : '火车票';
             const summary = r.verdict === 'hit' ? `${q.from}→${q.to} ${q.date} ${label}(飞猪官方只读)前 ${top.length} 条:\n${top.join('\n')}\n${r.evidence}` : r.verdict === 'miss' ? `${q.from}→${q.to} ${q.date} ${label}官方通道正常返回 0 条(常见原因:航线未开放/当日售罄)。${r.evidence}` : `${q.from}→${q.to} ${q.date} ${label}检索失败(可能限流/网络):${r.error ?? ''} ${r.evidence}`;
@@ -911,7 +964,7 @@ export function apply(ctx, config) {
     }));
     registerGuarded(defineTool({
         name: 'gotry_session_login',
-        description: 'Productized login bootstrap for the account session channel (call this when gotry_session_search returns needs-login — the user never needs a terminal). ' + 'AUTO-DETECTION FIRST: it reads ticket-cookie NAMES before anything else — if the user already logged in (on the external site) it confirms instantly WITHOUT opening any page. ' + 'OPENS the site login entry in the USER\'S OWN Chrome and waits for the user to finish logging in on the external site. ' + 'GoTry NEVER collects, stores, or transmits credentials: no passwords, no SMS codes, no cookie values — it only checks the boolean fact "already logged in" (reads cookie NAMES only, zero values). ' + 'verdict logged-in (tickets detected) | pending (login tab opened, user not done yet — offer to re-check later) | needs-attach (one-time Chrome remote-debugging switch instructions). ' + 'Evidence [会话:<site>-login@ts].',
+        description: 'Productized login bootstrap for the account session channel (call this when gotry_session_search returns needs-login — the user never needs a terminal). ' + 'AUTO-DETECTION FIRST: it reads ticket-cookie NAMES before anything else — if the user already logged in (on the external site) it confirms instantly WITHOUT opening any page. ' + 'OPENS the site login entry in the USER\'S OWN Chrome (foreground tab, left open for the user) and waits for the user to finish logging in on the external site. ' + 'GoTry NEVER collects, stores, or transmits credentials: no passwords, no SMS codes, no cookie values — it only checks the boolean fact "already logged in" (reads cookie NAMES only, zero values). ' + 'Transport: the GoTry Session Bridge browser extension (one-time install, ZERO Chrome system dialogs). ' + 'verdict logged-in (tickets detected) | pending (login tab opened, user not done yet — offer to re-check later) | needs-extension (one-time extension install: npx gotry setup, then chrome://extensions → load unpacked ~/.gotry/extension). ' + 'Evidence [会话:<site>-login@ts].',
         parameters: {
             query: {
                 type: 'json',
@@ -935,7 +988,7 @@ export function apply(ctx, config) {
             const r = await sessionLogin({
                 waitMs: typeof q?.waitSeconds === 'number' ? q.waitSeconds * 1000 : undefined
             });
-            const summary = r.verdict === 'logged-in' ? `${r.site} 登录完成确认(票据 cookie 名已检出,只读名字)。说明:登录是在携程官网、用你自己的浏览器完成的——gotry 全程未接触任何密码/验证码/cookie 值。现在可以继续会话检索了。${r.evidence}` : r.verdict === 'pending' ? `登录入口已在你的 Chrome 打开;请在弹出的标签页里正常登录携程(登录由你在官网完成,不属于 gotry)。完成后说一声"继续",我再确认。gotry 只检查"是否已登录",永不收集你的账号信息。${r.evidence}` : r.verdict === 'needs-attach' ? `需要一次性开启你 Chrome 的远程调试开关:在你的 Chrome 地址栏打开 chrome://inspect/#remote-debugging 并打开开关,然后说一声"重试"。${r.evidence}` : `登录引导未完成:${r.error ?? '未知原因'} ${r.evidence}`;
+            const summary = r.verdict === 'logged-in' ? `${r.site} 登录完成确认(票据 cookie 名已检出,只读名字)。说明:登录是在携程官网、用你自己的浏览器完成的——gotry 全程未接触任何密码/验证码/cookie 值。现在可以继续会话检索了。${r.evidence}` : r.verdict === 'pending' ? `登录入口已在你的 Chrome 打开;请在弹出的标签页里正常登录携程(登录由你在官网完成,不属于 gotry)。完成后说一声"继续",我再确认。gotry 只检查"是否已登录",永不收集你的账号信息。${r.evidence}` : r.verdict === 'needs-extension' ? `需要一次性安装 GoTry Session Bridge 浏览器扩展(约 30 秒,装完零弹窗):跑 npx gotry setup 拿安装指引,在 chrome://extensions 开发者模式「加载已解压的扩展程序」指向 ~/.gotry/extension,装好后说一声"重试"。${r.evidence}` : r.verdict === 'needs-attach' ? `cdp 车道需要一次性开启你 Chrome 的远程调试开关:在你的 Chrome 地址栏打开 chrome://inspect/#remote-debugging 并打开开关,然后说一声"重试"(默认走扩展车道,无需此步)。${r.evidence}` : `登录引导未完成:${r.error ?? '未知原因'} ${r.evidence}`;
             return JSON.parse(JSON.stringify({
                 ...r,
                 summary
@@ -964,7 +1017,7 @@ export function apply(ctx, config) {
     }));
     registerGuarded(defineTool({
         name: 'gotry_session_search',
-        description: 'Search on the USER\'S OWN logged-in browser session (Ctrip flights today; the account channel, not an anonymous instance). ' + 'Consent gate: the FIRST call in a session asks the user via the runtime approval card; once granted it holds for the session, a refusal revokes it for the session (no repeat prompting). ' + 'ReadGuard = physically read-only (write requests aborted at network layer; agent NEVER touches credentials/captcha; on captcha it stops and returns challenged). ' + 'Currently ctrip-flight: sniffs the site search API for structured options. Evidence [会话:ctrip-flight@ts]. ' + 'verdict needs-login = call gotry_session_login (product tool: opens the Ctrip login entry in the user\'s own Chrome and waits for them to log in on the external site — no terminal, no credentials through GoTry); needs-attach = one-time Chrome remote-debugging switch. ' + 'Rate-limited (≥30s between same-site calls; a challenged/timeout verdict means STOP — never retry, fall back to other tools).',
+        description: 'Search on the USER\'S OWN logged-in browser session (Ctrip flights today; the account channel, not an anonymous instance). ' + 'Consent gate: the FIRST call in a session asks the user via the runtime approval card; once granted it holds for the session, a refusal revokes it for the session (no repeat prompting). ' + 'Transport: GoTry Session Bridge browser extension (one-time install) — the agent side never talks to Chrome debugging, ZERO system dialogs; read-only by construction (the extension never issues requests; it only passively forwards the site\'s own search responses; agent NEVER touches credentials/captcha; on captcha it stops and returns challenged). ' + 'Currently ctrip-flight: sniffs the site search API for structured options. Evidence [会话:ctrip-flight@ts]. ' + 'verdict needs-login = call gotry_session_login (opens the Ctrip login entry in the user\'s own foreground tab — no terminal, no credentials through GoTry); ' + 'needs-extension = one-time browser-extension install (npx gotry setup for instructions) — the DEFAULT transport; cdp (chrome://inspect remote debugging) is a diagnostic fallback only via GOTRY_SESSION_TRANSPORT=cdp. ' + 'Rate-limited (≥30s between same-site calls; a challenged/timeout verdict means STOP — never retry, fall back to other tools).',
         parameters: {
             query: {
                 type: 'json',
@@ -991,12 +1044,23 @@ export function apply(ctx, config) {
                     summary: '需要 from/to(中文城市名,词表内)与 date(YYYY-MM-DD)'
                 };
             }
-            const r = await sessionFlightSearch({
-                from: q.from,
-                to: q.to,
-                date: q.date,
-                auditPath: join(config.stateRoot ?? '.', 'gotry-state', 'session-incidents.jsonl')
+            const itp = await interpretEffect({
+                effect: 'SESSION_FLIGHT_SEARCH',
+                params: {
+                    from: q.from,
+                    to: q.to,
+                    date: q.date,
+                    auditPath: join(config.stateRoot ?? '.', 'gotry-state', 'session-incidents.jsonl')
+                }
             });
+            if (!itp.result) return declinedObservation('SESSION_FLIGHT_SEARCH', itp.trace);
+            const r = itp.result;
+            const avMapS = await loadAirlineAirportMap();
+            await appendFacts(config.stateRoot ?? '.', factsFromSession({
+                origin: q.from,
+                destination: q.to,
+                date: q.date
+            }, r, new Date().toISOString(), avMapS?.city_alias));
             const top = (r.options ?? []).slice(0, 8).map((o)=>`${o.flightNo} ${o.airline} ${o.depDateTime.slice(11, 16)}→${o.arrDateTime.slice(11, 16)} ¥${o.price}`);
             const summary = r.verdict === 'hit' ? `${q.from}→${q.to} ${q.date} 会话检索(携程,用户本人登录态)前 ${top.length} 条:\n${top.join('\n')}\n${r.evidence}` : `会话检索未取回(${r.verdict}):${r.error ?? ''} ${r.evidence}`;
             return JSON.parse(JSON.stringify({
@@ -1012,7 +1076,7 @@ export function apply(ctx, config) {
             }),
         presentResult: (_args, value)=>{
             const r = value;
-            const label = r.verdict === 'hit' ? `会话 ${r.options.length} 条` : r.verdict === 'needs-login' ? '需登录' : r.verdict ?? '降级';
+            const label = r.verdict === 'hit' ? `会话 ${r.options.length} 条` : r.verdict === 'needs-login' ? '需登录' : r.verdict === 'needs-extension' ? '需装扩展(一次性)' : r.verdict ?? '降级';
             return {
                 card: 'generic',
                 title: `会话检索:${label}`,
@@ -1357,7 +1421,219 @@ export function apply(ctx, config) {
             };
         }
     }));
+    registerGuarded(defineTool({
+        name: 'gotry_artifacts_list',
+        description: 'List GoTry artifacts — deep-planning deliverables (async runs from the state ledger) plus agent-written markdown files ' + 'in the working directory (trip plans etc.). READ-ONLY discovery. ' + 'Use when the user asks to see/open/revisit a previously generated artifact ' + '(「看看刚才生成的行程」「上次的规划在哪」「打开那个 md」) — list first, then read with gotry_artifacts_read.',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ limit?: 20 }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? JSON.stringify(value).slice(0, 600))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = unwrapQuery(args, 'limit');
+            const r = await listArtifacts({
+                stateRoot: config.stateRoot ?? '.',
+                limit: q.limit
+            });
+            const lines = r.artifacts.map((a)=>`- [${a.source}] ${a.title}${a.status ? `(${a.status})` : ''} — ${a.path}${a.updated ? ` @ ${a.updated.slice(0, 16).replace('T', ' ')}` : ''}`);
+            const summary = r.artifacts.length ? `在册产物 ${r.artifacts.length}/${r.total} 项${r.truncated ? '(截断,可加 limit)' : ''}:\n${lines.join('\n')}` : '无在册产物(异步深度规划交付与工作目录 md 文件都会出现在这里)';
+            return JSON.parse(JSON.stringify({
+                ok: true,
+                artifacts: r.artifacts,
+                total: r.total,
+                truncated: r.truncated,
+                summary
+            }));
+        },
+        presentCall: ()=>({
+                card: 'generic',
+                title: '列出产物',
+                kind: 'search'
+            }),
+        presentResult: (_args, value)=>{
+            const r = value;
+            return {
+                card: 'generic',
+                title: `产物:${r.total ?? 0} 项在册`,
+                content: [
+                    {
+                        type: 'text',
+                        text: String(r.summary ?? '')
+                    }
+                ]
+            };
+        }
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_artifacts_read',
+        description: 'Read one GoTry artifact as a line-numbered file view rendered directly in the chat UI. ' + 'Input: the path from gotry_artifacts_list, or a bare async ticket id (e.g. dp-xxxx). ' + 'Optional offset (1-based) / limit window for paging large files. ' + 'READ-ONLY; text artifacts only (md/txt/json/jsonl/csv/log/yaml).',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ path: "<list 返回的路径或工单 id>", offset?: 1, limit?: 400 }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.content ?? JSON.stringify(value).slice(0, 600))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = unwrapQuery(args, 'path');
+            if (!q.path) return JSON.parse(JSON.stringify({
+                ok: false,
+                error: 'path 必填(来自 gotry_artifacts_list)'
+            }));
+            const r = await readArtifact({
+                stateRoot: config.stateRoot ?? '.',
+                path: q.path,
+                offset: q.offset,
+                limit: q.limit
+            });
+            if (!r.ok) return JSON.parse(JSON.stringify(r));
+            return JSON.parse(JSON.stringify({
+                ...r,
+                summary: `${r.path}(${r.totalLines} 行)第 ${r.offset}-${r.offset + r.lines.length - 1} 行${r.windowed ? `(共 ${r.totalLines} 行,可翻页)` : ''}`
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `读产物:${String(args.query?.path ?? '')}`,
+                kind: 'read',
+                rawInput: args.query
+            }),
+        presentResult: (_args, value)=>{
+            const r = value;
+            if (!r.ok) {
+                return {
+                    card: 'generic',
+                    title: '读产物失败',
+                    content: [
+                        {
+                            type: 'text',
+                            text: String(r.error ?? '')
+                        }
+                    ]
+                };
+            }
+            return {
+                card: 'read',
+                title: r.path?.split('/').pop() ?? r.path ?? '',
+                path: r.path ?? '',
+                offset: r.offset ?? 1,
+                lines: r.lines ?? [],
+                totalLines: r.totalLines ?? 0,
+                lang: r.lang,
+                content: [
+                    {
+                        type: 'text',
+                        text: r.content ?? ''
+                    }
+                ]
+            };
+        }
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_fact_gate',
+        description: 'Factuality gate for itinerary artifacts (issue #46): call BEFORE delivering any artifact that contains bookable facts ' + '(flight numbers, times, airports, prices, visa/entry policies). Every bookable claim in the markdown is checked against ' + 'the session fact registry (exact-date tool results recorded by gotry_flyai_search / gotry_session_search — hit AND miss). ' + 'Blocked when: a claimed flight is absent from the exact-date source (never backfill from route pages/history/adjacent dates); ' + 'route+date never queried; times contradict the snapshot; carrier→airport mapping conflicts (FD=DMK vs VZ=BKK are NOT interchangeable); ' + '「联程」without protected_connection=true; policy claims without 「截至 YYYY-MM-DD」; unconditional ✓ on unverified claims. ' + 'Optional itinerary object enables machine invariants (hotel_nights + onboard_nights = total nights, O&D segments vs flight legs, ' + 'budget floor ≥ sum of item minimums). verdict=blocked ⇒ fix or downgrade wording — never present as a verified plan.',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ markdown?: "<产物全文>", path?: "<产物路径(artifacts_list 返回的)>— 二选一", tripYear?: 2027, itinerary?: { trip_start, trip_end, stays: [{place,check_in,check_out}], onboard_nights, od_segments: [{from,to,date,mode,legs}], budget_items: [{label,min_cny,max_cny}], claimed_floor_cny? } }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? JSON.stringify(value).slice(0, 800))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = unwrapQuery(args, 'markdown');
+            const avMap = await loadAirlineAirportMap();
+            if (!avMap) {
+                return JSON.parse(JSON.stringify({
+                    ok: false,
+                    summary: '航司机场映射缺失(data/airline-airports.json)——事实闸不可用,fail closed:产物不得宣称已验证'
+                }));
+            }
+            let markdown = q.markdown;
+            if (!markdown && q.path) {
+                const r = await readArtifact({
+                    stateRoot: config.stateRoot ?? '.',
+                    path: q.path
+                });
+                if (!r.ok) return JSON.parse(JSON.stringify({
+                    ok: false,
+                    summary: `产物读取失败:${String(r.error ?? '')}`
+                }));
+                markdown = r.content;
+            }
+            if (!markdown) return JSON.parse(JSON.stringify({
+                ok: false,
+                summary: '需要 markdown(产物全文)或 path(产物路径)'
+            }));
+            const itinerary = q.itinerary;
+            const registry = await loadFactRegistry(config.stateRoot ?? '.');
+            const report = gateArtifact(markdown, registry, avMap, {
+                trip_year: q.tripYear,
+                itinerary
+            });
+            const lines = report.violations.slice(0, 20).map((v)=>`  L${v.line} [${v.kind}] ${v.detail}`);
+            const summary = report.verdict === 'pass' ? `事实闸 PASS:${report.traceable}/${report.claims_checked} 可下单 claim 全部回溯到 exact-date 工具结果(query_id 可重放)——可宣称「已验证方案」。` : `事实闸 BLOCKED(${report.violations.length} 违例,${report.traceable}/${report.claims_checked} claim 可回溯)——不得宣称「已验证方案」:\n${lines.join('\n')}\n修正路径:逐条改成 exact-date 源返回的事实,或降级为「未确认/当前不可售,到 D-xx 复核」;exact-date miss 的 route+date 不得用历史班期/相邻日期/航线页填充。`;
+            return JSON.parse(JSON.stringify({
+                ok: true,
+                ...report,
+                summary
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: '产物事实闸',
+                kind: 'execute',
+                rawInput: args.query
+            }),
+        presentResult: (_args, value)=>{
+            const r = value;
+            return {
+                card: 'generic',
+                title: `事实闸:${r.verdict === 'pass' ? '✅ pass' : `⛔ blocked(${r.violations?.length ?? '?'})`}`,
+                content: [
+                    {
+                        type: 'text',
+                        text: String(r.summary ?? '')
+                    }
+                ]
+            };
+        }
+    }));
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/index.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/index.ts

package/dist/src/journey.js

@@ -140,4 +140,4 @@ export function parseFlightPackLegs(pack) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/journey.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/journey.ts

package/dist/src/loop.js

@@ -408,4 +408,4 @@ export function probePoi(msg) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/loop.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/loop.ts

package/dist/src/memory-capture.js

@@ -37,4 +37,4 @@ export function mergeProfile(current, patch) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/memory-capture.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/memory-capture.ts

package/dist/src/memory-decay.js

@@ -28,4 +28,4 @@ function round4(x) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/memory-decay.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/memory-decay.ts

package/dist/src/memory-utility.js

@@ -52,4 +52,4 @@ export function projectUtility(events) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/memory-utility.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/memory-utility.ts

package/dist/src/mock-llm.js

@@ -100,4 +100,4 @@ export function createMockLlm(flightPackPath, slotScript = []) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/mock-llm.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/mock-llm.ts

package/dist/src/model.js

@@ -131,4 +131,4 @@ export function trueCostToDict(t) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/model.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/model.ts

package/dist/src/realtime-pricing.js

@@ -1,4 +1,4 @@
-import { flyaiSearch } from '../capabilities/flyai.js';
+import { interpretEffect } from '../capabilities/effect.js';
 const IATA_TO_CITY = {
     HKG: '香港',
     HKT: '普吉',
@@ -76,12 +76,19 @@ export async function overlayRealtimeFlightPrices(spec, opts = {}) {
     }
     return out;
 }
-const defaultQuery = (q)=>flyaiSearch({
-        kind: q.kind,
-        origin: q.origin,
-        destination: q.destination,
-        depDate: q.depDate
+const defaultQuery = async (q)=>{
+    const itp = await interpretEffect({
+        effect: 'FLYAI_SEARCH',
+        params: {
+            kind: q.kind,
+            origin: q.origin,
+            destination: q.destination,
+            depDate: q.depDate
+        }
     });
+    if (!itp.result) throw new Error(itp.trace.evidence.join(';'));
+    return itp.result;
+};
 export function realtimeSolvePort(base, opts = {}) {
     return async (spec)=>{
         const enabled = opts.enabled ?? process.env['GOTRY_REALTIME_PRICING'] === '1';
@@ -102,4 +109,4 @@ export function realtimeSolvePort(base, opts = {}) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/realtime-pricing.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/realtime-pricing.ts

package/dist/src/slot-spec.js

@@ -162,4 +162,4 @@ export function specDateMismatches(spec, resolved) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/slot-spec.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/slot-spec.ts

package/dist/src/state-ledger.js

@@ -924,4 +924,4 @@ export function readCompanionsWithFallback(stateRoot) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/state-ledger.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/state-ledger.ts

package/dist/src/time-anchor.js

@@ -97,4 +97,4 @@ export function parseAbsoluteDate(expr, anchorYear) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/time-anchor.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/time-anchor.ts

package/dist/src/tool-packet.js

@@ -9,4 +9,4 @@ export function interpretArgs(args, stringKey) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/tool-packet.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/tool-packet.ts

package/dist/src/travel-slots.js

@@ -141,4 +141,4 @@ export function scoreExtraction(expected, actual) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/travel-slots.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/travel-slots.ts

package/dist/src/travel-timeline.js

@@ -75,4 +75,4 @@ export function timelineGapsForVerified(timeline, verifiedWishes) {
 export { ymd };
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/travel-timeline.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/travel-timeline.ts

package/dist/src/unified.js

@@ -588,4 +588,4 @@ function renderCandidateMarkdown(req, verdicts, recommended) {
 export { minToHhmm };
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/unified.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/unified.ts

package/dist/src/wish-pool.js

@@ -24,4 +24,4 @@ export function pickNudgeWish(pool, ctx) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/wish-pool.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/wish-pool.ts

package/dist/src/z3-shared.js

@@ -15,4 +15,4 @@ export async function withZ3(label, session) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/z3-shared.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/z3-shared.ts