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

package/dist/env/task/task-component.d.ts

@@ -0,0 +1,270 @@
+/**
+ * @fileoverview Task Component
+ *
+ * Component for managing task lifecycle including:
+ * - Task CRUD operations
+ * - Operation record management
+ * - Tool registration
+ */
+import { BaseComponent, type ComponentConfig } from "../component";
+import { type TaskConfig, type Task, type TaskOperation, type CreateTaskOptions, type UpdateTaskOptions, type ListTasksOptions, type CreateOperationOptions, type ListOperationsOptions, type TaskListResult, type SearchTasksOptions } from "./types";
+import { BackgroundTaskManager } from "./delegate";
+import type { ConfigComponent } from "../../config/config-component";
+import { type TagService } from "./tag-service";
+import type { Hook } from "../hook/types";
+/**
+ * Task #2778 v2: deliverable 在 operation 行的统一格式
+ * 同时用于 task.context.deliverable_storage_path 字段和 operation.milestoneDescription 描述。
+ * 调用方在 op 列表 / task 列表里都看到一致的 "Deliverable: <path>" 字符串。
+ */
+export declare const DELIVERABLE_OPERATION_PREFIX = "Deliverable: ";
+/**
+ * 把 deliverable 路径格式化成 operation.milestoneDescription。
+ * - 有 path：返回 "Deliverable: <path>"
+ * - 无 path：返回 undefined（避免误写 "Deliverable: undefined"）
+ */
+export declare function formatDeliverableForOperation(deliverableStoragePath: string | undefined): string | undefined;
+/**
+ * TaskComponent 配置选项（通过 options 传递）
+ *
+ * 配置加载顺序（优先级从低到高）：
+ * 1. File - 配置文件（通过 configPath 指定）
+ * 2. Env - 环境变量（通过 envPrefix 配置前缀）
+ * 3. Object - 直接传入的 config 对象（最高优先级）
+ */
+export interface TaskComponentOptions {
+    /** ConfigComponent 实例（必填） */
+    configComponent: ConfigComponent;
+    /** 配置文件相对路径（可选，基于 XDG_DATA_HOME） */
+    configPath?: string;
+    /** 环境变量前缀（可选，默认 "TASK"） */
+    envPrefix?: string;
+    /** 直接传入的配置对象（可选，优先级最高） */
+    config?: Partial<TaskConfig>;
+}
+export declare class TaskComponent extends BaseComponent {
+    name: string;
+    version: string;
+    private store;
+    private config?;
+    private toolComponent?;
+    private backgroundTaskManager?;
+    private configComponent?;
+    private tagService;
+    private plugins;
+    /**
+     * Task #2245 — Codex P1-4: public typed accessor for `backgroundTaskManager`.
+     *
+     * Replaces the previous `as any` cast pattern (session-tree-stopper.ts)
+     * that accessed the private field directly. Returns undefined if the
+     * BackgroundTaskManager has not been initialized yet (init pending)
+     * or has been disposed.
+     */
+    getBackgroundTaskManager(): BackgroundTaskManager | undefined;
+    /**
+     * 发布 EnvEvent
+     */
+    private publishEvent;
+    constructor();
+    /**
+     * Initialize the component
+     *
+     * 配置加载优先级（从高到低）：
+     * 1. Object - 直接传入的 config 对象
+     * 2. Env - 环境变量（通过 envPrefix 配置前缀）
+     * 3. File - 配置文件（通过 configPath 指定）
+     */
+    init(config?: ComponentConfig): Promise<void>;
+    /**
+     * 注册配置到 ConfigComponent
+     *
+     * 配置加载顺序（优先级从低到高）：
+     * 1. Defaults - 默认值（最低）
+     * 2. FileSource - 从配置文件加载
+     * 3. EnvSource - 从环境变量加载
+     * 4. config 对象 - 直接传入的配置（最高）
+     */
+    private registerConfig;
+    /**
+     * 根据配置初始化 store
+     */
+    private initStore;
+    /**
+     * 将配置对象展平为点号路径
+     */
+    private flattenConfig;
+    /**
+     * 注册配置热更新监听
+     */
+    private registerConfigWatcher;
+    /**
+     * 处理配置变更
+     */
+    protected onConfigChange(event: {
+        key: string;
+        oldValue?: unknown;
+        newValue?: unknown;
+    }): void;
+    /** 配置变更 watcher 清理函数 */
+    private configWatcher?;
+    /**
+     * Start the component - register tools
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the component
+     */
+    stop(): Promise<void>;
+    /**
+     * Register task tools to ToolComponent
+     */
+    private registerTools;
+    /**
+     * 执行 Hook
+     */
+    private executeHook;
+    /**
+     * Create a new task
+     */
+    createTask(options: CreateTaskOptions): Promise<Task>;
+    /**
+     * Get task by ID
+     */
+    getTask(id: number): Promise<Task | undefined>;
+    /**
+     * 按 session_id 反查该 session 创建的第一个 task（sub-session → task 确定性映射）。
+     */
+    getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    /**
+     * Get task with operations
+     */
+    getTaskWithOperations(id: number): Promise<{
+        task: Task;
+        operations: TaskOperation[];
+    } | undefined>;
+    /**
+     * Update task
+     */
+    updateTask(id: number, options: UpdateTaskOptions): Promise<Task | undefined>;
+    /**
+     * Delete task
+     */
+    deleteTask(id: number): Promise<boolean>;
+    /**
+     * List tasks
+     *
+     * @returns `{ tasks, total }` where `total` is the count before pagination.
+     */
+    listTasks(options?: ListTasksOptions): Promise<TaskListResult>;
+    /**
+     * Search tasks by keywords
+     *
+     * Searches across title, description, goals, tags, and operation records.
+     * Returns `{ tasks, total }` for pagination.
+     */
+    searchTasksByKeywords(keywords: string[], options?: SearchTasksOptions): Promise<TaskListResult>;
+    /**
+     * Get task tree (subtree) starting from the given task
+     *
+     * @param taskId 起始任务 ID
+     * @param depth 层级深度，-1 表示无限层级（默认）
+     * @returns 所有后代任务的扁平列表（不含 taskId 本身）
+     */
+    getTaskTree(taskId: number, depth?: number): Promise<Task[]>;
+    /**
+     * Get direct children of a task (one level)
+     */
+    getChildTasks(taskId: number, options?: ListTasksOptions): Promise<TaskListResult>;
+    /**
+     * Complete task
+     *
+     * Task #2778: 新增 deliverableStoragePath 可选参数，调用方传入实际交付物寻址地址，
+     * 会被持久化到 task.context.deliverable_storage_path。
+     *
+     * Task #2778 v2: 同时把 deliverable 写入 task_operation.milestoneDescription（双写），
+     * 便于从 operation 列表直接看到交付物地址，无需查 context 字段。
+     *
+     * @param id 任务 ID
+     * @param sessionId 当前 session ID
+     * @param deliverableStoragePath 可选，交付物寻址地址（URL / 路径 / 分支名）
+     * @returns 更新后的 Task 或 undefined
+     */
+    completeTask(id: number, sessionId: string, deliverableStoragePath?: string): Promise<Task | undefined>;
+    /**
+     * Create operation record
+     */
+    createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
+    /**
+     * Get operation by ID
+     */
+    getOperation(id: number): Promise<TaskOperation | undefined>;
+    /**
+     * Update operation
+     */
+    updateOperation(id: number, updates: {
+        milestoneTitle?: string;
+        milestoneDescription?: string;
+        processDescription?: string;
+        actionTitle?: string;
+        actionDescription?: string;
+    }): Promise<TaskOperation | undefined>;
+    /**
+     * Delete operation
+     */
+    deleteOperation(id: number): Promise<boolean>;
+    /**
+     * List operations for a task
+     */
+    listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * 获取 TagService
+     */
+    getTagService(): TagService;
+    /**
+     * 注册 Hook（推荐方式）
+     *
+     * 直接注册 Hook 到 globalHookManager，无需通过 TaskPlugin
+     *
+     * @param hookPoint Hook 点（如 "task:after.create"）
+     * @param hook Hook 对象
+     *
+     * @example
+     * ```typescript
+     * // 直接注册 Hook
+     * taskComponent.registerHook("task:after.create", {
+     *   name: "my-notify",
+     *   priority: 5,
+     *   pluginName: "my-notify",    // 用于 pluginEnabled 检查
+     *   sourceId: "lark-cli",       // 用于 pluginEnabled 检查
+     *   execute: async (ctx) => {
+     *     const env = getEnvContextOrEmpty();
+     *     // ...
+     *   },
+     * });
+     * ```
+     */
+    registerHook(hookPoint: string, hook: Hook): void;
+    /**
+     * 注册多个 Hook
+     */
+    registerHooks(hooks: Array<{
+        hookPoint: string;
+        hook: Hook;
+    }>): void;
+    /**
+     * 注销 Hook（通过 name）
+     */
+    unregisterHook(hookPoint: string, hookName: string): boolean;
+    /**
+     * 获取所有注册的 Hook
+     */
+    listHooks(): Hook[];
+    /**
+     * 同一个 hook.name 可能挂在不同 hookPoint，复合 key 避免相互覆盖
+     */
+    private makePluginKey;
+    /**
+     * 获取指定 hook 点的 Hook 数量
+     */
+    countHooks(hookPoint: string): number;
+}

