@downcity/agent 1.1.1

package/bin/services/task/runtime/Model.js

@@ -0,0 +1,312 @@
+/**
+ * Task definition parsing and validation.
+ *
+ * 关键点（中文）
+ * - `task.md` 使用 YAML frontmatter + markdown 正文
+ * - frontmatter 必须包含：title/when/description/sessionId/status
+ * - `when` 统一承载触发语义：`@manual` / cron / `time:<ISO8601-with-timezone>`
+ */
+import yaml from "js-yaml";
+import path from "node:path";
+import cron from "node-cron";
+import { parseFrontMatter } from "./Frontmatter.js";
+/**
+ * 必填 frontmatter 字段清单。
+ */
+const REQUIRED_FIELDS = [
+    "title",
+    "when",
+    "description",
+    "sessionId",
+    "status",
+];
+function normalizeTaskReview(input) {
+    if (typeof input === "boolean")
+        return input;
+    if (typeof input !== "string")
+        return null;
+    const value = input.trim().toLowerCase();
+    if (!value)
+        return null;
+    if (["true", "1", "yes", "on"].includes(value))
+        return true;
+    if (["false", "0", "no", "off"].includes(value))
+        return false;
+    return null;
+}
+/**
+ * cron alias 映射表。
+ */
+const CRON_ALIAS_TO_EXPRESSION = {
+    "@manual": "@manual",
+    "@hourly": "0 * * * *",
+    "@daily": "0 0 * * *",
+    "@weekly": "0 0 * * 0",
+    "@monthly": "0 0 1 * *",
+    "@yearly": "0 0 1 1 *",
+    "@annually": "0 0 1 1 *",
+};
+const ISO_DATETIME_WITH_TZ_REGEXP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:\d{2})$/i;
+const ISO_DATETIME_WITHOUT_TZ_REGEXP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?$/i;
+function normalizeCronExpression(raw) {
+    const value = String(raw || "").trim();
+    if (!value)
+        return null;
+    const lower = value.toLowerCase();
+    return CRON_ALIAS_TO_EXPRESSION[lower] || value;
+}
+function normalizeOneShotTime(raw) {
+    const value = String(raw || "").trim();
+    if (!value) {
+        return {
+            ok: false,
+            error: "Invalid when time: expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z",
+        };
+    }
+    if (!ISO_DATETIME_WITH_TZ_REGEXP.test(value)) {
+        return {
+            ok: false,
+            error: `Invalid when time: "${value}" (expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z)`,
+        };
+    }
+    const ms = Date.parse(value);
+    if (!Number.isFinite(ms) || Number.isNaN(ms)) {
+        return {
+            ok: false,
+            error: `Invalid when time: "${value}" (expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z)`,
+        };
+    }
+    return { ok: true, value: new Date(ms).toISOString() };
+}
+/**
+ * 校验并归一化 when。
+ *
+ * 规则（中文）
+ * - `@manual`
+ * - cron / alias
+ * - `time:<ISO8601-with-timezone>`（一次性触发）
+ * - 兼容裸 ISO 时间输入，会归一化为 `time:<iso>`
+ */
+export function normalizeTaskWhen(input) {
+    const raw = String(input || "").trim();
+    if (!raw)
+        return { ok: false, error: "when cannot be empty" };
+    const lower = raw.toLowerCase();
+    if (lower === "@manual")
+        return { ok: true, value: "@manual" };
+    if (lower.startsWith("time:")) {
+        const timeRaw = raw.slice(raw.indexOf(":") + 1).trim();
+        const normalized = normalizeOneShotTime(timeRaw);
+        if (!normalized.ok)
+            return normalized;
+        return { ok: true, value: `time:${normalized.value}` };
+    }
+    if (ISO_DATETIME_WITH_TZ_REGEXP.test(raw)) {
+        const normalized = normalizeOneShotTime(raw);
+        if (!normalized.ok)
+            return normalized;
+        return { ok: true, value: `time:${normalized.value}` };
+    }
+    if (ISO_DATETIME_WITHOUT_TZ_REGEXP.test(raw)) {
+        return {
+            ok: false,
+            error: `Invalid when time: "${raw}" (expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z)`,
+        };
+    }
+    const cronExpression = normalizeCronExpression(raw);
+    if (!cronExpression)
+        return { ok: false, error: "when cannot be empty" };
+    const canonical = CRON_ALIAS_TO_EXPRESSION[lower] ? lower : raw;
+    if (cronExpression !== "@manual" && !cron.validate(cronExpression)) {
+        return { ok: false, error: `Invalid when (cron): "${raw}"` };
+    }
+    return { ok: true, value: canonical };
+}
+/**
+ * 兼容旧调用名：返回 cron 表达式或 `@manual`。
+ */
+export function normalizeTaskCronExpression(raw) {
+    const when = normalizeTaskWhen(raw);
+    if (!when.ok)
+        return null;
+    if (isTaskWhenOneShot(when.value))
+        return null;
+    return normalizeCronExpression(when.value);
+}
+export function isTaskWhenManual(input) {
+    const when = String(input || "").trim().toLowerCase();
+    return when === "@manual";
+}
+export function isTaskWhenOneShot(input) {
+    const when = String(input || "").trim().toLowerCase();
+    return when.startsWith("time:");
+}
+/**
+ * when -> cron expression；非 cron 返回 null。
+ */
+export function resolveTaskWhenCronExpression(input) {
+    const normalized = normalizeTaskWhen(input);
+    if (!normalized.ok)
+        return null;
+    if (isTaskWhenManual(normalized.value))
+        return null;
+    if (isTaskWhenOneShot(normalized.value))
+        return null;
+    return normalizeCronExpression(normalized.value);
+}
+/**
+ * when -> one-shot 毫秒时间戳；非 one-shot 返回 null。
+ */
+export function resolveTaskWhenOneShotMs(input) {
+    const normalized = normalizeTaskWhen(input);
+    if (!normalized.ok)
+        return null;
+    if (!isTaskWhenOneShot(normalized.value))
+        return null;
+    const iso = normalized.value.slice("time:".length).trim();
+    const ms = Date.parse(iso);
+    if (!Number.isFinite(ms) || Number.isNaN(ms))
+        return null;
+    return ms;
+}
+/**
+ * 归一化 task 状态。
+ */
+export function normalizeTaskStatus(input) {
+    const s = typeof input === "string" ? input.trim().toLowerCase() : "";
+    if (s === "enabled")
+        return "enabled";
+    if (s === "paused")
+        return "paused";
+    if (s === "disabled")
+        return "disabled";
+    return null;
+}
+/**
+ * 归一化 task 执行类型。
+ */
+export function normalizeTaskKind(input) {
+    const s = typeof input === "string" ? input.trim().toLowerCase() : "";
+    if (s === "script")
+        return "script";
+    return "agent";
+}
+/**
+ * 解析 task.md 为结构化定义。
+ */
+export function parseTaskMarkdown(params) {
+    const { taskId, markdown, taskMdPath, projectRoot } = params;
+    const text = String(markdown ?? "");
+    const { frontMatterYaml, body } = parseFrontMatter(text);
+    if (!frontMatterYaml || !frontMatterYaml.trim()) {
+        return { ok: false, error: "Missing YAML frontmatter (--- ... ---) in task.md" };
+    }
+    let meta = null;
+    try {
+        const loaded = yaml.load(frontMatterYaml);
+        if (loaded && typeof loaded === "object" && !Array.isArray(loaded)) {
+            meta = loaded;
+        }
+        else {
+            meta = null;
+        }
+    }
+    catch (e) {
+        return { ok: false, error: `Invalid YAML frontmatter: ${String(e)}` };
+    }
+    if (!meta || typeof meta !== "object") {
+        return { ok: false, error: "Invalid frontmatter: must be a YAML object" };
+    }
+    // 兼容已有任务定义：若无 when，则按旧字段推导。
+    const rawWhen = String(meta.when ?? "").trim();
+    if (!rawWhen) {
+        const rawTime = String(meta.time ?? "").trim();
+        const rawCron = String(meta.cron ?? "").trim();
+        if (rawTime) {
+            meta.when = `time:${rawTime}`;
+        }
+        else if (rawCron) {
+            meta.when = rawCron;
+        }
+    }
+    const missing = [];
+    const rawTitle = String(meta?.title ?? "").trim();
+    if (!rawTitle)
+        missing.push("title");
+    for (const f of REQUIRED_FIELDS.filter((x) => x !== "title")) {
+        if (meta?.[f] === undefined || meta?.[f] === null || String(meta?.[f]).trim() === "") {
+            missing.push(String(f));
+        }
+    }
+    if (missing.length > 0) {
+        return { ok: false, error: `Missing required frontmatter fields: ${missing.join(", ")}` };
+    }
+    const status = normalizeTaskStatus(meta.status);
+    if (!status) {
+        return {
+            ok: false,
+            error: `Invalid status: "${String(meta.status)}" (expected: enabled|paused|disabled)`,
+        };
+    }
+    const whenNormalized = normalizeTaskWhen(meta.when);
+    if (!whenNormalized.ok) {
+        return { ok: false, error: whenNormalized.error };
+    }
+    const kind = normalizeTaskKind(meta.kind);
+    const bodyText = String(body ?? "").trim();
+    if (kind === "script" && !bodyText) {
+        return { ok: false, error: "script task body cannot be empty" };
+    }
+    const fm = {
+        title: rawTitle,
+        when: whenNormalized.value,
+        description: String(meta.description).trim(),
+        sessionId: String(meta.sessionId).trim(),
+        kind,
+        ...(kind === "agent" && normalizeTaskReview(meta.review) === true ? { review: true } : {}),
+        status,
+    };
+    const relTaskMdPath = path
+        .relative(projectRoot, taskMdPath)
+        .split(path.sep)
+        .join("/");
+    const task = {
+        v: 1,
+        taskId,
+        frontmatter: fm,
+        body: String(body ?? "").trim(),
+        taskMdPath: relTaskMdPath,
+    };
+    return { ok: true, task };
+}
+/**
+ * 生成 task.md 文本。
+ */
+export function buildTaskMarkdown(params) {
+    const { frontmatter, body } = params;
+    const whenNormalized = normalizeTaskWhen(frontmatter.when);
+    if (!whenNormalized.ok) {
+        throw new Error(whenNormalized.error);
+    }
+    const kind = normalizeTaskKind(frontmatter.kind);
+    const bodyText = String(body ?? "").trim();
+    if (kind === "script" && !bodyText) {
+        throw new Error("script task body cannot be empty");
+    }
+    const meta = {
+        title: String(frontmatter.title || "").trim(),
+        when: whenNormalized.value,
+        description: String(frontmatter.description || "").trim(),
+        sessionId: String(frontmatter.sessionId || "").trim(),
+        kind,
+        ...(kind === "agent" ? { review: Boolean(frontmatter.review) } : {}),
+        status: String(frontmatter.status || "").trim(),
+    };
+    const yamlText = yaml.dump(meta, {
+        lineWidth: 120,
+        noRefs: true,
+    });
+    const bodyWithTrailingLf = bodyText ? bodyText + "\n" : "";
+    return `---\n${yamlText}---\n\n${bodyWithTrailingLf}`;
+}
+//# sourceMappingURL=Model.js.map

