@zhushanwen/pi-smart-context 0.4.2 → 0.4.4

package/README.md

@@ -10,7 +10,7 @@
   - cross-model：调用 pi 原生 `compact()` 仅换模型与凭证——split-turn / fileOps / previousSummary 原生组装
 - **3 档阈值提醒**（默认 400K/500K/600K）：`agent_settled` 越档检查，每档一次、多档合并、压缩后重置，nextTurn 投递（随下一次 prompt 注入，不自起 run）；已提醒档位经 `pi.appendEntry` 落在 session entries（`smart-context:fired`），reload / 进程重启后从 entries 重建，同一档不会重复提醒；措辞是数据投递不是指令
 - **排除模型**（精准 `provider/modelId` 匹配）：工具拒绝 + 不提醒 + 回落 pi 原生生成；切换跨界时注入一条可用性通知，downshift（切小窗模型将触线）时建议先压缩
-- **通知车道**：压缩结果 / 阈值提醒 / 模型切换四类通知统一走 nextTurn（custom role 随下次 prompt 注入，不自起 run）——工具压缩掐断的 turn 由 taiji runtime 在 `compaction_end` 判定后经投递内核追加续跑投递
+- **通知投递路径**：压缩结果 / 阈值提醒 / 模型切换四类通知统一走 nextTurn（custom role 随下次 prompt 注入，不自起 run）——工具压缩掐断的 turn 由 taiji runtime 在 `compaction_end` 判定后经投递内核追加续跑投递
 - **健壮性**：摘要收缩校验、max-tokens 截断 fail-closed、接管失败 3 次熔断（本 session 内停止接管）、transcript 回查指针、压缩后最近文件内容重注入（≤5 文件/50K）、多轮压缩降智提示（累计压缩 ≥2 次后附加）
 - **subagent 进程**自动静默（`TAIJI_AGENT_SUBAGENT` 标记）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-smart-context",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "type": "module",
   "main": "index.ts",
   "taiji": {
@@ -36,8 +36,8 @@
     "pi-package"
   ],
   "dependencies": {
-    "@zhushanwen/extension-protocol": "0.23.0",
     "@zhushanwen/pi-ext-guards": "0.5.0",
+    "@zhushanwen/extension-protocol": "0.26.0",
     "@zhushanwen/pi-extension-logger": "0.6.2",
     "@zhushanwen/pi-llm-shared": "0.12.0"
   },
@@ -72,7 +72,7 @@
     }
   },
   "scripts": {
-    "test": "vitest run",
+    "test": "vitest run --pool=threads",
     "test:watch": "vitest"
   }
 }

package/src/__tests__/tool.test.ts

@@ -128,7 +128,7 @@ describe("compact_context 工具（R2 降级态：fire-and-forget + 结果注入
 		await tools[0].execute("t1", {}, undefined, undefined, makeCtx());
 		expect(pi.sendMessage).toHaveBeenCalledTimes(1);
 		const [message, options] = pi.sendMessage.mock.calls[0];
-		// D4①：nextTurn 化——custom role 消息 + 不自起 run 的投递车道
+		// D4①：nextTurn 化——custom role 消息 + 不自起 run 的投递路径
 		expect(message.customType).toBe("smart-context");
 		expect(message.details).toEqual({ source: "compact-complete" });
 		expect(options).toEqual({ triggerTurn: false, deliverAs: "nextTurn" });
@@ -138,7 +138,7 @@ describe("compact_context 工具（R2 降级态：fire-and-forget + 结果注入
 		expect(text).toContain("500K");
 		expect(text).toContain("24K");
 		expect(text).toContain("compacted multiple times");
-		// 旧车道（自起 run 的 user 消息）已退役：不再调用 sendUserMessage（mock 挂 spy，被调用即断言红）
+		// 旧投递路径（自起 run 的 user 消息）已退役：不再调用 sendUserMessage（mock 挂 spy，被调用即断言红）
 		expect(pi.sendUserMessage).not.toHaveBeenCalled();
 	});
 
@@ -151,7 +151,7 @@ describe("compact_context 工具（R2 降级态：fire-and-forget + 结果注入
 		expect(pi.sendMessage.mock.calls[0][0].content).toContain("回退");
 	});
 
