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

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

@@ -1,27 +0,0 @@
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { BaseTool } from './base-tool';
-import { Tool } from './tool-protocol';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-declare const KillShellParameters: z.ZodObject<{
-    shell_id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    shell_id: string;
-}, {
-    shell_id: string;
-}>;
-export declare class KillShellTool extends BaseTool implements Tool {
-    name: ToolNames;
-    aliases: string[];
-    parameters: z.ZodObject<{
-        shell_id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        shell_id: string;
-    }, {
-        shell_id: string;
-    }>;
-    execute(input: z.infer<typeof KillShellParameters>, context: RunContext<Session>): Promise<any>;
-    private formatDuration;
-}
-export {};

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

@@ -1,54 +0,0 @@
-/**
- * LeaveWorktree Agent Tool
- *
- * 允许 Agent 在会话中离开当前 worktree 并切换回原始工作目录。
- * 与 EnterWorktree 对称，确保 worktree 生命周期完整闭环。
- *
- * 没有这个 Tool，Agent 完成工作后只能用 Bash 自行组装 git 命令清理 worktree，
- * 会导致会话状态、工作目录、分支等清理不干净。
- */
-import { z } from 'zod';
-import { BaseTool } from './base-tool';
-import { Tool, ToolResult } from './tool-protocol';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-/**
- * LeaveWorktree 工具参数 schema
- */
-declare const LeaveWorktreeParameters: z.ZodObject<{
-    action: z.ZodOptional<z.ZodEnum<["keep", "remove"]>>;
-    force: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    action?: "keep" | "remove" | undefined;
-    force?: boolean | undefined;
-}, {
-    action?: "keep" | "remove" | undefined;
-    force?: boolean | undefined;
-}>;
-type LeaveWorktreeInput = z.infer<typeof LeaveWorktreeParameters>;
-export declare class LeaveWorktreeTool extends BaseTool implements Tool {
-    name: ToolNames;
-    description: string;
-    aliases: string[];
-    parameters: z.ZodObject<{
-        action: z.ZodOptional<z.ZodEnum<["keep", "remove"]>>;
-        force: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        action?: "keep" | "remove" | undefined;
-        force?: boolean | undefined;
-    }, {
-        action?: "keep" | "remove" | undefined;
-        force?: boolean | undefined;
-    }>;
-    private worktreeSessionManager;
-    private worktreeChangeDetector?;
-    /**
-     * 权限：始终需要用户确认
-     * 原因：会改变进程工作目录，影响后续所有操作
-     */
-    needsApproval: boolean;
-    /**
-     * 执行离开 worktree
-     */
-    execute(input: LeaveWorktreeInput): Promise<ToolResult>;
-}
-export {};

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

@@ -1,35 +0,0 @@
-/**
- * ListColleagues —— Agent Home 通讯录：现有同事 + 频道，都带 id。
- *
- * 为什么必须有它：CreateChannel 要 `memberAgentIds`（id），ChannelTasks / SpeakInChannel
- * 要 `channel`（id），而注入的组队提示为了省 token 会把名册截断（`(+N more)`）——
- * 模型拿不到后面的 id，就只能猜、把已有同事重复建一遍，或者干脆卡住问用户。
- * 一次调用把「有谁、在哪几个频道、谁是 lead」给全。
- *
- * 只读：走 channelsForSelf（和工具口径一致），不拿目录锁。
- */
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-import type { RunContext } from '../../vendor/cbc-shared/node/index.js';
-import { Logger } from '@genie/telemetry';
-import { z } from 'zod';
-import { SettingsManager } from '../settings/settings-protocol';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolNames, ToolResult } from './tool-protocol';
-export declare class ListColleaguesTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly settingsManager?: SettingsManager;
-    name: ToolNames;
-    description: string;
-    needsApproval: boolean;
-    shouldShowInToolSearch: () => boolean;
-    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    toAutoClassifierInput(_input: unknown): string;
-    isEnabled: (args?: {
-        runContext?: RunContext<Session>;
-        agent?: {
-            name?: string;
-        };
-    }) => Promise<boolean>;
-    execute(_input: unknown, context?: RunContext<Session>): Promise<ToolResult>;
-}

package/cli/dist-server/types/node/tools/list-mcp-resources-tool.d.ts