package/bin/services/task/runtime/Model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.js","sourceRoot":"","sources":["../../../../src/services/task/runtime/Model.ts"],"names":[],"mappings":"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"}

package/bin/services/task/runtime/Paths.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Task System paths and identifiers.
+ *
+ * 约定（中文）
+ * - task root: `./.downcity/task/`
+ * - definition: `./.downcity/task/<taskId>/task.md`
+ * - run dir: `./.downcity/task/<taskId>/<timestamp>/`
+ *
+ * 同时定义“task run sessionId”格式，用于把 Agent 的 sessionFacade 映射到 run 目录：
+ * - `task-run:<taskId>:<timestamp>`
+ */
+export declare function isValidTaskId(input: string): boolean;
+/**
+ * 从 title 派生 taskId。
+ *
+ * 关键点（中文）
+ * - 目标：保证“title 与 taskId 同源”，避免随机 ID。
+ * - 处理：移除路径危险字符与非常见标点，压缩空白，最终按 taskId 规则校验。
+ */
+export declare function deriveTaskIdFromTitle(title: string): string;
+export declare function normalizeTaskId(input: string): string;
+export declare function getTaskRootDir(projectRoot: string): string;
+export declare function getTaskDir(projectRoot: string, taskId: string): string;
+export declare function getTaskMdPath(projectRoot: string, taskId: string): string;
+export declare function formatTaskRunTimestamp(date?: Date): string;
+export declare function getTaskRunDir(projectRoot: string, taskId: string, timestamp: string): string;
+export declare function createTaskRunSessionId(taskId: string, timestamp: string): string;
+export declare function parseTaskRunSessionId(sessionId: string): {
+    taskId: string;
+    timestamp: string;
+} | null;
+//# sourceMappingURL=Paths.d.ts.map

