@ai-setting/roy-agent-core 1.7.51 → 1.7.53

package/dist/env/task/tools/operation/list-tool.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Operation List Tool (Task #2211: milestone_* + action_* 兼容)
+ */
+import type { Tool } from "../../../tool/types";
+import type { TaskComponent } from "../../task-component";
+export declare function listOperationsTool(taskComponent: TaskComponent): Tool;

package/dist/env/task/tools/operation/operation-types.d.ts

@@ -0,0 +1,225 @@
+/**
+ * @fileoverview Operation Tool Parameter Schemas (Task #2211: 双维度里程碑 + 过程)
+ *
+ * 设计目标：
+ * - **状态/里程碑维度**（"达到什么"）：milestone_type / milestone_title / milestone_description
+ * - **过程维度**（"如何达到"）：process_description（100-150 字符硬约束，保留 task #2203 约定）
+ *
+ * 兼容：
+ * - action_type / action_title / action_description 通过 z.preprocess 自动映射到 milestone_*
+ *   并通过输出字段 _deprecated_warning 提示"建议改用 milestone_*"
+ */
+import { z } from "zod";
+/**
+ * Action type enum
+ */
+declare const ActionTypeEnum: z.ZodEnum<["create", "progress", "milestone", "problem", "solution", "decision", "review", "completed", "workflow_extracted"]>;
+export { ActionTypeEnum };
+/**
+ * Process description constraints
+ *
+ * 设计哲学：操作记录只承担节点阶段 milestone 概要。
+ * - milestone_description：达成状态/结果的描述（保留原义，可长可短）
+ * - process_description：采取了什么策略 + 工具步骤达成的过程概要
+ *
+ * 硬约束：100-150 字符。
+ * - 太短（<100）= 没价值，不算过程概要
+ * - 太长（>150）= 退化为日志细节，违背 milestone 摘要设计
+ * - 完整细节应通过 sessionId 回查 session 历史
+ *
+ * 失败模式：
+ * - < 100：拒绝（提供有意义的 process_description 才是该字段的本职）
+ * - > 150：拒绝（防止字段膨胀，保持 milestone 摘要克制）
+ */
+export declare const PROCESS_DESCRIPTION_MIN_LENGTH = 100;
+export declare const PROCESS_DESCRIPTION_MAX_LENGTH = 150;
+/**
+ * Milestone description (状态/结果描述) — 长度上限保留宽松（与历史 action_description 一致）。
+ */
+export declare const MILESTONE_DESCRIPTION_MAX_LENGTH = 5000;
+/**
+ * Milestone title — 必填，1-200 字符。
+ */
+export declare const MILESTONE_TITLE_MIN_LENGTH = 1;
+export declare const MILESTONE_TITLE_MAX_LENGTH = 200;
+/**
+ * process_description 字段校验
+ * - 可选（向后兼容）
+ * - 长度严格 100-150 字符
+ */
+export declare const ProcessDescriptionSchema: z.ZodString;
+/**
+ * milestone_title 字段校验
+ * - 必填
+ * - 1-200 字符
+ */
+export declare const MilestoneTitleSchema: z.ZodString;
+/**
+ * milestone_description 字段校验
+ * - 可选
+ * - 0-5000 字符（保留宽松，便于状态/结果描述）
+ */
+export declare const MilestoneDescriptionSchema: z.ZodOptional<z.ZodString>;
+/**
+ * task_operation_create tool parameters (Task #2211)
+ *
+ * 双维度规范：
+ * - milestone_* 字段描述达成的状态/结果
+ * - process_description 描述达成过程（100-150 字符）
+ * - action_* 字段作为兼容窗口期别名
+ */
+export declare const CreateOperationToolSchema: z.ZodEffects<z.ZodObject<{
+    task_id: z.ZodNumber;
+    milestone_type: z.ZodOptional<z.ZodEnum<["create", "progress", "milestone", "problem", "solution", "decision", "review", "completed", "workflow_extracted"]>>;
+    milestone_title: z.ZodOptional<z.ZodString>;
+    milestone_description: z.ZodOptional<z.ZodString>;
+    process_description: z.ZodOptional<z.ZodString>;
+    action_type: z.ZodOptional<z.ZodEnum<["create", "progress", "milestone", "problem", "solution", "decision", "review", "completed", "workflow_extracted"]>>;
+    action_title: z.ZodOptional<z.ZodString>;
+    action_description: z.ZodOptional<z.ZodString>;
+    md_path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_title?: string | undefined;
+    milestone_description?: string | undefined;
+    process_description?: string | undefined;
+    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_title?: string | undefined;
+    action_description?: string | undefined;
+    md_path?: string | undefined;
+}, {
+    task_id: number;
+    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_title?: string | undefined;
+    milestone_description?: string | undefined;
+    process_description?: string | undefined;
+    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_title?: string | undefined;
+    action_description?: string | undefined;
+    md_path?: string | undefined;
+}>, CreateOperationToolParams, {
+    task_id: number;
+    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_title?: string | undefined;
+    milestone_description?: string | undefined;
+    process_description?: string | undefined;
+    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_title?: string | undefined;
+    action_description?: string | undefined;
+    md_path?: string | undefined;
+}>;
+export interface CreateOperationToolParams {
+    task_id: number;
+    milestone_type?: string;
+    milestone_title?: string;
+    milestone_description?: string;
+    process_description?: string;
+    md_path?: string;
+    _deprecated_fields_used: string[];
+}
+/**
+ * task_operation_get tool parameters
+ */
+export declare const GetOperationToolSchema: z.ZodObject<{
+    operation_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    operation_id: number;
+}, {
+    operation_id: number;
+}>;
+export type GetOperationToolParams = z.infer<typeof GetOperationToolSchema>;
+/**
+ * task_operation_list tool parameters
+ */
+export declare const ListOperationsToolSchema: z.ZodEffects<z.ZodObject<{
+    task_id: z.ZodNumber;
+    milestone_type: z.ZodOptional<z.ZodEnum<["create", "progress", "milestone", "problem", "solution", "decision", "review", "completed", "workflow_extracted"]>>;
+    action_type: z.ZodOptional<z.ZodEnum<["create", "progress", "milestone", "problem", "solution", "decision", "review", "completed", "workflow_extracted"]>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+    limit: number;
+    offset: number;
+    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+}, {
+    task_id: number;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+}>, {
+    task_id: number;
+    milestone_type: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    limit: number;
+    offset: number;
+    _deprecated_fields_used: string[];
+}, {
+    task_id: number;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+}>;
+export interface ListOperationsToolParams {
+    task_id: number;
+    milestone_type?: string;
+    limit: number;
+    offset: number;
+    _deprecated_fields_used: string[];
+}
+export declare const UpdateOperationToolSchema: z.ZodEffects<z.ZodObject<{
+    operation_id: z.ZodNumber;
+    milestone_title: z.ZodOptional<z.ZodString>;
+    milestone_description: z.ZodOptional<z.ZodString>;
+    process_description: z.ZodOptional<z.ZodString>;
+    action_title: z.ZodOptional<z.ZodString>;
+    action_description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    operation_id: number;
+    milestone_title?: string | undefined;
+    milestone_description?: string | undefined;
+    process_description?: string | undefined;
+    action_title?: string | undefined;
+    action_description?: string | undefined;
+}, {
+    operation_id: number;
+    milestone_title?: string | undefined;
+    milestone_description?: string | undefined;
+    process_description?: string | undefined;
+    action_title?: string | undefined;
+    action_description?: string | undefined;
+}>, {
+    operation_id: number;
+    milestone_title: string | undefined;
+    milestone_description: string | undefined;
+    process_description: string | undefined;
+    _deprecated_fields_used: string[];
+}, {
+    operation_id: number;
+    milestone_title?: string | undefined;
+    milestone_description?: string | undefined;
+    process_description?: string | undefined;
+    action_title?: string | undefined;
+    action_description?: string | undefined;
+}>;
+export interface UpdateOperationToolParams {
+    operation_id: number;
+    milestone_title?: string;
+    milestone_description?: string;
+    process_description?: string;
+    _deprecated_fields_used: string[];
+}
+/**
+ * task_operation_delete tool parameters
+ */
+export declare const DeleteOperationToolSchema: z.ZodObject<{
+    operation_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    operation_id: number;
+}, {
+    operation_id: number;
+}>;
+export type DeleteOperationToolParams = z.infer<typeof DeleteOperationToolSchema>;

package/dist/env/task/tools/operation/update-tool.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Operation Update Tool (Task #2211: milestone_* + action_* 兼容)
+ */
+import type { Tool } from "../../../tool/types";
+import type { TaskComponent } from "../../task-component";
+export declare function updateOperationTool(taskComponent: TaskComponent): Tool;

package/dist/env/task/tools/search-tool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Task Search Tool
+ *
+ * Searches tasks by keywords across title, description, goals, tags, and
+ * operation records. Returns `{ tasks, total }` for pagination.
+ */
+import type { Tool } from "../../tool/types";
+import type { TaskComponent } from "../task-component";
+export declare function searchTasksTool(taskComponent: TaskComponent): Tool;

package/dist/env/task/tools/task-tree-tool.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Task Tree Tool
+ *
+ * Returns a hierarchical (forest) view of tasks. Used by callers to decide
+ * where to mount a new task via `task_create(parent_task_id=...)`.
+ *
+ * This is the MCP-equivalent of the CLI command `roy-agent tasks tree`.
+ *
+ * Implementation notes:
+ *  - Output is a JSON envelope (see {@link TreeTasksResult}) so the response
+ *    matches the shape used by `task_list` (total / truncated / nodes).
+ *  - `total` is intentionally the FIRST field in the JSON output so that
+ *    tail-truncation by ToolComponent.truncateOutput cannot strip it.
+ *  - `buildTaskNodes` is a pure function that converts a flat Task list to
+ *    a forest of `TaskNode`. Orphan tasks (parent missing from input) are
+ *    promoted to root level — matches the CLI `task-graph.ts` behavior.
+ *  - Sibling order: `updatedAt` DESC, `id` DESC tie-breaker.
+ */
+import type { Tool } from "../../tool/types";
+import type { TaskComponent } from "../task-component";
+import type { Task } from "../types";
+/**
+ * Lean node in the tree output. We deliberately exclude description,
+ * goals_and_expected_deliverables, context, etc. to keep tree views compact.
+ * Callers can fetch details via `task_get(task_id)` for any node.
+ */
+export interface TaskNode {
+    id: number;
+    title: string;
+    status: Task["status"];
+    type: Task["type"];
+    priority: Task["priority"];
+    progress: number;
+    children: TaskNode[];
+}
+/**
+ * Top-level response shape. `total` is FIRST for truncation safety.
+ */
+export interface TreeTasksResult {
+    total: number;
+    truncated: boolean;
+    depth: number;
+    parent_task_id: number | null;
+    nodes: TaskNode[];
+}
+/**
+ * Convert a flat list of tasks into a forest of `TaskNode`.
+ *
+ * Rules:
+ *  - Task with no `parent_task_id` → root.
+ *  - Task whose `parent_task_id` points to a task NOT in the input set
+ *    (orphan) is promoted to root (mirrors CLI `task-graph.ts`).
+ *  - Roots and each level of children are sorted by `updatedAt` DESC
+ *    (id DESC tie-breaker).
+ *
+ * Pure: no I/O, no console. Easy to unit-test in isolation.
+ */
+export declare function buildTaskNodes(tasks: Task[]): TaskNode[];
+/**
+ * Create the `task_tree` tool.
+ *
+ * Schema: see `TreeTasksToolSchema`.
+ * Output: see {@link TreeTasksResult}.
+ */
+export declare function treeTasksTool(taskComponent: TaskComponent): Tool;

package/dist/env/task/tools/task-types.d.ts

@@ -0,0 +1,255 @@
+/**
+ * @fileoverview Task Tool Parameter Schemas
+ */
+import { z } from "zod";
+/**
+ * task_create tool parameters
+ */
+export declare const CreateTaskToolSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>>;
+    goals_and_expected_deliverables: z.ZodOptional<z.ZodString>;
+    due_date: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    project_path: z.ZodString;
+    parent_task_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
+    context: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "normal" | "cycle" | "longterm";
+    title: string;
+    project_path: string;
+    context: string;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    goals_and_expected_deliverables?: string | undefined;
+    due_date?: string | undefined;
+    parent_task_id?: number | null | undefined;
+}, {
+    title: string;
+    project_path: string;
+    context: string;
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    goals_and_expected_deliverables?: string | undefined;
+    due_date?: string | undefined;
+    parent_task_id?: number | null | undefined;
+}>;
+export type CreateTaskToolParams = z.infer<typeof CreateTaskToolSchema>;
+/**
+ * task_get tool parameters
+ */
+export declare const GetTaskToolSchema: z.ZodObject<{
+    task_id: z.ZodNumber;
+    include_operations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+    include_operations: boolean;
+}, {
+    task_id: number;
+    include_operations?: boolean | undefined;
+}>;
+export type GetTaskToolParams = z.infer<typeof GetTaskToolSchema>;
+/**
+ * task_list tool parameters
+ */
+export declare const ListTasksToolSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    include_archived: boolean;
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    depth?: number | undefined;
+}, {
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    depth?: number | undefined;
+    include_archived?: boolean | undefined;
+}>;
+export type ListTasksToolParams = z.infer<typeof ListTasksToolSchema>;
+/**
+ * task_search tool parameters
+ */
+export declare const SearchTasksToolSchema: z.ZodObject<{
+    keywords: z.ZodArray<z.ZodString, "many">;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
+    exclude_task_id: z.ZodOptional<z.ZodNumber>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    include_archived: boolean;
+    keywords: string[];
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    depth?: number | undefined;
+    exclude_task_id?: number | undefined;
+}, {
+    keywords: string[];
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    depth?: number | undefined;
+    include_archived?: boolean | undefined;
+    exclude_task_id?: number | undefined;
+}>;
+export type SearchTasksToolParams = z.infer<typeof SearchTasksToolSchema>;
+/**
+ * task_update tool parameters
+ */
+export declare const UpdateTaskToolSchema: z.ZodObject<{
+    task_id: z.ZodNumber;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
+    progress: z.ZodOptional<z.ZodNumber>;
+    current_status: z.ZodOptional<z.ZodString>;
+    goals_and_expected_deliverables: z.ZodOptional<z.ZodString>;
+    due_date: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    project_path: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
+    parent_task_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    progress?: number | undefined;
+    title?: string | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    goals_and_expected_deliverables?: string | undefined;
+    due_date?: string | undefined;
+    project_path?: string | undefined;
+    parent_task_id?: number | null | undefined;
+    context?: string | undefined;
+    current_status?: string | undefined;
+}, {
+    task_id: number;
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    progress?: number | undefined;
+    title?: string | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    goals_and_expected_deliverables?: string | undefined;
+    due_date?: string | undefined;
+    project_path?: string | undefined;
+    parent_task_id?: number | null | undefined;
+    context?: string | undefined;
+    current_status?: string | undefined;
+}>;
+export type UpdateTaskToolParams = z.infer<typeof UpdateTaskToolSchema>;
+/**
+ * task_delete tool parameters
+ */
+export declare const DeleteTaskToolSchema: z.ZodObject<{
+    task_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+}, {
+    task_id: number;
+}>;
+export type DeleteTaskToolParams = z.infer<typeof DeleteTaskToolSchema>;
+/**
+ * task_complete tool parameters
+ *
+ * Task #2778: 新增 deliverable_storage_path 参数。
+ * 调用方在完成任务时，应提供实际交付物的寻址地址，便于后续追溯。
+ *
+ * 支持任意形式的寻址：本地文件路径 / 飞书 doc URL / git 分支名 / GitHub PR/commit URL。
+ * 该参数会持久化到 task.context.deliverable_storage_path。
+ */
+export declare const CompleteTaskToolSchema: z.ZodObject<{
+    task_id: z.ZodNumber;
+    deliverable_storage_path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+    deliverable_storage_path?: string | undefined;
+}, {
+    task_id: number;
+    deliverable_storage_path?: string | undefined;
+}>;
+export type CompleteTaskToolParams = z.infer<typeof CompleteTaskToolSchema>;
+/**
+ * task_batch_archive tool parameters
+ */
+export declare const BatchArchiveToolSchema: z.ZodObject<{
+    task_ids: z.ZodArray<z.ZodNumber, "many">;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    task_ids: number[];
+    reason?: string | undefined;
+}, {
+    task_ids: number[];
+    reason?: string | undefined;
+}>;
+export type BatchArchiveToolParams = z.infer<typeof BatchArchiveToolSchema>;
+/**
+ * task_batch_delete tool parameters
+ */
+export declare const BatchDeleteToolSchema: z.ZodObject<{
+    task_ids: z.ZodArray<z.ZodNumber, "many">;
+}, "strip", z.ZodTypeAny, {
+    task_ids: number[];
+}, {
+    task_ids: number[];
+}>;
+export type BatchDeleteToolParams = z.infer<typeof BatchDeleteToolSchema>;
+/**
+ * task_tree tool parameters
+ *
+ * Returns a hierarchical (forest) view of tasks. Use this BEFORE calling
+ * task_create to choose the right parent_task_id (or decide to create a root).
+ */
+export declare const TreeTasksToolSchema: z.ZodObject<{
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    parent_task_id: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
+    include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    depth: number;
+    include_archived: boolean;
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    parent_task_id?: number | undefined;
+}, {
+    type?: "normal" | "cycle" | "longterm" | undefined;
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    priority?: "low" | "medium" | "high" | undefined;
+    parent_task_id?: number | undefined;
+    depth?: number | undefined;
+    include_archived?: boolean | undefined;
+}>;
+export type TreeTasksToolParams = z.infer<typeof TreeTasksToolSchema>;

package/dist/env/task/tools/update-tool.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Task Update Tool
+ */
+import type { Tool } from "../../tool/types";
+import type { TaskComponent } from "../task-component";
+export declare function updateTaskTool(taskComponent: TaskComponent): Tool;