@downcity/plugins 1.0.4

package/bin/task/runtime/TaskRunnerSession.d.ts

@@ -0,0 +1,48 @@
+/**
+ * TaskRunnerSession：task runner 的 session 装配模块。
+ *
+ * 关键点（中文）
+ * - 负责构建 task 专用 Executor / JsonlSessionHistoryStore 运行时。
+ * - 负责把每轮 user/assistant 消息写入 run 目录对应的 messages.jsonl。
+ * - 这些能力与任务编排逻辑解耦后，task 主流程会更聚焦于状态流转。
+ * - 当前只有 api 执行模式。
+ */
+import type { LanguageModel } from "ai";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { SessionRunResult } from "@downcity/agent/internal/executor/types/SessionRun.js";
+import type { TaskSessionRuntimePort } from "../../task/runtime/TaskRunnerTypes.js";
+/**
+ * 把 task round 的 user query 落盘到对应 run context。
+ */
+export declare function appendTaskRoundUserMessage(params: {
+    taskSessionRuntime: TaskSessionRuntimePort;
+    sessionId: string;
+    taskId: string;
+    query: string;
+    actorId: string;
+    actorName: string;
+}): Promise<void>;
+/**
+ * 构建 task 专用 Session 运行时（独立于普通 Session 实例缓存）。
+ *
+ * 关键点（中文）
+ * - 使用 Executor 执行，但模型显式来自“任务绑定 session”的 session 级配置。
+ * - task runner 自己维护独立 history，不复用原 session 的消息落盘。
+ */
+export declare function createTaskSessionRuntimePort(params: {
+    context: AgentContext;
+    model: LanguageModel;
+    runDirAbs: string;
+    runSessionId: string;
+    userSimulatorSessionId: string;
+}): TaskSessionRuntimePort;
+/**
+ * 把 task session 的 assistant 消息落盘到对应 run context history Store。
+ */
+export declare function appendTaskAssistantMessage(params: {
+    taskSessionRuntime: TaskSessionRuntimePort;
+    sessionId: string;
+    taskId: string;
+    rawResult: SessionRunResult;
+}): Promise<void>;
+//# sourceMappingURL=TaskRunnerSession.d.ts.map

package/bin/task/runtime/TaskRunnerSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRunnerSession.d.ts","sourceRoot":"","sources":["../../../src/task/runtime/TaskRunnerSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAEjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uDAAuD,CAAC;AAC9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAUhF;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;CAChC,GAAG,sBAAsB,CAsGzB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/bin/task/runtime/TaskRunnerSession.js