package/bin/services/task/runtime/Paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../../../src/services/task/runtime/Paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAWtE;AAED,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU9C"}

package/bin/services/task/runtime/Paths.js

@@ -0,0 +1,103 @@
+/**
+ * Task System paths and identifiers.
+ *
+ * 约定（中文）
+ * - task root: `./.downcity/task/`
+ * - definition: `./.downcity/task/<taskId>/task.md`
+ * - run dir: `./.downcity/task/<taskId>/<timestamp>/`
+ *
+ * 同时定义“task run sessionId”格式，用于把 Agent 的 sessionFacade 映射到 run 目录：
+ * - `task-run:<taskId>:<timestamp>`
+ */
+import path from "node:path";
+/**
+ * taskId 允许字符：
+ * - 首字符：任意语言字母/数字
+ * - 后续：字母/数字/空格/下划线/连字符
+ */
+const TASK_ID_REGEXP = /^[\p{L}\p{N}][\p{L}\p{N}_\-\s]{0,63}$/u;
+export function isValidTaskId(input) {
+    const id = String(input || "").trim();
+    if (!id)
+        return false;
+    // 关键点（中文）：taskId 直接参与文件路径拼接，必须是安全的文件夹名。
+    return TASK_ID_REGEXP.test(id);
+}
+/**
+ * 从 title 派生 taskId。
+ *
+ * 关键点（中文）
+ * - 目标：保证“title 与 taskId 同源”，避免随机 ID。
+ * - 处理：移除路径危险字符与非常见标点，压缩空白，最终按 taskId 规则校验。
+ */
+export function deriveTaskIdFromTitle(title) {
+    const normalized = String(title || "")
+        .normalize("NFKC")
+        .replace(/[\\/:\u0000]/g, " ")
+        .replace(/[^\p{L}\p{N}_\-\s]/gu, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, 64)
+        .trim();
+    if (!normalized) {
+        throw new Error("Cannot derive taskId from title: title is empty after normalization.");
+    }
+    return normalizeTaskId(normalized);
+}
+export function normalizeTaskId(input) {
+    const id = String(input || "").trim();
+    if (!isValidTaskId(id)) {
+        throw new Error(`Invalid taskId: "${id}". Use a letter/number first, then letters/numbers/space/_/-, max 64 chars.`);
+    }
+    return id;
+}
+export function getTaskRootDir(projectRoot) {
+    return path.join(String(projectRoot || "").trim(), ".downcity", "task");
+}
+export function getTaskDir(projectRoot, taskId) {
+    return path.join(getTaskRootDir(projectRoot), normalizeTaskId(taskId));
+}
+export function getTaskMdPath(projectRoot, taskId) {
+    return path.join(getTaskDir(projectRoot, taskId), "task.md");
+}
+export function formatTaskRunTimestamp(date = new Date()) {
+    const pad = (n, width) => String(n).padStart(width, "0");
+    // 关键点（中文）：run 目录名统一使用 UTC，避免跨时区/DST 下时间排序歧义。
+    const yyyy = date.getUTCFullYear();
+    const mm = pad(date.getUTCMonth() + 1, 2);
+    const dd = pad(date.getUTCDate(), 2);
+    const hh = pad(date.getUTCHours(), 2);
+    const mi = pad(date.getUTCMinutes(), 2);
+    const ss = pad(date.getUTCSeconds(), 2);
+    const ms = pad(date.getUTCMilliseconds(), 3);
+    return `${yyyy}${mm}${dd}-${hh}${mi}${ss}-${ms}`;
+}
+export function getTaskRunDir(projectRoot, taskId, timestamp) {
+    const ts = String(timestamp || "").trim();
+    if (!ts)
+        throw new Error("timestamp is required");
+    return path.join(getTaskDir(projectRoot, taskId), ts);
+}
+export function createTaskRunSessionId(taskId, timestamp) {
+    const id = normalizeTaskId(taskId);
+    const ts = String(timestamp || "").trim();
+    if (!ts)
+        throw new Error("timestamp is required");
+    return `task-run:${id}:${ts}`;
+}
+export function parseTaskRunSessionId(sessionId) {
+    const key = String(sessionId || "").trim();
+    if (!key)
+        return null;
+    const m = key.match(/^task-run:([^:]+):(.+)$/);
+    if (!m)
+        return null;
+    const taskId = String(m[1] || "").trim();
+    const timestamp = String(m[2] || "").trim();
+    if (!taskId || !timestamp)
+        return null;
+    if (!isValidTaskId(taskId))
+        return null;
+    return { taskId, timestamp };
+}
+//# sourceMappingURL=Paths.js.map

