@downcity/agent 1.1.408 → 1.1.437

package/bin/session/messages/SessionTurnFileDiffBuilder.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Session Turn 结构化文件修改的 Diff 构建器。
+ *
+ * 关键点（中文）
+ * - 从当前 Turn 的通用 Tool effects 中只选择 Workspace 文件修改事实。
+ * - 不读取 Turn 结束时的实时工作树，因此 Shell 和外部进程不会被反向归属。
+ * - 同一文件的修改状态无法连续证明时直接忽略，避免把外部插入的内容伪装成本轮修改。
+ */
+import type { RuntimeToolEffect } from "@downcity/type";
+import type { SessionTurnFileDiffData, SessionTurnFileDiffSummary } from "@downcity/type";
+/** 把当前 Turn effects 中的结构化文件修改收敛为可持久化 Diff。 */
+export declare function build_session_turn_file_diff(workspace_path: string, effects: readonly RuntimeToolEffect[]): SessionTurnFileDiffData | undefined;
+/** 从当前 Turn effects 收敛只含统计的实时摘要，供 Thinking 状态行轻量展示。 */
+export declare function build_session_turn_file_diff_summary(workspace_path: string, effects: readonly RuntimeToolEffect[]): SessionTurnFileDiffSummary;
+//# sourceMappingURL=SessionTurnFileDiffBuilder.d.ts.map

package/bin/session/messages/SessionTurnFileDiffBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnFileDiffBuilder.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionTurnFileDiffBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMxD,OAAO,KAAK,EAEV,uBAAuB,EAEvB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AAaxB,8CAA8C;AAC9C,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACpC,uBAAuB,GAAG,SAAS,CAQrC;AAED,uDAAuD;AACvD,wBAAgB,oCAAoC,CAClD,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACpC,0BAA0B,CAO5B"}

package/bin/session/messages/SessionTurnFileDiffBuilder.js