@@ -0,0 +1,153 @@
+/**
+ * TaskRunnerSession：task runner 的 session 装配模块。
+ *
+ * 关键点（中文）
+ * - 负责构建 task 专用 Executor / JsonlSessionHistoryStore 运行时。
+ * - 负责把每轮 user/assistant 消息写入 run 目录对应的 messages.jsonl。
+ * - 这些能力与任务编排逻辑解耦后，task 主流程会更聚焦于状态流转。
+ * - 当前只有 api 执行模式。
+ */
+import path from "node:path";
+import { Executor } from "@downcity/agent/internal/executor/Executor.js";
+import { drainDeferredPersistedUserMessages } from "@downcity/agent/internal/executor/SessionRunScope.js";
+import { JsonlSessionHistoryComposer } from "@downcity/agent/internal/executor/composer/history/jsonl/JsonlSessionHistoryComposer.js";
+import { JsonlSessionHistoryStore } from "@downcity/agent/internal/executor/store/history/jsonl/JsonlSessionHistoryStore.js";
+import { JsonlSessionCompactionComposer } from "@downcity/agent/internal/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+import { LocalSessionContextComposer } from "@downcity/agent/internal/executor/composer/context/LocalSessionContextComposer.js";
+import { DefaultSessionSystemComposer } from "@downcity/agent/internal/executor/composer/system/default/DefaultSessionSystemComposer.js";
+import { shellTools } from "@downcity/agent/internal/executor/tools/shell/ShellToolDefinition.js";
+/**
+ * 把 task round 的 user query 落盘到对应 run context。
+ */
+export async function appendTaskRoundUserMessage(params) {
+    const text = String(params.query || "").trim();
+    if (!text)
+        return;
+    const historyStore = params.taskSessionRuntime.getHistoryStore(params.sessionId);
+    await historyStore.append(historyStore.userText({
+        text,
+        metadata: {
+            sessionId: params.sessionId,
+            extra: {
+                taskId: params.taskId,
+                actorId: params.actorId,
+                actorName: params.actorName,
+            },
+        },
+    }));
+}
+/**
+ * 构建 task 专用 Session 运行时（独立于普通 Session 实例缓存）。
+ *
+ * 关键点（中文）
+ * - 使用 Executor 执行，但模型显式来自“任务绑定 session”的 session 级配置。
+ * - task runner 自己维护独立 history，不复用原 session 的消息落盘。
+ */
+export function createTaskSessionRuntimePort(params) {
+    const { context, model, runDirAbs, runSessionId, userSimulatorSessionId, } = params;
+    const compactionComposer = new JsonlSessionCompactionComposer({
+        keepLastMessages: context.config.context?.messages?.keepLastMessages,
+        maxInputTokensApprox: context.config.context?.messages?.maxInputTokensApprox,
+        archiveOnCompact: context.config.context?.messages?.archiveOnCompact,
+        compactRatio: context.config.context?.messages?.compactRatio,
+    });
+    const systemComposer = new DefaultSessionSystemComposer({
+        projectRoot: context.rootPath,
+        getStaticSystemPrompts: () => context.systems,
+        getContext: () => context,
+        profile: "task",
+    });
+    const historyStoresBySessionId = new Map();
+    const historyComposersBySessionId = new Map();
+    const runtimesBySessionId = new Map();
+    const resolveTaskHistoryStore = (sessionId) => {
+        const existing = historyStoresBySessionId.get(sessionId);
+        if (existing)
+            return existing;
+        const key = String(sessionId || "").trim();
+        if (!key) {
+            throw new Error("TaskSessionRuntimePort requires a non-empty sessionId");
+        }
+        const runMessagesDirPath = key === runSessionId
+            ? runDirAbs
+            : key === userSimulatorSessionId
+                ? path.join(runDirAbs, "user-simulator")
+                : undefined;
+        const created = new JsonlSessionHistoryStore({
+            rootPath: context.rootPath,
+            sessionId: key,
+            ...(runMessagesDirPath
+                ? {
+                    paths: {
+                        sessionDirPath: runMessagesDirPath,
+                        messagesDirPath: runMessagesDirPath,
+                        messagesFilePath: path.join(runMessagesDirPath, "messages.jsonl"),
+                        metaFilePath: path.join(runMessagesDirPath, "meta.json"),
+                        archiveDirPath: path.join(runMessagesDirPath, "archive"),
+                    },
+                }
+                : {}),
+        });
+        historyStoresBySessionId.set(key, created);
+        return created;
+    };
+    const resolveTaskHistoryComposer = (sessionId) => {
+        const key = String(sessionId || "").trim();
+        const existing = historyComposersBySessionId.get(key);
+        if (existing)
+            return existing;
+        const created = new JsonlSessionHistoryComposer({
+            store: resolveTaskHistoryStore(key),
+        });
+        historyComposersBySessionId.set(key, created);
+        return created;
+    };
+    return {
+        getHistoryStore(sessionId) {
+            return resolveTaskHistoryStore(sessionId);
+        },
+        getExecutor(sessionId) {
+            const key = String(sessionId || "").trim();
+            if (!key) {
+                throw new Error("TaskSessionRuntimePort.getExecutor requires a non-empty sessionId");
+            }
+            const existing = runtimesBySessionId.get(key);
+            if (existing)
+                return existing;
+            const historyStore = resolveTaskHistoryStore(key);
+            const historyComposer = resolveTaskHistoryComposer(key);
+            const contextComposer = new LocalSessionContextComposer({
+                sessionId: key,
+                getTools: () => shellTools,
+            });
+            const created = new Executor({
+                sessionId: key,
+                getModel: () => model,
+                logger: context.logger,
+                historyStore,
+                historyComposer,
+                compactionComposer,
+                contextComposer,
+                systemComposer,
+                getTools: () => shellTools,
+            });
+            runtimesBySessionId.set(key, created);
+            return created;
+        },
+    };
+}
+/**
+ * 把 task session 的 assistant 消息落盘到对应 run context history Store。
+ */
+export async function appendTaskAssistantMessage(params) {
+    const { taskSessionRuntime, sessionId, rawResult } = params;
+    const historyStore = taskSessionRuntime.getHistoryStore(sessionId);
+    if (rawResult.assistantMessage) {
+        await historyStore.append(rawResult.assistantMessage);
+    }
+    const deferredUserMessages = drainDeferredPersistedUserMessages(sessionId);
+    for (const deferred of deferredUserMessages) {
+        await historyStore.append(deferred);
+    }
+}
+//# sourceMappingURL=TaskRunnerSession.js.map