package/bin/services/task/runtime/Paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paths.js","sourceRoot":"","sources":["../../../../src/services/task/runtime/Paths.ts"],"names":[],"mappings":"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"}

package/bin/services/task/runtime/Runner.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Task runner。
+ *
+ * 职责（中文）
+ * - 创建 run 目录（timestamp）。
+ * - 以“干净历史”调用当前 runtime 的 LocalSessionCore（逻辑与正常 chat 一致）。
+ * - 协调 script / agent 两类执行主链。
+ * - 把最终产物写入 run 目录的具体格式委托给 `TaskRunArtifacts.ts`。
+ */
+import type { AgentContext } from "../../../types/agent/AgentContext.js";
+import type { ShipTaskRunExecutionStatusV1, ShipTaskRunResultStatusV1, ShipTaskRunStatusV1, ShipTaskRunTriggerV1 } from "../../task/types/Task.js";
+/**
+ * 立即执行任务定义。
+ *
+ * 算法流程（中文）
+ * 1) 解析 task + 创建 run 目录。
+ * 2) 在 scheduler 上下文里执行 agent/script。
+ * 3) 产物落盘（messages.jsonl / output.md / result.md / error.md / run.json）。
+ */
+export declare function runTaskNow(params: {
+    context: AgentContext;
+    taskId: string;
+    trigger: ShipTaskRunTriggerV1;
+    executionId?: string;
+    projectRoot?: string;
+}): Promise<{
+    ok: boolean;
+    status: ShipTaskRunStatusV1;
+    executionStatus: ShipTaskRunExecutionStatusV1;
+    resultStatus: ShipTaskRunResultStatusV1;
+    resultErrors: string[];
+    dialogueRounds: number;
+    userSimulatorSatisfied: boolean;
+    userSimulatorReply?: string;
+    userSimulatorReason?: string;
+    userSimulatorScore?: number;
+    taskId: string;
+    executionId: string;
+    timestamp: string;
+    runDir: string;
+    runDirRel: string;
+}>;
+//# sourceMappingURL=Runner.d.ts.map

package/bin/services/task/runtime/Runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Runner.d.ts","sourceRoot":"","sources":["../../../../src/services/task/runtime/Runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAKlE,OAAO,KAAK,EAEV,4BAA4B,EAC5B,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AA+CtC;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,oBAAoB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IACV,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,mBAAmB,CAAC;IAC5B,eAAe,EAAE,4BAA4B,CAAC;IAC9C,YAAY,EAAE,yBAAyB,CAAC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CA2cD"}