@downcity/agent 1.1.320 → 1.1.324

package/bin/types/store/SessionAttachmentStore.js

@@ -0,0 +1,15 @@
+/**
+ * Session 附件持久化能力。
+ *
+ * Session Message 只保存附件引用，附件内容由该 Store 在 Session 生命周期内持有。
+ *
+ * 数据边界（中文）：
+ * - 输入边界：`session.prompt()` 接收 `type: "file"`、`mediaType` 和 Data URL。
+ * - 存储边界：Store 解码 Data URL，写入 `.downcity/.../attachments/att_<id>.<ext>`。
+ * - Message 边界：Session Message 只记录相对 Workspace 根目录的附件路径。
+ * - 模型边界：模型转换器读取该路径，在内存中恢复成模型需要的文件内容。
+ *
+ * 因此，Data URL 不会直接进入 JSONL Message；Session Message 是附件路径的唯一引用。
+ */
+export {};
+//# sourceMappingURL=SessionAttachmentStore.js.map

package/bin/types/store/SessionAttachmentStore.js.map

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

package/bin/types/store/SessionStore.d.ts

@@ -8,6 +8,7 @@
 import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
 import type { SessionAssistantMessage, SessionMessage } from "../../types/session/SessionMessage.js";
 import type { SessionMessageStorageStats, SessionSegmentRange, SessionSegmentSnapshot, SessionSegmentSummary } from "../../types/session/SessionSegment.js";
