@danceiny/gotry 0.0.1-rc.21 → 0.0.1-rc.24

package/dist/scripts/agent-planning-turn-deadline-tests.js

@@ -2,221 +2,137 @@ import assert from 'node:assert/strict';
 import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { installTurnDeadline, TURN_DEADLINE_EXHAUSTED, TURN_DEADLINE_HANDOFF, TURN_HANDOFF_SCHEMA, writeTurnHandoffTicket } from '../src/turn-deadline.js';
-const success = ()=>({
-        isError: false,
-        value: null,
-        content: []
-    });
+import { installTurnDeadline, TURN_DEADLINE_EXHAUSTED, TURN_DEADLINE_HANDOFF, TURN_HANDOFF_SCHEMA, writeTurnHandoffTicket, } from '../src/turn-deadline.js';
+const success = () => ({ isError: false, value: null, content: [] });
 const handlers = new Map();
 const restricted = [];
 const lifted = [];
-const makeAgent = (id)=>({
-        id,
-        ctx: {
-            tools: {
-                restrict (filter) {
-                    restricted.push({
-                        agentId: id,
-                        deny: [
-                            ...filter.deny
-                        ]
-                    });
-                    return ()=>lifted.push(id);
-                }
-            }
-        }
-    });
+const makeAgent = (id) => ({
+    id,
+    ctx: {
+        tools: {
+            restrict(filter) {
+                restricted.push({ agentId: id, deny: [...filter.deny] });
+                return () => lifted.push(id);
+            },
+        },
+    },
+});
 const ctx = {
     tools: {
-        schemas: ()=>[
-                {
-                    name: 'gotry_alpha'
-                },
-                {
-                    name: 'gotry_beta'
-                }
-            ]
+        schemas: () => [{ name: 'gotry_alpha' }, { name: 'gotry_beta' }],
     },
-    on (event, listener) {
+    on(event, listener) {
         const bucket = handlers.get(event) ?? [];
         bucket.push(listener);
         handlers.set(event, bucket);
-        return ()=>{};
-    }
+        return () => { };
+    },
 };
+// Product-path opt-out: `enabled: false` must install nothing.
 const productCtx = {
-    tools: {
-        schemas: ()=>[]
-    },
-    on (event) {
+    tools: { schemas: () => [] },
+    on(event) {
         throw new Error(`opt-out path must not subscribe to ${event}`);
-    }
+    },
 };
