downcity 1.1.90 → 1.1.94

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "downcity",
-  "version": "1.1.90",
+  "version": "1.1.94",
   "type": "module",
   "description": "Downcity CLI bundle — installs city and town commands",
   "bin": {
@@ -45,9 +45,9 @@
     "prompts": "^2.4.2",
     "ws": "^8.21.0",
     "zod": "^4.4.3",
-    "@downcity/agent": "^1.1.74",
-    "@downcity/city": "^0.2.36",
-    "@downcity/plugins": "^1.0.30"
+    "@downcity/agent": "^1.1.79",
+    "@downcity/city": "^0.2.40",
+    "@downcity/plugins": "^1.0.34"
   },
   "scripts": {
     "build": "node scripts/copy-cli-products.mjs && node scripts/ensure-cli-executable.mjs",

package/town/agent/control/CommonHelpers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 单 agent control API 通用 helper。
+ *
+ * 关键点（中文）
+ * - 聚合 control 路由、query/path/文本裁剪等基础工具。
+ * - 单 agent 控制面统一收敛到 `/api/control/*`。
+ * - 不依赖任何业务状态。
+ */
+/**
+ * 单 agent control API 的公开路由前缀。
+ *
+ * 说明（中文）
+ * - 单 agent 控制面只暴露 `/api/control/*`。
+ */
+export declare const CONTROL_API_ROUTE_PREFIXES: readonly ["/api/control"];
+/**
+ * 为同一个 control 端点生成公开路径别名。
+ */
+export declare function buildControlRouteAliases(suffix: string): string[];
+/**
+ * 解析 limit 参数并做边界裁剪。
+ */
+export declare function toLimit(raw: string | undefined, fallback?: number): number;
+/**
+ * 转成可选字符串。
+ */
+export declare function toOptionalString(input: unknown): string | undefined;
+/**
+ * 安全 decodeURIComponent。
+ */
+export declare function decodeMaybe(value: string): string;
+/**
+ * 文本截断。
+ */
+export declare function truncateText(text: string, maxChars: number): string;
+//# sourceMappingURL=CommonHelpers.d.ts.map

package/town/agent/control/CommonHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommonHelpers.d.ts","sourceRoot":"","sources":["../../../src/agent/control/CommonHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,2BAA4B,CAAC;AAEpE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjE;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,SAAgB,GACvB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAInE"}

package/town/agent/control/CommonHelpers.js

@@ -0,0 +1,63 @@
+/**
+ * 单 agent control API 通用 helper。
+ *
+ * 关键点（中文）
+ * - 聚合 control 路由、query/path/文本裁剪等基础工具。
+ * - 单 agent 控制面统一收敛到 `/api/control/*`。
+ * - 不依赖任何业务状态。
+ */
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 500;
+/**
+ * 单 agent control API 的公开路由前缀。
+ *
+ * 说明（中文）
+ * - 单 agent 控制面只暴露 `/api/control/*`。
+ */
+export const CONTROL_API_ROUTE_PREFIXES = ["/api/control"];
+/**
+ * 为同一个 control 端点生成公开路径别名。
+ */
+export function buildControlRouteAliases(suffix) {
+    const normalizedSuffix = String(suffix || "").startsWith("/")
+        ? String(suffix || "")
+        : `/${String(suffix || "")}`;
+    return CONTROL_API_ROUTE_PREFIXES.map((prefix) => `${prefix}${normalizedSuffix}`);
+}
+/**
+ * 解析 limit 参数并做边界裁剪。
+ */
+export function toLimit(raw, fallback = DEFAULT_LIMIT) {
+    const n = Number.parseInt(String(raw || "").trim(), 10);
+    if (!Number.isFinite(n) || Number.isNaN(n))
+        return fallback;
+    return Math.max(1, Math.min(MAX_LIMIT, n));
+}
+/**
+ * 转成可选字符串。
+ */
+export function toOptionalString(input) {
+    const value = typeof input === "string" ? input.trim() : "";
+    return value ? value : undefined;
+}
+/**
+ * 安全 decodeURIComponent。
+ */
+export function decodeMaybe(value) {
+    try {
+        return decodeURIComponent(String(value || ""));
+    }
+    catch {
+        return String(value || "");
+    }
+}
+/**
+ * 文本截断。
+ */
+export function truncateText(text, maxChars) {
+    const normalized = String(text || "");
+    if (normalized.length <= maxChars)
+        return normalized;
+    return normalized.slice(0, Math.max(0, maxChars - 3)) + "...";
+}
+//# sourceMappingURL=CommonHelpers.js.map

package/town/agent/control/CommonHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommonHelpers.js","sourceRoot":"","sources":["../../../src/agent/control/CommonHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,cAAc,CAAU,CAAC;AAEpE;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAC3D,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/B,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,gBAAgB,EAAE,CAAC,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,GAAuB,EACvB,QAAQ,GAAG,aAAa;IAExB,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACtC,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,UAAU,CAAC;IACrD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAChE,CAAC"}

package/town/agent/control/ExecuteBySession.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Control execute by session helper。
+ *
+ * 关键点（中文）
+ * - control 层只负责把请求转成 session prompt。
+ * - chat / queue 等渠道语义由宿主显式注入的 plugin 自行实现。
+ */
+import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
+import type { ControlSessionExecuteAttachmentInput } from "../../agent/control/types/ControlSessionExecute.js";
+/**
+ * 在指定 session 中执行一轮请求。
+ *
+ * 说明（中文）
+ * - 按普通 session 同步执行。
+ */
+export declare function executeBySessionId(params: {
+    agentState: AgentRuntime;
+    sessionId: string;
+    instructions: string;
+    attachments?: ControlSessionExecuteAttachmentInput[];
+}): Promise<{
+    assistantMessage: import("@downcity/agent/internal/executor/types/SessionMessages.js").SessionMessageV1 | undefined;
+    userVisible: string;
+    queued: boolean;
+    error?: string | undefined;
+    success: boolean;
+}>;
+//# sourceMappingURL=ExecuteBySession.d.ts.map

package/town/agent/control/ExecuteBySession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteBySession.d.ts","sourceRoot":"","sources":["../../../src/agent/control/ExecuteBySession.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,gDAAgD,CAAC;AAG3G;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,UAAU,EAAE,YAAY,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,oCAAoC,EAAE,CAAC;CACtD;;;;;;GA0BA"}

package/town/agent/control/ExecuteBySession.js

@@ -0,0 +1,41 @@
+/**
+ * Control execute by session helper。
+ *
+ * 关键点（中文）
+ * - control 层只负责把请求转成 session prompt。
+ * - chat / queue 等渠道语义由宿主显式注入的 plugin 自行实现。
+ */
+import { buildExecuteInputText } from "./ExecuteInput.js";
+/**
+ * 在指定 session 中执行一轮请求。
+ *
+ * 说明（中文）
+ * - 按普通 session 同步执行。
+ */
+export async function executeBySessionId(params) {
+    const sessionId = String(params.sessionId || "").trim();
+    const instructions = String(params.instructions || "").trim();
+    if (!sessionId)
+        throw new Error("Missing sessionId");
+    if (!instructions)
+        throw new Error("Missing instructions");
+    const executeInput = await buildExecuteInputText({
+        projectRoot: params.agentState.rootPath,
+        sessionId,
+        instructions,
+        attachments: params.attachments,
+    });
+    const session = params.agentState.getSession(sessionId);
+    const turn = await session.prompt({
+        query: executeInput,
+    });
+    const result = await turn.finished;
+    return {
+        success: result.success,
+        ...(result.error ? { error: result.error } : {}),
+        assistantMessage: result.assistantMessage,
+        userVisible: result.text.trim(),
+        queued: false,
+    };
+}
+//# sourceMappingURL=ExecuteBySession.js.map

package/town/agent/control/ExecuteBySession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteBySession.js","sourceRoot":"","sources":["../../../src/agent/control/ExecuteBySession.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAKxC;IACC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACrD,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAE3D,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC;QAC/C,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ;QACvC,SAAS;QACT,YAAY;QACZ,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;QAChC,KAAK,EAAE,YAAY;KACpB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;IAEnC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}

