@morlay/session-rdb 0.0.10 → 0.0.12

package/README.md

@@ -5,22 +5,6 @@ RDB（SQLite / PostgreSQL）持久会话后端（`ctx.sessionPersistence`）：
 支持配置选择 SQLite 或 PostgreSQL 后端。设计细节（表结构、delta 过滤、并发写、
 方言差异、仓库结构）见 [docs/design.md](docs/design.md)。
 
-## 安装
-
-包发布在 GitHub Packages，按包名安装到 dsh profile（示例：web；`dsh plugin
-add` 把参数原样转发给 pnpm，版本号按发布版本调整）。registry 必须限定在
-`@morlay` scope（`--config.@morlay:registry=…`），不要用全局 `--registry`，
-否则依赖（`@deepseek-ai/*` 等）也会被指到 GitHub Packages 而解析失败：
-
-```sh
-dsh plugin --profile=web add "@morlay/session-rdb"
-```
-
-GitHub Packages 的 registry 要求认证（公开包也一样）：profile 的 `.npmrc`
-需为 `npm.pkg.github.com` 配置访问 token（如
-`//npm.pkg.github.com/:_authToken=<token>`），详见
-[GitHub 文档](https://docs.github.com/packages/working-with-a-github-packages-registry/working-with-the-npm-registry)。
-
 ## 配置
 
 配置写在 `${DSH_HOME}/settings.yaml`，settings namespace 为插件短名

package/dist/index.d.mts

@@ -0,0 +1,203 @@
+import z from "@deepseek-ai/schemastery";
+import { PersistenceBackend, SessionLocation, SessionPersistence, SessionPersistenceRevision, SessionPersistenceSnapshot, SessionStorageMetadata, StoredPrefix, StoredSuffix } from "@deepseek-ai/dsh-session-persistence";
+import { Session, SessionEvent, SessionHeader, SessionId } from "@deepseek-ai/dsh-session";
+import { BranchAnchorMode, BranchBoundary, ForkFromOptions, SessionBranch, SessionBranchProvider } from "@morlay/session-branch";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/backend.d.ts
+interface SessionRow {
+  fSessionId: string;
+  fHeadEventId: string;
+  fHeadSequence: number;
+  fVersion: number;
+  fCreatedAt: number;
+  fCwd: string | null;
+  fParentSession: string | null;
+  fSeedLength: number | null;
+  fOrigin: string | null;
+  fDelegationDepth: number | null;
+  fIncarnation: string;
+  fRevision: number;
+}
+interface EventInsert {
+  fEventId: string;
+  fParentId: string;
+  fType: string;
+  fKind: string;
+  fRole: string;
+  fName: string;
+  fActionId: string;
+  fEncoding: string;
+  fData: string;
+  fCreatedAt: number;
+}
+interface EventRow {
+  fEventId: string;
+  fSequence: number;
+  fOriginalSeq: number;
+  fType: string;
+  fKind: string;
+  fRole: string;
+  fName: string;
+  fActionId: string;
+  fCreatedAt: number;
+  fData: string;
+  fSurfaceOp: string | null;
+}
+interface BackendTx {
+  upsertSession(storage: SessionStorageMetadata, incarnation: string): Promise<void>;
+  getHead(id: SessionId): Promise<Pick<SessionRow, "fHeadEventId" | "fHeadSequence">>;
+  getSeedLength(id: SessionId): Promise<number | null>;
+  updateSeedLength(id: SessionId, seedLength: number): Promise<void>;
+  insertEvents(events: EventInsert[]): Promise<void>;
+  insertBridges(rows: Array<{
+    fSessionId: SessionId;
+    fEventId: string;
+    fSequence: number;
+    fOriginalSeq: number;
+    fSurfaceOp: string | null;
+  }>): Promise<void>;
+  updateHead(id: SessionId, headEventId: string, headSequence: number): Promise<void>;
+  bumpRevision(id: SessionId): Promise<void>;
+  deleteBridgeTail(id: SessionId, fromSequence: number): Promise<void>;
+  getPrevBridge(id: SessionId, sequence: number): Promise<{
+    fEventId: string;
+    fSequence: number;
+  } | undefined>;
+  getLastBridge(id: SessionId): Promise<{
+    fEventId: string;
+    fSequence: number;
+  } | undefined>;
+}
+interface Backend {
+  readonly kind: "sqlite" | "postgres";
+  readonly storeIdentity: string;
+  open(): Promise<void>;
+  getSession(id: SessionId): Promise<SessionRow | undefined>;
+  getSeqMapRows(id: SessionId): Promise<Array<{
+    fSequence: number;
+    fOriginalSeq: number;
+  }>>;
+  getEventRows(id: SessionId, fromSequence?: number): Promise<EventRow[]>;
+  listSessions(): Promise<SessionRow[]>;
+  transaction<T>(fn: (tx: BackendTx) => Promise<T>): Promise<T>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/write-guard.d.ts
+declare class WriteGuard {
+  private readonly headSeqs;
+  confirmHead(id: SessionId, head: number): void;
+  assertNoConcurrentWriter(id: SessionId, storedHead: number): void;
+}
+//#endregion
+//#region src/schema.d.ts
+declare const SCHEMA_VERSION = 2;
+declare const EPHEMERAL_EVENT_TYPES: readonly ["assistant/chunk"];
+type JournalMode = "wal" | "delete" | "truncate" | "persist";
+//#endregion
+//#region src/branch.d.ts
+declare function locateTurnEnd(events: readonly SessionEvent[], atSeq?: number, mode?: BranchAnchorMode): number;
+interface LiveSessionHooks {
+  getSession(id: SessionId): Session | undefined;
+  getAgent(id: SessionId): LiveAgentLike | undefined;
+  flush(session: Session): Promise<boolean>;
+  setCoordinatorCursor(id: SessionId, cursor: number): void;
+  setCoordinatorState(id: SessionId, cursor: number, meta: SessionHeader): void;
+  setCoordinatorSeedLength(id: SessionId, seedLength: number): void;
+}
+interface LiveAgentLike {
+  session: Session;
+  requestHeaderLogged?: boolean;
+}
+declare class SessionBranchRdbProvider implements SessionBranchProvider {
+  private readonly persistence;
+  private readonly live;
+  readonly name = "session-rdb";
+  constructor(persistence: SessionPersistenceRdb, live?: LiveSessionHooks);
+  readBranchPrefix(id: SessionId, atSeq?: number, mode?: BranchAnchorMode, signal?: AbortSignal): Promise<BranchBoundary>;
+  readRawEvents(id: SessionId, signal?: AbortSignal): Promise<{
+    meta: SessionHeader;
+    events: readonly SessionEvent[];
+  }>;
+  forkFrom(sourceId: SessionId, options?: ForkFromOptions, signal?: AbortSignal): Promise<SessionId>;
+  rewind(id: SessionId, toBoundary: number, signal?: AbortSignal): Promise<SessionPersistenceSnapshot>;
+}
+declare class SessionBranchRdb extends SessionBranch {
+  static inject: string[];
+  constructor(ctx: import("@deepseek-ai/cordis").Context);
+  private readonly provider;
+  readBranchPrefix(id: SessionId, atSeq?: number, mode?: BranchAnchorMode, signal?: AbortSignal): Promise<BranchBoundary>;
+  readRawEvents(id: SessionId, signal?: AbortSignal): Promise<{
+    meta: SessionHeader;
+    events: readonly SessionEvent[];
+  }>;
+  forkFrom(sourceId: SessionId, options?: ForkFromOptions, signal?: AbortSignal): Promise<SessionId>;
+  rewind(id: SessionId, toBoundary: number, signal?: AbortSignal): Promise<SessionPersistenceSnapshot>;
+  syncLiveCursor(sessionId: SessionId): void;
+  timeline(sessionId: SessionId, signal?: AbortSignal): Promise<import("@morlay/session-branch").BranchTimeline>;
+}
+//#endregion
+//#region src/index.d.ts
+interface SessionPersistenceRdbInternals {
+  readonly backend: Backend;
+  readonly writeGuard: WriteGuard;
+  create(meta: SessionHeader, inheritedEventCount?: number): Promise<void>;
+  append(id: SessionId, events: readonly SessionEvent[]): Promise<void>;
+  load(id: SessionId): Promise<import("@deepseek-ai/dsh-session-persistence").SessionInspection>;
+  inspect(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionInspection>;
+  readFrom(id: SessionId, fromSeq: number, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionEventSuffix>;
+  listSnapshots(signal?: AbortSignal): Promise<SessionPersistenceSnapshot[]>;
+  readStoredRevision(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionPersistenceRevision | undefined>;
+  registerReuseEventIds(childId: SessionId, map: ReadonlyMap<number, string>): void;
+}
+type Config = {
+  type: "sqlite";
+  path: string;
+  journalMode?: JournalMode;
+  busyTimeout?: number;
+} | {
+  type: "postgres";
+  connectionString: string;
+  schema?: string;
+};
+declare class SessionPersistenceRdb extends SessionPersistence implements PersistenceBackend<number> {
+  config: Config;
+  static inject: string[];
+  static Config: z<Config>;
+  static readonly settingsNs = "session-rdb";
+  readonly name = "session-rdb";
+  readonly supportsRawArtifacts = true;
+  readRaw(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionRawArtifact | undefined>;
+  private readonly backend;
+  private storeIdentity;
+  private readonly ready;
+  private readonly coordinator;
+  private readonly writeGuard;
+  private readonly reuseEventIds;
+  constructor(ctx: Context, config: Config, injectedBackend?: Backend);
+  private init;
+  locate(_meta: SessionHeader): SessionLocation | undefined;
+  create(meta: SessionHeader, inheritedEventCount?: number): Promise<void>;
+  append(id: SessionId, events: readonly SessionEvent[]): Promise<void>;
+  load(id: SessionId): Promise<import("@deepseek-ai/dsh-session-persistence").SessionInspection>;
+  inspect(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionInspection>;
+  readFrom(id: SessionId, fromSeq: number, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionEventSuffix>;
+  borrowSession(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").BorrowedSessionSource>;
+  loadStored(id: SessionId, signal?: AbortSignal): Promise<StoredPrefix<number> | undefined>;
+  loadStoredFrom(id: SessionId, fromSeq: number, signal?: AbortSignal): Promise<StoredSuffix | undefined>;
+  private readPrefix;
+  readStoredRevision(id: SessionId, signal?: AbortSignal): Promise<SessionPersistenceRevision | undefined>;
+  private readLog;
+  appendBatch(storage: SessionStorageMetadata, events: readonly SessionEvent[], _isMaterialized: boolean): Promise<void>;
+  commitRepair(storage: SessionStorageMetadata, tornMarker: number | undefined, closers: readonly SessionEvent[]): Promise<void>;
+  list(signal?: AbortSignal): Promise<SessionHeader[]>;
+  listSnapshots(signal?: AbortSignal): Promise<Array<SessionPersistenceSnapshot & {
+    inheritedEventCount: number;
+  }>>;
+  close(): Promise<void>;
+  registerReuseEventIds(childId: SessionId, map: ReadonlyMap<number, string>): void;
+  internals(): SessionPersistenceRdbInternals;
+}
+//#endregion
+export { Config, EPHEMERAL_EVENT_TYPES, SCHEMA_VERSION, SessionBranchRdb, SessionBranchRdbProvider, SessionPersistenceRdb, SessionPersistenceRdb as default, SessionPersistenceRdbInternals, locateTurnEnd };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/backend.ts","../src/write-guard.ts","../src/schema.ts","../src/branch.ts","../src/index.ts"],"mappings":"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"}