@downcity/agent 1.1.32 → 1.1.43

package/src/plugin/builtins/task/runtime/TaskActionInput.ts

@@ -1,281 +0,0 @@
-/**
- * TaskActionInput：task service 的 CLI 输入映射模块。
- *
- * 关键点（中文）
- * - 统一处理命令行到 task action payload 的转换。
- * - 参数校验尽量前置到输入层，避免进入执行层后才发现字段非法。
- */
-
-import { resolveSessionId } from "@session/ids/resolveSessionId.js";
-import type { JsonValue } from "@/types/common/Json.js";
-import type { PluginActionCommandInput } from "@/plugin/types/Plugin.js";
-import type { ShipTaskKind, ShipTaskStatus } from "@/plugin/builtins/task/types/Task.js";
-import type {
-  TaskCreateRequest,
-  TaskDeleteRequest,
-  TaskRunRequest,
-  TaskSetStatusRequest,
-  TaskUpdateRequest,
-} from "@/plugin/builtins/task/types/TaskCommand.js";
-import type { TaskListActionPayload } from "@/plugin/builtins/task/types/TaskPluginTypes.js";
-
-function parseBooleanLike(value: JsonValue | undefined): boolean | undefined {
-  if (typeof value === "boolean") return value;
-  if (typeof value !== "string") return undefined;
-  const normalized = value.trim().toLowerCase();
-  if (!normalized) return undefined;
-  if (["true", "1", "yes", "on"].includes(normalized)) return true;
-  if (["false", "0", "no", "off"].includes(normalized)) return false;
-  return undefined;
-}
-
-function getStringOpt(
-  opts: Record<string, JsonValue>,
-  key: string,
-): string | undefined {
-  const value = opts[key];
-  return typeof value === "string" ? value.trim() : undefined;
-}
-
-function getBooleanOpt(
-  opts: Record<string, JsonValue>,
-  key: string,
-): boolean | undefined {
-  const value = opts[key];
-  return typeof value === "boolean" ? value : undefined;
-}
-
-function getBooleanLikeOpt(
-  opts: Record<string, JsonValue>,
-  key: string,
-): boolean | undefined {
-  return parseBooleanLike(opts[key]);
-}
-
-function readTaskStatusOrThrow(value?: string): ShipTaskStatus | undefined {
-  if (!value) return undefined;
-  if (value === "enabled" || value === "paused" || value === "disabled") {
-    return value;
-  }
-  throw new Error(`Invalid task status: ${value}`);
-}
-
-function readTaskKindOrThrow(value?: string): ShipTaskKind | undefined {
-  if (!value) return undefined;
-  if (value === "agent" || value === "script") {
-    return value;
-  }
-  throw new Error(`Invalid task kind: ${value}`);
-}
-
-function resolveSessionIdOrThrow(input?: string): string {
-  const sessionId = resolveSessionId({ sessionId: input });
-  if (!sessionId) {
-    throw new Error(
-      "Missing sessionId. Provide --session-id or ensure DC_SESSION_ID is available.",
-    );
-  }
-  return sessionId;
-}
-
-function mapTaskListCommandInput(
-  opts: Record<string, JsonValue>,
-): TaskListActionPayload {
-  const status = readTaskStatusOrThrow(getStringOpt(opts, "status"));
-  return status ? { status } : {};
-}
-
-function mapTaskCreateCommandInput(
-  opts: Record<string, JsonValue>,
-): TaskCreateRequest {
-  const title = String(getStringOpt(opts, "title") || "").trim();
-  const description = String(getStringOpt(opts, "description") || "").trim();
-  if (!title) throw new Error("Missing title");
-  if (!description) throw new Error("Missing description");
-
-  const sessionId = resolveSessionIdOrThrow(getStringOpt(opts, "sessionId"));
-  const kind = readTaskKindOrThrow(getStringOpt(opts, "kind"));
-  const review = getBooleanLikeOpt(opts, "review");
-  const status = readTaskStatusOrThrow(getStringOpt(opts, "status"));
-  const activate = getBooleanOpt(opts, "activate") === true;
-  if (activate && status && status !== "enabled") {
-    throw new Error("`--activate` conflicts with `--status` unless status=enabled");
-  }
-  const resolvedStatus = activate ? "enabled" : status;
-
-  return {
-    title,
-    when: String(getStringOpt(opts, "when") || "@manual").trim() || "@manual",
-    description,
-    sessionId,
-    ...(kind ? { kind } : {}),
-    ...(typeof review === "boolean" ? { review } : {}),
-    ...(resolvedStatus ? { status: resolvedStatus } : {}),
-    ...(typeof getStringOpt(opts, "body") === "string"
-      ? { body: getStringOpt(opts, "body") }
-      : {}),
-    overwrite: getBooleanOpt(opts, "overwrite") === true,
-  };
-}
-
-function mapTaskUpdateCommandInput(params: {
-  title: string;
-  opts: Record<string, JsonValue>;
-}): TaskUpdateRequest {
-  const opts = params.opts;
-  const kind = readTaskKindOrThrow(getStringOpt(opts, "kind"));
-  const review = getBooleanLikeOpt(opts, "review");
-  const status = readTaskStatusOrThrow(getStringOpt(opts, "status"));
-  const activate = getBooleanOpt(opts, "activate") === true;
-
-  // 关键点（中文）：set 与 clear 选项互斥，提前在命令入口做校验。
-  const conflicts: string[] = [];
-  if (
-    typeof getStringOpt(opts, "body") === "string" &&
-    getBooleanOpt(opts, "clearBody")
-  ) {
-    conflicts.push("`--body` conflicts with `--clear-body`");
-  }
-  if (
-    typeof getStringOpt(opts, "when") === "string" &&
-    getBooleanOpt(opts, "clearWhen")
-  ) {
-    conflicts.push("`--when` conflicts with `--clear-when`");
-  }
-  if (activate && status && status !== "enabled") {
-    conflicts.push("`--activate` conflicts with `--status` unless status=enabled");
-  }
-  if (conflicts.length > 0) {
-    throw new Error(conflicts.join("; "));
-  }
-  const resolvedStatus = activate ? "enabled" : status;
-
-  const hasUpdate =
-    typeof getStringOpt(opts, "title") === "string" ||
-    typeof getStringOpt(opts, "when") === "string" ||
-    typeof getStringOpt(opts, "description") === "string" ||
-    typeof getStringOpt(opts, "sessionId") === "string" ||
-    typeof kind === "string" ||
-    typeof review === "boolean" ||
-    getBooleanOpt(opts, "clearWhen") === true ||
-    typeof resolvedStatus === "string" ||
-    typeof getStringOpt(opts, "body") === "string" ||
-    getBooleanOpt(opts, "clearBody") === true;
-
-  if (!hasUpdate) {
-    throw new Error("No update fields provided");
-  }
-
-  return {
-    title: String(params.title || "").trim(),
-    ...(typeof getStringOpt(opts, "title") === "string"
-      ? { titleNext: getStringOpt(opts, "title") }
-      : {}),
-    ...(typeof getStringOpt(opts, "when") === "string"
-      ? { when: getStringOpt(opts, "when") }
-      : {}),
-    ...(typeof getStringOpt(opts, "description") === "string"
-      ? { description: getStringOpt(opts, "description") }
-      : {}),
-    ...(typeof getStringOpt(opts, "sessionId") === "string"
-      ? { sessionId: getStringOpt(opts, "sessionId") }
-      : {}),
-    ...(typeof kind === "string" ? { kind } : {}),
-    ...(typeof review === "boolean" ? { review } : {}),
-    ...(getBooleanOpt(opts, "clearWhen") ? { clearWhen: true } : {}),
-    ...(typeof resolvedStatus === "string" ? { status: resolvedStatus } : {}),
-    ...(typeof getStringOpt(opts, "body") === "string"
-      ? { body: getStringOpt(opts, "body") }
-      : {}),
-    ...(getBooleanOpt(opts, "clearBody") ? { clearBody: true } : {}),
-  };
-}
-
-function mapTaskSetStatusCommandInput(params: {
-  title: string;
-  status: ShipTaskStatus;
-}): TaskSetStatusRequest {
-  return {
-    title: String(params.title || "").trim(),
-    status: params.status,
-  };
-}
-
-function mapTaskDeleteCommandInput(titleInput: string): TaskDeleteRequest {
-  const title = String(titleInput || "").trim();
-  if (!title) throw new Error("Missing title");
-  return { title };
-}
-
-export function mapTaskListCommandPayload(
-  input: PluginActionCommandInput,
-): TaskListActionPayload {
-  return mapTaskListCommandInput(input.opts);
-}
-
-export function mapTaskCreateCommandPayload(
-  input: PluginActionCommandInput,
-): TaskCreateRequest {
-  return mapTaskCreateCommandInput(input.opts);
-}
-
-export function mapTaskRunCommandPayload(
-  input: PluginActionCommandInput,
-): TaskRunRequest {
-  const title = String(input.args[0] || "").trim();
-  if (!title) throw new Error("Missing title");
-  const reason = getStringOpt(input.opts, "reason");
-  return {
-    title,
-    ...(reason ? { reason } : {}),
-  };
-}
-
-export function mapTaskDeleteCommandPayload(
-  input: PluginActionCommandInput,
-): TaskDeleteRequest {
-  return mapTaskDeleteCommandInput(String(input.args[0] || ""));
-}
-
-export function mapTaskUpdateCommandPayload(
-  input: PluginActionCommandInput,
-): TaskUpdateRequest {
-  const title = String(input.args[0] || "").trim();
-  if (!title) throw new Error("Missing title");
-  return mapTaskUpdateCommandInput({
-    title,
-    opts: input.opts,
-  });
-}
-
-export function mapTaskStatusCommandPayload(
-  input: PluginActionCommandInput,
-): TaskSetStatusRequest {
-  const title = String(input.args[0] || "").trim();
-  const status = readTaskStatusOrThrow(String(input.args[1] || "").trim());
-  if (!title) throw new Error("Missing title");
-  if (!status) throw new Error("Missing or invalid status");
-  return mapTaskSetStatusCommandInput({ title, status });
-}
-
-export function mapTaskEnableCommandPayload(
-  input: PluginActionCommandInput,
-): TaskSetStatusRequest {
-  const title = String(input.args[0] || "").trim();
-  if (!title) throw new Error("Missing title");
-  return mapTaskSetStatusCommandInput({
-    title,
-    status: "enabled",
-  });
-}
-
-export function mapTaskDisableCommandPayload(
-  input: PluginActionCommandInput,
-): TaskSetStatusRequest {
-  const title = String(input.args[0] || "").trim();
-  if (!title) throw new Error("Missing title");
-  return mapTaskSetStatusCommandInput({
-    title,
-    status: "disabled",
-  });
-}

