@tencent-ai/agent-sdk 0.3.252 → 0.3.253

package/cli/dist-server/types/node/install/install-errors.d.ts

@@ -1,46 +0,0 @@
-import { CustomError } from '@celljs/core';
-/**
- * Custom error types for installation process
- */
-/**
- * Base class for all installation errors
- */
-export declare class InstallError extends CustomError {
-    constructor(message: string);
-}
-/**
- * Network-related errors (download failures, timeouts, DNS errors)
- */
-export declare class NetworkError extends InstallError {
-    constructor(message?: string);
-}
-/**
- * Permission errors (EACCES, insufficient privileges)
- */
-export declare class PermissionError extends InstallError {
-    constructor(message?: string);
-}
-/**
- * Disk space errors (ENOSPC)
- */
-export declare class DiskSpaceError extends InstallError {
-    constructor(message?: string);
-}
-/**
- * File system errors (file not found, directory not found)
- */
-export declare class FileSystemError extends InstallError {
-    constructor(message?: string);
-}
-/**
- * Version-related errors (version fetch, invalid version)
- */
-export declare class VersionError extends InstallError {
-    constructor(message: string);
-}
-/**
- * Archive extraction errors (corrupted archives, extraction failures)
- */
-export declare class ExtractionError extends InstallError {
-    constructor(message?: string);
-}

package/cli/dist-server/types/node/install/install-protocol.d.ts

@@ -1,83 +0,0 @@
-import type { Event } from '@celljs/core';
-import type { FileSystem } from '@genie/runtime';
-import type { Installation, PackageManager } from '../utils/installation-utils';
-export type { Installation, PackageManager };
-export declare const ReleasesService: unique symbol;
-export interface ReleasesService {
-    getLatestVersion(): Promise<string>;
-    getDownloadUrl(version: string, os: {
-        platform: () => NodeJS.Platform;
-        arch: () => NodeJS.Architecture;
-    }): string;
-}
-/**
- * Progress events emitted during installation
- */
-export type InstallProgressEvent = {
-    type: 'start';
-    version: string;
-} | {
-    type: 'downloading';
-    url: string;
-} | {
-    type: 'extracting';
-    destination: string;
-    skipped?: boolean;
-} | {
-    type: 'installing';
-    location: string;
-    displayLocation: string;
-};
-export declare const InstallEnvironment: unique symbol;
-export interface InstallEnvironment {
-    fs: FileSystem;
-    platform(): NodeJS.Platform;
-    arch(): NodeJS.Architecture;
-    homedir(): string;
-    versiondir(app: string): string;
-    bindir(app: string): string;
-    findCmd(cmd: string): Promise<string | undefined>;
-}
-/**
- * PATH status after installation
- */
-export type PathStatus = {
-    type: 'in-path';
-} | {
-    type: 'needs-refresh';
-    commands: string[];
-} | {
-    type: 'needs-setup';
-    commands: string[];
-};
-export interface InstallOptions {
-    target?: string;
-    force?: boolean;
-    silent?: boolean;
-}
-/**
- * Result of installation operation
- */
-export interface InstallResult {
-    success: boolean;
-    version?: string;
-    location?: string;
-    displayLocation?: string;
-    pathStatus?: PathStatus;
-    error?: string;
-}
-export declare const InstallService: unique symbol;
-export interface InstallService {
-    readonly binary: string;
-    readonly onProgress: Event<InstallProgressEvent>;
-    install(options?: InstallOptions): Promise<InstallResult>;
-    currentInstallation(): Promise<Installation>;
-}
-export type MaybePromise<T> = Promise<T> | T;
-export declare const ShellSetup: unique symbol;
-export interface ShellSetup {
-    readonly name: string;
-    exists(env: InstallEnvironment): MaybePromise<boolean>;
-    envScript(env: InstallEnvironment, bindir: string): string;
-    setup(env: InstallEnvironment, bindir: string): MaybePromise<void>;
-}

package/cli/dist-server/types/node/install/install-service.d.ts

