@danceiny/gotry 0.0.1-rc.9 → 0.2.0-rc.28

package/dist/capabilities/flyai.js

@@ -1,131 +1,968 @@
-import { spawn } from 'node:child_process';
-function sh(cmd, args, opts) {
-    const child = spawn(cmd, args, {
-        env: process.env,
-        cwd: process.cwd()
+/**
+ * FlyAI 官方通道能力层(飞猪开放平台,data-sources.md §8 / RFC P0;issue #521)。
+ *
+ * 完整对接官方 @fly-ai/flyai-cli 1.0.16 的 8 个公开只读命令:
+ *   flight/train: search-flight / search-train
+ *   hotel:        search-hotel(别名 search-hotels)
+ *   poi:          search-poi
+ *   keyword:      keyword-search(别名 fliggy-fast-search)
+ *   ai:           ai-search
+ *   marriott:     search-marriott-hotel / search-marriott-package
+ *
+ * 链路(CLI spawn,与 hbcli/weather 同构):
+ *   gotry capabilities/flyai.ts → npx -y @fly-ai/flyai-cli <command> [opts]
+ *     → 飞猪 MCP(实时直连官方商品库)
+ *
+ * 契约(L4 不变量):
+ *   - 只读:8 命令全只读,交易经 jumpUrl/detailUrl 由人完成(WriteGate 同构);
+ *   - 永不抛错:网络/超时/解析失败一律降级为结构化 verdict;
+ *   - 证据链:成功 [实时API:flyai@ts];失败 [实时API:flyai@error@ts];
+ *   - key 解析/endpoint 覆盖口径与官方 CLI 同源(flyai-config.ts);
+ *   - 子进程资源有界:进程组边界统一复用 spawn-bounded.ts(与 hbcli/anything
+ *     同策略),主进程退出后 stderr drain 最多等 drainMs(默认 3s),随后杀残留
+ *     后代并以 drain-timeout fail-closed 返回——不被持管道的后代挂死,也不把
+ *     不完整收集写成成功库存事实。
+ *
+ * 故障闭集(verdict):
+ *   hit / miss / auth-error(401)/ forbidden(403)/
+ *   needs-setup(匿名试用 429 Trial limit)/ rate-limited(普通 429)/
+ *   timeout / error(网络/Sentinel/malformed)。
+ */
+import { closeSync, openSync, readFileSync, unlinkSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { resolveFlyaiEndpoint, resolveFlyaiKey } from './flyai-config.js';
+import { spawnBounded } from './spawn-bounded.js';
+function nonEmptyText(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const text = value.trim();
+    return text || undefined;
+}
+function optionalText(value, allowNull = false) {
+    if (value === undefined)
+        return undefined;
+    if (allowNull && value === null)
+        return null;
+    return nonEmptyText(value);
+}
+function positiveFiniteNumber(value) {
+    const number = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && value.trim() ? Number(value.trim()) : Number.NaN;
+    return Number.isFinite(number) && number > 0 ? number : undefined;
+}
+function positiveFiniteDuration(value) {
+    if (typeof value === 'number')
+        return positiveFiniteNumber(value);
+    const text = nonEmptyText(value);
+    if (!text)
+        return undefined;
+    const minutes = /^(\d+(?:\.\d+)?)\s*分钟$/.exec(text)?.[1];
+    return positiveFiniteNumber(minutes ?? text);
+}
+function parseTransportPrice(value) {
+    const raw = nonEmptyText(value);
+    if (!raw)
+        return undefined;
+    const bare = raw.replace(/^¥\s*/, '');
+    if (/^\d+(?:\.\d+)?$/.test(bare)) {
+        const price = Number(bare);
+        return Number.isFinite(price) && price > 0 ? { price } : undefined;
+    }
+    // 未鉴权态打码 1xxx/¥7xx:保留原值,绝不猜成数字。
+    if (/^\d+x+$/.test(bare))
+        return { price: 0, priceRaw: raw };
+    return undefined;
+}
+/**
+ * 从 CLI stdout 提取首个含 data.itemList 的完整 JSON 对象。
+ * 扫描器识别字符串与转义;npx 前后缀日志不影响切分。
+ */
+export function parseFlyaiItemList(stdout) {
+    let start = -1;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    let sawIncompleteObject = false;
+    for (let index = 0; index < stdout.length; index += 1) {
+        const char = stdout[index];
+        if (start < 0) {
+            if (char === '{') {
+                start = index;
+                depth = 1;
+                inString = false;
+                escaped = false;
+                sawIncompleteObject = true;
+            }
+            continue;
+        }
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (char === '\\')
+                escaped = true;
+            else if (char === '"')
+                inString = false;
+            continue;
+        }
+        if (char === '"')
+            inString = true;
+        else if (char === '{')
+            depth += 1;
+        else if (char === '}') {
+            depth -= 1;
+            if (depth !== 0)
+                continue;
+            const candidate = stdout.slice(start, index + 1);
+            start = -1;
+            sawIncompleteObject = false;
+            try {
+                const parsed = JSON.parse(candidate);
+                if (Array.isArray(parsed.data?.itemList))
+                    return parsed.data.itemList;
+            }
+            catch {
+                // 前缀日志里的成对花括号;继续找下一完整对象。
+            }
+        }
+    }
+    throw new Error(sawIncompleteObject
+        ? 'incomplete FlyAI JSON object'
+        : 'no complete FlyAI itemList JSON object');
+}
+/** 解析 stdout 中首个完整 JSON 对象(不限 itemList;ai-search 用) */
+export function parseFlyaiJsonEnvelope(stdout) {
+    let start = -1;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let index = 0; index < stdout.length; index += 1) {
+        const char = stdout[index];
+        if (start < 0) {
+            if (char === '{') {
+                start = index;
+                depth = 1;
+                inString = false;
+                escaped = false;
+            }
+            continue;
+        }
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (char === '\\')
+                escaped = true;
+            else if (char === '"')
+                inString = false;
+            continue;
+        }
+        if (char === '"')
+            inString = true;
+        else if (char === '{')
+            depth += 1;
+        else if (char === '}') {
+            depth -= 1;
+            if (depth === 0) {
+                const candidate = stdout.slice(start, index + 1);
+                try {
+                    return JSON.parse(candidate);
+                }
+                catch {
+                    start = -1;
+                    depth = 0;
+                }
+            }
+        }
+    }
+    throw new Error('no complete FlyAI JSON envelope');
+}
+const REDACTED_FLYAI_KEY = '[已隐藏 FlyAI key]';
+const REDACTED_FLYAI_ENDPOINT = '?(已隐藏 endpoint 敏感参数)';
+function shellUrlToken(value) {
+    const match = /[),.;!?，。！？]+$/.exec(value);
+    const suffix = match?.[0] ?? '';
+    return { token: suffix ? value.slice(0, -suffix.length) : value, suffix };
+}
+/** 只针对实际 DEBUG endpoint 的 host 脱去 userinfo/query/fragment。 */
+function redactFlyaiText(value, sensitive) {
+    let output = value;
+    if (sensitive.key)
+        output = output.split(sensitive.key).join(REDACTED_FLYAI_KEY);
+    if (!sensitive.debugEndpoint)
+        return output;
+    let debugHost;
+    try {
+        debugHost = new URL(sensitive.debugEndpoint).host.toLowerCase();
+    }
+    catch {
+        return output;
+    }
+    return output.replace(/\bhttps?:\/\/[^\s"'<>]+/gi, (raw) => {
+        const { token, suffix } = shellUrlToken(raw);
+        try {
+            const url = new URL(token);
+            if (url.host.toLowerCase() !== debugHost)
+                return raw;
+            const path = url.pathname || '/';
+            const hasSensitivePart = Boolean(url.username || url.password || url.search || url.hash);
+            return `${url.protocol}//${url.host}${path}${hasSensitivePart ? REDACTED_FLYAI_ENDPOINT : ''}${suffix}`;
+        }
+        catch {
+            return raw;
+        }
     });
-    let stdout = '';
-    let stderr = '';
-    let error;
-    const timer = setTimeout(()=>{
+}
+function redactFlyaiValue(value, sensitive) {
+    if (typeof value === 'string')
+        return redactFlyaiText(value, sensitive);
+    if (Array.isArray(value))
+        return value.map(item => redactFlyaiValue(item, sensitive));
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, redactFlyaiValue(item, sensitive)]));
+    }
+    return value;
+}
+function safeFlyaiResult(result, sensitive) {
+    return redactFlyaiValue(result, sensitive);
+}
+/**
+ * 子进程 stdout 走临时文件而非管道(issue #84):管道在 CLI 异步写后
+ * 立即 exit 时丢尾部(实测截断 ~7.6KB,exit=0 静默);文件无此问题。
+ *
+ * 资源边界(#516):进程组/清理策略统一复用 capabilities/spawn-bounded.ts
+ * (与 hbcli/anything 同一进程树边界),本函数只叠加 flyai 特有的
+ * 文件 stdout 收集与本地终止分类——主进程 exit 后 stderr drain 最多等
+ * drainMs(默认 3s),超时杀组、drainTimedOut 结算,不写成成功事实。
+ */
+function sh(cmd, args, opts) {
+    // 预先取消:不 spawn 任何进程,不产生 stdout 临时文件。
+    if (opts.signal?.aborted) {
+        return Promise.resolve({ code: -1, stdout: '', stderr: '', cancelled: true, localTermination: 'signal' });
+    }
+    const outFile = join(tmpdir(), `gotry-flyai-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.out`);
+    const outFd = openSync(outFile, 'w');
+    const readOut = () => {
         try {
-            child.kill('SIGKILL');
-        } catch  {}
-    }, opts.timeoutMs);
-    return new Promise((resolve)=>{
-        child.stdout?.on('data', (d)=>{
-            stdout += d.toString();
-        });
-        child.stderr?.on('data', (d)=>{
-            stderr += d.toString();
+            return readFileSync(outFile, 'utf8');
+        }
+        catch {
+            return '';
+        }
+    };
+    const cleanupFile = () => {
+        try {
+            closeSync(outFd);
+        }
+        catch { /* ignore */ }
+        try {
+            unlinkSync(outFile);
+        }
+        catch { /* ignore */ }
+    };
+    return spawnBounded(cmd, args, {
+        env: opts.env ?? process.env,
+        cwd: process.cwd(),
+        timeoutMs: opts.timeoutMs,
+        signal: opts.signal,
+        stdoutFd: outFd,
+        drainMs: opts.drainMs ?? 3_000,
+    }).then((r) => {
+        // 必须先读出 stdout 再清理:closeSync 之后文件即删除,
+        // 先 cleanup 会把成功响应(含空 itemList miss)读成空串。
+        const stdout = readOut();
+        cleanupFile();
+        const localTermination = r.aborted
+            ? 'signal'
+            : r.timedOut
+                ? 'deadline'
+                : r.drainTimedOut
+                    ? 'drain-timeout'
+                    : r.error
+                        ? 'spawn'
+                        : r.signal
+                            ? 'empty-exit'
+                            : undefined;
+        return {
+            code: r.code ?? -1,
+            stdout,
+            stderr: r.stderr,
+            ...(r.signal !== null && r.signal !== undefined ? { signal: r.signal } : {}),
+            ...(r.error ? { error: r.error } : {}),
+            ...(r.timedOut ? { timedOut: true } : {}),
+            ...(r.drainTimedOut ? { drainTimedOut: true } : {}),
+            ...(r.aborted ? { cancelled: true } : {}),
+            ...(localTermination ? { localTermination } : {}),
+        };
+    });
+}
+function localTerminationResult(kind, termination, r, latencyMs, ts, envNote) {
+    const detail = termination === 'spawn'
+        ? `启动失败${r.error ? `:${r.error}` : ''}`
+        : termination === 'signal'
+            ? `进程收到本机取消信号${r.signal ? `(${r.signal})` : ''}`
+            : termination === 'deadline'
+                ? '达到本地 deadline'
+                : termination === 'drain-timeout'
+                    ? `主进程已退出(code ${r.code})但持有 stderr 的后代在 drain 时限内未释放,整组已终止——结果收集不完整`
+                    : '进程退出但未返回可判定结果';
+    return {
+        kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'error',
+        retryable: false, localTermination: termination,
+        evidence: `[实时API:flyai@error@${ts}] local termination: ${termination}`,
+        error: `FlyAI 本地终止(${detail})`,
+    };
+}
+const YMD = /^\d{4}-\d{2}-\d{2}$/;
+/** search-poi 闭集类别(官方 references,2026-09 核实) */
+export const FLYAI_POI_CATEGORIES = [
+    '自然风光', '山湖田园', '森林丛林', '峡谷瀑布', '沙滩海岛', '沙漠草原',
+    '人文古迹', '古镇古村', '历史古迹', '园林花园', '宗教场所', '公园乐园',
+    '主题乐园', '水上乐园', '影视基地', '动物园', '植物园', '海洋馆', '体育场馆',
+    '演出赛事', '剧院剧场', '博物馆', '纪念馆', '展览馆', '地标建筑', '市集',
+    '文创街区', '城市观光', '户外活动', '滑雪', '漂流', '冲浪', '潜水', '露营', '温泉',
+];
+const HOTEL_SORTS = ['distance_asc', 'rate_desc', 'price_asc', 'price_desc', 'no_rank'];
+const MARRIOTT_PACKAGE_SORTS = ['price_asc', 'price_desc'];
+function badArg(kind, error, ts) {
+    return {
+        kind, ok: false, via: 'flyai-error', verdict: 'error', latencyMs: 0,
+        evidence: `[实时API:flyai@error@${ts}] bad args`, error,
+    };
+}
+function hourOk(value) {
+    return Number.isInteger(value) && value >= 0 && value <= 23;
+}
+/** 各 kind 参数校验 → CLI args;不合法返回 error 串 */
+function buildCliArgs(q) {
+    const csv = (value) => value ? [value] : [];
+    switch (q.kind) {
+        case 'flight':
+        case 'train': {
+            if (!(q.origin ?? '').trim())
+                return { error: 'origin(出发城市/机场)required' };
+            for (const d of [q.depDate, q.depDateStart, q.depDateEnd, q.backDate]) {
+                if (d && !YMD.test(d))
+                    return { error: `日期需 YYYY-MM-DD,实际 ${d}` };
+            }
+            if (q.journeyType !== undefined && q.journeyType !== 1 && q.journeyType !== 2) {
+                return { error: 'journeyType 只接受 1(直达)/2(中转)' };
+            }
+            for (const h of [q.depHourStart, q.depHourEnd, q.arrHourStart, q.arrHourEnd]) {
+                if (h !== undefined && !hourOk(h))
+                    return { error: '小时范围需 0–23 整数' };
+            }
+            if (q.maxPrice !== undefined && !(q.maxPrice > 0))
+                return { error: 'maxPrice 需为正数' };
+            if (q.totalDurationHour !== undefined && !(q.totalDurationHour > 0))
+                return { error: 'totalDurationHour 需为正数' };
+            const sub = q.kind === 'flight' ? 'search-flight' : 'search-train';
+            return {
+                args: [
+                    sub, '--origin', q.origin.trim(),
+                    ...(q.destination?.trim() ? ['--destination', q.destination.trim()] : []),
+                    ...(q.depDate ? ['--dep-date', q.depDate] : []),
+                    ...(q.depDateStart ? ['--dep-date-start', q.depDateStart] : []),
+                    ...(q.depDateEnd ? ['--dep-date-end', q.depDateEnd] : []),
+                    ...(q.backDate ? ['--back-date', q.backDate] : []),
+                    ...(q.journeyType !== undefined ? ['--journey-type', String(q.journeyType)] : []),
+                    ...csv(q.seatClassName?.trim()).flatMap(v => ['--seat-class-name', v]),
+                    ...csv(q.transportNo?.trim()).flatMap(v => ['--transport-no', v]),
+                    ...csv(q.transferCity?.trim()).flatMap(v => ['--transfer-city', v]),
+                    ...(q.depHourStart !== undefined ? ['--dep-hour-start', String(q.depHourStart)] : []),
+                    ...(q.depHourEnd !== undefined ? ['--dep-hour-end', String(q.depHourEnd)] : []),
+                    ...(q.arrHourStart !== undefined ? ['--arr-hour-start', String(q.arrHourStart)] : []),
+                    ...(q.arrHourEnd !== undefined ? ['--arr-hour-end', String(q.arrHourEnd)] : []),
+                    ...(q.totalDurationHour !== undefined ? ['--total-duration-hour', String(q.totalDurationHour)] : []),
+                    ...(q.maxPrice !== undefined ? ['--max-price', String(q.maxPrice)] : []),
+                    ...(q.sortType?.trim() ? ['--sort-type', q.sortType.trim()] : []),
+                ],
+            };
+        }
+        case 'hotel':
+        case 'marriott-hotel': {
+            const dest = (q.destName ?? '').trim();
+            if (!dest)
+                return { error: 'destName(目的地 国家/省/市/区)required' };
+            const badPair = (q.checkInDate ? 1 : 0) !== (q.checkOutDate ? 1 : 0)
+                || (q.checkInDate && (!YMD.test(q.checkInDate) || !YMD.test(q.checkOutDate ?? '')));
+            if (badPair)
+                return { error: 'checkInDate/checkOutDate 须成对且为 YYYY-MM-DD' };
+            if (q.sort && !HOTEL_SORTS.includes(q.sort))
+                return { error: `sort 取值:${HOTEL_SORTS.join('/')}` };
+            if (q.maxPrice !== undefined && !(q.maxPrice > 0))
+                return { error: 'maxPrice 需为正数' };
+            if (q.hotelStars && !/^[1-5](,[1-5])*$/.test(q.hotelStars))
+                return { error: 'hotelStars 为 1–5 逗号分隔' };
+            const sub = q.kind === 'hotel' ? 'search-hotel' : 'search-marriott-hotel';
+            return {
+                args: [
+                    sub, '--dest-name', dest,
+                    ...(q.keyWords?.trim() ? ['--key-words', q.keyWords.trim()] : []),
+                    ...(q.poiName?.trim() ? ['--poi-name', q.poiName.trim()] : []),
+                    ...(q.hotelTypes?.trim() ? ['--hotel-types', q.hotelTypes.trim()] : []),
+                    ...(q.sort ? ['--sort', q.sort] : []),
+                    ...(q.checkInDate && q.checkOutDate ? ['--check-in-date', q.checkInDate, '--check-out-date', q.checkOutDate] : []),
+                    ...(q.hotelStars ? ['--hotel-stars', q.hotelStars] : []),
+                    ...(q.hotelBedTypes?.trim() ? ['--hotel-bed-types', q.hotelBedTypes.trim()] : []),
+                    ...(q.maxPrice !== undefined ? ['--max-price', String(q.maxPrice)] : []),
+                    ...(q.kind === 'marriott-hotel'
+                        ? [
+                            ...(q.hotelBrands?.trim() ? ['--hotel-brands', q.hotelBrands.trim()] : []),
+                            ...(q.hotelName?.trim() ? ['--hotel-name', q.hotelName.trim()] : []),
+                        ]
+                        : []),
+                ],
+            };
+        }
+        case 'poi': {
+            if (!(q.cityName ?? '').trim())
+                return { error: 'cityName(景点所在城市)required' };
+            if (q.poiLevel !== undefined && !(Number.isInteger(q.poiLevel) && q.poiLevel >= 1 && q.poiLevel <= 5)) {
+                return { error: 'poiLevel 为 1–5 整数' };
+            }
+            if (q.category && !FLYAI_POI_CATEGORIES.includes(q.category)) {
+                return { error: `category 不在官方闭集(共 ${FLYAI_POI_CATEGORIES.length} 类)` };
+            }
+            return {
+                args: [
+                    'search-poi', '--city-name', q.cityName.trim(),
+                    ...(q.poiLevel !== undefined ? ['--poi-level', String(q.poiLevel)] : []),
+                    ...(q.keyword?.trim() ? ['--keyword', q.keyword.trim()] : []),
+                    ...(q.category ? ['--category', q.category] : []),
+                ],
+            };
+        }
+        case 'keyword':
+            if (!(q.query ?? '').trim())
+                return { error: 'query(关键词)required' };
+            return { args: ['keyword-search', '--query', q.query.trim()] };
+        case 'ai':
+            if (!(q.query ?? '').trim())
+                return { error: 'query(完整自然语言)required' };
+            return { args: ['ai-search', '--query', q.query.trim()] };
+        case 'marriott-package': {
+            if (![q.keyword, q.hotelName, q.provinceOrCity].some(value => value?.trim()))
+                return { error: 'keyword/hotelName/provinceOrCity 至少填写一项' };
+            if (q.sortType && !MARRIOTT_PACKAGE_SORTS.includes(q.sortType)) {
+                return { error: `sortType 仅接受 ${MARRIOTT_PACKAGE_SORTS.join('/')}` };
+            }
+            return {
+                args: [
+                    'search-marriott-package',
+                    ...(q.keyword?.trim() ? ['--keyword', q.keyword.trim()] : []),
+                    ...(q.hotelName?.trim() ? ['--hotel-name', q.hotelName.trim()] : []),
+                    ...(q.provinceOrCity?.trim() ? ['--province-or-city', q.provinceOrCity.trim()] : []),
+                    ...(q.sortType ? ['--sort-type', q.sortType] : []),
+                ],
+            };
+        }
+    }
+}
+const KIND_LABEL = {
+    flight: 'flight', train: 'train', hotel: 'hotel', poi: 'poi',
+    keyword: 'keyword', ai: 'ai', 'marriott-hotel': 'marriott hotel', 'marriott-package': 'marriott package',
+};
+/**
+ * FlyAI 官方只读检索(8 命令)— 任何失败走降级;不抛错。
+ */
+export async function flyaiSearch(q) {
+    const started = Date.now();
+    const ts = new Date().toISOString();
+    const envContext = await runtimeEnvNote();
+    const envNote = envContext.note;
+    const sensitive = envContext.sensitive;
+    const safe = (result) => safeFlyaiResult(result, sensitive);
+    const built = buildCliArgs(q);
+    if (built.error)
+        return { ...badArg(q.kind, built.error, ts), ...envNote };
+    const prefix = q.cliPrefixArgs ?? ['-y', '@fly-ai/flyai-cli@1.0.16'];
+    const r = await sh(q.cliBin ?? 'npx', [...prefix, ...built.args], {
+        timeoutMs: q.timeoutMs ?? 30_000,
+        drainMs: q.drainMs,
+        signal: q.signal,
+    });
+    const latencyMs = Date.now() - started;
+    const combined = `${r.stderr}\n${r.stdout}`;
+    if (r.cancelled) {
+        return safe({
+            kind: q.kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'cancelled',
+            retryable: false, localTermination: 'signal',
+            evidence: `[实时API:flyai@error@${ts}] cancelled by caller`,
+            error: q.signal?.aborted ? '调用前已取消(未发起检索)' : '检索在途被取消(进程组已终止)',
         });
-        child.on('error', (e)=>{
-            error = e.message.slice(0, 200);
+    }
+    if (r.timedOut) {
+        return safe({
+            kind: q.kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'timeout',
+            retryable: false, localTermination: 'deadline',
+            evidence: `[实时API:flyai@error@${ts}] local deadline after ${q.timeoutMs ?? 30_000}ms`,
+            error: `FlyAI 本地终止(达到 deadline ${q.timeoutMs ?? 30_000}ms${r.drainTimedOut ? ';stderr 后代 drain 超时' : ''})`,
+            setup: '本机 deadline 已终止本次检索；请调整 timeoutMs 或稍后由上层重新发起。',
         });
-        child.on('close', (code)=>{
-            clearTimeout(timer);
-            resolve({
-                code: code ?? -1,
-                stdout,
-                stderr,
-                error
+    }
+    // A signal/empty exit/spawn failure carries no trustworthy upstream
+    // response. Handle it before HTTP text classification so stale partial
+    // stdout (for example a 429 printed before SIGTERM) cannot trigger retry.
+    if (r.localTermination) {
+        return safe(localTerminationResult(q.kind, r.localTermination, r, latencyMs, ts, envNote));
+    }
+    if (r.error || r.code !== 0 || /HTTP\s*(4\d\d|5\d\d)/.test(combined)) {
+        return safe(classifyUpstreamFailure(q.kind, r, latencyMs, ts, envNote));
+    }
+    // ai-search:data 是自由形状,不走 itemList。
+    if (q.kind === 'ai') {
+        let envelope;
+        try {
+            envelope = parseFlyaiJsonEnvelope(r.stdout);
+        }
+        catch (e) {
+            const raw = r.stdout.replace(/\s+/g, ' ').slice(0, 160);
+            return safe({
+                kind: q.kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'error',
+                evidence: `[实时API:flyai@error@${ts}] parse failed: ${raw}`,
+                error: `failed to parse flyai ai output (${e.message}): ${raw}`,
+            });
+        }
+        const systemMessage = nonEmptyText(envelope.systemMessage);
+        if (envelope.status !== undefined && envelope.status !== 0) {
+            return safe({
+                kind: q.kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'error',
+                evidence: `[实时API:flyai@error@${ts}] ai status=${String(envelope.status)}`,
+                error: nonEmptyText(envelope.message) ?? 'ai-search upstream failure',
+                ...(systemMessage ? { systemMessage } : {}),
             });
+        }
+        const aiData = envelope.data;
+        const empty = aiData === undefined || aiData === null || aiData === ''
+            || (Array.isArray(aiData) && aiData.length === 0);
+        return safe(JSON.parse(JSON.stringify({
+            kind: q.kind, ...envNote, latencyMs, ok: true, via: 'flyai',
+            verdict: empty ? 'miss' : 'hit',
+            ...(empty ? {} : { aiData }),
+            ...(systemMessage ? { systemMessage } : {}),
+            evidence: `[实时API:flyai@${ts}] ai-search ${empty ? 'empty' : 'data returned'}`,
+        })));
+    }
+    let items;
+    try {
+        items = parseFlyaiItemList(r.stdout);
+    }
+    catch (e) {
+        const raw = r.stdout.replace(/\s+/g, ' ').slice(0, 160);
+        // Sentinel 限流:exit 0,stdout 为 {"message":"SentinelBlockException…"}
+        if (/Sentinel/i.test(raw)) {
+            return safe({
+                kind: q.kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'error',
+                retryable: false,
+                evidence: `[实时API:flyai@error@${ts}] sentinel: ${raw}`,
+                error: `FlyAI Sentinel 限流:${raw}`,
+                setup: '平台 Sentinel 限流(恢复窗口未公开)——稍后重试,或改走 gotry_session_search(账号会话)。',
+            });
+        }
+        const reason = e.message;
+        return safe({
+            kind: q.kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'error',
+            retryable: false,
+            evidence: `[实时API:flyai@error@${ts}] parse failed(${reason}): ${raw}`,
+            error: `failed to parse flyai output (${reason}): ${raw}`,
         });
-    }).finally(()=>clearTimeout(timer));
+    }
+    return safe(parseItemListResult(q.kind, items, latencyMs, ts, envNote, r.stdout));
 }
-export async function flyaiSearch(q) {
-    const started = Date.now();
-    const ts = new Date().toISOString();
-    const base = {
-        kind: q.kind,
-        latencyMs: 0
-    };
-    const origin = (q.origin ?? '').trim();
-    const destination = (q.destination ?? '').trim();
-    if (!origin || !destination || !/^\d{4}-\d{2}-\d{2}$/.test(q.depDate ?? '')) {
+/** 当前进程 key 来源/endpoint 覆盖(仅展示,与 spawn 实际生效同源) */
+async function runtimeEnvNote() {
+    try {
+        const key = resolveFlyaiKey();
+        const endpoint = resolveFlyaiEndpoint();
         return {
-            ...base,
-            ok: false,
-            via: 'flyai-error',
-            verdict: 'error',
-            evidence: `[实时API:flyai@error@${ts}] bad args`,
-            error: 'origin/destination/depDate(YYYY-MM-DD) required'
+            note: { keySource: key.source, ...(endpoint.debug ? { endpointDebug: true } : {}) },
+            sensitive: { ...(key.key ? { key: key.key } : {}), ...(endpoint.debug ? { debugEndpoint: endpoint.url } : {}) },
         };
     }
-    const sub = q.kind === 'flight' ? 'search-flight' : 'search-train';
-    const r = await sh(q.cliBin ?? 'npx', [
-        '-y',
-        '@fly-ai/flyai-cli',
-        sub,
-        '--origin',
-        origin,
-        '--destination',
-        destination,
-        '--dep-date',
-        q.depDate
-    ], {
-        timeoutMs: q.timeoutMs ?? 30_000
+    catch {
+        return { note: { keySource: 'none' }, sensitive: {} };
+    }
+}
+/** 非 0 退出 / HTTP 4xx-5xx 文本 → 故障闭集分类 */
+function classifyUpstreamFailure(kind, r, latencyMs, ts, envNote) {
+    const upstream = `${r.stderr}\n${r.stdout}`.replace(/\s+/g, ' ').trim();
+    const tag = (verdict, evidence, extra) => ({ kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict, evidence, ...extra });
+    if (/Invalid API key|HTTP\s*401|\b401\b/.test(upstream)) {
+        return tag('auth-error', `[实时API:flyai@error@${ts}] 401 invalid api key`, {
+            retryable: false,
+            error: `FlyAI 鉴权失败(401):${upstream.slice(0, 160)}`,
+            setup: '当前 key 无效或已吊销——在本机终端运行 `gotry setup flyai` 重新设置并验证(模型无法替你输入 key);`gotry setup flyai --clear` 可清除错误 key,清除后仍可匿名试用。',
+        });
+    }
+    if (/HTTP\s*403|\b403\b/.test(upstream)) {
+        return tag('forbidden', `[实时API:flyai@error@${ts}] 403 forbidden`, {
+            retryable: false,
+            error: `FlyAI 拒绝访问(403):${upstream.slice(0, 160)}`,
+            setup: '上游 403:核对该 key 的权限范围与控制台状态;如 endpoint 被 DEBUG_FLYAI_MCP_URL 覆盖,请确认指向。',
+        });
+    }
+    if (/Trial limit reached/.test(upstream)) {
+        return tag('needs-setup', `[实时API:flyai@error@${ts}] trial quota exhausted`, {
+            retryable: false,
+            error: `FlyAI 匿名试用额度已用尽:${upstream.slice(0, 160)}`,
+            setup: '打开 https://flyai.open.fliggy.com/console，登录后复制 API Key,本机运行 `gotry setup flyai` 配置并验证;本会话请勿盲重试 gotry_flyai_search,机/火/酒改走 gotry_session_search。',
+        });
+    }
+    if (/HTTP\s*429|\b429\b/.test(upstream)) {
+        return tag('rate-limited', `[实时API:flyai@error@${ts}] 429 rate limited`, {
+            retryable: true,
+            error: `FlyAI 普通限流(非试用达限):${upstream.slice(0, 160)}`,
+            setup: '上游普通限流:稍候再查,勿高频连发;仍 429 请稍后或换 gotry_session_search。',
+        });
+    }
+    if (/timeout|timed out|ETIMEDOUT|ECONNRESET|ECONNREFUSED|ECONNABORTED|EHOSTUNREACH|ENETUNREACH|EAI_AGAIN|socket|network|fetch failed|HTTP\s*5\d\d|\b5\d\d\b/i.test(upstream)) {
+        return tag('error', `[实时API:flyai@error@${ts}] transient upstream`, {
+            retryable: true,
+            error: `FlyAI 瞬时网络/上游错误:${upstream.slice(0, 160)}`,
+            setup: '网络抖动或上游 5xx:稍后重试;持续失败请检查本机网络或改走 gotry_session_search。',
+        });
+    }
+    return tag('error', `[实时API:flyai@error@${ts}] ${r.error ?? `exit ${r.code}`}`, {
+        retryable: false,
+        error: r.error ?? upstream.slice(0, 200),
     });
-    const latencyMs = Date.now() - started;
-    if (r.error || r.code !== 0) {
+}
+/** itemList(非 ai 类)→ 对应 typed 结果;空=miss;含 malformed=整体 error */
+function parseItemListResult(kind, items, latencyMs, ts, envNote, rawStdout) {
+    let parsed;
+    switch (kind) {
+        case 'flight':
+        case 'train':
+            parsed = parseTransportItems(items);
+            break;
+        case 'hotel':
+            parsed = parseHotelItems(items);
+            break;
+        case 'marriott-hotel':
+            parsed = parseHotelItems(items);
+            break;
+        case 'poi':
+            parsed = parsePoiItems(items);
+            break;
+        case 'keyword':
+            parsed = parseKeywordItems(items);
+            break;
+        case 'marriott-package':
+            parsed = parsePackageItems(items);
+            break;
+        case 'ai':
+            parsed = { options: [], malformedCount: 0 };
+            break;
+    }
+    const systemMessage = (() => {
+        try {
+            return nonEmptyText(JSON.parse(rawStdout).systemMessage);
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    if (parsed.malformedCount > 0) {
+        const label = KIND_LABEL[kind];
         return {
-            ...base,
-            latencyMs,
-            ok: false,
-            via: 'flyai-error',
-            verdict: 'error',
-            evidence: `[实时API:flyai@error@${ts}] ${r.error ?? `exit ${r.code}`}`,
-            error: r.error ?? r.stderr.replace(/\s+/g, ' ').slice(0, 200)
+            kind, ...envNote, latencyMs, ok: false, via: 'flyai-error', verdict: 'error',
+            retryable: false,
+            evidence: `[实时API:flyai@error@${ts}] ${label} itemList malformed (${parsed.malformedCount}/${items.length} items failed typed validation)`,
+            error: `FlyAI ${label} itemList malformed: ${parsed.malformedCount}/${items.length} item(s) failed typed validation`,
+            ...(systemMessage ? { systemMessage } : {}),
         };
     }
-    let items;
-    try {
-        const jStart = r.stdout.indexOf('{');
-        const parsed = JSON.parse(jStart >= 0 ? r.stdout.slice(jStart) : r.stdout);
-        items = parsed.data?.itemList ?? [];
-    } catch  {
-        const raw = r.stdout.replace(/\s+/g, ' ').slice(0, 160);
-        return {
-            ...base,
-            latencyMs,
-            ok: false,
-            via: 'flyai-error',
-            verdict: 'error',
-            evidence: `[实时API:flyai@error@${ts}] parse failed: ${raw}`,
-            error: `failed to parse flyai output as JSON: ${raw}`
+    const count = parsed.options.length;
+    const verdict = count > 0 ? 'hit' : 'miss';
+    const evidence = `[实时API:flyai@${ts}] ${count}/${items.length} ${KIND_LABEL[kind]} options`;
+    const common = { kind, ...envNote, latencyMs, ok: true, via: 'flyai', verdict, evidence, ...(systemMessage ? { systemMessage } : {}) };
+    switch (kind) {
+        case 'flight':
+        case 'train':
+            return { ...common, options: parsed.options };
+        case 'hotel':
+        case 'marriott-hotel':
+            return { ...common, hotels: parsed.options };
+        case 'poi':
+            return { ...common, pois: parsed.options };
+        case 'keyword':
+            return { ...common, keywords: parsed.options };
+        case 'marriott-package':
+            return { ...common, packages: parsed.options };
+        case 'ai':
+            return { ...common };
+    }
+}
+// ── typed parsers ───────────────────────────────────────────────────────────────
+/** 机/火条目 → FlyaiOption;非空列表含任一不完整条目即整体 malformed */
+function parseTransportItems(items) {
+    const options = [];
+    let malformedCount = 0;
+    for (const raw of items) {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            malformedCount += 1;
+            continue;
+        }
+        const it = raw;
+        const journey = Array.isArray(it.journeys) ? it.journeys[0] : undefined;
+        const segments = journey && typeof journey === 'object' && !Array.isArray(journey) && Array.isArray(journey.segments)
+            ? journey.segments
+            : undefined;
+        if (!segments || segments.length === 0) {
+            malformedCount += 1;
+            continue;
+        }
+        const parsedSegments = [];
+        for (const rawSegment of segments) {
+            if (!rawSegment || typeof rawSegment !== 'object' || Array.isArray(rawSegment))
+                continue;
+            const segment = rawSegment;
+            const no = nonEmptyText(segment.marketingTransportNo);
+            const name = optionalText(segment.marketingTransportName);
+            const depDateTime = nonEmptyText(segment.depDateTime);
+            const arrDateTime = nonEmptyText(segment.arrDateTime);
+            const depStation = nonEmptyText(segment.depStationName);
+            const arrStation = nonEmptyText(segment.arrStationName);
+            const durationMin = positiveFiniteDuration(segment.duration);
+            const seatClass = optionalText(segment.seatClassName);
+            if (!no || !depDateTime || !arrDateTime || !depStation || !arrStation || durationMin === undefined
+                || (segment.marketingTransportName !== undefined && name === undefined)
+                || (segment.seatClassName !== undefined && seatClass === undefined))
+                continue;
+            parsedSegments.push({ no, name: name ?? '', depDateTime, arrDateTime, depStation, arrStation, durationMin, seatClass: seatClass ?? undefined });
+        }
+        if (parsedSegments.length !== segments.length) {
+            malformedCount += 1;
+            continue;
+        }
+        const first = parsedSegments[0];
+        const last = parsedSegments[parsedSegments.length - 1];
+        const journeyType = optionalText(journey?.journeyType);
+        const nonstop = parsedSegments.length === 1 && !/^(?:2|中转|transfer)/i.test(journeyType ?? '');
+        const totalDuration = positiveFiniteDuration(journey?.totalDuration)
+            ?? parsedSegments.reduce((sum, segment) => sum + segment.durationMin, 0);
+        const rawPriceValue = it.adultPrice !== undefined
+            ? it.adultPrice
+            : it.ticketPrice !== undefined ? it.ticketPrice : it.price;
+        const parsedPrice = parseTransportPrice(rawPriceValue);
+        const jumpUrl = optionalText(it.jumpUrl);
+        if (!parsedPrice
+            || (it.jumpUrl !== undefined && jumpUrl === undefined)) {
+            malformedCount += 1;
+            continue;
+        }
+        options.push({
+            no: first.no, name: first.name, depDateTime: first.depDateTime, arrDateTime: last.arrDateTime,
+            depStation: first.depStation, arrStation: last.arrStation, durationMin: totalDuration,
+            price: parsedPrice.price, priceRaw: parsedPrice.priceRaw,
+            seatClass: first.seatClass, jumpUrl: jumpUrl ?? undefined, nonstop, journeyType: journeyType ?? undefined,
+            segments: parsedSegments,
+        });
+    }
+    return { options, malformedCount };
+}
+function stringField(parent, key) {
+    const value = parent[key];
+    if (value === undefined)
+        return undefined;
+    if (value === null)
+        return null;
+    return nonEmptyText(value) ?? 'bad';
+}
+/** 酒店/万豪酒店条目 → FlyaiHotelOption(官方两形态字段集同构) */
+function parseHotelItems(items) {
+    const options = [];
+    let malformedCount = 0;
+    for (const raw of items) {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            malformedCount += 1;
+            continue;
+        }
+        const it = raw;
+        const name = nonEmptyText(it.name);
+        const star = stringField(it, 'star');
+        const rawPrice = stringField(it, 'price');
+        const rate = it.rate === undefined ? undefined : it.rate === null ? null : nonEmptyText(it.rate) ?? 'bad';
+        const address = stringField(it, 'address');
+        const poiSource = it.interestsPoi !== undefined ? it.interestsPoi : it.nearbyPoi;
+        const poi = poiSource === undefined ? undefined : poiSource === null ? null : nonEmptyText(poiSource) ?? 'bad';
+        const hotelIdSource = it.shId !== undefined ? it.shId : it.shid;
+        const hotelId = hotelIdSource === undefined ? undefined : nonEmptyText(hotelIdSource) ?? (typeof hotelIdSource === 'number' ? String(hotelIdSource) : 'bad');
+        const jumpUrl = stringField(it, 'detailUrl');
+        const mainPic = stringField(it, 'mainPic');
+        const score = it.score === undefined ? undefined : it.score === null ? null : nonEmptyText(it.score) ?? 'bad';
+        const scoreDesc = stringField(it, 'scoreDesc');
+        const review = stringField(it, 'review');
+        const brandName = stringField(it, 'brandName');
+        const latitude = stringField(it, 'latitude');
+        const longitude = stringField(it, 'longitude');
+        const fields = [star, rawPrice, rate, address, poi, hotelId, jumpUrl, mainPic, score, scoreDesc, review, brandName, latitude, longitude];
+        if (!name || fields.includes('bad')) {
+            malformedCount += 1;
+            continue;
+        }
+        const priceText = (rawPrice ?? '');
+        const bare = priceText.replace(/^¥/, '');
+        const numericPrice = Number(bare);
+        options.push({
+            name,
+            star: star ?? undefined,
+            price: /^\d+(\.\d+)?$/.test(bare) && numericPrice > 0 ? numericPrice : 0,
+            priceRaw: priceText || undefined,
+            rate: rate ?? undefined,
+            address: address ?? undefined,
+            poi: poi ?? undefined,
+            hotelId: hotelId ?? undefined,
+            jumpUrl: jumpUrl ?? undefined,
+            mainPic: mainPic ?? undefined,
+            score: score ?? undefined,
+            scoreDesc: scoreDesc ?? undefined,
+            review: review ?? undefined,
+            brandName: brandName ?? undefined,
+            latitude: latitude ?? undefined,
+            longitude: longitude ?? undefined,
+        });
+    }
+    return { options, malformedCount };
+}
+/** 景点条目 → FlyaiPoiOption */
+function parsePoiItems(items) {
+    const options = [];
+    let malformedCount = 0;
+    for (const raw of items) {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            malformedCount += 1;
+            continue;
+        }
+        const it = raw;
+        const name = nonEmptyText(it.name);
+        const poiId = it.id === undefined ? undefined : nonEmptyText(it.id) ?? (typeof it.id === 'number' ? String(it.id) : 'bad');
+        const mainPic = stringField(it, 'mainPic');
+        const jumpUrl = stringField(it, 'jumpUrl');
+        const address = stringField(it, 'address');
+        const freePoiStatus = stringField(it, 'freePoiStatus');
+        let ticketInfo;
+        if (it.ticketInfo !== undefined && it.ticketInfo !== null) {
+            if (typeof it.ticketInfo !== 'object' || Array.isArray(it.ticketInfo)) {
+                ticketInfo = 'bad';
+            }
+            else {
+                const t = it.ticketInfo;
+                const price = t.price === undefined ? undefined : t.price === null ? null : nonEmptyText(t.price) ?? 'bad';
+                const priceDate = t.priceDate === undefined || t.priceDate === null ? undefined : nonEmptyText(t.priceDate) ?? 'bad';
+                const ticketName = t.ticketName === undefined ? undefined : nonEmptyText(t.ticketName) ?? 'bad';
+                if ([price, priceDate, ticketName].includes('bad'))
+                    ticketInfo = 'bad';
+                else
+                    ticketInfo = { price: price ?? undefined, priceDate, ticketName };
+            }
+        }
+        if (!name || poiId === 'bad' || [mainPic, jumpUrl, address, freePoiStatus].includes('bad') || ticketInfo === 'bad') {
+            malformedCount += 1;
+            continue;
+        }
+        options.push({
+            name,
+            poiId: poiId ?? undefined,
+            mainPic: mainPic ?? undefined,
+            jumpUrl: jumpUrl ?? undefined,
+            address: address ?? undefined,
+            freePoiStatus: freePoiStatus ?? undefined,
+            ...(ticketInfo ? { ticketInfo } : {}),
+        });
+    }
+    return { options, malformedCount };
+}
+/** 关键词条目 → FlyaiKeywordOption(官方形状 itemList[].info) */
+function parseKeywordItems(items) {
+    const options = [];
+    let malformedCount = 0;
+    for (const raw of items) {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            malformedCount += 1;
+            continue;
+        }
+        const info = raw.info;
+        if (!info || typeof info !== 'object' || Array.isArray(info)) {
+            malformedCount += 1;
+            continue;
+        }
+        const it = info;
+        const title = nonEmptyText(it.title);
+        const str = (key) => {
+            const v = it[key];
+            if (v === undefined || v === null)
+                return undefined;
+            return nonEmptyText(v) ?? 'bad';
         };
+        const jumpUrl = str('jumpUrl');
+        const picUrl = str('picUrl');
+        const price = str('price');
+        const scoreDesc = str('scoreDesc');
+        const star = str('star');
+        let tags;
+        if (it.tags !== undefined && it.tags !== null) {
+            if (!Array.isArray(it.tags) || it.tags.some(t => nonEmptyText(t) === undefined))
+                tags = 'bad';
+            else
+                tags = it.tags.map(t => String(t).trim());
+        }
+        if (!title || [jumpUrl, picUrl, price, scoreDesc, star].includes('bad') || tags === 'bad') {
+            malformedCount += 1;
+            continue;
+        }
+        options.push({
+            title,
+            jumpUrl: jumpUrl ?? undefined,
+            picUrl: picUrl ?? undefined,
+            price: price ?? undefined,
+            scoreDesc: scoreDesc ?? undefined,
+            star: star ?? undefined,
+            ...(tags ? { tags } : {}),
+        });
     }
+    return { options, malformedCount };
+}
+/** 万豪套餐条目 → FlyaiMarriottPackageOption */
+function parsePackageItems(items) {
     const options = [];
-    for (const it of items){
-        const seg = it.journeys?.[0]?.segments?.[0];
-        if (!seg?.marketingTransportNo || !seg.depDateTime) continue;
-        const rawPrice = it.ticketPrice ?? it.price ?? '';
-        const numericPrice = Number(rawPrice);
+    let malformedCount = 0;
+    for (const raw of items) {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            malformedCount += 1;
+            continue;
+        }
+        const it = raw;
+        const title = stringField(it, 'title');
+        const name = title !== undefined ? title : stringField(it, 'name');
+        const itemId = stringField(it, 'itemId');
+        const mainPicSource = it.picUrl !== undefined ? 'picUrl' : 'mainPic';
+        const sellingPointSource = it.sellPoint !== undefined ? 'sellPoint' : 'sellingPoint';
+        const fields_ = [
+            stringField(it, 'brandName'), stringField(it, 'hotelName'), stringField(it, 'cityName'),
+            stringField(it, 'price'), stringField(it, 'detailUrl'), stringField(it, mainPicSource),
+            stringField(it, sellingPointSource), itemId,
+        ];
+        if (!name || fields_.includes('bad')) {
+            malformedCount += 1;
+            continue;
+        }
+        const [brandName, hotelName, cityName, price, detailUrl, mainPic, sellingPoint] = fields_;
         options.push({
-            no: seg.marketingTransportNo,
-            name: seg.marketingTransportName ?? '',
-            depDateTime: seg.depDateTime ?? '',
-            arrDateTime: seg.arrDateTime ?? '',
-            depStation: seg.depStationName ?? '',
-            arrStation: seg.arrStationName ?? '',
-            durationMin: Number(seg.duration ?? 0) || 0,
-            price: Number.isFinite(numericPrice) && numericPrice > 0 ? numericPrice : 0,
-            priceRaw: /^\d+$/.test(rawPrice) ? undefined : rawPrice || undefined,
-            seatClass: seg.seatClassName,
-            jumpUrl: it.jumpUrl
+            name: name,
+            ...(title && title !== 'bad' ? { title } : {}),
+            ...(itemId && itemId !== 'bad' ? { itemId } : {}),
+            brandName: brandName ?? undefined,
+            hotelName: hotelName ?? undefined,
+            cityName: cityName ?? undefined,
+            price: price ?? undefined,
+            detailUrl: detailUrl ?? undefined,
+            mainPic: mainPic ?? undefined,
+            picUrl: mainPic ?? undefined,
+            sellingPoint: sellingPoint ?? undefined,
+            sellPoint: sellingPoint ?? undefined,
         });
     }
-    const verdict = options.length > 0 ? 'hit' : 'miss';
-    return {
-        kind: q.kind,
-        latencyMs,
-        ok: true,
-        via: 'flyai',
-        verdict,
-        evidence: `[实时API:flyai@${ts}] ${options.length}/${items.length} ${q.kind} options`,
-        options
-    };
+    return { options, malformedCount };
 }
-
-
-//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/flyai.ts