@downcity/agent 1.1.287 → 1.1.310

package/bin/session/runtime/SessionCompactOperation.js

@@ -0,0 +1,66 @@
+/**
+ * Session 显式压缩操作生命周期。
+ *
+ * 该模块只负责把队列 Command 的异步执行映射为公开 Compact Handle；压缩计划、
+ * canonical 历史提交与事件发布仍由 Session 领域拥有。
+ */
+/** 创建一个与单次 Session Compact Command 绑定的操作生命周期。 */
+export function create_session_compact_operation(options) {
+    let result = null;
+    let resolve_finished;
+    const finished = new Promise((resolve) => {
+        resolve_finished = resolve;
+    });
+    return {
+        handle: {
+            id: options.compact_id,
+            get result() {
+                return result;
+            },
+            finished,
+        },
+        execute: async () => {
+            let final_result;
+            try {
+                const outcome = await options.run();
+                const reason = outcome.compacted
+                    ? "compacted"
+                    : outcome.reason === "nothing_to_compact"
+                        ? "nothing_to_compact"
+                        : "compact_failed";
+                final_result = {
+                    compact_id: options.compact_id,
+                    success: reason !== "compact_failed",
+                    compacted: outcome.compacted,
+                    reason,
+                    ...(outcome.error ? { error: outcome.error } : {}),
+                };
+            }
+            catch (error) {
+                const error_message = error instanceof Error ? error.message : String(error);
+                final_result = {
+                    compact_id: options.compact_id,
+                    success: false,
+                    compacted: false,
+                    reason: "compact_failed",
+                    error: error_message,
+                };
+                try {
+                    await options.log_error(error_message);
+                }
+                catch {
+                    // 关键点（中文）：日志属于观测侧，失败不能阻止 Handle 收口。
+                }
+            }
+            result = final_result;
+            try {
+                options.publish_finish(final_result);
+            }
+            catch {
+                // 关键点（中文）：事件发布失败不能让已完成的 Command 反向失败。
+            }
+            resolve_finished(final_result);
+        },
+    };
+}
+//# sourceMappingURL=SessionCompactOperation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionCompactOperation.js","sourceRoot":"","sources":["../../../src/session/runtime/SessionCompactOperation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,iDAAiD;AACjD,MAAM,UAAU,gCAAgC,CAC9C,OAA6C;IAE7C,IAAI,MAAM,GAAqC,IAAI,CAAC;IACpD,IAAI,gBAA6D,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,OAAO,CAA4B,CAAC,OAAO,EAAE,EAAE;QAClE,gBAAgB,GAAG,OAAO,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,OAAO,CAAC,UAAU;YACtB,IAAI,MAAM;gBACR,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,QAAQ;SACT;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,YAAuC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS;oBAC9B,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,oBAAoB;wBACvC,CAAC,CAAC,oBAAoB;wBACtB,CAAC,CAAC,gBAAgB,CAAC;gBACvB,YAAY,GAAG;oBACb,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,OAAO,EAAE,MAAM,KAAK,gBAAgB;oBACpC,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM;oBACN,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnD,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,aAAa,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC7E,YAAY,GAAG;oBACb,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,OAAO,EAAE,KAAK;oBACd,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,gBAAgB;oBACxB,KAAK,EAAE,aAAa;iBACrB,CAAC;gBACF,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;gBACzC,CAAC;gBAAC,MAAM,CAAC;oBACP,oCAAoC;gBACtC,CAAC;YACH,CAAC;YAED,MAAM,GAAG,YAAY,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;YACxC,CAAC;YACD,gBAAgB,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Session 历史压缩结果收口器。
+ *
+ * Session 仍提供 Composer 输入和 canonical 提交回调；本模块统一成功、空计划、
+ * 失败与 best-effort 日志的结果映射，供显式压缩和自动恢复共同复用。
+ */
+import type { SessionCompactionPlan } from "../../types/session/SessionComposer.js";
+import type { SessionCompactHistory } from "../../types/session/SessionExecution.js";
+/** 执行一次历史压缩所需的 Session 领域回调。 */
+export interface RunSessionHistoryCompactionOptions {
+    /** 当前压缩所属 Turn；空值表示显式队列命令尚未进入 Turn。 */
+    turn_id?: string;
+    /** 让 Composer 基于只读 Session 快照生成压缩计划。 */
+    create_plan: () => Promise<SessionCompactionPlan | null>;
+    /** 原子提交 Composer 返回的 canonical 压缩计划。 */
+    commit_plan: (plan: SessionCompactionPlan) => Promise<void>;
+    /** 尽力记录压缩错误，不得覆盖领域结果。 */
+    log_error: (error_message: string) => Promise<void>;
+}
+/** 执行并收口一次统一 Session 历史压缩。 */
+export declare function run_session_history_compaction(options: RunSessionHistoryCompactionOptions): ReturnType<SessionCompactHistory>;
+//# sourceMappingURL=SessionHistoryCompaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHistoryCompaction.d.ts","sourceRoot":"","sources":["../../../src/session/runtime/SessionHistoryCompaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,gCAAgC;AAChC,MAAM,WAAW,kCAAkC;IACjD,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACzD,wCAAwC;IACxC,WAAW,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,yBAAyB;IACzB,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,8BAA8B;AAC9B,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,kCAAkC,GAC1C,UAAU,CAAC,qBAAqB,CAAC,CAmBnC"}