package/bin/task/runtime/TaskRunnerSession.js.map

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

package/bin/task/runtime/TaskRunnerTypes.d.ts

@@ -0,0 +1,186 @@
+/**
+ * TaskRunner 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 task runner 在拆分后跨模块共享的内部类型。
+ * - 这些类型服务于 task 运行链路，统一归档到 `src/types/task/`。
+ */
+import type { JsonlSessionHistoryStore } from "@downcity/agent/internal/executor/store/history/jsonl/JsonlSessionHistoryStore.js";
+import type { SessionExecutor } from "@downcity/agent/internal/executor/types/SessionExecutor.js";
+import type { ShipTaskRunExecutionStatusV1, ShipTaskRunProgressPhaseV1, ShipTaskRunProgressStatusV1, ShipTaskRunResultStatusV1, ShipTaskRunStatusV1 } from "../../task/types/Task.js";
+/**
+ * run-progress.json 的当前快照状态。
+ */
+export type RunProgressSnapshot = {
+    /**
+     * 当前进度状态。
+     */
+    status: ShipTaskRunProgressStatusV1;
+    /**
+     * 当前进度阶段。
+     */
+    phase: ShipTaskRunProgressPhaseV1;
+    /**
+     * 当前阶段对人类可读的说明文本。
+     */
+    message: string;
+    /**
+     * 当前对话轮次。
+     */
+    round?: number;
+    /**
+     * 最大允许轮次。
+     */
+    maxRounds?: number;
+    /**
+     * 运行结束时间（毫秒时间戳）。
+     */
+    endedAt?: number;
+    /**
+     * 任务总体运行状态。
+     */
+    runStatus?: ShipTaskRunStatusV1;
+    /**
+     * 执行阶段状态。
+     */
+    executionStatus?: ShipTaskRunExecutionStatusV1;
+    /**
+     * 结果校验状态。
+     */
+    resultStatus?: ShipTaskRunResultStatusV1;
+};
+/**
+ * 任务结果校验结果。
+ */
+export type TaskResultValidation = {
+    /**
+     * 结果校验后的状态。
+     */
+    resultStatus: ShipTaskRunResultStatusV1;
+    /**
+     * 校验失败时的错误列表。
+     */
+    errors: string[];
+};
+/**
+ * 模拟用户的判定结果。
+ */
+export type UserSimulatorDecision = {
+    /**
+     * 模拟用户是否认为当前结果已满足要求。
+     */
+    satisfied: boolean;
+    /**
+     * 模拟用户给出的回复文本。
+     */
+    reply: string;
+    /**
+     * 判定理由。
+     */
+    reason: string;
+    /**
+     * 可选评分，范围通常为 0-10。
+     */
+    score?: number;
+    /**
+     * 原始输出文本快照。
+     */
+    raw: string;
+};
+/**
+ * 单轮对话的落盘记录。
+ */
+export type DialogueRoundRecord = {
+    /**
+     * 当前任务是否启用了 review 多轮模式。
+     */
+    reviewEnabled: boolean;
+    /**
+     * 当前轮次编号。
+     */
+    round: number;
+    /**
+     * 本轮执行器收到的 query。
+     */
+    executorQuery: string;
+    /**
+     * 本轮执行器输出文本。
+     */
+    executorOutput: string;
+    /**
+     * 本轮执行器是否通过 `chat_send` 等方式实际送达文本。
+     */
+    executorDelivered: boolean;
+    /**
+     * 执行器 assistantMessage 的调试快照。
+     */
+    executorAssistantMessageSnapshot?: string;
+    /**
+     * 本轮结果校验状态。
+     */
+    validationResultStatus: ShipTaskRunResultStatusV1;
+    /**
+     * 本轮规则校验失败项。
+     */
+    ruleErrors: string[];
+    /**
+     * 模拟用户收到的 query。
+     */
+    userSimulatorQuery?: string;
+    /**
+     * 模拟用户输出文本。
+     */
+    userSimulatorOutput?: string;
+    /**
+     * 模拟用户 assistantMessage 的调试快照。
+     */
+    userSimulatorAssistantMessageSnapshot?: string;
+    /**
+     * 模拟用户最终判定结果。
+     */
+    userSimulator: UserSimulatorDecision;
+    /**
+     * 传递给下一轮执行器的反馈文本。
+     */
+    feedbackForNextRound?: string;
+};
+/**
+ * script 类型任务的执行结果。
+ */
+export type ScriptExecutionResult = {
+    /**
+     * script 标准输出与标准错误合并后的文本。
+     */
+    outputText: string;
+};
+/**
+ * task 运行专用的 session runtime 端口。
+ *
+ * 关键点（中文）
+ * - task runner 不直接依赖具体 SDK `Session` 实现。
+ * - 这里暴露的是 task 场景最小可用端口：执行器 + history Store。
+ */
+export type TaskSessionRuntimePort = {
+    /**
+     * 获取指定 sessionId 对应的 Session 执行端口。
+     */
+    getExecutor(sessionId: string): SessionExecutor;
+    /**
+     * 获取指定 sessionId 对应的 JsonlSessionHistoryStore。
+     */
+    getHistoryStore(sessionId: string): JsonlSessionHistoryStore;
+};
+/**
+ * 从 assistant 输出中提取的文本结果。
+ */
+export type ChatSendOutputPick = {
+    /**
+     * 最终提取到的文本内容。
+     */
+    text: string;
+    /**
+     * 该文本是否已经通过 chat_send 等方式送达。
+     */
+    delivered: boolean;
+};
+//# sourceMappingURL=TaskRunnerTypes.d.ts.map

