@danceiny/gotry 0.0.1-rc.5 → 0.0.1-rc.7

package/dist/src/index.js

@@ -0,0 +1,760 @@
+import { join } from 'node:path';
+import z from '@deepseek-ai/schemastery';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { ensureStateDir, readJson, recordLatency, writeJson } 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 { geocodePlace, getForecast, getClimate, wmoLabel } from '../capabilities/weather.js';
+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';
+export const name = 'gotry-tools';
+export const inject = [
+    'tools',
+    'systemPrompt'
+];
+export const Config = z.object({
+    stateRoot: z.string().default('.'),
+    timeoutMs: z.number().default(30_000),
+    hbcliBin: z.string().default('hbcli')
+});
+export function apply(ctx, config) {
+    const sp = ctx['systemPrompt'];
+    sp?.variable?.('current_date', ()=>{
+        const d = new Date();
+        const ymd = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+        const weekdays = [
+            '日',
+            '一',
+            '二',
+            '三',
+            '四',
+            '五',
+            '六'
+        ];
+        return `${ymd} 周${weekdays[d.getDay()]}`;
+    });
+    installProcessGuards(config.stateRoot ?? '.', {
+        uncaughtException: 'gotry-tools',
+        unhandledRejection: 'gotry-tools'
+    });
+    const registerGuarded = (tool)=>{
+        const t = {
+            ...tool
+        };
+        if (typeof t.execute === 'function') {
+            t.execute = guardToolExecute(String(t.name), config.stateRoot ?? '.', t.execute);
+        }
+        ctx.tools.register(t);
+    };
+    registerGuarded(defineTool({
+        name: 'gotry_feasibility_check',
+        description: 'Check travel candidates against the user\'s motivation and hard constraints using the ' + 'door-to-door true-cost engine (wake time, arrival state, energy, usable hours, money). ' + 'Input is the structured request (motivation weights + hard constraints + window + budget + home hubs) ' + 'and the candidate list (services/transfers/stay costs/min days), same shape as data/golden_erhai.json. ' + 'Returns per-candidate verdicts, unsat cores with minimal-modification suggestions, ' + 'a wish-pool entry for infeasible aspirations, and a ready-to-show markdown answer.',
+        parameters: {
+            payload: {
+                type: 'json',
+                required: true,
+                description: 'The full engine payload: { request, candidates }.'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.answer_md ?? JSON.stringify(value))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const started = Date.now();
+            const payload = args.payload;
+            const req = parseRequest(payload['request']);
+            const cands = payload['candidates'].map(parseCandidate);
+            const spec = segmentsFromCandidate(req, cands);
+            const result = solveChoiceSegment(spec, req);
+            const dir = await ensureStateDir(config.stateRoot);
+            await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, 'feasibility_check:in-process-unified').catch(()=>{});
+            return {
+                ...result,
+                latency_ms: Date.now() - started,
+                via: 'in-process-unified'
+            };
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: 'GoTry 可行性检查(门到门全成本)',
+                kind: 'other',
+                rawInput: args.payload
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_motivation_save',
+        description: 'Persist the traveler\'s motivation profile (the "why depart" contract object). ' + 'This is the B2B reuse seam: downstream plugins consume only MotivationProfile + constraints, ' + 'never the principal/sponsor distinction. Requires an evidence field: every weight must trace ' + 'back to the user\'s own words (P0 anti-fabrication rule).',
+        parameters: {
+            profile: {
+                type: 'json',
+                required: true,
+                description: '{ weights: {escape_rest: 0.7, ...}, evidence: [user quotes...], hard: {wake_not_before, min_arrival_energy_pct} }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    saved: {
+                        type: 'boolean'
+                    },
+                    path: {
+                        type: 'string'
+                    },
+                    profile: {
+                        type: 'json'
+                    }
+                }
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: `动机画像已保存:${String(value.path ?? '')}`
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const profile = args.profile ?? {};
+            if (!profile.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');
+            const saved = JSON.parse(JSON.stringify({
+                ...profile,
+                updated_at: new Date().toISOString()
+            }));
+            await writeJson(path, saved);
+            return {
+                saved: true,
+                path,
+                profile: saved
+            };
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: '保存动机画像',
+                kind: 'other',
+                rawInput: args.profile
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_wish_pool_add',
+        description: 'Add an aspiration to the "next departure" wish pool — the graceful home for infeasible dreams. ' + 'An entry carries its fulfilment conditions (days needed, budget, best months) so a future ' + '"next departure" nudge can fire when the window matches. 憧憬不被拒绝。',
+        parameters: {
+            entry: {
+                type: 'json',
+                required: true,
+                description: '{ name, reason, conditions: { days, budget_cny, best_months } }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    added: {
+                        type: 'boolean'
+                    },
+                    total: {
+                        type: 'integer'
+                    },
+                    path: {
+                        type: 'string'
+                    }
+                }
+            },
+            render: (_args, value)=>{
+                const v = value;
+                return [
+                    {
+                        type: 'text',
+                        text: `已加入「下一次出发」清单(共 ${v.total ?? '?'} 项):${v.path ?? ''}`
+                    }
+                ];
+            }
+        },
+        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) {
+                pool[existing] = {
+                    ...pool[existing],
+                    reason: entry.reason ?? pool[existing]?.['reason'],
+                    conditions: entry.conditions
+                };
+                await writeJson(path, pool);
+                return {
+                    added: false,
+                    total: pool.length,
+                    path
+                };
+            }
+            pool.push({
+                reason: '',
+                ...entry,
+                added_at: new Date().toISOString()
+            });
+            await writeJson(path, pool);
+            return {
+                added: true,
+                total: pool.length,
+                path
+            };
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: '加入「下一次出发」清单',
+                kind: 'other',
+                rawInput: args.entry
+            })
+    }));
+    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. Output: hotel list with evidence chain ([realtime-API:hbcli] + fetch timestamp, ' + 'or [static-pack:estimate]) per the L4 invariant.',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ destination: "普吉", checkIn?: "2026-07-18", checkOut?: "2026-07-23", occupancy?: { adults: 2 } }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? JSON.stringify(value).slice(0, 400))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = args.query ?? {};
+            if (!q.destination) throw new Error('gotry_hotel_search requires destination');
+            const started = Date.now();
+            const fallbackPath = join(import.meta.dirname, '..', '..', 'data', 'hotels_2026.json');
+            const resp = await hbcliSearchHotels({
+                destination: q.destination,
+                checkIn: q.checkIn,
+                checkOut: q.checkOut,
+                adults: q.adults
+            }, {
+                hbcliBin: config.hbcliBin,
+                timeoutMs: config.timeoutMs,
+                fallbackPath
+            });
+            const dir = await ensureStateDir(config.stateRoot);
+            const isLive = resp.via === 'hbcli-realtime';
+            const evidence = isLive ? resp.evidence : '[静态包:估算]';
+            await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, `hotel_search:${resp.via}`).catch(()=>{});
+            const payload = {
+                hotels: resp.hotels ?? null,
+                evidence,
+                destination: q.destination,
+                via: resp.via,
+                latency_ms: Date.now() - started,
+                summary: resp.summary,
+                error: resp.error
+            };
+            return JSON.parse(JSON.stringify(payload));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `酒店搜索:${String(args.query?.destination ?? '')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_skeleton_check',
+        description: 'Check flight connectivity between two airports against the OpenFlights skeleton (free tier). ' + 'Three-valued: found = strong positive (airlines returned); hub-to-hub absence = downgrade signal, NEVER disproof ' + '(skeleton lags reality); outside hub set = no conclusion. Use BEFORE recommending a route.',
+        parameters: {
+            from: {
+                type: 'string',
+                required: true,
+                description: 'IATA, e.g. HKG'
+            },
+            to: {
+                type: 'string',
+                required: true,
+                description: 'IATA, e.g. HKT'
+            }
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    connected: {
+                        type: 'boolean'
+                    },
+                    airlines: {
+                        type: 'array',
+                        items: {
+                            type: 'string'
+                        }
+                    },
+                    evidence: {
+                        type: 'string'
+                    }
+                }
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.evidence ?? '')
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const verdict = await checkConnectivity(args.from, args.to);
+            return JSON.parse(JSON.stringify(verdict));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `骨架校验:${args.from}-${args.to}`,
+                kind: 'other',
+                rawInput: args
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_weather_check',
+        description: 'Check weather for a destination: forecast (≤16 days) or historical climate (seasonality baseline). ' + 'Free Open-Meteo API, no key required. Input: place name (Chinese ok) or lat/lng. ' + 'Returns daily temp range, precipitation probability, weather code — with evidence chain tagging ' + '[实时API:open-meteo@ts]. Use to ground seasonal advice in real data instead of LLM guessing.',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ place: "大理市", month?: 8, mode?: "forecast"|"climate", days?: 7 }'
+            }
+        },
+        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 = args.query ?? {};
+            const started = Date.now();
+            let lat = q.lat, lng = q.lng;
+            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);
+                if (!geo.ok || geo.results.length === 0) {
+                    return JSON.parse(JSON.stringify({
+                        ok: false,
+                        summary: `地点「${q.place}」地理编码失败:${geo.error ?? '无结果'}`,
+                        evidence: geo.evidence
+                    }));
+                }
+                const hit = geo.results[0];
+                lat = hit.latitude;
+                lng = hit.longitude;
+                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 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}%` : ''}`);
+            const summary = r.ok ? `${placeLabel}:${isClimate ? '历史气候' : `${q.days ?? 7} 天预报`}\n${dailyLines.join('\n')}\n${r.evidence}` : `${placeLabel}:天气查询失败(${r.error})${r.evidence}`;
+            return JSON.parse(JSON.stringify({
+                ok: r.ok,
+                place: placeLabel,
+                mode: isClimate ? 'climate' : 'forecast',
+                daily: r.daily,
+                evidence: r.evidence,
+                summary,
+                latency_ms: Date.now() - started
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `天气:${String(args.query?.place ?? '')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_flight_verify',
+        description: 'Verify whether a flight callsign is currently observable on the OpenSky ADS-B network. ' + 'Free anonymous API (~400 credits/day, 4 req/s burst). Three-valued semantics: ' + 'observed = strong positive (the aircraft is currently being broadcast); ' + 'not_observed = no conclusion (ADS-B coverage is limited by geography/altitude — ' + 'a missing signal does NOT disprove the flight); ' + 'unavailable = API failure, gracefully degraded. ' + 'Use to ground "is this flight actually flying right now?" in real data, complementing ' + 'the OpenFlights skeleton (historical connectivity) and the static flight pack (planned schedule).',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ callsign: "EK329", airport?: "OMDB", timeoutMs?: 10000 }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.summary ?? JSON.stringify(value).slice(0, 500))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = args.query ?? {};
+            const started = Date.now();
+            if (!q.callsign) {
+                return JSON.parse(JSON.stringify({
+                    verdict: 'unavailable',
+                    evidence: '[校验不可用:无 callsign]',
+                    summary: 'callsign 必填'
+                }));
+            }
+            const r = await verifyFlight({
+                callsign: q.callsign,
+                airport: q.airport,
+                timeoutMs: q.timeoutMs
+            });
+            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}`;
+            return JSON.parse(JSON.stringify({
+                verdict: r.verdict,
+                callsign: r.callsign,
+                airport: r.airport,
+                sample_size: r.sampleSize,
+                hits: r.hits,
+                evidence: r.evidence,
+                summary,
+                latency_ms: Date.now() - started
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `飞行校验:${String(args.query?.callsign ?? '')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_anything_search',
+        description: 'Universal Anything search via hotel-byte CLI → hotel-be Anything endpoint. ' + '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).',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ keyword: "大理", contentType?: "city"|"hotel", parentDestinationId?: "?", timeoutMs?: 12000 }'
+            }
+        },
+        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 = args.query ?? {};
+            const started = Date.now();
+            if (!q.keyword) {
+                return JSON.parse(JSON.stringify({
+                    ok: false,
+                    verdict: 'error',
+                    summary: 'keyword 必填',
+                    evidence: '[hbcli-anything@error] empty'
+                }));
+            }
+            const r = await anythingSearch(q);
+            const dir = await ensureStateDir(config.stateRoot);
+            await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, `anything:${r.via}`).catch(()=>{});
+            const top5 = (r.hits ?? []).slice(0, 5);
+            const summary = r.verdict === 'hit' ? `${q.keyword} → hit (${r.hits?.length ?? 0} 候选项)\n${top5.map((h, i)=>`  ${i + 1}. [${h.type}] ${h.name}${h.latitude !== undefined && h.longitude !== undefined ? ` @ (${h.latitude.toFixed(3)},${h.longitude.toFixed(3)})` : ''}`).join('\n')}\n${r.evidence}` : r.verdict === 'miss' ? `${q.keyword} → miss (酒店-be 一切正常但无候选)\n${r.evidence}` : `${q.keyword} → unavailable (${r.error})\n${r.evidence}`;
+            return JSON.parse(JSON.stringify({
+                ok: r.ok,
+                verdict: r.verdict,
+                keyword: q.keyword,
+                content_type: q.contentType ?? null,
+                total_candidates: r.totalCandidates,
+                hits: r.hits,
+                evidence: r.evidence,
+                summary,
+                latency_ms: Date.now() - started
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `Anything search:${String(args.query?.keyword ?? '')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_web_search',
+        description: 'Read any public URL as markdown (Jina Reader, free, no key). ' + 'Use as the "last mile" web reader when hotel-be Anything or gotry tools lack the answer. ' + 'NOT a general-purpose search engine — only fetches a URL you already know. ' + 'Three-valued: ok / error(非法 URL/超时)/not-reachable(r.jina.ai 不可用).' + 'Contract with gotry capabilities/anything.ts: 同构(L4 证据链 + 降级不阻塞 + 三值)。',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ url: "https://example.com", timeoutMs?: 20000 }'
+            }
+        },
+        output: {
+            schema: {
+                type: 'json'
+            },
+            render: (_args, value)=>[
+                    {
+                        type: 'text',
+                        text: String(value.content?.slice(0, 800) ?? JSON.stringify(value).slice(0, 800))
+                    }
+                ]
+        },
+        async execute (args, _exec) {
+            const q = args.query ?? {};
+            const started = Date.now();
+            if (!q.url) {
+                return JSON.parse(JSON.stringify({
+                    ok: false,
+                    summary: 'url 必填',
+                    evidence: '[agent-reach:error] empty url'
+                }));
+            }
+            const r = await readUrl({
+                url: q.url,
+                timeoutMs: q.timeoutMs
+            });
+            const dir = await ensureStateDir(config.stateRoot);
+            await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, `agent-reach:${r.via}`).catch(()=>{});
+            const summary = r.ok ? `${q.url} → ${r.title ?? '(no title)'} (${r.latencyMs}ms)\n${r.evidence}\n---\n${r.content?.slice(0, 600) ?? ''}` : `${q.url} → unavailable (${r.error})\n${r.evidence}`;
+            return JSON.parse(JSON.stringify({
+                ok: r.ok,
+                url: q.url,
+                via: r.via,
+                title: r.title,
+                content: r.content,
+                evidence: r.evidence,
+                summary,
+                latency_ms: Date.now() - started
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `读网页:${String(args.query?.url ?? '')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_video_subtitle',
+        description: 'Extract subtitles from a YouTube/Bilibili video (yt-dlp, optional tool). ' + 'If yt-dlp is installed on this machine, returns the subtitle text (vtt, zh-Hans/zh/en preference). ' + 'If NOT installed, degrades gracefully with install instructions — never blocks. ' + 'Evidence chain: [agent-reach:yt-dlp@ts] / [@not-installed@ts].',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ url: "https://www.youtube.com/watch?v=...", lang?: "zh-Hans,zh,en" }'
+            }
+        },
+        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 = args.query ?? {};
+            if (!q.url) {
+                return JSON.parse(JSON.stringify({
+                    ok: false,
+                    summary: 'url 必填'
+                }));
+            }
+            const r = await videoSubtitle({
+                url: q.url,
+                lang: q.lang
+            });
+            const summary = r.verdict === 'found' ? `${q.url} 字幕提取成功 (${r.latencyMs}ms)\n${r.evidence}\n---\n${(r.subtitles ?? '').slice(0, 800)}` : r.verdict === 'not-installed' ? `yt-dlp 未安装。${r.stderr}\n${r.evidence}` : `${q.url} 字幕提取失败(${r.verdict})\n${r.evidence}`;
+            return JSON.parse(JSON.stringify({
+                ok: r.ok,
+                verdict: r.verdict,
+                url: q.url,
+                subtitles: r.subtitles?.slice(0, 4000),
+                evidence: r.evidence,
+                summary,
+                latency_ms: r.latencyMs
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `视频字幕:${String(args.query?.url ?? '')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_github_search',
+        description: 'Search GitHub repositories (gh CLI, optional tool). ' + 'If gh is installed and authenticated, returns repos with name/description/stars/url. ' + 'If NOT installed, degrades with install instructions — never blocks. ' + 'Evidence chain: [agent-reach:gh@ts] / [@not-installed@ts].',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ query: "agent-reach", limit?: 5 }'
+            }
+        },
+        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 = args.query ?? {};
+            if (!q.query) {
+                return JSON.parse(JSON.stringify({
+                    ok: false,
+                    summary: 'query 必填'
+                }));
+            }
+            const r = await githubSearch({
+                query: q.query,
+                limit: q.limit
+            });
+            const summary = r.verdict === 'found' ? `${q.query} → ${r.repos?.length ?? 0} repos\n${(r.repos ?? []).map((x, i)=>`  ${i + 1}. ${x.name} ★${x.stars ?? '?'} — ${(x.description ?? '').slice(0, 60)}`).join('\n')}\n${r.evidence}` : r.verdict === 'not-installed' ? `gh 未安装。${r.stderr}\n${r.evidence}` : `${q.query} 搜索失败(${r.verdict})\n${r.evidence}`;
+            return JSON.parse(JSON.stringify({
+                ok: r.ok,
+                verdict: r.verdict,
+                query: q.query,
+                repos: r.repos,
+                evidence: r.evidence,
+                summary,
+                latency_ms: r.latencyMs
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `GitHub 搜索:${String(args.query?.query ?? '')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+    registerGuarded(defineTool({
+        name: 'gotry_agent_reach',
+        description: 'Agent Reach — thin wrapper over Panniantong/Agent-Reach upstream registry (zero channel knowledge here). ' + 'Call ANY upstream channel method by reflection: web.read(url) / v2ex.get_hot_topics() / v2ex.search(query) / ' + 'xueqiu.get_stock_quote(symbol) / xueqiu.search_stock(query) / youtube.transcribe(url) / <channel>.check() ... ' + 'Unknown channel or method? Just call it — the error returns the upstream inventory (channel list or method signatures) so you can self-correct. ' + 'Action "status" runs the real `agent-reach doctor` (.venv/bin/agent-reach). ' + 'Channels needing cookies/setup return the upstream check() guidance verbatim (never blocks). ' + 'Evidence chain: [agent-reach:<channel>.<method>@ts].',
+        parameters: {
+            query: {
+                type: 'json',
+                required: true,
+                description: '{ action: "status" } 或 { action: "reach", channel: "<上游渠道名,如 web/v2ex/xueqiu>", method: "<上游方法名,如 read/get_hot_topics/get_stock_quote>", args?: "<空格分隔参数>" }'
+            }
+        },
+        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 = args.query ?? {};
+            const started = Date.now();
+            const dir = await ensureStateDir(config.stateRoot);
+            if (q.action === 'status' || !q.action && !q.channel) {
+                const st = await reachStatus(q.timeoutMs);
+                await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, 'agent-reach:doctor').catch(()=>{});
+                const summary = st.via === 'agent-reach-cli' ? `Agent Reach doctor(上游 CLI,原样透传):\n${st.output}\n${st.evidence}` : `Agent Reach 未装:\n${st.output}\n${st.evidence}`;
+                return JSON.parse(JSON.stringify({
+                    ok: st.ok,
+                    via: st.via,
+                    output: st.output,
+                    evidence: st.evidence,
+                    summary,
+                    latency_ms: Date.now() - started
+                }));
+            }
+            if (!q.channel || !q.method) {
+                return JSON.parse(JSON.stringify({
+                    ok: false,
+                    summary: 'channel 与 method 必填(或 action=status);清单可先随便调一次,inventory 会带回上游渠道/方法表'
+                }));
+            }
+            const r = await reach({
+                channel: q.channel,
+                method: q.method,
+                args: q.args,
+                timeoutMs: q.timeoutMs
+            });
+            await recordLatency(join(dir, 'bridge-latency.jsonl'), Date.now() - started, `agent-reach:${q.channel}.${q.method}:${r.verdict}`).catch(()=>{});
+            const summary = r.verdict === 'found' ? `${q.channel}.${q.method} → found (${r.latencyMs}ms)\n${r.evidence}\n${typeof r.data === 'string' ? r.data.slice(0, 600) : JSON.stringify(r.data ?? null).slice(0, 600)}` : r.verdict === 'needs-setup' ? `${q.channel}.${q.method} → 需配置(上游 check() 原话): ${r.setup ?? ''}\n${r.evidence}` : r.verdict === 'not-installed' ? `${q.channel}.${q.method} → 上游未装: ${r.setup ?? ''}\n${r.evidence}` : `${q.channel}.${q.method} → ${r.error ?? 'error'}${r.inventory ? `\n上游清单: ${JSON.stringify(r.inventory).slice(0, 1200)}` : ''}\n${r.evidence}`;
+            return JSON.parse(JSON.stringify({
+                ok: r.ok,
+                channel: r.channel,
+                method: q.method,
+                verdict: r.verdict,
+                data: typeof r.data === 'string' ? r.data.slice(0, 4000) : r.data,
+                inventory: r.inventory,
+                setup: r.setup,
+                evidence: r.evidence,
+                summary,
+                latency_ms: Date.now() - started
+            }));
+        },
+        presentCall: (args)=>({
+                card: 'generic',
+                title: `Agent Reach:${String(args.query?.channel ?? '')}.${String(args.query?.method ?? 'status')}`,
+                kind: 'other',
+                rawInput: args.query
+            })
+    }));
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/src/index.ts