@@ -1,36 +0,0 @@
-import { ConsoleManager } from '../console';
-import { type Installation } from '../utils/installation-utils';
-import type { InstallOptions, InstallProgressEvent, InstallResult } from './install-protocol';
-import { InstallEnvironment, InstallService, ReleasesService, ShellSetup } from './install-protocol';
-export declare class InstallServiceImpl implements InstallService {
-    protected readonly env: InstallEnvironment;
-    protected readonly releases: ReleasesService;
-    protected readonly shellSetups: ShellSetup[];
-    protected readonly consoleManager: ConsoleManager;
-    private readonly onProgressEmitter;
-    readonly onProgress: import("@celljs/core").Event<InstallProgressEvent>;
-    private pathWasAutoSetup;
-    get binary(): string;
-    get binaryExe(): string;
-    get productName(): string;
-    get packageName(): string;
-    install(options?: InstallOptions): Promise<InstallResult>;
-    currentInstallation(): Promise<Installation>;
-    private fetchVersion;
-    private downloadAndExtract;
-    private installBins;
-    private handleInstallError;
-    private getErrorMessage;
-    private getDisplayLocation;
-    private trySetupPath;
-    private setupPathUnix;
-    private setupPathWindows;
-    private getPathStatus;
-    private isBinaryInPath;
-    private getRefreshCommands;
-    private getSetupCommands;
-    /**
-     * Remove old versions to save disk space, keeping the most recent ones
-     */
-    private pruneOldVersions;
-}

package/cli/dist-server/types/node/install/install-utils.d.ts

@@ -1,7 +0,0 @@
-import { Writable } from 'node:stream';
-import { FileSystem } from '@genie/runtime';
-export declare function extractTo(fs: FileSystem, path: string): Writable;
-export declare function unzipTo(fs: FileSystem, path: string): Writable;
-export declare function ensure(fs: FileSystem, ...paths: string[]): Promise<string>;
-export declare function linkOrCopyFile(fs: FileSystem, src: string, dest: string): Promise<void>;
-export declare function makeExecutable(fs: FileSystem, path: string): Promise<void>;

package/cli/dist-server/types/node/install/releases-service.d.ts

@@ -1,18 +0,0 @@
-import { ReleasesService } from './install-protocol';
-interface ReleasesConfig {
-    packageName: string;
-    baseUrl: string;
-    filenamePattern?: (platform: string, arch: string) => string;
-}
-export declare class ReleasesServiceImpl implements ReleasesService {
-    config: ReleasesConfig;
-    /** Fetches latest version from {baseUrl}/latest */
-    getLatestVersion(): Promise<string>;
-    /** Returns download URL for the release artifact */
-    getDownloadUrl(version: string, os: {
-        platform: () => NodeJS.Platform;
-        arch: () => NodeJS.Architecture;
-    }): string;
-    static defaultFilenamePattern(packageName: string, platform: string, arch: string): string;
-}
-export {};

package/cli/dist-server/types/node/install/shell-setup.d.ts

@@ -1,36 +0,0 @@
-import { type InstallEnvironment, ShellSetup } from './install-protocol';
-export declare class PosixSetup implements ShellSetup {
-    get name(): string;
-    exists(): boolean;
-    rcfiles(env: InstallEnvironment): string[];
-    rcsToUpdate(env: InstallEnvironment): string[];
-    envScript(env: InstallEnvironment, bindir: string): string;
-    setup(env: InstallEnvironment, bindir: string): Promise<void>;
-}
-export declare class BashSetup implements ShellSetup {
-    get name(): string;
-    exists(env: InstallEnvironment): Promise<boolean>;
-    rcfiles(env: InstallEnvironment): string[];
-    rcsToUpdate(env: InstallEnvironment): Promise<string[]>;
-    envScript(env: InstallEnvironment, bindir: string): string;
-    setup(env: InstallEnvironment, bindir: string): Promise<void>;
-}
-export declare class ZshSetup implements ShellSetup {
-    get name(): string;
-    exists(env: InstallEnvironment): Promise<boolean>;
-    private getZshDotDir;
-    rcfiles(env: InstallEnvironment): Promise<string[]>;
-    rcsToUpdate(env: InstallEnvironment): Promise<string[]>;
-    envScript(env: InstallEnvironment, bindir: string): string;
-    setup(env: InstallEnvironment, bindir: string): Promise<void>;
-}
-export declare class FishSetup implements ShellSetup {
-    get name(): string;
-    exists(env: InstallEnvironment): Promise<boolean>;
-    envScript(env: InstallEnvironment, bindir: string): string;
-    setup(env: InstallEnvironment, bindir: string): Promise<void>;
-}
-export declare function filterAsync<T>(arr: T[], pred: (v: T) => Promise<boolean>): Promise<T[]>;
-export declare function shellEnvContains(shellName: string): boolean;
-export declare function portablePath(env: InstallEnvironment, path: string): string;
-export declare function getCurrentShellRcFiles(env: InstallEnvironment): Promise<string[]>;