package/bin/session/runtime/SessionHistoryCompaction.js

@@ -0,0 +1,31 @@
+/**
+ * Session 历史压缩结果收口器。
+ *
+ * Session 仍提供 Composer 输入和 canonical 提交回调；本模块统一成功、空计划、
+ * 失败与 best-effort 日志的结果映射，供显式压缩和自动恢复共同复用。
+ */
+/** 执行并收口一次统一 Session 历史压缩。 */
+export async function run_session_history_compaction(options) {
+    try {
+        const plan = await options.create_plan();
+        if (!plan)
+            return { compacted: false, reason: "nothing_to_compact" };
+        await options.commit_plan(plan);
+        return { compacted: true };
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : String(error);
+        try {
+            await options.log_error(error_message);
+        }
+        catch {
+            // 关键点（中文）：日志失败不能覆盖稳定的压缩领域结果。
+        }
+        return {
+            compacted: false,
+            reason: "compact_failed",
+            error: error_message,
+        };
+    }
+}
+//# sourceMappingURL=SessionHistoryCompaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHistoryCompaction.js","sourceRoot":"","sources":["../../../src/session/runtime/SessionHistoryCompaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAA2C;IAE3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;QACrE,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7E,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,aAAa;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * SessionTurnContext 运行时实现。
+ *
+ * 关键点（中文）
+ * - Session 创建并拥有上下文，Executor 和 Tool 通过领域分区协作。
+ * - 所有可变数组、Plugin lease 与取消监听都封装在本模块内。
+ * - Plugin 每次只获得新建的只读快照，不能越过扩展边界访问内核运行能力。
+ */
+import type { SessionTurnContext, SessionTurnContextInit } from "../../types/executor/SessionTurnContext.js";
+import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
+/** 非 Turn 查询创建 Plugin 只读快照所需的稳定 Session 状态。 */
+export interface CreateSessionPluginExecutionContextInput {
+    /** 当前 Session 标识。 */
+    session_id: string;
+    /** 当前 Session 所属项目根目录。 */
+    project_root: string;
+    /** 当前 Session 已生效的 Workspace 环境变量。 */
+    workspace_env: Readonly<Record<string, string>>;
+    /** 当前 Session 已生效的 Agent instruction 文本。 */
+    agent_systems: readonly string[];
+}
+/** 创建一次由 Session Turn 拥有的统一执行上下文。 */
+export declare function create_session_turn_context(init: SessionTurnContextInit): SessionTurnContext;
+/** 为非 Turn 的 system 查询创建 Plugin 可读取的 Session 快照。 */
+export declare function create_session_plugin_execution_context(input: CreateSessionPluginExecutionContextInput): PluginExecutionContext;
+//# sourceMappingURL=SessionTurnContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnContext.d.ts","sourceRoot":"","sources":["../../../src/session/runtime/SessionTurnContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAEvF,+CAA+C;AAC/C,MAAM,WAAW,wCAAwC;IACvD,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,4CAA4C;IAC5C,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAgLD,qCAAqC;AACrC,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,sBAAsB,GAC3B,kBAAkB,CAEpB;AAED,oDAAoD;AACpD,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,wCAAwC,GAC9C,sBAAsB,CAOxB"}

