@x1a0f3n9/dsh-session-persistence 0.1.5-rc.4 → 0.1.7-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.i18n.yaml CHANGED
@@ -1,6 +1,79 @@
1
- # Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
2
- # side as of the last confirmed-consistent state. Both languages carry equal authority;
3
- # after editing either side, bring the other along and re-record with:
1
+ # Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
2
+ # section, a hash of its English and Chinese blocks outside code blocks and generated regions.
3
+ # After editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/session/session-persistence/README.md
5
- README.md: 16111343b95b9598417d91ee1836783371e8c209
6
- README.zh.md: 16f631cff6e1979f733de2261fe5c1020a1933ff
5
+ /:
6
+ en: 99acbd5c1e2a16ce
7
+ zh: 31342508a4e1bf09
8
+ /x1a0f3n9-dsh-session-persistence:
9
+ en: 32b6f9d3ae040cb3
10
+ zh: d2cef0ca9eed67e2
11
+ /x1a0f3n9-dsh-session-persistence/summary:
12
+ en: 31d5eec7694aa83f
13
+ zh: b91ea5b6daaec8a5
14
+ /x1a0f3n9-dsh-session-persistence/table-of-contents:
15
+ en: d152484eb41ac6b4
16
+ zh: 09388d293f9be9cb
17
+ /x1a0f3n9-dsh-session-persistence/use-this-package:
18
+ en: bd48e96d14122170
19
+ zh: f8a06e7246b55a6f
20
+ /x1a0f3n9-dsh-session-persistence/use-this-package/choosing-a-backend:
21
+ en: 170892270261aae0
22
+ zh: 7daf1edd4f764409
23
+ /x1a0f3n9-dsh-session-persistence/use-this-package/what-the-service-provides:
24
+ en: c10b9c7d9bad305c
25
+ zh: 0e9c391e9df37da6
26
+ /x1a0f3n9-dsh-session-persistence/use-this-package/ownership-and-visibility:
27
+ en: 16d4abbb05a67360
28
+ zh: fc91863169570795
29
+ /x1a0f3n9-dsh-session-persistence/use-this-package/the-live-write-path-and-shutdown-drain:
30
+ en: 282c5bc8a391159f
31
+ zh: 96682e345ef301f6
32
+ /x1a0f3n9-dsh-session-persistence/use-this-package/resuming-and-crash-recovery:
33
+ en: 08b09dce0bcf47c8
34
+ zh: b6c5926d6e440a7b
35
+ /x1a0f3n9-dsh-session-persistence/use-this-package/failures-and-recovery:
36
+ en: 6d8beec038b1121a
37
+ zh: 1f02952eb2a0b386
38
+ /x1a0f3n9-dsh-session-persistence/understand-the-implementation:
39
+ en: 9e303bd09a71fef1
40
+ zh: 1f631925081ae101
41
+ /x1a0f3n9-dsh-session-persistence/understand-the-implementation/design-concept:
42
+ en: 3d21cded1f7e74ff
43
+ zh: 5f624aefebb1f63d
44
+ /x1a0f3n9-dsh-session-persistence/understand-the-implementation/the-invariants-every-backend-honors:
45
+ en: ab77c11245363282
46
+ zh: 8f3d08304c967325
47
+ /x1a0f3n9-dsh-session-persistence/understand-the-implementation/source-map:
48
+ en: 3868942fde28ff0a
49
+ zh: 865208afd7d04b49
50
+ /x1a0f3n9-dsh-session-persistence/understand-the-implementation/the-write-path-at-a-glance:
51
+ en: c920cf9262f4a563
52
+ zh: 0f8e3ff17e39c861
53
+ /x1a0f3n9-dsh-session-persistence/understand-the-implementation/stored-record-validation:
54
+ en: b93ec8187f7f86b0
55
+ zh: 578aa5c6cadafd5a
56
+ /x1a0f3n9-dsh-session-persistence/further-exploration:
57
+ en: eae3982f64497a9c
58
+ zh: bfca52edcaeff828
59
+ /x1a0f3n9-dsh-session-persistence/model-experience:
60
+ en: 215e7ba838619b7b
61
+ zh: a311da3843709f90
62
+ /x1a0f3n9-dsh-session-persistence/model-experience/resumed-conversation-history:
63
+ en: 062875aab7f3f138
64
+ zh: c7285918227e6f5c
65
+ /x1a0f3n9-dsh-session-persistence/model-experience/resumed-conversation-history/what-the-model-sees:
66
+ en: f697ddcf1a13c439
67
+ zh: a3b5050484be4b9b
68
+ /x1a0f3n9-dsh-session-persistence/model-experience/resumed-conversation-history/token-effect:
69
+ en: 375253768652244e
70
+ zh: c5bf6c3dcf707ab2
71
+ /x1a0f3n9-dsh-session-persistence/model-experience/resumed-conversation-history/kv-cache-effect:
72
+ en: 70a8139de5fd1cec
73
+ zh: 66dfba4b93e63c55
74
+ /x1a0f3n9-dsh-session-persistence/known-limitations-and-deferred-work:
75
+ en: 97296c31399996e4
76
+ zh: 86a5c1e771415e99
77
+ /x1a0f3n9-dsh-session-persistence/known-limitations-and-deferred-work/dev-note:
78
+ en: e67f633dc6fe7773
79
+ zh: 3bb0c20c93f16f98
package/lib/index.js CHANGED
@@ -261,6 +261,8 @@ function assertContiguous(id, events, cursor) {
261
261
  * on this backend instance observe at least that prefix.
262
262
  */
263
263
  var SessionPersistence = class extends Service {
264
+ /** Process-local instance identity, stable through Context proxies and distinct after service replacement. */
265
+ identity = Symbol("sessionPersistence");
264
266
  constructor(ctx) {
265
267
  super(ctx, "sessionPersistence");
266
268
  }
@@ -60,6 +60,12 @@ export interface SessionInspection extends SessionStorageMetadata {
60
60
  export interface SessionPersistenceOpenOptions {
61
61
  /** Optional cancellation observed before backend work starts. */
62
62
  readonly signal?: AbortSignal;
63
+ /**
64
+ * Receive each current-generation event while opening instead of retaining
65
+ * the complete log on the handle. Backends that cannot stream ignore this
66
+ * and callers fall back to `SessionHandle.read(0)`.
67
+ */
68
+ readonly adoptEvent?: (event: SessionEvent) => void;
63
69
  }
64
70
  /** Options for {@link SessionPersistence.stat}. */
65
71
  export interface SessionPersistenceStatOptions {
@@ -124,6 +130,8 @@ declare module '@deepseek-ai/cordis' {
124
130
  * on this backend instance observe at least that prefix.
125
131
  */
126
132
  export declare abstract class SessionPersistence extends Service {
133
+ /** Process-local instance identity, stable through Context proxies and distinct after service replacement. */
134
+ readonly identity: symbol;
127
135
  constructor(ctx: Context);
128
136
  /**
129
137
  * Create a new stored session and take its write ownership.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@x1a0f3n9/dsh-session-persistence",
3
3
  "description": "Abstract durable session persistence seam (ctx.sessionPersistence) for the DeepSeek Harness",
4
- "version": "0.1.5-rc.4",
4
+ "version": "0.1.7-rc.2",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -27,19 +27,19 @@
27
27
  ],
28
28
  "license": "MIT",
29
29
  "peerDependencies": {
30
- "@deepseek-ai/cordis": "^4.0.2",
31
- "@x1a0f3n9/dsh-brand": "^0.1.5-rc.4",
32
- "@x1a0f3n9/dsh-session": "^0.1.5-rc.4",
33
- "@x1a0f3n9/dsh-timeout": "^0.1.5-rc.4"
30
+ "@deepseek-ai/cordis": "~4.0.4",
31
+ "@x1a0f3n9/dsh-brand": "0.1.7-rc.2",
32
+ "@x1a0f3n9/dsh-session": "0.1.7-rc.2",
33
+ "@x1a0f3n9/dsh-timeout": "0.1.7-rc.2"
34
34
  },
35
35
  "devDependencies": {
36
- "@deepseek-ai/cordis": "^4.0.2",
37
- "@x1a0f3n9/dsh-brand": "^0.1.5-rc.4",
38
- "@x1a0f3n9/dsh-scope": "^0.1.5-rc.4",
39
- "@x1a0f3n9/dsh-session": "^0.1.5-rc.4",
40
- "@x1a0f3n9/dsh-timeout": "^0.1.5-rc.4"
36
+ "@deepseek-ai/cordis": "~4.0.4",
37
+ "@x1a0f3n9/dsh-brand": "0.1.7-rc.2",
38
+ "@x1a0f3n9/dsh-scope": "0.1.7-rc.2",
39
+ "@x1a0f3n9/dsh-session": "0.1.7-rc.2",
40
+ "@x1a0f3n9/dsh-timeout": "0.1.7-rc.2"
41
41
  },
42
42
  "dependencies": {
43
- "@x1a0f3n9/dsh-util-values": "^0.1.5-rc.4"
43
+ "@x1a0f3n9/dsh-util-values": "0.1.7-rc.2"
44
44
  }
45
45
  }