@@ -1,58 +0,0 @@
-import { Logger } from '@celljs/core';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { z } from 'zod';
-import { McpResourceCatalogService } from '../mcp/mcp-resource-catalog-protocol';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-declare const ListMcpResourcesParameters: z.ZodObject<{
-    server: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    server?: string | undefined;
-}, {
-    server?: string | undefined;
-}>;
-type ListMcpResourcesInput = z.infer<typeof ListMcpResourcesParameters>;
-/**
- * ListMcpResources — list all resources/templates exposed by connected MCP
- * servers.
- *
- * Pairs with `ReadMcpResource`. The two-tool split (vs. the previous single
- * `FetchMcpResource` that baked the resource catalog into its description)
- * keeps the system prompt small even when an MCP server exposes many
- * resources, and matches the upstream Claude Code naming convention
- * (ListMcpResourcesTool / ReadMcpResourceTool). Issue #40458.
- */
-export declare class ListMcpResourcesTool extends BaseTool implements Tool {
-    protected readonly catalogService: McpResourceCatalogService;
-    protected readonly logger: Logger;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        server: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        server?: string | undefined;
-    }, {
-        server?: string | undefined;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    /** Read-only — no approval needed. */
-    needsApproval: boolean;
-    /**
-     * Enable the tool when a connected server declares the `resources`
-     * capability, rather than when a live listing happens to return rows.
-     *
-     * Issue #102572: the old gate counted actual resources, so an 8s
-     * `resources/list` timeout on one slow server (企查查 connector) collapsed
-     * the count to zero and removed this tool — and ReadMcpResource with it —
-     * from the model's tool list mid-session, restoring it on the next turn.
-     * Observed gaps between a successful and a failing listing ranged from
-     * milliseconds to four hours, so no cache window can paper over it. The
-     * capability is captured during `initialize` and read from memory, so it
-     * cannot time out and stays stable for the life of the connection.
-     */
-    isEnabled: () => Promise<boolean>;
-    execute(input: ListMcpResourcesInput, _context: RunContext<Session>): Promise<ToolResult>;
-}
-export { ListMcpResourcesParameters };
-export type { ListMcpResourcesInput };

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

@@ -1,68 +0,0 @@
-/**
- * LSP Tool - 与 LSP 服务器交互以获取代码智能功能
- */
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { Workspace } from '@genie/runtime';
-import { Logger } from '@genie/telemetry';
-import { z } from 'zod';
-import { LSPManager } from '../lsp';
-import { BaseTool } from './base-tool';
-import { Tool, ToolResult } from './tool-protocol';
-declare const LspParameters: z.ZodObject<{
-    operation: z.ZodEnum<["goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol", "goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls"]>;
-    filePath: z.ZodString;
-    line: z.ZodNumber;
-    character: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    operation: "documentSymbol" | "findReferences" | "goToDefinition" | "goToImplementation" | "hover" | "incomingCalls" | "outgoingCalls" | "prepareCallHierarchy" | "workspaceSymbol";
-    filePath: string;
-    line: number;
-    character: number;
-}, {
-    operation: "documentSymbol" | "findReferences" | "goToDefinition" | "goToImplementation" | "hover" | "incomingCalls" | "outgoingCalls" | "prepareCallHierarchy" | "workspaceSymbol";
-    filePath: string;
-    line: number;
-    character: number;
-}>;
-export declare class LspTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly workspace: Workspace;
-    protected readonly lspManager: LSPManager;
-    name: ToolNames;
-    aliases: string[];
-    description: string;
-    parameters: z.ZodObject<{
-        operation: z.ZodEnum<["goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol", "goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls"]>;
-        filePath: z.ZodString;
-        line: z.ZodNumber;
-        character: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        operation: "documentSymbol" | "findReferences" | "goToDefinition" | "goToImplementation" | "hover" | "incomingCalls" | "outgoingCalls" | "prepareCallHierarchy" | "workspaceSymbol";
-        filePath: string;
-        line: number;
-        character: number;
-    }, {
-        operation: "documentSymbol" | "findReferences" | "goToDefinition" | "goToImplementation" | "hover" | "incomingCalls" | "outgoingCalls" | "prepareCallHierarchy" | "workspaceSymbol";
-        filePath: string;
-        line: number;
-        character: number;
-    }>;
-    private readonly MAX_RESULTS;
-    execute(input: z.infer<typeof LspParameters>, context: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * 执行 LSP 操作
-     */
-    private performOperation;
-    private goToDefinition;
-    private findReferences;
-    private hover;
-    private documentSymbol;
-    private workspaceSymbol;
-    private goToImplementation;
-    private prepareCallHierarchy;
-    private callHierarchy;
-    private formatSymbols;
-    private getSymbolKindName;
-}
-export {};

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