package/bin/task/runtime/TaskRunnerTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRunnerTypes.d.ts","sourceRoot":"","sources":["../../../src/task/runtime/TaskRunnerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mFAAmF,CAAC;AAClI,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4DAA4D,CAAC;AAClG,OAAO,KAAK,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,MAAM,EAAE,2BAA2B,CAAC;IACpC;;OAEG;IACH,KAAK,EAAE,0BAA0B,CAAC;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;OAEG;IACH,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C;;OAEG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAC;CAC1C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,YAAY,EAAE,yBAAyB,CAAC;IACxC;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C;;OAEG;IACH,sBAAsB,EAAE,yBAAyB,CAAC;IAClD;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,qCAAqC,CAAC,EAAE,MAAM,CAAC;IAC/C;;OAEG;IACH,aAAa,EAAE,qBAAqB,CAAC;IACrC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAAC;IAChD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,CAAC;CAC9D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/bin/task/runtime/TaskRunnerTypes.js

@@ -0,0 +1,9 @@
+/**
+ * TaskRunner 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 task runner 在拆分后跨模块共享的内部类型。
+ * - 这些类型服务于 task 运行链路，统一归档到 `src/types/task/`。
+ */
+export {};
+//# sourceMappingURL=TaskRunnerTypes.js.map

package/bin/task/runtime/TaskRunnerTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRunnerTypes.js","sourceRoot":"","sources":["../../../src/task/runtime/TaskRunnerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/task/types/Cron.d.ts

