@tencent-ai/agent-harness 0.2.0-beta.7 → 0.2.0-beta.8

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

@@ -0,0 +1,129 @@
+import { AgentManager, PromptRenderer, Session } from '../../vendor/cbc-core/node/index.js';
+import { type FunctionCallItem, ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { EventService, Logger } from '../../workspace/telemetry/lib/common/index.js';
+import type { RunContext } from '@openai/agents';
+import { z } from 'zod';
+import { AgentTaskManager } from '../agent-task/agent-task-protocol';
+import { CommandManager, CustomCommandRenderer } from '../command';
+import { SettingsManager } from '../settings/settings-protocol';
+import { BaseTool } from './base-tool';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+declare const SkillParameters: z.ZodEffects<z.ZodObject<{
+    skill: z.ZodOptional<z.ZodString>;
+    command: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    command?: string | undefined;
+    skill?: string | undefined;
+    args?: string | undefined;
+}, {
+    command?: string | undefined;
+    skill?: string | undefined;
+    args?: string | undefined;
+}>, {
+    command?: string | undefined;
+    skill?: string | undefined;
+    args?: string | undefined;
+}, {
+    command?: string | undefined;
+    skill?: string | undefined;
+    args?: string | undefined;
+}>;
+export declare class SkillTool extends BaseTool implements Tool {
+    protected readonly productManager: ProductManager;
+    protected readonly customCommandRenderer: CustomCommandRenderer;
+    protected readonly promptRenderer: PromptRenderer;
+    protected readonly logger: Logger;
+    protected readonly taskManager: AgentTaskManager;
+    protected readonly commandManager: CommandManager;
+    protected readonly agentManager: AgentManager;
+    protected readonly eventService: EventService;
+    protected readonly settingsManager: SettingsManager;
+    private readonly disabledCallsBySession;
+    name: ToolNames;
+    readonly promptCacheStability: "volatile";
+    aliases: string[];
+    parameters: z.ZodEffects<z.ZodObject<{
+        skill: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command?: string | undefined;
+        skill?: string | undefined;
+        args?: string | undefined;
+    }, {
+        command?: string | undefined;
+        skill?: string | undefined;
+        args?: string | undefined;
+    }>, {
+        command?: string | undefined;
+        skill?: string | undefined;
+        args?: string | undefined;
+    }, {
+        command?: string | undefined;
+        skill?: string | undefined;
+        args?: string | undefined;
+    }>;
+    needsApproval: (runContext: RunContext<Session>, input: unknown, callId?: string) => Promise<boolean>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    resolveNeedPermissionArgs(runContext: RunContext, input: z.infer<typeof SkillParameters>, callId?: string): ToolArg[];
+    execute(input: z.infer<typeof SkillParameters>, context: RunContext<Session>, details?: {
+        toolCall: FunctionCallItem;
+    }): Promise<ToolResult>;
+    /**
+     * Execute a slash command (from commands configuration or built-in commands)
+     */
+    private executeSlashCommand;
+    /**
+     * Try to execute a built-in command. Returns null if not a built-in command.
+     */
+    private tryExecuteBuiltinCommand;
+    /**
+     * Find a skill by name, supporting exact match, short name match, and displayName fallback.
+     * For short names (without ':'), if multiple skills share the same short name,
+     * returns undefined and sets an ambiguity error message.
+     */
+    private findSkill;
+    /**
+     * Execute a skill (from skills configuration)
+     * If skill not found, try to find as slash command
+     */
+    private executeSkill;
+    protected safeRender(promptToRender: string): Promise<string>;
+    /**
+     * 上报插件 skill 能力调用埋点。
+     * 仅当 skill 带 pluginInfo 时触发。
+     * 仅在 WorkBuddy Desktop 宿主下上报；其他宿主（VSCode 插件、纯 CLI 等）各自有独立的上报链路。
+     */
+    private reportPluginCapabilityCall;
+    /**
+     * 上报插件 command 能力调用埋点。
+     * 插件 command 的 tags 形如 [CUSTOM_COMMAND_TAG, PLUGIN_TAG, source]，
+     * 其中 source 形如 "pluginName@marketplaceName"。
+     * 仅在 WorkBuddy Desktop 宿主下上报。
+     */
+    private reportPluginCommandCall;
+    private rememberDisabledCall;
+    private consumeDisabledCall;
+    private validateToolParams;
+    /**
+     * Execute skill in fork context (isolated subagent)
+     * The subagent runs independently without access to main conversation history,
+     * but will load CODEBUDDY.md through the session mechanism.
+     *
+     * Aligns with Claude Code's fork context execution:
+     * - Skill content becomes the prompt (via buildForkPrompt)
+     * - No conversation history is inherited
+     */
+    private executeSkillInForkContext;
+    /**
+     * Build prompt for fork context execution
+     * Aligns with Claude Code's Q06 function behavior:
+     * - Uses getPromptForCommand pattern (Base directory prefix + skill content)
+     * - Processes content through the standard pipeline: $ARGUMENTS → !`command` → @file references
+     * - Does NOT add extra "You are executing skill" prefix
+     */
+    private buildForkPrompt;
+}
+export {};

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

@@ -0,0 +1,51 @@
+import { PromptRenderer, Session } from '../../vendor/cbc-core/node/index.js';
+import { ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import type { RunContext } from '@openai/agents';
+import { z } from 'zod';
+import { CommandManager, CustomCommandRenderer } from '../command';
+import { BaseTool } from './base-tool';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+declare const SlashCommandParameters: z.ZodObject<{
+    command: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+}, {
+    command: string;
+}>;
+export declare class SlashCommandTool extends BaseTool implements Tool {
+    protected readonly productManager: ProductManager;
+    protected readonly customCommandRenderer: CustomCommandRenderer;
+    protected readonly promptRenderer: PromptRenderer;
+    protected readonly commandManager: CommandManager;
+    protected readonly logger: Logger;
+    name: ToolNames;
+    readonly promptCacheStability: "volatile";
+    aliases: string[];
+    parameters: z.ZodObject<{
+        command: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+    }, {
+        command: string;
+    }>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    needsApproval: (runContext: RunContext<Session>, input: z.infer<typeof SlashCommandParameters>, callId?: string) => Promise<boolean>;
+    resolveNeedPermissionArgs(runContext: RunContext, input: z.infer<typeof SlashCommandParameters>, callId?: string): ToolArg[];
+    execute(input: z.infer<typeof SlashCommandParameters>, context: RunContext<Session>): Promise<ToolResult>;
+    /**
+     * Execute a built-in command via CommandManager.
+     */
+    protected executeBuiltinCommand(trimmedCommand: string, commandName: string, context: RunContext<Session>): Promise<ToolResult>;
+    protected safeRender(promptToRender: string): Promise<string>;
+    /**
+     * Bridge a slash command to the mods runtime — thin adapter over
+     * {@link dispatchModCommand}. See that helper's jsdoc for the routing
+     * contract (`{ text }` / `{ deny }` return; empty `{}` falls through).
+     */
+    private tryModsRuntimeCommand;
+    private extractCommandName;
+    private validateToolParams;
+}
+export {};

package/cli/dist-server/types/node/tools/space-upload/errors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SpaceEngine 上传（View API）业务错误码。
+ *
+ * 与 `@genie/agent-provider` 的同名常量保持一致（这里本地声明而非跨包 value import，
+ * 避免 CLI 打包引入 agent-provider 运行时依赖）。
+ */
+/** 知识空间上传业务错误码：文件大小超限（ErrFileTooLarge）。 */
+export declare const KNOWLEDGE_UPLOAD_FILE_TOO_LARGE_CODE = 56040;
+/** 知识空间上传业务错误码：标题命中内容审核（Code_ERR_NODE_BLOCKED）。 */
+export declare const KNOWLEDGE_UPLOAD_MODERATION_BLOCKED_CODE = 619610;
+/** 资料库容量不足（SpaceEngine 业务码），映射为工具的 CAPACITY_EXCEEDED。 */
+export declare const SPACE_CAPACITY_EXCEEDED_CODE = 20010;
+/** 异步解析阶段发现格式不支持（Code_ERR_ZIP_UNSUPPORTED_FILE_TYPE），映射为 UNSUPPORTED_FILE_TYPE。 */
+export declare const SPACE_UNSUPPORTED_FILE_TYPE_CODE = 56042;

package/cli/dist-server/types/node/tools/space-upload/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './errors';
+export * from './upload-file';
+export * from './local-file-source';

package/cli/dist-server/types/node/tools/space-upload/local-file-source.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 本地文件读取（LibraryUpload 的文件访问校验）。
+ *
+ * 顺序是硬约束，缺一不可：
+ *   1. 字符串路径 → `resolveFilePathToWorkDir` 归一化（只接受绝对路径与 file:// URI）；
+ *   2. `realpath` 解析软链；
+ *   3. `stat` 记录 dev/ino，open 后与 `fstat` 比对，把校验过的路径和真正打开的 fd 绑定（防 TOCTOU 替换）；
+ *   4. 基于 `fstat` 判断，只允许普通非空文件。
+ *
+ * 不限制路径落在工作区内：用户主动把任意本地文件交给 agent 上传是正常诉求
+ * （附件常在 Documents / 桌面）。敏感路径由平台侧的 denyRead 规则与工具权限拦截，
+ * 这里只负责「打开的是一个没被换掉的普通文件」。
+ */
+/** 打开本地文件失败的原因，由调用方映射成工具契约错误码。 */
+export type LocalFileFailureCode = 'INVALID_ARGUMENT' | 'PATH_NOT_ALLOWED' | 'FILE_NOT_FOUND' | 'NOT_REGULAR_FILE' | 'EMPTY_FILE';
+export interface LocalFileFailure {
+    code: LocalFileFailureCode;
+    detail?: string;
+}
+export interface LocalFileSource {
+    /** realpath 之后的绝对路径。 */
+    realPath: string;
+    /** 上传用的文件名（basename；调用方如需改名应在传入前校验扩展名一致）。 */
+    fileName: string;
+    size: number;
+    /** 每次调用返回从 0 开始的**新**流；PUT 重试依赖该语义。 */
+    openStream(): NodeJS.ReadableStream;
+    /** 关闭底层 fd（幂等）。 */
+    close(): Promise<void>;
+}
+export declare function openLocalFileSource(rawPath: string): Promise<LocalFileSource | {
+    failure: LocalFileFailure;
+}>;

package/cli/dist-server/types/node/tools/space-upload/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SpaceEngine 上传（View API）公共类型。
+ *
+ * 抽自 `artifact-tool.ts` 的「申请凭证 → 直传对象存储 → 提交导入 → 轮询结果」链路，
+ * 供 Artifact 与资料库上传（LibraryUpload）等调用方共用；接口本身与业务语义解耦，
+ * 公开分享、覆盖既有节点等行为由调用方通过请求字段决定。
+ */
+/** 上传源：一次上传的文件内容。 */
+export interface UploadBody {
+    /** 内容总字节数，用于 `Content-Length`。 */
+    size: number;
+    /**
+     * 返回一个**从 0 开始的新流**。重试（如 PUT 失败后重发）会再次调用，
+     * 因此实现必须能从同一份底层数据重建完整输入。
+     */
+    openStream(): NodeJS.ReadableStream;
+}
+/** 轮询配置；缺省 `{ intervalMs: 2000, maxRetries: 30 }`（与 Artifact 既有行为一致）。 */
+export interface SpaceUploadPollOptions {
+    intervalMs?: number;
+    maxRetries?: number;
+}
+/** 一次上传请求。 */
+export interface SpaceUploadRequest {
+    source: UploadBody;
+    fileName: string;
+    /** PUT 到对象存储时的 `Content-Type`；缺省 `application/octet-stream`。 */
+    contentType?: string;
+    /** 目标父节点；不传由服务端决定默认落点。 */
+    parentId?: string;
+    /** 是否允许生成公开分享链接。不传则请求体不带该字段（由调用方语义决定）。 */
+    supportShare?: boolean;
+    /** 覆盖既有节点（Artifact 原地更新用）；不传表示新建。 */
+    nodeBlockId?: string;
+    poll?: SpaceUploadPollOptions;
+}
+/** 上传成功结果。 */
+export interface SpaceUploadResult {
+    taskId: string;
+    nodeId: string;
+    nodeKind: string;
+    url?: string;
+    publishUrl?: string;
+}
+/** 失败发生的阶段，供调用方把失败映射成自己的错误码体系。 */
+export type SpaceUploadStage = 'credential' | 'upload' | 'import' | 'poll';
+/** 上传失败：诊断文案 + 可选的后端业务错误码 + 阶段。 */
+export interface SpaceUploadFailure {
+    /** 人类可读诊断文案，拼进调用方的失败提示。 */
+    detail?: string;
+    /** 后端返回的业务错误码（如 56040 / 619610 / 20010），由调用方决定怎么展示。 */
+    errorCode?: number;
+    stage?: SpaceUploadStage;
+    /**
+     * 导入已受理、但客户端没等到终态时的任务 ID。任务在服务端仍可能继续执行，
+     * 调用方应据此提示用户稍后核对，而不是当成本次上传已失败直接重传。
+     */
+    taskId?: string;
+    /** 需要单独识别的失败原因：状态未知（轮询超时 / 进度查询失败），其余情况不设置。 */
+    reason?: 'poll-timeout' | 'poll-status-unknown';
+}
+/** 上传结果：成功返回结果，失败返回 `{ failure }`（判别靠 `'failure' in outcome`）。 */
+export type SpaceUploadOutcome = SpaceUploadResult | {
+    failure: SpaceUploadFailure;
+};

package/cli/dist-server/types/node/tools/space-upload/upload-file.d.ts

@@ -0,0 +1,27 @@
+import type { SpaceUploadOutcome, SpaceUploadRequest } from './types';
+/**
+ * SpaceEngine 上传链路（抽自 `ArtifactTool.uploadToKnowledge`，行为与文案保持不变）：
+ *   1. POST /space/api/view/import/uploadCredential → 预签名 URL + cosKey/confirmKey + STS 头
+ *   2. PUT 到对象存储（body 取自 `UploadBody.openStream()`，带 Content-Length）
+ *   3. POST /space/api/view/import/importLocalFileAsync → taskId
+ *   4. 轮询 /space/api/view/import/queryImportFileProgress → 终态结果
+ *
+ * 调用方负责业务语义：`supportShare` / `nodeBlockId` 由请求字段决定，
+ * 公开权限补设、分享链接拼装等留在各工具内部。
+ */
+/** 日志出口：只用到 error 与可选 warn，便于单测注入 fake。 */
+export interface SpaceUploadLogger {
+    error(message: string): void;
+    warn?(message: string): void;
+}
+/** 上传依赖：endpoint 与鉴权头由调用方提供（CLI 工具自带登录态与 logger）。 */
+export interface SpaceUploadDeps {
+    /** 产品 endpoint（尾部斜杠已去掉）。 */
+    endpoint: string;
+    /** 鉴权头，必须含 `Authorization`。 */
+    headers: Record<string, string>;
+    /** 日志标签，保持各调用方原有日志文本（如 `Artifact`）。 */
+    logTag: string;
+    logger?: SpaceUploadLogger;
+}
+export declare function uploadToSpace(request: SpaceUploadRequest, deps: SpaceUploadDeps): Promise<SpaceUploadOutcome>;

package/cli/dist-server/types/node/tools/speak-in-channel-tool.d.ts

@@ -0,0 +1,182 @@
+/**
+ * SpeakInChannel —— 往频道 jsonl 说话。
+ * 不是 MessageColleague，不写对方 1:1，不进 jobAssignments。
+ * 落盘走带锁的 applyChannelSpeech；成功后叫醒其他成员，不叫醒自己。
+ *
+ * 频道解析走 agent-home-channel-context，叫醒走 ChannelWakeService——
+ * 工具里不再出现 ContainerUtil.get / 目录读写的样板。
+ */
+import type { Session } from '../../vendor/cbc-core/node/index.js';
+import { type RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { z } from 'zod';
+import { ChannelWakeService } from '../agent-home/channel-wake-service';
+import { SettingsManager } from '../settings/settings-protocol';
+import { BaseTool } from './base-tool';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+declare const SpeakInChannelParameters: z.ZodObject<{
+    content: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodString>;
+    mentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    replyTo: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    widget: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodString;
+        helpText: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodOptional<z.ZodString>;
+            style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            value?: string | undefined;
+            style?: "default" | "primary" | "danger" | undefined;
+        }, {
+            label: string;
+            value?: string | undefined;
+            style?: "default" | "primary" | "danger" | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        options: {
+            label: string;
+            value?: string | undefined;
+            style?: "default" | "primary" | "danger" | undefined;
+        }[];
+        helpText?: string | undefined;
+    }, {
+        prompt: string;
+        options: {
+            label: string;
+            value?: string | undefined;
+            style?: "default" | "primary" | "danger" | undefined;
+        }[];
+        helpText?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    content?: string | undefined;
+    mentions?: string[] | undefined;
+    attachments?: string[] | undefined;
+    channel?: string | undefined;
+    widget?: {
+        prompt: string;
+        options: {
+            label: string;
+            value?: string | undefined;
+            style?: "default" | "primary" | "danger" | undefined;
+        }[];
+        helpText?: string | undefined;
+    } | undefined;
+    replyTo?: string | undefined;
+}, {
+    content?: string | undefined;
+    mentions?: string[] | undefined;
+    attachments?: string[] | undefined;
+    channel?: string | undefined;
+    widget?: {
+        prompt: string;
+        options: {
+            label: string;
+            value?: string | undefined;
+            style?: "default" | "primary" | "danger" | undefined;
+        }[];
+        helpText?: string | undefined;
+    } | undefined;
+    replyTo?: string | undefined;
+}>;
+type SpeakInChannelInput = z.infer<typeof SpeakInChannelParameters>;
+export declare class SpeakInChannelTool extends BaseTool implements Tool {
+    protected readonly logger: Logger;
+    protected readonly wakeService?: ChannelWakeService;
+    protected readonly settingsManager?: SettingsManager;
+    name: ToolNames;
+    description: string;
+    needsApproval: boolean;
+    shouldShowInToolSearch: () => boolean;
+    parameters: z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        channel: z.ZodOptional<z.ZodString>;
+        mentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        replyTo: z.ZodOptional<z.ZodString>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        widget: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+            helpText: z.ZodOptional<z.ZodString>;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                value?: string | undefined;
+                style?: "default" | "primary" | "danger" | undefined;
+            }, {
+                label: string;
+                value?: string | undefined;
+                style?: "default" | "primary" | "danger" | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            prompt: string;
+            options: {
+                label: string;
+                value?: string | undefined;
+                style?: "default" | "primary" | "danger" | undefined;
+            }[];
+            helpText?: string | undefined;
+        }, {
+            prompt: string;
+            options: {
+                label: string;
+                value?: string | undefined;
+                style?: "default" | "primary" | "danger" | undefined;
+            }[];
+            helpText?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        content?: string | undefined;
+        mentions?: string[] | undefined;
+        attachments?: string[] | undefined;
+        channel?: string | undefined;
+        widget?: {
+            prompt: string;
+            options: {
+                label: string;
+                value?: string | undefined;
+                style?: "default" | "primary" | "danger" | undefined;
+            }[];
+            helpText?: string | undefined;
+        } | undefined;
+        replyTo?: string | undefined;
+    }, {
+        content?: string | undefined;
+        mentions?: string[] | undefined;
+        attachments?: string[] | undefined;
+        channel?: string | undefined;
+        widget?: {
+            prompt: string;
+            options: {
+                label: string;
+                value?: string | undefined;
+                style?: "default" | "primary" | "danger" | undefined;
+            }[];
+            helpText?: string | undefined;
+        } | undefined;
+        replyTo?: string | undefined;
+    }>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    toAutoClassifierInput(_input: unknown): string;
+    isEnabled: (args?: {
+        runContext?: RunContext<Session>;
+        agent?: {
+            name?: string;
+        };
+    }) => Promise<boolean>;
+    /**
+     * 有身份即可说话：默认 Agent 或已认领/已登记的同事（设置闸门走 agentHomeRoomToolRefusal）。
+     * **只管可见性**：缺省解析（未认领 job 回落默认 Agent）意味着"工具在"；能不能真的说，
+     * 由 execute 的 strict 解析与 applyChannelSpeech 的 INVALID_SPEAKER 决定（#125667 评审）。
+     */
+    private hasChannelIdentity;
+    execute(input: SpeakInChannelInput, context?: RunContext<Session>): Promise<ToolResult>;
+}
+export {};

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

@@ -0,0 +1,43 @@
+/**
+ * StructuredOutput Tool
+ *
+ * This tool allows the model to return structured data in a specific format
+ * when --json-schema is provided. The model should call this tool exactly once
+ * at the end of its response to provide the structured output.
+ *
+ * The tool's parameters are dynamically generated based on the user-provided
+ * JSON Schema, allowing the model to see the exact structure expected.
+ */
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { Agent, RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { BaseTool } from './base-tool';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+export declare class StructuredOutputTool extends BaseTool implements Tool {
+    name: ToolNames;
+    readonly promptCacheStability: "volatile";
+    protected readonly logger: Logger;
+    private ajv;
+    private compiledValidator;
+    private currentSchema;
+    /**
+     * Dynamic parameters generator
+     * Returns the user-provided JSON Schema from --json-schema option directly,
+     * or a default flexible schema if not provided.
+     */
+    parameters: () => Promise<any>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    /**
+     * This tool is only enabled when --json-schema option is provided.
+     * This replaces the disallowedTools logic in the interceptor.
+     */
+    isEnabled: ({ runContext }: {
+        runContext: RunContext<Session>;
+        agent: Agent;
+    }) => boolean;
+    /**
+     * This tool does not need approval - it's a passive data capture tool
+     */
+    needsApproval: boolean;
+    execute(input: Record<string, unknown>, context?: RunContext<Session>): Promise<ToolResult>;
+}

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

@@ -0,0 +1,71 @@
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { z } from 'zod';
+import { BaseTool } from './base-tool';
+import { TaskStorageService } from './task-storage-service';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+declare const TaskCreateParameters: z.ZodObject<{
+    subject: z.ZodString;
+    description: z.ZodString;
+    activeForm: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    owner: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    subject: string;
+    owner?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    activeForm?: string | undefined;
+}, {
+    description: string;
+    subject: string;
+    owner?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    activeForm?: string | undefined;
+}>;
+export declare class TaskCreateTool extends BaseTool implements Tool {
+    protected readonly taskStorageService: TaskStorageService;
+    protected readonly logger: Logger;
+    name: ToolNames;
+    parameters: z.ZodObject<{
+        subject: z.ZodString;
+        description: z.ZodString;
+        activeForm: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        owner: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        subject: string;
+        owner?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        activeForm?: string | undefined;
+    }, {
+        description: string;
+        subject: string;
+        owner?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        activeForm?: string | undefined;
+    }>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    needsApproval: boolean;
+    execute(input: z.infer<typeof TaskCreateParameters>, context?: RunContext<Session>): Promise<ToolResult>;
+    /**
+     * Validate task-create params.
+     *
+     * - First runs zod schema validation via {@link ZodUtils.validate} for shape / type errors.
+     * - Then enforces business-level semantics that zod alone cannot express:
+     *   required strings must be non-empty after trim, optional strings (when supplied)
+     *   must not be blank, and metadata must be a plain object.
+     *
+     * Returns a human-readable reason on failure (consumed by execute() to throw),
+     * or undefined when input is valid.
+     */
+    private validateToolParams;
+    /**
+     * Generate activeForm from subject by converting to present continuous
+     * e.g., "Run tests" -> "Running tests"
+     */
+    private generateActiveForm;
+}
+export {};

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

@@ -0,0 +1,31 @@
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { z } from 'zod';
+import { RunContext } from '../../vendor/cbc-shared/node/index.js';
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { BaseTool } from './base-tool';
+import { TaskStorageService } from './task-storage-service';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
+declare const TaskGetParameters: z.ZodObject<{
+    taskId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+}, {
+    taskId: string;
+}>;
+export declare class TaskGetTool extends BaseTool implements Tool {
+    protected readonly taskStorageService: TaskStorageService;
+    protected readonly logger: Logger;
+    name: ToolNames;
+    parameters: z.ZodObject<{
+        taskId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        taskId: string;
+    }, {
+        taskId: string;
+    }>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    needsApproval: boolean;
+    execute(input: z.infer<typeof TaskGetParameters>, context?: RunContext<Session>): Promise<ToolResult>;
+}
+export {};