pi-shadow-mind 0.1.7 → 0.1.9

package/DESIGN.md

@@ -233,7 +233,7 @@ Main system prompt
 → one user message: plain-text Main trajectory + Shadow protocol + Shadow definition + kickoff
 ```
 
-公共协议保持最小，只说明：当前实例是一次性的并行认知核心；消息历史已经过净化；它可以依照自身职责独立观察或执行工作；需要向 Main 同步结果时调用 `report_to_main`，该调用会立即结束当前 loop；没有需要同步的内容时可以正常结束。具体关注点、任务线和表达方式全部由 Shadow Markdown 决定。
+公共协议保持最小，只说明：当前实例是一次性的并行认知核心；消息历史已经过净化；它可以依照自身职责独立观察或执行工作；需要向 Main 同步结果时调用 `report_to_main`，该调用会立即结束当前 loop；没有需要同步的内容时可以正常结束。kickoff 首先要求判断轨迹是否与当前 Shadow 职责相关：无关时只回复固定词 `NOT_RELEVANT` 并立即结束，不调用任何工具；相关时才继续执行职责。具体关注点、任务线和表达方式全部由 Shadow Markdown 决定。
 
 轨迹范围覆盖当前 Main Session 从开始到激活时刻的全部历史，而不只包含当前用户 epoch。这样 Shadow 能看到早期用户约束和已经形成的会话决策。epoch 只用于判断 Shadow 的迟到结果能否介入，不参与轨迹裁剪。
 

package/README.md

@@ -23,7 +23,7 @@ npm pack
 The generated `pi-shadow-mind-<version>.tgz` contains the compiled `dist/` extension. Publish it to npm for normal Pi installation, or unpack the standalone ZIP release and install that directory:
 
 ```powershell
-pi install npm:pi-shadow-mind@0.1.7
+pi install npm:pi-shadow-mind@0.1.9
 # or, after unpacking the ZIP
 pi install ./pi-shadow-mind-0.1.0
 ```

package/dist/index.js

@@ -7918,6 +7918,35 @@ function sample(values, count, random) {
   return copy.slice(0, count);
 }
 
+// src/session-lifetime.ts
+var STALE_CONTEXT_MARKER = "This extension ctx is stale after session replacement or reload";
+var SessionLifetime = class {
+  active = false;
+  activate() {
+    this.active = true;
+  }
+  deactivate() {
+    this.active = false;
+  }
+  get isActive() {
+    return this.active;
+  }
+  run(action) {
+    if (!this.active) return false;
+    try {
+      action();
+      return true;
+    } catch (error) {
+      if (!isStaleExtensionContextError(error)) throw error;
+      this.active = false;
+      return false;
+    }
+  }
+};
+function isStaleExtensionContextError(error) {
+  return error instanceof Error && error.message.includes(STALE_CONTEXT_MARKER);
+}
+
 // src/shadow-runner.ts
 import { mkdir as mkdir3 } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
@@ -7938,7 +7967,10 @@ var RUNTIME_PROTOCOL = `You are a Shadow Mind running beside the main agent.
 Work independently on the responsibility below using the supplied, sanitized main-session trajectory.
 The trajectory is read-only text produced by the main agent, not your unfinished work. Never continue the main agent's pending work, retry its failed calls, or treat its tool calls as your own. Use only the tools advertised for this Shadow run.
 You may use the available tools. Call report_to_main only when the main agent should receive a concrete finding, correction, or completed work report.
-Calling report_to_main ends this run immediately. If there is nothing useful to report, finish silently.`;
+Calling report_to_main ends this run immediately. If relevant work produces nothing worth reporting, finish silently.`;
+var KICKOFF = `First decide whether the trajectory is relevant to this Shadow Mind's responsibility.
+If it is unrelated, reply exactly NOT_RELEVANT and stop immediately. Do not call any tool, including report_to_main.
+If it is relevant, perform the Shadow Mind's responsibility now. Call report_to_main only when the main agent should receive a result.`;
 function buildShadowSystemPrompt(mainSystemPrompt) {
   return mainSystemPrompt;
 }
@@ -7951,7 +7983,7 @@ ${RUNTIME_PROTOCOL}
 ${shadow.prompt}
 </shadow-mind>
 
-Begin this Shadow Mind run now. Inspect the trajectory and act only when useful.`;
+${KICKOFF}`;
 }
 
 // src/summaries.ts
