@morlay/better-session 0.0.10 → 0.0.12

package/README.md

@@ -0,0 +1,64 @@
+# @morlay/better-session
+
+profile 聚合 bundle：一次性装配 `@morlay/session-branch`、
+`@morlay/session-rdb`、`@morlay/ui-conversation-message-actions` 到
+DeepSeek Harness web profile，提供 **就地编辑 / 重试 / 分支**
+（rewind / retry / fork）闭环。
+
+## 安装
+
+```sh
+dsh plugin --profile web add "@morlay/better-session"
+```
+
+安装自动带上子包（`@morlay/session-branch`、`@morlay/session-rdb`、
+`@morlay/ui-conversation-message-actions`），并由 bundle 的 patch
+（`cordis.patch.yml`）自动装配：
+
+- `ctx.sessionPersistence` ← RDB（SQLite / PostgreSQL）持久化后端
+- `ctx.sessionBranch` ← rewind / fork 数据层
+- `ctx.sessionEditor` ← edit / retry / fork 编排（HTTP：`/session-editor`）
+- `conversation.chat.node` ← 渲染替换（user 消息行内编辑 / 重试按钮）
+
+## 使用
+
+装配后即可在 GUI 会话中：
+
+- **编辑** user 消息 → 就地重写并重放（重新生成回复）
+- **重试** 任意闭合回合 → 就地重放该回合输入（带确认弹窗）
+- **分支**（fork）→ 从任意闭合边界派生**新会话**
+
+也可以直接调用服务：
+
+```ts
+// 编排层（host）
+await ctx.sessionEditor.retry({ action: "retry", sessionId, turn: 2, cascade: "truncate" });
+// 数据层
+await ctx.sessionBranch.rewind(sessionId, 5);
+await ctx.sessionBranch.forkFrom(sourceId, { atSeq: 6, childSessionId });
+```
+
+## 配置（rdb）
+
+默认配置为 SQLite（`$DSH_HOME/sessions/sessions.sqlite`）。在
+`$DSH_HOME/settings.yaml` 覆盖 `session-rdb` namespace：
+
+```yaml
+session-rdb:
+  type: sqlite # 或 postgres + connectionString
+  path: /abs/path/to/sessions.sqlite
+```
+
+## 本地开发
+
+本包是 monorepo（pnpm workspaces）的一员，命令入口见根 [justfile](../../justfile)：
+
+```sh
+just dep      # 安装依赖
+just build    # 构建全部包（tsdown）
+just test     # vitest（含 PostgreSQL 契约测试，需 TEST_PG_URL）
+just lint     # oxlint
+```
+
+架构与约定见 [docs/ARCHITECTURE.md](../../docs/ARCHITECTURE.md) 与
+[docs/CODING_GUIDELINE.md](../../docs/CODING_GUIDELINE.md)。

package/dist/invariant.d.mts

@@ -0,0 +1,8 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/invariant.d.ts
+declare const name = "web-app-invariant";
+declare const inject: string[];
+declare const apply: (ctx: Context) => Promise<() => void>;
+//#endregion
+export { apply, inject, name };
+//# sourceMappingURL=invariant.d.mts.map

package/dist/invariant.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.mts","names":[],"sources":["../src/invariant.ts"],"mappings":";;cAKa;cAEA;cAIA,QAAK,KAAS,YAAU"}

package/dist/invariant.mjs

@@ -0,0 +1,10 @@
+//#region src/invariant.ts
+const PACKAGE_NAME = "@morlay/better-session";
+const name = "web-app-invariant";
+const inject = ["invariants"];
+const install = () => {};
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };
+
+//# sourceMappingURL=invariant.mjs.map

package/dist/invariant.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.mjs","names":[],"sources":["../src/invariant.ts"],"sourcesContent":["import type { Context } from \"@deepseek-ai/cordis\";\nimport type { InvariantInstaller } from \"@deepseek-ai/dsh-invariants\";\n\nconst PACKAGE_NAME = \"@morlay/better-session\";\n\nexport const name = \"web-app-invariant\";\n\nexport const inject = [\"invariants\"];\n\nconst install: InvariantInstaller = () => {};\n\nexport const apply = (ctx: Context): Promise<() => void> =>\n  Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));\n"],"mappings":";AAGA,MAAM,eAAe;AAErB,MAAa,OAAO;AAEpB,MAAa,SAAS,CAAC,YAAY;AAEnC,MAAM,gBAAoC,CAAC;AAE3C,MAAa,SAAS,QACpB,QAAQ,QAAQ,IAAI,WAAW,SAAS,cAAc,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/better-session",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "Example dsh profile bundle: assembles @morlay/session-rdb and @morlay/ui-conversation-message-actions into a web profile — rewind / retry / fork closed loop on RDB persistence.",
   "keywords": [
     "dsh",
@@ -17,31 +17,32 @@
     "url": "https://github.com/morlay/better-session.git"
   },
   "files": [
+    "dist",
+    "src",
     "cordis.patch.yml",
-    "README.md"
+    "!**/__tests__"
   ],
   "type": "module",
   "exports": {
-    "./invariant": {
-      "types": "./lib/invariant.d.mts",
-      "default": "./lib/invariant.mjs"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
+    ".": "./dist/invariant.mjs",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
   },
   "dependencies": {
-    "@morlay/session-branch": "^0.0.10",
-    "@morlay/session-rdb": "^0.0.10",
-    "@morlay/ui-conversation-message-actions": "^0.0.10"
+    "@morlay/session-branch": "^0.0.2",
+    "@morlay/session-rdb": "^0.0.12",
+    "@morlay/ui-conversation-message-actions": "^0.0.12"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6"
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-rc.1"
   },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
     }
   },
-  "scripts": {}
+  "scripts": {
+    "build": "pnpm exec tsdown"
+  }
 }

package/src/invariant.ts

@@ -0,0 +1,13 @@
+import type { Context } from "@deepseek-ai/cordis";
+import type { InvariantInstaller } from "@deepseek-ai/dsh-invariants";
+
+const PACKAGE_NAME = "@morlay/better-session";
+
+export const name = "web-app-invariant";
+
+export const inject = ["invariants"];
+
+const install: InvariantInstaller = () => {};
+
+export const apply = (ctx: Context): Promise<() => void> =>
+  Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));