[Question]: 2.0.x 用户后续直接升级到 2.1 是否支持平滑升级？/ Is 2.0.x -> 2.1 intended to be a smooth upgrade? #3462

问题 / Question

我们目前在生产使用 2.0.4（HarnessAgent + MysqlAgentStateStore + RemoteFilesystemSpec + 沙箱）。看到 main 已经是 2.1.0-SNAPSHOT、并发布了 v2.1.0-BETA1，而 2.0.x 分支目前只有 2.0.5-SNAPSHOT 的版本号准备提交。

想确认：后续从 2.0.x 直接升级到 2.1，是否会提供平滑升级路径？

I'd like to confirm whether upgrading directly from 2.0.x to 2.1 is intended to be a smooth upgrade for existing 2.0.x users, and what the planned migration path is.

对比 v2.0.4 与 v2.1.0-BETA1 后看到的不兼容点

以下是读源码 diff 的发现（没有实际在 2.1 上做完整回归，若有误请指正）：

1. HarnessAgent 默认会话持久化改为 EVENT_LOG（SessionHistoryMode）
   • 2.0.4 靠 AgentStateStore（如 MysqlAgentStateStore）恢复会话；2.1 默认走 SessionLogStore，AgentStateStore 不再是该会话的恢复依据（context.md：「Direct AgentStateStore edits do not affect native sessions」）。
   • 直接读取 stateStore.get(userId, sessionId, "agent_state", AgentState.class) 的应用（例如读取挂起的 ask-user / external tool 状态）在默认模式下会读不到新数据。
   • HarnessAgent.Builder 的注释写到 "Existing snapshots require explicit migration"。
   • getAgentState() / saveAgentState() 在 EVENT_LOG 下变为带 writer lease 与版本检查的 checkpoint，过期快照会被拒绝。
2. Transcript / SessionTree 相关 API 被整体删除：SessionTree（含 awaitMirrorQuiescence）、SessionEntry、SessionTranscriptWriter、TranscriptMiddleware、TranscriptStore/TranscriptRef、FilesystemTranscriptStore、ObjectStoreTranscriptStore，以及 HarnessAgent.Builder#transcriptStore/transcriptTenant。
3. 配置项被移除：MemoryConfig.Builder#sessionRetentionDays(int)、CompactionConfig.Builder#offloadBeforeCompact(boolean)。原先靠它们做会话日志清理 / 压缩前卸载，升级后没有看到对应的替代说明（文档里写「Retention and archiving belong to the deployment」）。
4. agentscope-extensions-aistio 重命名为 agentscope-extensions-controlplane（包名、类名同步变化）。
5. TaskContextState 构造器签名变化。

想请教

1. 2.0.x → 2.1 是否承诺平滑升级？还是说 2.1 属于有不兼容变更的 minor 版本，需要按迁移指南改造？
2. 对已有 2.0.x 线上会话数据（AgentStateStore 里的 agent_state），是否有官方推荐的迁移方式？（我看到 SessionMigration，但文档主要讲 fork / 新会话基线导入，是否适用于存量数据批量迁移？）
3. legacySessionHistory(true) / SessionHistoryMode.LEGACY 是否会长期保留？计划保留到哪个版本？在 LEGACY 模式下，被删除的 sessionRetentionDays / offloadBeforeCompact / SessionTree 对应能力是否有替代？
4. 2.0.x 分支（2.0.5）的维护计划与时间窗口大概是怎样的？是否会回合 main 上的相关修复（例如 fix(core): stop fabricating tool results for suspended external tool calls #3435 「stop fabricating tool results for suspended external tool calls」）？
5. 是否会在 2.1 正式版发布前提供一份 2.0.x → 2.1 的迁移指南（类似现有 change-log.md 里 1.x → 2.0 那份）？

谢谢！