@zhushanwen/pi-structured-output 6.1.3 → 6.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-structured-output",
-  "version": "6.1.3",
+  "version": "6.2.0",
   "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",
@@ -26,16 +26,21 @@
   ],
   "dependencies": {
     "ajv": "^8.17.0",
+    "@zhushanwen/extension-protocol": "0.21.0",
     "@zhushanwen/pi-ext-guards": "0.5.0"
   },
   "peerDependencies": {
+    "@earendil-works/pi-ai": "^1.0.0",
     "@earendil-works/pi-coding-agent": "^1.0.0",
-    "typebox": "1.3.27",
-    "@earendil-works/pi-ai": "^1.0.0"
+    "@earendil-works/pi-tui": "^1.0.0",
+    "typebox": "1.3.27"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-ai": {
       "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
     }
   },
   "devDependencies": {

package/src/render-result.ts

@@ -0,0 +1,38 @@
+/**
+ * structured-output 工具的 TUI renderResult（折叠态一行摘要 / 展开态 content 纯文本）。
+ *
+ * 摘要不进 details：本工具的 result.details 是模型的结构化产出本体（workflow 引擎
+ * output-collector 的 extractParsedOutput 原样取走作 agent parsedOutput），混入 summary
+ * 键会污染产出契约（object 形态多出合同外字段、primitive 形态无处挂载）。因此折叠态
+ * 摘要 = 固定文案，不依赖数据。
+ */
+
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
+import { firstContentText } from "@zhushanwen/extension-protocol";
+
+/** 折叠态一行摘要（两种注册变体统一；校验失败走 throw 不产出 result）。 */
+export const STRUCTURED_OUTPUT_SUMMARY = "Final result reported (schema validated)";
+
+/** content[0] 的 text 纯文本（content 缺失或非 text 类型时兜底空串）。 */
+/** unknown 值按字段名安全取值（index-signature 收窄，替代全可选结构断言）。 */
+function fieldValue(v: unknown, key: string): unknown {
+	if (typeof v !== "object" || v === null) return undefined;
+	return (v as Record<string, unknown>)[key];
+}
+
+function contentText(result: unknown): string {
+	const content = fieldValue(result, "content");
+	if (!Array.isArray(content)) return "";
+	return firstContentText({ content });
+}
+
+/** 折叠态（expanded=false）= 固定一行摘要（dim）；展开态 = content 纯文本。 */
+export function renderStructuredOutputResult(
+	result: unknown,
+	options: { expanded: boolean },
+	theme: Theme,
+): Text {
+	if (options.expanded) return new Text(contentText(result), 0, 0);
+	return new Text(theme.fg("dim", STRUCTURED_OUTPUT_SUMMARY), 0, 0);
+}

package/src/tool-definition.ts

@@ -18,10 +18,12 @@
  * 两变体的描述文本均被 prompt-quality.test.ts 文本断言锁定。
  */
 
+import type { Theme } from "@earendil-works/pi-coding-agent";
 import { isRecord } from "@zhushanwen/pi-ext-guards";
 import { Type } from "typebox";
 
 import { executeStructuredOutput, isObjectRootSchema } from "./execute.js";
+import { renderStructuredOutputResult } from "./render-result.js";
 import {
 	assertJsonSchemaRoot,
 	echo,
@@ -163,6 +165,12 @@ export function createWorkflowToolDefinition(envSchema: string) {
 			// 「根是否 object」对称完成（与注册期包装判定同一函数 isObjectRootSchema）。
 			return executeStructuredOutput({ data: params, authoritativeSchema: schema });
 		},
+
+		// 摘要不进 details：details 是模型的结构化产出本体（workflow 引擎 extractParsedOutput
+		// 原样消费），折叠态摘要 = render-result 的固定文案。
+		renderResult(result: unknown, options: { expanded: boolean }, theme: Theme) {
+			return renderStructuredOutputResult(result, options, theme);
+		},
 	};
 }
 
@@ -240,5 +248,10 @@ export function createDailyToolDefinition() {
 					: params,
 			);
 		},
+
+		// 摘要不进 details：同 workflow 变体（details = 数据本体，parsedOutput 契约）
+		renderResult(result: unknown, options: { expanded: boolean }, theme: Theme) {
+			return renderStructuredOutputResult(result, options, theme);
+		},
 	};
 }