package/cli/dist-server/types/node/mcp/mcp-cancellation.d.ts

@@ -1,65 +0,0 @@
-/**
- * 客户端侧的 MCP 请求取消（`notifications/cancelled`）。
- *
- * MCP 规范：客户端放弃一个已发出的请求时 SHOULD 向 server 发
- * `notifications/cancelled { requestId, reason }`，让 server 有机会终止底层工作
- * （杀子进程、断上游 HTTP、停轮询），而不是把结果算完再交给一个没人接的连接。
- *
- * 发送侧在 `@modelcontextprotocol/sdk` 里已经实现好了：`Protocol.request` 只要
- * 拿到 `RequestOptions.signal`，signal abort 时就会自动发出该通知并 reject 本地
- * Promise（见 SDK `shared/protocol.ts` 的 `cancel()`）。`mcp-server-override` 的
- * `__signal` sideband 也早就把 meta 接到了 `RequestOptions.signal` 上。
- *
- * 缺的只是「谁来喂这个 signal」：此前只有微信支付长轮询显式传 `__signal`，
- * 普通 MCP 工具调用一律不传 —— 用户按停止 / 新一轮取代旧一轮时，在途的
- * `tools/call` 只是被本地静默丢弃，server 侧仍然跑到底。本模块把
- * 「本轮 run 的中断」桥成一个可以安全交给 SDK 的 signal，补上这一环。
- */
-/**
- * `notifications/cancelled.params.reason` 的取值。
- *
- * SDK 用 `String(signal.reason)` 填这个字段，所以这里必须 abort 一个字符串
- * （abort 一个 Error 会得到 `"Error: ..."` 这种带前缀的噪音文案）。
- */
-export declare const MCP_CANCEL_REASON_CLIENT_STOPPED = "Client cancelled the in-flight tool call";
-/** 本模块只需要 Session 的这两个字段，收窄依赖便于单测构造。 */
-export interface McpCancellableSession {
-    abortSignal?: AbortSignal;
-    lastAbortReason?: 'user' | 'internal';
-}
-export interface McpCallCancellation {
-    /**
-     * 交给 `RequestOptions.signal` 的 signal；`undefined` 表示本次调用不接取消线。
-     */
-    readonly signal: AbortSignal | undefined;
-    /**
-     * 摘除挂在 `session.abortSignal` 上的监听器。幂等，**必须**在调用 settle 后执行。
-     *
-     * 一轮 run 里可能发生几十次 MCP 调用，而它们共享同一个 `session.abortSignal`；
-     * 不摘监听器会累积到 Node 的 `MaxListenersExceededWarning`（EventTarget 阈值 10）。
-     */
-    dispose(): void;
-}
-/**
- * 为一次 MCP `tools/call` 派生取消 signal。
- *
- * @param explicitSignal 调用方经 `meta.__signal` 显式传入的 signal（微信支付长轮询）。
- *                       显式传入优先，原样透传，不做任何包装。
- * @param session        当前会话；取 `abortSignal` 作为取消源。
- *
- * 两条刻意的保守规则：
- *
- * 1. **调用开始时 signal 已经 aborted → 不接线**。此时 run 早已结束，拿到的是
- *    上一轮遗留的 controller（`createRunStartupController` 只在下一轮启动时才换新的）。
- *    非 run 路径的调用方（`/mcp` 手动调用、mcp-ui 反向调用）会因此被误判成"已取消"，
- *    把本来能成功的调用打挂。只有「开始时 run 还活着」的在途调用才需要取消语义。
- * 2. **`lastAbortReason === 'internal'` 时不取消**。与 BashTool 同一把尺子
- *    （见 `bash-tool.ts` 的 `onAbort`）：turn 切换 / compact 这类内部流程也会 abort
- *    `session.abortSignal`，但那不代表用户要停掉这个工具。未显式标记时按 `'user'`
- *    处理，保持既有语义。
- */
-export declare function createMcpCallCancellation(explicitSignal: AbortSignal | undefined, session: McpCancellableSession | undefined): McpCallCancellation;
-/**
- * 该次调用是否由我们主动取消（用于把"用户取消"与"server 真失败"在埋点/日志上分开）。
- */
-export declare function isMcpCallCancelled(cancellation: McpCallCancellation): boolean;

