@akagilnc/pi-workflow-roles 0.1.3682 → 0.1.3685

package/dist/acp-host/production-host.js

@@ -2228,6 +2228,19 @@ var init_reviewer_output = __esm({
   }
 });
 
+// src/readable-gate-item.ts
+function readableGateItem(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function joinReadableGateItems(items, separator = "; ") {
+  return items.map(readableGateItem).join(separator);
+}
+var init_readable_gate_item = __esm({
+  "src/readable-gate-item.ts"() {
+    "use strict";
+  }
+});
+
 // src/audit-escalation.ts
 function buildAuditEscalationResult(decision, deliveredOutput) {
   const auditOwned = {
@@ -2276,17 +2289,17 @@ function humanDecisionText(decision, result) {
     lines.push(`Reason: ${result.reason}`);
   }
   if (Array.isArray(result.conflicts)) {
-    lines.push("Conflicts:", ...result.conflicts.map((conflict) => `- ${conflict}`));
+    lines.push("Conflicts:", ...result.conflicts.map((conflict) => `- ${readableGateItem(conflict)}`));
   }
   if (officer !== void 0 && Array.isArray(result.findings) && result.findings.length > 0) {
-    lines.push("Findings:", ...result.findings.map((finding2) => `- ${finding2}`));
+    lines.push("Findings:", ...result.findings.map((finding2) => `- ${readableGateItem(finding2)}`));
   }
   const gate = result.auditDecisionGate;
   if (gate !== null && typeof gate === "object" && !Array.isArray(gate)) {
     const record4 = gate;
     if (typeof record4.question === "string") lines.push(`Question: ${record4.question}`);
     if (Array.isArray(record4.options)) {
-      lines.push("Options:", ...record4.options.map((option) => `- ${option}`));
+      lines.push("Options:", ...record4.options.map((option) => `- ${readableGateItem(option)}`));
     }
   }
   return lines.join("\n");
@@ -2338,6 +2351,7 @@ var AUDIT_ESCALATION_KIND, AUDIT_ESCALATION_LIVE_REGISTRY;
 var init_audit_escalation = __esm({
   "src/audit-escalation.ts"() {
     "use strict";
+    init_readable_gate_item();
     AUDIT_ESCALATION_KIND = "audit_escalation";
     AUDIT_ESCALATION_LIVE_REGISTRY = /* @__PURE__ */ new WeakSet();
   }
@@ -2346,7 +2360,7 @@ var init_audit_escalation = __esm({
 // src/submission-errors.ts
 function gatekeeperNonPassMessage(result) {
   if (result.status === "bounce") {
-    const findings = result.findings.length === 0 ? "\uFF08\u65E0 findings\uFF09" : result.findings.join("; ");
+    const findings = result.findings.length === 0 ? "\uFF08\u65E0 findings\uFF09" : joinReadableGateItems(result.findings);
     return `\u95E8\u4E0B\u7701\u6253\u56DE\u91CD\u5199\uFF0Cfindings\uFF1A${findings}`;
   }
   if (result.status === "unreadable") {
@@ -2358,6 +2372,7 @@ var GatekeeperDecisionError, WorkerCommitReminderError, WorkerPrefixReminderErro
 var init_submission_errors = __esm({
   "src/submission-errors.ts"() {
     "use strict";
+    init_readable_gate_item();
     GatekeeperDecisionError = class extends Error {
       result;
       constructor(result) {
@@ -9834,7 +9849,7 @@ function failureReason(error) {
 }
 function asStringArray3(value) {
   if (!Array.isArray(value)) return [];
-  return value.map((item) => typeof item === "string" ? item : JSON.stringify(item));
+  return value.map(readableGateItem);
 }
 function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -9973,6 +9988,7 @@ var init_gatekeeper_role = __esm({
     "use strict";
     init_auditor_dossier_tool();
     init_submission_errors();
+    init_readable_gate_item();
     init_inspector_contracts();
     init_gatekeeper_output();
     init_shape_unreadable_failure();
@@ -20071,7 +20087,7 @@ function createDoctorRoleRuntime(pi, dependencies, host) {
         const details = testimony.status === "completed" ? { ...testimony, cost: activation.patient.cost } : testimony;
         const acceptedDetails = details;
         return disposeComplianceDecision(audit, { pass: (usage) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_TEXT }], details: acceptedDetails, terminate: true, ...usage === void 0 ? {} : { usage } }), noReceipt: (auditNoReceipt, usageProjection) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_AUDIT_NO_RECEIPT_TEXT }], details: { ...acceptedDetails, auditNoReceipt }, terminate: true, ...usageProjection }), received: (auditReceived, usageProjection) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_TEXT }], details: { ...acceptedDetails, audit: auditReceived.reply }, terminate: true, ...usageProjection }), bounce: (violations) => {
-          throw new Error(`\u592A\u533B\u7F72\u56DE\u6267\u8FDD soul\uFF1A${violations.join("; ")}`);
+          throw new Error(`\u592A\u533B\u7F72\u56DE\u6267\u8FDD soul\uFF1A${joinReadableGateItems(violations)}`);
         }, escalate: (result) => result }, acceptedDetails);
       } });
       pi.on("before_agent_start", (event) => {
@@ -20102,6 +20118,7 @@ var init_doctor_role = __esm({
     "use strict";
     init_audit_escalation();
     init_compliance_transport();
+    init_readable_gate_item();
     init_dossier_resolution();
     init_doctor_contracts();
     init_sitian_facade();
@@ -20780,7 +20797,7 @@ function createJudgeRoleRuntime(pi, dependencies, hostActions) {
                 }),
                 bounce: (violations) => {
                   throw new Error(
-                    `\u5927\u7406\u5BFA\u56DE\u6267\u8FDD soul\uFF1A${violations.join("; ")}`
+                    `\u5927\u7406\u5BFA\u56DE\u6267\u8FDD soul\uFF1A${joinReadableGateItems(violations)}`
                   );
                 },
                 escalate: (result) => result
@@ -20810,6 +20827,7 @@ var init_judge_role = __esm({
     "use strict";
     init_host_contracts();
     init_audit_escalation();
+    init_readable_gate_item();
     init_terminating_infrastructure();
     init_judge_output();
     judgeVerdictSchema = withInfrastructureFailureDeclaration(

package/dist/audit-escalation.js

@@ -1,3 +1,4 @@
+import { readableGateItem } from "./readable-gate-item.js";
 export const AUDIT_ESCALATION_KIND = "audit_escalation";
 // Live Navigator settlement may consume only the projection produced by this
 // owner. Its private WeakSet cannot be authored by role output; persisted/
@@ -71,10 +72,10 @@ function humanDecisionText(decision, result) {
         lines.push(`Reason: ${result.reason}`);
     }
     if (Array.isArray(result.conflicts)) {
-        lines.push("Conflicts:", ...result.conflicts.map((conflict) => `- ${conflict}`));
+        lines.push("Conflicts:", ...result.conflicts.map((conflict) => `- ${readableGateItem(conflict)}`));
     }
     if (officer !== undefined && Array.isArray(result.findings) && result.findings.length > 0) {
-        lines.push("Findings:", ...result.findings.map((finding) => `- ${finding}`));
+        lines.push("Findings:", ...result.findings.map((finding) => `- ${readableGateItem(finding)}`));
     }
     const gate = result.auditDecisionGate;
     if (gate !== null && typeof gate === "object" && !Array.isArray(gate)) {
@@ -82,7 +83,7 @@ function humanDecisionText(decision, result) {
         if (typeof record.question === "string")
             lines.push(`Question: ${record.question}`);
         if (Array.isArray(record.options)) {
-            lines.push("Options:", ...record.options.map((option) => `- ${option}`));
+            lines.push("Options:", ...record.options.map((option) => `- ${readableGateItem(option)}`));
         }
     }
     return lines.join("\n");

package/dist/doctor-role.js

@@ -1,5 +1,6 @@
 import { disposeComplianceDecision } from "./audit-escalation.js";
 import { ComplianceResponseRetentionError } from "./compliance-transport.js";
+import { joinReadableGateItems } from "./readable-gate-item.js";
 import { DOCTOR_CANDIDATE_ENTRY_TYPE } from "./dossier-resolution.js";
 import { DOCTOR_ACCEPTED_AUDIT_NO_RECEIPT_TEXT, DOCTOR_ACCEPTED_TEXT, DOCTOR_EVIDENCE_TOOL_NAME, DOCTOR_OUTPUT_TOOL_DESCRIPTION, DOCTOR_OUTPUT_TOOL_NAME, DoctorEvidenceStore, doctorEvidenceReadSchema, doctorSubmissionSchema, validateDoctorOutput } from "./doctor-contracts.js";
 import { sitianReport } from "./sitian-facade.js";
@@ -57,7 +58,7 @@ export function createDoctorRoleRuntime(pi, dependencies, host) {
                     }
                     catch (error) {
                         host.failInfrastructure(error, ctx, id);
-                    } const details = testimony.status === "completed" ? { ...testimony, cost: activation.patient.cost } : testimony; const acceptedDetails = details; return disposeComplianceDecision(audit, { pass: (usage) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_TEXT }], details: acceptedDetails, terminate: true, ...(usage === undefined ? {} : { usage }) }), noReceipt: (auditNoReceipt, usageProjection) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_AUDIT_NO_RECEIPT_TEXT }], details: { ...acceptedDetails, auditNoReceipt }, terminate: true, ...usageProjection }), received: (auditReceived, usageProjection) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_TEXT }], details: { ...acceptedDetails, audit: auditReceived.reply }, terminate: true, ...usageProjection }), bounce: (violations) => { throw new Error(`太医署回执违 soul：${violations.join("; ")}`); }, escalate: (result) => result }, acceptedDetails); } });
+                    } const details = testimony.status === "completed" ? { ...testimony, cost: activation.patient.cost } : testimony; const acceptedDetails = details; return disposeComplianceDecision(audit, { pass: (usage) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_TEXT }], details: acceptedDetails, terminate: true, ...(usage === undefined ? {} : { usage }) }), noReceipt: (auditNoReceipt, usageProjection) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_AUDIT_NO_RECEIPT_TEXT }], details: { ...acceptedDetails, auditNoReceipt }, terminate: true, ...usageProjection }), received: (auditReceived, usageProjection) => ({ content: [{ type: "text", text: DOCTOR_ACCEPTED_TEXT }], details: { ...acceptedDetails, audit: auditReceived.reply }, terminate: true, ...usageProjection }), bounce: (violations) => { throw new Error(`太医署回执违 soul：${joinReadableGateItems(violations)}`); }, escalate: (result) => result }, acceptedDetails); } });
                 pi.on("before_agent_start", (event) => { if (!activation)
                     throw new Error("太医署未激活"); const catalog = { version: activation.patient.version, identity: activation.patient.identity, admittedMetrics: { provenance: "由留存 session 字节推导，封入受理回执。", cost: activation.patient.cost }, lawfulTargetKeys: ["case", ...activation.patient.cost.invocations.sources], evidence: activation.patient.evidence.map(({ id, kind, sha256, byteLength, contentLength }) => ({ id, kind, sha256, byteLength, contentLength })) }; return { systemPrompt: `${event.systemPrompt}\n\n<doctor_soul>\n${activation.soul}\n</doctor_soul>\n\n<doctor_case>\n${JSON.stringify(catalog)}\n</doctor_case>` }; });
             }