@@ -0,0 +1,180 @@
+/**
+ * Session Turn 结构化文件修改的 Diff 构建器。
+ *
+ * 关键点（中文）
+ * - 从当前 Turn 的通用 Tool effects 中只选择 Workspace 文件修改事实。
+ * - 不读取 Turn 结束时的实时工作树，因此 Shell 和外部进程不会被反向归属。
+ * - 同一文件的修改状态无法连续证明时直接忽略，避免把外部插入的内容伪装成本轮修改。
+ */
+import path from "node:path";
+import { FILE_HEADERS_ONLY, formatPatch, structuredPatch, } from "diff";
+import { WORKSPACE_FILE_MUTATION_EFFECT_TYPE, } from "@downcity/type";
+/** 把当前 Turn effects 中的结构化文件修改收敛为可持久化 Diff。 */
+export function build_session_turn_file_diff(workspace_path, effects) {
+    const files = collect_session_turn_file_diffs(workspace_path, effects);
+    if (files.length === 0)
+        return undefined;
+    return {
+        files,
+        additions: files.reduce((total, file) => total + file.additions, 0),
+        deletions: files.reduce((total, file) => total + file.deletions, 0),
+    };
+}
+/** 从当前 Turn effects 收敛只含统计的实时摘要，供 Thinking 状态行轻量展示。 */
+export function build_session_turn_file_diff_summary(workspace_path, effects) {
+    const files = collect_session_turn_file_diffs(workspace_path, effects);
+    return {
+        files_count: files.length,
+        additions: files.reduce((total, file) => total + file.additions, 0),
+        deletions: files.reduce((total, file) => total + file.deletions, 0),
+    };
+}
+/** 把 effects 收敛为稳定排序的文件 Diff 列表；空列表表示当前没有结构化修改。 */
+function collect_session_turn_file_diffs(workspace_path, effects) {
+    const mutations = effects.flatMap((effect) => {
+        const mutation = read_workspace_file_mutation_effect(effect);
+        return mutation ? [mutation] : [];
+    });
+    const files_by_path = collect_file_mutations(workspace_path, mutations);
+    return [...files_by_path.values()]
+        .filter((entry) => !entry.conflicted && !same_file_state(entry.before, entry.after))
+        .map(create_file_diff)
+        .sort((left, right) => left.file.localeCompare(right.file));
+}
+/** 从通用 Tool effect 中读取经过最小运行时校验的 Workspace 文件修改。 */
+function read_workspace_file_mutation_effect(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        return undefined;
+    const effect = input;
+    if (effect.type !== WORKSPACE_FILE_MUTATION_EFFECT_TYPE)
+        return undefined;
+    if (!effect.data || typeof effect.data !== "object" || Array.isArray(effect.data)) {
+        return undefined;
+    }
+    const mutation = effect.data;
+    if (typeof mutation.file_path !== "string" ||
+        !is_file_state(mutation.before) ||
+        !is_file_state(mutation.after))
+        return undefined;
+    return {
+        file_path: mutation.file_path,
+        before: mutation.before,
+        after: mutation.after,
+    };
+}
+/** 按文件聚合连续的结构化修改；无法证明连续时标记冲突。 */
+function collect_file_mutations(workspace_path, mutations) {
+    const workspace_root = path.resolve(workspace_path);
+    const files_by_path = new Map();
+    for (const mutation of mutations) {
+        const file = resolve_workspace_file(workspace_root, mutation.file_path);
+        if (!file)
+            continue;
+        const existing = files_by_path.get(file);
+        if (!existing) {
+            files_by_path.set(file, {
+                file,
+                before: mutation.before,
+                after: mutation.after,
+                conflicted: false,
+            });
+            continue;
+        }
+        if (!same_file_state(existing.after, mutation.before))
+            existing.conflicted = true;
+        existing.after = mutation.after;
+    }
+    return files_by_path;
+}
+/** 把绝对修改路径收窄为当前 Workspace 内的正斜杠相对路径。 */
+function resolve_workspace_file(workspace_root, file_path) {
+    if (typeof file_path !== "string" || !file_path.trim())
+        return undefined;
+    if (!path.isAbsolute(file_path))
+        return undefined;
+    const resolved_path = path.resolve(file_path);
+    const relative_path = path.relative(workspace_root, resolved_path);
+    if (!relative_path ||
+        relative_path === ".." ||
+        relative_path.startsWith(`..${path.sep}`) ||
+        path.isAbsolute(relative_path)) {
+        return undefined;
+    }
+    return relative_path.replaceAll(path.sep, "/");
+}
+/** 校验 Workspace 修改状态的最小运行时形状。 */
+function is_file_state(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        return false;
+    const state = input;
+    return typeof state.exists === "boolean" &&
+        (state.sha256 === undefined || typeof state.sha256 === "string") &&
+        (state.content === undefined || typeof state.content === "string");
+}
+/** 使用内容 hash 优先判断两个相邻修改状态是否连续。 */
+function same_file_state(left, right) {
+    if (left.exists !== right.exists)
+        return false;
+    if (!left.exists)
+        return true;
+    if (left.sha256 && right.sha256)
+        return left.sha256 === right.sha256;
+    if (left.content !== undefined && right.content !== undefined) {
+        return left.content === right.content;
+    }
+    return false;
+}
+/** 为单个连续文件修改生成统计与 unified patch。 */
+function create_file_diff(entry) {
+    const status = !entry.before.exists
+        ? "added"
+        : !entry.after.exists
+            ? "deleted"
+            : "modified";
+    const before_content = entry.before.exists ? entry.before.content : "";
+    const after_content = entry.after.exists ? entry.after.content : "";
+    const text_diff = before_content !== undefined && after_content !== undefined
+        ? create_text_patch(entry.file, status, before_content, after_content)
+        : undefined;
+    return {
+        file: entry.file,
+        status,
+        additions: text_diff?.additions ?? 0,
+        deletions: text_diff?.deletions ?? 0,
+        patch: text_diff?.patch ?? create_binary_patch(entry.file),
+    };
+}
+/** 生成 Git 风格文件头与标准 unified hunks。 */
+function create_text_patch(file, status, before, after) {
+    const old_file = status === "added" ? "/dev/null" : `a/${file}`;
+    const new_file = status === "deleted" ? "/dev/null" : `b/${file}`;
+    const structured = structuredPatch(old_file, new_file, before, after, "", "", { context: 3 });
+    let additions = 0;
+    let deletions = 0;
+    for (const hunk of structured.hunks) {
+        for (const line of hunk.lines) {
+            if (line.startsWith("+"))
+                additions += 1;
+            else if (line.startsWith("-"))
+                deletions += 1;
+        }
+    }
+    const header = [
+        `diff --git a/${file} b/${file}`,
+        ...(status === "added" ? ["new file mode 100644"] : []),
+        ...(status === "deleted" ? ["deleted file mode 100644"] : []),
+    ];
+    return {
+        additions,
+        deletions,
+        patch: `${header.join("\n")}\n${formatPatch(structured, FILE_HEADERS_ONLY).trimEnd()}`,
+    };
+}
+/** 无法安全保留文本内容时生成不伪造行级统计的变化说明。 */
+function create_binary_patch(file) {
+    return [
+        `diff --git a/${file} b/${file}`,
+        `Binary files a/${file} and b/${file} differ`,
+    ].join("\n");
+}
+//# sourceMappingURL=SessionTurnFileDiffBuilder.js.map