package/cli/dist-server/types/node/mcp/mcp-controller.d.ts

@@ -1,56 +0,0 @@
-import { ConsoleManager } from '../console';
-import { McpConfig, McpConfigManager, McpConnectionManager, McpManager, McpScope, McpServerManager, McpTool, McpTransportType } from './mcp-protocol';
-export interface McpScopeOptions {
-    scope?: McpScope;
-}
-export interface McpNameRequest extends McpScopeOptions {
-    name: string;
-}
-export interface McpServerRequestBase extends McpNameRequest {
-    args?: string[];
-    env?: string[];
-    header?: string[];
-    description?: string;
-}
-export interface McpAddRequest extends McpServerRequestBase {
-    commandOrUrl: string;
-    transport: McpTransportType;
-}
-export interface McpUpdateRequest extends McpServerRequestBase {
-    commandOrUrl?: string;
-    transport?: McpTransportType;
-}
-export interface McpAddJsonRequest extends McpNameRequest {
-    json: McpConfig;
-}
-export declare class McpController {
-    protected readonly mcpManager: McpManager;
-    protected readonly mcpConfigManager: McpConfigManager;
-    protected readonly mcpConnectionManager: McpConnectionManager;
-    protected readonly mcpServerManager: McpServerManager;
-    protected readonly consoleManager: ConsoleManager;
-    add(request: McpAddRequest): Promise<void>;
-    remove(request: McpNameRequest): Promise<void>;
-    get(request: McpNameRequest): Promise<void>;
-    list(request: McpScopeOptions): Promise<void>;
-    addJson(request: McpAddJsonRequest): Promise<void>;
-    listTools(request: McpNameRequest): Promise<McpTool[]>;
-    /**
-     * Get MCP server connection status
-     * Used by workbuddy-desktop to poll connection state after /add
-     */
-    status(request: McpNameRequest): Promise<{
-        name: string;
-        status: string;
-        needsAuth: boolean;
-        error?: string;
-    }>;
-    /**
-     * Get OAuth authorization URL for a server that needs authentication
-     * Used by workbuddy-desktop to open browser for OAuth
-     */
-    oauthAuthorize(request: McpNameRequest): Promise<{
-        authorizationUrl?: string;
-        error?: string;
-    }>;
-}

package/cli/dist-server/types/node/mcp/mcp-model-id-header-helper.d.ts

@@ -1,12 +0,0 @@
-/**
- * 在 operation 执行期间，把 `modelId` 绑定到当前 async 作用域；
- * 期间由该作用域内发出的任何 MCP HTTP 请求都会被自动注入 `X-Model-ID`。
- *
- * 当 `modelId` 缺失、或 transport 不带 HTTP fetch 钩子（如 stdio）时，
- * 直接执行 operation 不做注入。
- */
-export declare function withMcpModelIdHeader<T>(params: {
-    serverName: string;
-    transport: unknown;
-    modelId?: string;
-}, operation: () => Promise<T>): Promise<T>;

package/cli/dist-server/types/node/mcp/mcp-oauth-callback-html.d.ts

@@ -1,6 +0,0 @@
-/** HTML entity escape for OAuth callback pages (text-node / quoted-attr context). */
-export declare function escapeHtml(s: string): string;
-/** CSP for static OAuth callback HTML (inline CSS only, no scripts). */
-export declare const OAUTH_CALLBACK_CSP = "default-src 'none'; style-src 'unsafe-inline'; img-src 'none'; script-src 'none'; base-uri 'none'; form-action 'none'; frame-ancestors 'none'";
-export declare function generateOAuthSuccessHtml(serverName: string, operation: 'connect' | 'authenticate'): string;
-export declare function generateOAuthErrorHtml(errorMessage: string): string;

