@akagilnc/pi-workflow-roles 0.1.2521 → 0.1.2653-next.71811ca

package/dist/compliance-transport.js

@@ -33,41 +33,32 @@ export const complianceDecisionSchema = Type.Object({ status: Type.Unknown({ des
 export function createComplianceDecisionTool(name, description) {
     return { name, description, parameters: complianceDecisionSchema, async execute(_id, params) { return { content: [{ type: "text", text: "审计决议已收" }], details: params, terminate: true }; } };
 }
-export async function prepareComplianceDispatch(model, context, label) {
-    const resolution = await context.modelRegistry.getProviderAuth(model.provider).catch((error) => { throw new Error(`${label} authentication failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error }); });
-    if (resolution === undefined)
-        throw new Error(`${label} authentication failed: provider is not configured: ${model.provider}`);
-    const auth = await context.modelRegistry.getApiKeyAndHeaders(model);
-    if (!auth.ok)
-        throw new Error(`${label} authentication failed: ${auth.error}`);
-    const env = auth.env ?? resolution.env;
-    return { model: resolution.auth.baseUrl ? { ...model, baseUrl: resolution.auth.baseUrl } : model, auth: { ...(auth.apiKey === undefined ? {} : { apiKey: auth.apiKey }), ...(auth.headers === undefined ? {} : { headers: auth.headers }), ...(env === undefined ? {} : { env }) } };
-}
 export const COMPLIANCE_RESPONSE_ENTRY_TYPE = "ak_compliance_response";
 export const AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE = "ak_auditor_parent_attempt_binding";
 export const AUDITOR_COMPLIANCE_FAILURE_ENTRY_TYPE = "ak_auditor_compliance_failure";
+import { attachDirectErrnoCode, sitianReport } from "./sitian-facade.js";
 export class ComplianceResponseRetentionError extends Error {
-    constructor(message, options) { super(message, options); this.name = "ComplianceResponseRetentionError"; }
-}
-/** Unique owner for session custom-entry append with availability check and typed failure. */
-export function appendActiveSessionCustomEntry(context, customType, data, labels = {}) {
-    const manager = context.sessionManager;
-    if (typeof manager?.appendCustomEntry !== "function") {
-        throw new ComplianceResponseRetentionError(labels.unavailable ?? "session custom entry append is unavailable");
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ComplianceResponseRetentionError";
+        attachDirectErrnoCode(this, options?.cause);
     }
+}
+function retainComplianceResponse(context, response) {
     try {
-        return manager.appendCustomEntry(customType, data);
+        sitianReport({
+            level: "event",
+            kind: "auditor",
+            cwd: context.cwd,
+            sessionParent: context.sessionManager.getSessionFile(),
+            payload: { version: 1, response },
+            source: "compliance-transport",
+        });
     }
     catch (error) {
-        throw new ComplianceResponseRetentionError(labels.failed ?? "session custom entry append failed", { cause: error });
+        throw new ComplianceResponseRetentionError(`compliance response retention failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
     }
 }
-function retainComplianceResponse(context, response) {
-    appendActiveSessionCustomEntry(context, COMPLIANCE_RESPONSE_ENTRY_TYPE, { version: 1, response }, {
-        unavailable: "compliance response retention is unavailable",
-        failed: "compliance response retention failed",
-    });
-}
 function readListField(value) { return Array.isArray(value) ? value : value === undefined ? [] : [value]; }
 export function readComplianceCandidate(arguments_, usage) {
     if (typeof arguments_ !== "object" || arguments_ === null || Array.isArray(arguments_)) {
@@ -93,7 +84,7 @@ export async function runComplianceAudit(options) {
         roleLabel: options.roleLabel,
         context: options.context,
         retainResponse: (response) => retainComplianceResponse(options.context, response),
-        ...(options.runCompletion === undefined ? {} : { runCompletion: options.runCompletion }),
+        ...(options.runDirectory === undefined ? {} : { runDirectory: options.runDirectory }),
         ...(options.signal === undefined ? {} : { signal: options.signal }),
     });
     if (receipt.noReceiptLifecycle !== undefined) {

package/dist/doctor-contracts.js

@@ -1,7 +1,6 @@
 import { Type } from "typebox";
 import { canonicalJson } from "./canonical-json.js";
 import { openToolObjectFromUnion } from "./open-tool-schema.js";
-import { withInfrastructureFailureDeclaration } from "./package-contracts/terminating-infrastructure.js";
 export const DOCTOR_EVIDENCE_TOOL_NAME = "ak_doctor_evidence";
 export const DOCTOR_OUTPUT_TOOL_NAME = "ak_doctor_output";
 export const DOCTOR_ACCEPTED_TEXT = "太医署回执已接受";
@@ -50,7 +49,7 @@ const doctorSubmissionVariants = Type.Union([
         missingEvidence: Type.Array(Type.Object({ need: nonblank, targetKeys: Type.Array(nonblank, { minItems: 1 }) }, { additionalProperties: false }), { minItems: 1, description: "如实证词所需而尚缺的证据" }),
     }, { additionalProperties: false, description: "证据不足以支撑如实案证词" }),
 ]);
-export const doctorSubmissionSchema = withInfrastructureFailureDeclaration(openToolObjectFromUnion(doctorSubmissionVariants));
+export const doctorSubmissionSchema = openToolObjectFromUnion(doctorSubmissionVariants);
 export const doctorOutputSchema = Type.Union([
     Type.Object({ status: Type.Literal("completed"), case: caseIdentity, findings: Type.Array(finding), cost }, { additionalProperties: false }),
     doctorSubmissionVariants.anyOf[1],

package/dist/dossier-resolution.js

@@ -36,30 +36,26 @@ export function resolveAuditDossier(env = process.env) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-/**
- * Judge subjects must already be on the parent session books before audit starts:
- * assignment (user message) + candidate verdict (sole judge output tool call).
- */
 export function readJudgeAuditSubjects(context) {
     const entries = context.sessionManager.getEntries?.() ?? [];
     let hasAssignment = false;
     let hasCandidate = false;
     for (const entry of entries) {
-        if (entry.type !== "message")
+        if (!isRecord(entry) || entry.type !== "message" || !isRecord(entry.message))
             continue;
         const message = entry.message;
         if (message.role === "user") {
             const text = typeof message.content === "string"
                 ? message.content
                 : Array.isArray(message.content)
-                    ? message.content.map((part) => (part.type === "text" ? part.text : "")).join("")
+                    ? message.content.map((part) => (isRecord(part) && part.type === "text" && typeof part.text === "string" ? part.text : "")).join("")
                     : "";
             if (text.trim().length > 0)
                 hasAssignment = true;
         }
         if (message.role === "assistant" && Array.isArray(message.content)) {
             for (const part of message.content) {
-                if (part.type === "toolCall" && part.name === JUDGE_OUTPUT_TOOL_NAME && isRecord(part.arguments)) {
+                if (isRecord(part) && part.type === "toolCall" && part.name === JUDGE_OUTPUT_TOOL_NAME && isRecord(part.arguments)) {
                     hasCandidate = true;
                 }
             }
@@ -79,7 +75,7 @@ export function readJudgeAuditSubjects(context) {
 export function readDoctorAuditSubjects(context) {
     const entries = context.sessionManager.getEntries?.() ?? [];
     for (const entry of entries) {
-        if (entry.type === "custom" && entry.customType === DOCTOR_CANDIDATE_ENTRY_TYPE) {
+        if (isRecord(entry) && entry.type === "custom" && entry.customType === DOCTOR_CANDIDATE_ENTRY_TYPE) {
             return { status: "ok" };
         }
     }

package/dist/engine-detour-tool.js

@@ -1,5 +1,12 @@
+/**
+ * Package-owned engine detour tool (#357 T2 / #378 / #380).
+ * Registered by shared role-runtime when any role + engine activation signal is present.
+ * Evidence-child legs install the same definition via customTools (no spawn in role modules).
+ * Engine process failures stop through the host infrastructure-failure seam.
+ * Caller AbortSignal cancellation propagates unchanged.
+ */
 import { Type } from "typebox";
-import { ENGINE_DETOUR_TOOL_NAME, engineDetourFailureDiagnostic, engineNameFromEnv, isEngineDetourFailure, runEngineDetourOnce, } from "./engine-detour.js";
+import { ENGINE_DETOUR_ALREADY_USED_DIAGNOSTIC, ENGINE_DETOUR_TOOL_NAME, engineDetourFailureDiagnostic, engineNameFromEnv, isEngineDetourFailure, runEngineDetourOnce, } from "./engine-detour.js";
 const engineDetourArgsSchema = Type.Object({
     argv: Type.Array(Type.String({ minLength: 1 }), {
         minItems: 1,
@@ -18,20 +25,26 @@ function isCallerCancellation(error, signal) {
     return false;
 }
 /**
- * Build one detour tool definition for a configured engine name.
+ * Build one once-latch detour tool definition for a configured engine name.
+ * `latch` is shared so parent registration can reset between activations.
  * `fail` owns host abort (parent) vs throw (evidence child) for tool misuse only.
  * Engine process failures (nonzero/empty/spawn) stop via `fail` with their cause.
  * Caller AbortSignal cancellation propagates unchanged.
  */
 export function createEngineDetourToolDefinition(input) {
+    const latch = input.latch ?? { used: false };
     const engineName = input.engineName;
     return {
         name: ENGINE_DETOUR_TOOL_NAME,
         label: "劳务引擎",
-        description: `运行一次劳务引擎子进程（engine=${engineName}），stdout 返回本 session。`,
+        description: `运行一次劳务引擎子进程（engine=${engineName}），stdout 返回本 session；每次激活至多一次。`,
         promptSnippet: "运行配置的劳务引擎一次并返回 stdout",
         parameters: engineDetourArgsSchema,
         async execute(toolCallId, params, signal, _onUpdate, ctx) {
+            if (latch.used) {
+                input.fail(new Error(ENGINE_DETOUR_ALREADY_USED_DIAGNOSTIC), toolCallId, ctx);
+            }
+            latch.used = true;
             const args = params;
             const argv = Array.isArray(args.argv) ? args.argv : [];
             if (argv.length === 0 || argv.some((part) => typeof part !== "string" || part.length === 0)) {
@@ -61,7 +74,6 @@ export function createEngineDetourToolDefinition(input) {
                 details: {
                     tool: ENGINE_DETOUR_TOOL_NAME,
                     code: result.code,
-                    stderr: result.stderr,
                 },
             };
         },
@@ -70,18 +82,31 @@ export function createEngineDetourToolDefinition(input) {
 /**
  * Register the engine-generic detour tool once for this process when any role has
  * an engine activation signal. Returns whether registration occurred.
+ * Once-latch is activation-scoped via the returned reset handle.
  */
-export function registerEngineDetourTool(pi, hostActions) {
+export function registerEngineDetourTool(roleHost, hostActions) {
     const engineName = engineNameFromEnv();
     if (engineName === undefined) {
-        return false;
+        return {
+            registered: false,
+            resetLatch() {
+                /* no-op when unregistered */
+            },
+        };
     }
+    const latch = { used: false };
     const definition = createEngineDetourToolDefinition({
         engineName,
+        latch,
         fail(error, toolCallId, ctx) {
             hostActions.failInfrastructure(error, ctx, toolCallId);
         },
     });
-    pi.registerTool(definition);
-    return true;
+    roleHost.registerTool(definition);
+    return {
+        registered: true,
+        resetLatch() {
+            latch.used = false;
+        },
+    };
 }

package/dist/engine-detour.js

@@ -22,6 +22,7 @@ export function applyEngineChildEnv(childEnv, engine) {
     }
 }
 export const ENGINE_DETOUR_EMPTY_STDOUT_DIAGNOSTIC = "劳务引擎 stdout 为空";
+export const ENGINE_DETOUR_ALREADY_USED_DIAGNOSTIC = "本激活内劳务引擎已使用";
 function abortReasonError(signal) {
     const reason = signal.reason;
     if (reason instanceof Error)