package/town/agent/control/ExecuteInput.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Control execute 输入拼装 helper。
+ *
+ * 关键点（中文）
+ * - 负责把 API 传入的附件规范化并落盘。
+ * - 最终统一转成 `<file>` 标签注入到 user message。
+ */
+import type { ControlSessionExecuteAttachmentInput } from "../../agent/control/types/ControlSessionExecute.js";
+/**
+ * 构造 execute 入站文本。
+ */
+export declare function buildExecuteInputText(params: {
+    projectRoot: string;
+    sessionId: string;
+    instructions: string;
+    attachments?: ControlSessionExecuteAttachmentInput[];
+}): Promise<string>;
+//# sourceMappingURL=ExecuteInput.d.ts.map

package/town/agent/control/ExecuteInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteInput.d.ts","sourceRoot":"","sources":["../../../src/agent/control/ExecuteInput.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,oCAAoC,EAErC,MAAM,gDAAgD,CAAC;AA0KxD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,oCAAoC,EAAE,CAAC;CACtD,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB"}

package/town/agent/control/ExecuteInput.js

@@ -0,0 +1,201 @@
+/**
+ * Control execute 输入拼装 helper。
+ *
+ * 关键点（中文）
+ * - 负责把 API 传入的附件规范化并落盘。
+ * - 最终统一转成 `<file>` 标签注入到 user message。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { getCacheDirPath } from "../../config/Paths.js";
+import { renderChatMessageFileTag } from "@downcity/agent/internal/executor/messages/ChatMessageMarkup.js";
+const EXECUTE_ATTACHMENT_MAX_COUNT = 8;
+const EXECUTE_ATTACHMENT_MAX_BYTES = 2 * 1024 * 1024;
+const EXECUTE_ATTACHMENT_CONTENT_MAX_CHARS = 1_500_000;
+const EXECUTE_ATTACHMENT_FALLBACK_TEXT = "请查看以上附件并按用户要求处理。";
+function normalizeExecuteAttachmentType(value) {
+    const raw = String(value || "")
+        .trim()
+        .toLowerCase();
+    if (raw === "photo" ||
+        raw === "voice" ||
+        raw === "audio" ||
+        raw === "video") {
+        return raw;
+    }
+    return "document";
+}
+function normalizeAttachmentCaption(value) {
+    const text = String(value || "")
+        .replace(/\r?\n+/g, " ")
+        .replace(/\s+/g, " ")
+        .replace(/\|/g, "/")
+        .trim();
+    if (!text)
+        return undefined;
+    return text.slice(0, 180);
+}
+function toProjectRelativePath(projectRoot, absPath) {
+    const relative = path.relative(projectRoot, absPath);
+    if (!relative)
+        return null;
+    if (relative.startsWith(".."))
+        return null;
+    if (path.isAbsolute(relative))
+        return null;
+    return relative.split(path.sep).join("/");
+}
+function normalizeAttachmentFileName(params) {
+    const raw = String(params.fileName || "").trim();
+    const base = (raw || "attachment")
+        .replace(/[\\/:*?"<>|]/g, "-")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^\.+/, "")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 72);
+    const safeBase = base || "attachment";
+    const fallbackExt = params.fallbackExt.startsWith(".")
+        ? params.fallbackExt
+        : `.${params.fallbackExt}`;
+    const hasExt = /\.[A-Za-z0-9]+$/.test(safeBase);
+    return hasExt ? safeBase : `${safeBase}${fallbackExt}`;
+}
+function inferAttachmentExt(params) {
+    const fromFileName = path.extname(String(params.fileName || "").trim())
+        .toLowerCase()
+        .trim();
+    if (fromFileName)
+        return fromFileName;
+    const contentType = String(params.contentType || "").toLowerCase();
+    if (contentType.includes("markdown"))
+        return ".md";
+    if (contentType.includes("json"))
+        return ".json";
+    if (contentType.includes("html"))
+        return ".html";
+    if (contentType.includes("plain"))
+        return ".txt";
+    if (params.type === "photo")
+        return ".jpg";
+    if (params.type === "voice" || params.type === "audio")
+        return ".mp3";
+    if (params.type === "video")
+        return ".mp4";
+    return ".md";
+}
+async function resolveAttachmentPathFromInput(params) {
+    const rawPath = String(params.attachment.path || "").trim();
+    if (!rawPath)
+        return null;
+    const abs = path.isAbsolute(rawPath)
+        ? path.normalize(rawPath)
+        : path.resolve(params.projectRoot, rawPath);
+    const relative = toProjectRelativePath(params.projectRoot, abs);
+    if (!relative)
+        return null;
+    const stat = await fs
+        .stat(abs)
+        .then((value) => value)
+        .catch(() => null);
+    if (!stat?.isFile())
+        return null;
+    return relative;
+}
+function resolveAttachmentBytes(attachment) {
+    const textContent = typeof attachment.content === "string" ? attachment.content : "";
+    if (textContent) {
+        const clipped = textContent.slice(0, EXECUTE_ATTACHMENT_CONTENT_MAX_CHARS);
+        return Buffer.from(clipped, "utf8");
+    }
+    const base64 = String(attachment.contentBase64 || "").trim();
+    if (!base64)
+        return null;
+    try {
+        return Buffer.from(base64, "base64");
+    }
+    catch {
+        return null;
+    }
+}
+async function materializeAttachmentContent(params) {
+    const bytes = resolveAttachmentBytes(params.attachment);
+    if (!bytes || bytes.length <= 0)
+        return null;
+    if (bytes.length > EXECUTE_ATTACHMENT_MAX_BYTES) {
+        throw new Error(`Attachment too large (>${EXECUTE_ATTACHMENT_MAX_BYTES} bytes)`);
+    }
+    const type = normalizeExecuteAttachmentType(params.attachment.type);
+    const ext = inferAttachmentExt({
+        type,
+        fileName: params.attachment.fileName,
+        contentType: params.attachment.contentType,
+    });
+    const safeName = normalizeAttachmentFileName({
+        fileName: params.attachment.fileName,
+        fallbackExt: ext,
+    });
+    const safeContext = String(params.sessionId || "session")
+        .replace(/[^A-Za-z0-9_-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 32);
+    const prefix = safeContext || "context";
+    const fileName = `${Date.now()}-${prefix}-${String(params.index + 1).padStart(2, "0")}-${safeName}`;
+    const cacheDir = path.join(getCacheDirPath(params.projectRoot), "chrome-extension");
+    await fs.ensureDir(cacheDir);
+    const absPath = path.join(cacheDir, fileName);
+    await fs.writeFile(absPath, bytes);
+    return toProjectRelativePath(params.projectRoot, absPath);
+}
+function toAttachmentLine(params) {
+    return renderChatMessageFileTag({
+        type: params.type,
+        path: params.relativePath,
+        ...(params.caption ? { caption: params.caption } : {}),
+    });
+}
+/**
+ * 构造 execute 入站文本。
+ */
+export async function buildExecuteInputText(params) {
+    const instructions = String(params.instructions || "").trim();
+    const inputAttachments = Array.isArray(params.attachments)
+        ? params.attachments.slice(0, EXECUTE_ATTACHMENT_MAX_COUNT)
+        : [];
+    if (inputAttachments.length === 0)
+        return instructions;
+    const lines = [];
+    for (let index = 0; index < inputAttachments.length; index += 1) {
+        const attachment = inputAttachments[index];
+        if (!attachment || typeof attachment !== "object")
+            continue;
+        const type = normalizeExecuteAttachmentType(attachment.type);
+        const caption = normalizeAttachmentCaption(attachment.caption);
+        const reusePath = await resolveAttachmentPathFromInput({
+            projectRoot: params.projectRoot,
+            attachment,
+        });
+        const relativePath = reusePath ||
+            (await materializeAttachmentContent({
+                projectRoot: params.projectRoot,
+                sessionId: params.sessionId,
+                attachment,
+                index,
+            }));
+        if (!relativePath)
+            continue;
+        lines.push(toAttachmentLine({
+            type,
+            relativePath,
+            ...(caption ? { caption } : {}),
+        }));
+    }
+    if (lines.length === 0)
+        return instructions;
+    return [lines.join("\n"), instructions || EXECUTE_ATTACHMENT_FALLBACK_TEXT]
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
+}
+//# sourceMappingURL=ExecuteInput.js.map