package/cli/dist-server/types/node/mcp/mcp-oauth-controller.d.ts

@@ -1,26 +0,0 @@
-import { ConsoleManager } from '../console';
-import { McpManager, McpOAuthManager } from './mcp-protocol';
-export interface OAuthCallbackQuery {
-    code?: string;
-    state?: string;
-    error?: string;
-    error_description?: string;
-}
-export declare class McpOAuthController {
-    protected readonly oauthManager: McpOAuthManager;
-    protected readonly mcpManager: McpManager;
-    protected readonly consoleManager: ConsoleManager;
-    /**
-     * Handle OAuth callback from authorization server
-     * It will attempt to find the server by matching the OAuth state parameter
-     */
-    handleCallback(query: OAuthCallbackQuery): Promise<string>;
-    protected applyOAuthCallbackSecurityHeaders(): void;
-    protected processOAuthCallback(query: OAuthCallbackQuery): Promise<string>;
-}
-/**
- * Legacy controller for backward compatibility with /internal/mcp/oauth/callback path
- */
-export declare class McpOAuthInternalController extends McpOAuthController {
-    handleCallback(query: OAuthCallbackQuery): Promise<string>;
-}

package/cli/dist-server/types/node/mcp/mcp-output-storage.d.ts

@@ -1,57 +0,0 @@
-import { CallToolResultContent } from './mcp-protocol';
-/**
- * 计算内容的字符数（与原 checkTokenUsage 同 metric，image 块跳过）。
- *
- * 对非法块（字段缺失 / 类型错误）容错：按 0 处理而不是抛错，保证
- * processMcpResult 的"永不 throw"契约不会被上游返回的异常结构打破。
- */
-export declare function computeCharCount(content: CallToolResultContent): number;
-/**
- * 检测内容是否含 image 块。含 image 时走截断而非落盘：base64 图片 payload
- * 写入 `.txt` 文件会丢失 UI 层的图片查看/渲染集成。cbc 不像 CC 那样会
- * `compressImageBlock` 压缩图片塞进剩余预算——预算够则原样保留，不够则丢。
- */
-export declare function contentContainsImages(content: CallToolResultContent): boolean;
-/**
- * 生成模型指引文本（逐字对齐 CC `getLargeOutputInstructions`）。
- */
-export declare function getLargeOutputInstructions(rawOutputPath: string, contentLength: number, formatDescription: string): string;
-/** 截断降级文案（对齐 CC `getTruncationMessage` + `truncateMcpContent`）。 */
-export declare function getTruncationMessage(maxTokens: number): string;
-/**
- * 截断内容到 maxTokens*4 字符上限。
- *   - text: 切片到剩余预算
- *   - image: 整块保留（不计入预算；cbc 无压缩）
- *   - resource / resource_link / audio: 预算有剩整块保留，否则丢弃但
- *     **插入占位文本**告知模型"N 个 X 类型块因超限被丢弃"——不让降级悄无声息地丢数据
- */
-export declare function truncateMcpContent(content: CallToolResultContent, maxTokens: number): CallToolResultContent;
-/** 落盘结果 union。 */
-export type PersistResult = {
-    filepath: string;
-    originalSize: number;
-} | {
-    error: string;
-};
-/**
- * 把内容写入会话的 tool-results 目录。
- * 路径规则与 `ToolResultBlobService` 一致：
- *   - 主 session: `~/.codebuddy/projects/<hash>/<sessionStoreId>/tool-results/mcp-<server>-<tool>-<ts>-<rand>.txt`
- *   - 子 agent:  `~/.codebuddy/projects/<hash>/<parentSessionId>/subagents/<storeId>/tool-results/...`
- *
- * 文件名含 6 位随机后缀，避免同毫秒并发 call 互相覆盖。
- */
-export declare function persistMcpOutput(content: CallToolResultContent, sessionStoreId: string, parentSessionId: string | undefined, serverName: string, toolName: string): Promise<PersistResult>;
-/**
- * 统一入口：返回替换后的 content，**永不 throw**。
- *
- * 决策逻辑：
- *   1. 未超限 → 原样返回
- *   2. env 禁用 / 含 image / 无 sessionStoreId / 落盘失败 → 截断降级
- *   3. 否则 → 落盘，返回单条 text 指引
- *
- * 最外层 try/catch 兜底任何意外 throw（如 DI container 未就绪时
- * `PathUtils.getHomeProjectDir` 抛、content 结构异常让 helper 抛等），
- * 失败时用同步的最小截断确保模型拿到可读内容。
- */
-export declare function processMcpResult(content: CallToolResultContent, maxTokens: number, serverName: string, toolName: string, sessionStoreId: string | undefined, parentSessionId: string | undefined): Promise<CallToolResultContent>;