@@ -0,0 +1,16 @@
+/**
+ * cron 触发定义。
+ */
+export type TaskCronTriggerDefinition = {
+    id: string;
+    expression: string;
+    timezone?: string;
+    execute: () => Promise<void> | void;
+};
+/**
+ * cron 引擎端口。
+ */
+export type TaskCronEngine = {
+    register(definition: TaskCronTriggerDefinition): void;
+};
+//# sourceMappingURL=Cron.d.ts.map

package/bin/task/types/Cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cron.d.ts","sourceRoot":"","sources":["../../../src/task/types/Cron.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACvD,CAAC"}

package/bin/task/types/Cron.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Cron.js.map

package/bin/task/types/Cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cron.js","sourceRoot":"","sources":["../../../src/task/types/Cron.ts"],"names":[],"mappings":""}

package/bin/task/types/Task.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Task System domain 类型。
+ *
+ * 关键点（中文）
+ * - task 定义使用 markdown + frontmatter
+ * - 每次执行产出 run 目录用于审计
+ */
+export type ShipTaskStatus = "enabled" | "paused" | "disabled";
+export type ShipTaskKind = "agent" | "script";
+export type ShipTaskFrontmatterV1 = {
+    /** 任务名称（唯一语义标识；对外统一使用 title） */
+    title: string;
+    /** 触发条件：`@manual`、cron 表达式，或 `time:<ISO8601-with-timezone>` */
+    when: string;
+    /** 任务描述（给执行器的意图说明） */
+    description: string;
+    /** 任务执行会话标识（sessionId） */
+    sessionId: string;
+    /** 任务执行类型（agent=交给 agent 执行；script=直接执行 task 正文脚本） */
+    kind?: ShipTaskKind;
+    /** 是否启用 review 多轮复核（仅 `kind=agent` 生效；默认 false，false 时单轮执行） */
+    review?: boolean;
+    /** 启停状态 */
+    status: ShipTaskStatus;
+};
+export type ShipTaskDefinitionV1 = {
+    /** schema 版本 */
+    v: 1;
+    /** 稳定任务键（与 title 同值，用于目录与运行上下文） */
+    taskId: string;
+    /** task.md frontmatter */
+    frontmatter: ShipTaskFrontmatterV1;
+    /** 任务正文（可直接作为执行 prompt） */
+    body: string;
+    /** 相对项目根目录的 task.md 路径 */
+    taskMdPath: string;
+};
+export type ShipTaskRunTriggerV1 = {
+    type: "cron";
+} | {
+    type: "time";
+} | {
+    type: "manual";
+    reason?: string;
+};
+export type ShipTaskRunStatusV1 = "success" | "failure" | "skipped";
+export type ShipTaskRunExecutionStatusV1 = "success" | "failure" | "skipped";
+export type ShipTaskRunResultStatusV1 = "valid" | "invalid" | "not_checked";
+export type ShipTaskRunProgressStatusV1 = "running" | "success" | "failure";
+/**
+ * 执行进度阶段（用于 Console 实时展示）。
+ */
+export type ShipTaskRunProgressPhaseV1 = "preparing" | "script_running" | "agent_executor_round" | "agent_user_simulator_round" | "validating" | "writing_artifacts" | "completed";
+/**
+ * 单条进度事件。
+ */
+export type ShipTaskRunProgressEventV1 = {
+    /** 事件时间（ms） */
+    at: number;
+    /** 当前阶段 */
+    phase: ShipTaskRunProgressPhaseV1;
+    /** 阶段说明 */
+    message: string;
+    /** 当前轮次（agent 场景可选） */
+    round?: number;
+    /** 最大轮次（agent 场景可选） */
+    maxRounds?: number;
+};
+/**
+ * 运行中进度快照（run-progress.json）。
+ */
+export type ShipTaskRunProgressV1 = {
+    /** schema 版本 */
+    v: 1;
+    /** taskId */
+    taskId: string;
+    /** run 时间戳目录名 */
+    timestamp: string;
+    /** 触发来源 */
+    trigger: ShipTaskRunTriggerV1;
+    /** 任务类型 */
+    kind: ShipTaskKind;
+    /** 当前进度状态 */
+    status: ShipTaskRunProgressStatusV1;
+    /** 当前阶段 */
+    phase: ShipTaskRunProgressPhaseV1;
+    /** 当前阶段说明 */
+    message: string;
+    /** 开始时间（ms） */
+    startedAt: number;
+    /** 最近更新时间（ms） */
+    updatedAt: number;
+    /** 结束时间（ms，完成后可选） */
+    endedAt?: number;
+    /** 最终 run 状态（完成后可选） */
+    runStatus?: ShipTaskRunStatusV1;
+    /** 最终执行状态（完成后可选） */
+    executionStatus?: ShipTaskRunExecutionStatusV1;
+    /** 最终结果校验状态（完成后可选） */
+    resultStatus?: ShipTaskRunResultStatusV1;
+    /** 当前轮次（agent 场景可选） */
+    round?: number;
+    /** 最大轮次（agent 场景可选） */
+    maxRounds?: number;
+    /** 最近进度事件（仅保留有限窗口） */
+    events: ShipTaskRunProgressEventV1[];
+};
+export type ShipTaskRunMetaV1 = {
+    /** schema 版本 */
+    v: 1;
+    /** 任务 ID */
+    taskId: string;
+    /** 本次 run 时间戳（目录名） */
+    timestamp: string;
+    /** 本次执行唯一 ID */
+    executionId: string;
+    /** 任务执行会话标识 */
+    sessionId: string;
+    /** 触发来源 */
+    trigger: ShipTaskRunTriggerV1;
+    /** 最终状态（综合执行阶段 + 结果校验） */
+    status: ShipTaskRunStatusV1;
+    /** 执行阶段状态（agent run 是否成功） */
+    executionStatus: ShipTaskRunExecutionStatusV1;
+    /** 结果校验状态（产物/输出是否满足要求） */
+    resultStatus: ShipTaskRunResultStatusV1;
+    /** 结果校验错误摘要（可选） */
+    resultErrors?: string[];
+    /** 实际执行的双边对话轮数 */
+    dialogueRounds: number;
+    /** 模拟用户在最终轮是否判定“满意” */
+    userSimulatorSatisfied: boolean;
+    /** 模拟用户的最终回复（可选） */
+    userSimulatorReply?: string;
+    /** 模拟用户的最终理由（可选） */
+    userSimulatorReason?: string;
+    /** 模拟用户的最终评分（0-10，可选） */
+    userSimulatorScore?: number;
+    /** 开始时间（ms） */
+    startedAt: number;
+    /** 结束时间（ms） */
+    endedAt: number;
+    /** 失败摘要（可选） */
+    error?: string;
+};
+//# sourceMappingURL=Task.d.ts.map

package/bin/task/types/Task.d.ts.map

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

package/bin/task/types/Task.js

@@ -0,0 +1,9 @@
+/**
+ * Task System domain 类型。
+ *
+ * 关键点（中文）
+ * - task 定义使用 markdown + frontmatter
+ * - 每次执行产出 run 目录用于审计
+ */
+export {};
+//# sourceMappingURL=Task.js.map

package/bin/task/types/Task.js.map

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