package/bin/session/messages/SessionTurnFileDiffBuilder.js.map

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

package/bin/session/messages/SessionTurnFileDiffData.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Session Turn 文件改动 data part 的协议辅助函数。
+ *
+ * 这里集中维护稳定 data_type 与运行时校验，避免 Desktop、远程客户端和插件各自解释
+ * 任意 JSON 结构。
+ */
+import type { SessionAgentDataPart } from "@downcity/type";
+import type { SessionTurnFileDiffData } from "@downcity/type";
+/** 当前 Turn 文件改动使用的稳定 Assistant data part 类型。 */
+export declare const SESSION_TURN_FILE_DIFF_DATA_TYPE = "data-session-turn-file-diff";
+/** 从 Assistant data part 中读取经过校验的 Turn 文件改动。 */
+export declare function read_session_turn_file_diff_data(part: SessionAgentDataPart): SessionTurnFileDiffData | undefined;
+/** 判断 data part 是否为有效的 Turn 文件改动。 */
+export declare function is_session_turn_file_diff_data_part(part: SessionAgentDataPart): boolean;
+//# sourceMappingURL=SessionTurnFileDiffData.d.ts.map

package/bin/session/messages/SessionTurnFileDiffData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnFileDiffData.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionTurnFileDiffData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,gBAAgB,CAAC;AAExB,gDAAgD;AAChD,eAAO,MAAM,gCAAgC,gCAAgC,CAAC;AAE9E,gDAAgD;AAChD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,oBAAoB,GACzB,uBAAuB,GAAG,SAAS,CAYrC;AAED,qCAAqC;AACrC,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAET"}

package/bin/session/messages/SessionTurnFileDiffData.js

@@ -0,0 +1,59 @@
+/**
+ * Session Turn 文件改动 data part 的协议辅助函数。
+ *
+ * 这里集中维护稳定 data_type 与运行时校验，避免 Desktop、远程客户端和插件各自解释
+ * 任意 JSON 结构。
+ */
+/** 当前 Turn 文件改动使用的稳定 Assistant data part 类型。 */
+export const SESSION_TURN_FILE_DIFF_DATA_TYPE = "data-session-turn-file-diff";
+/** 从 Assistant data part 中读取经过校验的 Turn 文件改动。 */
+export function read_session_turn_file_diff_data(part) {
+    if (part.data_type !== SESSION_TURN_FILE_DIFF_DATA_TYPE)
+        return undefined;
+    if (!is_record(part.data) || !Array.isArray(part.data.files))
+        return undefined;
+    const files = part.data.files.flatMap((candidate) => {
+        const file_diff = read_file_diff(candidate);
+        return file_diff ? [file_diff] : [];
+    });
+    if (files.length !== part.data.files.length)
+        return undefined;
+    const additions = read_count(part.data.additions);
+    const deletions = read_count(part.data.deletions);
+    if (additions === undefined || deletions === undefined)
+        return undefined;
+    return { files, additions, deletions };
+}
+/** 判断 data part 是否为有效的 Turn 文件改动。 */
+export function is_session_turn_file_diff_data_part(part) {
+    return read_session_turn_file_diff_data(part) !== undefined;
+}
+/** 读取单个文件差异并收窄未知 JSON。 */
+function read_file_diff(input) {
+    if (!is_record(input))
+        return undefined;
+    const file = typeof input.file === "string" ? input.file : "";
+    const status = input.status;
+    const additions = read_count(input.additions);
+    const deletions = read_count(input.deletions);
+    if (!file ||
+        !is_file_diff_status(status) ||
+        additions === undefined ||
+        deletions === undefined ||
+        typeof input.patch !== "string")
+        return undefined;
+    return { file, status, additions, deletions, patch: input.patch };
+}
+/** 文件状态只接受 canonical 三种值。 */
+function is_file_diff_status(input) {
+    return input === "added" || input === "deleted" || input === "modified";
+}
+/** 行数必须是非负整数。 */
+function read_count(input) {
+    return Number.isInteger(input) && Number(input) >= 0 ? Number(input) : undefined;
+}
+/** 将未知值收窄为普通对象。 */
+function is_record(input) {
+    return Boolean(input) && typeof input === "object" && !Array.isArray(input);
+}
+//# sourceMappingURL=SessionTurnFileDiffData.js.map

