@deepseek-ai/dsh-session-persistence 0.2.1-alpha.1 → 0.2.1-alpha.3

package/README.i18n.yaml

@@ -33,8 +33,8 @@
   en: 08b09dce0bcf47c8
   zh: b6c5926d6e440a7b
 /deepseek-ai-dsh-session-persistence/use-this-package/failures-and-recovery:
-  en: 6d8beec038b1121a
-  zh: 1f02952eb2a0b386
+  en: 18a5cfd4cfa07751
+  zh: 0c9bf65c4a40d599
 /deepseek-ai-dsh-session-persistence/understand-the-implementation:
   en: 9e303bd09a71fef1
   zh: 1f631925081ae101

package/README.md

@@ -62,6 +62,8 @@ Persistence returns the physically valid log; semantic repair belongs to the rea
 
 ### Failures and recovery
 
+For versioned artifacts, `stat` and `list` expose `formatStatus` as `current` or `migration-required`. The separate `header` remains current logical metadata. This status describes storage, not an in-memory preparation or migration task; providers without this information omit it.
+
 A stored log the current build cannot faithfully interpret is refused with a direction-aware error, never misread. `SessionHandle` exposes only current logical records identified by `SESSION_FORMAT_VERSION`; a provider must convert any supported historical storage before returning a handle, and the shipped JSONL provider migrates supported historical generations through its static catalog. A newer format instructs the operator to upgrade the harness. An event type unknown to this build refuses unless its envelope marks it `ignorable`, and committed-prefix corruption rejects as `SessionPersistenceCorruptionError`.
 
 -----

package/README.zh.md

@@ -62,6 +62,8 @@ await ctx.sessionPersistence.flush()                           // backend-wide d
 
 ### 失败与恢复
 
+对于版本化产物，`stat` 与 `list` 通过 `formatStatus` 暴露 `current` 或 `migration-required`。独立的 `header` 仍是当前逻辑元数据。该状态描述存储，不描述内存准备或迁移任务；没有这项信息的提供方省略该字段。
+
 当前构建无法忠实解读的存储日志会被拒绝，并返回指明拒绝方向的错误，绝不会被误读。`SessionHandle` 只暴露由 `SESSION_FORMAT_VERSION` 标识的当前逻辑记录；提供方必须在返回句柄前转换任何受支持的历史存储，随产品交付的 JSONL 提供方会通过静态 catalog 迁移受支持的历史代际。更新的格式会要求操作者升级 harness。本构建不认识的事件类型会被拒绝，除非其信封标记为 `ignorable`；已提交前缀中的损坏以 `SessionPersistenceCorruptionError` 拒绝。
 
 -----

package/lib/types/index.d.ts

@@ -22,6 +22,8 @@ export { assertContiguous, assertStoredId, assertVersion, materializeAppendBatch
 export interface SessionPersistenceSnapshot {
     /** Detached metadata for one stored session. */
     readonly header: SessionHeader;
+    /** Header-only format classification; absent without versioned artifact metadata. */
+    readonly formatStatus?: 'current' | 'migration-required';
     /** Opaque change token; see {@link SessionPersistence.stat}. */
     readonly revision: SessionPersistenceRevision;
     /** Logical event count, when the backend can provide it cheaply from metadata; otherwise absent. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-persistence",
   "description": "Abstract durable session persistence seam (ctx.sessionPersistence) for the DeepSeek Harness",
-  "version": "0.2.1-alpha.1",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -27,19 +27,19 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-scope": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.3"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3"
   }
 }