@akagilnc/pi-workflow-roles 0.1.5842 → 0.1.5853

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

@@ -16,7 +16,6 @@ import { projectThrownFailureLeaf } from "../public-cli/settlement.js";
 import { renderSystemPromptOverride, resolveBoundHostSessionId, } from "../prepared-role-turn.js";
 import { copyAndRecordHostDossier, recordNativeSessionPointer, } from "../host-session-record.js";
 import { closeJsonSchemaForCodex, codexTurnArgs, headlessMcpConfigDocument, headlessTurnArgs, isClaudePrintDescription, isCodexExecDescription, } from "./description.js";
-import { NAVIGATOR_OUTPUT_TOOL_NAME } from "../package-contracts/navigator-output.js";
 import { errorText, isRecord } from "../unknown-value.js";
 /**
  * True when a parsed stdout object is the typed result receipt (or a single-doc
@@ -312,7 +311,6 @@ function buildTurnArgs(options) {
         if (options.sessionKind === "resume" && !options.sessionId) {
             throw new Error("codex resume requires a bound thread_id");
         }
-        // Codex always mounts --output-schema when the path is supplied (incl. navigator byStatus #1160).
         return codexTurnArgs({
             systemPromptPath: options.systemPromptPath,
             ...(options.outputSchemaPath === undefined ? {} : { outputSchemaPath: options.outputSchemaPath }),
@@ -335,7 +333,6 @@ function buildTurnArgs(options) {
     return headlessTurnArgs({
         description: options.description,
         systemPromptPath: options.systemPromptPath,
-        // #959: navigator omits --json-schema so free-form prose is a lawful exit.
         ...(options.jsonSchema === undefined ? {} : { jsonSchema: options.jsonSchema }),
         mcpConfigPath: options.mcpConfigPath,
         ...(options.model === undefined ? {} : { model: options.model }),
@@ -349,10 +346,6 @@ export function createHeadlessRoleTurnHost(config) {
         const prepared = await config.prepare(request);
         const systemPrompt = renderSystemPromptOverride(prepared.systemPrompt);
         const codex = isCodexExecDescription(config.description);
-        // #1160: one exit-mode decision per turn — direct navigator free prose vs structured.
-        // Attendance sets request.navigatorByStatusPrepare; direct ak-role navigator does not.
-        const navigatorProseExit = prepared.terminatingToolName === NAVIGATOR_OUTPUT_TOOL_NAME
-            && request.navigatorByStatusPrepare !== true;
         let outcome = failure("session", "HeadlessNoOutcome", "no-outcome");
         try {
             // Claude mints a package UUID for --session-id; codex waits for thread.started.
@@ -386,17 +379,14 @@ export function createHeadlessRoleTurnHost(config) {
                     if (codex) {
                         // #1148: Codex --output-schema requires a native strict transport schema.
                         // Project from the unique open declaration; do not alter package receipt rules.
-                        if (!navigatorProseExit) {
-                            outputSchemaPath = join(inputsDirectory, "output-schema.json");
-                            deliveredSchema = closeJsonSchemaForCodex(prepared.jsonSchema);
-                            await writeFile(outputSchemaPath, `${JSON.stringify(deliveredSchema, null, 2)}\n`, "utf8");
-                        }
+                        outputSchemaPath = join(inputsDirectory, "output-schema.json");
+                        deliveredSchema = closeJsonSchemaForCodex(prepared.jsonSchema);
+                        await writeFile(outputSchemaPath, `${JSON.stringify(deliveredSchema, null, 2)}\n`, "utf8");
                     }
                     else {
                         mcpConfigPath = join(inputsDirectory, "mcp-config.json");
                         await writeFile(mcpConfigPath, `${JSON.stringify(headlessMcpConfigDocument(prepared.mcpServers), null, 2)}\n`, "utf8");
-                        if (!navigatorProseExit)
-                            deliveredSchema = prepared.jsonSchema;
+                        deliveredSchema = prepared.jsonSchema;
                     }
                     startedWithSchema = deliveredSchema;
                 }
@@ -425,8 +415,7 @@ export function createHeadlessRoleTurnHost(config) {
                                 args = buildTurnArgs({
                                     description: config.description,
                                     systemPromptPath,
-                                    // Direct navigator prose exit omits --json-schema; byStatus prepare mounts it.
-                                    ...(navigatorProseExit ? {} : { jsonSchema: prepared.jsonSchema }),
+                                    jsonSchema: prepared.jsonSchema,
                                     mcpServers: prepared.mcpServers,
                                     ...(mcpConfigPath === undefined ? {} : { mcpConfigPath }),
                                     ...(outputSchemaPath === undefined ? {} : { outputSchemaPath }),
@@ -566,14 +555,7 @@ export function createHeadlessRoleTurnHost(config) {
                                     const deliverReply = async () => {
                                         if (!observation.turnCompleted || observation.finalMessage === undefined)
                                             return undefined;
-                                        if (navigatorProseExit) {
-                                            // Direct ak-role navigator: free-form agent_message is the prose body.
-                                            if (observation.finalMessage.trim() === "")
-                                                return undefined;
-                                            await prepared.ingestStructuredOutput({ prose: observation.finalMessage });
-                                            return deliveredFromSpawned(spawned);
-                                        }
-                                        // Structured seats (incl. #1160 byStatus prepare): native JSON receipt.
+                                        // Native JSON receipt.
                                         let receipt;
                                         try {
                                             receipt = JSON.parse(observation.finalMessage);
@@ -621,13 +603,6 @@ export function createHeadlessRoleTurnHost(config) {
                                 if (envelope.structured_output !== undefined) {
                                     await prepared.ingestStructuredOutput(envelope.structured_output);
                                 }
-                                else if (navigatorProseExit
-                                    && typeof envelope.result === "string"
-                                    && envelope.result.trim() !== "") {
-                                    // #959: direct navigator prose exit — free-form result text is the body
-                                    // when structured_output is absent (json-schema omitted).
-                                    await prepared.ingestStructuredOutput({ prose: envelope.result });
-                                }
                                 return deliveredFromSpawned(spawned);
                             }
                             catch (error) {

package/dist/migrate-book-topology.js

@@ -8712,6 +8712,9 @@ var init_navigator_output = __esm({
       }),
       byStatus: typebox_exports.Unknown({
         description: "\u6309\u4E3B\u8859\u95E8\u7ED3\u5C40 status \u9884\u5199\u7684\u6563\u6587\u5EFA\u8BAE\u3002\u952E\u4E3A status \u5B57\u9762\u91CF\uFF0C\u503C\u4E3A\u5EFA\u8BAE\u6B63\u6587\u3002\u7ED3\u7B97\u65F6\u4EE3\u7801\u53EA\u6309\u5B9E\u9645 status \u53D6\u5BF9\u5E94\u539F\u6587\uFF0C\u4E0D\u89E3\u6790\u5EFA\u8BAE\u8BED\u4E49\u3002"
+      }),
+      byRole: typebox_exports.Unknown({
+        description: "\u6574\u5F20\u8DEF\u7EBF\u8868\uFF1A\u952E\u4E3A\u8859\u95E8\u89D2\u8272\uFF0C\u503C\u4E3A\u8BE5\u8859\u95E8 status \u2192 \u5EFA\u8BAE\u3002\u76F4\u63A5\u5165\u53E3\u4E0D\u7ED9\u89D2\u8272\u65F6\u4F7F\u7528\u3002"
       })
     };
     navigatorAdviceBodySchema = openToolObject(typebox_exports.Object(navigatorAdviceFields));
@@ -9258,8 +9261,6 @@ var init_packaged_role_registry = __esm({
         settlement: "sealed",
         /** Factory board: court until another station has started, then marshal. */
         boardPlacement: "judge-history",
