@downcity/agent 1.1.317 → 1.1.323

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAttachmentStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/SessionAttachmentStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,yBAAyB;AACzB,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE;QACtB,oBAAoB;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,yBAAyB;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrB"}

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":"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"}
+{"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,EACnC,0CAA0C,GAC3C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAK3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAE/F,wBAAwB;AACxB,MAAM,OAAO,iBAAiB;IAC5B,wBAAwB;IACf,UAAU,CAAS;IAE5B,wCAAwC;IAC/B,QAAQ,CAA2B;IAE5C,2BAA2B;IAClB,WAAW,CAA8B;IAElD,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;QACH,IAAI,CAAC,WAAW,GAAG,IAAI,2BAA2B,CAAC;YACjD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,oBAAoB,EAAE,0CAA0C,CAC9D,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"}

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.317",
+  "version": "1.1.323",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与本机 RPC 能力",
   "main": "./bin/index.js",
@@ -16,8 +16,8 @@
     }
   },
   "dependencies": {
-    "@downcity/shell": "^0.1.165",
-    "@downcity/type": "0.1.191",
+    "@downcity/shell": "^0.1.167",
+    "@downcity/type": "0.1.193",
     "ai": "^6.0.193",
     "commander": "^15.0.0",
     "dotenv": "^17.4.2",
@@ -32,9 +32,9 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@downcity/sandbox-linux": "^0.1.29",
-    "@downcity/sandbox-macos": "^0.1.29",
-    "@downcity/sandbox-windows-mxc": "^0.1.29",
+    "@downcity/sandbox-linux": "^0.1.31",
+    "@downcity/sandbox-macos": "^0.1.31",
+    "@downcity/sandbox-windows-mxc": "^0.1.31",
     "@ai-sdk/openai": "^3.0.67",
     "@types/fs-extra": "^11.0.4",
     "@types/js-yaml": "^4.0.9",

package/scripts/remote-session-reconnect.test.mjs

@@ -11,6 +11,31 @@ import assert from "node:assert/strict";
 
 import { RemoteSession } from "../bin/remote/RemoteSession.js";
 
+test("RemoteSession forwards set observability options to its transport", async () => {
+  const calls = [];
+  const transport = {
+    async set(session_id, input, options) {
+      calls.push({ session_id, input, options });
+    },
+  };
+  const session = new RemoteSession(transport, {
+    agent_id: "agent_test",
+    session_id: "session_test",
+    message_count: 0,
+  });
+
+  await session.set(
+    { security: { approval_mode: "ask" } },
+    { persist_action: false, publish_mutation: false },
+  );
+
+  assert.deepEqual(calls, [{
+    session_id: "session_test",
+    input: { security: { approval_mode: "ask" } },
+    options: { persist_action: false, publish_mutation: false },
+  }]);
+});
+
 test("RemoteSession reconnects the event pump after transport close", async () => {
   const subscriptions = [];
   let prompt_count = 0;

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(), []);
+});