@downcity/city 1.1.1 → 1.1.4

package/bin/services/shell/types/ShellService.d.ts

@@ -1,216 +0,0 @@
-/**
- * Shell service 类型定义。
- *
- * 关键点（中文）
- * - `shell_id` 是 shell 会话的唯一标识，与 chat `sessionId` 严格区分。
- * - 这些类型同时服务于 service 层状态管理与 agent tool 协议。
- */
-export type ShellSessionStatus = "starting" | "running" | "completed" | "failed" | "killed" | "expired";
-/**
- * shell 会话关联的外部引用。
- *
- * 说明（中文）
- * - 用于记录诸如第三方平台 `thread_id`、任务链接等弱结构化引用。
- * - 不要求所有 shell 都存在该信息；仅在可识别时附加。
- */
-export type ShellExternalRef = {
-    /** 引用类别，例如 `thread_id`。 */
-    kind: string;
-    /** 引用的原始值。 */
-    value: string;
-    /** 可选的人类可读标签。 */
-    label?: string;
-};
-/**
- * shell 会话快照。
- *
- * 说明（中文）
- * - 该对象是 shell service 对外暴露的统一状态视图。
- * - 内部运行态（child process / waiter 集合）不会暴露给上层。
- */
-export type ShellSessionSnapshot = {
-    /** shell 唯一标识。 */
-    shellId: string;
-    /** 发起该 shell 的 chat/context 标识；不存在时表示非聊天上下文触发。 */
-    ownerContextId?: string;
-    /** 原始命令字符串。 */
-    cmd: string;
-    /** 命令执行工作目录（绝对路径）。 */
-    cwd: string;
-    /** 实际使用的 shell 可执行文件路径。 */
-    shellPath: string;
-    /** 当前 shell 是否运行在 sandbox 中。 */
-    sandboxed?: boolean;
-    /** 当前 shell 使用的 sandbox backend。 */
-    sandboxBackend?: string;
-    /** 当前 shell 采用的 sandbox 网络模式。 */
-    sandboxNetworkMode?: "off" | "restricted" | "full";
-    /** 当前 shell 状态。 */
-    status: ShellSessionStatus;
-    /** 子进程 pid；若尚未创建成功则为空。 */
-    pid?: number;
-    /** shell 创建时间戳（毫秒）。 */
-    startedAt: number;
-    /** 最近一次状态或输出变更时间戳（毫秒）。 */
-    updatedAt: number;
-    /** shell 结束时间戳（毫秒）；运行中为空。 */
-    endedAt?: number;
-    /** 进程退出码；运行中为空。 */
-    exitCode?: number;
-    /** 最近一次收到输出的时间戳（毫秒）。 */
-    lastOutputAt?: number;
-    /** 最近一小段输出预览，供状态查询快速展示。 */
-    lastOutputPreview?: string;
-    /** 当前累计输出字符数。 */
-    outputChars: number;
-    /** 因内存缓存裁剪而丢弃的字符数。 */
-    droppedChars: number;
-    /** 状态版本号；任意输出/状态变化都递增。 */
-    version: number;
-    /** 是否在 shell 结束后自动回投到所属 chat，让主 agent 自己回复。 */
-    autoNotifyOnExit: boolean;
-    /** 自动回投是否已经发送，避免重复通知。 */
-    notificationSent: boolean;
-    /** 从输出中识别到的外部引用集合。 */
-    externalRefs: ShellExternalRef[];
-};
-/**
- * shell 启动请求。
- */
-export type ShellStartRequest = {
-    /** 要执行的完整 shell 命令。 */
-    cmd: string;
-    /** 可选工作目录；为空时回退项目根目录。 */
-    cwd?: string;
-    /** 可选 shell 路径，例如 `/bin/zsh`。 */
-    shell?: string;
-    /** 是否以 login shell 方式启动；默认 `true`。 */
-    login?: boolean;
-    /** 启动后内联等待多久再返回首批状态/输出。 */
-    inlineWaitMs?: number;
-    /** 单次读取输出返回给模型的 token 上限。 */
-    maxOutputTokens?: number;
-    /** 显式指定 owner sessionId；为空时优先从 SessionRunScope 推断。 */
-    ownerContextId?: string;
-    /** 是否在 shell 结束后自动回投主 chat agent。 */
-    autoNotifyOnExit?: boolean;
-};
-/**
- * shell 一次性执行请求。
- *
- * 说明（中文）
- * - 适合短命令与无需中途查询状态的场景。
- * - 底层仍复用 shell session 引擎，但调用方不需要管理 `shell_id`。
- */
-export type ShellExecRequest = {
-    /** 要执行的完整 shell 命令。 */
-    cmd: string;
-    /** 可选工作目录；为空时回退项目根目录。 */
-    cwd?: string;
-    /** 可选 shell 路径，例如 `/bin/zsh`。 */
-    shell?: string;
-    /** 是否以 login shell 方式启动；默认 `true`。 */
-    login?: boolean;
-    /** 整个一次性执行的总超时时间（毫秒）。 */
-    timeoutMs?: number;
-    /** 单次读取输出返回给模型的 token 上限。 */
-    maxOutputTokens?: number;
-};
-/**
- * shell 查询请求。
- *
- * 说明（中文）
- * - `shellId` 优先级最高。
- * - 若未提供 `shellId`，允许在同一 owner context 下按 `cmd` 模糊匹配最近一个会话。
- */
-export type ShellQueryRequest = {
-    /** 目标 shell_id。 */
-    shellId?: string;
-    /** 命令关键字；用于在当前 context 下查找最近匹配会话。 */
-    cmd?: string;
-    /** 指定 owner sessionId；为空时优先从 SessionRunScope 推断。 */
-    ownerContextId?: string;
-    /** 是否允许匹配已结束会话。 */
-    includeCompleted?: boolean;
-};
-/**
- * shell 输出读取请求。
- */
-export type ShellReadRequest = ShellQueryRequest & {
-    /** 从哪个字符偏移开始读取；默认从头或从最新游标外部自行维护。 */
-    fromCursor?: number;
-    /** 单次读取输出返回给模型的 token 上限。 */
-    maxOutputTokens?: number;
-};
-/**
- * shell stdin 写入请求。
- */
-export type ShellWriteRequest = {
-    /** 目标 shell_id。 */
-    shellId: string;
-    /** 要写入 stdin 的原始文本。 */
-    chars: string;
-};
-/**
- * shell 等待请求。
- *
- * 说明（中文）
- * - `afterVersion` 用于等待“状态变化”而非模型侧空轮询。
- * - 可同时附带 `fromCursor`，一旦变化就顺便取回新的输出增量。
- */
-export type ShellWaitRequest = {
-    /** 目标 shell_id。 */
-    shellId: string;
-    /** 仅当版本号大于该值时才立即返回。 */
-    afterVersion?: number;
-    /** 读取输出的起始字符游标。 */
-    fromCursor?: number;
-    /** 最大等待时间（毫秒）。 */
-    timeoutMs?: number;
-    /** 单次读取输出返回给模型的 token 上限。 */
-    maxOutputTokens?: number;
-};
-/**
- * shell 关闭请求。
- */
-export type ShellCloseRequest = {
-    /** 目标 shell_id。 */
-    shellId: string;
-    /** 是否强制 kill（SIGKILL）；默认优雅终止。 */
-    force?: boolean;
-};
-/**
- * shell 输出块。
- *
- * 说明（中文）
- * - 统一用于 `start/read/wait` 的输出增量返回。
- * - `startCursor/endCursor` 采用字符偏移，便于上层自行维护断点。
- */
-export type ShellOutputChunk = {
-    /** 本次输出块对应的 shell_id。 */
-    shellId: string;
-    /** 本次读取返回的文本。 */
-    output: string;
-    /** 本次读取的起始字符游标。 */
-    startCursor: number;
-    /** 本次读取结束后的字符游标。 */
-    endCursor: number;
-    /** 原始待读取文本字符数。 */
-    originalChars: number;
-    /** 原始待读取文本行数。 */
-    originalLines: number;
-    /** 是否仍有未读输出。 */
-    hasMoreOutput: boolean;
-};
-/**
- * shell service 对 agent tool 返回的统一数据结构。
- */
-export type ShellActionResponse = {
-    /** shell 当前快照。 */
-    shell: ShellSessionSnapshot;
-    /** 可选输出块；仅在 start/read/wait 中返回。 */
-    chunk?: ShellOutputChunk;
-    /** 操作说明或附加提示。 */
-    note?: string;
-};
-//# sourceMappingURL=ShellService.d.ts.map