package/town/agent/control/ExecuteInput.js.map

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

package/town/agent/control/Helpers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Control helper 聚合出口。
+ *
+ * 关键点（中文）
+ * - 兼容控制面路由层的统一 import 路径。
+ * - 具体实现已拆分到独立子模块，避免单文件继续膨胀。
+ */
+export { toLimit, toOptionalString, decodeMaybe } from "./CommonHelpers.js";
+export { buildExecuteInputText } from "./ExecuteInput.js";
+export { loadSessionMessagesFromFile, resolveUiMessagePreview, toUiMessageTimeline, } from "./MessageTimeline.js";
+export { listControlSessionSummaries } from "./SessionSummaryStore.js";
+export { TASK_RUN_DIR_REGEX, listTaskRuns, readRecentLogs, readTaskRunDetail, } from "./TaskStore.js";
+//# sourceMappingURL=Helpers.d.ts.map

package/town/agent/control/Helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Helpers.d.ts","sourceRoot":"","sources":["../../../src/agent/control/Helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/town/agent/control/Helpers.js

@@ -0,0 +1,13 @@
+/**
+ * Control helper 聚合出口。
+ *
+ * 关键点（中文）
+ * - 兼容控制面路由层的统一 import 路径。
+ * - 具体实现已拆分到独立子模块，避免单文件继续膨胀。
+ */
+export { toLimit, toOptionalString, decodeMaybe } from "./CommonHelpers.js";
+export { buildExecuteInputText } from "./ExecuteInput.js";
+export { loadSessionMessagesFromFile, resolveUiMessagePreview, toUiMessageTimeline, } from "./MessageTimeline.js";
+export { listControlSessionSummaries } from "./SessionSummaryStore.js";
+export { TASK_RUN_DIR_REGEX, listTaskRuns, readRecentLogs, readTaskRunDetail, } from "./TaskStore.js";
+//# sourceMappingURL=Helpers.js.map

