@zhushanwen/pi-structured-output 5.1.3 → 5.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-structured-output",
-  "version": "5.1.3",
+  "version": "5.1.5",
   "description": "Structured output tool for Pi — workflow schema enforcement via pi's parameter layer; interactive mode validates self-reported schemas with Ajv",
   "type": "module",
   "main": "index.ts",
@@ -24,7 +24,8 @@
     "index.ts"
   ],
   "dependencies": {
-    "ajv": "^8.17.0"
+    "ajv": "^8.17.0",
+    "@zhushanwen/pi-ext-guards": "0.3.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.4",

package/src/loop-gate.ts

@@ -41,6 +41,7 @@
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { guardStaleCtx, toErrorMessage } from "@zhushanwen/pi-ext-guards";
 
 import { isPlainObject, isToolExecutionEndEvent } from "./schema-guards.js";
 import {
@@ -558,8 +559,23 @@ export function setupLoopGate(pi: PiAPI, options: LoopGateOptions = {}): LoopGat
 
 		options.onTerminal?.();
 		writeTerminatedLog(pi, gate);
-		ctx.abort();
-		ctx.shutdown();
+		// stale ctx 防御（crash-resilience D1）：abort/shutdown 均在 pi assertActive 面
+		// （PS-30，runner.js createContext）——session 替换窗口触发 terminal 时无人接的
+		// 同步 throw 会经 async handler 变 rejected Promise 杀 pi 进程。stale 静默跳过
+		// 优雅退出（此时进程的存在意义已随 session 替换消失），armForceExitTeardown 的
+		// 15s 硬退兜底保持武装——自清理语义不丢。非 stale 错误原样上抛（守卫不吞真实 bug）。
+		guardStaleCtx(() => {
+			ctx.abort();
+			ctx.shutdown();
+		}, {
+			label: "structured-output:terminal-teardown",
+			onStale: (error) => {
+				process.stderr.write(
+					`[structured-output gate] terminal teardown skipped (stale ctx, session replaced): `
+						+ `${toErrorMessage(error)}; force-exit timer stays armed.\n`,
+				);
+			},
+		});
 		armForceExitTeardown();
 	});
 

package/src/text-primitives.ts

@@ -40,10 +40,9 @@ export function truncateText(text: string, max: number): string {
  *
  * Pi 框架在参数层校验失败（immediate 路径）与 execute 抛错时，均构造
  * `{ content: [{ type: "text", text }] }` 塞进 result.content[0].text
- * （agent-loop.js createErrorToolResult；见 extensions/universal/unified-hooks 的
- * extractErrorText 及其文档：SDK 事件结构里没有独立 errorMessage 字段，错误文本只能从
- * result.content 里取）。loop-gate（D3）复用本函数提取签名原料，workflow-hook 取
- * steer 回灌文本。
+ * （agent-loop.js createErrorToolResult；SDK 事件结构里没有独立 errorMessage 字段，
+ * 错误文本只能从 result.content 里取）。loop-gate（D3）复用本函数提取签名原料，
+ * workflow-hook 取 steer 回灌文本。
  * 这里防御性取多种结构，取不到就返回 undefined（调用方降级为通用提示）。
  */
 export function extractToolErrorText(result: unknown): string | undefined {

package/src/tool-definition.ts

@@ -37,9 +37,9 @@ export const ENV_SCHEMA = "PI_WORKFLOW_SCHEMA";
  *
  * 背景：PI_WORKFLOW_SCHEMA 经 spawn childEnv 注入子进程，env 块受 ARG_MAX 约束
  *（Linux E2BIG）——超大 schema 会在 spawn 调用点报难归因的失败。硬拒绝在
- * subagent-core 侧（packages/subagent-core 的 session-runner applySchemaEnvToChildEnv，
- * 同值上限 SCHEMA_ENV_MAX_BYTES = 256 * 1024，见其 src/shared/schema-env.ts
- * [跨包契约 SSOT] 注释）；本包独立 npm 不能直接 import（isObjectRootSchema 本地副本同例），常量
+ * pi 引擎侧（packages/pi-subagent-cli 的 applySchemaEnvToChildEnv，同值上限
+ * SCHEMA_ENV_MAX_BYTES = 256 * 1024，见其 src/constants.ts）；本包独立 npm
+ * 不能直接 import（isObjectRootSchema 本地副本同例），常量
  * 各自保留、跨包契约测试锁字节相等（tests/cross-package-contract.test.ts）。
  * 本侧职责仅可见性：注册时超限 logger.warn（无 logger API，stderr 直出惯例）提示
  * env 通道有上限，建议拆分 schema 或精简——不拒绝注册（子进程能收到 env 说明 SW