package/dist/env/task/task-config-registration.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Task Component 配置注册
+ *
+ * 使用 ConfigComponent.registerComponent() 机制统一管理配置
+ */
+import type { ComponentRegistration } from "../../config/config-component";
+/**
+ * Task Component 默认配置值
+ *
+ * 注意：键使用完整格式（带 "task." 前缀），在 registerConfig 中手动设置
+ * 注意：dbPath 的默认值由 SQLiteTaskStore 决定，放在这里是为了让 show-config 能显示
+ */
+export declare const TASK_DEFAULTS: Record<string, unknown>;
+/**
+ * Task Component 配置注册常量
+ *
+ * 定义了所有 Task 相关的配置项和来源
+ */
+export declare const TASK_CONFIG_REGISTRATION: ComponentRegistration;

package/dist/env/task/task-creation-registry.d.ts

@@ -0,0 +1,181 @@
+/**
+ * @fileoverview TaskCreationRegistry — In-process bounded index of recently
+ * created/updated tasks with sanitization, LRU eviction and TTL.
+ *
+ * The registry is **observation only** — it never writes back to TaskComponent
+ * and never deletes/merges tasks. It powers:
+ *
+ * 1. The "reuse candidate" prompt section injected into sub-agent prompts
+ *    (see task-reuse-context.ts). The section lists recent candidate tasks so
+ *    the sub-agent can decide to reuse instead of creating a new Task.
+ *
+ * 2. Programmatic queries from hooks / debug tools.
+ *
+ * Design choices (see docs/design/task-reuse-context.md):
+ * - **In-process**: hook events fire at runtime; DB fallback is opt-in and
+ *   intentionally not implemented in MVP. The registry is a "hot path" index.
+ * - **LRU + TTL**: maxEntries caps memory; ttlMs drops stale entries from
+ *   `recent()` (note: TTL only affects queries, not storage, to keep
+ *   behavior predictable for tests).
+ * - **Sanitization**: secrets are redacted before storage so they never leak
+ *   into a prompt even by accident.
+ *
+ * Backward compatibility: zero — this is a new module. Caller code
+ * (delegate-tool.ts, prompts-index.ts) is updated in subsequent commits.
+ */
+import type { Task, TaskStatus, TaskPriority, TaskType } from "./types";
+/**
+ * Provenance info for a task record. Captures which session / bg task /
+ * sub-agent type created the task so we can scope "recent" queries.
+ */
+export interface TaskRecordSource {
+    /** sessionId under which task_create was invoked (TaskComponent.createTask) */
+    sessionId?: string;
+    /** parent session id from sessions table (sub-session → main session) */
+    parentSessionId?: string;
+    /** BackgroundTaskManager task id (process_<ts>_<rand>) if applicable */
+    bgTaskId?: string;
+    /** Sub-agent type that triggered the task creation (roy / workflow-runner / ...) */
+    subagentType?: string;
+    /** OS process.pid (Node) of the host process at record time */
+    processId?: number;
+}
+export interface TaskRecord {
+    taskId: number;
+    title: string;
+    /** Sanitized + truncated description (never raw user input). */
+    description: string;
+    /** Sanitized + truncated goals (never raw user input). */
+    goals: string;
+    tags: string[];
+    status: TaskStatus;
+    priority: TaskPriority;
+    type: TaskType;
+    parentTaskId?: number;
+    source: TaskRecordSource;
+    /** ISO 8601 */
+    createdAt: string;
+    /** ISO 8601 — bumped on update() / refresh() */
+    updatedAt: string;
+    /** Approximate operation count for tie-breaking in sort */
+    operationCount: number;
+    /** Task #2395: cached from task.project_path */
+    project_path?: string;
+    /** Task #2395: cached from task.context JSON */
+    branch?: string;
+    /** Task #2395: cached from task.context JSON */
+    worktree_path?: string;
+    /** Task #2395: cached from task.context JSON */
+    parentBranch?: string;
+    /**
+     * Task #2395: cached parent context object with sensitive fields stripped
+     * (e.g. prior_context.commit). Stored only for delegation hints.
+     */
+    context?: Record<string, unknown>;
+}
+export interface RecentQueryOptions {
+    scope?: {
+        sessionId?: string;
+        parentSessionId?: string;
+        subagentType?: string;
+    };
+    /** Default: 10 */
+    limit?: number;
+    /** Default: all non-archived */
+    statuses?: TaskStatus[];
+    /** IDs to omit (e.g. similar_task_ids) so we don't show duplicates. */
+    excludeIds?: number[];
+    /** Exclude the subtree rooted at this task id (the task itself + all descendants). */
+    excludeAncestorOf?: number;
+    /** Task #2395: Exclude this id + its descendants (alias for clearer call-site intent). */
+    excludeSelfOrDescendant?: number;
+    /** Only return records updated within this window (hours). */
+    sinceHours?: number;
+    /** Task #2395: Promote candidates whose subtree contains an active child. */
+    activeChildFirst?: boolean;
+}
+/**
+ * Task #2395 — Subtree summary used by the reuse-candidate prompt to show
+ * `Children: N (active: M, completed: K)` per parent.
+ */
+export interface SubtreeSummary {
+    descendantCount: number;
+    activeCount: number;
+    completedCount: number;
+    /** Furthest descendant depth from the root (1 = direct child). 0 when empty. */
+    maxDepth: number;
+}
+export interface SubtreeSummaryOptions {
+    /** Include archived descendants. Default false (matches recent() default). */
+    includeArchived?: boolean;
+}
+export interface TaskCreationRegistryConfig {
+    /** Hard cap on entries; oldest are evicted (LRU) once exceeded. Default: 500 */
+    maxEntries?: number;
+    /** TTL in ms; entries older than this are skipped by `recent()`. Default: 24h */
+    ttlMs?: number;
+    /** Max chars for description / goals. Default: 240 */
+    maxDescriptionChars?: number;
+}
+export declare class TaskCreationRegistry {
+    private readonly maxEntries;
+    private readonly ttlMs;
+    private readonly maxDescriptionChars;
+    /** Map preserves insertion order; we re-insert on update() for LRU. */
+    private readonly records;
+    /** parent_task_id → list of child taskIds, for excludeAncestorOf traversal */
+    private readonly childrenIndex;
+    constructor(config?: TaskCreationRegistryConfig);
+    /**
+     * Insert (or upsert) a task record. Safe to call on existing id — overwrites.
+     * Auto-tracks parent/child relationships for excludeAncestorOf.
+     */
+    record(task: Task, source?: TaskRecordSource): TaskRecord;
+    /**
+     * Mutate an existing record. If the id is unknown, returns undefined
+     * (callers can choose to follow up with record() if they want upsert
+     * semantics — but the standard contract is "update only existing").
+     */
+    update(task: Task, source?: TaskRecordSource): TaskRecord | undefined;
+    /**
+     * Remove a record. No-op if id is unknown.
+     */
+    remove(id: number): boolean;
+    /**
+     * Get a record by id. Returns undefined if the entry has expired
+     * (TTL) so callers don't accidentally resurrect stale state.
+     */
+    getById(id: number): TaskRecord | undefined;
+    /**
+     * Like getById but ignores TTL — useful for tests / debugging.
+     */
+    peekById(id: number): TaskRecord | undefined;
+    /**
+     * Clear all records. Mainly for tests.
+     */
+    clear(): void;
+    /** Total stored records (ignores TTL). Useful for tests/debugging. */
+    size(): number;
+    recent(options?: RecentQueryOptions): TaskRecord[];
+    /**
+     * Task #2395: Subtree summary used by the reuse-candidate prompt.
+     * Returns { descendantCount, activeCount, completedCount, maxDepth } for
+     * the given parent task id. Returns all zeros for unknown parent or empty
+     * subtree (does not throw).
+     */
+    getSubtreeSummary(parentId: number, options?: SubtreeSummaryOptions): SubtreeSummary;
+    /**
+     * Task #2395: True if any direct child of the given parent is active or todo.
+     * Used internally by the activeChildFirst sort.
+     */
+    private hasActiveChild;
+    private toRecord;
+    private safeParseContext;
+    private pickString;
+    private static STRIPPED_KEYS;
+    private stripSensitiveKeys;
+    private upsert;
+    private indexParentChild;
+    private collectSubtree;
+    private evictIfNeeded;
+}

