docs(session): document creation ownership boundaries

2026-08-05 00:24:26 +08:00
parent c02871b910
commit 1832df038d
12 changed files with 42 additions and 20 deletions
--- a/packages/core/session/src/index.ts
+++ b/packages/core/session/src/index.ts
@@ -455,8 +455,8 @@ export class Session {
  readonly firstLiveSeq: number

  /**
-   * Create a detached session with the same validation and snapshot semantics
-   * formerly provided by direct construction.
+   * Create a detached session by validating and snapshotting borrowed seed
+   * events and storage metadata.
   * @param id - session identity.
   * @param seed - optional borrowed replay or fork events.
   * @param header - optional borrowed storage metadata.