package/dist/gatekeeper-role.js

@@ -1,5 +1,6 @@
 import { auditorRunDirectory, persistGateSubmissionCandidate, } from "./auditor-dossier-tool.js";
 import { GatekeeperDecisionError } from "./submission-errors.js";
+import { readableGateItem } from "./readable-gate-item.js";
 import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.js";
 import { GATEKEEPER_OUTPUT_TOOL_NAME, gatekeeperDecisionSchema, gatekeeperOutputSchema, } from "./package-contracts/gatekeeper-output.js";
 import { retainedShapeUnreadable } from "./shape-unreadable-failure.js";
@@ -52,8 +53,8 @@ function asStringArray(value) {
     if (!Array.isArray(value))
         return [];
     // Officer findings may be structured objects (category/law/evidence); the
-    // parent role must see them verbatim, not an empty list (#750 evidence).
-    return value.map((item) => (typeof item === "string" ? item : JSON.stringify(item)));
+    // parent role must see them verbatim, not an empty list (#750 / #775).
+    return value.map(readableGateItem);
 }
 /** Serializable stand-in when the child tool call had no arguments object. */
 export const MISSING_ARGUMENTS_SUBMISSION = Object.freeze({ missing: "arguments" });

package/dist/judge-role.js

@@ -1,6 +1,7 @@
 import { stringEnum } from "./host-contracts.js";
 import { Type } from "typebox";
 import { disposeComplianceDecision } from "./audit-escalation.js";