package/town/agent/control/Helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Helpers.js","sourceRoot":"","sources":["../../../src/agent/control/Helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/town/agent/control/MessageTimeline.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Control 消息时间线 helper。
+ *
+ * 关键点（中文）
+ * - 负责把上下文消息映射成 control UI 可视时间线。
+ * - 同时提供消息文件读取能力。
+ */
+import type { SessionMessageV1 } from "@downcity/agent/internal/executor/types/SessionMessages.js";
+import type { ControlTimelineEvent } from "../../agent/control/types/ControlViewData.js";
+/**
+ * 转成 control 时间线。
+ */
+export declare function toUiMessageTimeline(message: SessionMessageV1): ControlTimelineEvent[];
+/**
+ * 读取 session 消息文件。
+ */
+export declare function loadSessionMessagesFromFile(filePath: string): Promise<SessionMessageV1[]>;
+/**
+ * 读取适合摘要展示的消息预览文本。
+ */
+export declare function resolveUiMessagePreview(message: SessionMessageV1): string;
+//# sourceMappingURL=MessageTimeline.d.ts.map

package/town/agent/control/MessageTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageTimeline.d.ts","sourceRoot":"","sources":["../../../src/agent/control/MessageTimeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,4DAA4D,CAAC;AAGpE,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,0CAA0C,CAAC;AAmI1G;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,GACxB,oBAAoB,EAAE,CAiFxB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB7B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAEzE"}