package/bin/services/shell/types/ShellService.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellService.d.ts","sourceRoot":"","sources":["../../../../src/services/shell/types/ShellService.ts"],"names":[],"mappings":"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"}

package/bin/services/shell/types/ShellService.js

@@ -1,9 +0,0 @@
-/**
- * Shell service 类型定义。
- *
- * 关键点（中文）
- * - `shell_id` 是 shell 会话的唯一标识，与 chat `sessionId` 严格区分。
- * - 这些类型同时服务于 service 层状态管理与 agent tool 协议。
- */
-export {};
-//# sourceMappingURL=ShellService.js.map

package/bin/services/shell/types/ShellService.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellService.js","sourceRoot":"","sources":["../../../../src/services/shell/types/ShellService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/services/task/Action.d.ts

@@ -1,36 +0,0 @@
-/**
- * Task command services.
- *
- * 关键点（中文）
- * - 任务定义（task.md）与执行（runTaskNow）统一收口到服务层
- * - CLI 与 Server 共用同一份参数归一化/校验逻辑
- */
-import type { ShipTaskStatus } from "./types/Task.js";
-import type { AgentContext } from "../../types/agent/AgentContext.js";
-import type { TaskCreateRequest, TaskCreateResponse, TaskDeleteRequest, TaskDeleteResponse, TaskListResponse, TaskRunRequest, TaskRunResponse, TaskUpdateRequest, TaskUpdateResponse, TaskSetStatusRequest, TaskSetStatusResponse } from "./types/TaskCommand.js";
-export declare function listTaskDefinitions(params: {
-    projectRoot: string;
-    status?: ShipTaskStatus;
-}): Promise<TaskListResponse>;
-export declare function createTaskDefinition(params: {
-    projectRoot: string;
-    request: TaskCreateRequest;
-}): Promise<TaskCreateResponse>;
-export declare function updateTaskDefinition(params: {
-    projectRoot: string;
-    request: TaskUpdateRequest;
-}): Promise<TaskUpdateResponse>;
-export declare function runTaskDefinition(params: {
-    context: AgentContext;
-    projectRoot: string;
-    request: TaskRunRequest;
-}): Promise<TaskRunResponse>;
-export declare function setTaskStatus(params: {
-    projectRoot: string;
-    request: TaskSetStatusRequest;
-}): Promise<TaskSetStatusResponse>;
-export declare function deleteTaskDefinition(params: {
-    projectRoot: string;
-    request: TaskDeleteRequest;
-}): Promise<TaskDeleteResponse>;
-//# sourceMappingURL=Action.d.ts.map

