@zhushanwen/pi-pending-notifications 0.7.7 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-pending-notifications",
-  "version": "0.7.7",
+  "version": "0.8.1",
   "description": "Cross-extension async operation registration/query mechanism for Pi.",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "typebox": "*"
   },
   "dependencies": {
-    "@zhushanwen/extension-protocol": "0.14.0",
+    "@zhushanwen/extension-protocol": "0.17.0",
     "@zhushanwen/pi-extension-logger": "0.6.1"
   },
   "scripts": {

package/src/__tests__/pending-notifications.test.ts

@@ -143,13 +143,16 @@ function makeUnregisterEntry(id: string): MockSessionEntry {
 
 describe("state pure functions", () => {
 	describe("normalizePendingType", () => {
-		it("subagent/bash 直通，其余（缺失/未知/大小写不符）归 workflow", () => {
+		it("subagent/bash/session 直通，其余（缺失/未知/大小写不符）归 workflow", () => {
 			expect(normalizePendingType("subagent")).toBe("subagent");
 			expect(normalizePendingType("bash")).toBe("bash");
 			expect(normalizePendingType("workflow")).toBe("workflow");
+			// notify-once D6：词表真身在此（写侧归一成 workflow 会展示错标 [workflow]）
+			expect(normalizePendingType("session")).toBe("session");
 			expect(normalizePendingType(undefined)).toBe("workflow");
 			expect(normalizePendingType("scheduler")).toBe("workflow");
 			expect(normalizePendingType("Bash")).toBe("workflow");
+			expect(normalizePendingType("Session")).toBe("workflow");
 		});
 	});
 });

package/src/index.ts

@@ -29,7 +29,7 @@
  * - subagent-core worker-message-pump.ts finalizeRun（reload-closeout D4：workflow
  *   run 终态注销直落，emit 发射点已删——reload 转换窗/factory 顺序窗内 emit 丢失
  *   即注销 entry 永缺位）；
- * - subagent-core round-supervisor/reconcile-sweep.ts（对账 sweep 补注销，对账走
+ * - subagent-core registry-reconcile/reconcile-sweep.ts（对账 sweep 补注销，对账走
  *   appendEntry 权威路径，不经 emit）；
  * - base-tool-enhance pending-reconcile.ts（session_start 对账，同款）。
  *
@@ -225,7 +225,7 @@ export default function pendingNotificationsExtension(pi: ExtensionAPI): void {
 		name: "pending_notifications",
 		label: "Pending Notifications",
 		description:
-			"查询当前活跃的异步操作（workflow/subagent/bash 后台任务）。action=count 返回数量；action=list 返回列表。状态由 EventBus + session entries 维护，无需手动注册。",
+			"查询当前活跃的异步操作（workflow/subagent/bash 后台任务与 session（managed session 债权））。action=count 返回数量；action=list 返回列表。状态由 EventBus + session entries 维护，无需手动注册。",
 		parameters: PendingNotificationsParams,
 		execute: async (_toolCallId: string, params: { action: "count" | "list" }, _signal: AbortSignal | undefined, _onUpdate: unknown, ctx: ExtensionContext): Promise<{ content: { type: "text"; text: string }[]; details: PendingToolDetails }> => {
 			// entries 现算（单一权威源）：与 goal/subagent-workflow 同一原语。跨 session

package/src/state.ts

@@ -16,14 +16,14 @@
  *   重建、TTL 与 shutdown 机器已删除）——「落盘了什么」与「查询到什么」共用同一份扫描，
  *   结构上不可分歧
  * - 纯函数，不依赖 Pi 运行时（ExtensionAPI/appendEntry），可独立单元测试
- * - 差集刻意不校验 expiresAt（三类型全 process 档，长任务 >1h 仍应视为活跃，
+ * - 差集刻意不校验 expiresAt（四类型（workflow/subagent/bash/session）全 process 档，长任务 >1h 仍应视为活跃，
  *   对齐 goal continuation 守卫语义）；历史 session 文件中遗留的带 expiresAt 的
  *   register entry 无需迁移——差集语义不读该键
  */
 import { applyPendingDiff, scanPendingEntries } from "@zhushanwen/extension-protocol";
 
-/** 异步操作类型（来源：workflow / subagent / bash 后台任务） */
-export type PendingType = "workflow" | "subagent" | "bash";
+/** 异步操作类型（来源：workflow / subagent / bash 后台任务 / session 完成通知债权） */
+export type PendingType = "workflow" | "subagent" | "bash" | "session";
 
 /** 异步操作终态/过渡状态。active = 仍在运行；其他都视为已结束 */
 export type PendingStatus = "active" | "completed" | "failed" | "cancelled" | "expired" | "time_limited" | "aborted";
@@ -46,7 +46,7 @@ export interface PendingEntry {
 
 /** countActiveFromEntries 的过滤选项。 */
 export interface CountActiveOptions {
-	/** 只统计指定类型的活跃 pending；缺省 = 全部类型（subagent + workflow + bash） */
+	/** 只统计指定类型的活跃 pending；缺省 = 全部类型（subagent + workflow + bash + session） */
 	types?: PendingType[];
 	/**
 	 * [跨 session 残留过滤] 当前 session id（过滤基准）：传入时按「register entry 的
@@ -143,18 +143,22 @@ function filterActiveRegisters(
 }
 
 /**
- * type 归一化：subagent/bash 原样保留，其余（含缺失/未知值）归 workflow。
+ * type 归一化：subagent/bash/session 原样保留，其余（含缺失/未知值）归 workflow。
  * state.ts 与 index.ts 两处归一化共用本函数，防止「写入侧直通、读取侧归并」漂移。
  *
  * [偏好显式化] 缺失/未知 type 默认归 workflow = 宁挂账不失明：未知类型照常进差集
  * （守卫不因类型畸形失明），收口通道按类型分流——workflow / 畸形条目由 core 注册
  * 对账 sweep 收口（查 WorkflowRun store：终态 ∪ state 文件不存在 → 补注销）；bash 无
  * record/store 可查——注册随进程退出注销，进程死亡窗口的丢失无补发通道，属显式
- * 边界（每孤儿 bash 注册至多 1 条静态虚报，熔断限损）。
+ * 边界（每孤儿 bash 注册至多 1 条静态虚报，熔断限损）；session（notify-once D6
+ * 词表真身在此——否则写侧归一成 workflow 展示错标）由 watch 应答 unregister 与
+ * extension session_start 重启收口腿（D7③）收口，reconcile-sweep 对该 raw type
+ * 显式 skip（不入 workflow run-state 判据，防误销活跃 claim）。
  */
 export function normalizePendingType(raw: unknown): PendingType {
 	if (raw === "subagent") return "subagent";
 	if (raw === "bash") return "bash";
+	if (raw === "session") return "session";
 	return "workflow";
 }