package/bin/session/messages/SessionTurnFileDiffData.js.map

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

package/bin/session/messages/SessionUserContext.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Session User Context Part 的校验与模型标记渲染。
+ *
+ * canonical Message 始终保存原始 tag 与 context；只有进入模型上下文时才生成 XML 风格标记，
+ * 避免持久化层与具体模型提示格式互相耦合。
+ */
+/** 校验并规范化 Session Context 标签。 */
+export declare function normalize_session_context_tag(tag_input: unknown): string;
+/** 校验 Session Context 正文，同时保留调用方提供的原始空白。 */
+export declare function normalize_session_context_content(context_input: unknown): string;
+/** 把 canonical Context Part 安全渲染为模型可消费的 XML 风格文本。 */
+export declare function render_session_user_context(tag_input: unknown, context_input: unknown): string;
+//# sourceMappingURL=SessionUserContext.d.ts.map

package/bin/session/messages/SessionUserContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionUserContext.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionUserContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,iCAAiC;AACjC,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAQxE;AAED,4CAA4C;AAC5C,wBAAgB,iCAAiC,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,CAMhF;AAED,qDAAqD;AACrD,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,OAAO,GACrB,MAAM,CAIR"}

package/bin/session/messages/SessionUserContext.js

@@ -0,0 +1,38 @@
+/**
+ * Session User Context Part 的校验与模型标记渲染。
+ *
+ * canonical Message 始终保存原始 tag 与 context；只有进入模型上下文时才生成 XML 风格标记，
+ * 避免持久化层与具体模型提示格式互相耦合。
+ */
+/** Session Context 标签允许使用的稳定名称格式。 */
+const SESSION_CONTEXT_TAG_PATTERN = /^[a-z][a-z0-9_-]*$/u;
+/** 校验并规范化 Session Context 标签。 */
+export function normalize_session_context_tag(tag_input) {
+    const tag = typeof tag_input === "string" ? tag_input.trim() : "";
+    if (!SESSION_CONTEXT_TAG_PATTERN.test(tag)) {
+        throw new Error("Session context tag must start with a lowercase letter and contain only lowercase letters, numbers, underscores, or hyphens");
+    }
+    return tag;
+}
+/** 校验 Session Context 正文，同时保留调用方提供的原始空白。 */
+export function normalize_session_context_content(context_input) {
+    const context = typeof context_input === "string" ? context_input : "";
+    if (!context.trim()) {
+        throw new Error("Session context content must not be empty");
+    }
+    return context;
+}
+/** 把 canonical Context Part 安全渲染为模型可消费的 XML 风格文本。 */
+export function render_session_user_context(tag_input, context_input) {
+    const tag = normalize_session_context_tag(tag_input);
+    const context = normalize_session_context_content(context_input);
+    return `<${tag}>${escape_xml_text(context)}</${tag}>`;
+}
+/** 转义 XML 文本节点中的结构字符，防止正文提前闭合或插入标签。 */
+function escape_xml_text(value) {
+    return value
+        .replace(/&/gu, "&amp;")
+        .replace(/</gu, "&lt;")
+        .replace(/>/gu, "&gt;");
+}
+//# sourceMappingURL=SessionUserContext.js.map