package/dist/env/task/task-reuse-context.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview TaskReuseContext — Build the "reuse candidate" markdown
+ * section injected into sub-agent delegate prompts.
+ *
+ * The section lists recently-active tasks (from TaskCreationRegistry) so the
+ * sub-agent can decide whether to:
+ *   - Reuse the existing task via `task_get` → `task_update` (reopen +
+ *     append description/goals + create a continuation operation record).
+ *   - Or — only if clearly different — call `task_create` for a new task.
+ *
+ * Critical invariants:
+ *   - Candidates are *suggestions*, never auto-merged.
+ *   - The section dedupes against the caller's `similar_task_ids` so the
+ *     sub-agent doesn't see the same task twice in two different sections.
+ *   - Output is bounded by `maxChars` and `maxDescriptionChars` to avoid
+ *     consuming the prompt token budget.
+ *   - Secret-like strings are redacted again at the boundary, as a second
+ *     line of defense (the registry already sanitizes on write).
+ */
+import type { TaskCreationRegistry, RecentQueryOptions } from "./task-creation-registry";
+import type { TaskStatus } from "./types";
+export interface ReuseCandidatePromptOptions {
+    registry: TaskCreationRegistry;
+    /** IDs supplied by caller via similar_task_ids — skip in this section. */
+    similarTaskIds?: number[];
+    /** Scope override (e.g. { subagentType: "roy" }). */
+    scope?: RecentQueryOptions["scope"];
+    /** Default 5 */
+    limit?: number;
+    /** Hard cap on total markdown length. Default 2000. */
+    maxChars?: number;
+    /** Per-candidate description length. Default 240. */
+    maxDescriptionChars?: number;
+    /** Filter statuses. Default = all non-archived. */
+    statuses?: TaskStatus[];
+    /** Exclude the subtree rooted at this task id. */
+    excludeAncestorOf?: number;
+    /** Custom prefix label. Default: "Recent task context (reuse candidates)" */
+    heading?: string;
+}
+export interface ReuseCandidatePromptSection {
+    /** Full markdown block (heading + candidates + instructions). */
+    markdown: string;
+    /** Candidate task ids actually included (after excludeIds). */
+    candidateIds: number[];
+    isEmpty: boolean;
+}
+/**
+ * Build a markdown section listing recent task candidates. Caller is
+ * responsible for deciding whether to append it to the prompt.
+ */
+export declare function buildReuseCandidateSection(options: ReuseCandidatePromptOptions): ReuseCandidatePromptSection;