package/bin/session/runtime/SessionTurnContext.js

@@ -0,0 +1,181 @@
+/**
+ * SessionTurnContext 运行时实现。
+ *
+ * 关键点（中文）
+ * - Session 创建并拥有上下文，Executor 和 Tool 通过领域分区协作。
+ * - 所有可变数组、Plugin lease 与取消监听都封装在本模块内。
+ * - Plugin 每次只获得新建的只读快照，不能越过扩展边界访问内核运行能力。
+ */
+/** SessionTurnContext 的唯一内置实现。 */
+class DefaultSessionTurnContext {
+    init;
+    session;
+    interactions;
+    shell;
+    abort_controller = new AbortController();
+    upstream_abort_signal;
+    abort_from_upstream;
+    disposed = false;
+    workspace_env_snapshot;
+    agent_systems_snapshot = Object.freeze([]);
+    plugin_lease;
+    injected_user_messages = [];
+    deferred_messages = [];
+    pending_assistant_parts = [];
+    lifecycle;
+    step;
+    input;
+    output;
+    constructor(init) {
+        this.init = init;
+        const session_id = String(init.session_id || "").trim();
+        if (!session_id) {
+            throw new Error("SessionTurnContext requires a non-empty session_id");
+        }
+        const turn_id = String(init.turn_id || "").trim();
+        if (!turn_id) {
+            throw new Error("SessionTurnContext requires a non-empty turn_id");
+        }
+        const project_root = String(init.project_root || "").trim();
+        this.session = Object.freeze({
+            session_id,
+            turn_id,
+            ...(project_root ? { project_root } : {}),
+        });
+        this.interactions = init.interactions;
+        this.shell = Object.freeze({
+            ...(init.shell_approval_gateway
+                ? { approval_gateway: init.shell_approval_gateway }
+                : {}),
+        });
+        this.upstream_abort_signal = init.abort_signal;
+        this.abort_from_upstream = () => {
+            if (!this.abort_controller.signal.aborted) {
+                this.abort_controller.abort(this.upstream_abort_signal?.reason);
+            }
+        };
+        if (this.upstream_abort_signal?.aborted) {
+            this.abort_from_upstream();
+        }
+        else {
+            this.upstream_abort_signal?.addEventListener("abort", this.abort_from_upstream, { once: true });
+        }
+        this.lifecycle = Object.freeze({
+            abort_signal: this.abort_controller.signal,
+            abort: (reason) => {
+                if (!this.abort_controller.signal.aborted) {
+                    this.abort_controller.abort(reason);
+                }
+            },
+            dispose: async () => await this.dispose(),
+        });
+        const context = this;
+        this.step = Object.freeze({
+            get workspace_env() {
+                return context.workspace_env_snapshot;
+            },
+            get agent_systems() {
+                return context.agent_systems_snapshot;
+            },
+            get plugins() {
+                return context.plugin_lease;
+            },
+            commit: (input) => {
+                context.workspace_env_snapshot = Object.freeze({
+                    ...input.workspace_env,
+                });
+                context.agent_systems_snapshot = Object.freeze([
+                    ...input.agent_systems,
+                ]);
+            },
+            replace_plugins: async (plugins) => {
+                const previous = context.plugin_lease;
+                context.plugin_lease = plugins;
+                if (previous && previous !== plugins)
+                    await previous.release();
+            },
+            release: async () => await context.release_plugins(),
+            plugin_execution_context: () => context.create_plugin_execution_context(),
+        });
+        this.input = Object.freeze({
+            checkpoint: async () => {
+                const injected = context.injected_user_messages;
+                context.injected_user_messages = [];
+                let queued = [];
+                try {
+                    queued = (await context.init.merge_step_input?.()) || [];
+                }
+                catch {
+                    queued = [];
+                }
+                return [...injected, ...queued];
+            },
+            has_pending: () => context.init.has_pending_step_input?.() === true,
+            inject_user_message: (message) => {
+                context.injected_user_messages.push(message);
+            },
+            defer_user_message: (message) => {
+                context.deferred_messages.push(message);
+            },
+            deferred_user_messages: () => Object.freeze([...context.deferred_messages]),
+            consume_history_reload: () => context.init.consume_history_reload?.() === true,
+        });
+        this.output = Object.freeze({
+            ...(init.assistant_output ? { assistant: init.assistant_output } : {}),
+            enqueue_assistant_parts: (parts) => {
+                context.pending_assistant_parts.push(...parts);
+            },
+            take_assistant_parts: () => {
+                const parts = context.pending_assistant_parts;
+                context.pending_assistant_parts = [];
+                return [...parts];
+            },
+            publish_action: async (event) => {
+                await context.init.publish_action?.(event);
+            },
+        });
+    }
+    /** 为 Plugin 生成不共享根对象引用的只读快照。 */
+    create_plugin_execution_context() {
+        return Object.freeze({
+            session_id: this.session.session_id,
+            turn_id: this.session.turn_id,
+            ...(this.session.project_root
+                ? { project_root: this.session.project_root }
+                : {}),
+            ...(this.workspace_env_snapshot
+                ? { workspace_env: this.workspace_env_snapshot }
+                : {}),
+            agent_systems: this.agent_systems_snapshot,
+            abort_signal: this.abort_controller.signal,
+        });
+    }
+    /** 释放当前 Step 捕获的 Plugin lease。 */
+    async release_plugins() {
+        const plugins = this.plugin_lease;
+        this.plugin_lease = undefined;
+        await plugins?.release();
+    }
+    /** 闭合当前运行拥有的全部资源。 */
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.upstream_abort_signal?.removeEventListener("abort", this.abort_from_upstream);
+        await this.release_plugins();
+    }
+}
+/** 创建一次由 Session Turn 拥有的统一执行上下文。 */
+export function create_session_turn_context(init) {
+    return new DefaultSessionTurnContext(init);
+}
+/** 为非 Turn 的 system 查询创建 Plugin 可读取的 Session 快照。 */
+export function create_session_plugin_execution_context(input) {
+    return Object.freeze({
+        session_id: input.session_id,
+        project_root: input.project_root,
+        workspace_env: Object.freeze({ ...input.workspace_env }),
+        agent_systems: Object.freeze([...input.agent_systems]),
+    });
+}
+//# sourceMappingURL=SessionTurnContext.js.map

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

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