package/bin/session/messages/SessionUserContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionUserContext.js","sourceRoot":"","sources":["../../../src/session/messages/SessionUserContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qCAAqC;AACrC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AAE1D,iCAAiC;AACjC,MAAM,UAAU,6BAA6B,CAAC,SAAkB;IAC9D,MAAM,GAAG,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,6HAA6H,CAC9H,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,iCAAiC,CAAC,aAAsB;IACtE,MAAM,OAAO,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,2BAA2B,CACzC,SAAkB,EAClB,aAAsB;IAEtB,MAAM,GAAG,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,iCAAiC,CAAC,aAAa,CAAC,CAAC;IACjE,OAAO,IAAI,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;AACxD,CAAC;AAED,uCAAuC;AACvC,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK;SACT,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/bin/session/messages/SessionUserMessage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Session User Message 与公开输入 Part 的 canonical 转换规则。
+ *
+ * 本模块只进行确定性数据归一化，不持有 Message、Store 或 Session 状态。
+ */
+import type { SessionAgentContent, SessionUserContent } from "@downcity/type";
+import type { SessionUserMessagePart } from "@downcity/type";
+/** 把 Downcity Session User parts 归一为 canonical User parts。 */
+export declare function normalize_session_user_parts(parts: SessionUserContent[] | null | undefined): SessionUserMessagePart[];
+/** 校验直接写入的 canonical User Parts，并保留已有 Part identity。 */
+export declare function normalize_canonical_session_user_parts(parts: readonly SessionUserMessagePart[]): SessionUserMessagePart[];
+/** 判断 Assistant 结果中是否包含可持久化内容。 */
+export declare function has_assistant_result_content(parts: readonly SessionAgentContent[]): boolean;
+//# sourceMappingURL=SessionUserMessage.d.ts.map

package/bin/session/messages/SessionUserMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionUserMessage.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionUserMessage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAO7D,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC7C,sBAAsB,EAAE,CAuC1B;AAED,wDAAwD;AACxD,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,SAAS,sBAAsB,EAAE,GACvC,sBAAsB,EAAE,CAU1B;AAED,kCAAkC;AAClC,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,OAAO,CAQT"}

package/bin/session/messages/SessionUserMessage.js

@@ -0,0 +1,74 @@
+/**
+ * Session User Message 与公开输入 Part 的 canonical 转换规则。
+ *
+ * 本模块只进行确定性数据归一化，不持有 Message、Store 或 Session 状态。
+ */
+import { to_session_json_value } from "../../session/messages/SessionJsonValue.js";
+import { normalize_session_context_content, normalize_session_context_tag, } from "../../session/messages/SessionUserContext.js";
+/** 把 Downcity Session User parts 归一为 canonical User parts。 */
+export function normalize_session_user_parts(parts) {
+    if (!Array.isArray(parts))
+        return [];
+    return parts.flatMap((part, index) => {
+        if (part.type === "text") {
+            return [{
+                    part_id: `user-text:${index + 1}`,
+                    sequence: index + 1,
+                    type: "text",
+                    text: part.text,
+                }];
+        }
+        if (part.type === "context") {
+            return [{
+                    part_id: `user-context:${index + 1}`,
+                    sequence: index + 1,
+                    type: "context",
+                    tag: normalize_session_context_tag(part.tag),
+                    context: normalize_session_context_content(part.context),
+                }];
+        }
+        if (part.type === "file") {
+            return [{
+                    part_id: `user-file:${index + 1}`,
+                    sequence: index + 1,
+                    type: "file",
+                    url: part.url,
+                    media_type: part.media_type,
+                    ...(part.filename ? { filename: part.filename } : {}),
+                }];
+        }
+        return [{
+                part_id: `user-data:${index + 1}`,
+                sequence: index + 1,
+                type: "data",
+                data_type: part.data_type,
+                data: to_session_json_value(part.data),
+                ...(part.data_id ? { data_id: part.data_id } : {}),
+            }];
+    });
+}
+/** 校验直接写入的 canonical User Parts，并保留已有 Part identity。 */
+export function normalize_canonical_session_user_parts(parts) {
+    return parts.map((part, index) => {
+        const canonical = { ...structuredClone(part), sequence: index + 1 };
+        if (canonical.type !== "context")
+            return canonical;
+        return {
+            ...canonical,
+            tag: normalize_session_context_tag(canonical.tag),
+            context: normalize_session_context_content(canonical.context),
+        };
+    });
+}
+/** 判断 Assistant 结果中是否包含可持久化内容。 */
+export function has_assistant_result_content(parts) {
+    return parts.some((part) => {
+        if (part.type === "text")
+            return Boolean(part.text.trim());
+        if (part.type === "file") {
+            return Boolean(part.media_type.trim() && part.url.trim());
+        }
+        return Boolean(part.data_type.trim());
+    });
+}
+//# sourceMappingURL=SessionUserMessage.js.map

package/bin/session/messages/SessionUserMessage.js.map

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