package/bin/services/task/Action.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../src/services/task/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAmBlE,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAsDhC,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0B5B;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2E9B;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6G9B;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoF3B;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;CAC/B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8CjC;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0B9B"}

package/bin/services/task/Action.js

@@ -1,407 +0,0 @@
-/**
- * Task command services.
- *
- * 关键点（中文）
- * - 任务定义（task.md）与执行（runTaskNow）统一收口到服务层
- * - CLI 与 Server 共用同一份参数归一化/校验逻辑
- */
-import path from "node:path";
-import { deriveTaskIdFromTitle, normalizeTaskId, } from "./runtime/Paths.js";
-import { normalizeTaskKind, normalizeTaskWhen, normalizeTaskStatus, } from "./runtime/Model.js";
-import { deleteTask, listTasks, readTask, resolveTaskIdByTitle, writeTask, } from "./runtime/Store.js";
-import { runTaskNow } from "./runtime/Runner.js";
-function resolveTaskStatus(input, fallback) {
-    const normalized = normalizeTaskStatus(input);
-    return normalized || fallback;
-}
-const TASK_LOG_PREFIX = "[TASK]";
-function formatTaskLogMessage(message) {
-    return `${TASK_LOG_PREFIX} ${message}`;
-}
-function buildDefaultTaskBody() {
-    return [
-        "# 任务目标",
-        "",
-        "- 明确这次任务最终要交付什么结果，最终回复会由系统自动发送到任务绑定的 chat。",
-        "- 如果需要额外文件，请写入本次 run 目录，便于审计和排查。",
-        "",
-        "# 背景与输入",
-        "",
-        "- 补充任务依赖的上下文、数据来源、范围限制与关键假设。",
-        "- 如果存在用户原话、链接、文件路径或口径要求，在这里写清楚。",
-        "",
-        "# 执行步骤",
-        "",
-        "1. 先理解任务目标与完成标准。",
-        "2. 按需要收集信息、执行分析或运行命令。",
-        "3. 把关键中间产物写入 run 目录。",
-        "4. 整理出面向用户可直接阅读的最终结果。",
-        "",
-        "# 输出要求",
-        "",
-        "- 最终输出直接写结果本身，不要包多余寒暄，不要粘贴冗长日志。",
-        "- 需要结构时，优先使用短标题、要点列表、表格或 JSON 等稳定格式。",
-        "- 默认不要在正文里重复调用 `city chat send`；系统会自动发送最终结果。",
-        "",
-        "# 触发与状态建议",
-        "",
-        "- 默认创建后会立即启用；如果还在试运行或需要人工确认，再改成 `paused`。",
-        "- 已经稳定、需要周期执行的任务：优先保持 `enabled`，再改成 cron。",
-        "- 一次性定时任务：使用 `time:<带时区的 ISO 时间>`；执行后会自动回退为 `@manual` + `paused`。",
-        "",
-        "# 注意事项",
-        "",
-        "- 当前是独立 task 上下文，不要假设仍处在原始聊天回合里。",
-        "- 尽量使用可审计的方式：关键中间产物写入 `./.downcity/task/<title>/<timestamp>/` 下的 markdown 文件。",
-        "- 如果任务明确要求跨会话、跨平台或发送额外通知，再显式调用 `city chat send`。",
-        "",
-    ].join("\n");
-}
-export async function listTaskDefinitions(params) {
-    const root = path.resolve(params.projectRoot);
-    const normalizedStatus = normalizeTaskStatus(params.status);
-    const tasks = await listTasks(root);
-    const filtered = normalizedStatus
-        ? tasks.filter((task) => String(task.status).toLowerCase() === normalizedStatus)
-        : tasks;
-    return {
-        success: true,
-        tasks: filtered.map((task) => ({
-            title: task.title,
-            description: task.description,
-            ...(typeof task.body === "string" && task.body.trim()
-                ? { body: task.body }
-                : {}),
-            when: task.when,
-            status: task.status,
-            sessionId: task.sessionId,
-            kind: task.kind || "agent",
-            ...(task.kind === "agent" ? { review: Boolean(task.review) } : {}),
-            taskMdPath: task.taskMdPath,
-            ...(task.lastRunTimestamp ? { lastRunTimestamp: task.lastRunTimestamp } : {}),
-        })),
-    };
-}
-export async function createTaskDefinition(params) {
-    const root = path.resolve(params.projectRoot);
-    const req = params.request;
-    const title = String(req.title || "").trim();
-    const description = String(req.description || "").trim();
-    let taskIdFromName = "";
-    let taskId = "";
-    try {
-        taskIdFromName = deriveTaskIdFromTitle(title);
-        taskId = normalizeTaskId(taskIdFromName);
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
-    const whenNormalized = normalizeTaskWhen(String(req.when || "@manual").trim() || "@manual");
-    const sessionId = String(req.sessionId || "").trim();
-    const kind = normalizeTaskKind(req.kind);
-    if (!title)
-        return { success: false, error: "Missing title" };
-    if (!description)
-        return { success: false, error: "Missing description" };
-    if (!sessionId)
-        return { success: false, error: "Missing sessionId" };
-    if (!whenNormalized.ok)
-        return { success: false, error: whenNormalized.error };
-    const status = resolveTaskStatus(req.status, "enabled");
-    const body = typeof req.body === "string" && req.body.trim()
-        ? req.body.trim()
-        : kind === "script"
-            ? ""
-            : buildDefaultTaskBody();
-    // 关键点（中文）：`title` 是唯一键，create 去重只按 title 精确匹配。
-    const existingTasks = await listTasks(root);
-    const duplicated = existingTasks.find((item) => String(item.title || "").trim() === title);
-    if (duplicated && !req.overwrite) {
-        return {
-            success: true,
-            title: duplicated.title,
-            taskMdPath: duplicated.taskMdPath,
-            reusedExisting: true,
-            message: "Task title already exists; reused existing task.",
-        };
-    }
-    const targetTaskId = duplicated ? duplicated.taskId : taskId;
-    try {
-        const written = await writeTask({
-            taskId: targetTaskId,
-            projectRoot: root,
-            overwrite: Boolean(req.overwrite) || Boolean(duplicated),
-            frontmatter: {
-                title,
-                description,
-                when: whenNormalized.value,
-                sessionId,
-                kind,
-                ...(kind === "agent" && req.review === true ? { review: true } : {}),
-                status,
-            },
-            body,
-        });
-        return {
-            success: true,
-            title,
-            taskMdPath: written.taskMdPath,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
-}
-export async function updateTaskDefinition(params) {
-    const root = path.resolve(params.projectRoot);
-    const req = params.request;
-    const title = String(req.title || "").trim();
-    let taskId = "";
-    try {
-        taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
-    }
-    catch (error) {
-        return { success: false, error: String(error) };
-    }
-    // 关键点（中文）：API 层也做一次互斥校验，避免非 CLI 调用写入歧义状态。
-    if (req.body !== undefined && req.clearBody) {
-        return { success: false, error: "`body` conflicts with `clearBody`" };
-    }
-    if (req.when !== undefined && req.clearWhen) {
-        return { success: false, error: "`when` conflicts with `clearWhen`" };
-    }
-    try {
-        const current = await readTask({
-            projectRoot: root,
-            taskId,
-        });
-        const nextTitle = typeof req.titleNext === "string"
-            ? req.titleNext.trim()
-            : current.frontmatter.title;
-        if (!nextTitle)
-            return { success: false, error: "title cannot be empty" };
-        const nextTaskId = normalizeTaskId(deriveTaskIdFromTitle(nextTitle));
-        if (nextTaskId !== taskId) {
-            return {
-                success: false,
-                error: `title cannot change task identity. Expected "${taskId}", got "${nextTaskId}".`,
-            };
-        }
-        const description = typeof req.description === "string"
-            ? req.description.trim()
-            : current.frontmatter.description;
-        if (!description)
-            return { success: false, error: "description cannot be empty" };
-        const whenInput = req.clearWhen
-            ? "@manual"
-            : typeof req.when === "string"
-                ? req.when.trim()
-                : current.frontmatter.when;
-        const whenNormalized = normalizeTaskWhen(whenInput);
-        if (!whenNormalized.ok)
-            return { success: false, error: whenNormalized.error };
-        const sessionId = typeof req.sessionId === "string" ? req.sessionId.trim() : current.frontmatter.sessionId;
-        if (!sessionId)
-            return { success: false, error: "sessionId cannot be empty" };
-        const kind = normalizeTaskKind(req.kind === undefined ? current.frontmatter.kind : req.kind);
-        const review = kind === "agent"
-            ? req.review === undefined
-                ? Boolean(current.frontmatter.review)
-                : req.review === true
-            : false;
-        const status = req.status === undefined
-            ? current.frontmatter.status
-            : normalizeTaskStatus(req.status);
-        if (!status) {
-            return {
-                success: false,
-                error: `Invalid status: ${String(req.status)}`,
-            };
-        }
-        const body = req.clearBody
-            ? ""
-            : typeof req.body === "string"
-                ? req.body.trim()
-                : current.body;
-        const written = await writeTask({
-            projectRoot: root,
-            taskId,
-            overwrite: true,
-            frontmatter: {
-                title: nextTitle,
-                description,
-                when: whenNormalized.value,
-                sessionId,
-                kind,
-                ...(kind === "agent" && review ? { review: true } : {}),
-                status,
-            },
-            body,
-        });
-        return {
-            success: true,
-            title: nextTitle,
-            taskMdPath: written.taskMdPath,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
-}
-export async function runTaskDefinition(params) {
-    const root = path.resolve(params.projectRoot);
-    const title = String(params.request.title || "").trim();
-    let taskId = "";
-    try {
-        taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
-    }
-    catch (error) {
-        return { success: false, error: String(error) };
-    }
-    const reason = typeof params.request.reason === "string" ? params.request.reason.trim() : "";
-    const trigger = {
-        type: "manual",
-        ...(reason ? { reason } : {}),
-    };
-    try {
-        // 关键点（中文）：run 改为“异步受理”，先做存在性校验，再后台执行。
-        await readTask({
-            taskId,
-            projectRoot: root,
-        });
-        params.context.logger.info(formatTaskLogMessage("Manual task run accepted"), {
-            taskId,
-            via: "manual",
-            ...(reason ? { reason } : {}),
-        });
-        const executionId = `${taskId}:${Date.now()}`;
-        void runTaskNow({
-            context: params.context,
-            projectRoot: root,
-            taskId,
-            trigger,
-            executionId,
-        })
-            .then((result) => {
-            params.context.logger.info(formatTaskLogMessage("Manual task run finished"), {
-                taskId,
-                via: "manual",
-                status: result.status,
-                executionStatus: result.executionStatus,
-                resultStatus: result.resultStatus,
-                ...(result.resultErrors.length > 0
-                    ? { resultErrors: result.resultErrors }
-                    : {}),
-                dialogueRounds: result.dialogueRounds,
-                userSimulatorSatisfied: result.userSimulatorSatisfied,
-                executionId: result.executionId,
-                timestamp: result.timestamp,
-                runDir: result.runDirRel,
-            });
-        })
-            .catch((error) => {
-            params.context.logger.error(formatTaskLogMessage("Manual task run failed"), {
-                taskId,
-                via: "manual",
-                error: String(error),
-            });
-        });
-        return {
-            success: true,
-            accepted: true,
-            // 关键点（中文）：这里直接返回给 agent 作为 tool result，提醒它这是异步任务，无需等待完成即可继续后续流程。
-            message: "任务已经开始执行，完成后 task 会自动发送给用户。请直接继续后续流程，无需等待 task 完成。",
-            executionId,
-            title,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
-}
-export async function setTaskStatus(params) {
-    const root = path.resolve(params.projectRoot);
-    const title = String(params.request.title || "").trim();
-    let taskId = "";
-    try {
-        taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
-    }
-    catch (error) {
-        return { success: false, error: String(error) };
-    }
-    const status = normalizeTaskStatus(params.request.status);
-    if (!status) {
-        return {
-            success: false,
-            error: `Invalid status: ${String(params.request.status)}`,
-        };
-    }
-    try {
-        const task = await readTask({
-            projectRoot: root,
-            taskId,
-        });
-        await writeTask({
-            projectRoot: root,
-            taskId,
-            overwrite: true,
-            frontmatter: {
-                ...task.frontmatter,
-                status,
-            },
-            body: task.body,
-        });
-        return {
-            success: true,
-            title: task.frontmatter.title,
-            status,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
-}
-export async function deleteTaskDefinition(params) {
-    const root = path.resolve(params.projectRoot);
-    const title = String(params.request.title || "").trim();
-    let taskId = "";
-    try {
-        taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
-    }
-    catch (error) {
-        return { success: false, error: String(error) };
-    }
-    try {
-        const deleted = await deleteTask({
-            projectRoot: root,
-            taskId,
-        });
-        return {
-            success: true,
-            title,
-            taskDirPath: deleted.taskDirPath,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
-}
-//# sourceMappingURL=Action.js.map