-        /** Navigator subject is the public admitted instruction when the run is bound. */
-        navigatorSubject: "public-instruction",
         activationStage: "load-and-install",
         receiptStatusKey: "status",
         sessionMaterials: [
@@ -9288,8 +9289,6 @@ var init_packaged_role_registry = __esm({
           reportPhase: true
         },
         boardPlacement: "marshal",
-        /** #1168: dispatch is first message; navigator reads admitted instruction. */
-        navigatorSubject: "public-instruction",
         activationFlags: [
           { field: "phase", flag: "ak-fixer-phase", binds: "phase" }
         ],
@@ -9318,8 +9317,6 @@ var init_packaged_role_registry = __esm({
         artifactFace: {
           reportPhase: true
         },
-        /** #1168: dispatch is first message; navigator reads admitted instruction. */
-        navigatorSubject: "public-instruction",
         activationFlags: [
           { field: "phase", flag: "ak-coder-phase", binds: "phase" }
         ],
@@ -9413,8 +9410,6 @@ var init_packaged_role_registry = __esm({
         artifactFace: {
           doctorReportFacts: true
         },
-        /** Navigator subject is the doctor case, not the case-path file bytes. */
-        navigatorSubject: "case",
         activationFlags: [
           { field: "casePath", from: "caseRunsPath", flag: "ak-doctor-case", binds: "input" }
         ],
@@ -9469,8 +9464,6 @@ var init_packaged_role_registry = __esm({
         gateStageLabel: "\u7B26\u5B9D\u90CE",
         /** Gate summon binds --source-run and keeps dialogue off the argv. */
         gateSummon: "source-run",
-        /** Navigator subject is the source-run locator, not the path file bytes. */
-        navigatorSubject: "source-run",
         activationFlags: [
           { field: "sourceRun", from: "sourceRunPath", flag: "ak-notary-source-run", binds: "input" },
           { field: "ticketNumber", flag: "ak-notary-ticket-number" }
@@ -9608,12 +9601,14 @@ var init_packaged_role_registry = __esm({
         role: "navigator",
         inCallAutoResume: false,
         presentSettled: "always",
-        summonResume: true,
+        summonResume: false,
         admission: "instruction",
         sameParent: "none",
         phases: [null],
         outputTool: NAVIGATOR_OUTPUT_TOOL_NAME,
         settlement: "accepted",
+        /** #1192: structured target seat for the lookup run; no host flag (no host runs it). */
+        activationFlags: [{ field: "forRole" }],
         activationStage: "load-and-install",
         sessionMaterials: ["CLAUDE.md", "souls/navigator.md"]
       },
@@ -10489,7 +10484,7 @@ function publicOptionTable() {
   }
   return { global: GLOBAL_OPTIONS, ...roles, analyst: ANALYST_OPTIONS };
 }
-var GLOBAL_OPTIONS, SHARED_PROJECT_SEMANTICS, SHARED_ATTACH_SEMANTICS, SHARED_PHASE_SEMANTICS, GLEANER_LEFT_OPTIONS, AUDITOR_OPTIONS, CODER_OPTIONS, FIXER_OPTIONS, REVIEWER_OPTIONS, COLLECTOR_OPTIONS, DOCTOR_OPTIONS, NOTARY_OPTIONS, INSPECTOR_OPTIONS, MERGER_OPTIONS, ANALYST_OPTIONS, SEAT_OPTION_ROWS, PUBLIC_OPTION_TABLE, PUBLIC_ROLE_OPTION_OWNERS, TOP_LEVEL_HELP, ROLE_COMMAND_HELP, SUPPORT_COMMAND_HELP, PUBLIC_COMMAND_HELP;
+var GLOBAL_OPTIONS, SHARED_PROJECT_SEMANTICS, SHARED_ATTACH_SEMANTICS, SHARED_PHASE_SEMANTICS, GLEANER_LEFT_OPTIONS, AUDITOR_OPTIONS, CODER_OPTIONS, FIXER_OPTIONS, REVIEWER_OPTIONS, COLLECTOR_OPTIONS, DOCTOR_OPTIONS, NAVIGATOR_OPTIONS, NOTARY_OPTIONS, INSPECTOR_OPTIONS, MERGER_OPTIONS, ANALYST_OPTIONS, SEAT_OPTION_ROWS, PUBLIC_OPTION_TABLE, PUBLIC_ROLE_OPTION_OWNERS, TOP_LEVEL_HELP, ROLE_COMMAND_HELP, SUPPORT_COMMAND_HELP, PUBLIC_COMMAND_HELP;
 var init_option_definitions = __esm({
   "src/public-cli/option-definitions.ts"() {
     "use strict";
@@ -10801,6 +10796,23 @@ var init_option_definitions = __esm({
         }
       }
     ];
+    NAVIGATOR_OPTIONS = [
+      ...projectAndAttach("navigator"),
+      {
+        id: "role",
+        owner: "navigator",
+        canonical: "--role",
+        aliases: [],
+        valueMetavar: "role",
+        required: false,
+        repeatable: false,
+        form: "option",
+        description: {
+          en: "Optional seat whose status \u2192 advice rows to show; omitted shows the whole table. The instruction text is not read.",
+          zh: "\u53EF\u9009\u8859\u95E8\u89D2\u8272\uFF1A\u53EA\u663E\u793A\u8BE5\u8859\u95E8\u7684 status \u2192 \u5EFA\u8BAE\uFF1B\u7F3A\u7701\u663E\u793A\u6574\u5F20\u8868\u3002instruction \u6B63\u6587\u4E0D\u8BFB\u3002"
+        }
+      }
+    ];
     NOTARY_OPTIONS = [
       bindOwner("notary", SHARED_PROJECT_SEMANTICS),
       {
@@ -10994,7 +11006,8 @@ var init_option_definitions = __esm({
       merger: MERGER_OPTIONS,
       notary: NOTARY_OPTIONS,
       auditor: AUDITOR_OPTIONS,
-      inspector: INSPECTOR_OPTIONS
+      inspector: INSPECTOR_OPTIONS,
+      navigator: NAVIGATOR_OPTIONS
     };
     PUBLIC_OPTION_TABLE = publicOptionTable();
     PUBLIC_ROLE_OPTION_OWNERS = [
@@ -11114,10 +11127,11 @@ var init_option_definitions = __esm({
       },
       navigator: {
         command: "navigator",
-        summary: "Direct Navigator (\u6E38\u5955\u4F7F) free-form prose route advice.",
-        usage: ["ak-role navigator [options] [instruction]"],
+        summary: "Direct Navigator (\u6E38\u5955\u4F7F) status \u2192 next-station advice table lookup; no model call.",
+        usage: ["ak-role navigator [--role <role>] [options] [instruction]"],
         examples: [
-          'ak-role navigator "\u521A\u5B8C\u6210 coder apply \u6536\u655B\uFF0C\u4E0B\u4E00\u6B65\uFF1F"'
+          "ak-role navigator",
+          "ak-role navigator --role coder"
         ]
       },
       auditor: {
@@ -11262,6 +11276,7 @@ var init_invocation = __esm({
     init_notary_source_run();
     init_cli_errors();
     init_option_definitions();
+    init_registry();
     init_unknown_value();
   }
 });