@akagilnc/pi-workflow-roles 0.1.3648 → 0.1.3652

package/dist/packaged-role-registry.js

@@ -11,7 +11,6 @@ import { COUNTERSIGN_OUTPUT_TOOL_NAME } from "./countersign-contracts.js";
 import { GLEANER_LEFT_OUTPUT_TOOL_NAME } from "./gleaner-left-contracts.js";
 import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.js";
 import { AUDITOR_OUTPUT_TOOL_NAME } from "./package-contracts/auditor-output.js";
-import { EVIDENCE_CHILD_OUTPUT_TOOL_NAME } from "./package-contracts/evidence-child-output.js";
 import {
   DIARIST_OUTPUT_TOOL_NAME,
   DIARIST_SOURCES_FLAG
@@ -36,12 +35,6 @@ const AUDITOR_PUBLIC_SESSION_MATERIALS = [
   "souls/audit-law.md",
   "souls/quality-law.md"
 ];
-const EVIDENCE_CHILD_SESSION_MATERIALS = [
-  "CLAUDE.md",
-  "souls/evidence-child.md",
-  "souls/audit-law.md",
-  "souls/quality-law.md"
-];
 const PUBLIC_ROLE_RECORDS = [
   {
     role: "judge",
@@ -195,7 +188,7 @@ const PUBLIC_ROLE_RECORDS = [
     activationStage: "load-and-install",
     sessionMaterials: ["CLAUDE.md", "souls/navigator.md"]
   },
-  // #675: 审刑院 / evidence-child are roles like any other — public ak-role entries.
+  // #675: 审刑院 is a role like any other — public ak-role entry. (#744: evidence-child deleted)
   {
     role: "auditor",
     phases: [null],
@@ -205,15 +198,6 @@ const PUBLIC_ROLE_RECORDS = [
     activationStage: "load-and-install",
     sessionMaterials: AUDITOR_PUBLIC_SESSION_MATERIALS
   },
-  {
-    role: "evidence-child",
-    phases: [null],
-    outputTool: EVIDENCE_CHILD_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
-    activationStage: "load-and-install",
-    sessionMaterials: EVIDENCE_CHILD_SESSION_MATERIALS
-  },
   // #708 / ADR 0075 `diarist-is-role`: 起居郎 is a seat like any other. The
   // frozen source catalog rides the shared input-flag seam; it is absent for a
   // true-unbound summons (no ticket → no diary).
@@ -246,7 +230,6 @@ function packagedRoleOutputTool(role) {
 }
 export {
   AUDITOR_PUBLIC_SESSION_MATERIALS,
-  EVIDENCE_CHILD_SESSION_MATERIALS,
   INSPECTOR_SESSION_MATERIALS,
   NOTARY_SESSION_MATERIALS,
   PACKAGED_ROLE_REGISTRY,

package/dist/pi/adapter.js

@@ -0,0 +1,211 @@
+import { parseSkillBlock, } from "@earendil-works/pi-coding-agent";
+import { requireGatekeeperPass } from "../gatekeeper-pass-envelope.js";
+import { createOAuthKeepalive } from "../oauth-keepalive.js";
+import { createRoleRuntimeExtension } from "../role-runtime.js";
+import { renderAgentStartMaterials } from "../agent-start-materials.js";
+const piContexts = new WeakMap();
+/** Pi-only entrypoint adapter around the host-neutral shared composition. */
+export function createPiRoleRuntimeExtension(dependencies, options = {}) {
+    return (pi) => createRoleRuntimeExtension(dependencies)(createPiRoleHostAdapter(pi, options));
+}
+/** Project Pi's activation context onto the package-owned host contract. */
+function projectPiContext(context, transcriptFromContext) {
+    const sessionManager = context.sessionManager;
+    const host = {
+        cwd: context.cwd,
+        mode: context.mode,
+        model: context.model === undefined ? undefined : { provider: context.model.provider },
+        sessionManager: {
+            getLeafEntry: () => context.sessionManager.getLeafEntry(),
+            getLeafId: () => context.sessionManager.getLeafId(),
+            getEntries: () => context.sessionManager.getEntries(),
+            getSessionDir: () => context.sessionManager.getSessionDir(),
+            getSessionFile: () => context.sessionManager.getSessionFile(),
+            getHeader: () => context.sessionManager.getHeader(),
+            setSessionFile: (path) => sessionManager.setSessionFile(path),
+            appendCustomEntry: (customType, data) => sessionManager.appendCustomEntry(customType, data),
+        },
+        ...(context.signal === undefined ? {} : { signal: context.signal }),
+        ...(context.ui === undefined ? {} : { ui: { notify: (message, type) => context.ui.notify(message, type) } }),
+        ...(transcriptFromContext === undefined ? {} : { transcript: () => transcriptFromContext(context) }),
+        abort: () => context.abort(),
+    };
+    piContexts.set(host, context);
+    return host;
+}
+/** Recover the Pi context only at the Pi composition boundary. */
+export function toPiContext(context) {
+    const piContext = piContexts.get(context);
+    if (piContext === undefined)
+        throw new Error("Host context is not backed by the Pi adapter");
+    return piContext;
+}
+/** Gatekeeper receives HostContext directly (#518 §1③) without recovering raw ExtensionContext via WeakMap. */
+function requirePiGatekeeperPass(options) {
+    return requireGatekeeperPass({
+        context: options.context,
+        subject: options.subject,
+        ...(options.signal === undefined ? {} : { signal: options.signal }),
+        hostActions: {
+            failInfrastructure(error, _context, toolCallId) {
+                options.hostActions.failInfrastructure(error, options.context, toolCallId);
+            },
+            bindSubmissionNonPass: options.hostActions.bindSubmissionNonPass,
+        },
+        toolCallId: options.toolCallId,
+    });
+}
+function toPiResult(result) {
+    return result;
+}
+/** Fold a host before_agent_start return: push readingMaterial into the provider-visible
+ * systemPrompt via the shared renderer and strip the typed field before Pi sees it. */
+function foldBeforeAgentStartReturn(result) {
+    if (result === undefined || result === null || typeof result !== "object")
+        return undefined;
+    const record = result;
+    const { systemPrompt, readingMaterial } = record;
+    const folded = readingMaterial === undefined
+        ? systemPrompt
+        : renderAgentStartMaterials(systemPrompt ?? "", [readingMaterial]);
+    return folded === undefined ? {} : { systemPrompt: folded };
+}
+function toPiToolDefinition(tool, projectContext) {
+    return {
+        name: tool.name,
+        label: tool.label,
+        description: tool.description,
+        ...(tool.promptSnippet === undefined ? {} : { promptSnippet: tool.promptSnippet }),
+        parameters: tool.parameters,
+        execute: async (toolCallId, params, signal, update, context) => toPiResult(await tool.execute(toolCallId, params, signal, update === undefined ? undefined : (result) => update(toPiResult(result)), projectContext(context))),
+    };
+}
+/** Pi composition boundary. Each consumed capability is adapted explicitly. */
+export function createPiRoleHostAdapter(pi, options = {}) {
+    const keepalive = createOAuthKeepalive(options.oauthKeepalive);
+    const host = {
+        deliverSubmissionRejection(rejection) {
+            pi.sendMessage({
+                customType: "ak-role-submission-rejection",
+                content: "The terminal submission was rejected because it was not the sole tool call in its turn. Correct the call pattern and resubmit.",
+                display: true,
+                details: rejection,
+            }, { triggerTurn: true, deliverAs: "followUp" });
+        },
+        capabilities: {
+            skillExpansion(prompt) {
+                const parsed = parseSkillBlock(prompt);
+                if (parsed == null)
+                    return undefined;
+                const userMessage = parsed.userMessage ?? "";
+                return Object.freeze({
+                    name: parsed.name,
+                    location: parsed.location,
+                    content: parsed.content,
+                    userMessage,
+                });
+            },
+        },
+        registerFlag: (name, definition) => pi.registerFlag(name, definition),
+        getFlag: (name) => pi.getFlag(name),
+        registerTool: (tool) => pi.registerTool(toPiToolDefinition(tool, (context) => projectPiContext(context, options.transcriptFromContext))),
+        getAllTools: () => pi.getAllTools().map(({ name, sourceInfo }) => ({
+            name,
+            ...(sourceInfo?.path === undefined ? {} : { sourceInfo: { path: sourceInfo.path } }),
+        })),
+        setActiveTools: (names) => pi.setActiveTools(names),
+        getActiveTools: () => pi.getActiveTools(),
+        requireGatekeeperPass: requirePiGatekeeperPass,
+        on(...registration) {
+            const context = (value) => projectPiContext(value, options.transcriptFromContext);
+            if (registration[0] === "before_agent_start") {
+                const [, handler] = registration;
+                pi.on("before_agent_start", (value, ctx) => {
+                    const result = handler({ prompt: value.prompt, systemPrompt: value.systemPrompt, systemPromptOptions: value.systemPromptOptions }, context(ctx));
+                    if (result instanceof Promise)
+                        return result.then(foldBeforeAgentStartReturn);
+                    return foldBeforeAgentStartReturn(result);
+                });
+            }
+            else if (registration[0] === "input") {
+                const [, handler] = registration;
+                pi.on("input", (value, ctx) => handler({ text: value.text, ...(value.images === undefined ? {} : { images: value.images }), source: value.source }, context(ctx)));
+            }
+            else if (registration[0] === "tool_call") {
+                const [, handler] = registration;
+                pi.on("tool_call", (value, ctx) => handler({ toolName: value.toolName, toolCallId: value.toolCallId, input: value.input }, context(ctx)));
+            }
+            else if (registration[0] === "tool_result") {
+                const [, handler] = registration;
+                pi.on("tool_result", (value, ctx) => handler({ toolName: value.toolName, toolCallId: value.toolCallId, isError: value.isError, content: (value.content ?? []).map((part) => part.type === "text" ? { type: "text", text: part.text } : { type: "image", data: part.data, mimeType: part.mimeType }), details: value.details }, context(ctx)));
+            }
+            else if (registration[0] === "session_start") {
+                const [, handler] = registration;
+                pi.on("session_start", (value, ctx) => handler({ reason: value.reason }, context(ctx)));
+            }
+            else if (registration[0] === "session_shutdown") {
+                const [, handler] = registration;
+                pi.on("session_shutdown", (_value, ctx) => handler({}, context(ctx)));
+            }
+            else if (registration[0] === "after_provider_response") {
+                const [, handler] = registration;
+                pi.on("after_provider_response", (value, ctx) => handler({ status: value.status }, context(ctx)));
+            }
+            else if (registration[0] === "agent_end") {
+                const [, handler] = registration;
+                pi.on("agent_end", (value, ctx) => handler({
+                    messages: value.messages.map((message) => ({
+                        role: message.role,
+                        content: "content" in message && Array.isArray(message.content) ? message.content.map((part) => part.type === "text"
+                            ? { type: "text", text: part.text }
+                            : part.type === "toolCall"
+                                ? { type: "toolCall", id: part.id, name: part.name, arguments: part.arguments }
+                                : { type: part.type }) : [],
+                        ...("toolName" in message && typeof message.toolName === "string" ? { toolName: message.toolName } : {}),
+                        ...("isError" in message && typeof message.isError === "boolean" ? { isError: message.isError } : {}),
+                        ...("stopReason" in message && typeof message.stopReason === "string" ? { stopReason: message.stopReason } : {}),
+                    })),
+                }, context(ctx)));
+            }
+            else if (registration[0] === "turn_end") {
+                const [, handler] = registration;
+                pi.on("turn_end", (value, ctx) => handler({
+                    turnIndex: value.turnIndex,
+                    calls: value.toolResults.map((result) => ({
+                        toolCallId: result.toolCallId,
+                        toolName: result.toolName,
+                    })),
+                }, context(ctx)));
+            }
+            else if (registration[0] === "agent_settled") {
+                const [, handler] = registration;
+                pi.on("agent_settled", (_value, ctx) => handler({}, context(ctx)));
+            }
+            else if (registration[0] === "tool_execution_start") {
+                const [, handler] = registration;
+                pi.on("tool_execution_start", (value, ctx) => handler({ toolName: value.toolName, toolCallId: value.toolCallId }, context(ctx)));
+            }
+            else if (registration[0] === "tool_execution_update") {
+                const [, handler] = registration;
+                pi.on("tool_execution_update", (value, ctx) => handler({ toolName: value.toolName, toolCallId: value.toolCallId, partialResult: value.partialResult }, context(ctx)));
+            }
+            else {
+                const [, handler] = registration;
+                pi.on("tool_execution_end", (value, ctx) => handler({ toolName: value.toolName, toolCallId: value.toolCallId, isError: value.isError }, context(ctx)));
+            }
+        },
+        ...(typeof pi.getCommands === "function" ? { getCommands: () => pi.getCommands().map(({ name }) => ({ name })) } : {}),
+    };
+    return {
+        host,
+        appendEntry: (customType, data) => pi.appendEntry(customType, data),
+        sendMessage: (message, sendOptions) => pi.sendMessage({
+            customType: message.customType,
+            content: message.content,
+            display: message.display ?? false,
+            details: message.details,
+        }, sendOptions),
+        startKeepalive: (context) => keepalive.start(toPiContext(context)),
+        stopKeepalive: () => keepalive.stop(),
+    };
+}

package/dist/pi/role-turn-host.js

@@ -127,8 +127,6 @@ function buildActivationFlagArgs(activation) {
             return ["--ak-role", "navigator"];
         case "auditor":
             return ["--ak-role", "auditor"];
-        case "evidence-child":
-            return ["--ak-role", "evidence-child"];
         case "diarist":
             return [
                 "--ak-role",

package/dist/public-cli/instruction-seat-run.js

@@ -1,11 +1,11 @@
 import { engineSessionMaterialFromOptions } from "../package-resources/engine-material.js";
 import { readRunTicketNumber } from "../run-ticket-number.js";
 import { CliUsageError } from "./cli-errors.js";
-import { admitAuditorInvocation, admitEvidenceChildInvocation, admitGatekeeperInvocation, admitNavigatorInvocation, bindAdmittedTicketNumber, buildInstructionTransportPrompt, persistAdmittedSourceRunPath, } from "./invocation.js";
+import { admitAuditorInvocation, admitGatekeeperInvocation, admitNavigatorInvocation, bindAdmittedTicketNumber, buildInstructionTransportPrompt, persistAdmittedSourceRunPath, } from "./invocation.js";
 import { prepareSummonsResumeMaterials, runPostAdmissionOneShot, runPostAdmissionSeatResume, resumeTurnRequestProjectionOptions, } from "./post-admission.js";
 import { loadResumableInstructionSeatRun, markRunAdmitted, } from "./run-lifecycle.js";
 import { applyInstructionTicketProbe, probeInstructionTicket, ticketNumberFromProbe, tryResumeSameTicketSeatRun, } from "./seat-ticket-binding.js";
-import { presentStructuralRejection, readEngineDetourInfrastructureFailure, trySettleAuditorTerminalResult, trySettleEvidenceChildTerminalResult, trySettleGatekeeperTerminalResult, trySettleNavigatorTerminalResult, } from "./settlement.js";
+import { presentStructuralRejection, readEngineDetourInfrastructureFailure, trySettleAuditorTerminalResult, trySettleGatekeeperTerminalResult, trySettleNavigatorTerminalResult, } from "./settlement.js";
 import { projectRoleTurnRequest, } from "./turn-request.js";
 /** Project an admitted instruction-seat invocation onto the host-neutral turn request. */
 export function buildInstructionSeatTurnRequest(admitted, options) {
@@ -25,8 +25,6 @@ function instructionSeatAdapters(options) {
                     return trySettleNavigatorTerminalResult(admitted, authority, scope);
                 case "auditor":
                     return trySettleAuditorTerminalResult(admitted, authority, scope);
-                case "evidence-child":
-                    return trySettleEvidenceChildTerminalResult(admitted, authority, scope);
             }
         },
         // Accepted receipts and failure terminals both present via shared path.
@@ -58,8 +56,6 @@ async function admitInstructionSeat(role, options) {
             return admitNavigatorInvocation(options);
         case "auditor":
             return admitAuditorInvocation(options);
-        case "evidence-child":
-            return admitEvidenceChildInvocation(options);
     }
 }
 export async function runPublicInstructionSeatResume(request, env, io) {

package/dist/public-cli/invocation.js

@@ -369,9 +369,6 @@ export function parseNavigatorArgv(args) {
 export function parseAuditorArgv(args) {
     return parseInstructionArgv(args, "auditor");
 }
-export function parseEvidenceChildArgv(args) {
-    return parseInstructionArgv(args, "evidence-child");
-}
 export function parseDiaristArgv(args) {
     return parseInstructionArgv(args, "diarist");
 }
@@ -621,10 +618,6 @@ export async function admitNavigatorInvocation(options) {
 export async function admitAuditorInvocation(options) {
     return admitStandardMaterialInvocation("auditor", options);
 }
-/** Admit a public evidence-child run (#675). */
-export async function admitEvidenceChildInvocation(options) {
-    return admitStandardMaterialInvocation("evidence-child", options);
-}
 /**
  * Admit a direct Diarist (起居郎) run (#708): freeze attachments, persist the
  * request, reserve session placement — same instruction-seat face.