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

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

@@ -1,65 +0,0 @@
-/**
- * WeComReply Tool
- *
- * Allows the AI to send replies back to WeCom (企业微信) users via the WecomBotChannelBridge.
- * Dynamically enabled/disabled based on WeCom connection status.
- * Supports multiple client instances — any connected instance enables the tool.
- *
- * Supports:
- *   - text: plain markdown text
- *   - image_url: image URL (data: or http:) to upload and send
- *   - file_path: local file path to upload and send
- *   - file_url: remote file URL to download and send
- */
-import { z } from 'zod';
-import type { RunContext } from '../../vendor/cbc-shared/node/index.js';
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-import { BaseTool } from './base-tool';
-import { Tool, type ToolResult } from './tool-protocol';
-export declare class WecomReplyTool extends BaseTool implements Tool {
-    name: string;
-    description: string;
-    needsApproval: boolean;
-    /**
-     * Enabled when any WeCom client instance is connected.
-     */
-    isEnabled: () => boolean;
-    parameters: z.ZodObject<{
-        chat_id: z.ZodString;
-        text: z.ZodOptional<z.ZodString>;
-        image_url: z.ZodOptional<z.ZodString>;
-        file_path: z.ZodOptional<z.ZodString>;
-        file_url: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        chat_id: string;
-        text?: string | undefined;
-        image_url?: string | undefined;
-        file_path?: string | undefined;
-        file_url?: string | undefined;
-    }, {
-        chat_id: string;
-        text?: string | undefined;
-        image_url?: string | undefined;
-        file_path?: string | undefined;
-        file_url?: string | undefined;
-    }>;
-    execute(input: {
-        chat_id: string;
-        text?: string;
-        image_url?: string;
-        file_path?: string;
-        file_url?: string;
-    }, context?: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * Upload and send media via WebSocket (WecomBotClient.uploadMedia + sendMediaMessage).
-     */
-    private sendMedia;
-    /**
-     * Detect WeCom media type from filename extension.
-     */
-    private detectMediaType;
-    /**
-     * Convert URL (data: or http:) or local path to Buffer.
-     */
-    private urlToBuffer;
-}

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

@@ -1,100 +0,0 @@
-/**
- * WorkflowTool —— 把 Dynamic Workflow 暴露给 LLM 主 agent 的 Tool 入口。
- *
- * 单一职责:协议适配。校验 input → 转交 WorkflowManager.start() → **立刻**返回 runId,
- * 不阻塞主对话。workflow 在后台跑,主 agent 可以继续做其他事。
- *
- * 设计取舍(对齐 Claude Code 的 async_launched 行为,见反编译 `wf_full.txt:251499`):
- * - cc 的 Workflow tool 是 fire-and-forget:`(async () => { ... })().catch(...)` 后立刻
- *   `return { data: { status: "async_launched", ... } }`。我们对齐这个语义。
- * - **Sub-agent 静音**:adapter 用 detached:true,不刷屏到主对话区;用户在 status-line /
- *   `/workflows` panel 看实时进度。
- * - **后台任务复用**:workflow run 当成一个 BackgroundTask 注册到 ToolManager,
- *   完成时复用 BackgroundTaskNotifier 推 `<task-notification>` 给主 agent
- *   (与 bash run_in_background / PowerShell 后台任务共用同一通知通道)。
- *   `<output-file>` 落盘到用户隔离临时目录的 `agent-tasks/<runId>.output`,模型用
- *   TaskOutput 工具拉完整结果。
- *
- * 使用约定(opt-in,见 description):
- * - 主 agent 默认不调用此工具。
- * - 仅在用户明确说 "use a workflow"、"run a workflow"、或在 prompt 中写
- *   `ultracode` 关键词、或调用一个已保存的 workflow 命令时才用。
- * - 用户日常请求(单轮可解、不需要多 agent 并行)不要起 workflow。
- */
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { type Agent, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { type WorkflowManager, type WorkflowToolInput } from '@genie/cbc-workflow';
-import { type ICwdService } from '@genie/cbc-worktree';
-import { Logger } from '@genie/telemetry';
-import { type FunctionCallItem, type RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { AgentTaskOutputFileManager, BackgroundTaskNotifier } from '../agent-task/agent-task-protocol';
-import { BaseTool } from './base-tool';
-import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-export declare class WorkflowTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly manager: WorkflowManager;
-    protected readonly cwdService: ICwdService;
-    protected readonly backgroundTaskNotifier: BackgroundTaskNotifier;
-    protected readonly outputFileManager: AgentTaskOutputFileManager;
-    name: ToolNames;
-    /**
-     * 真正的描述来自 product.tools[].description (=> 模板 `workflow-tool-description`),
-     * 由框架在工具装配时通过 PromptManager 解出来覆写 BaseTool.description。
-     * 这里的占位仅在 product 配置里没声明该工具时兜底。
-     */
-    description: string;
-    parameters: z.ZodObject<{
-        script: z.ZodOptional<z.ZodString>;
-        scriptPath: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        args: z.ZodOptional<z.ZodString>;
-        resumeFromRunId: z.ZodOptional<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        script?: string | undefined;
-        scriptPath?: string | undefined;
-        name?: string | undefined;
-        args?: string | undefined;
-        resumeFromRunId?: string | undefined;
-    }, {
-        script?: string | undefined;
-        scriptPath?: string | undefined;
-        name?: string | undefined;
-        args?: string | undefined;
-        resumeFromRunId?: string | undefined;
-    }>;
-    /**
-     * 工具卡片的标题:`Workflow(<source>)`,对齐 Claude TUI 截图。
-     * <source> 优先级 = name > scriptPath > "dynamic workflow"
-     */
-    argumentRenderer: ToolCallArgumentRenderer;
-    needsApproval: boolean;
-    /**
-     * 总开关:env 或 settings 任一标记禁用时,本工具就不会被装配进 agent 工具集,
-     * LLM 看不到也调不到。对齐 CC 的 `disableWorkflows` 能力。
-     * 实现细节:见 workflow/workflow-disabled.ts。
-     */
-    isEnabled: (_args: {
-        runContext: RunContext<Session>;
-        agent: Agent;
-    }) => Promise<boolean>;
-    execute(input: WorkflowToolInput, context?: RunContext<Session>, details?: {
-        toolCall: FunctionCallItem;
-    }): Promise<ToolResult>;
-    /**
-     * 把 workflow run 注册到 ToolManager 的后台任务池。
-     * - task.id 复用 runId,让 TaskOutput 能直接按模型给的 task_id 查到
-     * - stdout/stderr 留空 buffer:workflow 没有流式输出,但接口要求非空
-     * - kill wire 到 manager.abort,让模型/UI 调 KillBash 之类等价操作能终止 workflow
-     * - toolUseId 透传给 BackgroundTaskNotifier 拼 `<tool-use-id>` XML 字段
-     */
-    private registerBackgroundTask;
-    /**
-     * Workflow 完成 / 失败 / abort 时:
-     *   1. 把 record.output 落盘到用户隔离临时目录的 agent-tasks/<runId>.output
-     *      (跟 sub-agent output 共用一套 AgentTaskOutputFileManager)
-     *   2. 翻 task 状态,通知 UI 更新
-     *   3. 调 BackgroundTaskNotifier 推 `<task-notification>` 给主 agent
-     */
-    private finalizeBackgroundTask;
-}

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

@@ -1,74 +0,0 @@
-import { Workspace } from '@genie/runtime';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { CodeRatioReportingService } from '../code-ratio';
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { TelemetryService } from '../telemetry';
-import { SandboxPermissionFileTool } from './sandbox-permission-file-tool';
-import { ReadFileStateService, Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-import { ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-declare const WriteParameters: z.ZodObject<{
-    file_path: z.ZodString;
-    content: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    file_path: string;
-    content: string;
-}, {
-    file_path: string;
-    content: string;
-}>;
-export declare class WriteTool extends SandboxPermissionFileTool implements Tool {
-    protected readonly workspace: Workspace;
-    protected readonly telemetryService: TelemetryService;
-    protected readonly readFileStateService: ReadFileStateService;
-    protected readonly codeRatioReportingService?: CodeRatioReportingService;
-    name: ToolNames;
-    aliases: string[];
-    parameters: z.ZodObject<{
-        file_path: z.ZodString;
-        content: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        file_path: string;
-        content: string;
-    }, {
-        file_path: string;
-        content: string;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    resolveNeedPermissionArgs(runContext: RunContext, input: z.infer<typeof WriteParameters>, callId?: string): ToolArg[];
-    /**
-     * Auto mode classifier projection: `${file_path}: ${content}` (strict Claude
-     * alignment, decision D1). The full content is intentionally projected — the
-     * classifier judges whether the written content is dangerous / a payload.
-     */
-    toAutoClassifierInput(input: unknown): string;
-    /**
-     * Map thrown non-ToolExecutionError failures to tool-specific error codes.
-     * Sandbox-related failures are kept here so hook manager no longer hard-codes
-     * Write-tool message matching.
-     */
-    resolveThrownErrorCode(error: unknown): string | undefined;
-    execute(input: z.infer<typeof WriteParameters>, context: RunContext<Session>): Promise<ToolResult>;
-    /**
-     * 将 Write 工具底层异常映射到 2000 段细分错误码。
-     * 重点覆盖沙箱 ModifyBackup 失败（pre-tool 或 write 阶段），避免落 99999。
-     */
-    private classifyWriteError;
-    private validateToolParams;
-    private checkFileExists;
-    private writeFileContent;
-    /**
-     * Prepend a UTF-8 BOM for new CSV/TSV files so Windows Excel decodes CJK
-     * characters correctly (#54660), or re-add the original file's BOM on
-     * overwrite (the model-supplied content usually lacks one).
-     */
-    private shouldWriteUtf8Bom;
-    private reportFileAction;
-    /**
-     * 全文 diff 超时兜底：无法精确到「变化的行」，退化为按整份行数/字符数估算。
-     * 新建文件 old 为空 → removed=0；覆盖已有文件视为「删旧全部 + 写新全部」（会把未改动的保留行也计入，数值偏大）。
-     * 仅超大文件覆写触发 diff 超时时才走到，极罕见。
-     */
-    private estimateChangesByLineCount;
-}
-export {};

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

@@ -1,39 +0,0 @@
-/** 记录方向：`out` = CLI 发出（stdout）；预留 `in` 便于后续扩展 stdin 记录。 */
-export type StdioDirection = 'in' | 'out';
-/**
- * 每次调用都 live 读 env，避免在容器装配阶段冻结值，导致 prewarm 命中的进程
- * 拿不到 daemon 后来透传的开关。
- */
-export declare function isStdioPersistenceEnabled(): boolean;
-/**
- * 一个通道：一条落盘管线，对应磁盘上的一个 .jsonl 文件。写入串行 await 避免
- * 交织；append 失败静默计数。调用侧永远不 await 返回值。
- */
-export interface StdioChannel {
-    append(direction: StdioDirection, message: unknown): void;
-    /**
-     * 等所有已排队的 append 真正落到磁盘。CLI 退出前调用，避免进程先于
-     * `appendFile` microtask 结束造成落盘丢失。永不 reject。
-     */
-    flush(): Promise<void>;
-    /** 累计静默丢弃的记录条数（排障 / 测试用）。 */
-    readonly failedWrites: number;
-}
-/**
- * 打开 stream-json 落盘通道。**只在 env 启用时才调用**——调用侧先判 flag，
- * 避免这里内部再判导致误开无用文件。
- *
- * @param sessionId session id（写盘目录用）
- * @param projectId 可选；默认取 `PathUtils.getCompressedWorkDir()`（对齐现有 session 目录约定）
- */
-/**
- * 打开 stream-json 落盘通道。**只在 env 启用时才调用**——调用侧先判 flag，
- * 避免这里内部再判导致误开无用文件。
- *
- * 每次调用产生独立的 run 子目录（`{ISO-timestamp}-{pid}`），因此同一 sessionId
- * 反复启动不会互相覆盖。
- *
- * @param sessionId session id
- * @param projectId 可选；默认取 `PathUtils.getCompressedWorkDir()`（对齐现有 session 目录约定）
- */
-export declare function openStreamJsonChannel(sessionId: string, projectId?: string): StdioChannel;