@takboo/dsh-session-bin 0.1.0 → 0.1.1

package/README.md

@@ -12,7 +12,7 @@
 - 删除前展示确认和阻止原因，删除后显示逐项结果；中断或断线后可查询结果并明确继续。
 - 中英文界面，使用宿主控件、浅色和深色主题。
 
-首发版本为 `0.1.0`，包名为 `@takboo/dsh-session-bin`。GitHub Release 提供预编译 tarball；npm 发布由维护者完成，dsh-market 收录另行提交。核心功能已完成跨平台验收；运行证据见 [Host 验证](docs/verification/host-lifecycle.md#跨平台生产删除资格晋级验证)和[客户端验证](docs/verification/client-interface.md#跨平台生产删除客户端验证)。
+当前版本为 `0.1.1`，包名为 `@takboo/dsh-session-bin`。GitHub Release 提供预编译 tarball；npm 通过 trusted publishing 自动发布同一份产物，dsh-market 收录另行提交。核心功能已完成跨平台验收；运行证据见 [Host 验证](docs/verification/host-lifecycle.md#跨平台生产删除资格晋级验证)和[客户端验证](docs/verification/client-interface.md#跨平台生产删除客户端验证)。
 
 ## 界面预览
 
@@ -38,7 +38,7 @@
 
 ```sh
 mise exec -- pnpm exec npm pack --ignore-scripts
-dsh plugin --profile web add ./takboo-dsh-session-bin-0.1.0.tgz
+dsh plugin --profile web add ./takboo-dsh-session-bin-0.1.1.tgz
 ```
 
 以上命令使用已安装的 DSH `0.2.0-rc.2`，将完整插件 bundle 安装到 `web` profile；该路径已通过真实 CLI/GUI 验证。启动或重新启动该 profile 后，从侧栏打开“会话回收站”（Session Bin）。tarball 包含预编译 Host 和 Client，使用者安装时无需编译 TypeScript。
@@ -49,7 +49,7 @@ dsh plugin --profile web add ./takboo-dsh-session-bin-0.1.0.tgz
 dsh plugin --profile web remove @takboo/dsh-session-bin
 ```
 
-也可下载 [v0.1.0 Release](https://github.com/takboo/dsh-session-bin/releases/tag/v0.1.0) 中的 `dsh-session-bin.tgz`，通过同一个 `dsh plugin --profile web add` 命令安装。npm 发布后可使用 `dsh plugin --profile web add @takboo/dsh-session-bin@0.1.0`。
+也可下载 [v0.1.1 Release](https://github.com/takboo/dsh-session-bin/releases/tag/v0.1.1) 中的 `dsh-session-bin.tgz`，通过同一个 `dsh plugin --profile web add` 命令安装。也可从 npm 安装：`dsh plugin --profile web add @takboo/dsh-session-bin@0.1.1`。
 
 如安装过早期未加 scope 的开发包，先从同一 profile 卸载 `dsh-session-bin`，再安装 scoped 包，避免重复注册；原生归档和已有操作记录保留。分发契约见[发布文档](docs/release.md)。
 
@@ -68,7 +68,7 @@ dsh plugin --profile web remove @takboo/dsh-session-bin
 
 **“清空全部归档”包含点击时的全部归档，搜索和工作区筛选不会缩小其范围。** 批量删除固定开始时的对象，后来新增的归档不会加入。
 
-永久删除不可撤销，仅允许已归档、无活动且无未释放读写引用的冷会话；宿主仍加载的会话会被阻止。清除范围是目标会话日志及已声明的会话元数据、索引；共享附件、外部副本和独立 fork 会保留。插件不提供共享附件垃圾回收或安全擦除保证，也不支持自动定期清空、跨设备同步或多 Host 协调。可通过 Host 配置 `permanentDeletion: false` 关闭永久删除，配置说明见 [Host 生命周期](docs/host-lifecycle.md)。
+永久删除不可撤销，仅允许已归档、无活动且无未释放读写引用的冷会话；删除准备会释放由 API Session 激活且确认空闲的目标 Agent，再复核冷会话条件；活动任务、其他所有者的 Agent 和未释放的读写引用仍会阻止删除。清除范围是目标会话日志及已声明的会话元数据、索引；共享附件、外部副本和独立 fork 会保留。插件不提供共享附件垃圾回收或安全擦除保证，也不支持自动定期清空、跨设备同步或多 Host 协调。可通过 Host 配置 `permanentDeletion: false` 关闭永久删除，配置说明见 [Host 生命周期](docs/host-lifecycle.md)。
 
 ## 开发入门
 

package/dist/host/native-retirement-metadata.d.ts

@@ -64,6 +64,9 @@ export declare class NativeMetadataAdapter {
     private readonly targets;
     private readonly retained;
     private readonly followers;
+    private readonly followerStops;
+    private readonly activationTarget;
+    private readonly apiHandles;
     private readonly operations;
     private readonly queueTarget;
     private readonly receivers;
@@ -78,6 +81,7 @@ export declare class NativeMetadataAdapter {
     private readonly queryProvider;
     private readonly cacheTable;
     private readonly cacheDirectory;
+    private readonly agents;
     private moveCacheDocument;
     private clearCacheStage;
     private removeCacheStage;
@@ -90,6 +94,9 @@ export declare class NativeMetadataAdapter {
     private refuse;
     private assertInstances;
     private assertCold;
+    /** Explicit deletion preparation may unload an idle API-owned lifecycle.
+     * No bare registry Agent, foreign handle, or unknown reader is disposed. */
+    releaseIdle(id: string): Promise<void>;
     private cacheView;
     private openCacheDocument;
     private pathAbsent;

package/dist/index.js

@@ -1834,6 +1834,20 @@ async function nativeRetirementSdkFingerprint() {
       if (createHash3("sha256").update(await readFile(join2(dirname(path), file))).digest("hex") !== digest2) return null;
     }
   }
+  const runtime = createRequire(base.resolve("@deepseek-ai/dsh-base/package.json"));
+  for (const [name2, expected] of Object.entries({
+    "dsh-agent": "7b9aa39474de83115cf890dd7f8904cf0d59df0811cb335ab85565a04f1aac93",
+    "dsh-agent-loop": "00c4814d63f3d1e2754eb09144832d19b30499d6ea444730473f740b587948c2"
+  })) {
+    let path;
+    try {
+      path = runtime.resolve(`@deepseek-ai/${name2}/package.json`);
+    } catch (error) {
+      if (error.code === "MODULE_NOT_FOUND") return null;
+      throw error;
+    }
+    if (JSON.parse(await readFile(path, "utf8")).version !== "0.2.0-rc.2" || createHash3("sha256").update(await readFile(join2(dirname(path), "lib/index.js"))).digest("hex") !== expected) return null;
+  }
   return createHash3("sha256").update(JSON.stringify(nativeRetirementSdkSources)).digest("hex");
 }
 
@@ -2448,10 +2462,14 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
     this.queryProvider = !query ? "none" : query.config.openAt === "never" ? "sqlite-memory-disabled-0.2.0-rc.2" : "sqlite-0.2.0-rc.2";
     this.cacheTable = cache?.requireTable();
     this.cacheDirectory = this.cacheTable?.host.unit.dir;
+    this.agents = controller ? _NativeMetadataAdapter.get(ctx, "agents") : void 0;
   }
   targets = /* @__PURE__ */ new Set();
   retained = /* @__PURE__ */ new Map();
   followers = /* @__PURE__ */ new Map();
+  followerStops = /* @__PURE__ */ new Map();
+  activationTarget = new AsyncLocalStorage();
+  apiHandles = /* @__PURE__ */ new Map();
   operations = /* @__PURE__ */ new Map();
   queueTarget = new AsyncLocalStorage();
   receivers = new AsyncLocalStorage();
@@ -2466,6 +2484,7 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
   queryProvider;
   cacheTable;
   cacheDirectory;
+  agents;
   moveCacheDocument = renameWindowsWriteThrough;
   clearCacheStage = async (handle) => {
     await handle.truncate(0);
@@ -2494,7 +2513,7 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
       const disabledMemory = query.config?.openAt === "never" && query.config.path === ":memory:" && query._db === void 0 && query._ready === void 0;
       if (query.constructor.name !== "SqliteSessionQueryEngine" || !enabled && !disabledMemory || typeof query.config?.path !== "string" || !methods(query, ["searchSessions", "listSessions", "observeSession", "_serialized"]) || !(query._observations?.cache instanceof Map) || !methods(query._observations, ["read", "store"])) return void 0;
     }
-    if (controller && (controller.constructor.name !== "SessionController" || !(controller.history?.closeFollowers instanceof Set) || !methods(controller.history, ["page", "follow", "sourceFor"]))) return void 0;
+    if (controller && (controller.constructor.name !== "SessionController" || !(controller.history?.closeFollowers instanceof Set) || !methods(controller.history, ["page", "follow", "sourceFor"]) || controller.agents?.constructor.name !== "ApiSessionAgentController" || !methods(controller.agents, ["resumeObserved", "createOrAdopt"]) || !methods(controller.listState ?? {}, ["summarizeCold"]) || !methods(this.get(ctx, "agents") ?? {}, ["create", "resume", "get"]))) return void 0;
     return new _NativeMetadataAdapter(ctx, admission, workspace, sessions, cache, query, controller);
   }
   assert(id) {
@@ -2533,7 +2552,7 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
     if (this.guardedMethods.some(({ port, name: name2, replacement }) => port[name2] !== replacement)) {
       this.refuse("native/guard-replaced", "A native metadata admission guard was replaced.");
     }
-    if (_NativeMetadataAdapter.get(this.ctx, "workspaceRegistry") !== this.workspace || _NativeMetadataAdapter.get(this.ctx, "sessions") !== this.sessions || _NativeMetadataAdapter.get(this.ctx, "sessionProjectionCache") !== this.cache || _NativeMetadataAdapter.get(this.ctx, "sessionQuery") !== this.query || _NativeMetadataAdapter.get(this.ctx, "sessionController") !== this.controller || this.cache && (this.cache.requireTable() !== this.cacheTable || this.cacheTable.host.unit.dir !== this.cacheDirectory) || this.query && (this.query.config.path !== this.queryConfiguration.path || this.query.config.openAt !== this.queryConfiguration.openAt) || this.queryProvider === "sqlite-memory-disabled-0.2.0-rc.2" && (this.query._db !== void 0 || this.query._ready !== void 0)) {
+    if (_NativeMetadataAdapter.get(this.ctx, "workspaceRegistry") !== this.workspace || _NativeMetadataAdapter.get(this.ctx, "sessions") !== this.sessions || _NativeMetadataAdapter.get(this.ctx, "sessionProjectionCache") !== this.cache || _NativeMetadataAdapter.get(this.ctx, "sessionQuery") !== this.query || _NativeMetadataAdapter.get(this.ctx, "sessionController") !== this.controller || this.controller && _NativeMetadataAdapter.get(this.ctx, "agents") !== this.agents || this.cache && (this.cache.requireTable() !== this.cacheTable || this.cacheTable.host.unit.dir !== this.cacheDirectory) || this.query && (this.query.config.path !== this.queryConfiguration.path || this.query.config.openAt !== this.queryConfiguration.openAt) || this.queryProvider === "sqlite-memory-disabled-0.2.0-rc.2" && (this.query._db !== void 0 || this.query._ready !== void 0)) {
       this.refuse("native/composition-changed", "Native metadata service composition changed.");
     }
   }
@@ -2548,6 +2567,34 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
     if ((this.controller?.history.closeFollowers.size ?? 0) > knownFollowers) this.refuse("native/unknown-follow", "A history follower predates native admission tracking.");
     if (this.cache && [...this.cache.dirty.keys()].some((session) => session.id === id)) this.refuse("native/cache-dirty", "Target cache write-behind is not quiescent.");
   }
+  /** Explicit deletion preparation may unload an idle API-owned lifecycle.
+   * No bare registry Agent, foreign handle, or unknown reader is disposed. */
+  async releaseIdle(id) {
+    this.assertInstances();
+    const handle = this.apiHandles.get(id);
+    if (!handle) return;
+    const agent = handle.agent;
+    const registry = this.agents;
+    if (registry.get(id) !== agent || this.sessions.get(id) !== agent.session) return;
+    const activity = await this.admission.withoutBypass(() => this.ctx.waterfall(
+      "workspace/session-activity",
+      { sessionId: id },
+      async () => []
+    ));
+    if (activity.length || agent.constructor.name !== "ReactLoopAgent" || agent.phase?.kind !== "idle" || agent.status !== "idle" || !Array.isArray(agent.inbox?.nextTurn) || !Array.isArray(agent.inbox?.nextStep) || agent.inbox.nextTurn.length || agent.inbox.nextStep.length) {
+      this.refuse("native/session-active", "Native deletion refuses active or queued work.");
+    }
+    if (!this.workspace.archivedSessionIds.includes(id)) this.refuse("native/not-archived", "Only an archived target may be unloaded.");
+    if (registry.get(id) !== agent || this.sessions.get(id) !== agent.session) this.refuse("native/session-live", "The API lifecycle changed.");
+    await this.admission.bypass(id, async () => {
+      await handle.dispose();
+      for (const stop of [...this.followerStops.get(id) ?? []]) await stop();
+      if (this.cache) await this.cache.requireTable().host.enqueue(async () => void 0);
+      const summary = this.controller.listState.summarizeCold(agent.session.header);
+      this.admission.withoutBypass(() => this.ctx.emit("api-session/added", summary));
+    });
+    this.apiHandles.delete(id);
+  }
   async cacheView(table, id, acceptedStage) {
     table.host.assertReadable();
     if (!/^[a-zA-Z0-9_-]+$/.test(id)) this.refuse("native/cache-key-unsupported", "The pinned cache backend cannot own this record key.");
@@ -2912,19 +2959,54 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
       }
       if (this.controller) {
         const adapter = this;
+        for (const name2 of ["resumeObserved", "createOrAdopt"]) {
+          this.wrap(this.controller.agents, name2, (original) => (id, ...args) => this.tracked(id, () => this.activationTarget.run(id, async () => original(id, ...args))));
+        }
+        const agents = this.agents;
+        for (const name2 of ["create", "resume"]) {
+          this.wrap(agents, name2, (original) => (options, ...args) => {
+            const id = String(name2 === "create" ? options.sessionId : options.resumeSessionId);
+            return this.tracked(id, async () => {
+              const handle = await original(options, ...args);
+              if (this.activationTarget.getStore() === id && options.parentAgent === void 0 && handle.agent.id === id && handle.agent.session.header.origin !== "subagent" && typeof handle.dispose === "function") this.apiHandles.set(id, handle);
+              return handle;
+            });
+          });
+        }
+        this.restores.push(this.ctx.on("agent/disposed", ({ agent }) => {
+          if (this.apiHandles.get(agent.id)?.agent === agent) this.apiHandles.delete(agent.id);
+        }, { global: true }));
         this.wrap(this.controller.history, "follow", (original) => function(request, signal) {
           const id = String(request.address.sessionId);
           adapter.assert(id);
           return (async function* () {
             adapter.assert(id);
             adapter.increment(adapter.followers, id, 1);
+            const cancellation = new AbortController();
+            const iterator = original(request, AbortSignal.any([signal, cancellation.signal]));
+            const stops = adapter.followerStops.get(id) ?? /* @__PURE__ */ new Set();
+            adapter.followerStops.set(id, stops);
+            let finished = false;
+            const finish = () => {
+              if (finished) return;
+              finished = true;
+              adapter.increment(adapter.followers, id, -1);
+              stops.delete(stop);
+              if (!stops.size) adapter.followerStops.delete(id);
+            };
+            const stop = async () => {
+              cancellation.abort();
+              await iterator.return();
+              finish();
+            };
+            stops.add(stop);
             try {
-              for await (const frame of original(request, signal)) {
+              for await (const frame of iterator) {
                 adapter.assert(id);
                 yield frame;
               }
             } finally {
-              adapter.increment(adapter.followers, id, -1);
+              finish();
             }
           })();
         });
@@ -2939,6 +3021,7 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
     return () => closing ??= (async () => {
       this.fallbackRetired = new Set([...this.targets].filter((id) => this.admission.isRetired(id)));
       this.disposed = true;
+      this.apiHandles.clear();
       if (this.fallbackRetired.size === 0) {
         for (const restore of [...this.restores].reverse()) restore();
         this.restores.length = 0;
@@ -2957,6 +3040,7 @@ var NativeMetadataAdapter = class _NativeMetadataAdapter {
     this.restores.length = 0;
     this.guardedMethods.length = 0;
     this.fallbackRetired.clear();
+    this.apiHandles.clear();
   }
   async converge(input, expected, request) {
     const snapshot = nativeMetadataSnapshotSchema.parse(input);
@@ -4088,16 +4172,19 @@ var NativeRetirementOwner = class _NativeRetirementOwner {
   async eligibilityInner(id) {
     if (nativeServiceInstance(this.ctx.sessionPersistence) !== this.originalProvider) return "native/composition-changed";
     if (this.admission.isRetired(id)) return "native/session-retired";
-    if (this.provider.busy(id)) return "native/persistence-retained";
     try {
       const scope = this.scopes.get(id);
       if (scope) {
+        if (this.provider.busy(id)) return "native/persistence-retained";
         if (scope.blocked) return scope.blocked;
         await this.metadata.capture(id);
         return null;
       }
       const release = await this.admission.acquire(id);
       try {
+        await this.metadata.releaseIdle(id);
+        await this.admission.drain(id);
+        if (this.provider.busy(id)) return "native/persistence-retained";
         await this.metadata.capture(id);
         const snapshot = await this.provider.stat(id);
         if (!snapshot) return "session-not-found";