@danceiny/gotry 0.0.1-rc.10

package/dist/capabilities/session/read-guard.js

@@ -0,0 +1,99 @@
+import { mkdirSync, appendFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+const HARD_PAY_RE = /\/(pay|payment|cashier)(\/|\?|$)/i;
+const WRITE_COMPOUND_RE = /(submitorder|createorder|placeorder|cancelorder|refundorder|orderconfirm|orderpay|confirmpay)/i;
+const WRITE_URL_RE = /\/(order|orders|submit|trade|booking|book|purchase|buy|create|cancel|refund)(\/|\?|$)/i;
+const WRITE_METHODS = new Set([
+    'POST',
+    'PUT',
+    'DELETE',
+    'PATCH'
+]);
+export const SUBMIT_TEXT_RE = /下单|去支付|支付|预订|订票|购买|提交订单|确认订单/;
+export function classifyRequest(method, url) {
+    if (HARD_PAY_RE.test(url) || WRITE_COMPOUND_RE.test(url)) return 'block';
+    if (WRITE_METHODS.has(method.toUpperCase()) && WRITE_URL_RE.test(url)) return 'block';
+    return 'allow';
+}
+export function isSubmitText(text) {
+    return SUBMIT_TEXT_RE.test(text ?? '');
+}
+export async function attachReadGuard(ctx, auditPath) {
+    let blocked = 0;
+    let total = 0;
+    await ctx.route('**/*', async (route)=>{
+        const req = route.request();
+        total += 1;
+        const verdict = classifyRequest(req.method(), req.url());
+        if (verdict === 'block') {
+            blocked += 1;
+            if (auditPath) {
+                const entry = {
+                    ts: new Date().toISOString(),
+                    kind: 'blocked-write-request',
+                    method: req.method(),
+                    url: req.url().slice(0, 400)
+                };
+                try {
+                    mkdirSync(dirname(auditPath), {
+                        recursive: true
+                    });
+                    appendFileSync(auditPath, JSON.stringify(entry) + '\n');
+                } catch  {}
+            }
+            await route.abort('blockedbyclient');
+            return;
+        }
+        await route.continue();
+    });
+    return {
+        blockedCount: ()=>blocked,
+        requestCount: ()=>total
+    };
+}
+export async function attachReadGuardPuppeteer(browser, auditPath) {
+    let blocked = 0;
+    let total = 0;
+    const wire = (page)=>{
+        void (async ()=>{
+            try {
+                await page.setRequestInterception(true);
+                page.on('request', async (req)=>{
+                    total += 1;
+                    const verdict = classifyRequest(req.method(), req.url());
+                    if (verdict === 'block') {
+                        blocked += 1;
+                        if (auditPath) {
+                            const entry = {
+                                ts: new Date().toISOString(),
+                                kind: 'blocked-write-request',
+                                method: req.method(),
+                                url: req.url().slice(0, 400)
+                            };
+                            try {
+                                mkdirSync(dirname(auditPath), {
+                                    recursive: true
+                                });
+                                appendFileSync(auditPath, JSON.stringify(entry) + '\n');
+                            } catch  {}
+                        }
+                        await req.abort('blockedbyclient').catch(()=>{});
+                        return;
+                    }
+                    await req.continue().catch(()=>{});
+                });
+            } catch  {}
+        })();
+    };
+    for (const p of (await browser.pages()))wire(p);
+    browser.on('targetcreated', (t)=>{
+        if (t.type() === 'page') void t.page().then(wire).catch(()=>{});
+    });
+    return {
+        blockedCount: ()=>blocked,
+        requestCount: ()=>total
+    };
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/session/read-guard.ts

package/dist/capabilities/session/transport.js

@@ -0,0 +1,101 @@
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { attachReadGuardPuppeteer } from './read-guard.js';
+async function loadPuppeteer() {
+    try {
+        return await import('puppeteer-core');
+    } catch  {
+        return {
+            missing: true
+        };
+    }
+}
+function devtoolsWsEndpoint() {
+    try {
+        const udd = process.env.CHROME_USER_DATA_DIR ?? `${homedir()}/Library/Application Support/Google/Chrome`;
+        const [port, wsPath] = readFileSync(`${udd}/DevToolsActivePort`, 'utf8').trim().split('\n');
+        if (!port || !wsPath?.startsWith('/devtools/browser/')) {
+            return {
+                err: `DevToolsActivePort 内容异常: ${String(port)}/${String(wsPath)}`
+            };
+        }
+        return {
+            ws: `ws://127.0.0.1:${port.trim()}${wsPath.trim()}`
+        };
+    } catch  {
+        return {
+            err: '日常 Chrome 未开调试端口。开启方法:Chrome 打开 chrome://inspect/#remote-debugging → 打开开关(Chrome 144+)'
+        };
+    }
+}
+export async function openSession(opts = {}) {
+    const pp = await loadPuppeteer();
+    if ('missing' in pp) {
+        return {
+            ok: false,
+            summary: 'puppeteer-core 未安装(可选依赖):会话检索不可用,官方通道 gotry_flyai_search 仍可用。安装:npm i -D puppeteer-core'
+        };
+    }
+    const puppeteer = pp.default;
+    const useCdp = opts.mode === 'cdp' || opts.mode !== 'persistent' && !opts.profileDir;
+    let browser;
+    let isCdp = false;
+    if (useCdp) {
+        const d = devtoolsWsEndpoint();
+        if ('err' in d) return {
+            ok: false,
+            summary: d.err
+        };
+        try {
+            browser = await puppeteer.connect({
+                browserWSEndpoint: d.ws,
+                defaultViewport: null
+            });
+            isCdp = true;
+        } catch (e) {
+            const msg = e instanceof Error ? e.message : e?.message ?? JSON.stringify(e).slice(0, 200);
+            return {
+                ok: false,
+                summary: `cdp attach 失败:${String(msg).split('\n')[0]}`
+            };
+        }
+    } else {
+        const { tmpdir } = await import('node:os');
+        const profileDir = opts.profileDir ?? `${tmpdir()}/gotry-session-profile`;
+        try {
+            browser = await puppeteer.launch({
+                channel: 'chrome',
+                headless: opts.headless ?? true,
+                userDataDir: profileDir
+            });
+        } catch (e) {
+            return {
+                ok: false,
+                summary: `chrome launch failed: ${e instanceof Error ? e.message.split('\n')[0] : String(e)}`
+            };
+        }
+    }
+    let guard;
+    try {
+        guard = await attachReadGuardPuppeteer(browser, opts.auditPath);
+    } catch (e) {
+        await (isCdp ? browser.disconnect() : browser.close()).catch(()=>{});
+        return {
+            ok: false,
+            summary: `read-guard attach failed: ${e instanceof Error ? e.message.split('\n')[0] : String(e)}`
+        };
+    }
+    const page = (await browser.pages())[0] ?? await browser.newPage();
+    return {
+        ok: true,
+        browser,
+        page,
+        guard,
+        close: async ()=>{
+            await (isCdp ? browser.disconnect() : browser.close()).catch(()=>{});
+        }
+    };
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/session/transport.ts

package/dist/capabilities/session-search.js

@@ -0,0 +1,93 @@
+import { openSession } from './session/transport.js';
+import { buildEntryUrl, NETWORK_HINTS, parseBatchSearch, LOGIN_COOKIE_NAMES, SITE_DOMAIN } from './session/adapters/ctrip-flight.js';
+const MIN_INTERVAL_MS = 30_000;
+const lastCallAt = new Map();
+export function __resetRateLimiterForTest() {
+    lastCallAt.clear();
+}
+const CHALLENGE_RE = /验证|滑块|captcha|verify/i;
+export async function sessionFlightSearch(q) {
+    const started = Date.now();
+    const ts = new Date().toISOString();
+    const site = 'ctrip-flight';
+    const err = (verdict, error)=>({
+            ok: false,
+            via: 'session-ctrip-flight-error',
+            evidence: `[会话:${site}@error@${ts}] ${error}`,
+            latencyMs: Date.now() - started,
+            verdict,
+            error
+        });
+    const last = lastCallAt.get(site) ?? 0;
+    if (Date.now() - last < MIN_INTERVAL_MS) {
+        return err('cooldown', `rate limit: last call ${Date.now() - last}ms ago, min ${MIN_INTERVAL_MS}ms`);
+    }
+    lastCallAt.set(site, Date.now());
+    const entry = buildEntryUrl(q.from, q.to, q.date);
+    if (!entry.ok || !entry.url) {
+        return err('error', `unresolved entry: ${(entry.unresolved ?? []).join('/')} 不在城市码表`);
+    }
+    const t = await openSession({
+        profileDir: q.profileDir,
+        headless: q.headless,
+        auditPath: q.auditPath,
+        mode: q.profileDir ? 'persistent' : 'cdp'
+    });
+    if (!t.ok) {
+        if (q.profileDir === undefined && /cdp attach 失败/.test(t.summary)) return err('needs-attach', t.summary);
+        return err('error', t.summary);
+    }
+    try {
+        const loggedIn = async ()=>{
+            const cookies = await t.browser.cookies().catch(()=>[]);
+            return cookies.some((c)=>c.domain.includes(SITE_DOMAIN.replace(/^\./, '')) && LOGIN_COOKIE_NAMES.includes(c.name));
+        };
+        if (!await loggedIn() && !q.allowAnonymous) {
+            return err('needs-login', '匿名实例——先跑 scripts/session-login.ts 用用户自己的账号建立登录态(allowAnonymous 仅限链路自检)');
+        }
+        let settled = false;
+        let body = '';
+        const heard = new Promise((resolve)=>{
+            t.page.on('response', async (res)=>{
+                if (settled) return;
+                const u = res.url();
+                if (!NETWORK_HINTS.some((re)=>re.test(u))) return;
+                try {
+                    body = await res.text();
+                } catch  {}
+                if (body) {
+                    settled = true;
+                    resolve();
+                }
+            });
+            setTimeout(()=>resolve(), q.timeoutMs ?? 25_000);
+        });
+        await t.page.goto(entry.url, {
+            waitUntil: 'domcontentloaded',
+            timeout: 30_000
+        });
+        await heard;
+        const title = await t.page.title().catch(()=>'');
+        const headHtml = (await t.page.content().catch(()=>'')).slice(0, 5000);
+        if (CHALLENGE_RE.test(title + headHtml)) {
+            return err('challenged', `风控/验证码命中(title=${title.slice(0, 60)});按红线不重试不绕过,交还用户`);
+        }
+        const options = parseBatchSearch(body);
+        const verdict = options.length > 0 ? 'hit' : 'miss';
+        return {
+            ok: true,
+            via: 'session-ctrip-flight',
+            evidence: `[会话:${site}@${ts}] ${options.length} options;guard blocked=${t.guard.blockedCount()}/${t.guard.requestCount()}${q.allowAnonymous ? ';anonymous=自检态' : ''}`,
+            latencyMs: Date.now() - started,
+            verdict,
+            options
+        };
+    } catch (e) {
+        return err('error', e instanceof Error ? e.message.slice(0, 200) : String(e));
+    } finally{
+        await t.close();
+    }
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/session-search.ts

package/dist/capabilities/weather.js

@@ -0,0 +1,180 @@
+const FORECAST_BASE = 'https://api.open-meteo.com/v1/forecast';
+const ARCHIVE_BASE = 'https://archive-api.open-meteo.com/v1/archive';
+const GEOCODE_BASE = 'https://geocoding-api.open-meteo.com/v1/search';
+const WMO_ZH = {
+    0: '晴',
+    1: '大致晴',
+    2: '多云',
+    3: '阴',
+    45: '雾',
+    48: '冻雾',
+    51: '毛毛雨',
+    53: '毛毛雨',
+    55: '密集毛毛雨',
+    61: '小雨',
+    63: '中雨',
+    65: '大雨',
+    66: '冻雨',
+    67: '强冻雨',
+    71: '小雪',
+    73: '中雪',
+    75: '大雪',
+    77: '雪粒',
+    80: '阵雨',
+    81: '强阵雨',
+    82: '暴雨',
+    85: '阵雪',
+    86: '强阵雪',
+    95: '雷暴',
+    96: '雷暴伴小冰雹',
+    99: '雷暴伴大冰雹'
+};
+export function wmoLabel(code) {
+    return WMO_ZH[code] ?? `天气码${code}`;
+}
+async function fetchJson(url, timeoutMs) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(()=>ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            signal: ctrl.signal,
+            headers: {
+                Accept: 'application/json'
+            }
+        });
+        if (!res.ok) return {
+            ok: false,
+            error: `HTTP ${res.status}`
+        };
+        return {
+            ok: true,
+            data: await res.json()
+        };
+    } catch (e) {
+        return {
+            ok: false,
+            error: e.message.slice(0, 200)
+        };
+    } finally{
+        clearTimeout(timer);
+    }
+}
+export async function geocodePlace(name, opts = {}) {
+    const ts = new Date().toISOString();
+    const count = opts.count ?? 5;
+    const url = `${GEOCODE_BASE}?name=${encodeURIComponent(name)}&count=${count}&language=zh&format=json`;
+    const r = await fetchJson(url, opts.timeoutMs ?? 15_000);
+    if (!r.ok) {
+        return {
+            ok: false,
+            evidence: `[实时API:open-meteo-geo@error@${ts}]`,
+            results: [],
+            error: r.error
+        };
+    }
+    const results = (r.data?.results ?? []).map((item)=>{
+        const it = item;
+        return {
+            name: String(it['name'] ?? ''),
+            latitude: Number(it['latitude']),
+            longitude: Number(it['longitude']),
+            country: it['country'] ? String(it['country']) : undefined,
+            admin1: it['admin1'] ? String(it['admin1']) : undefined
+        };
+    });
+    return {
+        ok: true,
+        evidence: `[实时API:open-meteo-geo@${ts}]`,
+        results
+    };
+}
+export async function getForecast(point, opts = {}) {
+    const started = Date.now();
+    const ts = new Date().toISOString();
+    const days = Math.min(opts.days ?? 7, 16);
+    const url = `${FORECAST_BASE}?latitude=${point.latitude}&longitude=${point.longitude}` + `&daily=temperature_2m_max,temperature_2m_min,precipitation_probability_max,weathercode` + `&forecast_days=${days}&timezone=auto`;
+    const r = await fetchJson(url, opts.timeoutMs ?? 15_000);
+    const latencyMs = Date.now() - started;
+    if (!r.ok) {
+        return {
+            ok: false,
+            via: 'open-meteo-error',
+            evidence: `[实时API:open-meteo@error@${ts}]`,
+            latencyMs,
+            error: r.error
+        };
+    }
+    const daily = r.data.daily;
+    if (!daily) {
+        return {
+            ok: false,
+            via: 'open-meteo-error',
+            evidence: `[实时API:open-meteo@error@${ts}]`,
+            latencyMs,
+            error: 'empty daily payload'
+        };
+    }
+    const rows = daily.time.map((date, i)=>({
+            date,
+            tempMaxC: daily.temperature_2m_max[i] ?? NaN,
+            tempMinC: daily.temperature_2m_min[i] ?? NaN,
+            precipProbMaxPct: daily.precipitation_probability_max?.[i] ?? null,
+            weatherCode: daily.weathercode[i] ?? -1
+        }));
+    return {
+        ok: true,
+        via: 'open-meteo',
+        evidence: `[实时API:open-meteo@${ts}]`,
+        latencyMs,
+        timezone: r.data.timezone,
+        daily: rows
+    };
+}
+export async function getClimate(point, month, opts = {}) {
+    const started = Date.now();
+    const ts = new Date().toISOString();
+    const year = opts.year ?? new Date().getFullYear() - 1;
+    const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();
+    const start = `${year}-${String(month).padStart(2, '0')}-01`;
+    const end = `${year}-${String(month).padStart(2, '0')}-${String(lastDay).padStart(2, '0')}`;
+    const url = `${ARCHIVE_BASE}?latitude=${point.latitude}&longitude=${point.longitude}` + `&start_date=${start}&end_date=${end}` + `&daily=temperature_2m_max,temperature_2m_min,precipitation_sum,weathercode&timezone=auto`;
+    const r = await fetchJson(url, opts.timeoutMs ?? 15_000);
+    const latencyMs = Date.now() - started;
+    if (!r.ok) {
+        return {
+            ok: false,
+            via: 'open-meteo-error',
+            evidence: `[实时API:open-meteo-climate@error@${ts}]`,
+            latencyMs,
+            error: r.error
+        };
+    }
+    const daily = r.data.daily;
+    if (!daily) {
+        return {
+            ok: false,
+            via: 'open-meteo-error',
+            evidence: `[实时API:open-meteo-climate@error@${ts}]`,
+            latencyMs,
+            error: 'empty daily payload'
+        };
+    }
+    const rows = daily.time.map((date, i)=>({
+            date,
+            tempMaxC: daily.temperature_2m_max[i] ?? NaN,
+            tempMinC: daily.temperature_2m_min[i] ?? NaN,
+            precipProbMaxPct: null,
+            weatherCode: daily.weathercode[i] ?? -1
+        }));
+    return {
+        ok: true,
+        via: 'open-meteo',
+        evidence: `[实时API:open-meteo-climate@${ts}]`,
+        latencyMs,
+        timezone: r.data.timezone,
+        daily: rows
+    };
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/weather.ts

package/dist/scripts/action-cache-tests.js

@@ -0,0 +1,107 @@
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ActionCache, actionCachePath, fingerprint, templateKey } from '../capabilities/session/action-cache.js';
+let pass = 0;
+let fail = 0;
+function assert(cond, label, detail) {
+    if (cond) {
+        pass += 1;
+        console.log(`  ok - ${label}`);
+    } else {
+        fail += 1;
+        console.log(`  FAIL - ${label}${detail !== undefined ? ' :: ' + String(detail) : ''}`);
+    }
+}
+const iso = mkdtempSync(join(tmpdir(), 'gotry-actioncache-'));
+const path = actionCachePath(iso);
+const T0 = new Date('2026-08-28T10:00:00Z');
+let clock = T0.getTime();
+const now = ()=>new Date(clock);
+const site = 'ctrip-flight';
+console.log('A. templateKey(参数变量化)');
+const k1 = templateKey(site, 'search', {
+    from: '上海',
+    to: '丽江',
+    date: '2026-10-01'
+});
+const k2 = templateKey(site, 'search', {
+    from: '上海',
+    to: '丽江',
+    date: '2026-11-11'
+});
+assert(k1 === k2 && k1 === 'ctrip-flight:search:上海|丽江|%date%', '同型查询共享模板 key(日期变量化),跨日期复用');
+console.log('B. 命中与指纹失配(被动失效)');
+const c = new ActionCache(path, {
+    now
+});
+const fpA = fingerprint('batchSearch v1 shape {"flightItineraryList":[]}');
+const fpB = fingerprint('batchSearch v2 shape {"itineraries":[]}');
+c.record(k1, fpA, {
+    entryUrl: 'https://flights.ctrip.com/online/list/oneway-sha-ljg?depdate=%date%',
+    parser: 'batchSearch.v1'
+}, site);
+clock += 60_000;
+assert(c.lookup(k1, fpA, site)?.locator.parser === 'batchSearch.v1', '指纹一致 → 命中并回放确定性载荷');
+assert(c.lookup(k1, fpA, site)?.hits === 2, '命中计 hits');
+assert(c.lookup(k1, fpB, site) === null, '接口改版(指纹失配)→ miss 不误放(错误的缓存点击比慢更糟)');
+assert(c.lookup(templateKey(site, 'search', {
+    from: '北京',
+    to: '大理',
+    date: '2026-10-01'
+}), fpA, site) === null, 'key 不同 → miss');
+console.log('C. miss 回写与幂等');
+c.record(k1, fpB, {
+    entryUrl: 'oneway-bjs-dlu?depdate=%date%',
+    parser: 'batchSearch.v2'
+}, site);
+assert(c.lookup(k1, fpB, site)?.locator.parser === 'batchSearch.v2', '改版后回写新载荷,下次命中');
+const hitsBefore = c.lookup(k1, fpB, site).hits;
+c.record(k1, fpB, {
+    parser: 'batchSearch.v2'
+}, site);
+assert(c.lookup(k1, fpB, site).hits === hitsBefore + 1, '重复 record 幂等(hits/createdAt 保留,不重置)');
+console.log('D. TTL 过期(48h 默认;注入时钟)');
+clock += 49 * 3600_000;
+assert(c.lookup(k1, fpB, site) === null && c.size(site) === 0, '超 48h → 过期删除条目');
+console.log('E. LRU 淘汰(每站点上限)');
+const c2 = new ActionCache(path + '.lru', {
+    now,
+    maxEntriesPerSite: 3
+});
+for(let i = 0; i < 5; i++){
+    const key = `ctrip-flight:search:城${i}|丽江|%date%`;
+    c2.record(key, fingerprint(`shape-${i}`), {
+        i: String(i)
+    }, site);
+    clock += 1_000;
+}
+assert(c2.size(site) === 3, '超容 LRU 淘汰至 3 条');
+console.log('F. 持久化跨实例 + 损坏文件容错');
+const c3 = new ActionCache(path + '.p', {
+    now
+});
+c3.record('meituan:search:大理|民宿|%date%', fingerprint('mt-shape'), {
+    url: 'https://www.meituan.com/...'
+}, 'meituan');
+clock += 5_000;
+const c4 = new ActionCache(path + '.p', {
+    now
+});
+assert(c4.lookup('meituan:search:大理|民宿|%date%', fingerprint('mt-shape'), 'meituan') !== null, '跨实例:落盘后新实例可命中');
+writeFileSync(path + '.broken', '{not json', 'utf8');
+const c5 = new ActionCache(path + '.broken', {
+    now
+});
+assert(c5.size() === 0 && c5.lookup('any', 'any', site) === null, '损坏 JSON 按空缓存,不抛错');
+console.log('G. fingerprint 敏感度');
+assert(fingerprint('abc') !== fingerprint('abd') && fingerprint('abc') === fingerprint('abc'), '微改即变,同文稳定');
+rmSync(iso, {
+    recursive: true,
+    force: true
+});
+console.log(`\nACTION-CACHE: ${pass} pass, ${fail} fail`);
+process.exit(fail > 0 ? 1 : 0);
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/action-cache-tests.ts

package/dist/scripts/agent-reach-deep-tests.js

@@ -0,0 +1,54 @@
+import assert from 'node:assert/strict';
+import { videoSubtitle, githubSearch } from '../capabilities/agent-reach-deep.js';
+{
+    const r = await videoSubtitle({
+        url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
+        timeoutMs: 15_000
+    });
+    assert.ok([
+        'found',
+        'not-installed',
+        'error',
+        'timeout'
+    ].includes(r.verdict), `verdict 三值之一: ${r.verdict}`);
+    assert.ok(r.evidence.includes('[agent-reach:yt-dlp@'), '证据链前缀');
+    console.log(`1. yt-dlp → ${r.verdict} (${r.latencyMs}ms) OK`);
+}{
+    const r = await githubSearch({
+        query: 'agent-reach',
+        limit: 3
+    });
+    assert.ok([
+        'found',
+        'not-installed',
+        'error',
+        'timeout'
+    ].includes(r.verdict));
+    if (r.verdict === 'found') {
+        assert.ok((r.repos?.length ?? 0) > 0, 'found 应有 repos');
+        const top = r.repos[0];
+        console.log(`2. gh search → found (top: ${top.name} ★${top.stars}) OK`);
+    } else {
+        console.log(`2. gh search → ${r.verdict} (${r.stderr?.slice(0, 60)}) OK`);
+    }
+}{
+    const r = await githubSearch({
+        query: 'hello'
+    });
+    assert.match(r.evidence, /\[agent-reach:gh@/, 'gh 证据链');
+    console.log('3. 证据链格式 OK');
+}{
+    const r = await githubSearch({
+        query: 'hello',
+        timeoutMs: 1
+    });
+    assert.ok([
+        'timeout',
+        'error',
+        'not-installed'
+    ].includes(r.verdict));
+    console.log(`4. 超时 → ${r.verdict} OK`);
+}console.log('\nAGENT-REACH DEEP TESTS: 4/4 OK(yt-dlp/gh 可选工具,不装则降级)');
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/agent-reach-deep-tests.ts

package/dist/scripts/agent-reach-tests.js

@@ -0,0 +1,38 @@
+import assert from 'node:assert/strict';
+import { readUrl } from '../capabilities/agent-reach.js';
+{
+    const r = await readUrl({
+        url: 'example.com'
+    });
+    assert.equal(r.ok, false);
+    assert.equal(r.via, 'r.jina.ai-error');
+    assert.ok(r.evidence.includes('error'), 'evidence 带 error');
+    console.log('1. 非法 URL 拒绝 OK');
+}{
+    const r = await readUrl({
+        url: 'https://example.com',
+        timeoutMs: 1
+    });
+    assert.equal(r.ok, false);
+    assert.equal(r.via, 'r.jina.ai-error');
+    assert.ok(r.latencyMs >= 0, '永不抛错');
+    console.log('2. 超时降级 OK');
+}{
+    const r = await readUrl({
+        url: 'https://example.com',
+        timeoutMs: 30_000
+    });
+    if (r.ok) {
+        assert.ok(r.evidence.includes('[agent-reach:web.read@'), '证据链');
+        assert.match(r.evidence, /\[agent-reach:web\.read@2\d{3}-\d{2}-\d{2}T/, '证据链带 ISO 时间戳');
+        assert.ok(typeof r.content === 'string' && r.content.length > 0, 'content 非空');
+        assert.ok(typeof r.title === 'string' && r.title.length > 0, `Title 提取,实际 ${r.title}`);
+        console.log(`3. readUrl example.com → ok (title=${r.title}) OK`);
+    } else {
+        assert.equal(r.via, 'r.jina.ai-error');
+        console.log(`3. readUrl example.com → 降级(${r.error?.slice(0, 60)})(网络边界,合法) OK`);
+    }
+}console.log('\nAGENT-REACH TESTS: 3/3 OK(readUrl 薄壳;上游真读见 wrapper 套)');
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/agent-reach-tests.ts