+import { joinReadableGateItems } from "./readable-gate-item.js";
 import { withInfrastructureFailureDeclaration } from "./package-contracts/terminating-infrastructure.js";
 import { JUDGE_ACCEPTED_AUDIT_NO_RECEIPT_TEXT, JUDGE_ACCEPTED_TEXT, JUDGE_OUTPUT_TOOL_NAME, validateAcceptedJudgeDetails, } from "./package-contracts/judge-output.js";
 export { JUDGE_OUTPUT_TOOL_NAME };
@@ -85,7 +86,7 @@ export function createJudgeRoleRuntime(pi, dependencies, hostActions) {
                                 ...usageProjection,
                             }),
                             bounce: (violations) => {
-                                throw new Error(`大理寺回执违 soul：${violations.join("; ")}`);
+                                throw new Error(`大理寺回执违 soul：${joinReadableGateItems(violations)}`);
                             },
                             escalate: (result) => result,
                         }, 

package/dist/public-cli/main.js

@@ -16687,6 +16687,13 @@ var init_run_ticket_number = __esm({
   }
 });
 
+// src/readable-gate-item.ts
+var init_readable_gate_item = __esm({
+  "src/readable-gate-item.ts"() {
+    "use strict";
+  }
+});
+
 // src/audit-escalation.ts
 function isAuditEscalationResult(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
@@ -16698,6 +16705,7 @@ var AUDIT_ESCALATION_KIND;
 var init_audit_escalation = __esm({
   "src/audit-escalation.ts"() {
     "use strict";
+    init_readable_gate_item();
     AUDIT_ESCALATION_KIND = "audit_escalation";
   }
 });
@@ -16706,6 +16714,7 @@ var init_audit_escalation = __esm({
 var init_submission_errors = __esm({
   "src/submission-errors.ts"() {
     "use strict";
+    init_readable_gate_item();
   }
 });
 
@@ -22411,6 +22420,7 @@ var init_gatekeeper_role = __esm({
     "use strict";
     init_auditor_dossier_tool();
     init_submission_errors();
+    init_readable_gate_item();
     init_inspector_contracts();
     init_gatekeeper_output();
     init_shape_unreadable_failure();

package/dist/readable-gate-item.js

@@ -0,0 +1,16 @@
+/**
+ * Parent-visible relay of one gate bounce/finding item (#750 / #775).
+ *
+ * Strings stay as-is. Any other value is JSON-serialized so structured content
+ * (article/reason/evidence, category/law/evidence, …) is not lost as
+ * `[object Object]` when joined into parent-seat text.
+ *
+ * Presentation only: does not legislate carrier format for LLM-to-LLM traffic.
+ */
+export function readableGateItem(value) {
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+/** Join gate items into one parent-visible line. */
+export function joinReadableGateItems(items, separator = "; ") {
+    return items.map(readableGateItem).join(separator);
+}

package/dist/submission-errors.js

@@ -1,6 +1,9 @@
+import { joinReadableGateItems } from "./readable-gate-item.js";
 function gatekeeperNonPassMessage(result) {
     if (result.status === "bounce") {
-        const findings = result.findings.length === 0 ? "（无 findings）" : result.findings.join("; ");
+        const findings = result.findings.length === 0
+            ? "（无 findings）"
+            : joinReadableGateItems(result.findings);
         return `门下省打回重写，findings：${findings}`;
     }
     if (result.status === "unreadable") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.3682",
+  "version": "0.1.3685",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/src/audit-escalation.ts

@@ -3,6 +3,7 @@ import type { Usage } from "@earendil-works/pi-ai";
 import type {
   ComplianceDecision,
 } from "./compliance-transport.ts";
+import { readableGateItem } from "./readable-gate-item.ts";
 
 export const AUDIT_ESCALATION_KIND = "audit_escalation" as const;
 
@@ -126,17 +127,17 @@ function humanDecisionText(
     lines.push(`Reason: ${result.reason}`);
   }
   if (Array.isArray(result.conflicts)) {
-    lines.push("Conflicts:", ...result.conflicts.map((conflict) => `- ${conflict}`));
+    lines.push("Conflicts:", ...result.conflicts.map((conflict) => `- ${readableGateItem(conflict)}`));
   }
   if (officer !== undefined && Array.isArray(result.findings) && result.findings.length > 0) {
-    lines.push("Findings:", ...result.findings.map((finding) => `- ${finding}`));
+    lines.push("Findings:", ...result.findings.map((finding) => `- ${readableGateItem(finding)}`));
   }
   const gate = result.auditDecisionGate;
   if (gate !== null && typeof gate === "object" && !Array.isArray(gate)) {
     const record = gate as Record<string, unknown>;
     if (typeof record.question === "string") lines.push(`Question: ${record.question}`);
     if (Array.isArray(record.options)) {
-      lines.push("Options:", ...record.options.map((option) => `- ${option}`));
+      lines.push("Options:", ...record.options.map((option) => `- ${readableGateItem(option)}`));
     }
   }
   return lines.join("\n");

package/src/doctor-role.ts

@@ -1,6 +1,7 @@
 import type { RoleHost, HostContext, HostToolResult } from "./host-contracts.ts";
 import { disposeComplianceDecision } from "./audit-escalation.ts";
 import { ComplianceResponseRetentionError, type ComplianceDecision } from "./compliance-transport.ts";
+import { joinReadableGateItems } from "./readable-gate-item.ts";
 import { DOCTOR_CANDIDATE_ENTRY_TYPE } from "./dossier-resolution.ts";
 import { DOCTOR_ACCEPTED_AUDIT_NO_RECEIPT_TEXT, DOCTOR_ACCEPTED_TEXT, DOCTOR_EVIDENCE_TOOL_NAME, DOCTOR_OUTPUT_TOOL_DESCRIPTION, DOCTOR_OUTPUT_TOOL_NAME, DoctorEvidenceStore, doctorEvidenceReadSchema, doctorSubmissionSchema, validateDoctorOutput, type DoctorCase } from "./doctor-contracts.ts";
 
@@ -35,7 +36,7 @@ export function createDoctorRoleRuntime(pi: RoleHost, dependencies: DoctorRoleDe
   let activation: { soul: string; patient: DoctorCase; store: DoctorEvidenceStore } | undefined; let registered = false; pi.registerFlag(DOCTOR_CASE_FLAG.name, DOCTOR_CASE_FLAG.definition);
   return { async activate() { const path = pi.getFlag(DOCTOR_CASE_FLAG.name); if (typeof path !== "string" || !path.trim()) throw new Error("Doctor requires --ak-doctor-case"); const soul = (await dependencies.loadSoul()).trim(); if (!soul) throw new Error("Doctor soul is empty"); const patient = await dependencies.loadCase(path); activation = { soul, patient, store: new DoctorEvidenceStore(patient) };
     if (!registered) { registered = true; pi.registerTool({ name: DOCTOR_EVIDENCE_TOOL_NAME, label: "太医署证据", description: "分页读取留存的 Pi session 字节。", parameters: doctorEvidenceReadSchema, async execute(_id: string, params: { evidenceId: string; offset?: number; limit?: number }) { if (!activation) throw new Error("太医署未激活"); const details = activation.store.read(params.evidenceId, params.offset, params.limit); return { content: [{ type: "text" as const, text: JSON.stringify(details) }], details }; } });
-      pi.registerTool({ name: DOCTOR_OUTPUT_TOOL_NAME, label: "太医署输出", description: DOCTOR_OUTPUT_TOOL_DESCRIPTION, parameters: doctorSubmissionSchema, async execute(id: string, params: unknown, signal: AbortSignal | undefined, _update: unknown, ctx: HostContext): Promise<HostToolResult<unknown>> { if (!activation) throw new Error("太医署未激活"); const testimony = validateDoctorOutput(params, activation.patient, activation.store); try { appendCandidate(ctx, { version: 1, testimony, readRecord: activation.store.readRecord(), patientIdentity: activation.patient.identity }); } catch (error) { host.failInfrastructure(error, ctx, id); } let audit: ComplianceDecision; try { audit = await dependencies.auditCompliance(signal === undefined ? { context: ctx } : { context: ctx, signal }); } catch (error) { host.failInfrastructure(error, ctx, id); } const details = testimony.status === "completed" ? { ...testimony, cost: activation.patient.cost } : testimony; const acceptedDetails = details; return disposeComplianceDecision<HostToolResult<unknown>>(audit, { pass: (usage) => ({ content: [{ type: "text" as const, text: DOCTOR_ACCEPTED_TEXT }], details: acceptedDetails, terminate: true as const, ...(usage === undefined ? {} : { usage }) }), noReceipt: (auditNoReceipt, usageProjection) => ({ content: [{ type: "text" as const, text: DOCTOR_ACCEPTED_AUDIT_NO_RECEIPT_TEXT }], details: { ...acceptedDetails, auditNoReceipt }, terminate: true as const, ...usageProjection }), received: (auditReceived, usageProjection) => ({ content: [{ type: "text" as const, text: DOCTOR_ACCEPTED_TEXT }], details: { ...acceptedDetails, audit: auditReceived.reply }, terminate: true as const, ...usageProjection }), bounce: (violations) => { throw new Error(`太医署回执违 soul：${violations.join("; ")}`); }, escalate: (result) => result }, acceptedDetails); } });
+      pi.registerTool({ name: DOCTOR_OUTPUT_TOOL_NAME, label: "太医署输出", description: DOCTOR_OUTPUT_TOOL_DESCRIPTION, parameters: doctorSubmissionSchema, async execute(id: string, params: unknown, signal: AbortSignal | undefined, _update: unknown, ctx: HostContext): Promise<HostToolResult<unknown>> { if (!activation) throw new Error("太医署未激活"); const testimony = validateDoctorOutput(params, activation.patient, activation.store); try { appendCandidate(ctx, { version: 1, testimony, readRecord: activation.store.readRecord(), patientIdentity: activation.patient.identity }); } catch (error) { host.failInfrastructure(error, ctx, id); } let audit: ComplianceDecision; try { audit = await dependencies.auditCompliance(signal === undefined ? { context: ctx } : { context: ctx, signal }); } catch (error) { host.failInfrastructure(error, ctx, id); } const details = testimony.status === "completed" ? { ...testimony, cost: activation.patient.cost } : testimony; const acceptedDetails = details; return disposeComplianceDecision<HostToolResult<unknown>>(audit, { pass: (usage) => ({ content: [{ type: "text" as const, text: DOCTOR_ACCEPTED_TEXT }], details: acceptedDetails, terminate: true as const, ...(usage === undefined ? {} : { usage }) }), noReceipt: (auditNoReceipt, usageProjection) => ({ content: [{ type: "text" as const, text: DOCTOR_ACCEPTED_AUDIT_NO_RECEIPT_TEXT }], details: { ...acceptedDetails, auditNoReceipt }, terminate: true as const, ...usageProjection }), received: (auditReceived, usageProjection) => ({ content: [{ type: "text" as const, text: DOCTOR_ACCEPTED_TEXT }], details: { ...acceptedDetails, audit: auditReceived.reply }, terminate: true as const, ...usageProjection }), bounce: (violations) => { throw new Error(`太医署回执违 soul：${joinReadableGateItems(violations)}`); }, escalate: (result) => result }, acceptedDetails); } });
       pi.on("before_agent_start", (event) => { if (!activation) throw new Error("太医署未激活"); const catalog = { version: activation.patient.version, identity: activation.patient.identity, admittedMetrics: { provenance: "由留存 session 字节推导，封入受理回执。", cost: activation.patient.cost }, lawfulTargetKeys: ["case", ...activation.patient.cost.invocations.sources], evidence: activation.patient.evidence.map(({ id, kind, sha256, byteLength, contentLength }) => ({ id, kind, sha256, byteLength, contentLength })) }; return { systemPrompt: `${event.systemPrompt}\n\n<doctor_soul>\n${activation.soul}\n</doctor_soul>\n\n<doctor_case>\n${JSON.stringify(catalog)}\n</doctor_case>` }; }); }
     const required = [DOCTOR_EVIDENCE_TOOL_NAME, DOCTOR_OUTPUT_TOOL_NAME]; const names = pi.getAllTools().map((tool) => tool.name); for (const name of required) if (names.filter((item) => item === name).length !== 1) throw new Error(`Doctor required tool collision or missing: ${name}`); pi.setActiveTools(required); const active = pi.getActiveTools?.() ?? required; if (active.length !== 2 || !required.every((name) => active.includes(name))) throw new Error("Doctor active tool narrowing failed"); } };
 }

package/src/gatekeeper-role.ts

@@ -7,6 +7,7 @@ import {
 } from "./auditor-dossier-tool.ts";
 import type { NoReceiptLifecycleFacts } from "./receipt-delivery-policy.ts";
 import { GatekeeperDecisionError } from "./submission-errors.ts";
+import { readableGateItem } from "./readable-gate-item.ts";
 import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.ts";
 import {
   GATEKEEPER_OUTPUT_TOOL_NAME,
@@ -147,8 +148,8 @@ function failureReason(error: unknown): string {
 function asStringArray(value: unknown): readonly string[] {
   if (!Array.isArray(value)) return [];
   // Officer findings may be structured objects (category/law/evidence); the
-  // parent role must see them verbatim, not an empty list (#750 evidence).
-  return value.map((item) => (typeof item === "string" ? item : JSON.stringify(item)));
+  // parent role must see them verbatim, not an empty list (#750 / #775).
+  return value.map(readableGateItem);
 }
 
 /** Serializable stand-in when the child tool call had no arguments object. */

package/src/judge-role.ts

@@ -4,6 +4,7 @@ import { Type, type Static } from "typebox";
 
 import { disposeComplianceDecision } from "./audit-escalation.ts";
 import type { ComplianceDecision } from "./compliance-transport.ts";
+import { joinReadableGateItems } from "./readable-gate-item.ts";
 import { withInfrastructureFailureDeclaration } from "./package-contracts/terminating-infrastructure.ts";
 
 import {
@@ -136,7 +137,7 @@ export function createJudgeRoleRuntime(
                 }),
                 bounce: (violations) => {
                   throw new Error(
-                    `大理寺回执违 soul：${violations.join("; ")}`,
+                    `大理寺回执违 soul：${joinReadableGateItems(violations)}`,
                   );
                 },
                 escalate: (result) => result,

package/src/readable-gate-item.ts

@@ -0,0 +1,20 @@
+/**
+ * Parent-visible relay of one gate bounce/finding item (#750 / #775).
+ *
+ * Strings stay as-is. Any other value is JSON-serialized so structured content
+ * (article/reason/evidence, category/law/evidence, …) is not lost as
+ * `[object Object]` when joined into parent-seat text.
+ *
+ * Presentation only: does not legislate carrier format for LLM-to-LLM traffic.
+ */
+export function readableGateItem(value: unknown): string {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+
+/** Join gate items into one parent-visible line. */
+export function joinReadableGateItems(
+  items: readonly unknown[],
+  separator = "; ",
+): string {
+  return items.map(readableGateItem).join(separator);
+}

package/src/submission-errors.ts

@@ -1,8 +1,11 @@
 import type { GatekeeperNonPassResult } from "./gatekeeper-role.ts";
+import { joinReadableGateItems } from "./readable-gate-item.ts";
 
 function gatekeeperNonPassMessage(result: GatekeeperNonPassResult): string {
   if (result.status === "bounce") {
-    const findings = result.findings.length === 0 ? "（无 findings）" : result.findings.join("; ");
+    const findings = result.findings.length === 0
+      ? "（无 findings）"
+      : joinReadableGateItems(result.findings);
     return `门下省打回重写，findings：${findings}`;
   }
   if (result.status === "unreadable") {