package/bin/session/preview/SessionMessagePreview.d.ts

@@ -5,7 +5,7 @@
  * - 只负责从单条 canonical Message 提取用户可见文本。
  * - history store 与浏览层共用该投影，避免摘要写入和读取采用不同规则。
  */
-import type { SessionMessage } from "../../types/session/SessionMessage.js";
+import type { SessionMessage } from "@downcity/type";
 /**
  * 解析单条 session record 的用户可见预览文本。
  */

package/bin/session/preview/SessionMessagePreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionMessagePreview.d.ts","sourceRoot":"","sources":["../../../src/session/preview/SessionMessagePreview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAcxE;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,GACtB,MAAM,CAaR"}
+{"version":3,"file":"SessionMessagePreview.d.ts","sourceRoot":"","sources":["../../../src/session/preview/SessionMessagePreview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAcrD;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,GACtB,MAAM,CAyBR"}

package/bin/session/preview/SessionMessagePreview.js

@@ -5,7 +5,7 @@
  * - 只负责从单条 canonical Message 提取用户可见文本。
  * - history store 与浏览层共用该投影，避免摘要写入和读取采用不同规则。
  */
-import { extract_session_message_text, resolve_session_assistant_visible_text, } from "../messages/SessionMessageText.js";
+import { extract_session_message_text, resolve_session_assistant_visible_text, } from "../../session/messages/SessionMessageText.js";
 function extract_assistant_tool_summary(message) {
     const tool_names = new Set();
     for (const part of message.parts) {
@@ -23,19 +23,35 @@ function extract_assistant_tool_summary(message) {
  * 解析单条 session record 的用户可见预览文本。
  */
 export function resolve_session_message_preview(message) {
-    if (message.type === "action") {
-        return message.description
-            ? `${message.title}\n${message.description}`
-            : message.title;
-    }
-    if (message.type === "error")
-        return message.message;
     const plain_text = extract_session_message_text(message);
     if (plain_text)
         return plain_text;
-    if (message.type !== "assistant")
+    if (message.role !== "agent")
         return "";
     const user_visible = resolve_session_assistant_visible_text(message).trim();
-    return user_visible || extract_assistant_tool_summary(message);
+    if (user_visible)
+        return user_visible;
+    for (const part of message.parts) {
+        switch (part.type) {
+            case "action":
+                return part.description ? `${part.title}\n${part.description}` : part.title;
+            case "error":
+                return part.message;
+            case "text":
+            case "reasoning":
+            case "tool":
+            case "interaction":
+            case "file":
+            case "data":
+                break;
+            default:
+                assert_never(part);
+        }
+    }
+    return extract_assistant_tool_summary(message);
+}
+/** canonical Agent Part 增加成员时强制预览投影显式处理。 */
+function assert_never(value) {
+    throw new Error(`Unsupported preview Session Part: ${String(value.type)}`);
 }
 //# sourceMappingURL=SessionMessagePreview.js.map

package/bin/session/preview/SessionMessagePreview.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionMessagePreview.js","sourceRoot":"","sources":["../../../src/session/preview/SessionMessagePreview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,0CAA0C,CAAC;AAGlD,SAAS,8BAA8B,CAAC,OAAuD;IAC7F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,SAAS;YAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,GAAG,CAAC;QACxB,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC/C,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAuB;IAEvB,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,WAAW;YACxB,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,WAAW,EAAE;YAC5C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IACrD,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAE5C,MAAM,YAAY,GAAG,sCAAsC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO,YAAY,IAAI,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACjE,CAAC"}
+{"version":3,"file":"SessionMessagePreview.js","sourceRoot":"","sources":["../../../src/session/preview/SessionMessagePreview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,0CAA0C,CAAC;AAGlD,SAAS,8BAA8B,CAAC,OAAmD;IACzF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,SAAS;YAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,GAAG,CAAC;QACxB,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC/C,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAuB;IAEvB,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,YAAY,GAAG,sCAAsC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5E,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YAC9E,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,OAAO,CAAC;YACtB,KAAK,MAAM,CAAC;YACZ,KAAK,WAAW,CAAC;YACjB,KAAK,MAAM,CAAC;YACZ,KAAK,aAAa,CAAC;YACnB,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM;gBACT,MAAM;YACR;gBACE,YAAY,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,4CAA4C;AAC5C,SAAS,YAAY,CAAC,KAAY;IAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAE,KAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrG,CAAC"}

package/bin/session/runtime/SessionEventHub.d.ts

@@ -5,7 +5,7 @@
  * - 收口 `Session.subscribe()` 的订阅/取消订阅能力。
  * - 只做未来事件广播，不做缓存、重放或背压管理。
  */
-import type { SessionMutation, SessionMutationSubscriber, SessionMutationUnsubscribe } from "../../types/session/SessionMutation.js";
+import type { SessionMutation, SessionMutationSubscriber, SessionMutationUnsubscribe } from "@downcity/type";
 /**
  * SessionEventHub：最小事件总线实现。
  */

package/bin/session/runtime/SessionEventHub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionEventHub.d.ts","sourceRoot":"","sources":["../../../src/session/runtime/SessionEventHub.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgD;IAC5E,OAAO,CAAC,kBAAkB,CAAK;IAE/B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,yBAAyB,GAAG,0BAA0B;IAU5E;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;CASzC"}
+{"version":3,"file":"SessionEventHub.d.ts","sourceRoot":"","sources":["../../../src/session/runtime/SessionEventHub.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgD;IAC5E,OAAO,CAAC,kBAAkB,CAAK;IAE/B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,yBAAyB,GAAG,0BAA0B;IAU5E;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;CASzC"}

package/bin/session/runtime/SessionModelRequestWarning.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Session 模型请求 Warning 投影模块。
+ *
+ * 本模块是内部模型请求失败与公开 Session Mutation 之间的唯一转换边界。
+ */
+import type { ModelRequestFailureNotice } from "@downcity/type";
+import type { SessionModelRequestWarningMutation } from "@downcity/type";
+/** 构造公开 Session 模型请求 Warning Mutation。 */
+export declare function create_session_model_request_warning(input: {
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前模型请求所属 Turn；后台 Session 请求允许为空。 */
+    turn_id?: string;
+    /** 模型请求执行器产生的内部失败通知。 */
+    notice: ModelRequestFailureNotice;
+}): SessionModelRequestWarningMutation;
+//# sourceMappingURL=SessionModelRequestWarning.d.ts.map

package/bin/session/runtime/SessionModelRequestWarning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionModelRequestWarning.d.ts","sourceRoot":"","sources":["../../../src/session/runtime/SessionModelRequestWarning.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AAGzE,0CAA0C;AAC1C,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,yBAAyB,CAAC;CACnC,GAAG,kCAAkC,CAUrC"}

package/bin/session/runtime/SessionModelRequestWarning.js

@@ -0,0 +1,19 @@
+/**
+ * Session 模型请求 Warning 投影模块。
+ *
+ * 本模块是内部模型请求失败与公开 Session Mutation 之间的唯一转换边界。
+ */
+import { generate_id } from "../../utils/Id.js";
+/** 构造公开 Session 模型请求 Warning Mutation。 */
+export function create_session_model_request_warning(input) {
+    return {
+        mutation_id: generate_id(),
+        variant: "warning",
+        type: "model_request",
+        session_id: input.session_id,
+        created_at: Date.now(),
+        ...(input.turn_id ? { turn_id: input.turn_id } : {}),
+        ...input.notice,
+    };
+}
+//# sourceMappingURL=SessionModelRequestWarning.js.map

package/bin/session/runtime/SessionModelRequestWarning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionModelRequestWarning.js","sourceRoot":"","sources":["../../../src/session/runtime/SessionModelRequestWarning.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,0CAA0C;AAC1C,MAAM,UAAU,oCAAoC,CAAC,KAOpD;IACC,OAAO;QACL,WAAW,EAAE,WAAW,EAAE;QAC1B,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,eAAe;QACrB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,KAAK,CAAC,MAAM;KAChB,CAAC;AACJ,CAAC"}

package/bin/session/runtime/SessionTitleTask.d.ts

@@ -14,12 +14,12 @@ export interface SessionTitleTaskOptions {
     /** 当前 Session 的稳定标识。 */
     session_id: string;
     /** 用于记录后台任务失败的统一日志器。 */
-    logger: Logger;
+    logger?: Logger;
 }
 /** Session 标题后台任务协调器。 */
 export declare class SessionTitleTask {
     private readonly session_id;
-    private readonly logger;
+    private readonly logger?;
     private active_task;
     private abort_controller;
     private pending_runner;