@@ -1,107 +0,0 @@
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { AgentManager } from '../../vendor/cbc-core/node/index.js';
-import { AgentTaskManager } from '../agent-task/agent-task-protocol';
-import { GoalService } from '@genie/cbc-goal';
-import { InterruptionService, Session } from '../../vendor/cbc-core/node/index.js';
-import { BaseTool } from './base-tool';
-import { Tool, ToolResult } from './tool-protocol';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-declare const ListAgentsParameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-export declare class ListAgentsTool extends BaseTool implements Tool {
-    protected readonly agentManager: AgentManager;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-    needsApproval: boolean;
-    execute(_input: z.infer<typeof ListAgentsParameters>, context?: RunContext<Session>): Promise<ToolResult>;
-}
-declare const InterruptAgentParameters: z.ZodObject<{
-    sessionId: z.ZodString;
-    reason: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    sessionId: string;
-    reason?: string | undefined;
-}, {
-    sessionId: string;
-    reason?: string | undefined;
-}>;
-export declare class InterruptAgentTool extends BaseTool implements Tool {
-    /**
-     * 必须走 AgentTaskManager（与 TaskStop 同一条路）取消**活跃**任务。
-     *
-     * 不要用 `sessionManager.get(id)` 拿目标再 abort —— SessionStore 无活跃缓存，
-     * get() 从磁盘反序列化出一个**全新** Session（sessionFactory 无条件 new
-     * AbortController），abort 打在废弃副本上，对真正在跑的 run 是空操作；
-     * `cancelAllForSession(子会话id)` 也查不到以主会话 id 为键的审批队列。
-     * AgentTask.cancel() 持有活的 subAgentSession 引用，abort 才真正生效。
-     */
-    protected readonly agentTaskManager: AgentTaskManager;
-    protected readonly interruptionService: InterruptionService;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        sessionId: z.ZodString;
-        reason: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        sessionId: string;
-        reason?: string | undefined;
-    }, {
-        sessionId: string;
-        reason?: string | undefined;
-    }>;
-    needsApproval: boolean;
-    execute(input: z.infer<typeof InterruptAgentParameters>, context?: RunContext<Session>): Promise<ToolResult>;
-    /** 当前会话所属树的主会话 id；解析失败回退自身 id（顶层会话本来就是自身）。 */
-    private currentMainSessionId;
-}
-/**
- * `GoalService.set` 已是「设定/替换」语义（有目标时先注销再设，见 goal-protocol），
- * 所以 CreateGoal / UpdateGoal 共用同一个 schema 与同一条执行路径，只是名字不同 ——
- * 保留两个名字是为了让模型无论选哪个都能成功，而不是两套行为。
- */
-declare const GoalConditionParameters: z.ZodObject<{
-    condition: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    condition: string;
-}, {
-    condition: string;
-}>;
-export declare class CreateGoalTool extends BaseTool implements Tool {
-    protected readonly goalService: GoalService;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        condition: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        condition: string;
-    }, {
-        condition: string;
-    }>;
-    needsApproval: boolean;
-    execute(input: z.infer<typeof GoalConditionParameters>, context?: RunContext<Session>): Promise<ToolResult>;
-}
-declare const GetGoalParameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-export declare class GetGoalTool extends BaseTool implements Tool {
-    protected readonly goalService: GoalService;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-    needsApproval: boolean;
-    execute(_input: z.infer<typeof GetGoalParameters>, context?: RunContext<Session>): Promise<ToolResult>;
-}
-export declare class UpdateGoalTool extends BaseTool implements Tool {
-    protected readonly goalService: GoalService;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        condition: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        condition: string;
-    }, {
-        condition: string;
-    }>;
-    needsApproval: boolean;
-    execute(input: z.infer<typeof GoalConditionParameters>, context?: RunContext<Session>): Promise<ToolResult>;
-}
-export {};

package/cli/dist-server/types/node/tools/malicious-block-guidance.d.ts

@@ -1,11 +0,0 @@
-/**
- * 恶意网站命中后给模型的两句引导语，沙箱拦截与 WebFetch 拦截共用。
- *
- * 必须显式禁止换工具重试：否则模型会很自然地改用 Bash curl 再试一次，虽然沙箱侧
- * 会再拦一次，但那已经违背需求「命中后不得换命令或工具重试」。
- *
- * 两条路径的渲染格式不同（沙箱按行输出、WebFetch 拼成一句），所以只共用句子本身，
- * 不共用拼装逻辑。
- */
-export declare const MALICIOUS_BLOCK_NO_RETRY_HINT = "Do NOT retry this request with another command, tool, protocol, or workaround.";
-export declare const MALICIOUS_BLOCK_WHITELIST_HINT = "If access is required, ask the user to add the domain to the whitelist in Settings \u2192 Security Center \u2192 Network Security.";

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