package/cli/dist-server/types/node/mcp/mcp-server-override-impl.d.ts

@@ -1,136 +0,0 @@
-import { MCPServerSSE, MCPServerStdio, MCPServerStreamableHttp } from '@openai/agents';
-import { MCPServerSSE as UnderlyingMCPServerSSE, MCPServerStdio as UnderlyingMCPServerStdio, MCPServerStreamableHttp as UnderlyingMCPServerStreamableHttp } from '@openai/agents-core/_shims';
-import { CallToolResultContent, GetPromptResult, McpPrompt, McpResource, McpResourceTemplate, MCPServer, ReadResourceResult } from './mcp-protocol';
-import { extractMcpCallSideband } from './mcp-tool-result-sideband';
-/**
- * MCP progress callback and result-sideband contracts. The shared extractor is
- * used by every transport so wire metadata stays open while all local `__*`
- * fields are removed before serialization.
- */
-export type { McpResultMetaSink, McpToolProgressCallback } from './mcp-tool-result-sideband';
-/**
- * The MCP SDK's Client.callTool, when handed `RequestOptions.onprogress`, automatically:
- *   1. assigns a JSON-RPC messageId as `progressToken` in `_meta`
- *   2. registers the callback in its `_progressHandlers` map
- *   3. routes incoming `notifications/progress` by `progressToken` to the callback
- *   4. cleans up after the request settles
- */
-declare const extractProgressCallback: typeof extractMcpCallSideband;
-export { extractProgressCallback };
-/**
- * Override MCPServerStdio to set stderr: 'ignore' when creating StdioClientTransport
- */
-export declare class OverriddenUnderlyingMCPServerStdio extends UnderlyingMCPServerStdio implements MCPServer {
-    private _name;
-    private transport;
-    onToolsListChanged?: () => void;
-    connect(): Promise<void>;
-    /** Timestamp of the last listTools failure. Used to skip retries for a cooldown period. */
-    private _lastListToolsFailure;
-    listTools(): ReturnType<MCPServer['listTools']>;
-    callTool(toolName: string, args: Record<string, unknown> | null, meta?: Record<string, unknown> | null): Promise<CallToolResultContent>;
-    listPrompts(): Promise<McpPrompt[]>;
-    /**
-     * Capability declared at `initialize` and cached by the MCP client, so this
-     * is a memory read that cannot time out — see MCPServer.supportsResources.
-     */
-    supportsResources(): boolean;
-    listResources(): Promise<McpResource[]>;
-    listResourceTemplates(): Promise<McpResourceTemplate[]>;
-    getPrompt(promptName: string, args?: Record<string, string>): Promise<GetPromptResult['messages']>;
-    readResource(request: {
-        uri: string;
-    }): Promise<ReadResourceResult['contents']>;
-}
-export declare class OverriddenMCPServerStdio extends MCPServerStdio implements MCPServer {
-    protected underlying: OverriddenUnderlyingMCPServerStdio;
-    constructor(params: ConstructorParameters<typeof MCPServerStdio>[0]);
-    get onToolsListChanged(): (() => void) | undefined;
-    set onToolsListChanged(callback: (() => void) | undefined);
-    connect(): Promise<void>;
-    listTools(): ReturnType<MCPServer['listTools']>;
-    listPrompts(): Promise<McpPrompt[]>;
-    supportsResources(): boolean;
-    listResources(): Promise<McpResource[]>;
-    listResourceTemplates(): Promise<McpResourceTemplate[]>;
-    getPrompt(promptName: string, args?: Record<string, string>): Promise<GetPromptResult['messages']>;
-    readResource(request: {
-        uri: string;
-    }): Promise<ReadResourceResult['contents']>;
-}
-export declare class OverriddenUnderlyingMCPServerSSE extends UnderlyingMCPServerSSE implements MCPServer {
-    private _name;
-    private transport;
-    onToolsListChanged?: () => void;
-    connect(): Promise<void>;
-    /** Timestamp of the last listTools failure. Used to skip retries for a cooldown period. */
-    private _lastListToolsFailure;
-    listTools(): ReturnType<MCPServer['listTools']>;
-    callTool(toolName: string, args: Record<string, unknown> | null, meta?: Record<string, unknown> | null): Promise<CallToolResultContent>;
-    listPrompts(): Promise<McpPrompt[]>;
-    /**
-     * Capability declared at `initialize` and cached by the MCP client, so this
-     * is a memory read that cannot time out — see MCPServer.supportsResources.
-     */
-    supportsResources(): boolean;
-    listResources(): Promise<McpResource[]>;
-    listResourceTemplates(): Promise<McpResourceTemplate[]>;
-    getPrompt(promptName: string, args?: Record<string, string>): Promise<GetPromptResult['messages']>;
-    readResource(request: {
-        uri: string;
-    }): Promise<ReadResourceResult['contents']>;
-}
-export declare class OverriddenMCPServerSSE extends MCPServerSSE implements MCPServer {
-    protected underlying: OverriddenUnderlyingMCPServerSSE;
-    constructor(params: ConstructorParameters<typeof MCPServerSSE>[0]);
-    get onToolsListChanged(): (() => void) | undefined;
-    set onToolsListChanged(callback: (() => void) | undefined);
-    connect(): Promise<void>;
-    listTools(): ReturnType<MCPServer['listTools']>;
-    listPrompts(): Promise<McpPrompt[]>;
-    supportsResources(): boolean;
-    listResources(): Promise<McpResource[]>;
-    listResourceTemplates(): Promise<McpResourceTemplate[]>;
-    getPrompt(promptName: string, args?: Record<string, string>): Promise<GetPromptResult['messages']>;
-    readResource(request: {
-        uri: string;
-    }): Promise<ReadResourceResult['contents']>;
-}
-export declare class OverriddenUnderlyingMCPServerStreamableHttp extends UnderlyingMCPServerStreamableHttp implements MCPServer {
-    private _name;
-    private transport;
-    onToolsListChanged?: () => void;
-    connect(): Promise<void>;
-    /** Timestamp of the last listTools failure. Used to skip retries for a cooldown period. */
-    private _lastListToolsFailure;
-    listTools(): ReturnType<MCPServer['listTools']>;
-    callTool(toolName: string, args: Record<string, unknown> | null, meta?: Record<string, unknown> | null): Promise<CallToolResultContent>;
-    listPrompts(): Promise<McpPrompt[]>;
-    /**
-     * Capability declared at `initialize` and cached by the MCP client, so this
-     * is a memory read that cannot time out — see MCPServer.supportsResources.
-     */
-    supportsResources(): boolean;
-    listResources(): Promise<McpResource[]>;
-    listResourceTemplates(): Promise<McpResourceTemplate[]>;
-    getPrompt(promptName: string, args?: Record<string, string>): Promise<GetPromptResult['messages']>;
-    readResource(request: {
-        uri: string;
-    }): Promise<ReadResourceResult['contents']>;
-}
-export declare class OverriddenMCPServerStreamableHttp extends MCPServerStreamableHttp implements MCPServer {
-    protected underlying: OverriddenUnderlyingMCPServerStreamableHttp;
-    constructor(params: ConstructorParameters<typeof MCPServerStreamableHttp>[0]);
-    get onToolsListChanged(): (() => void) | undefined;
-    set onToolsListChanged(callback: (() => void) | undefined);
-    connect(): Promise<void>;
-    listTools(): ReturnType<MCPServer['listTools']>;
-    listPrompts(): Promise<McpPrompt[]>;
-    supportsResources(): boolean;
-    listResources(): Promise<McpResource[]>;
-    listResourceTemplates(): Promise<McpResourceTemplate[]>;
-    getPrompt(promptName: string, args?: Record<string, string>): Promise<GetPromptResult['messages']>;
-    readResource(request: {
-        uri: string;
-    }): Promise<ReadResourceResult['contents']>;
-}

