@gt-fe/eap-runtime 0.0.12 → 0.0.14

package/dist/tool/dev-tool-executor.d.ts

@@ -10,7 +10,7 @@
  * - 其余 → NOT_CONFIGURED
  */
 import { DevMcpExecutor } from './dev-mcp-executor.js';
-import type { IToolExecutor, ToolCallRequest, ToolCallResult } from './tool-executor.interface.js';
+import type { IToolExecutor, McpListedTool, ToolCallRequest, ToolCallResult } from './tool-executor.interface.js';
 export interface DevToolExecutorOptions {
     mcp?: ConstructorParameters<typeof DevMcpExecutor>[0];
 }
@@ -20,4 +20,5 @@ export declare class DevToolExecutor implements IToolExecutor {
     private readonly local;
     constructor(options?: DevToolExecutorOptions);
     execute(request: ToolCallRequest): Promise<ToolCallResult>;
+    listTools(request: ToolCallRequest): Promise<McpListedTool[]>;
 }

package/dist/tool/dev-tool-executor.js

@@ -47,6 +47,12 @@ export class DevToolExecutor {
             runtime: 'local',
         };
     }
+    async listTools(request) {
+        if (hasMcpExecution(request.execution)) {
+            return this.mcp.listTools(request);
+        }
+        return [];
+    }
 }
 function hasMcpExecution(raw) {
     if (!raw || typeof raw !== 'object')

package/dist/tool/harness-command.js

@@ -21,7 +21,7 @@ export function commandDialectLines(platform = process.platform) {
     else {
         lines.push('基础命令：当前目录 `pwd`；列目录 `ls`；环境变量 `$VAR`；串命令用 `&&`。');
     }
-    lines.push('解释器：`python`/`python3`、`node`/`nodejs`、`sh`/`bash`（Windows 上 `sh` 需本机有 Git Bash 等）。', '可执行文件：用绝对路径或相对于 cwd（Windows `.exe`/`.bat`/`.cmd`；Unix 二进制需可执行或用 `sh`）。', '`execute_command` 的 cwd 是用户目录。技能包只读。包内任意文件用 `EAP_SKILL_DIR` 加相对路径（不限 `scripts/`）。读到的 SKILL.md 里像脚本的相对路径已展开为绝对路径。不要把 cwd 设成技能目录。相对写出在用户目录。');
+    lines.push('解释器：`python`/`python3`、`node`/`nodejs`、`sh`/`bash`（Windows 上 `sh` 需本机有 Git Bash 等）。', '可执行文件：用绝对路径或相对于 cwd（Windows `.exe`/`.bat`/`.cmd`；Unix 二进制需可执行或用 `sh`）。', '`execute_command` 的 cwd 是用户目录。技能包只读。包内任意文件用 `EAP_SKILL_DIR` 加相对路径（不限 `scripts/`）。读到的 SKILL.md 里本包存在的相对路径已展开为绝对路径。不要把 cwd 设成技能目录。相对写出在用户目录。');
     return lines;
 }
 export function resolveShellSpawn(command, platform = process.platform) {

package/dist/tool/harness-primitives.d.ts

@@ -34,6 +34,13 @@ export declare function resolveJailFromState(state: {
 export declare function resolveJailRoots(options?: HarnessJailOptions): string[];
 /** 路径落在写根外的 extraRoot 时，返回该 extraRoot。 */
 export declare function extraRootContaining(abs: string, extraRoots: string[], workdir: string): string | undefined;
+/**
+ * 相对 read_file：`技能名/文件`、全库唯一命中、显式 skillDir，否则用户目录。
+ */
+export declare function locateSkillRelativeRead(filePath: string, workdir: string | undefined, skillDir: string | undefined, extraRoots?: string[]): {
+    path: string;
+    relativeBase: string | undefined;
+};
 export declare function resolveJailedPath(requested: string, roots: string[], opts?: {
     mustExist?: boolean;
     relativeBase?: string;

package/dist/tool/harness-primitives.js

@@ -8,10 +8,10 @@
  * 开发态可选 overlay：`EAP_LOCAL_SKILLS_DIR` / `EAP_LOCAL_TOOLS_DIR`（只读）。
  */
 import { spawn } from 'node:child_process';
-import { constants as fsConstants, realpathSync } from 'node:fs';
+import { constants as fsConstants, existsSync, realpathSync } from 'node:fs';
 import { mkdir, open, readFile } from 'node:fs/promises';
 import path from 'node:path';
-import { BUILTIN_TOOL_SOURCE, DEFAULT_BUILTIN_TIMEOUT_MS, MAX_BUILTIN_TIMEOUT_MS, clampBuiltinTimeout, isBuiltinToolExecution, resolveBuiltinToolsConfig, } from '@gt-fe/eap-contracts';
+import { BUILTIN_TOOL_SOURCE, DEFAULT_BUILTIN_TIMEOUT_MS, MAX_BUILTIN_TIMEOUT_MS, clampBuiltinTimeout, isBuiltinToolExecution, resolveBuiltinToolsConfig, } from '@eap/contracts';
 import { ensureInterpreterShims, formatSpawnError, killProcessTree, resolveShellSpawn, sandboxEnv, spawnOptionsFor, substituteSkillDir, } from './harness-command.js';
 import { expandSkillScriptRefs, isSkillEntryFile } from './skill-script-refs.js';
 function builtinConfig() {
@@ -252,6 +252,53 @@ function resolveViaExistingAncestor(abs) {
         cur = parent;
     }
 }
+function userReadBase(workdir) {
+    return workdir?.trim()
+        ? (tryRealpath(path.resolve(workdir)) ?? path.resolve(workdir))
+        : undefined;
+}
+function skillPackageRoots(roots) {
+    const out = [];
+    const seen = new Set();
+    for (const root of roots) {
+        const resolved = path.resolve(root);
+        if (seen.has(resolved))
+            continue;
+        seen.add(resolved);
+        if (existsSync(path.join(resolved, 'SKILL.md')) || existsSync(path.join(resolved, 'skill.md'))) {
+            out.push(resolved);
+        }
+    }
+    return out;
+}
+/**
+ * 相对 read_file：`技能名/文件`、全库唯一命中、显式 skillDir，否则用户目录。
+ */
+export function locateSkillRelativeRead(filePath, workdir, skillDir, extraRoots) {
+    const trimmed = filePath.trim();
+    const userBase = userReadBase(workdir);
+    if (!trimmed || path.isAbsolute(trimmed))
+        return { path: trimmed, relativeBase: userBase };
+    const packages = skillPackageRoots([
+        ...(skillDir?.trim() ? [skillDir] : []),
+        ...(extraRoots ?? []),
+    ]);
+    const slash = trimmed.replace(/\\/g, '/');
+    const segs = slash.split('/').filter(Boolean);
+    if (segs.length >= 2) {
+        const hit = packages.find((pkg) => path.basename(pkg) === segs[0]);
+        if (hit)
+            return { path: segs.slice(1).join('/'), relativeBase: hit };
+    }
+    const matches = packages.filter((pkg) => existsSync(path.resolve(pkg, trimmed)));
+    if (matches.length === 1)
+        return { path: trimmed, relativeBase: matches[0] };
+    const skillBase = skillDir?.trim() ? path.resolve(skillDir) : undefined;
+    if (skillBase && existsSync(path.resolve(skillBase, trimmed))) {
+        return { path: trimmed, relativeBase: skillBase };
+    }
+    return { path: trimmed, relativeBase: userBase };
+}
 export function resolveJailedPath(requested, roots, opts) {
     const trimmed = requested.trim();
     if (!trimmed || trimmed.includes('\0')) {
@@ -344,10 +391,10 @@ export class HarnessPrimitiveExecutor {
     async readFile(request) {
         const filePath = String(request.arguments.path ?? request.arguments.file ?? '');
         const workdir = this.workdirFor(request);
-        const relativeBase = workdir ? (tryRealpath(workdir) ?? path.resolve(workdir)) : undefined;
-        const target = resolveJailedPath(filePath, this.rootsFor(request), {
+        const located = locateSkillRelativeRead(filePath, workdir, request.skillDir, this.extraRootsFor(request));
+        const target = resolveJailedPath(located.path, this.rootsFor(request), {
             mustExist: true,
-            relativeBase,
+            relativeBase: located.relativeBase,
         });
         const buf = await readFile(target);
         const config = builtinConfig();
@@ -481,7 +528,7 @@ export class HarnessPrimitiveExecutor {
 }
 export function withHarnessPrimitives(inner, options) {
     const harness = new HarnessPrimitiveExecutor(options);
-    return {
+    const wrapped = {
         execute(request) {
             if (isBuiltinToolExecution(request.execution)) {
                 return harness.execute(request);
@@ -489,4 +536,8 @@ export function withHarnessPrimitives(inner, options) {
             return inner.execute(request);
         },
     };
+    if (typeof inner.listTools === 'function') {
+        wrapped.listTools = (request) => inner.listTools(request);
+    }
+    return wrapped;
 }

package/dist/tool/http-tool-executor.js

@@ -4,7 +4,7 @@
  * @see docs/contracts/tool-execution.md §2
  * @see docs/contracts/cross-service-api.md §4.6
  */
-import { ErrorCodes } from '@gt-fe/eap-contracts';
+import { ErrorCodes } from '@eap/contracts';
 import { abortOrTimeoutMessage, isAbortError } from './timeout.js';
 function mapGatewayHttpError(status, body, statusText) {
     const code = body?.error?.code;

package/dist/tool/index.d.ts

@@ -1,4 +1,5 @@
-export type { AuthContext, ToolCallRequest, ToolCallResult, LLMToolCall, LLMToolCallResponse, IToolExecutor, } from './tool-executor.interface.js';
+export type { AuthContext, ToolCallRequest, ToolCallResult, LLMToolCall, LLMToolCallResponse, IToolExecutor, McpListedTool, } from './tool-executor.interface.js';
+export { hydrateMcpTools, isMcpDiscoverStub, needsMcpHydration, parseListedTools, } from './mcp-list.js';
 export { toLoadedToolMap, type LoadedToolDefinition, type LoadedToolMap, type LoadedToolManifestRef, } from './loaded-tool-definition.js';
 export { ToolOrchestrator } from './tool-orchestrator.js';
 export { HttpToolExecutor, type HttpToolExecutorOptions, } from './http-tool-executor.js';

package/dist/tool/index.js

@@ -1,3 +1,4 @@
+export { hydrateMcpTools, isMcpDiscoverStub, needsMcpHydration, parseListedTools, } from './mcp-list.js';
 export { toLoadedToolMap, } from './loaded-tool-definition.js';
 export { ToolOrchestrator } from './tool-orchestrator.js';
 export { HttpToolExecutor, } from './http-tool-executor.js';

package/dist/tool/local-mcp-client.d.ts

@@ -2,10 +2,11 @@
  * LocalMcpClient — 桌面本地 MCP 调用（stdio / streamable_http）
  *
  * mcp-data-service 等上游要求 HTTP 头 `userId`（或 query），再注入 `params._meta.userId`。
- * 身份优先来自 Runtime ExecutionContext（Token.sub）；manifest headers.userId 作兜底。
+ * 身份优先来自 Runtime ExecutionContext（Token.sub）；manifest header.userId 作兜底。
  */
-import type { McpRuntimeExecution } from '@gt-fe/eap-contracts';
+import type { McpRuntimeExecution } from '@eap/contracts';
 import { type FileArtifact } from './file-artifact.js';
+import type { McpListedTool } from './tool-executor.interface.js';
 export interface LocalMcpInvokeContext {
     /** Platform Token.sub / ExecutionContext.userId */
     userId?: string | null;
@@ -16,8 +17,10 @@ export interface LocalMcpInvokeResult {
 }
 export interface ILocalMcpClient {
     invoke(execution: McpRuntimeExecution, args: Record<string, unknown>, context?: LocalMcpInvokeContext): Promise<LocalMcpInvokeResult>;
+    list(execution: McpRuntimeExecution, context?: LocalMcpInvokeContext): Promise<McpListedTool[]>;
 }
 export declare function formatMcpOutput(result: unknown): string;
 export declare class LocalMcpClient implements ILocalMcpClient {
     invoke(execution: McpRuntimeExecution, args: Record<string, unknown>, context?: LocalMcpInvokeContext): Promise<LocalMcpInvokeResult>;
+    list(execution: McpRuntimeExecution, context?: LocalMcpInvokeContext): Promise<McpListedTool[]>;
 }

package/dist/tool/local-mcp-client.js

@@ -2,12 +2,13 @@
  * LocalMcpClient — 桌面本地 MCP 调用（stdio / streamable_http）
  *
  * mcp-data-service 等上游要求 HTTP 头 `userId`（或 query），再注入 `params._meta.userId`。
- * 身份优先来自 Runtime ExecutionContext（Token.sub）；manifest headers.userId 作兜底。
+ * 身份优先来自 Runtime ExecutionContext（Token.sub）；manifest header.userId 作兜底。
  */
 import { spawn } from 'node:child_process';
 import readline from 'node:readline';
 import { isAbortError, resolveToolTimeoutSec, toToolTimeoutMs, toolTimeoutErrorMessage, } from './timeout.js';
 import { fileArtifactFromToolOutput, fileBasesFromEnv } from './file-artifact.js';
+import { nextListCursor, parseListedTools } from './mcp-list.js';
 export function formatMcpOutput(result) {
     const r = result;
     if (r?.structuredContent !== undefined) {
@@ -53,7 +54,7 @@ function expandEnvRefs(value) {
     return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_match, name) => process.env[name] ?? '');
 }
 function resolveUserId(_execution, context) {
-    // 仅用调用期身份（Token/ExecutionContext）；禁止依赖 manifest 静态 headers.userId
+    // 仅用调用期身份（Token/ExecutionContext）；禁止依赖 manifest 静态 header.userId
     const fromCtx = context?.userId?.trim();
     return fromCtx || undefined;
 }
@@ -142,6 +143,61 @@ async function invokeStdio(execution, args, context) {
         rl.close();
     }
 }
+async function listStdio(execution, context) {
+    const { server } = execution;
+    const command = server.command ?? 'node';
+    const spawnArgs = server.args ?? [];
+    const timeoutMs = toToolTimeoutMs(execution.timeout);
+    const userId = resolveUserId(execution, context);
+    const child = spawn(command, spawnArgs, {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        cwd: server.cwd,
+        env: {
+            ...process.env,
+            ...server.env,
+            ...(userId ? { EAP_MCP_USER_ID: userId } : {}),
+        },
+    });
+    const session = {
+        process: child,
+        nextId: 1,
+        pending: new Map(),
+        timeoutMs,
+    };
+    const rl = readline.createInterface({ input: child.stdout });
+    rl.on('line', (line) => {
+        if (!line.trim())
+            return;
+        try {
+            const msg = JSON.parse(line);
+            if (msg.id == null)
+                return;
+            const p = session.pending.get(msg.id);
+            if (!p)
+                return;
+            session.pending.delete(msg.id);
+            if (msg.error)
+                p.reject(new Error(msg.error.message));
+            else
+                p.resolve(msg.result);
+        }
+        catch {
+            /* ignore */
+        }
+    });
+    try {
+        await rpcStdio(session, 'initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'eap-runtime-local', version: '0.1.0' },
+        });
+        return await collectListedTools((params) => rpcStdio(session, 'tools/list', params));
+    }
+    finally {
+        child.kill();
+        rl.close();
+    }
+}
 async function postMcp(url, headers, payload, signal) {
     const response = await fetch(url, {
         method: 'POST',
@@ -171,7 +227,7 @@ async function invokeStreamableHttp(execution, args, context) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeoutMs);
     const userId = resolveUserId(execution, context);
-    const rawHeaders = execution.server.headers ?? {};
+    const rawHeaders = execution.server.header ?? {};
     const expandedHeaders = {};
     for (const [key, value] of Object.entries(rawHeaders)) {
         expandedHeaders[key] = expandEnvRefs(value);
@@ -219,6 +275,61 @@ async function invokeStreamableHttp(execution, args, context) {
         clearTimeout(timer);
     }
 }
+async function listStreamableHttp(execution, context) {
+    const url = expandEnvRefs(execution.server.url);
+    if (!url) {
+        throw new Error('streamable_http MCP requires server.url');
+    }
+    const timeoutSec = resolveToolTimeoutSec(execution.timeout);
+    const timeoutMs = toToolTimeoutMs(timeoutSec);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const userId = resolveUserId(execution, context);
+    const rawHeaders = execution.server.header ?? {};
+    const expandedHeaders = {};
+    for (const [key, value] of Object.entries(rawHeaders)) {
+        expandedHeaders[key] = expandEnvRefs(value);
+    }
+    const headers = {
+        'Content-Type': 'application/json',
+        Accept: 'application/json, text/event-stream',
+        ...expandedHeaders,
+    };
+    if (userId) {
+        headers.userId = userId;
+    }
+    try {
+        const init = await postMcp(url, headers, {
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'initialize',
+            params: {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'eap-runtime-local', version: '0.1.0' },
+            },
+        }, controller.signal);
+        const listHeaders = { ...headers };
+        if (init.sessionId)
+            listHeaders['mcp-session-id'] = init.sessionId;
+        let nextId = 2;
+        return await collectListedTools(async (params) => {
+            const listed = await postMcp(url, listHeaders, { jsonrpc: '2.0', id: nextId++, method: 'tools/list', params }, controller.signal);
+            return listed.body.result;
+        });
+    }
+    catch (err) {
+        if (isAbortError(err)) {
+            const timeoutErr = new Error(toolTimeoutErrorMessage(timeoutSec));
+            timeoutErr.name = 'TimeoutError';
+            throw timeoutErr;
+        }
+        throw err instanceof Error ? err : new Error(String(err));
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 function parseMcpHttpBody(raw) {
     const trimmed = raw.trim();
     if (trimmed.startsWith('{')) {
@@ -244,6 +355,22 @@ export class LocalMcpClient {
         }
         return invokeStdio(execution, args, context);
     }
+    async list(execution, context) {
+        if (execution.transport === 'streamable_http') {
+            return listStreamableHttp(execution, context);
+        }
+        return listStdio(execution, context);
+    }
+}
+async function collectListedTools(rpcList) {
+    const tools = [];
+    let cursor;
+    do {
+        const result = await rpcList(cursor ? { cursor } : {});
+        tools.push(...parseListedTools(result));
+        cursor = nextListCursor(result);
+    } while (cursor);
+    return tools;
 }
 function toInvokeResult(raw, serverEnv) {
     const structured = (raw && typeof raw === 'object' && !Array.isArray(raw))

package/dist/tool/local-tool-executor.d.ts

@@ -4,8 +4,8 @@
  * 优先 ILocalToolInstallStore；若无安装记录但 request.execution 带
  * 或 request.execution 带可解析的 code bundlePath+handler，则直接本机执行。
  */
-import type { ILocalToolInstallStore } from '@gt-fe/eap-contracts';
-import type { IToolExecutor, ToolCallRequest, ToolCallResult } from './tool-executor.interface.js';
+import type { ILocalToolInstallStore } from '@eap/contracts';
+import type { IToolExecutor, McpListedTool, ToolCallRequest, ToolCallResult } from './tool-executor.interface.js';
 import { type ILocalMcpClient } from './local-mcp-client.js';
 export interface LocalToolExecutorOptions {
     installStore: ILocalToolInstallStore;
@@ -30,6 +30,7 @@ export declare class LocalToolExecutor implements IToolExecutor {
     private readonly mcpClient;
     constructor(options: LocalToolExecutorOptions);
     execute(request: ToolCallRequest): Promise<ToolCallResult>;
+    listTools(request: ToolCallRequest): Promise<McpListedTool[]>;
     private executeCodeSpec;
     private executeCode;
     private executeMcp;

package/dist/tool/local-tool-executor.js

@@ -7,10 +7,11 @@
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
-import { ErrorCodes, resolveReadyInstallByToolName, resolveMcpExecutionFromInstall, resolveCodeHandlerFromInstall, } from '@gt-fe/eap-contracts';
+import { ErrorCodes, resolveReadyInstallByToolName, resolveMcpExecutionFromInstall, resolveCodeHandlerFromInstall, } from '@eap/contracts';
 import { isAbortError, toToolTimeoutMs, toolTimeoutErrorMessage } from './timeout.js';
 import { fileArtifactFromToolOutput, fileBasesFromEnv } from './file-artifact.js';
 import { LocalMcpClient } from './local-mcp-client.js';
+import { normalizeMcpExecution } from './dev-mcp-executor.js';
 /**
  * 根据 execution.runtime 解析执行命令：
  * - node（默认）→ process.execPath + [handlerPath]
@@ -171,6 +172,20 @@ export class LocalToolExecutor {
             runtime: 'local',
         };
     }
+    async listTools(request) {
+        const fromRequest = normalizeMcpExecution(request.execution, request.toolName);
+        if (fromRequest) {
+            return this.mcpClient.list(fromRequest, { userId: request.authContext?.userId });
+        }
+        const install = resolveReadyInstallByToolName(this.options.installStore, request.toolName);
+        if (install && install.installStatus === 'ready' && (install.type ?? request.toolType) === 'mcp') {
+            const execution = resolveMcpExecutionFromInstall(install);
+            if (execution) {
+                return this.mcpClient.list(execution, { userId: request.authContext?.userId });
+            }
+        }
+        throw new Error(`MCP tools/list: no mcp execution for "${request.toolName}"`);
+    }
     async executeCodeSpec(request, spec) {
         try {
             const stdout = await runHandler(spec.handlerPath, request.arguments, spec.timeoutMs ?? this.options.timeoutMs ?? 30_000, { runtime: spec.runtime, args: spec.args });

package/dist/tool/mcp-list.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MCP tools/list 解析、discover stub 判定、hydrate。
+ *
+ * type: mcp 的预装工具集不展开清单 tools[]，先产出 discover stub；
+ * 有 ExecutionContext 后由同一执行器 tools/list，再写入 LLM tools。
+ */
+import type { LoadedToolDefinition, LoadedToolMap } from './loaded-tool-definition.js';
+import type { AuthContext, IToolExecutor, McpListedTool } from './tool-executor.interface.js';
+export declare function parseListedTools(result: unknown): McpListedTool[];
+export declare function nextListCursor(result: unknown): string | undefined;
+export interface McpDiscoverExecution {
+    protocol?: string;
+    discover?: boolean;
+    transport?: string;
+    server?: Record<string, unknown>;
+    timeout?: number;
+    bundlePath?: string;
+    enabledTools?: string[];
+    autoApprove?: string[];
+}
+export declare function readMcpDiscoverExecution(raw: unknown): McpDiscoverExecution | null;
+export declare function isMcpDiscoverStub(def: LoadedToolDefinition): boolean;
+export declare function mcpEndpointKey(execution: unknown, fallback?: string): string;
+export declare const MCP_LIST_TOOL_NAME = "tools/list";
+/** 展示用：`tl-data-035/get_dataset_by_code`；无名工具集则只返回工具名。 */
+export declare function formatToolsetToolName(toolset: string | undefined, toolName: string): string;
+/** 从 hydrate 后的 toolId（`toolset:toolName`）取出工具集编码。 */
+export declare function toolsetCodeFromLoaded(loaded: {
+    toolId?: string;
+    name?: string;
+    manifest?: {
+        id?: string;
+    };
+} | undefined): string | undefined;
+export interface HydrateMcpToolsAuth {
+    authContext: AuthContext;
+    correlationId?: string;
+    taskId?: string;
+    onListFailure?: (failure: {
+        toolset: string;
+        endpoint: string;
+        error: string;
+    }) => void;
+}
+/**
+ * 将 MCP discover stub 替换为 tools/list 结果。
+ * 无 stub 时原样返回（同一引用）。按 endpoint+user+agent 在执行器内缓存 list。
+ * enabledTools 为可选白名单；autoApprove 的子工具 requireConfirmation=false。
+ * 单个 endpoint 的 list 失败只跳过该工具集；全部失败才抛错（错误含工具集名）。
+ */
+export declare function hydrateMcpTools(loadedTools: LoadedToolMap | undefined, executor: IToolExecutor | undefined, auth: HydrateMcpToolsAuth): Promise<LoadedToolMap | undefined>;
+/** 测试与 HITL 续跑：从已 hydrate 的 map 判断是否还要 list */
+export declare function needsMcpHydration(loadedTools: LoadedToolMap | undefined): boolean;