package/dist/env/task/task-reuse-registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview TaskReuseRegistry — process-global singleton + lazy hook install.
+ *
+ * Provides one TaskCreationRegistry per process. Lazily installs the
+ * registry hook on the first call to `getOrCreateTaskReuseRegistry(env)`
+ * so callers don't have to wire it manually.
+ *
+ * The registry is keyed by env instance so two TaskComponents in the same
+ * process (rare, but possible in tests) each get their own registry.
+ */
+import type { Environment } from "../interface";
+import { TaskCreationRegistry } from "./task-creation-registry";
+import { type InstallHandle } from "./registry-hook-installer";
+export interface TaskReuseRegistryEntry {
+    registry: TaskCreationRegistry;
+    installHandle: InstallHandle;
+}
+/**
+ * Get (and lazily create) the process-global TaskCreationRegistry for the
+ * given environment. On first access, installs the registry hook.
+ *
+ * If the environment doesn't expose a TaskComponent, returns a stub
+ * registry that is never updated — callers can still query it but it
+ * will always be empty.
+ */
+export declare function getOrCreateTaskReuseRegistry(env: Environment): TaskCreationRegistry;
+/**
+ * Uninstall and discard the registry for an environment. Mainly for tests
+ * to ensure clean state between runs.
+ */
+export declare function disposeTaskReuseRegistry(env: Environment): void;

