@danceiny/gotry 0.0.1-rc.8 → 0.0.1-rc.9

package/dist/src/index.js

@@ -1,18 +1,17 @@
 import { join } from 'node:path';
-import { readFile, writeFile } from 'node:fs/promises';
-import { readFileSync } from 'node:fs';
 import z from '@deepseek-ai/schemastery';
 import { defineTool } from '@deepseek-ai/dsh-tools';
-import { ensureStateDir, readJson, recordLatency, writeJson } from './bridge.js';
+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 { appendEvent, projectUtility } from './memory-utility.js';
+import { projectUtility } from './memory-utility.js';
 import { pickNudgeWish } from './wish-pool.js';
-import { mergeProfile } from './memory-capture.js';
+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';
@@ -20,6 +19,8 @@ import { verifyFlight } from '../capabilities/opensky.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';
 export const name = 'gotry-tools';
 export const inject = [
     'tools',
@@ -32,22 +33,45 @@ export const Config = z.object({
 });
 const unwrapQuery = interpretArgs;
 function renderMotivationBrief(stateRoot) {
-    try {
-        const raw = readFileSync(join(stateRoot, 'gotry-state', 'motivation-profile.json'), 'utf-8');
-        const p = JSON.parse(raw);
-        const lines = [
-            '## 用户记忆(跨会话画像;与用户当轮说法冲突时以用户为准,更新经 gotry_motivation_save)'
-        ];
-        const weights = Object.entries(p.weights ?? {});
-        if (weights.length) lines.push(`- 动机权重: ${weights.map(([k, v])=>`${k}=${v}`).join(', ')}(证据 ${p.evidence?.length ?? 0} 条)`);
-        const hard = Object.entries(p.hard ?? {});
-        if (hard.length) lines.push(`- 硬约束: ${hard.map(([k, v])=>`${k}=${String(v)}`).join(', ')}`);
-        lines.push(`- 愿望池: 用 gotry_wish_pool_list 按条件召回(0..1),勿直接堆砌`);
-        if (p.updated_at) lines.push(`- 更新于: ${p.updated_at}`);
-        return weights.length || hard.length ? lines.join('\n') : '';
-    } catch  {
-        return '';
+    const p = readMotivationWithFallback(stateRoot);
+    if (!p) return '';
+    const lines = [
+        '## 用户记忆(跨会话画像;与用户当轮说法冲突时以用户为准,更新经 gotry_motivation_save)'
+    ];
+    const weights = Object.entries(p.weights ?? {});
+    if (weights.length) lines.push(`- 动机权重: ${weights.map(([k, v])=>`${k}=${v}`).join(', ')}(证据 ${p.evidence?.length ?? 0} 条)`);
+    const hard = Object.entries(p.hard ?? {});
+    if (hard.length) lines.push(`- 硬约束: ${hard.map(([k, v])=>`${k}=${String(v)}`).join(', ')}`);
+    const trips = readTimelineTrips(stateRoot);
+    if (trips.length) {
+        lines.push(`- 去过: ${trips.map((t)=>`${t.destination}(${t.start.slice(0, 7)})`).join('、')}——去过的地方不再主动推荐,除非用户点名`);
+    }
+    const companions = readCompanions(stateRoot);
+    if (companions.length) {
+        lines.push(`- 同行人: ${companions.map((c)=>`${c.label}(${c.brief})`).join('、')}——约束进结构与排序建议,不硬过滤;引用时带当初的原话依据`);
     }
+    lines.push(`- 愿望池: 用 gotry_wish_pool_list 按条件召回(0..1),勿直接堆砌`);
+    if (p.updated_at) lines.push(`- 更新于: ${p.updated_at}`);
+    return weights.length || hard.length ? lines.join('\n') : '';
+}
+function readCompanions(stateRoot) {
+    return readCompanionsWithFallback(stateRoot).map((c)=>{
+        const bits = [
+            c.constraints.mobility,
+            ...c.constraints.health ?? [],
+            ...c.constraints.prefs ?? []
+        ].filter(Boolean);
+        return {
+            label: c.label,
+            brief: bits.join('/')
+        };
+    });
+}
+function readTimelineTrips(stateRoot) {
+    return readTripsWithFallback(stateRoot).map((t)=>({
+            destination: t.destination,
+            start: t.start
+        })).sort((a, b)=>a.start < b.start ? 1 : -1).slice(0, 3);
 }
 export function apply(ctx, config) {
     const sp = ctx['systemPrompt'];
@@ -169,41 +193,25 @@ export function apply(ctx, config) {
             if (!incoming.evidence?.length) {
                 throw new Error('refusing to save a motivation profile without evidence (P0 anti-fabrication rule)');
             }
-            const dir = await ensureStateDir(config.stateRoot);
-            const path = join(dir, 'motivation-profile.json');
-            let existing = null;
-            try {
-                existing = await readJson(path, null);
-            } catch  {}
-            const merged = mergeProfile(existing, {
+            const ledger = ensureLedger(config.stateRoot);
+            const res = ledger.appendMotivationPatch({
                 weights: incoming.weights,
                 evidence: incoming.evidence,
                 hard: incoming.hard
             });
-            if (!merged) {
-                const currentJson = JSON.parse(JSON.stringify({
-                    ...existing ?? {},
-                    updated_at: new Date().toISOString()
-                }));
-                return {
-                    ok: true,
-                    saved: false,
-                    path,
-                    profile: currentJson,
-                    summary: '无新内容(幂等跳过)'
-                };
-            }
-            const saved = JSON.parse(JSON.stringify({
-                ...merged,
-                updated_at: new Date().toISOString()
-            }));
-            await writeJson(path, saved);
-            return {
+            const profileJson = JSON.parse(JSON.stringify(res.profile));
+            return res.saved ? {
                 ok: true,
                 saved: true,
-                path,
-                profile: saved,
-                summary: '画像已合并落盘'
+                path: ledger.dbPath,
+                profile: profileJson,
+                summary: '画像已合并入账本(单事务)'
+            } : {
+                ok: true,
+                saved: false,
+                path: ledger.dbPath,
+                profile: profileJson,
+                summary: '无新内容(幂等跳过)'
             };
         },
         presentCall: (args)=>({
@@ -239,47 +247,19 @@ export function apply(ctx, config) {
         },
         async execute (args, _exec) {
             const entry = args.entry ?? {};
-            if (!entry.name || !entry.conditions) {
-                throw new Error('wish pool entry requires name and conditions (fulfilment conditions are the whole point)');
-            }
-            const dir = await ensureStateDir(config.stateRoot);
-            const path = join(dir, 'wish-pool.json');
-            const pool = await readJson(path, []);
-            const existing = pool.findIndex((e)=>e['name'] === entry.name);
-            if (existing >= 0) {
-                const prev = pool[existing] ?? {};
-                pool[existing] = {
-                    ...prev,
-                    wish_id: prev['wish_id'] ?? `w${Date.now().toString(36)}`,
-                    reason: entry.reason ?? prev['reason'],
-                    conditions: entry.conditions,
-                    ...entry.muted !== undefined ? {
-                        muted: entry.muted
-                    } : {}
-                };
-                await writeJson(path, pool);
-                return {
-                    ok: true,
-                    added: false,
-                    wish_id: String(pool[existing]?.['wish_id']),
-                    total: pool.length,
-                    path
-                };
-            }
-            const created = {
-                wish_id: `w${Date.now().toString(36)}`,
-                reason: '',
-                ...entry,
-                added_at: new Date().toISOString()
-            };
-            pool.push(created);
-            await writeJson(path, pool);
+            const ledger = ensureLedger(config.stateRoot);
+            const r = ledger.appendWish({
+                name: entry.name,
+                reason: entry.reason,
+                conditions: entry.conditions,
+                muted: entry.muted
+            });
             return {
                 ok: true,
-                added: true,
-                wish_id: created.wish_id,
-                total: pool.length,
-                path
+                added: r.added,
+                wish_id: r.wish_id,
+                total: r.total,
+                path: ledger.dbPath
             };
         },
         presentCall: (args)=>({
@@ -296,7 +276,7 @@ export function apply(ctx, config) {
             query: {
                 type: 'json',
                 required: true,
-                description: '{ action?: "recall"|"confirm-outcome", days?: number, budgetCny?: number, month?: number, wishId?: string, attribution?: "helpful"|"harmful"|"neutral", detail?: string }'
+                description: '{ action?: "recall"|"confirm-outcome", days?, budgetCny?, month?, wishId?, attribution?: "helpful"|"harmful"|"neutral", detail?, tripStart?: "行程起始(确认成行时挂时间线)" }'
             }
         },
         output: {
@@ -312,20 +292,7 @@ export function apply(ctx, config) {
         },
         async execute (args, _exec) {
             const q = unwrapQuery(args, 'action');
-            const dir = await ensureStateDir(config.stateRoot);
-            const pool = await readJson(join(dir, 'wish-pool.json'), []);
-            const sidecarPath = join(dir, 'memory-utility.jsonl');
-            const loadSidecar = async ()=>{
-                try {
-                    const raw = await readFile(sidecarPath, 'utf-8');
-                    return raw.split('\n').filter(Boolean).map((l)=>JSON.parse(l));
-                } catch  {
-                    return [];
-                }
-            };
-            const saveSidecar = async (events)=>{
-                await writeFile(sidecarPath, events.map((e)=>JSON.stringify(e)).join('\n') + '\n', 'utf-8');
-            };
+            const ledger = ensureLedger(config.stateRoot);
             const now = new Date().toISOString();
             if (q.action === 'confirm-outcome') {
                 if (!q.wishId || !q.attribution) {
@@ -334,24 +301,39 @@ export function apply(ctx, config) {
                         summary: 'confirm-outcome 需要 wishId + attribution(helpful|harmful|neutral)'
                     };
                 }
-                const events = await loadSidecar();
-                const { events: next, appended } = appendEvent(events, {
-                    wish_id: q.wishId,
-                    kind: 'verified_outcome',
-                    ts: now,
-                    ctx: 'gotry_wish_pool_list.confirm',
+                let tripInput;
+                const wish = ledger.readWishPool().find((e)=>String(e.wish_id) === q.wishId);
+                if (q.tripStart && wish?.name) {
+                    const anchor = buildTimeAnchor(new Date());
+                    const start = resolveTimelineDate(q.tripStart, anchor) ?? (/^\d{4}-\d{2}-\d{2}$/.test(q.tripStart) ? q.tripStart : undefined);
+                    if (start) {
+                        tripInput = {
+                            destination: String(wish.name),
+                            start,
+                            companions: undefined,
+                            source: 'wish-confirmed',
+                            evidence: `wish ${q.wishId} confirm-outcome(${q.attribution})`
+                        };
+                    }
+                }
+                const r = ledger.confirmOutcome({
+                    wishId: q.wishId,
+                    attribution: q.attribution,
                     detail: q.detail,
-                    attribution: q.attribution
+                    trip: tripInput
                 });
-                if (appended) await saveSidecar(next);
                 return {
                     ok: true,
-                    recorded: appended,
+                    recorded: r.recorded,
                     wish_id: q.wishId,
-                    status: q.attribution
+                    status: q.attribution,
+                    ...r.trip ? {
+                        trip: r.trip
+                    } : {}
                 };
             }
-            const candidates = pool.filter((e)=>!e['muted'] && typeof e['wish_id'] === 'string');
+            const pool = ledger.readWishPool();
+            const candidates = pool.filter((e)=>!e.muted && typeof e.wish_id === 'string');
             const month = q.month ?? new Date().getMonth() + 1;
             const match = pickNudgeWish(candidates, {
                 days: q.days,
@@ -365,14 +347,12 @@ export function apply(ctx, config) {
                     summary: `无可成行的憧憬匹配当前窗口(${candidates.length} 条在册,0..1 纪律:不硬推)`
                 };
             }
-            const events = await loadSidecar();
-            const { events: next, appended } = appendEvent(events, {
+            const { events: next } = ledger.appendUtilityEvent({
                 wish_id: match.wishId,
                 kind: 'recalled',
                 ts: now,
                 ctx: 'gotry_wish_pool_list.recall'
             });
-            if (appended) await saveSidecar(next);
             const utility = projectUtility(next)[match.wishId];
             return {
                 ok: true,
@@ -398,6 +378,128 @@ export function apply(ctx, config) {
                 rawInput: args.query
             })
     }));
+    registerGuarded(defineTool({
+        name: 'gotry_companion_save',
+        description: 'Save/update a travel companion profile (memory-design M5 layer): constraints that shape itinerary STRUCTURE and ranking — ' + 'never a hard filter (「爸爸65轻度高血压」→ 不排高海拔/控制步行量;「晕车」→ 优先火车/备提示). ' + 'evidence MUST be the user\'s verbatim words (append-only, traceable). ' + 'NEGATIVE LIST: passport/ID/phone numbers are rejected on sight — such fields never enter storage.',
+        parameters: {
+            companion: {
+                type: 'json',
+                required: true,
+                description: '{ label: "爸爸", constraints: { mobility?: "步行≤4h", health?: ["轻度高血压"], prefs?: ["怕吵"] }, evidence: "<用户原话>" }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? '')
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const c = args.companion ?? {};
+            if (!c.evidence) return {
+                ok: false,
+                summary: 'evidence 必填(用户原话,溯源 P0)'
+            };
+            const ledger = ensureLedger(config.stateRoot);
+            const res = ledger.appendCompanion({
+                label: String(c.label ?? ''),
+                constraints: {
+                    mobility: c.constraints?.mobility,
+                    health: c.constraints?.health,
+                    prefs: c.constraints?.prefs
+                },
+                evidence: c.evidence
+            });
+            if (!res.appended && res.reason) return {
+                ok: false,
+                summary: res.reason
+            };
+            return {
+                ok: true,
+                appended: res.appended,
+                companion_id: res.companionId,
+                total: res.total,
+                summary: res.appended ? `同行人已保存:${res.companionId}` : `无新内容(幂等跳过):${res.companionId}`
+            };
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: '保存同行人',
+                kind: 'edit',
+                rawInput: args.companion
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_trip_log',
+        description: 'Record a PAST trip into the travel timeline (memory-design M4 layer). Use when the user mentions a trip they already took ' + '(「去年国庆去了大理」) — dates resolve via the time anchor (词表外日期会拒绝,请用户给绝对日期), evidence MUST be the user\'s verbatim words. ' + 'Append-only and idempotent (same destination+start+source = same trip); overlapping same-destination trips are rejected for human adjudication. ' + 'Past trips power origin resolution and 「去过不再推」 ranking — never a hard filter.',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ destination: "大理", start: "2025-10-01 或绝对日期表达", end?: 同上, companions?: ["爸爸"], evidence: "<用户原话>" }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? '')
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = unwrapQuery(args, 'destination');
+            if (!q.destination) return {
+                ok: false,
+                summary: 'destination 必填'
+            };
+            if (!q.evidence) return {
+                ok: false,
+                summary: 'evidence 必填(用户原话,溯源 P0)'
+            };
+            const anchor = buildTimeAnchor(new Date());
+            const start = resolveTimelineDate(q.start ?? '', anchor) ?? (/^\d{4}-\d{2}-\d{2}$/.test(q.start ?? '') ? q.start : undefined);
+            if (!start) return {
+                ok: false,
+                summary: `start 无法解析为绝对日期(${q.start ?? '缺'})——请向用户要具体日期,不猜`
+            };
+            const end = q.end ? resolveTimelineDate(q.end, anchor) ?? (/^\d{4}-\d{2}-\d{2}$/.test(q.end) ? q.end : undefined) : undefined;
+            const ledger = ensureLedger(config.stateRoot);
+            const res = ledger.appendTripEvent({
+                destination: q.destination.trim(),
+                start,
+                end,
+                companions: q.companions,
+                source: 'user-verbatim',
+                evidence: q.evidence
+            });
+            if (!res.appended && res.reason) return {
+                ok: false,
+                summary: res.reason
+            };
+            return {
+                ok: true,
+                appended: res.appended,
+                trip_id: res.tripId,
+                total: res.total,
+                summary: res.appended ? `已入时间线:${q.destination} @ ${start}` : `已存在(幂等跳过):${res.tripId}`
+            };
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: '记录旅行',
+                kind: 'edit',
+                rawInput: args.query
+            })
+    }));
     registerGuarded(defineTool({
         name: 'gotry_hotel_search',
         description: 'Search hotels via hotelbyte-cli (real-time when hbcli credentials exist, falls back to the static pack with explicit evidence tagging). ' + 'Input: destination city name + optional dates/occupancy. Dates accept verbatim natural expressions (下周五 / 8.20 / 下周五+3) — ' + 'the code layer resolves them against the time anchor; unresolved expressions degrade to an undated search with an explicit ' + 'date_notes entry instead of guessing. Output: hotel list with evidence chain ([realtime-API:hbcli] + fetch timestamp, ' + 'or [static-pack:estimate]) per the L4 invariant.',
@@ -672,6 +774,133 @@ export function apply(ctx, config) {
                 rawInput: args.query
             })
     }));
+    registerGuarded(defineTool({
+        name: 'gotry_flyai_search',
+        description: 'Live flight/train search via Fliggy official FlyAI channel (read-only, no key, booking only via jumpUrl by the human). ' + 'PRIMARY source for real schedules & prices (RFC user-session-data-rfc). Input: kind=flight|train, from/to city names (Chinese), date YYYY-MM-DD. ' + 'Evidence [实时API:flyai@ts]. Cross-validate expensive claims against gotry_session_search when it matters.',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ kind: "flight"|"train", from: "上海", to: "丽江", date: "2026-10-01" }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_a, v)=>[
+                    {
+                        type: 'text',
+                        text: String(v.summary ?? JSON.stringify(v).slice(0, 600))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = unwrapQuery(args, 'from');
+            const kind = q.kind === 'train' ? 'train' : 'flight';
+            if (!q.from || !q.to || !q.date) {
+                return {
+                    ok: false,
+                    summary: '需要 from/to(中文城市名)与 date(YYYY-MM-DD)'
+                };
+            }
+            const r = await flyaiSearch({
+                kind,
+                origin: q.from,
+                destination: q.to,
+                depDate: q.date
+            });
+            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 summary = r.verdict === 'hit' ? `${q.from}→${q.to} ${q.date} ${kind === 'flight' ? '机票' : '火车票'}(飞猪官方只读)前 ${top.length} 条:\n${top.join('\n')}\n${r.evidence}` : `${q.from}→${q.to} ${q.date} 无结果或失败:${r.error ?? 'miss'} ${r.evidence}`;
+            return JSON.parse(JSON.stringify({
+                ...r,
+                kind,
+                summary
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `官方检索:${String(args.query?.kind ?? 'flight')}`,
+                kind: 'fetch',
+                rawInput: args.query
+            }),
+        presentResult: (args, value)=>{
+            const r = value;
+            return {
+                card: 'generic',
+                title: `飞猪检索:${r.ok && (r.options?.length ?? 0) > 0 ? `${r.options.length} 条` : '降级'}`,
+                content: [
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? '')
+                    }
+                ]
+            };
+        }
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_session_search',
+        description: 'Cross-validation search on the user\'s OWN logged-in browser session (dedicated persistent profile, ReadGuard = physically read-only: ' + 'write requests are 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 = run scripts/session-login.ts once with the human logging in. Rate-limited (≥30s between same-site calls). ' + 'Use to verify/double-check prices from gotry_flyai_search on the same itinerary (split by 直达/中转).',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ from: "上海", to: "丽江", date: "2026-10-01" }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_a, v)=>[
+                    {
+                        type: 'text',
+                        text: String(v.summary ?? JSON.stringify(v).slice(0, 600))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = unwrapQuery(args, 'from');
+            if (!q.from || !q.to || !q.date) {
+                return {
+                    ok: false,
+                    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 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({
+                ...r,
+                summary
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `会话检索:${String(args.query?.from ?? '')}`,
+                kind: 'fetch',
+                rawInput: args.query
+            }),
+        presentResult: (_args, value)=>{
+            const r = value;
+            const label = r.verdict === 'hit' ? `会话 ${r.options.length} 条` : r.verdict === 'needs-login' ? '需登录' : r.verdict ?? '降级';
+            return {
+                card: 'generic',
+                title: `会话检索:${label}`,
+                content: [
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? '')
+                    }
+                ]
+            };
+        }
+    }));
     registerGuarded(defineTool({
         name: 'gotry_anything_search',
         description: 'Travel-domain search via hotel-byte CLI → hotel-be Anything (cities/hotels/destinations) — NOT general web search; for general internet facts use gotry_agent_reach. ' + 'Mixed destinations (cities / metropolitan areas / high-level regions) + hotels in one call. ' + 'Returns candidates with type, name, optional coordinates and hotel-id. ' + 'Three-valued semantics: hit = ≥1 candidate; miss = 0 candidates (try synonyms or contentType=city/hotel); ' + 'unavailable = hbcli failed (degraded, never blocks). ' + 'Use as the first stop when the user mentions a place/city/hotel name and you need to ground it in real catalog data ' + '(OpenFlights skeleton tells you connectivity; Anything tells you what EXISTS at a city/region).',

package/dist/src/loop.js

@@ -264,36 +264,73 @@ export async function runTurn(state, userMsg, llm, history = [], solve = null) {
     };
 }
 import { join } from 'node:path';
-import { mkdir } from 'node:fs/promises';
-import { readFile, writeFile } from 'node:fs/promises';
-const ASYNC_DIR = 'gotry-state/async';
-async function asyncPath(name) {
-    await mkdir(ASYNC_DIR, {
+import { mkdir, rename, writeFile, readFile } from 'node:fs/promises';
+import { ensureLedger, openLedgerIfExists } from './state-ledger.js';
+async function asyncDir(stateRoot) {
+    const root = stateRoot === '.' ? process.cwd() : stateRoot;
+    const dir = join(root, 'gotry-state', 'async');
+    await mkdir(dir, {
         recursive: true
     });
-    return join(ASYNC_DIR, name);
+    return dir;
 }
-export async function persistAsyncTicket(ticket, state) {
-    const p = await asyncPath(`${ticket.id}.json`);
-    await writeFile(p, JSON.stringify({
+async function atomicWrite(path, text) {
+    const tmp = `${path}.tmp`;
+    await writeFile(tmp, text, 'utf-8');
+    await rename(tmp, path);
+}
+export async function persistAsyncTicket(ticket, state, stateRoot = '.') {
+    const ledger = ensureLedger(stateRoot);
+    ledger.createWorkflowRun({
+        id: ticket.id,
+        goal: ticket.objective,
+        ticket,
+        state
+    });
+    const dir = await asyncDir(stateRoot);
+    const p = join(dir, `${ticket.id}.json`);
+    await atomicWrite(p, JSON.stringify({
         ticket,
         state
-    }, null, 2), 'utf-8');
+    }, null, 2));
     return p;
 }
-export async function loadAsyncTicket(ticketId) {
+export async function loadAsyncTicket(ticketId, stateRoot = '.') {
+    const ledger = openLedgerIfExists(stateRoot);
+    const run = ledger?.getWorkflowRun(ticketId);
+    if (run) {
+        return {
+            ticket: JSON.parse(run.ticket_json),
+            state: JSON.parse(run.state_json)
+        };
+    }
     try {
-        const p = await asyncPath(`${ticketId}.json`);
+        const p = join(await asyncDir(stateRoot), `${ticketId}.json`);
         return JSON.parse(await readFile(p, 'utf-8'));
     } catch  {
         return null;
     }
 }
-export async function settleAsyncTicket(ticketId, reply) {
-    const p = await asyncPath(`${ticketId}.deliverable.md`);
-    await writeFile(p, reply, 'utf-8');
+export async function settleAsyncTicket(ticketId, reply, stateRoot = '.') {
+    openLedgerIfExists(stateRoot)?.settleWorkflowRun(ticketId, reply);
+    const dir = await asyncDir(stateRoot);
+    const p = join(dir, `${ticketId}.deliverable.md`);
+    await atomicWrite(p, reply);
     return p;
 }
+export function makeJournaledSolvePort(ledger, runId, solve, opts) {
+    return async (spec)=>{
+        const step = ledger.getWorkflowStep(runId, 'solve');
+        if (step?.status === 'done' && step.result) {
+            return JSON.parse(step.result);
+        }
+        ledger.markStepIntent(runId, 'solve');
+        opts?.onRealSolve?.();
+        const r = await solve(spec);
+        ledger.markStepDone(runId, 'solve', r);
+        return r;
+    };
+}
 export function probePoi(msg) {
     const trimmed = msg.trim();
     if (!trimmed) return null;