package/bin/session/storage/Metadata.d.ts

@@ -2,59 +2,19 @@
  * SDK Session 元数据辅助。
  *
  * 关键点（中文）
- * - 统一负责 `.downcity/agents/<agentId>/sessions/<sessionId>/messages/meta.json` 的 SDK 字段读写。
+ * - 统一负责 `.downcity/agents/<agent_id>/sessions/<session_id>/messages/meta.json` 的规范化读取。
  * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
  */
-import { type AgentModel } from "../../agent/AgentModel.js";
 import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
-import type { AgentSessionConfigSnapshot } from "../../types/agent/SessionTypes.js";
-/** 刷新 Session metadata 的参数。 */
-export interface TouchSessionMetadataParams {
-    /** 当前项目根目录。 */
-    projectRoot: string;
-    /** 当前 Agent 稳定标识。 */
-    agentId: string;
-    /** 当前 Session 稳定标识。 */
-    sessionId: string;
-    /** 当前 Session configured state。 */
-    sessionConfig: AgentSessionConfigSnapshot;
-    /** 当前 canonical Message 总数。 */
-    message_count?: number;
-    /** 当前 Message 日志总字节数。 */
-    history_bytes?: number;
-    /** 最近一条用户可见 Message 的文本摘要。 */
-    preview_text?: string;
-}
-type ReadSessionMetadataInput = {
-    /**
-     * 项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 当前 agentId。
-     */
-    agentId: string;
-    /**
-     * 当前 sessionId。
-     */
-    sessionId: string;
-};
+import type { FileSystem } from "../../types/workspace/FileSystem.js";
 /**
  * 归一化 session 标题。
  */