package/dist/env/task/tools/batch-archive-tool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Task Batch Archive Tool
+ *
+ * 批量归档任务工具。将多个任务一次性设为 archived 状态。
+ * 用于任务整理场景（如 task-organizer agent）快速清理已完成的历史任务。
+ */
+import type { Tool } from "../../tool/types";
+import type { TaskComponent } from "../task-component";
+export declare function batchArchiveTaskTool(taskComponent: TaskComponent): Tool;

package/dist/env/task/tools/batch-delete-tool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Task Batch Delete Tool
+ *
+ * 批量删除工具。将多个任务一次性删除。
+ * 用于任务整理场景（如 task-organizer agent）快速清理测试/临时任务。
+ */
+import type { Tool } from "../../tool/types";
+import type { TaskComponent } from "../task-component";
+export declare function batchDeleteTaskTool(taskComponent: TaskComponent): Tool;

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

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Task Complete Tool
+ *
+ * Task #2778: 新增 deliverable_storage_path 参数 + 增强 description
+ */
+import type { Tool } from "../../tool/types";
+import type { TaskComponent } from "../task-component";
+/**
+ * task_complete 工具描述（导出便于单测和未来 reuse）
+ */
+export declare const TASK_COMPLETE_DESCRIPTION: string;
+export declare function completeTaskTool(taskComponent: TaskComponent): Tool;

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

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

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

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

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

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