package/src/plugin/builtins/task/runtime/TaskPluginActionRegistry.ts

@@ -1,214 +0,0 @@
-/**
- * TaskPluginActions：task service 的 action 注册表模块。
- *
- * 关键点（中文）
- * - 这里专门负责把 task 的 CLI/execute 定义装配成 `PluginActions`。
- * - TaskService 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
- */
-
-import type { Command } from "commander";
-import type { PluginActions } from "@/plugin/types/Plugin.js";
-import type { TaskListActionPayload } from "@/plugin/builtins/task/types/TaskPluginTypes.js";
-import type {
-  TaskCreateRequest,
-  TaskDeleteRequest,
-  TaskRunRequest,
-  TaskSetStatusRequest,
-  TaskUpdateRequest,
-} from "@/plugin/builtins/task/types/TaskCommand.js";
-import {
-  executeTaskCreateAction,
-  executeTaskDeleteAction,
-  executeTaskListAction,
-  executeTaskRunAction,
-  executeTaskStatusAction,
-  executeTaskUpdateAction,
-  type TaskSchedulerReloadPort,
-} from "./TaskActionExecution.js";
-import {
-  mapTaskCreateCommandPayload,
-  mapTaskDeleteCommandPayload,
-  mapTaskDisableCommandPayload,
-  mapTaskEnableCommandPayload,
-  mapTaskListCommandPayload,
-  mapTaskRunCommandPayload,
-  mapTaskStatusCommandPayload,
-  mapTaskUpdateCommandPayload,
-} from "./TaskActionInput.js";
-
-/**
- * 创建 task service 的 action 定义表。
- */
-export function createTaskPluginActions(params: {
-  reloadSchedulerAfterMutation: TaskSchedulerReloadPort;
-}): PluginActions {
-  return {
-    list: {
-      command: {
-        description: "列出任务",
-        configure(command: Command) {
-          command.option(
-            "--status <status>",
-            "按状态过滤（enabled|paused|disabled）",
-          );
-        },
-        mapInput: mapTaskListCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskListAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskListActionPayload,
-        });
-      },
-    },
-    create: {
-      command: {
-        description: "创建任务定义",
-        configure(command: Command) {
-          command
-            .requiredOption("--title <title>", "任务名称（唯一语义标识）")
-            .requiredOption("--description <description>", "任务描述")
-            .option("--when <when>", "触发条件（@manual | cron | time:ISO8601）", "@manual")
-            .option("--kind <kind>", "执行类型（agent|script）", "agent")
-            .option("--review <review>", "是否启用 review 多轮复核（true|false）")
-            .option(
-              "--session-id <sessionId>",
-              "任务执行 sessionId（不传尝试使用 DC_SESSION_ID）",
-            )
-            .option(
-              "--status <status>",
-              "状态（enabled|paused|disabled，默认 enabled）",
-            )
-            .option(
-              "--activate",
-              "创建后立即启用（等同 --status enabled）",
-              false,
-            )
-            .option("--body <body>", "任务正文")
-            .option("--overwrite", "覆盖已有 task.md", false);
-        },
-        mapInput: mapTaskCreateCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskCreateAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskCreateRequest,
-          reloadSchedulerAfterMutation: params.reloadSchedulerAfterMutation,
-        });
-      },
-    },
-    run: {
-      command: {
-        description: "手动运行任务",
-        configure(command: Command) {
-          command
-            .argument("<title>")
-            .option("--reason <reason>", "手动运行原因");
-        },
-        mapInput: mapTaskRunCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskRunAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskRunRequest,
-        });
-      },
-    },
-    delete: {
-      command: {
-        description: "删除任务定义与历史运行目录",
-        configure(command: Command) {
-          command.argument("<title>");
-        },
-        mapInput: mapTaskDeleteCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskDeleteAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskDeleteRequest,
-          reloadSchedulerAfterMutation: params.reloadSchedulerAfterMutation,
-        });
-      },
-    },
-    update: {
-      command: {
-        description: "更新任务定义",
-        configure(command: Command) {
-          command
-            .argument("<title>")
-            .option("--title <title>", "任务名称（保持同一语义）")
-            .option("--description <description>", "任务描述")
-            .option("--when <when>", "触发条件（@manual | cron | time:ISO8601）")
-            .option("--kind <kind>", "执行类型（agent|script）")
-            .option("--review <review>", "是否启用 review 多轮复核（true|false）")
-            .option("--clear-when", "清空 when（回退为 @manual）", false)
-            .option("--session-id <sessionId>", "任务执行 sessionId")
-            .option("--status <status>", "状态（enabled|paused|disabled）")
-            .option(
-              "--activate",
-              "更新后立即启用（等同 --status enabled）",
-              false,
-            )
-            .option("--body <body>", "设置任务正文")
-            .option("--clear-body", "清空任务正文", false);
-        },
-        mapInput: mapTaskUpdateCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskUpdateAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskUpdateRequest,
-          reloadSchedulerAfterMutation: params.reloadSchedulerAfterMutation,
-        });
-      },
-    },
-    status: {
-      command: {
-        description: "设置任务状态（enabled|paused|disabled）",
-        configure(command: Command) {
-          command.argument("<title>").argument("<status>");
-        },
-        mapInput: mapTaskStatusCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskStatusAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskSetStatusRequest,
-          reloadSchedulerAfterMutation: params.reloadSchedulerAfterMutation,
-        });
-      },
-    },
-    enable: {
-      command: {
-        description: "启用任务（status=enabled）",
-        configure(command: Command) {
-          command.argument("<title>");
-        },
-        mapInput: mapTaskEnableCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskStatusAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskSetStatusRequest,
-          reloadSchedulerAfterMutation: params.reloadSchedulerAfterMutation,
-        });
-      },
-    },
-    disable: {
-      command: {
-        description: "禁用任务（status=disabled）",
-        configure(command: Command) {
-          command.argument("<title>");
-        },
-        mapInput: mapTaskDisableCommandPayload,
-      },
-      execute: async (actionParams) => {
-        return executeTaskStatusAction({
-          context: actionParams.context,
-          payload: actionParams.payload as TaskSetStatusRequest,
-          reloadSchedulerAfterMutation: params.reloadSchedulerAfterMutation,
-        });
-      },
-    },
-  };
-}

