@downcity/agent 1.1.23 → 1.1.32

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

@@ -0,0 +1,281 @@
+/**
+ * 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

@@ -0,0 +1,214 @@
+/**
+ * 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

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

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

@@ -0,0 +1,8 @@
+/**
+ * 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

@@ -0,0 +1,14 @@
+/**
+ * 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();