-	it("onError → 注入失败消息带重试指引（display:true 失败必须用户可见 + nextTurn 车道不自起 run）", async () => {
+	it("onError → 注入失败消息带重试指引（display:true 失败必须用户可见 + nextTurn 投递路径不自起 run）", async () => {
 		const { pi, tools } = makePi();
 		registerCompactContextTool(pi);
 		const ctx = makeCtx((options) => options.onError(new Error("Nothing to compact")));

package/src/index.ts

@@ -9,7 +9,7 @@
  * - agent_settled：越档检查 + marker 持久化（D15）+ nextTurn 投递一次性提醒（D3/D4①）
  * - model_select：跨界通知 + downshift 提醒（D5/D4①）
  *
- * 通知注入车道（D4①，delivery-ownership-kernel）：四类通知全部经 notices.ts 的
+ * 通知投递路径（D4①，delivery-ownership-kernel）：四类通知全部经 notices.ts 的
  * sendSmartContextNotice 走 nextTurn（随下一次 prompt 注入、不自起 run）——通知 run 不再
  * 抢占用户消息投递跑道；被压缩掐断的 turn 由 runtime 续跑投递兜底（D4②）。
  */

package/src/notices.ts

@@ -33,13 +33,13 @@ export type SmartContextNoticeSource =
 	| "model-downshift";
 
 /**
- * 注入一条 smart-context 通知（nextTurn 车道，不自起 run）。
+ * 注入一条 smart-context 通知（nextTurn 投递路径，不自起 run）。
  *
- * `deliverAs:'nextTurn'` 是投递车道（pi 实装分支序：nextTurn 分支先命中，`triggerTurn`
+ * `deliverAs:'nextTurn'` 是投递路径之一（pi 实装分支序：nextTurn 分支先命中，`triggerTurn`
  * 不再参与判定）；`triggerTurn:false` 是意图的显式声明（双写防未来实现分支序漂移）。
- * `display:true` 使通知在对话流可见——分车道语义（D4①）：compact-result 两条（complete/
+ * `display:true` 使通知在对话流可见——可见性按投递路径区分（D4①）：compact-result 两条（complete/
  * failed）改造前即 display:true 系统消息，可见性保持；阈值提醒/模型跨界/downshift 三条
- * 改造前 display:false 静默（只进 LLM 上下文，不进对话流），随 nextTurn 车道统一转
+ * 改造前 display:false 静默（只进 LLM 上下文，不进对话流），随 nextTurn 投递路径统一转
  * display:true 可见。
  */
 export function sendSmartContextNotice(

package/src/reminder.ts

@@ -2,7 +2,7 @@
  * 提醒与通知文案构造（D3/D4/D5/D13-12）。
  *
  * 全部为纯函数：文案 + 越档判定。注入由 src/index.ts / src/tool.ts 经 notices.ts 的
- * sendSmartContextNotice（nextTurn 车道，D4①）执行。
+ * sendSmartContextNotice（nextTurn 投递路径，D4①）执行。
  * 措辞原则（目标 3）：提醒是数据投递不是指令——给三条件自查清单 + 明确的"可忽略"出口，
  * 避免 agent 见提醒就压缩。
  */

package/src/tool.ts

@@ -5,7 +5,7 @@
  * （R2 实测 2026-08-22：tool execute 内 await ctx.compact() 不可行——AgentSession.compact
  * 开头的 abort() 会中止当前 agent 循环，挂起的 Promise 永不兑现、session 无 toolResult。
  * 故走 §3.2 降级态：execute 立即返回"压缩已启动"，onComplete/onError 后经
- * sendSmartContextNotice 注入结果消息（nextTurn 车道，D4①——随下一次 prompt 注入，
+ * sendSmartContextNotice 注入结果消息（nextTurn 投递路径，D4①——随下一次 prompt 注入，
  * 不自起 run；此刻无进行中回合，compact 内部 abort 为 no-op）。
  * 压缩生成由 session_before_compact 接管 handler 完成（工具只触发，不生成）。
  *