-export declare function normalizeSessionTitle(input: unknown): string | undefined;
+export declare function normalize_session_title(input: unknown): string | undefined;
 /**
  * 读取当前系统时区。
  */
-export declare function resolveSystemTimezone(): string;
-/**
- * 从模型实例推导轻量可读标签。
- */
-export declare function inferModelLabel(model: AgentModel | undefined): string | undefined;
-/**
- * 读取当前 session 的 meta.json。
- */
-export declare function readSessionMetadata(input: ReadSessionMetadataInput): Promise<SessionHistoryMetaV1>;
+export declare function resolve_system_timezone(): string;
 /**
  * 从指定路径读取 session meta.json。
  *
@@ -62,33 +22,16 @@ export declare function readSessionMetadata(input: ReadSessionMetadataInput): Pr
  * - 供归档 session 等需要脱离默认 `sessions/` 目录的场景复用。
  * - 路径本身不做校验，调用方需保证可访问。
  */
-export declare function readSessionMetadataFromPath(input: {
+export declare function read_session_metadata_from_path(input: {
     /** meta.json 文件路径。 */
     filePath: string;
-    /** 当前 sessionId。 */
-    sessionId: string;
-    /** 当前 agentId。 */
-    agentId: string;
-}): Promise<SessionHistoryMetaV1>;
-/**
- * 写回当前 session 的 meta.json。
- */
-export declare function writeSessionMetadata(input: ReadSessionMetadataInput & {
-    /**
-     * 下一份 meta 数据。
-     */
-    meta: SessionHistoryMetaV1;
-}): Promise<void>;
-/**
- * 更新当前 session 的 SDK 配置摘要。
- */
-export declare function patchSessionModelLabel(input: ReadSessionMetadataInput & {
-    /**
-     * 当前模型实例。
-     */
-    model?: AgentModel;
+    /** 当前 session_id。 */
+    session_id: string;
+    /** 当前 agent_id。 */
+    agent_id: string;
+    /** 当前 Workspace 的统一文件能力。 */
+    files: FileSystem;
 }): Promise<SessionHistoryMetaV1>;
-/** 根据 canonical Message 统计刷新当前 Session metadata。 */
-export declare function touchSessionMetadata(params: TouchSessionMetadataParams): Promise<void>;
-export {};
+/** 将未知 Metadata 内容规范化为当前 Session 的稳定结构。 */
+export declare function normalize_session_metadata(raw: Partial<SessionHistoryMetaV1>, session_id: string, agent_id: string): SessionHistoryMetaV1;
 //# sourceMappingURL=Metadata.d.ts.map

package/bin/session/storage/Metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Metadata.d.ts","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,+BAA+B;AAC/B,MAAM,WAAW,0BAA0B;IACzC,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,aAAa,EAAE,0BAA0B,CAAC;IAC1C,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,KAAK,wBAAwB,GAAG;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAOF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAwBD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAW/B;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0ChC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,wBAAwB,GAAG;IAChC;;OAEG;IACH,IAAI,EAAE,oBAAoB,CAAC;CAC5B,GACA,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,wBAAwB,GAAG;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAqB/B;AAED,oDAAoD;AACpD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Bf"}
+{"version":3,"file":"Metadata.d.ts","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAOlE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAwBD;;;;;;GAMG;AACH,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAShC;AAED,2CAA2C;AAC3C,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,oBAAoB,CA8BtB"}