@@ -1,33 +0,0 @@
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { MemoryManager } from '../memory';
-import { BaseTool } from './base-tool';
-import { Tool, ToolResult } from './tool-protocol';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-declare const MemoryParameters: z.ZodObject<{
-    fact: z.ZodString;
-    scope: z.ZodEnum<["user", "project", "project_local"]>;
-}, "strip", z.ZodTypeAny, {
-    fact: string;
-    scope: "project" | "project_local" | "user";
-}, {
-    fact: string;
-    scope: "project" | "project_local" | "user";
-}>;
-export declare class MemoryTool extends BaseTool implements Tool {
-    protected readonly memoryManager: MemoryManager;
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        fact: z.ZodString;
-        scope: z.ZodEnum<["user", "project", "project_local"]>;
-    }, "strip", z.ZodTypeAny, {
-        fact: string;
-        scope: "project" | "project_local" | "user";
-    }, {
-        fact: string;
-        scope: "project" | "project_local" | "user";
-    }>;
-    execute(input: z.infer<typeof MemoryParameters>, context?: RunContext): Promise<ToolResult>;
-}
-export {};

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

@@ -1,79 +0,0 @@
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-import { type RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { Logger } from '@genie/telemetry';
-import { z } from 'zod';
-import { SettingsManager } from '../settings/settings-protocol';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-/**
- * MessageColleague —— Agent Home 的 1:1（通讯录可达即能发）。
- *
- * 目标是"某个人"（上游 SendToAgent 的语义），不是"某个房间成员"：
- * 同事发到他的 job 收件箱（死了就拉起）；主 Agent（委托人）发到主会话邮箱
- * （落盘，主会话 idle 时注入）。频道群对话走 SpeakInChannel，不是这个工具。
- * 和 Agent Teams 的 SendMessage 无关。
- */
-export declare class MessageColleagueTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly settingsManager?: SettingsManager;
-    name: ToolNames;
-    description: string;
-    needsApproval: boolean;
-    /**
-     * 通讯录里没人（且不是自己）时，它既不在工具列表里，也不出现在 ToolSearch 的
-     * "Available deferred tools" 描述里，模型不会知道有这么个东西。
-     */
-    shouldShowInToolSearch: () => boolean;
-    parameters: z.ZodObject<{
-        action: z.ZodOptional<z.ZodEnum<["list", "send", "incoming"]>>;
-        recipient: z.ZodOptional<z.ZodString>;
-        content: z.ZodOptional<z.ZodString>;
-        summary: z.ZodOptional<z.ZodString>;
-        from: z.ZodOptional<z.ZodString>;
-        text: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        action?: "incoming" | "list" | "send" | undefined;
-        recipient?: string | undefined;
-        content?: string | undefined;
-        summary?: string | undefined;
-        from?: string | undefined;
-        text?: string | undefined;
-    }, {
-        action?: "incoming" | "list" | "send" | undefined;
-        recipient?: string | undefined;
-        content?: string | undefined;
-        summary?: string | undefined;
-        from?: string | undefined;
-        text?: string | undefined;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    /**
-     * 房间 ACL 已经挡住了能联系谁；问候同事不必再走 auto 分类器，
-     * 否则模型已经决定发了，UI 还会再问一次确认。
-     */
-    toAutoClassifierInput(_input: unknown): string;
-    private cachedTargets?;
-    private cachedAt;
-    /** 通讯录里还有别人 → 工具出现。主 Agent 也算（同事要能回报它）。 */
-    private hasReachableTarget;
-    private targets;
-    /**
-     * 极简没有组队 / 互感知：工具不出现。其他人走通讯录（有人就能发）。
-     */
-    isEnabled: (args?: {
-        runContext?: RunContext<Session>;
-        agent?: {
-            name?: string;
-        };
-    }) => Promise<boolean>;
-    /** 每个成员此刻在干嘛：读的是和侧栏同一份 Run 状态，不另开数据源。 */
-    private describeContact;
-    execute(input: {
-        action?: string;
-        recipient?: string;
-        content?: string;
-        summary?: string;
-        from?: string;
-        text?: string;
-    }, context?: RunContext<Session>): Promise<ToolResult>;
-}