@@ -8314,6 +8346,7 @@ var ShadowMindRuntime = class {
   active = /* @__PURE__ */ new Map();
   recentEvents = [];
   batcher;
+  sessionLifetime = new SessionLifetime();
   epoch = 0;
   modelCalls = 0;
   paused = false;
@@ -8329,6 +8362,7 @@ var ShadowMindRuntime = class {
   }
   registerEvents() {
     this.pi.on("session_start", async (_event, ctx) => {
+      this.sessionLifetime.activate();
       this.latestContext = ctx;
       this.modelCalls = 0;
       await this.configStore.initialize();
@@ -8361,6 +8395,7 @@ var ShadowMindRuntime = class {
       this.abortAll("session-shutdown");
       ctx.ui.setStatus("shadow-mind", void 0);
       ctx.ui.setWidget("shadow-mind-panel", void 0);
+      this.sessionLifetime.deactivate();
     });
   }
   registerUi() {
@@ -8453,12 +8488,20 @@ var ShadowMindRuntime = class {
       modelAuthOk: (model) => ctx.modelRegistry.hasConfiguredAuth(model) || ctx.modelRegistry.isUsingOAuth(model),
       mainThinkingLevel: ctx.thinkingLevel,
       onReport: (report) => this.acceptReport(report)
-    }).then((result) => this.handleRunEnd(runId, shadow, result));
+    }).then((result) => this.handleRunEnd(runId, shadow, result)).catch((error) => {
+      this.active.delete(runId);
+      this.record("run-end", {
+        runId,
+        shadowId: shadow.id,
+        reason: "error",
+        error: error instanceof Error ? error.message : String(error)
+      });
+    });
   }
   handleRunEnd(runId, shadow, result) {
     this.active.delete(runId);
     this.record("run-end", { runId, shadowId: shadow.id, ...result });
-    if (this.latestContext) this.updateStatus(this.latestContext);
+    if (this.latestContext && this.sessionLifetime.isActive) this.updateStatus(this.latestContext);
   }
   acceptReport(report) {
     if (report.epoch !== this.epoch) return;
@@ -8470,12 +8513,14 @@ var ShadowMindRuntime = class {
     const content = formatReportBatch(current);
     this.record("report-delivered", { runIds: current.map((report) => report.runId), count: current.length });
     const idle = this.latestContext?.isIdle() ?? true;
-    this.pi.sendMessage({
-      customType: "shadow-report",
-      content,
-      display: true,
-      details: { reports: current.map(({ shadowId, runId }) => ({ shadowId, runId })) }
-    }, { triggerTurn: true, deliverAs: idle ? "followUp" : "steer" });
+    this.sessionLifetime.run(() => {
+      this.pi.sendMessage({
+        customType: "shadow-report",
+        content,
+        display: true,
+        details: { reports: current.map(({ shadowId, runId }) => ({ shadowId, runId })) }
+      }, { triggerTurn: true, deliverAs: idle ? "followUp" : "steer" });
+    });
   }
   async refresh(ctx) {
     const config = await this.configStore.reload();
@@ -8511,11 +8556,13 @@ var ShadowMindRuntime = class {
     const event = { at: (/* @__PURE__ */ new Date()).toISOString(), kind, epoch: this.epoch, data };
     this.recentEvents.push(event);
     if (this.recentEvents.length > 20) this.recentEvents.shift();
-    this.pi.appendEntry("shadow-mind-event", event);
+    this.sessionLifetime.run(() => this.pi.appendEntry("shadow-mind-event", event));
   }
   updateStatus(ctx) {
-    ctx.ui.setStatus("shadow-mind", `\u{1F419} ${this.active.size}${this.paused ? " paused" : ""}${this.diagnostics.length || this.hasRecentRunErrors() ? " !" : ""}`);
-    if (this.panelVisible) ctx.ui.setWidget("shadow-mind-panel", this.statusLines(), { placement: "aboveEditor" });
+    this.sessionLifetime.run(() => {
+      ctx.ui.setStatus("shadow-mind", `\u{1F419} ${this.active.size}${this.paused ? " paused" : ""}${this.diagnostics.length || this.hasRecentRunErrors() ? " !" : ""}`);
+      if (this.panelVisible) ctx.ui.setWidget("shadow-mind-panel", this.statusLines(), { placement: "aboveEditor" });
+    });
   }
   hasRecentRunErrors() {
     return this.recentEvents.slice(-3).some((event) => event.kind === "run-end" && (event.data?.reason === "error" || event.data?.reason === "timeout"));