@tencent-ai/agent-sdk 0.3.263-dev.90f0e98.202609190050 → 0.3.263

package/cli/dist-server/types/node/tools/agent-tool.d.ts

@@ -1,154 +0,0 @@
-import { type Session } from '../../vendor/cbc-core/node/index.js';
-import { FunctionCallItem, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { type ICwdService, type IWorktreeChangeDetector, type IWorktreeService } from '@genie/cbc-worktree';
-import { EventService, Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { ConsoleManager } from '../console';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-export declare class AgentTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly consoleManager: ConsoleManager;
-    protected readonly eventService: EventService;
-    protected readonly cwdService: ICwdService;
-    protected readonly worktreeService: IWorktreeService;
-    protected readonly worktreeChangeDetector: IWorktreeChangeDetector;
-    private teamSpawnChain;
-    name: ToolNames;
-    readonly promptCacheStability: 'volatile';
-    /**
-     * Tool schema is a **method** (not a static object) so ToolManager.get()
-     * re-evaluates it per invocation and reflects the current process env.
-     * This is how we hide `run_in_background` from the model when
-     * `CODEBUDDY_CODE_DISABLE_BACKGROUND_TASKS` is truthy (issue #63114 — in
-     * request-response SDK / print-mode consumers, background agent results
-     * cannot flow back into the lead's final answer, so the host disables the
-     * whole capability instead of shipping half a feature).
-     *
-     * The runtime guard in `execute()` still ignores `run_in_background=true`
-     * from stale/cached tool calls that bypass this schema.
-     */
-    parameters(): z.ZodTypeAny;
-    private buildParametersSchema;
-    argumentRenderer: ToolCallArgumentRenderer;
-    needsApproval: boolean;
-    /**
-     * Auto mode classifier projection: `(${subagent_type}, mode=${mode}): ${prompt}`
-     * (Claude alignment, decision D1). The sub-agent prompt is projected so a
-     * delegated dangerous action is visible to the classifier (delegation-bypass
-     * defense). NOTE: CodeBuddy's Agent tool has `needsApproval = false`, so the
-     * current action never reaches the classifier directly — this projection is
-     * consumed when an Agent call appears in the history transcript.
-     */
-    toAutoClassifierInput(input: unknown): string;
-    execute(input: any, context?: RunContext<Session>, details?: {
-        toolCall: FunctionCallItem;
-    }): Promise<ToolResult>;
-    /**
-     * 将 Agent 工具执行异常映射到 19920 段细分错误码。
-     */
-    private classifyAgentError;
-    /**
-     * Generate an auto-name for a background agent: "{agentType}-{seq}"
-     * e.g. "explore-1", "explore-2", "plan-1"
-     */
-    private generateBackgroundAgentName;
-    /**
-     * Resolve a member name that is unique within `teamName` (checked against
-     * the in-memory TeamMemberRegistry). If `desired` already exists, append a
-     * short random hex suffix and retry — aligns with TeamCreate's "rename on
-     * conflict" idempotency strategy and prevents a leftover/stale teammate
-     * (e.g. a `critic` from a finished team) from blocking new background
-     * agent spawns with misleading "already active" errors.
-     */
-    private resolveUniqueMemberName;
-    /**
-     * Ensure the lead is in a team before spawning a named/background member.
-     * Named Agent() from Code Mode must not require a prior TeamCreate.
-     */
-    private ensureTeamForSpawn;
-    /**
-     * Spawn a background agent as a team member in an auto-created team.
-     *
-     * This replaces the old "implicit team" approach. Instead of ad-hoc
-     * TeamMember + setAgentTask() + ensureInboxPolling(), we:
-     * 1. Auto-create a team via TeamManager (if not already in one)
-     * 2. Spawn the agent using TeamMember.spawn() for full lifecycle support
-     * 3. Register with TeamManager for persistence to config.json
-     */
-    private spawnBackgroundAgent;
-    /**
-     * Spawn a teammate in the current active team.
-     * Teammates always run in detached + background mode.
-     * If the lead is not in a team yet, auto-create one (same as background Agent).
-     */
-    private spawnTeammate;
-    /**
-     * Cleanup agent worktree after task completion.
-     * - No changes: auto-delete worktree, return removal message
-     * - Has changes: preserve worktree, return info message
-     *
-     * Message format aligned with Claude Code:
-     * - No changes: "Worktree removed (no changes)"
-     * - Has changes: "Worktree preserved at ${path} on branch: ${branch}"
-     */
-    private cleanupAgentWorktree;
-    /**
-     * Spawn a Fork subagent that inherits the parent agent's full context.
-     * Reuses spawnBackgroundAgent() with agentType='fork', which is recognized
-     * by AgentTask.setupPhase() to inherit the default agent definition.
-     */
-    private spawnForkAgent;
-    /**
-     * Execute a Fork subagent synchronously (blocking).
-     * Same as standard sync sub-agent but uses AgentNames.FORK so that
-     * AgentTask.setupPhase() inherits the default agent definition and
-     * setupSubAgentSession() injects parent conversation history.
-     */
-    private executeSyncForkAgent;
-    /**
-     * Build the fork child's prompt by prepending behavioral rules.
-     * The <fork-boilerplate> tag serves dual purpose:
-     * 1. Behavioral instructions for the fork child
-     * 2. Marker for isInForkChild() recursive fork prevention
-     */
-    private buildForkChildPrompt;
-    /**
-     * Check if the current execution context is inside a Fork child.
-     * Two-layer defense:
-     * 1. Session meta: check if agentName === 'fork'
-     * 2. Message scan: check for <fork-boilerplate> tag in session history
-     */
-    private isInForkChild;
-    private getAgentManager;
-    /**
-     * Enforces `CODEBUDDY_DISABLE_BUILTIN_SUBAGENTS` (issue #99451) for a
-     * built-in-disableable `subagent_type`. Throws unless a custom OR plugin
-     * agent overrides it (matching tool-manager.ts's exposure-layer check —
-     * see that file's `CUSTOM_AGENT_TAG || PLUGIN_AGENT_TAG` filter).
-     *
-     * Deliberately reads tags via `AgentManager.getAgentConfig()` rather than
-     * `CustomAgentManager.get()`: the latter's `loadCustomAgents()` filters
-     * out anything tagged `PLUGIN_AGENT_TAG`, so a plugin-provided override
-     * would be misreported as absent here — a "shown in the tool catalog but
-     * blocked at runtime" bug that existed in the original CustomAgentManager
-     * -based check.
-     */
-    private assertBuiltinSubagentOverrideAllowed;
-    /**
-     * 上报插件 subagent 能力调用埋点。
-     * Agent 的 tags 格式为 [CLI_AGENT_TAG, CUSTOM_AGENT_TAG, PLUGIN_TAG, source]，
-     * 其中 source 形如 "pluginName@marketplaceName"。
-     * 仅在 WorkBuddy Desktop 宿主下上报。
-     */
-    private reportPluginAgentCall;
-    /**
-     * Build the optional `subAgent` slice on the returned ToolResult — present
-     * when AgentTask recorded a sessionId and a `lastId` boundary (i.e. the run
-     * produced at least one history item to replay). afterId may be undefined
-     * (window starts at the subagent history beginning). Spread
-     * `...AgentTool.subAgentMetaOf(executionResult)` at the call site.
-     */
-    private static subAgentMetaOf;
-}

package/cli/dist-server/types/node/tools/artifact-common.d.ts

@@ -1,80 +0,0 @@
-import { AuthenticationManager } from '@genie/authentication';
-import { AbTestService, ProductManager } from '@genie/product';
-/** 国际集群 endpoint 主机名片段。命中任一即判定为暂不支持 Artifact 分享链路的国际环境。 */
-export declare const INTERNATIONAL_ENDPOINT_HOSTS: string[];
-/**
- * Artifact / ArtifactControl 共享的开关判定（issue #81031）。
- *
- * 判定顺序（先命中先生效）：
- *   1. 国际 endpoint → 直接关闭（国际网关缺少 spaceengine 接口，任何开关都无法覆盖）；
- *   2. 环境变量：CODEBUDDY_ARTIFACT_ENABLED（新规范名）优先，未设置时回落
- *      CODEBUDDY_SHARE_LINK_ENABLED（旧名，兼容已部署环境）。空串/空白视为未设置——
- *      宿主模板化 env 很容易注入空值，若按「已设置」处理会遮蔽旧变量并静默关闭工具；
- *   3. 云端 productFeatures：优先走调用方注入的 AbTestService（Artifact 权威优先、
- *      ShareLink 兼容兜底；任一 alias 显式 false 触发 kill-switch）；两者均缺失时
- *      本地默认按 true 处理，保留既有"缺省开"的行为。
- *   4. AbTestService 未注入（老bundle / 未装配 CellJS 容器的单测）→ fallback 到
- *      productManager.waitConfiguration()，语义与迁移前完全等价。
- *
- * **不用 `ContainerUtil.get(AbTestService)`懒获取的原因**：CellJS 惰性实例化，
- * 首次 get 才触发 @PostConstruct → warm-up。如果只有 isArtifactToolEnabled 消费它，
- * 那么在无登录/短路径场景下工具从未被 evaluate → AbTestService 从未实例化 → snapshot
- * 从不落盘。改由消费方类（ArtifactTool / ArtifactControlTool）通过 @Autowired 声明依赖，
- * CellJS 装配这些工具时会顺带装配 AbTestService，warm-up 提前发生。
- */
-export declare function isArtifactToolEnabled(productManager: ProductManager, abTestService?: AbTestService): Promise<boolean>;
-/**
- * 知识空间上传业务错误码：文件大小超限（ErrFileTooLarge）。
- * 与 `@genie/agent-provider` 的 `KNOWLEDGE_UPLOAD_FILE_TOO_LARGE_CODE` 保持一致
- * （这里本地声明而非跨包 value import，避免 CLI 打包引入 agent-provider 运行时依赖）。
- */
-export declare const KNOWLEDGE_UPLOAD_FILE_TOO_LARGE_CODE = 56040;
-/**
- * 知识空间上传业务错误码：标题命中内容审核（Code_ERR_NODE_BLOCKED）。
- * 与 `@genie/agent-provider` 的 `KNOWLEDGE_UPLOAD_MODERATION_BLOCKED_CODE` 保持一致。
- */
-export declare const KNOWLEDGE_UPLOAD_MODERATION_BLOCKED_CODE = 619610;
-/**
- * 按文件扩展名判定上传 COS 时的 `Content-Type`。
- *
- * 后端 `importLocalFileAsync` 按扩展名分流（见 workbuddy-server `share/facade.ts` 的
- * 「html/md 走 cosKey，其他类型走 confirmKey」注释），`.md` 与 `.html` 同为一等公民并由
- * **服务端**渲染为样式化页面 —— 因此客户端不做任何预渲染，只需给出正确的 contentType。
- *
- * 未识别的扩展名保持 `application/octet-stream`（既有行为，不收窄）。
- */
-export declare function resolveShareContentType(filePath: string): string;
-/** endpoint 主机名命中国际集群清单时返回 true。 */
-export declare function isInternationalEndpoint(endpoint: string): boolean;
-/** 复用 CBC 自身会话的 access token 构造鉴权头（bearer + X-* 上下文）。未登录返回 null。 */
-export declare function buildShareAuthHeaders(authManager: AuthenticationManager): Record<string, string> | null;
-/**
- * 从 Artifact 工具返回的分享链接中解析出 nodeId（即取消发布接口所需的 fileId）。
- *
- * 链接格式稳定为 `.../p/{nodeId}`（见 spaceengine urlgen.PublishURL），因此取 pathname
- * 的最后一段即可。传入的已经是裸 nodeId（不含斜杠、不含协议）时原样返回。
- *
- * 无法解析时返回 null。
- */
-export declare function extractNodeIdFromShareLink(input: string): string | null;
-/**
- * 分享链接的节点类型：
- * - `page`：HTML 页面节点（`https://workbuddy.link/p/{nodeId}`），取消公开走 page/unpublish；
- * - `doc`：Markdown 文档节点（`https://www.workbuddy.cn/space/d/{nodeId}`），取消公开走
- *   set-permission(invalid)（doc 节点没有 page/unpublish，调之报 "page meta not found"）；
- * - `unknown`：只给了裸 nodeId（无路径可判型），由调用方先试 page 再回退 doc。
- */
-export type ShareLinkKind = 'page' | 'doc' | 'unknown';
-/**
- * 按链接路径形态判定节点类型，并解析出 nodeId。
- *
- * 判据只看路径段（`/p/` vs `/space/d/`），不依赖 host——host 可能随环境变化
- * （workbuddy.link / workbuddy.cn / copilot.tencent.com 等），但路径形态稳定。
- * 裸 nodeId（无斜杠）无法判型，返回 `unknown` 交由调用方按 page→doc 顺序试探。
- *
- * nodeId 复用 extractNodeIdFromShareLink，避免重复解析逻辑。
- */
-export declare function classifyShareLink(input: string): {
-    nodeId: string | null;
-    kind: ShareLinkKind;
-};

package/cli/dist-server/types/node/tools/artifact-control-tool.d.ts

@@ -1,103 +0,0 @@
-import { AuthenticationManager } from '@genie/authentication';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { Agent, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { AbTestService, ProductManager } from '@genie/product';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-/**
- * ArtifactControl 工具参数：对一个已发布的 artifact 执行控制动作。
- *
- * 当前**唯一**支持的动作是「取消发布」（unpublish）：把此前用 Artifact 工具发布的
- * HTML 页面 / Markdown 文档的公开链接设为私密（撤销公开访问）。
- *
- * 二选一（至少一个）：
- *   - shareLink：Artifact 返回的完整链接（形如 .../p/{nodeId}），工具会自行解析出 nodeId。
- *   - nodeId：链接末段的裸标识（等价于后端取消发布接口所需的 fileId）。
- */
-declare const ArtifactControlParameters: z.ZodObject<{
-    shareLink: z.ZodOptional<z.ZodString>;
-    nodeId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    shareLink?: string | undefined;
-    nodeId?: string | undefined;
-}, {
-    shareLink?: string | undefined;
-    nodeId?: string | undefined;
-}>;
-/**
- * ArtifactControl 工具 —— 已发布 artifact 的控制入口（issue #81031 更名自 ShareLinkUnpublish）。
- *
- * 当前**唯一**能力：取消发布（unpublish）——把一个 Artifact 工具发布的
- * HTML 页面 / Markdown 文档的公开分享链接设为私密（互联网不可访问，并尽量移除协作人）。
- * 尚不支持列表 / 删除 / 权限调整等其他动作；命名仅为后续以可选参数扩展预留空间。
- *
- * 与 ArtifactTool 对称：同样仅面向国内 / iOA / 内部 endpoint，复用 CBC 自身会话的
- * access token。按链接形态路由（见 classifyShareLink / revoke）：
- *   - html 页面节点（/p/）→ `POST /space/api/view/page/unpublish`（body `{ fileId }`）；
- *   - markdown 文档节点（/space/d/）→ `POST /space/api/permission/set-permission`
- *     设为 `{ role: 'invalid' }`（doc 节点没有 page/unpublish，硬调会报 "page meta not found"）；
- *   - 裸 nodeId（无法判型）→ 先试 page/unpublish，任意失败回退 set-permission(invalid)。
- *
- * 用户可以直接把 Artifact 返回的链接贴回来撤销，无需记忆内部标识，也无需依赖会话状态——
- * nodeId 稳定内嵌在链接中（见 spaceengine urlgen.PublishURL）。
- */
-export declare class ArtifactControlTool extends BaseTool implements Tool {
-    protected readonly authManager: AuthenticationManager;
-    protected readonly productManager: ProductManager;
-    protected readonly abTestService?: AbTestService;
-    protected readonly logger: Logger;
-    name: ToolNames;
-    aliases: string[];
-    description: string;
-    parameters: z.ZodObject<{
-        shareLink: z.ZodOptional<z.ZodString>;
-        nodeId: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        shareLink?: string | undefined;
-        nodeId?: string | undefined;
-    }, {
-        shareLink?: string | undefined;
-        nodeId?: string | undefined;
-    }>;
-    strict: boolean;
-    argumentRenderer: ToolCallArgumentRenderer;
-    isEnabled: (_args: {
-        runContext: RunContext<Session>;
-        agent: Agent;
-    }) => Promise<boolean>;
-    execute(input: z.infer<typeof ArtifactControlParameters>, _context: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * 按节点类型取消公开访问，返回成功走的是哪条路径（page / permission）。
-     *
-     * - `page`：仅 page/unpublish。
-     * - `doc`：仅 makeDocPrivate（关闭公开档位 + 移除所有人类协作人）。
-     * - `unknown`：先 page/unpublish，**任意**失败即回退 makeDocPrivate
-     *   （不按错误串匹配——串匹配脆弱，且 CLI markdown 分享大多本就是 doc 节点）。
-     *   两者都失败时返回权限接口的失败详情（更可能是真实路径），并注明 page 也已尝试。
-     */
-    private revoke;
-    /** page/unpublish（html 页面节点）：body `{ fileId }`，code===0 成功。 */
-    private unpublishPage;
-    /**
-     * 把 markdown doc 节点设为**完全私密**：关闭公开档位 + 移除所有人类协作人。
-     *
-     * 仅关公开档位（public.role=invalid）只堵住「互联网公开」这道门；此前通过邀请/协作
-     * 加入的成员仍能访问。真正的「设为私密」必须连协作人一起撤掉，因此本方法：
-     *   1. 先查当前协作人：POST /space/api/permission/collaborators `{ recordId }`
-     *      → `{ collaborators: [{ uid, role, type }] }`（type='public' 是公开档位占位条目、
-     *      role='owner' 是所有者，二者都要跳过）。查失败不致命——仍继续关公开档位，
-     *      只是附警告说明协作人可能未清干净。
-     *   2. 一次原子调用 POST /space/api/permission/set-permission
-     *      `{ recordId, public:{role:'invalid'}, members:[{uid, role:'invalid'}...] }`
-     *      （后端 role='invalid' → permission.None，即移除成员；见 spaceengine
-     *      set_permission.go / protocol.go）。code===0 成功。
-     *
-     * 这是 ArtifactTool 上传时 set-permission(reader) 的逆操作，但覆盖面更全（含协作人）。
-     * agent override 条目（响应里的 agents）不在此处理：CLI 分享链路不会产生它们。
-     */
-    private makeDocPrivate;
-}
-export {};

package/cli/dist-server/types/node/tools/artifact-tool.d.ts

@@ -1,109 +0,0 @@
-import { AuthenticationManager } from '@genie/authentication';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { Agent, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { AbTestService, ProductManager } from '@genie/product';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { BaseTool } from './base-tool';
-import { Tool, ToolResult } from './tool-protocol';
-/**
- * Artifact 工具参数：上传本地单个 HTML / Markdown 文件，发布为可分享的公网链接。
- *
- * `existingShareLink` 为空时新建节点；给定既有链接 / nodeId 时覆盖同一节点，
- * 因而 republish 到同一个 URL（语义与「不给标识就是新建」一致）。
- */
-declare const ArtifactParameters: z.ZodObject<{
-    filePath: z.ZodString;
-    existingShareLink: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    filePath: string;
-    existingShareLink?: string | undefined;
-}, {
-    filePath: string;
-    existingShareLink?: string | undefined;
-}>;
-/**
- * Artifact 工具 —— 把本地 HTML / Markdown 发布为可渲染的公网分享链接（issue #81031 更名自 ShareLink）。
- *
- * 当前仅面向国内 / iOA / 内部 endpoint 开启，走【知识空间上传】
- * （/space/api/view/import/*，与 WorkBuddy uploadToKnowledge 对齐）。国际 endpoint 暂不提供：
- * 国际网关缺少 spaceengine 接口，暂不作为 CLI 分享链路。
- *
- * Markdown 由**服务端**渲染成样式化页面（后端按扩展名分流，`.md` 与 `.html` 同为一等公民），
- * 客户端不做任何预渲染，只负责给出正确的 Content-Type。
- *
- * 全程仅用 CBC 自身会话的 access token（authManager.buildAuthHeaders）+
- * productManager.getEndpoint()，无需额外 env / token。
- *
- * 开关见 artifact-common.isArtifactToolEnabled（env 新旧名 → 云端 feature 新旧 key → 缺省开）。
- */
-export declare class ArtifactTool extends BaseTool implements Tool {
-    protected readonly authManager: AuthenticationManager;
-    protected readonly productManager: ProductManager;
-    protected readonly abTestService?: AbTestService;
-    protected readonly logger: Logger;
-    name: ToolNames;
-    aliases: string[];
-    description: string;
-    parameters: z.ZodObject<{
-        filePath: z.ZodString;
-        existingShareLink: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        filePath: string;
-        existingShareLink?: string | undefined;
-    }, {
-        filePath: string;
-        existingShareLink?: string | undefined;
-    }>;
-    isEnabled: (_args: {
-        runContext: RunContext<Session>;
-        agent: Agent;
-    }) => Promise<boolean>;
-    execute(input: z.infer<typeof ArtifactParameters>, _context: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * 把上传失败转成用户可读结果。
-     *
-     * 后端已把「文件过大 / 内容审核未通过」明确成业务错误码（见 WorkBuddy `share/facade.ts`
-     * 对 56040 / 619610 的 errorCode 回传），这里按同一口径给出精准文案，其余保留通用文案 +
-     * 诊断片段，确保任何失败都不会静默。
-     *
-     * 失败详情由调用方（uploadToKnowledge）以返回值传入，不落在实例字段——工具是单例，
-     * 若两次 execute() 并发（Agents SDK 一轮内并行跑多个工具调用），实例字段会被彼此覆盖，
-     * 导致一次调用报出另一次调用的错误码/诊断文案。
-     */
-    private buildFailureResult;
-    /**
-     * 知识空间上传路径（国内 / iOA，严格复刻 WorkBuddy share/facade.ts uploadToKnowledge）：
-     *   1. POST /space/api/view/import/uploadCredential → 预签名 URL + cosKey + STS 头
-     *   2. PUT 到 COS（带 STS 头）
-     *   3. POST /space/api/view/import/importLocalFileAsync → taskId
-     *   4. 轮询 /space/api/view/import/queryImportFileProgress → publishUrl
-     *
-     * 成功返回 `{ shareLink, nodeId }`，失败返回 `{ failure }`（诊断文案 + 可选的精准错误码）。
-     * 失败详情作为返回值而非实例字段传递，避免并发 execute() 调用互相覆盖对方的诊断状态。
-     *
-     * `nodeBlockId` 非空时后端覆盖该既有节点（见 workbuddy-server `share/contract.ts`
-     * 的 KnowledgeUploadParams.nodeBlockId），从而 republish 到同一链接。
-     */
-    private uploadToKnowledge;
-    /**
-     * 把节点设为「互联网公开可读」（对齐 WorkBuddy `setPublicPermission` 的 public_read→reader）。
-     *
-     * 后端契约 POST /space/api/permission/set-permission：
-     *   body `{ recordId: <nodeId>, public: { role: "reader" } }`，成功判据 code === 0
-     *   （见 workbuddy-server `share/facade.ts` setPublicPermission）。
-     *
-     * markdown 导入的 doc 节点默认私有，必须补这一步分享链接才对外可读。
-     * 失败不视为致命错误：返回 `{ ok: false, detail }`，由调用方降级为「链接已生成但可能仍私有」的警告。
-     */
-    private setPublicRead;
-    /**
-     * 轮询异步导入进度（与 WorkBuddy pollImportProgress 对齐）。
-     * 最长等待 60s，done 时返回结果，failed/超时返回 `{ failure }`。
-     */
-    private pollImportProgress;
-    /** 归一化本地路径（兼容 file:// 与 Windows 盘符）。 */
-    private normalizeLocalPath;
-}
-export {};

package/cli/dist-server/types/node/tools/ask-user-for-structured-input-tool.d.ts

@@ -1,127 +0,0 @@
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { type FunctionCallItem } from '../../vendor/cbc-shared/node/index.js';
-import { SdkHooksManager } from '../control-signal/control-signal-protocol';
-import { ElicitationService } from '../elicitation/elicitation-service';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-/**
- * 是否启用本 tool 的 env 开关。
- * - 缺省 / 空串 / '0' / 'false' 视为关闭；
- * - 其他任意非空值视为开启（与 CBC 其它 `CODEBUDDY_ENABLE_*` 家族保持一致）。
- * 读取放在运行时方法内、每次调用时 live 读，遵循 packages/agent-cli/CODEBUDDY.md
- * 的 prewarm env 契约（禁止模块顶层 / 构造函数固化 per-session env）。
- */
-export declare const ASK_STRUCTURED_INPUT_ENV_FLAG = "CODEBUDDY_ENABLE_ASK_USER_FOR_STRUCTURED_INPUT";
-export declare function isAskUserForStructuredInputEnvEnabled(): boolean;
-declare const AskUserForStructuredInputParameters: z.ZodObject<{
-    message: z.ZodString;
-    requestedSchema: z.ZodObject<{
-        type: z.ZodLiteral<"object">;
-        properties: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        additionalProperties: z.ZodOptional<z.ZodBoolean>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        type: z.ZodLiteral<"object">;
-        properties: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        additionalProperties: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        type: z.ZodLiteral<"object">;
-        properties: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        additionalProperties: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    requestedSchema: {
-        type: "object";
-        properties: Record<string, Record<string, unknown>>;
-        required?: string[] | undefined;
-        additionalProperties?: boolean | undefined;
-    } & {
-        [k: string]: unknown;
-    };
-}, {
-    message: string;
-    requestedSchema: {
-        type: "object";
-        properties: Record<string, Record<string, unknown>>;
-        required?: string[] | undefined;
-        additionalProperties?: boolean | undefined;
-    } & {
-        [k: string]: unknown;
-    };
-}>;
-export type AskUserForStructuredInputInput = z.infer<typeof AskUserForStructuredInputParameters>;
-export declare class AskUserForStructuredInputTool extends BaseTool implements Tool {
-    protected readonly elicitationService: ElicitationService;
-    protected readonly sdkHooksManager: SdkHooksManager;
-    name: ToolNames;
-    /**
-     * Description 保持精简 + 泛化，只讲"是什么、什么时候用"，不绑定业务场景。
-     * 具体场景的用法（例如 MCP 授权征询）通过 `--append-system-prompt` 追加，
-     * 详见 `packages/agent-cli/prompts/examples/mcp-auth-elicitation.md`。
-     */
-    description: string;
-    parameters: z.ZodObject<{
-        message: z.ZodString;
-        requestedSchema: z.ZodObject<{
-            type: z.ZodLiteral<"object">;
-            properties: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            additionalProperties: z.ZodOptional<z.ZodBoolean>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            type: z.ZodLiteral<"object">;
-            properties: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            additionalProperties: z.ZodOptional<z.ZodBoolean>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            type: z.ZodLiteral<"object">;
-            properties: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            additionalProperties: z.ZodOptional<z.ZodBoolean>;
-        }, z.ZodTypeAny, "passthrough">>;
-    }, "strip", z.ZodTypeAny, {
-        message: string;
-        requestedSchema: {
-            type: "object";
-            properties: Record<string, Record<string, unknown>>;
-            required?: string[] | undefined;
-            additionalProperties?: boolean | undefined;
-        } & {
-            [k: string]: unknown;
-        };
-    }, {
-        message: string;
-        requestedSchema: {
-            type: "object";
-            properties: Record<string, Record<string, unknown>>;
-            required?: string[] | undefined;
-            additionalProperties?: boolean | undefined;
-        } & {
-            [k: string]: unknown;
-        };
-    }>;
-    /**
-     * Tool 本身就是"征询用户答复"，弹 UI 的语义已经内建在 elicitation/create
-     * 上；再走一层 session/request_permission 只会让用户点两次（先"允许"、
-     * 再填表单）。与 AskUserQuestion 同款处理：不走审批门。
-     */
-    needsApproval: boolean;
-    argumentRenderer: ToolCallArgumentRenderer;
-    /**
-     * 门控：env + capability + 可用通道。任一未满足即从模型可见工具列表中移除。
-     * 与 AskUserQuestion 保持相同的写法风格，便于日后维护。
-     */
-    isEnabled: (args: {
-        runContext: RunContext<Session>;
-    }) => boolean;
-    execute(input: AskUserForStructuredInputInput, context?: RunContext<Session>, details?: {
-        toolCall: FunctionCallItem;
-    }): Promise<ToolResult>;
-    private errorResult;
-}
-export {};