+import type { SessionAttachmentStore } from "../../types/store/SessionAttachmentStore.js";
 /** 在 Message Store 写事务中创建新消息所需的稳定状态。 */
 export interface SessionMessageCommitState {
     /** 下一条真实 Message 应使用的全局线性顺序。 */
@@ -68,6 +69,8 @@ export interface SessionStore {
     readonly session_id: string;
     /** 当前 Session 的 Message 持久化能力。 */
     readonly messages: SessionMessageStore;
+    /** 当前 Session 的附件持久化能力。 */
+    readonly attachments: SessionAttachmentStore;
     /** 读取 Session Metadata；不存在时返回规范化的初始值。 */
     read_metadata(): Promise<SessionHistoryMetaV1>;
     /** 原子写入完整 Session Metadata。 */

package/bin/types/store/SessionStore.d.ts.map

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

package/bin/workspace/store/LocalSessionAttachmentStore.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Workspace 内 Session 附件的本地实现。
+ *
+ * Data URL 在这里解码为文件；Message 层只接收相对 Workspace 根目录的文件引用。
+ */
+import type { FileSystem } from "../../types/workspace/FileSystem.js";
+import type { SessionAttachmentStore } from "../../types/store/SessionAttachmentStore.js";
+export interface LocalSessionAttachmentStoreOptions {
+    /** Workspace 文件能力。 */
+    files: FileSystem;
+    /** 当前 Session 附件目录的绝对路径。 */
+    attachments_dir_path: string;
+}
+/** Session 附件本地持久化实现。 */
+export declare class LocalSessionAttachmentStore implements SessionAttachmentStore {
+    private readonly files;
+    private readonly attachments_dir_path;
+    constructor(options: LocalSessionAttachmentStoreOptions);
+    persist_data_url(input: {
+        data_url: string;
+        media_type: string;
+        filename?: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=LocalSessionAttachmentStore.d.ts.map

package/bin/workspace/store/LocalSessionAttachmentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessionAttachmentStore.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalSessionAttachmentStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAetF,MAAM,WAAW,kCAAkC;IACjD,sBAAsB;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,4BAA4B;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,yBAAyB;AACzB,qBAAa,2BAA4B,YAAW,sBAAsB;IACxE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,OAAO,EAAE,kCAAkC;IAKjD,gBAAgB,CAAC,KAAK,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;CASpB"}

package/bin/workspace/store/LocalSessionAttachmentStore.js

@@ -0,0 +1,72 @@
+/**
+ * Workspace 内 Session 附件的本地实现。
+ *
+ * Data URL 在这里解码为文件；Message 层只接收相对 Workspace 根目录的文件引用。
+ */
+import path from "node:path";
+import { generate_id } from "../../utils/Id.js";
+const DATA_URL_PATTERN = /^data:([^;,]+)?((?:;[^;,]+)*),(.*)$/s;
+const MEDIA_TYPE_EXTENSIONS = {
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/webp": ".webp",
+    "image/gif": ".gif",
+    "video/mp4": ".mp4",
+    "video/quicktime": ".mov",
+    "video/webm": ".webm",
+    "application/pdf": ".pdf",
+};
+/** Session 附件本地持久化实现。 */
+export class LocalSessionAttachmentStore {
+    files;
+    attachments_dir_path;
+    constructor(options) {
+        this.files = options.files;
+        this.attachments_dir_path = path.resolve(options.attachments_dir_path);
+    }
+    async persist_data_url(input) {
+        const parsed = parse_data_url(input.data_url, input.media_type);
+        const extension = resolve_extension(parsed.media_type, input.filename);
+        const attachment_name = `att_${generate_id()}${extension}`;
+        const absolute_path = path.join(this.attachments_dir_path, attachment_name);
+        await this.files.ensure_directory(this.attachments_dir_path);
+        await this.files.write_file_atomically(absolute_path, parsed.bytes);
+        return path.relative(this.files.root_path, absolute_path);
+    }
+}
+function parse_data_url(data_url, fallback_media_type) {
+    const match = DATA_URL_PATTERN.exec(String(data_url || "").trim());
+    if (!match)
+        throw new Error("Invalid data URL");
+    const media_type = String(match[1] || fallback_media_type || "").trim();
+    if (!media_type || !media_type.includes("/")) {
+        throw new Error("Data URL requires a valid media type");
+    }
+    const metadata = String(match[2] || "");
+    const payload = String(match[3] || "");
+    try {
+        const normalized_payload = payload.replace(/\s/g, "");
+        if (metadata.includes(";base64") &&
+            (!/^[A-Za-z0-9+/]*={0,2}$/.test(normalized_payload) ||
+                normalized_payload.length % 4 === 1)) {
+            throw new Error("invalid base64 payload");
+        }
+        return {
+            media_type,
+            bytes: metadata.includes(";base64")
+                ? Buffer.from(normalized_payload, "base64")
+                : Buffer.from(decodeURIComponent(payload), "utf8"),
+        };
+    }
+    catch (error) {
+        throw new Error(`Invalid data URL payload: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function resolve_extension(media_type, filename) {
+    const known = MEDIA_TYPE_EXTENSIONS[media_type.toLowerCase()];
+    if (known)
+        return known;
+    const filename_extension = path.extname(String(filename || "")).toLowerCase();
+    return /^[.][a-z0-9]{1,10}$/.test(filename_extension) ? filename_extension : ".bin";
+}
+//# sourceMappingURL=LocalSessionAttachmentStore.js.map

package/bin/workspace/store/LocalSessionAttachmentStore.js.map

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

package/bin/workspace/store/LocalSessionStore.d.ts

@@ -9,12 +9,15 @@ import { JsonlSessionMessageStore } from "../../workspace/store/JsonlSessionMess
 import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
 import type { SessionStore } from "../../types/store/SessionStore.js";
 import type { LocalSessionStoreOptions } from "../../types/store/LocalStore.js";
+import { LocalSessionAttachmentStore } from "../../workspace/store/LocalSessionAttachmentStore.js";
 /** 本地 Session Store。 */
 export declare class LocalSessionStore implements SessionStore {
     /** 当前 Session 的稳定标识。 */
     readonly session_id: string;
     /** 当前 Session 的 JSONL Message Store。 */
     readonly messages: JsonlSessionMessageStore;
+    /** 当前 Session 的附件持久化能力。 */
+    readonly attachments: LocalSessionAttachmentStore;
     /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
     private readonly files;
     /** 当前 Agent 的稳定标识。 */

package/bin/workspace/store/LocalSessionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalSessionStore.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalSessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AAQzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,wBAAwB;AACxB,qBAAa,iBAAkB,YAAW,YAAY;IACpD,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAE5C,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,wBAAwB;IAoB7C,8BAA8B;IACxB,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAWpD,6BAA6B;IACvB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,0BAA0B;IACpB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzC,sBAAsB;IAChB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKhD,sBAAsB;IAChB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,kDAAkD;IAClD,OAAO,CAAC,gBAAgB;IAQxB,6CAA6C;IAC7C,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"LocalSessionStore.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalSessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AASzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAE/F,wBAAwB;AACxB,qBAAa,iBAAkB,YAAW,YAAY;IACpD,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAE5C,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAElD,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,wBAAwB;IA4B7C,8BAA8B;IACxB,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAWpD,6BAA6B;IACvB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,0BAA0B;IACpB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzC,sBAAsB;IAChB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKhD,sBAAsB;IAChB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,kDAAkD;IAClD,OAAO,CAAC,gBAAgB;IAQxB,6CAA6C;IAC7C,OAAO,CAAC,aAAa;CAOtB"}

package/bin/workspace/store/LocalSessionStore.js

@@ -6,14 +6,17 @@
  * - Session 领域只持有本对象，不再自行拼接任何存储路径。
  */
 import { JsonlSessionMessageStore } from "../../workspace/store/JsonlSessionMessageStore.js";
-import { get_sdk_agent_session_instruction_path, get_sdk_agent_session_meta_path, get_sdk_agent_session_assistant_message_path, get_sdk_agent_session_messages_path, } from "../../workspace/store/LocalStorePaths.js";
+import { get_sdk_agent_session_instruction_path, get_sdk_agent_session_meta_path, get_sdk_agent_session_assistant_message_path, get_sdk_agent_session_messages_path, get_sdk_agent_session_attachments_dir_path, } from "../../workspace/store/LocalStorePaths.js";
 import { normalize_session_metadata } from "../../session/storage/Metadata.js";
+import { LocalSessionAttachmentStore } from "../../workspace/store/LocalSessionAttachmentStore.js";
 /** 本地 Session Store。 */
 export class LocalSessionStore {
     /** 当前 Session 的稳定标识。 */
     session_id;
     /** 当前 Session 的 JSONL Message Store。 */
     messages;
+    /** 当前 Session 的附件持久化能力。 */
+    attachments;
     /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
     files;
     /** 当前 Agent 的稳定标识。 */
@@ -28,6 +31,10 @@ export class LocalSessionStore {
             file_path: get_sdk_agent_session_messages_path(this.files.root_path, this.agent_id, this.session_id),
             assistant_message_file_path: get_sdk_agent_session_assistant_message_path(this.files.root_path, this.agent_id, this.session_id),
         });
+        this.attachments = new LocalSessionAttachmentStore({
+            files: this.files,
+            attachments_dir_path: get_sdk_agent_session_attachments_dir_path(this.files.root_path, this.agent_id, this.session_id),
+        });
     }
     /** 读取规范化 Session Metadata。 */
     async read_metadata() {

package/bin/workspace/store/LocalSessionStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalSessionStore.js","sourceRoot":"","sources":["../../../src/workspace/store/LocalSessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,4CAA4C,EAC5C,mCAAmC,GACpC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAM3E,wBAAwB;AACxB,MAAM,OAAO,iBAAiB;IAC5B,wBAAwB;IACf,UAAU,CAAS;IAE5B,wCAAwC;IAC/B,QAAQ,CAA2B;IAE5C,oDAAoD;IACnC,KAAK,CAAa;IAEnC,sBAAsB;IACL,QAAQ,CAAS;IAElC,YAAY,OAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAwB,CAAC;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,mCAAmC,CAC5C,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB;YACD,2BAA2B,EAAE,4CAA4C,CACvE,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB;SACF,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnC,CAAC;YACnC,OAAO,0BAA0B,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,0BAA0B,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,cAAc,CAAC,QAA8B;QACjD,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CACpC,IAAI,CAAC,aAAa,EAAE,EACpB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACzC,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,eAAe;QACnB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChF,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,iBAAiB,CAAC,WAAmB;QACzC,MAAM,gBAAgB,GAAG,sCAAsC,CAC7D,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,kDAAkD;IAC1C,gBAAgB;QACtB,OAAO,sCAAsC,CAC3C,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAED,6CAA6C;IACrC,aAAa;QACnB,OAAO,+BAA+B,CACpC,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"LocalSessionStore.js","sourceRoot":"","sources":["../../../src/workspace/store/LocalSessionStore.ts"],"names":[],"mappings":"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"}

package/bin/workspace/store/LocalStorePaths.d.ts

@@ -61,6 +61,12 @@ export declare function get_sdk_agent_session_instruction_path(workspace_path: s
  * 单个 session 的消息目录路径。
  */
 export declare function get_sdk_agent_session_messages_dir_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个 Session 的附件目录路径。
+ *
+ * 附件与 Session 目录同生命周期，归档或删除 Session 时随目录一起迁移或清理。
+ */
+export declare function get_sdk_agent_session_attachments_dir_path(workspace_path: string, agent_id: string, session_id: string): string;
 /**
  * 单个 session 的 Active JSONL 文件路径。
  */

package/bin/workspace/store/LocalStorePaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalStorePaths.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalStorePaths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,gDAAgD,CAC9D,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,4CAA4C,CAC1D,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CACpD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,4CAA4C,CAC1D,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR"}
+{"version":3,"file":"LocalStorePaths.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalStorePaths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,gDAAgD,CAC9D,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,4CAA4C,CAC1D,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CACpD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,4CAA4C,CAC1D,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR"}

package/bin/workspace/store/LocalStorePaths.js

@@ -86,6 +86,14 @@ export function get_sdk_agent_session_instruction_path(workspace_path, agent_id,
 export function get_sdk_agent_session_messages_dir_path(workspace_path, agent_id, session_id) {
     return path.join(get_sdk_agent_session_dir_path(workspace_path, agent_id, session_id), "messages");
 }
+/**
+ * 单个 Session 的附件目录路径。
+ *
+ * 附件与 Session 目录同生命周期，归档或删除 Session 时随目录一起迁移或清理。
+ */
+export function get_sdk_agent_session_attachments_dir_path(workspace_path, agent_id, session_id) {
+    return path.join(get_sdk_agent_session_dir_path(workspace_path, agent_id, session_id), "attachments");
+}
 /**
  * 单个 session 的 Active JSONL 文件路径。
  */

package/bin/workspace/store/LocalStorePaths.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalStorePaths.js","sourceRoot":"","sources":["../../../src/workspace/store/LocalStorePaths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LocalStorePaths.js","sourceRoot":"","sources":["../../../src/workspace/store/LocalStorePaths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,cAAsB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,cAAsB;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAsB,EACtB,QAAgB;IAEhB,OAAO,IAAI,CAAC,IAAI,CACd,4BAA4B,CAAC,cAAc,CAAC,EAC5C,kBAAkB,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC,CAClD,cAAsB,EACtB,QAAgB;IAEhB,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wCAAwC,CACtD,cAAsB,EACtB,QAAgB;IAEhB,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC1F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uCAAuC,CACrD,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,wCAAwC,CAAC,cAAc,EAAE,QAAQ,CAAC,EAClE,kBAAkB,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CACpD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gDAAgD,CAC9D,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,uCAAuC,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EAC7E,UAAU,CACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4CAA4C,CAC1D,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,gDAAgD,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EACtF,cAAc,CACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wCAAwC,CACtD,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,gDAAgD,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EACtF,WAAW,CACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,oCAAoC,CAAC,cAAc,EAAE,QAAQ,CAAC,EAC9D,kBAAkB,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CACpD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sCAAsC,CACpD,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,8BAA8B,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EACpE,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uCAAuC,CACrD,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,8BAA8B,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EACpE,UAAU,CACX,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0CAA0C,CACxD,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,8BAA8B,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EACpE,aAAa,CACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC,CACjD,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,uCAAuC,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EAC7E,cAAc,CACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,uCAAuC,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EAC7E,WAAW,CACZ,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4CAA4C,CAC1D,cAAsB,EACtB,QAAgB,EAChB,UAAkB;IAElB,OAAO,IAAI,CAAC,IAAI,CACd,uCAAuC,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC,EAC7E,wBAAwB,CACzB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.320",
+  "version": "1.1.324",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与本机 RPC 能力",
   "main": "./bin/index.js",

package/scripts/session-attachments.test.mjs

@@ -0,0 +1,101 @@
+/**
+ * @file 验证 Session prompt 的 Data URL 附件会先落盘，再以路径持久化。
+ */
+
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { LocalFileSystem } from "../bin/workspace/LocalFileSystem.js";
+import { LocalSessionStore } from "../bin/workspace/store/LocalSessionStore.js";
+import { SessionMessages } from "../bin/session/SessionMessages.js";
+
+async function create_harness() {
+  const root_path = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-session-attachment-"));
+  const files = new LocalFileSystem(root_path);
+  const store = new LocalSessionStore({
+    files,
+    agent_id: "attachment-test-agent",
+    session_id: "attachment-test-session",
+  });
+  const messages = new SessionMessages({
+    session_id: "attachment-test-session",
+    store: store.messages,
+    attachment_store: store.attachments,
+    publish: () => {},
+  });
+  await messages.initialize();
+  return { root_path, store, messages };
+}
+
+test("Data URL 先保存为 Session 附件，Message 只保存相对路径", async () => {
+  const harness = await create_harness();
+  const result = await harness.messages.append_prompt_message({
+    turn_id: "turn-1",
+    input_type: "prompt",
+    prompt: {
+      query: [{
+        type: "file",
+        mediaType: "image/png",
+        url: "data:image/png;base64,aGVsbG8=",
+        filename: "diagram.png",
+      }],
+    },
+    project_root: harness.root_path,
+  });
+
+  const part = result.parts[0];
+  assert.equal(part.type, "file");
+  assert.match(part.url, /^\.downcity\/agents\/attachment-test-agent\/sessions\/attachment-test-session\/attachments\/att_/);
+  assert.equal(part.url.endsWith(".png"), true);
+  assert.equal(
+    (await fs.readFile(path.join(harness.root_path, part.url))).toString(),
+    "hello",
+  );
+  assert.equal(part.url.includes("base64"), false);
+});
+
+test("视频 Data URL 使用 MIME 类型和扩展名落盘", async () => {
+  const harness = await create_harness();
+  const result = await harness.messages.append_prompt_message({
+    turn_id: "turn-1",
+    input_type: "prompt",
+    prompt: {
+      query: [{
+        type: "file",
+        mediaType: "video/mp4",
+        url: "data:video/mp4;base64,AQID",
+        filename: "demo.mp4",
+      }],
+    },
+    project_root: harness.root_path,
+  });
+
+  const part = result.parts[0];
+  assert.equal(part.url.endsWith(".mp4"), true);
+  assert.deepEqual(
+    [...await fs.readFile(path.join(harness.root_path, part.url))],
+    [1, 2, 3],
+  );
+});
+
+test("无效 Data URL 不会写入 Session Message", async () => {
+  const harness = await create_harness();
+  await assert.rejects(
+    harness.messages.append_prompt_message({
+      turn_id: "turn-1",
+      input_type: "prompt",
+      prompt: {
+        query: [{
+          type: "file",
+          mediaType: "image/png",
+          url: "data:image/png;base64",
+        }],
+      },
+      project_root: harness.root_path,
+    }),
+    /Invalid data URL/,
+  );
+  assert.deepEqual(await harness.store.messages.list_messages(), []);
+});

package/scripts/session-list-title.test.mjs

@@ -72,6 +72,12 @@ async function create_agent_with_titled_session(input) {
   await session.append_user_message({
     text: input.first_user_text,
   });
+  const title_deadline = Date.now() + 1000;
+  while (Date.now() < title_deadline) {
+    if ((await session.get_info()).title === input.title) break;
+    await new Promise((resolve) => setTimeout(resolve, 10));
+  }
+  assert.equal((await session.get_info()).title, input.title);
 
   return {
     agent,

package/scripts/session-title-event.test.mjs

@@ -79,6 +79,30 @@ function create_failing_title_model() {
   });
 }
 
+function create_delayed_title_model(title_text) {
+  let resolve_started;
+  let resolve_release;
+  const started = new Promise((resolve) => {
+    resolve_started = resolve;
+  });
+  const released = new Promise((resolve) => {
+    resolve_release = resolve;
+  });
+  const model = new MockLanguageModelV3({
+    modelId: "mock-session-title-delayed-model",
+    doStream: async () => {
+      resolve_started();
+      await released;
+      return create_stream_text_result(title_text);
+    },
+  });
+  return {
+    model,
+    started,
+    release: () => resolve_release(),
+  };
+}
+
 async function read_log_lines(agent_path) {
   const logs_path = path.join(agent_path, ".downcity", "logs");
   const entries = await fs.readdir(logs_path);
@@ -91,6 +115,15 @@ async function read_log_lines(agent_path) {
   return lines;
 }
 
+async function wait_for_title(session, expected_title) {
+  const deadline = Date.now() + 1000;
+  while (Date.now() < deadline) {
+    if ((await session.get_info()).title === expected_title) return;
+    await new Promise((resolve) => setTimeout(resolve, 10));
+  }
+  assert.equal((await session.get_info()).title, expected_title);
+}
+
 test("Session keeps title empty when no model is available", async () => {
   const agent_path = await fs.mkdtemp(
     path.join(os.tmpdir(), "downcity-agent-session-title-"),
@@ -123,6 +156,29 @@ test("Session keeps title empty when no model is available", async () => {
   }
 });
 
+test("Session title generation does not block user message append", async () => {
+  const agent_path = await fs.mkdtemp(
+    path.join(os.tmpdir(), "downcity-agent-session-title-async-"),
+  );
+  const delayed = create_delayed_title_model("异步标题");
+  const agent = new Agent({
+    id: "title_async_agent",
+    workspace: new Workspace({ path: agent_path }),
+    model: delayed.model,
+  });
+  const session = await agent.sessions.create();
+
+  try {
+    await session.append_user_message({ text: "标题生成不应阻塞消息写入" });
+    await delayed.started;
+    assert.equal((await session.get_info()).title, undefined);
+    delayed.release();
+    await wait_for_title(session, "异步标题");
+  } finally {
+    await agent.dispose();
+  }
+});
+
 test("Session logs title generation failure without blocking the session", async () => {
   const agent_path = await fs.mkdtemp(
     path.join(os.tmpdir(), "downcity-agent-session-title-log-"),
@@ -142,8 +198,16 @@ test("Session logs title generation failure without blocking the session", async
 
     assert.equal((await session.get_info()).title, undefined);
 
-    await agent.get_logger().save_all_logs();
-    const log_lines = await read_log_lines(agent_path);
+    let log_lines = [];
+    const log_deadline = Date.now() + 1000;
+    while (Date.now() < log_deadline) {
+      await agent.get_logger().save_all_logs();
+      log_lines = await read_log_lines(agent_path);
+      if (log_lines.some((line) => line.includes("session_title.generate_failed"))) {
+        break;
+      }
+      await new Promise((resolve) => setTimeout(resolve, 10));
+    }
     const title_failure_log = log_lines
       .map((line) => JSON.parse(line))
       .find((entry) => entry.message.includes("session_title.generate_failed"));
@@ -196,7 +260,7 @@ test("Session retries title generation after model becomes available", async ()
       text: "Need another prompt to trigger the retry path",
     });
 
-    assert.equal((await session.get_info()).title, "排查 session 标题");
+    await wait_for_title(session, "排查 session 标题");
   } finally {
     unsubscribe();
     await agent.dispose();

package/scripts/session-turn-failure.test.mjs

@@ -45,8 +45,9 @@ async function create_turn_harness(execute_turn) {
     compact_history: async () => ({ compacted: false, reason: "nothing_to_compact" }),
     state: {
       ensure_runnable: async () => {},
-      ensure_title_from_history: async () => {},
+      schedule_title_generation: () => {},
       touch_metadata: async () => {},
+      touch_metadata_in_background: () => {},
     },
     messages,
     events: new SessionEventHub(),
@@ -137,6 +138,38 @@ test("Provider 在部分输出后失败时保留 failed Assistant 并追加 Erro
   assert.equal(page.items[2].message, "stream interrupted");
 });
 
+test("Assistant 失败收口时不会遗留 input-streaming Tool Part", async () => {
+  const { messages, turn } = await create_turn_harness(async (turn_context) => {
+    await turn_context.output.assistant.begin_step();
+    await turn_context.output.assistant.write_chunk({
+      type: "tool-input-start",
+      toolCallId: "call-1",
+      toolName: "shell_exec",
+    });
+    await turn_context.output.assistant.write_chunk({
+      type: "tool-input-delta",
+      toolCallId: "call-1",
+      inputTextDelta: '{"cmd":"pwd"}',
+    });
+    return {
+      success: false,
+      text: "",
+      error: "stream interrupted",
+      deferred_persisted_user_messages: [],
+    };
+  });
+
+  const handle = await turn.prompt({ query: "hello" });
+  await handle.finished;
+  const page = await messages.list_messages();
+  const assistant = page.items.find((message) => message.type === "assistant");
+
+  assert.equal(assistant?.status, "failed");
+  assert.equal(assistant?.parts[0]?.type, "tool");
+  assert.equal(assistant?.parts[0]?.state, "failed");
+  assert.equal(assistant?.parts[0]?.error, "stream interrupted");
+});
+
 test("Turn 使用 step canonical chunks 保持 Tool 与最终正文顺序", async () => {
   const { messages, turn } = await create_turn_harness(async (turn_context) => {
     await turn_context.output.assistant.begin_step();

package/src/agent/Agent.ts

@@ -206,6 +206,7 @@ export class Agent {
   async dispose(): Promise<void> {
     this.unsubscribe_workspace_env();
     this.unsubscribe_plugin_change();
+    this.sessions.dispose_title_generation();
     try {
       await this.state.dispose();
     } finally {

package/src/agent/AgentSessions.ts

@@ -133,6 +133,13 @@ export class AgentSessions implements AgentSessionsContract<AgentSession> {
     return this.list_executing_session_ids().length;
   }
 
+  /** 释放全部缓存 Session 的标题后台任务。 */
+  dispose_title_generation(): void {
+    for (const session of this.sessions_by_id.values()) {
+      session.dispose_title_generation?.();
+    }
+  }
+
   /**
    * 把 Agent env 修改广播到已有 Session 的统一输入队列。
    */
@@ -228,6 +235,7 @@ export class AgentSessions implements AgentSessionsContract<AgentSession> {
     if (cached?.is_executing()) {
       await cached.stop();
     }
+    cached?.dispose_title_generation?.();
     const existed = await this.store.remove_session(resolved_session_id);
     this.sessions_by_id.delete(resolved_session_id);
     return existed;
@@ -245,6 +253,7 @@ export class AgentSessions implements AgentSessionsContract<AgentSession> {
     if (cached?.is_executing()) {
       throw new Error(`Session "${resolved_session_id}" is currently executing`);
     }
+    cached?.dispose_title_generation?.();
     const existed = await this.store.clear_session_messages(resolved_session_id);
     this.sessions_by_id.delete(resolved_session_id);
     return existed;
@@ -279,6 +288,7 @@ export class AgentSessions implements AgentSessionsContract<AgentSession> {
     }
 
     const result = await this.store.archive_session(session_id);
+    this.sessions_by_id.get(session_id)?.dispose_title_generation?.();
     this.sessions_by_id.delete(session_id);
     return result;
   }