package/src/plugin/builtins/task/runtime/TaskPluginActions.ts

@@ -1,5 +0,0 @@
-/**
- * TaskPluginActions 导出门面。
- */
-
-export { createTaskPluginActions } from "./TaskPluginActionRegistry.js";

package/src/plugin/builtins/task/runtime/TaskPluginSystem.ts

@@ -1,8 +0,0 @@
-/**
- * TaskPluginSystem：task plugin 的 system prompt 模块。
- *
- * 关键点（中文）
- * - task plugin prompt 属于静态资产。
- * - 当前直接从 TS 常量导出，避免运行时文件系统依赖。
- */
-export { TASK_PLUGIN_PROMPT } from "@/plugin/builtins/task/runtime/TaskPromptAssets.js";

package/src/plugin/builtins/task/runtime/TaskPromptAssets.ts

@@ -1,14 +0,0 @@
-/**
- * TaskPromptAssets：task plugin 静态提示词资产。
- *
- * 关键点（中文）
- * - task prompt 文本真实来源是 `PROMPT.ts.txt`。
- * - 这里统一做 `trim()`，保持 plugin system 文本行为稳定。
- */
-
-import taskServicePromptText from "@/plugin/builtins/task/PROMPT.js";
-
-/**
- * task plugin 固定 system prompt 文本。
- */
-export const TASK_PLUGIN_PROMPT = taskServicePromptText.trim();