package/cli/dist-server/types/node/mcp/mcp-server-override.d.ts

@@ -1,29 +0,0 @@
-/**
- * MCP server override 的 async factory shim（standby lazy 化 #107267）。
- *
- * ## 背景
- *
- * 6 个 `Overridden*` 类都 `extends` `@openai/agents` / `@openai/agents-core/_shims`
- * 里的基类。`class X extends Y {}` 是 module-load 时求值——若 Y 走 lazy binding
- * 会崩 `Class extends value undefined is not a constructor`。
- *
- * 解法：**把 subclass 定义整体挪到 `./mcp-server-override-impl.ts`**（保留原 static
- * imports），主入口只做 async factory + `await import()`。rspack 看到 dynamic
- * `import()` 就会把 impl 文件连同它顶层 static import 的 `@openai/agents(-core)`
- * 一起拆到 lazy chunk。standby 期不加载 —— agent-loop / MCP connect 都在 activate
- * 后才走到这里。
- *
- * ## 使用契约
- *
- * caller: `mcp-server-manager.ts` 3 处从 `new OverriddenMCPServer*(...)` 改为
- * `await createOverriddenMCPServerXxx(...)`（都在 async 上下文，改动最小）。
- * 首次调用时 impl chunk 加载并缓存；之后 O(1) 拿 factory。
- *
- * 类型层（`OverriddenMCPServerStdio` 等）通过 `import type` re-export，
- * 依然可以在 caller 里作类型注解，不 pull SDK 到主 chunk。
- */
-import type { OverriddenMCPServerSSE, OverriddenMCPServerStdio, OverriddenMCPServerStreamableHttp, OverriddenUnderlyingMCPServerSSE, OverriddenUnderlyingMCPServerStdio, OverriddenUnderlyingMCPServerStreamableHttp } from './mcp-server-override-impl';
-export type { OverriddenMCPServerSSE, OverriddenMCPServerStdio, OverriddenMCPServerStreamableHttp, OverriddenUnderlyingMCPServerSSE, OverriddenUnderlyingMCPServerStdio, OverriddenUnderlyingMCPServerStreamableHttp, };
-export declare function createOverriddenMCPServerStdio(params: ConstructorParameters<typeof import('./mcp-server-override-impl').OverriddenMCPServerStdio>[0]): Promise<OverriddenMCPServerStdio>;
-export declare function createOverriddenMCPServerSSE(params: ConstructorParameters<typeof import('./mcp-server-override-impl').OverriddenMCPServerSSE>[0]): Promise<OverriddenMCPServerSSE>;
-export declare function createOverriddenMCPServerStreamableHttp(params: ConstructorParameters<typeof import('./mcp-server-override-impl').OverriddenMCPServerStreamableHttp>[0]): Promise<OverriddenMCPServerStreamableHttp>;