package/dist/env/task/tools/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Task Tools Index
+ */
+export { createTaskTool } from "./create-tool";
+export { getTaskTool } from "./get-tool";
+export { listTasksTool } from "./list-tool";
+export { searchTasksTool } from "./search-tool";
+export { batchArchiveTaskTool } from "./batch-archive-tool";
+export { batchDeleteTaskTool } from "./batch-delete-tool";
+export { updateTaskTool } from "./update-tool";
+export { deleteTaskTool } from "./delete-tool";
+export { completeTaskTool } from "./complete-tool";
+export { treeTasksTool } from "./task-tree-tool";

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Operation Create Tool (Task #2211: milestone_* 主字段 + action_* 兼容)
+ *
+ * 双维度：
+ * - milestone_* 三字段描述达成的状态/里程碑
+ * - process_description 描述达成过程（100-150 字符硬约束）
+ *
+ * 兼容：action_* 自动映射到 milestone_* 并通过返回 _deprecated_warning 提示。
+ */
+import type { Tool } from "../../../tool/types";
+import type { TaskComponent } from "../../task-component";
+export declare function createOperationTool(taskComponent: TaskComponent): Tool;

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

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

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

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

package/dist/env/task/tools/operation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Operation Tools Index
+ */
+export { createOperationTool } from "./create-tool";
+export { getOperationTool } from "./get-tool";
+export { listOperationsTool } from "./list-tool";
+export { updateOperationTool } from "./update-tool";
+export { deleteOperationTool } from "./delete-tool";