-installTurnDeadline(productCtx, {
-    enabled: false
-});
-const clock = (()=>{
+installTurnDeadline(productCtx, { enabled: false });
+const clock = (() => {
     let t = 1_000_000;
-    return {
-        now: ()=>t,
-        advance: (ms)=>{
-            t += ms;
-        }
-    };
+    return { now: () => t, advance: (ms) => { t += ms; } };
 })();
 const handoffRoot = mkdtempSync(join(tmpdir(), 'gotry-turn-handoff-tests-'));
-installTurnDeadline(ctx, {
-    stateRoot: handoffRoot,
-    now: clock.now
-});
+installTurnDeadline(ctx, { stateRoot: handoffRoot, now: clock.now });
 const execute = handlers.get('tools/execute')?.[0];
 const postExecute = handlers.get('tools/post-execute')?.[0];
 const sessionEvent = handlers.get('session/event')?.[0];
 const sessionDisposed = handlers.get('session/disposed')?.[0];
 assert.ok(execute && postExecute && sessionEvent && sessionDisposed, 'all Cordis boundary hooks register');
-const userMessage = (id, text, kind = 'user')=>sessionEvent({
-        id
-    }, {
-        type: 'user/message',
-        data: {
-            source: {
-                kind
-            },
-            content: [
-                {
-                    type: 'text',
-                    text
-                }
-            ]
-        }
-    });
-const turnEvent = (id, type)=>sessionEvent({
-        id
-    }, {
-        type
-    });
+// dsh 事件载荷在 event.data 下(与 benchmark-agent-conformance 同型)。
+const userMessage = (id, text, kind = 'user') => sessionEvent({ id }, { type: 'user/message', data: { source: { kind }, content: [{ type: 'text', text }] } });
+const turnEvent = (id, type) => sessionEvent({ id }, { type });
+// Agent-less calls are programmatic control-plane calls, not planner spend.
 {
     let directBodies = 0;
-    for(let i = 0; i < 5; i++){
-        const result = await execute({
-            token: Symbol(`direct-${i}`)
-        }, async ()=>{
-            directBodies++;
-            return success();
-        });
+    for (let i = 0; i < 5; i++) {
+        const result = await execute({ token: Symbol(`direct-${i}`) }, async () => { directBodies++; return success(); });
         assert.equal(result.isError, false);
     }
     assert.equal(directBodies, 5);
-}{
+}
+// ---- converge 路径:sync-planning 消息,软提示 + 硬阈结构化拒绝 ----------------
+{
     const agent = makeAgent('agent-converge');
     turnEvent(agent.id, 'turn/start');
     userMessage(agent.id, '帮我看看10.1去杭州的高铁票');
     {
-        const exec = {
-            token: Symbol('conv-1'),
-            agent
-        };
-        const result = await execute(exec, async ()=>success());
-        const post = await postExecute(exec, result, async ()=>({
-                kind: 'accept'
-            }));
+        const exec = { token: Symbol('conv-1'), agent };
+        const result = await execute(exec, async () => success());
+        const post = await postExecute(exec, result, async () => ({ kind: 'accept' }));
         assert.equal(result.isError, false);
         assert.equal((post.additionalContexts ?? []).length, 0, 'no convergence context before soft');
         assert.equal(restricted.length, 0);
     }
+    // 推进超过软阈(sync-planning 300s):post-execute 注入 TURN_DEADLINE_SOFT
     clock.advance(300_001);
     {
-        const exec = {
-            token: Symbol('conv-2'),
-            agent
-        };
-        const result = await execute(exec, async ()=>success());
-        const post = await postExecute(exec, result, async ()=>({
-                kind: 'accept'
-            }));
-        const contextText = post.additionalContexts?.flatMap((item)=>item.content ?? []).map((item)=>item.text ?? '').join('\n') ?? '';
+        const exec = { token: Symbol('conv-2'), agent };
+        const result = await execute(exec, async () => success());
+        const post = await postExecute(exec, result, async () => ({ kind: 'accept' }));
+        const contextText = post.additionalContexts?.flatMap(item => item.content ?? []).map(item => item.text ?? '').join('\n') ?? '';
         assert.ok(contextText.includes('TURN_DEADLINE_SOFT'), 'soft context after crossing softMs');
         assert.ok(contextText.includes('final answer'), 'converge soft text asks for a final answer');
     }
+    // 推进超过硬阈(600s):结构化拒绝 + 同步抑制 schema,不落任何工单
     clock.advance(300_000);
     {
-        const exec = {
-            token: Symbol('conv-3'),
-            agent
-        };
+        const exec = { token: Symbol('conv-3'), agent };
         let bodyRan = false;
-        const result = await execute(exec, async ()=>{
-            bodyRan = true;
-            return success();
-        });
+        const result = await execute(exec, async () => { bodyRan = true; return success(); });
         assert.equal(bodyRan, false);
         assert.equal(result.isError, true);
-        assert.deepEqual(result.error?.info, {
-            name: 'TurnDeadlineError',
-            code: TURN_DEADLINE_EXHAUSTED
-        });
+        assert.deepEqual(result.error?.info, { name: 'TurnDeadlineError', code: TURN_DEADLINE_EXHAUSTED });
         assert.match(result.content[0]?.text ?? '', /TURN_DEADLINE_EXHAUSTED/);
     }
-    assert.deepEqual(restricted.at(-1), {
-        agentId: agent.id,
-        deny: [
-            'gotry_alpha',
-            'gotry_beta'
-        ]
-    });
+    assert.deepEqual(restricted.at(-1), { agentId: agent.id, deny: ['gotry_alpha', 'gotry_beta'] });
     const convergeTicketDir = join(handoffRoot, 'gotry-state', 'turn-handoffs');
     assert.equal(existsSync(convergeTicketDir) ? readdirSync(convergeTicketDir).length : 0, 0, 'converge writes no ticket');
     turnEvent(agent.id, 'turn/end');
     assert.equal(lifted.at(-1), agent.id);
-}{
+}
+// ---- handoff 路径:deep-planning 消息(失败轨迹原文)→ 落单转后台 -----------
+{
     const agent = makeAgent('agent-handoff');
     turnEvent(agent.id, 'turn/start');
-    const deepMessage = '2026年我还有6天IRW额度 ,我准备再请几天假,在国内待个十几天。' + '其中10.3要去湖南衡阳参加同学婚礼。其他我没有特别的要求,请根据我的实际情况,偏好,外部环境等因素,给我安排行程';
+    const deepMessage = '2026年我还有6天IRW额度 ,我准备再请几天假,在国内待个十几天。'
+        + '其中10.3要去湖南衡阳参加同学婚礼。其他我没有特别的要求,请根据我的实际情况,偏好,外部环境等因素,给我安排行程';
     userMessage(agent.id, deepMessage);
+    // 软阈(deep 120s):提示语义是「收尾摸底、即将转后台」
     clock.advance(120_001);
     {
-        const exec = {
-            token: Symbol('hand-1'),
-            agent
-        };
-        const result = await execute(exec, async ()=>success());
-        const post = await postExecute(exec, result, async ()=>({
-                kind: 'accept'
-            }));
-        const contextText = post.additionalContexts?.flatMap((item)=>item.content ?? []).map((item)=>item.text ?? '').join('\n') ?? '';
+        const exec = { token: Symbol('hand-1'), agent };
+        const result = await execute(exec, async () => success());
+        const post = await postExecute(exec, result, async () => ({ kind: 'accept' }));
+        const contextText = post.additionalContexts?.flatMap(item => item.content ?? []).map(item => item.text ?? '').join('\n') ?? '';
         assert.ok(contextText.includes('background planning'), 'handoff soft text announces the handoff');
         assert.equal(result.isError, false);
     }
+    // 硬阈(240s):TURN_DEADLINE_HANDOFF 结构化结果 + 工单落盘
     clock.advance(120_000);
     {
-        const exec = {
-            token: Symbol('hand-2'),
-            agent
-        };
+        const exec = { token: Symbol('hand-2'), agent };
         let bodyRan = false;
-        const result = await execute(exec, async ()=>{
-            bodyRan = true;
-            return success();
-        });
+        const result = await execute(exec, async () => { bodyRan = true; return success(); });
         assert.equal(bodyRan, false);
         assert.equal(result.isError, true);
-        assert.deepEqual(result.error?.info, {
-            name: 'TurnDeadlineHandoff',
-            code: TURN_DEADLINE_HANDOFF
-        });
+        assert.deepEqual(result.error?.info, { name: 'TurnDeadlineHandoff', code: TURN_DEADLINE_HANDOFF });
         const text = result.content[0]?.text ?? '';
         assert.match(text, /TURN_DEADLINE_HANDOFF/);
         assert.match(text, /th-/, 'result names the persisted ticket id');
         assert.match(text, /约 1 小时/, 'ETA label mirrors the S5 promise');
     }
-    assert.deepEqual(restricted.at(-1), {
-        agentId: agent.id,
-        deny: [
-            'gotry_alpha',
-            'gotry_beta'
-        ]
-    });
+    // 同步抑制已生效
+    assert.deepEqual(restricted.at(-1), { agentId: agent.id, deny: ['gotry_alpha', 'gotry_beta'] });
     const tickets = readdirSync(join(handoffRoot, 'gotry-state', 'turn-handoffs'));
     assert.equal(tickets.length, 1, 'exactly one handoff ticket');
     const ticket = JSON.parse(readFileSync(join(handoffRoot, 'gotry-state', 'turn-handoffs', tickets[0]), 'utf8'));
@@ -225,38 +141,36 @@ const turnEvent = (id, type)=>sessionEvent({
     assert.equal(ticket.userMessage, deepMessage, 'ticket carries the verbatim user ask');
     assert.ok(ticket.requestedAt);
     assert.equal(ticket.etaLabel, '约 1 小时');
+    // 新 user 消息 = 新预算:同 agent 下一轮 quick 消息恢复放行
     turnEvent(agent.id, 'turn/end');
     userMessage(agent.id, '你好');
     {
-        const result = await execute({
-            token: Symbol('hand-3'),
-            agent
-        }, async ()=>success());
+        const result = await execute({ token: Symbol('hand-3'), agent }, async () => success());
         assert.equal(result.isError, false);
     }
     turnEvent(agent.id, 'turn/end');
     assert.equal(readdirSync(join(handoffRoot, 'gotry-state', 'turn-handoffs')).length, 1, 'no extra tickets');
-}{
+}
+// ---- 路由输入纪律:plugin 注入的 user/message 不参与路由 --------------------
+{
     const agent = makeAgent('agent-plugin-msg');
     turnEvent(agent.id, 'turn/start');
     userMessage(agent.id, '你好');
+    // plugin 注入的深规划文本不得翻转预算
     userMessage(agent.id, deepPlanningNoise(), 'plugin');
     clock.advance(1_000_000);
     {
-        const exec = {
-            token: Symbol('plug-1'),
-            agent
-        };
-        const result = await execute(exec, async ()=>success());
-        assert.deepEqual(result.error?.info, {
-            name: 'TurnDeadlineError',
-            code: TURN_DEADLINE_EXHAUSTED
-        });
+        const exec = { token: Symbol('plug-1'), agent };
+        const result = await execute(exec, async () => success());
+        // quick 硬阈 180s 已被跨过 → converge 拒绝(而非 handoff):证明路由未被 plugin 消息改写
+        assert.deepEqual(result.error?.info, { name: 'TurnDeadlineError', code: TURN_DEADLINE_EXHAUSTED });
     }
     turnEvent(agent.id, 'turn/end');
-}function deepPlanningNoise() {
+}
+function deepPlanningNoise() {
     return '系统提醒样例:10.3 婚礼 IRW 请假 十几天 安排行程——这是插件注入,不该参与路由';
 }
+// ---- 工单写入器(独立契约:原子写 + 目录形态) ------------------------------
 {
     const root = mkdtempSync(join(tmpdir(), 'gotry-turn-handoff-writer-'));
     const ticket = await writeTurnHandoffTicket(root, '短消息');
@@ -264,18 +178,8 @@ const turnEvent = (id, type)=>sessionEvent({
     assert.equal(readdirSync(dir).length, 1);
     const loaded = JSON.parse(readFileSync(join(dir, `${ticket.id}.json`), 'utf8'));
     assert.equal(loaded.userMessage, '短消息');
-    rmSync(root, {
-        recursive: true,
-        force: true
-    });
-}sessionDisposed({
-    id: 'agent-handoff'
-});
-rmSync(handoffRoot, {
-    recursive: true,
-    force: true
-});
+    rmSync(root, { recursive: true, force: true });
+}
+sessionDisposed({ id: 'agent-handoff' });
+rmSync(handoffRoot, { recursive: true, force: true });
 console.log('agent turn deadline tests: OK (routing→converge/handoff exits, ticket persistence, plugin-message discipline, lifecycle)');
-
-
-//# sourceURL=ts/scripts/agent-planning-turn-deadline-tests.ts

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

@@ -1,54 +1,44 @@
+/**
+ * agent-reach 深度能力层测试(yt-dlp + gh,系统装了就调,没装降级):
+ *  1. yt-dlp:无论装没装,三值之一(found/not-installed/error)且不抛错
+ *  2. gh 搜索:gh 已装的环境真实搜 agent-reach;未装环境走 not-installed
+ *  3. 证据链标注含 [agent-reach:<bin>@
+ *  4. 超时降级
+ *
+ * 运行: cd ts && npx tsx scripts/agent-reach-deep-tests.ts
+ */
 import assert from 'node:assert/strict';
 import { videoSubtitle, githubSearch } from '../capabilities/agent-reach-deep.js';
+// 1. yt-dlp 三值
 {
-    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}`);
+    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));
+}
+// 2. gh 搜索(装了就真实搜,没装走 not-installed)
+{
+    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 {
+    }
+    else {
         console.log(`2. gh search → ${r.verdict} (${r.stderr?.slice(0, 60)}) OK`);
     }
-}{
-    const r = await githubSearch({
-        query: 'hello'
-    });
+}
+// 3. 证据链格式
+{
+    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));
+}
+// 4. 超时降级(1ms timeout)
+{
+    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=ts/scripts/agent-reach-deep-tests.ts
+}
+console.log('\nAGENT-REACH DEEP TESTS: 4/4 OK(yt-dlp/gh 可选工具,不装则降级)');

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

@@ -1,38 +1,46 @@
+/**
+ * agent-reach web 读取(readUrl 薄壳)测试:
+ *  readUrl = URL 校验 + 委托上游 WebChannel.read(反射桥) + Title 提取,自身无网络实现。
+ *  上游真读已在 §15 wrapper 测试覆盖;本套只测薄壳行为:
+ *  1. 非法 URL(不带 http) → 拒绝,不抛错,降级返回(离线确定性)
+ *  2. 1ms 超时 → 桥被杀,降级 error(离线确定性)
+ *  3. live 读 example.com → 成功时断言 Title/证据链;网络边界允许降级(不抛错)
+ *
+ * 运行: cd ts && npx tsx scripts/agent-reach-tests.ts
+ */
 import assert from 'node:assert/strict';
 import { readUrl } from '../capabilities/agent-reach.js';
+// 1. 非法 URL(不带 scheme)
 {
-    const r = await readUrl({
-        url: 'example.com'
-    });
+    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
-    });
+}
+// 2. 超时(1ms 杀掉反射桥进程)
+{
+    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
-    });
+}
+// 3. live 读 example.com(上游 Jina Reader;网络边界允许降级)
+{
+    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 非空');
+        // live 内容会漂移(example.com 经 Jina 的 Title 曾从 Example Domain 变 Test Document),
+        // 断言结构(非空标题被提取)而非精确文案
         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 {
+    }
+    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=ts/scripts/agent-reach-tests.ts
+}
+console.log('\nAGENT-REACH TESTS: 3/3 OK(readUrl 薄壳;上游真读见 wrapper 套)');

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

@@ -1,5 +1,19 @@
+/**
+ * agent-reach wrapper 测试(零渠道知识,全部走反射桥):
+ *  1. status: 真 agent-reach doctor 透传(via=agent-reach-cli)
+ *  2. web.read: 真读 example.com(上游 Jina Reader 后端)
+ *  3. v2ex.get_hot_topics: 上游 python 方法真调(网络边界允许降级)
+ *  4. xueqiu.get_stock_quote: 无 cookie → needs-setup 且 setup=上游 check() 原话
+ *  5. 未知渠道 → 自描述错误带回上游渠道清单
+ *  6. 未知方法 → 自描述错误带回上游方法签名清单
+ *  7. 永不抛错: 空 channel/method 降级
+ *
+ * 运行: cd ts && npx tsx scripts/agent-reach-wrapper-tests.ts
+ */
 import assert from 'node:assert/strict';
 import { reach, reachStatus } from '../capabilities/agent-reach.js';
+// 1. status(真 doctor 原样透传;agent-reach 未装时结构化 SKIP——真集成面设备绑定,
+//    与 §17 skills-contract「有凭证真校验,离线 SKIP」同构;CI 装了则全跑 7 断言)
 {
     const st = await reachStatus(90_000);
     if (!st.ok) {
@@ -10,74 +24,56 @@ import { reach, reachStatus } from '../capabilities/agent-reach.js';
     assert.equal(st.via, 'agent-reach-cli');
     assert.ok(st.output.length > 50, 'doctor 输出非空(上游原样)');
     console.log(`1. status → doctor 透传 (${st.latencyMs}ms) OK`);
-}{
-    const r = await reach({
-        channel: 'web',
-        method: 'read',
-        args: [
-            'https://example.com'
-        ],
-        timeoutMs: 30_000
-    });
+}
+// 2. web.read(上游 WebChannel.read → Jina Reader)
+{
+    const r = await reach({ channel: 'web', method: 'read', args: ['https://example.com'], timeoutMs: 30_000 });
     assert.equal(r.verdict, 'found');
     assert.ok(r.evidence.includes('[agent-reach:web.read@'), '证据链 [agent-reach:web.read@ts]');
+    // live 内容会漂移(同 §13),断言非空 markdown 而非精确文案
     assert.ok(typeof r.data === 'string' && r.data.length > 200, 'content 非空 markdown');
     console.log(`2. web.read example.com → found (${r.latencyMs}ms) OK`);
-}{
-    const r = await reach({
-        channel: 'v2ex',
-        method: 'get_hot_topics',
-        timeoutMs: 30_000
-    });
+}
+// 3. v2ex.get_hot_topics(上游 python 方法;网络边界允许降级不抛错)
+{
+    const r = await reach({ channel: 'v2ex', method: 'get_hot_topics', timeoutMs: 30_000 });
     if (r.ok) {
         assert.ok(Array.isArray(r.data), 'hot topics 是数组');
         console.log(`3. v2ex.get_hot_topics → found (${r.data.length} topics) OK`);
-    } else {
-        assert.ok([
-            'error',
-            'needs-setup'
-        ].includes(r.verdict), '降级合法');
+    }
+    else {
+        assert.ok(['error', 'needs-setup'].includes(r.verdict), '降级合法');
         console.log(`3. v2ex.get_hot_topics → ${r.verdict}(网络边界,降级合法) OK`);
     }
-}{
-    const r = await reach({
-        channel: 'xueqiu',
-        method: 'get_stock_quote',
-        args: [
-            'SH600519'
-        ],
-        timeoutMs: 30_000
-    });
+}
+// 4. xueqiu.get_stock_quote(无 cookie → needs-setup 且 setup 是上游 check() 原话)
+{
+    const r = await reach({ channel: 'xueqiu', method: 'get_stock_quote', args: ['SH600519'], timeoutMs: 30_000 });
     assert.equal(r.verdict, 'needs-setup', `实际 verdict=${r.verdict} error=${r.error}`);
     assert.ok((r.setup ?? '').includes('configure'), 'setup 透传上游 configure 指引(不转述)');
     console.log('4. xueqiu.get_stock_quote → needs-setup(上游原话指引) OK');
-}{
-    const r = await reach({
-        channel: 'nosuch',
-        method: 'foo'
-    });
+}
+// 5. 未知渠道 → 自描述,带回上游渠道清单
+{
+    const r = await reach({ channel: 'nosuch', method: 'foo' });
     assert.equal(r.ok, false);
-    const channels = r.inventory?.channels ?? {};
+    const channels = (r.inventory?.channels ?? {});
     assert.ok(channels.web && channels.xueqiu && channels['exa_search'], 'inventory 带回上游注册表(含 exa_search 真名)');
     console.log(`5. 未知渠道 → 自描述清单(${Object.keys(channels).length} 渠道) OK`);
-}{
-    const r = await reach({
-        channel: 'web',
-        method: 'nosuch'
-    });
+}
+// 6. 未知方法 → 自描述,带回上游方法签名清单
+{
+    const r = await reach({ channel: 'web', method: 'nosuch' });
     assert.equal(r.ok, false);
-    const methods = r.inventory?.methods ?? {};
+    const methods = (r.inventory?.methods ?? {});
     assert.ok(methods.read, 'inventory.methods 带 read 签名');
     console.log(`6. 未知方法 → 自描述清单(${Object.keys(methods).length} 方法) OK`);
-}{
-    const r = await reach({
-        channel: '',
-        method: ''
-    });
+}
+// 7. 永不抛错: 空 channel/method
+{
+    const r = await reach({ channel: '', method: '' });
     assert.equal(r.ok, false);
     assert.equal(r.verdict, 'error');
     console.log('7. 空 channel/method 降级 OK');
-}console.log('\nAGENT-REACH WRAPPER TESTS: 7/7 OK(反射桥 + doctor 透传 + 自描述错误)');
-
-
-//# sourceURL=ts/scripts/agent-reach-wrapper-tests.ts
+}
+console.log('\nAGENT-REACH WRAPPER TESTS: 7/7 OK(反射桥 + doctor 透传 + 自描述错误)');