package/cli/dist-server/types/node/mcp/mcp-tool-result-sideband.d.ts

@@ -1,26 +0,0 @@
-export type McpToolProgressCallback = (progress: number, total?: number, message?: string) => void;
-export type McpResultMetaSink = (result: Record<string, unknown> & {
-    content?: unknown[];
-    structuredContent?: Record<string, unknown>;
-    _meta?: Record<string, unknown>;
-    isError?: boolean;
-}) => void;
-export interface McpCallSideband {
-    onProgress?: McpToolProgressCallback;
-    resultMetaSink?: McpResultMetaSink;
-    abortSignal?: AbortSignal;
-    timeoutMs?: number;
-    realMeta?: Record<string, unknown>;
-}
-/**
- * Split local `__*` sideband fields from the open MCP wire metadata. Known
- * sidebands are returned to the caller; every `__*` key is kept off the wire.
- */
-export declare function extractMcpCallSideband(meta: Record<string, unknown> | null | undefined): McpCallSideband;
-/** 保留原始未知字段，并用 schema 解析值覆盖标准字段。 */
-export declare function emitMcpToolResultSideband(rawResponse: unknown, parsed: Record<string, unknown> & {
-    content?: unknown[];
-    structuredContent?: Record<string, unknown>;
-    _meta?: Record<string, unknown>;
-    isError?: boolean;
-}, sink?: McpResultMetaSink): void;