@akagilnc/pi-workflow-roles 0.1.5357 → 0.1.5368

package/dist/merger-contracts.js

@@ -1,6 +1,6 @@
 import { Type } from "typebox";
 import { exactUtf8 } from "./exact-utf8.js";
-import { openToolObjectFromUnion } from "./open-tool-schema.js";
+import { openToolObject } from "./open-tool-schema.js";
 import { withTerminatingOutputDeclarations } from "./package-contracts/terminating-infrastructure.js";
 const materialSchema = Type.Object({ bytesBase64: Type.String(), sha256: Type.String() }, { additionalProperties: false });
 const checkSchema = Type.Object({ name: Type.String({ minLength: 1 }), argv: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }) }, { additionalProperties: false });
@@ -14,11 +14,16 @@ const mergerInputSchema = Type.Object({
   authorizedChecks: Type.Array(checkSchema)
 }, { additionalProperties: false });
 const MERGER_STATUS_DESCRIPTION = "completed | escalate";
-const mergerOutputVariants = Type.Union([
-  Type.Object({ status: Type.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: Type.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), mergeCommitId: Type.String({ description: "\u5B8C\u6210\u5408\u5E76 commit object ID" }) }, { additionalProperties: false }),
-  Type.Object({ status: Type.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: Type.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), diagnosis: Type.String({ description: "\u5408\u5E76\u65E0\u6CD5\u6216\u4E0D\u5E94\u7531\u672C\u5E2D\u5B8C\u6210\u7684\u539F\u56E0\uFF08\u542B\u65E0\u8FDB\u884C\u4E2D\u5408\u5E76\u3001\u65E0\u6D3B\u53EF\u5E72\u3001\u9700\u65B0\u7684\u4EA7\u54C1/\u6743\u529B\u51B3\u5B9A\uFF09" }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }, { additionalProperties: false })
-]);
-const mergerOutputSchema = withTerminatingOutputDeclarations(openToolObjectFromUnion(mergerOutputVariants));
+const mergerOutputObject = Type.Object({
+  status: Type.Unknown({ description: MERGER_STATUS_DESCRIPTION }),
+  attemptId: Type.Unknown({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }),
+  report: Type.Unknown({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }),
+  mergeCommitId: Type.Unknown({ description: "\u5B8C\u6210\u5408\u5E76 commit object ID" }),
+  diagnosis: Type.Unknown({
+    description: "\u5408\u5E76\u65E0\u6CD5\u6216\u4E0D\u5E94\u7531\u672C\u5E2D\u5B8C\u6210\u7684\u539F\u56E0\uFF08\u542B\u65E0\u8FDB\u884C\u4E2D\u5408\u5E76\u3001\u65E0\u6D3B\u53EF\u5E72\u3001\u9700\u65B0\u7684\u4EA7\u54C1/\u6743\u529B\u51B3\u5B9A\uFF09"
+  })
+});
+const mergerOutputSchema = withTerminatingOutputDeclarations(openToolObject(mergerOutputObject));
 const MERGER_OUTPUT_TOOL_NAME = "ak_merger_output";
 const record = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 const blank = (v) => typeof v !== "string" || v.trim().length === 0;

package/dist/migrate-book-topology.js

@@ -214,6 +214,9 @@ function roleRunPlacement(ledgerHome, input) {
 function roleRunArtifactsDirectory(runDirectory) {
   return join3(runDirectory, "artifacts");
 }
+function isUnboundRunDirectory(runDirectory) {
+  return runDirectory.replaceAll("\\", "/").includes("/unbound/runs/");
+}
 var init_role_run_placement = __esm({
   "src/role-run-placement.ts"() {
     "use strict";
@@ -8010,29 +8013,6 @@ function described(name, schema) {
   if (typeof schema.description === "string") return schema;
   throw new Error(`Tool field ${name} has no semantic description at its schema owner`);
 }
-function declarationIdentity(schema) {
-  const { description: _description, ...semantic } = schema;
-  return JSON.stringify(semantic);
-}
-function openToolObjectFromUnion(schema) {
-  const declarations = /* @__PURE__ */ new Map();
-  for (const variant of schema.anyOf) {
-    for (const [name, declaration] of Object.entries(variant.properties ?? {})) {
-      const entries = declarations.get(name) ?? [];
-      const identity = declarationIdentity(declaration);
-      if (!entries.some((entry) => declarationIdentity(entry) === identity)) entries.push(declaration);
-      declarations.set(name, entries);
-    }
-  }
-  const properties = Object.fromEntries([...declarations].map(([name, entries]) => {
-    const descriptions = [...new Set(entries.map((entry) => entry.description).filter((value2) => typeof value2 === "string"))].join(" ");
-    const declaration = entries.length === 1 ? entries[0] : typebox_exports.Union(entries, descriptions === "" ? {} : { description: descriptions });
-    return [name, typebox_exports.Optional(described(name, declaration))];
-  }));
-  const object2 = typebox_exports.Object(properties, { additionalProperties: true });
-  object2.required = [];
-  return object2;
-}
 function openToolObject(schema) {
   const object2 = typebox_exports.Object(
     Object.fromEntries(Object.entries(schema.properties).map(([name, declaration]) => [
@@ -8202,7 +8182,7 @@ var init_reviewer_output = __esm({
 });
 
 // src/package-contracts/fixer-output.ts
-var FIXER_OUTPUT_TOOL_NAME, transportString, authorityBlockerSchema, prerequisiteBlockerSchema, blockerSchema, exceptionSchema, testEvidenceSchema, completedClassResultSchema, refusedClassResultSchema, classResultSchema, completedClassResultsSchema, PARTIALLY_COMPLETED_DEFINITION, FIXER_STATUS_DESCRIPTION, fixerOutputVariants, fixerOutputSchema;
+var FIXER_OUTPUT_TOOL_NAME, PARTIALLY_COMPLETED_DEFINITION, FIXER_STATUS_DESCRIPTION, fixerOutputObject, fixerOutputSchema;
 var init_fixer_output = __esm({
   "src/package-contracts/fixer-output.ts"() {
     "use strict";
@@ -8210,43 +8190,29 @@ var init_fixer_output = __esm({
     init_open_tool_schema();
     init_terminating_infrastructure();
     FIXER_OUTPUT_TOOL_NAME = "ak_fixer_output";
-    transportString = typebox_exports.String();
-    authorityBlockerSchema = typebox_exports.Object({ cause: typebox_exports.Optional(typebox_exports.Literal("authority_violation")), evidence: typebox_exports.Optional(transportString) });
-    prerequisiteBlockerSchema = typebox_exports.Object({ cause: typebox_exports.Optional(typebox_exports.Literal("prerequisite_unmet")), prerequisiteId: typebox_exports.Optional(transportString), evidence: typebox_exports.Optional(transportString) });
-    blockerSchema = typebox_exports.Union([authorityBlockerSchema, prerequisiteBlockerSchema]);
-    exceptionSchema = typebox_exports.Object({ where: typebox_exports.Optional(transportString), reason: typebox_exports.Optional(transportString) });
-    testEvidenceSchema = typebox_exports.Object({
-      contract: typebox_exports.Optional(typebox_exports.String({ description: "\u6D4B\u8BD5\u6539\u52A8\u6240\u8BC1\u660E\u7684\u5951\u7EA6" })),
-      minimumNecessaryCost: typebox_exports.Optional(typebox_exports.String({ description: "\u6D4B\u8BD5\u6539\u52A8\u7684\u4E00\u884C\u6700\u5C0F\u5FC5\u8981\u6210\u672C" })),
-      measuredDuration: typebox_exports.Optional(typebox_exports.String({ description: "\u805A\u7126\u9A8C\u8BC1\u5B9E\u6D4B\u65F6\u957F" }))
-    }, { description: "\u6D4B\u8BD5\u8BC1\u636E\u6761\uFF1Bdiff \u542B\u6D4B\u8BD5\u6539\u52A8\u65F6\u63D0\u4EA4\uFF1B\u673A\u5668\u4E0D\u6838\u9A8C\u3002" });
-    completedClassResultSchema = typebox_exports.Object({
-      name: typebox_exports.Optional(transportString),
-      disposition: typebox_exports.Optional(typebox_exports.Literal("completed")),
-      searchScope: typebox_exports.Optional(transportString),
-      exceptions: typebox_exports.Optional(typebox_exports.Array(exceptionSchema)),
-      commitSha: typebox_exports.Optional(transportString)
-    });
-    refusedClassResultSchema = typebox_exports.Object({
-      name: typebox_exports.Optional(transportString),
-      disposition: typebox_exports.Optional(typebox_exports.Literal("refused")),
-      remainingScope: typebox_exports.Optional(transportString),
-      blocker: typebox_exports.Optional(blockerSchema)
-    });
-    classResultSchema = typebox_exports.Union([completedClassResultSchema, refusedClassResultSchema]);
-    completedClassResultsSchema = typebox_exports.Array(completedClassResultSchema);
     PARTIALLY_COMPLETED_DEFINITION = "partially_completed \u53EA\u80FD\u5728\u6709\u5408\u6CD5\u62D2\u7EDD\u9879\uFF08\u5B8C\u6210\u9879\u4E0E\u5408\u6CD5\u62D2\u7EDD\u9879\u5E76\u5B58\uFF09\u65F6\u7528\uFF0C\u522B\u7684\u60C5\u51B5\u4E0D\u51C6\u7528\u3002";
     FIXER_STATUS_DESCRIPTION = `planned | completed | refused | unfinished | partially_completed\u3002unfinished \u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u81F4\u672C\u5C40\u672A\u5B8C\u6210\u65F6\u53EF\u7528\uFF0C\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002${PARTIALLY_COMPLETED_DEFINITION}`;
-    fixerOutputVariants = typebox_exports.Union([
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }),
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), remainingScope: typebox_exports.String({ description: "\u4F9D\u6CD5\u4E0D\u80FD\u5B8C\u6210\u7684\u5DE5\u4F5C\u8303\u56F4" }), blocker: typebox_exports.Unsafe({ ...blockerSchema, description: "\u5408\u6CD5\u963B\u65AD\u5B8C\u6210\u7684 blocker" }) }),
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), remainingScope: typebox_exports.String({ description: "\u672C\u5C40\u540E\u5269\u4F59\u5DE5\u4F5C" }), reason: typebox_exports.Optional(typebox_exports.String({ minLength: 1, description: "\u963B\u65AD\u539F\u56E0\uFF1A\u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u3002\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002" })), classResults: typebox_exports.Optional(typebox_exports.Unsafe({ ...completedClassResultsSchema, description: "\u672C\u5C40\u5DF2\u5B8C\u6210\u7684 class \u7ED3\u7B97" })), testEvidence: typebox_exports.Optional(testEvidenceSchema) }),
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), classResults: typebox_exports.Array(classResultSchema, { description: "\u5DF2\u5B8C\u6210\u7684 class \u7ED3\u7B97" }), testEvidence: typebox_exports.Optional(testEvidenceSchema) }),
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), classResults: typebox_exports.Array(classResultSchema, { description: "\u5404\u7C7B\u62D2\u7EDD\u7ED3\u7B97" }) }),
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), classResults: typebox_exports.Array(classResultSchema, { description: "\u5404\u7C7B\u5B8C\u6210\u6216\u62D2\u7EDD\u7ED3\u7B97" }), testEvidence: typebox_exports.Optional(testEvidenceSchema) })
-    ]);
+    fixerOutputObject = typebox_exports.Object({
+      status: typebox_exports.Unknown({ description: FIXER_STATUS_DESCRIPTION }),
+      report: typebox_exports.Unknown({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }),
+      remainingScope: typebox_exports.Unknown({
+        description: "\u672C\u5C40\u540E\u5269\u4F59\u5DE5\u4F5C\uFF1B\u4F9D\u6CD5\u4E0D\u80FD\u5B8C\u6210\u7684\u8303\u56F4\u4E5F\u5199\u6B64\u5904\u3002"
+      }),
+      blocker: typebox_exports.Unknown({
+        description: "\u5408\u6CD5\u963B\u65AD\u5B8C\u6210\u7684 blocker\uFF0C\u539F\u6837\u7559\u5B58\u3002\u53EF\u5199 cause\uFF08authority_violation \u6216 prerequisite_unmet\uFF09\u3001evidence\uFF1Bprerequisite_unmet \u8FD8\u53EF\u5199 prerequisiteId\u3002"
+      }),
+      reason: typebox_exports.Unknown({
+        description: "\u963B\u65AD\u539F\u56E0\uFF1A\u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u3002\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002"
+      }),
+      classResults: typebox_exports.Unknown({
+        description: "\u5404\u7C7B class \u7ED3\u7B97\uFF0C\u539F\u6837\u7559\u5B58\u3002\u5B8C\u6210\u9879\u7684 disposition \u4E3A completed\uFF0C\u53EF\u5199 name\u3001searchScope\u3001exceptions\uFF08where\u3001reason\uFF09\u3001commitSha\u3002\u62D2\u7EDD\u9879\u7684 disposition \u4E3A refused\uFF0C\u53EF\u5199 name\u3001remainingScope\u3001blocker\u3002"
+      }),
+      testEvidence: typebox_exports.Unknown({
+        description: "\u6D4B\u8BD5\u8BC1\u636E\u6761\uFF1Bdiff \u542B\u6D4B\u8BD5\u6539\u52A8\u65F6\u63D0\u4EA4\uFF1B\u673A\u5668\u4E0D\u6838\u9A8C\u3002\u53EF\u5199 contract\uFF08\u6D4B\u8BD5\u6539\u52A8\u6240\u8BC1\u660E\u7684\u5951\u7EA6\uFF09\u3001minimumNecessaryCost\uFF08\u6D4B\u8BD5\u6539\u52A8\u7684\u4E00\u884C\u6700\u5C0F\u5FC5\u8981\u6210\u672C\uFF09\u3001measuredDuration\uFF08\u805A\u7126\u9A8C\u8BC1\u5B9E\u6D4B\u65F6\u957F\uFF09\u3002"
+      })
+    });
     fixerOutputSchema = withTerminatingOutputDeclarations(
-      openToolObjectFromUnion(fixerOutputVariants)
+      openToolObject(fixerOutputObject)
     );
   }
 });
@@ -13665,7 +13631,7 @@ var init_canonical_json = __esm({
 });
 
 // src/doctor-contracts.ts
-var DOCTOR_OUTPUT_TOOL_NAME, DOCTOR_AUDIT_TOOL_NAME, DOCTOR_TARGET_KINDS, nonblank, evidenceIds, guardrail, lastRealBite, assetKinds, findingBody, finding, caseIdentity, DOCTOR_STATUS_DESCRIPTION, doctorSubmissionVariants, doctorSubmissionSchema, doctorEvidenceReadSchema;
+var DOCTOR_OUTPUT_TOOL_NAME, DOCTOR_AUDIT_TOOL_NAME, DOCTOR_TARGET_KINDS, DOCTOR_DISPOSITIONS, DOCTOR_PRESCRIPTION_KINDS, biteActual, biteNone, DOCTOR_BITE_KINDS, DOCTOR_STATUS_DESCRIPTION, doctorSubmissionObject, doctorSubmissionSchema, doctorEvidenceReadSchema;
 var init_doctor_contracts = __esm({
   "src/doctor-contracts.ts"() {
     "use strict";
@@ -13676,41 +13642,29 @@ var init_doctor_contracts = __esm({
     DOCTOR_OUTPUT_TOOL_NAME = "ak_doctor_output";
     DOCTOR_AUDIT_TOOL_NAME = "ak_doctor_audit_decision";
     DOCTOR_TARGET_KINDS = ["law", "gate", "template", "station", "seat"];
-    nonblank = typebox_exports.Optional(typebox_exports.String());
-    evidenceIds = typebox_exports.Optional(typebox_exports.Array(typebox_exports.String()));
-    guardrail = typebox_exports.Object({ answer: typebox_exports.Optional(typebox_exports.Boolean()), evidenceIds, explanation: nonblank }, { additionalProperties: true });
-    lastRealBite = typebox_exports.Union([
-      typebox_exports.Object({ kind: typebox_exports.Optional(typebox_exports.Literal("actual")), targetKey: nonblank, evidenceId: nonblank }, { additionalProperties: true }),
-      typebox_exports.Object({ kind: typebox_exports.Optional(typebox_exports.Literal("noRealBite")), targetKey: nonblank, eligibleEvidenceIds: evidenceIds }, { additionalProperties: true })
-    ]);
-    assetKinds = DOCTOR_TARGET_KINDS;
-    findingBody = {
-      evidenceIds,
-      disposition: typebox_exports.Optional(typebox_exports.Union([typebox_exports.Literal("keep"), typebox_exports.Literal("thin"), typebox_exports.Literal("delete")])),
-      guardrails: typebox_exports.Optional(typebox_exports.Object({ reproducibleFailure: guardrail, owningSeamOrInvariant: guardrail, deletionOrSimplificationSuffices: guardrail }, { additionalProperties: true })),
-      prescription: typebox_exports.Optional(typebox_exports.Object({ kind: typebox_exports.Optional(typebox_exports.Union([typebox_exports.Literal("retain"), typebox_exports.Literal("delete"), typebox_exports.Literal("simplify"), typebox_exports.Literal("patch"), typebox_exports.Literal("addMechanism")])), recommendation: nonblank, necessityExplanation: nonblank }, { additionalProperties: true })),
-      lastRealBite: typebox_exports.Optional(lastRealBite)
-    };
-    finding = typebox_exports.Union([
-      typebox_exports.Object({ targetKey: nonblank, observation: nonblank, evidenceIds }, { additionalProperties: true }),
-      typebox_exports.Object({ targetKey: nonblank, targetKind: typebox_exports.Optional(typebox_exports.Union(assetKinds.map((kind) => typebox_exports.Literal(kind)))), assetEvidence: typebox_exports.Optional(typebox_exports.Object({ targetKey: nonblank, targetKind: typebox_exports.Optional(typebox_exports.Union(assetKinds.map((kind) => typebox_exports.Literal(kind)))), evidenceId: nonblank }, { additionalProperties: true })), ...findingBody }, { additionalProperties: true })
-    ]);
-    caseIdentity = typebox_exports.Object({ issueNumber: typebox_exports.Optional(typebox_exports.Integer()), runsPath: nonblank }, { additionalProperties: true });
+    DOCTOR_DISPOSITIONS = ["keep", "thin", "delete"];
+    DOCTOR_PRESCRIPTION_KINDS = ["retain", "delete", "simplify", "patch", "addMechanism"];
+    biteActual = "actual";
+    biteNone = "noRealBite";
+    DOCTOR_BITE_KINDS = [biteActual, biteNone];
     DOCTOR_STATUS_DESCRIPTION = "completed | refused\u3002completed \u5141\u8BB8\u7A7A findings\uFF1Brefused \u4EC5\u5F53\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u6848\u8BC1\u8BCD";
-    doctorSubmissionVariants = typebox_exports.Union([
-      typebox_exports.Object({
-        status: typebox_exports.Unknown({ description: DOCTOR_STATUS_DESCRIPTION }),
-        case: typebox_exports.Unsafe({ ...caseIdentity, description: "\u7559\u5B58\u592A\u533B\u7F72\u6848\u8EAB\u4EFD" }),
-        findings: typebox_exports.Array(finding, { description: "\u53EF\u7A7A\u6216\u4EC5\u542B\u975E\u5904\u65B9\u6848\u89C2\u5BDF\uFF1B\u7F3A\u53EF\u590D\u7528\u8D44\u4EA7\u6216 bounded-bite \u8BC1\u636E\u53EA\u6392\u9664\u5BF9\u5E94\u8D44\u4EA7\u5904\u65B9" })
-      }, { additionalProperties: false, description: "\u5355\u6848\u8BC1\u8BCD\uFF0C\u4E0D\u8981\u6C42\u4EFB\u4F55\u5904\u65B9\u6216\u53EF\u590D\u7528 finding" }),
-      typebox_exports.Object({
-        status: typebox_exports.Unknown({ description: DOCTOR_STATUS_DESCRIPTION }),
-        reason: typebox_exports.String({ description: "\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u8BC1\u8BCD\u7684\u539F\u56E0" }),
-        missingEvidence: typebox_exports.Array(typebox_exports.Object({ need: nonblank, targetKeys: evidenceIds }, { additionalProperties: true }), { description: "\u5982\u5B9E\u8BC1\u8BCD\u6240\u9700\u800C\u5C1A\u7F3A\u7684\u8BC1\u636E" })
-      }, { additionalProperties: false, description: "\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u6848\u8BC1\u8BCD" })
-    ]);
+    doctorSubmissionObject = typebox_exports.Object({
+      status: typebox_exports.Unknown({ description: DOCTOR_STATUS_DESCRIPTION }),
+      case: typebox_exports.Unknown({
+        description: "\u7559\u5B58\u592A\u533B\u7F72\u6848\u8EAB\u4EFD\uFF0C\u539F\u6837\u7559\u5B58\uFF08\u5982 issueNumber\u3001runsPath\uFF09\u3002\u673A\u68B0\u5C42\u53E6\u6309\u7ED1\u5B9A run \u6295\u5F71\u6848\u8EAB\u4EFD\uFF0C\u4E0D\u5728\u672C\u5B57\u6BB5\u91CD\u5224\u3002"
+      }),
+      findings: typebox_exports.Unknown({
+        description: `\u9010\u6761\u8D44\u4EA7\u89C2\u5BDF\u4E0E\u5904\u65B9\uFF0C\u539F\u6837\u7559\u5B58\u3002\u4E00\u6761\u53EF\u542B targetKey\u3001targetKind\uFF08${DOCTOR_TARGET_KINDS.join(" | ")}\uFF09\u3001observation\u3001evidenceIds\u3001disposition\uFF08${DOCTOR_DISPOSITIONS.join(" | ")}\uFF09\u3001assetEvidence\uFF08targetKey\u3001targetKind\u3001evidenceId\uFF09\u3001guardrails\uFF08reproducibleFailure\u3001owningSeamOrInvariant\u3001deletionOrSimplificationSuffices\uFF0C\u5404\u9879\u53EF\u542B answer\u3001evidenceIds\u3001explanation\uFF09\u3001prescription\uFF08kind \u4E3A ${DOCTOR_PRESCRIPTION_KINDS.join(" | ")}\uFF0C\u53E6\u53EF\u5199 recommendation\u3001necessityExplanation\uFF09\u3001lastRealBite\uFF08kind \u4E3A ${DOCTOR_BITE_KINDS.join(" | ")}\uFF0C\u53E6\u53EF\u5199 targetKey\u3001evidenceId\u3001eligibleEvidenceIds\uFF09\u3002\u4E0D\u8981\u6C42\u4EFB\u4F55\u5904\u65B9\u6216\u53EF\u590D\u7528 finding\uFF1B\u7F3A\u53EF\u590D\u7528\u8D44\u4EA7\u6216 bounded-bite \u8BC1\u636E\u53EA\u6392\u9664\u5BF9\u5E94\u8D44\u4EA7\u5904\u65B9\u3002\u673A\u5668\u4E0D\u6838\u9A8C\u3002`
+      }),
+      reason: typebox_exports.Unknown({
+        description: "\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u8BC1\u8BCD\u7684\u539F\u56E0\uFF1B\u4EC5 refused \u65F6\u7528\u3002"
+      }),
+      missingEvidence: typebox_exports.Unknown({
+        description: "\u5982\u5B9E\u8BC1\u8BCD\u6240\u9700\u800C\u5C1A\u7F3A\u7684\u8BC1\u636E\uFF0C\u539F\u6837\u7559\u5B58\uFF08\u5982\u6BCF\u9879 need\u3001targetKeys\uFF09\u3002"
+      })
+    });
     doctorSubmissionSchema = withTerminatingOutputDeclarations(
-      openToolObjectFromUnion(doctorSubmissionVariants)
+      openToolObject(doctorSubmissionObject)
     );
     doctorEvidenceReadSchema = typebox_exports.Object({ evidenceId: typebox_exports.String({ minLength: 1, description: "\u5F85\u8BFB\u7559\u5B58\u8BC1\u636E\u6807\u8BC6" }), offset: typebox_exports.Optional(typebox_exports.Integer({ minimum: 0, description: "\u8D77\u59CB\u5B57\u8282\u504F\u79FB\uFF08\u4ECE 0 \u8BA1\uFF09" })), limit: typebox_exports.Optional(typebox_exports.Integer({ minimum: 1, description: "\u8FD4\u56DE\u5B57\u8282\u6570\uFF08\u65E0\u4E0A\u9650\uFF09" })) }, { additionalProperties: true });
   }
@@ -13726,7 +13680,7 @@ var init_exact_utf8 = __esm({
 });
 
 // src/merger-contracts.ts
-var materialSchema, checkSchema, mergerInputSchema, MERGER_STATUS_DESCRIPTION, mergerOutputVariants, mergerOutputSchema, MERGER_OUTPUT_TOOL_NAME;
+var materialSchema, checkSchema, mergerInputSchema, MERGER_STATUS_DESCRIPTION, mergerOutputObject, mergerOutputSchema, MERGER_OUTPUT_TOOL_NAME;
 var init_merger_contracts = __esm({
   "src/merger-contracts.ts"() {
     "use strict";
@@ -13746,11 +13700,16 @@ var init_merger_contracts = __esm({
       authorizedChecks: typebox_exports.Array(checkSchema)
     }, { additionalProperties: false });
     MERGER_STATUS_DESCRIPTION = "completed | escalate";
-    mergerOutputVariants = typebox_exports.Union([
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: typebox_exports.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), mergeCommitId: typebox_exports.String({ description: "\u5B8C\u6210\u5408\u5E76 commit object ID" }) }, { additionalProperties: false }),
-      typebox_exports.Object({ status: typebox_exports.Unknown({ description: MERGER_STATUS_DESCRIPTION }), attemptId: typebox_exports.String({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }), diagnosis: typebox_exports.String({ description: "\u5408\u5E76\u65E0\u6CD5\u6216\u4E0D\u5E94\u7531\u672C\u5E2D\u5B8C\u6210\u7684\u539F\u56E0\uFF08\u542B\u65E0\u8FDB\u884C\u4E2D\u5408\u5E76\u3001\u65E0\u6D3B\u53EF\u5E72\u3001\u9700\u65B0\u7684\u4EA7\u54C1/\u6743\u529B\u51B3\u5B9A\uFF09" }), report: typebox_exports.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }, { additionalProperties: false })
-    ]);
-    mergerOutputSchema = withTerminatingOutputDeclarations(openToolObjectFromUnion(mergerOutputVariants));
+    mergerOutputObject = typebox_exports.Object({
+      status: typebox_exports.Unknown({ description: MERGER_STATUS_DESCRIPTION }),
+      attemptId: typebox_exports.Unknown({ description: "\u5DF2\u53D7\u7406\u5408\u5E76 attempt \u8EAB\u4EFD" }),
+      report: typebox_exports.Unknown({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }),
+      mergeCommitId: typebox_exports.Unknown({ description: "\u5B8C\u6210\u5408\u5E76 commit object ID" }),
+      diagnosis: typebox_exports.Unknown({
+        description: "\u5408\u5E76\u65E0\u6CD5\u6216\u4E0D\u5E94\u7531\u672C\u5E2D\u5B8C\u6210\u7684\u539F\u56E0\uFF08\u542B\u65E0\u8FDB\u884C\u4E2D\u5408\u5E76\u3001\u65E0\u6D3B\u53EF\u5E72\u3001\u9700\u65B0\u7684\u4EA7\u54C1/\u6743\u529B\u51B3\u5B9A\uFF09"
+      })
+    });
+    mergerOutputSchema = withTerminatingOutputDeclarations(openToolObject(mergerOutputObject));
     MERGER_OUTPUT_TOOL_NAME = "ak_merger_output";
   }
 });
@@ -195184,9 +195143,6 @@ async function resolveMigratingRunTicket(runDirectory) {
     }
   };
 }
-function isUnboundRunDirectory(runDirectory) {
-  return runDirectory.replaceAll("\\", "/").includes("/unbound/runs/");
-}
 function bookHistoricalRoots(booksDirectory, backupBooksDirectory, bookKey) {
   return [join17(booksDirectory, bookKey), join17(backupBooksDirectory, bookKey)];
 }

package/dist/open-tool-schema.js

@@ -3,29 +3,6 @@ function described(name, schema) {
   if (typeof schema.description === "string") return schema;
   throw new Error(`Tool field ${name} has no semantic description at its schema owner`);
 }
-function declarationIdentity(schema) {
-  const { description: _description, ...semantic } = schema;
-  return JSON.stringify(semantic);
-}
-function openToolObjectFromUnion(schema) {
-  const declarations = /* @__PURE__ */ new Map();
-  for (const variant of schema.anyOf) {
-    for (const [name, declaration] of Object.entries(variant.properties ?? {})) {
-      const entries = declarations.get(name) ?? [];
-      const identity = declarationIdentity(declaration);
-      if (!entries.some((entry) => declarationIdentity(entry) === identity)) entries.push(declaration);
-      declarations.set(name, entries);
-    }
-  }
-  const properties = Object.fromEntries([...declarations].map(([name, entries]) => {
-    const descriptions = [...new Set(entries.map((entry) => entry.description).filter((value) => typeof value === "string"))].join(" ");
-    const declaration = entries.length === 1 ? entries[0] : Type.Union(entries, descriptions === "" ? {} : { description: descriptions });
-    return [name, Type.Optional(described(name, declaration))];
-  }));
-  const object = Type.Object(properties, { additionalProperties: true });
-  object.required = [];
-  return object;
-}
 function openToolObject(schema) {
   const object = Type.Object(
     Object.fromEntries(Object.entries(schema.properties).map(([name, declaration]) => [
@@ -38,6 +15,5 @@ function openToolObject(schema) {
   return object;
 }
 export {
-  openToolObject,
-  openToolObjectFromUnion
+  openToolObject
 };

package/dist/package-contracts/fixer-output.js

@@ -1,44 +1,30 @@
 import { Type } from "typebox";
-import { openToolObjectFromUnion } from "../open-tool-schema.js";
+import { openToolObject } from "../open-tool-schema.js";
 import { withTerminatingOutputDeclarations } from "./terminating-infrastructure.js";
 const FIXER_OUTPUT_TOOL_NAME = "ak_fixer_output";
-const transportString = Type.String();
-const authorityBlockerSchema = Type.Object({ cause: Type.Optional(Type.Literal("authority_violation")), evidence: Type.Optional(transportString) });
-const prerequisiteBlockerSchema = Type.Object({ cause: Type.Optional(Type.Literal("prerequisite_unmet")), prerequisiteId: Type.Optional(transportString), evidence: Type.Optional(transportString) });
-const blockerSchema = Type.Union([authorityBlockerSchema, prerequisiteBlockerSchema]);
-const exceptionSchema = Type.Object({ where: Type.Optional(transportString), reason: Type.Optional(transportString) });
-const testEvidenceSchema = Type.Object({
-  contract: Type.Optional(Type.String({ description: "\u6D4B\u8BD5\u6539\u52A8\u6240\u8BC1\u660E\u7684\u5951\u7EA6" })),
-  minimumNecessaryCost: Type.Optional(Type.String({ description: "\u6D4B\u8BD5\u6539\u52A8\u7684\u4E00\u884C\u6700\u5C0F\u5FC5\u8981\u6210\u672C" })),
-  measuredDuration: Type.Optional(Type.String({ description: "\u805A\u7126\u9A8C\u8BC1\u5B9E\u6D4B\u65F6\u957F" }))
-}, { description: "\u6D4B\u8BD5\u8BC1\u636E\u6761\uFF1Bdiff \u542B\u6D4B\u8BD5\u6539\u52A8\u65F6\u63D0\u4EA4\uFF1B\u673A\u5668\u4E0D\u6838\u9A8C\u3002" });
-const completedClassResultSchema = Type.Object({
-  name: Type.Optional(transportString),
-  disposition: Type.Optional(Type.Literal("completed")),
-  searchScope: Type.Optional(transportString),
-  exceptions: Type.Optional(Type.Array(exceptionSchema)),
-  commitSha: Type.Optional(transportString)
-});
-const refusedClassResultSchema = Type.Object({
-  name: Type.Optional(transportString),
-  disposition: Type.Optional(Type.Literal("refused")),
-  remainingScope: Type.Optional(transportString),
-  blocker: Type.Optional(blockerSchema)
-});
-const classResultSchema = Type.Union([completedClassResultSchema, refusedClassResultSchema]);
-const completedClassResultsSchema = Type.Array(completedClassResultSchema);
 const PARTIALLY_COMPLETED_DEFINITION = "partially_completed \u53EA\u80FD\u5728\u6709\u5408\u6CD5\u62D2\u7EDD\u9879\uFF08\u5B8C\u6210\u9879\u4E0E\u5408\u6CD5\u62D2\u7EDD\u9879\u5E76\u5B58\uFF09\u65F6\u7528\uFF0C\u522B\u7684\u60C5\u51B5\u4E0D\u51C6\u7528\u3002";
 const FIXER_STATUS_DESCRIPTION = `planned | completed | refused | unfinished | partially_completed\u3002unfinished \u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u81F4\u672C\u5C40\u672A\u5B8C\u6210\u65F6\u53EF\u7528\uFF0C\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002${PARTIALLY_COMPLETED_DEFINITION}`;
-const fixerOutputVariants = Type.Union([
-  Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }) }),
-  Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), remainingScope: Type.String({ description: "\u4F9D\u6CD5\u4E0D\u80FD\u5B8C\u6210\u7684\u5DE5\u4F5C\u8303\u56F4" }), blocker: Type.Unsafe({ ...blockerSchema, description: "\u5408\u6CD5\u963B\u65AD\u5B8C\u6210\u7684 blocker" }) }),
-  Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), remainingScope: Type.String({ description: "\u672C\u5C40\u540E\u5269\u4F59\u5DE5\u4F5C" }), reason: Type.Optional(Type.String({ minLength: 1, description: "\u963B\u65AD\u539F\u56E0\uFF1A\u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u3002\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002" })), classResults: Type.Optional(Type.Unsafe({ ...completedClassResultsSchema, description: "\u672C\u5C40\u5DF2\u5B8C\u6210\u7684 class \u7ED3\u7B97" })), testEvidence: Type.Optional(testEvidenceSchema) }),
-  Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), classResults: Type.Array(classResultSchema, { description: "\u5DF2\u5B8C\u6210\u7684 class \u7ED3\u7B97" }), testEvidence: Type.Optional(testEvidenceSchema) }),
-  Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), classResults: Type.Array(classResultSchema, { description: "\u5404\u7C7B\u62D2\u7EDD\u7ED3\u7B97" }) }),
-  Type.Object({ status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }), report: Type.String({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }), classResults: Type.Array(classResultSchema, { description: "\u5404\u7C7B\u5B8C\u6210\u6216\u62D2\u7EDD\u7ED3\u7B97" }), testEvidence: Type.Optional(testEvidenceSchema) })
-]);
+const fixerOutputObject = Type.Object({
+  status: Type.Unknown({ description: FIXER_STATUS_DESCRIPTION }),
+  report: Type.Unknown({ description: "\u5982\u5B9E\u7ED3\u679C\u62A5\u544A" }),
+  remainingScope: Type.Unknown({
+    description: "\u672C\u5C40\u540E\u5269\u4F59\u5DE5\u4F5C\uFF1B\u4F9D\u6CD5\u4E0D\u80FD\u5B8C\u6210\u7684\u8303\u56F4\u4E5F\u5199\u6B64\u5904\u3002"
+  }),
+  blocker: Type.Unknown({
+    description: "\u5408\u6CD5\u963B\u65AD\u5B8C\u6210\u7684 blocker\uFF0C\u539F\u6837\u7559\u5B58\u3002\u53EF\u5199 cause\uFF08authority_violation \u6216 prerequisite_unmet\uFF09\u3001evidence\uFF1Bprerequisite_unmet \u8FD8\u53EF\u5199 prerequisiteId\u3002"
+  }),
+  reason: Type.Unknown({
+    description: "\u963B\u65AD\u539F\u56E0\uFF1A\u7F3A\u524D\u7F6E\u6216\u8FDD\u5BAA\u7EA6\u675F\u3002\u7F3A\u5F85\u51B3 owner \u51B3\u5B9A\u6216\u7B54\u590D\u5C5E\u7F3A\u524D\u7F6E\u3002"
+  }),
+  classResults: Type.Unknown({
+    description: "\u5404\u7C7B class \u7ED3\u7B97\uFF0C\u539F\u6837\u7559\u5B58\u3002\u5B8C\u6210\u9879\u7684 disposition \u4E3A completed\uFF0C\u53EF\u5199 name\u3001searchScope\u3001exceptions\uFF08where\u3001reason\uFF09\u3001commitSha\u3002\u62D2\u7EDD\u9879\u7684 disposition \u4E3A refused\uFF0C\u53EF\u5199 name\u3001remainingScope\u3001blocker\u3002"
+  }),
+  testEvidence: Type.Unknown({
+    description: "\u6D4B\u8BD5\u8BC1\u636E\u6761\uFF1Bdiff \u542B\u6D4B\u8BD5\u6539\u52A8\u65F6\u63D0\u4EA4\uFF1B\u673A\u5668\u4E0D\u6838\u9A8C\u3002\u53EF\u5199 contract\uFF08\u6D4B\u8BD5\u6539\u52A8\u6240\u8BC1\u660E\u7684\u5951\u7EA6\uFF09\u3001minimumNecessaryCost\uFF08\u6D4B\u8BD5\u6539\u52A8\u7684\u4E00\u884C\u6700\u5C0F\u5FC5\u8981\u6210\u672C\uFF09\u3001measuredDuration\uFF08\u805A\u7126\u9A8C\u8BC1\u5B9E\u6D4B\u65F6\u957F\uFF09\u3002"
+  })
+});
 const fixerOutputSchema = withTerminatingOutputDeclarations(
-  openToolObjectFromUnion(fixerOutputVariants)
+  openToolObject(fixerOutputObject)
 );
 function validateFixerOutput(value, _phase) {
   return value;

package/dist/public-cli/auto-resume.js

@@ -155,7 +155,7 @@ function jsonSafeReplacer() {
  * + O_NOFOLLOW where the platform provides it (a planted symlink is never
  * followed) — mirrors settlement.ts's own hardened artifact writers.
  */
-async function writeHardenedArtifactFile(artifactsDir, namePrefix, payload) {
+export async function writeHardenedArtifactFile(artifactsDir, namePrefix, payload) {
     const filePath = join(artifactsDir, `${namePrefix}-${randomUUID()}.json`);
     const body = `${JSON.stringify(payload, jsonSafeReplacer(), 2)}\n`;
     const noFollowFlag = typeof fsConstants.O_NOFOLLOW === "number" ? fsConstants.O_NOFOLLOW : 0;

package/dist/public-cli/cli.js

@@ -3,19 +3,19 @@ import { piDurablePrincipalAuthority } from "../pi/durable-principal.js";
  * Public ak-role CLI dispatcher (roles / config / layered help / Judge run).
  */
 import { realpath } from "node:fs/promises";
-import { join } from "node:path";
 import { packageMachineHome } from "../activation-ledger-topology.js";
 import { assertLegalEngineModel, assertLegalEngineName, pickEngineAxis, } from "../package-resources/engine-material.js";
 import { resolveConfiguredProvinceOfficer, } from "../institutional-resolution.js";
-import { clearPersistentSeatConfig, effectiveSeatConfigurations, formatModelSpec, isGateOfficerSeat, loadCredentialProviders, loadPublicCliConfig, missingResolvedSeatModelMessage, parseModelSpec, resolveEffectiveSeat, resolvedSeatWithModel, savePublicCliConfig, setAutoResumeLimit, setPersistentSeatConfig, setPersistentSeatEngine, setPersistentSeatEngineModel, setPersistentSeatHost, validatePublicCliConfigAxes, } from "./config.js";
-import { loadHostProvidersTable, projectHostFacingProvider, renderHostProvidersTable, } from "./host-providers.js";
+import { clearPersistentSeatConfig, effectiveSeatConfigurations, formatModelSpec, isGateOfficerSeat, loadCredentialProviders, loadPublicCliConfig, missingResolvedSeatModelMessage, parseModelSpec, resolveEffectiveSeat, savePublicCliConfig, setAutoResumeLimit, setPersistentSeatConfig, setPersistentSeatEngine, setPersistentSeatEngineModel, setPersistentSeatHost, resolvePublicAgentDir, validatePublicCliConfigAxes, } from "./config.js";
+import { loadHostProvidersTable, renderHostProvidersTable, } from "./host-providers.js";
 import { packagedModelParent } from "../packaged-role-registry.js";
 import { seatModelOnly } from "./registry.js";
 import { CliUsageError } from "./cli-errors.js";
 import { runMachineSkillSetup } from "./machine-method-skills.js";
 import { presentLocatedResumeFailure, } from "./post-admission.js";
 import { appendPiSessionCustomEntry } from "../pi/role-turn-host.js";
-import { composeRoleTurnHostAdapters, formatHostSelectionFailure, HostSelectionError, selectRoleTurnHost, } from "./role-turn-host-resolution.js";
+import { openRoleSeatRuntime } from "./role-seat-runtime.js";
+import { formatHostSelectionFailure, HostSelectionError, } from "./role-turn-host-resolution.js";
 import { parseAnalystArgv, parsePublicSeatArgv, } from "./invocation.js";
 import { createTypedOptionConsumer, optionsForOwner, projectCommandHelp, projectOwnerOptions, PUBLIC_NAVIGATOR_HELP_NOTE, PUBLIC_ROLE_OPTION_OWNERS, renderHumanOwnerOptionLines, } from "./option-definitions.js";
 import { TurnDispatchedFailure } from "./auto-resume.js";
@@ -89,43 +89,41 @@ function takePublicGlobalFlag(argv, index, options) {
 function createRoleEnvironment(env, options, 
 /** #178: after host selection, before missing-model — structural argv parse once. */
 afterHost) {
-    const role = options.role;
     const extraPiArgs = env.extraPiArgs;
     const timeoutMs = env.timeoutMs;
-    // #617/#178/#788/#840: host first, then model; nested child seat selects own host.
-    const hostAdapters = composeRoleTurnHostAdapters({
-        packageRoot: env.packageRoot,
-        ...(env.roleTurnHost === undefined ? {} : { roleTurnHost: env.roleTurnHost }),
-        ...(env.hostAdapters === undefined ? {} : { hostAdapters: env.hostAdapters }),
-        ...(extraPiArgs === undefined ? {} : { extraPiArgs }),
-        ...(timeoutMs === undefined ? {} : { timeoutMs }),
-    }, env.principalAuthority);
-    const roleTurnHost = selectRoleTurnHost(hostAdapters, {
-        role,
+    const opened = openRoleSeatRuntime({
+        resolution: {
+            packageRoot: env.packageRoot,
+            ...(env.roleTurnHost === undefined ? {} : { roleTurnHost: env.roleTurnHost }),
+            ...(env.hostAdapters === undefined ? {} : { hostAdapters: env.hostAdapters }),
+            ...(extraPiArgs === undefined ? {} : { extraPiArgs }),
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+        },
+        principalAuthority: env.principalAuthority,
+        role: options.role,
         seat: options.seat,
+        home: options.home,
+        ...(afterHost === undefined ? {} : { afterHost }),
     });
-    // #178: host → argv (afterHost) → missing-model → provider projection.
-    afterHost?.();
-    const seatWithModel = resolvedSeatWithModel(options.seat);
-    if (seatWithModel === undefined) {
+    if (!opened.ok) {
         // Direct CLI has --model; dual remediation is intentional here (#178 / #916).
         throw new CliUsageError(missingResolvedSeatModelMessage(options.seat.seat, "invocation-or-config"));
     }
-    const hostFacingSelection = projectHostFacingProvider(seatWithModel.selection, seatWithModel.host, loadHostProvidersTable(options.home), options.home);
     return {
         home: options.home,
         principalAuthority: env.principalAuthority,
         agentDir: options.agentDir,
         sessionAppender: appendPiSessionCustomEntry,
         packageRoot: env.packageRoot,
-        roleTurnHost,
-        hostAdapters,
+        roleTurnHost: opened.roleTurnHost,
+        hostAdapters: opened.hostAdapters,
         cwd: options.cwd,
         ...(options.credentials === undefined ? {} : { credentials: options.credentials }),
         ...(env.correlationId === undefined ? {} : { correlationId: env.correlationId }),
-        ...(hostFacingSelection === undefined ? {} : { model: hostFacingSelection }),
-        ...projectSeatEngine(options.seat),
-        ...projectSeatHost(options.seat),
+        ...(opened.model === undefined ? {} : { model: opened.model }),
+        ...(opened.engine === undefined ? {} : { engine: opened.engine }),
+        ...(opened.engineModel === undefined ? {} : { engineModel: opened.engineModel }),
+        host: opened.host,
         ...(timeoutMs === undefined ? {} : { timeoutMs }),
         ...(env.createRunId === undefined ? {} : { createRunId: env.createRunId }),
         ...(options.config?.autoResumeLimit === undefined
@@ -138,18 +136,31 @@ afterHost) {
         ...(env.signal === undefined ? {} : { signal: env.signal }),
     };
 }
+/** Shared preamble for a new public role command and an explicit resume. */
+async function loadPublicRoleDispatchParts(env, home) {
+    const agentDir = resolvePublicAgentDir(env.agentDir, home);
+    const cwd = env.cwd ?? process.cwd();
+    const config = await loadAndValidateConfig(home, env.packageRoot);
+    const credentials = env.credentials ?? (await loadCredentialProviders(agentDir));
+    return { agentDir, cwd, config, credentials };
+}
 /**
  * #178 single spine: resolve seat → host select → argv parse once → missing-model → run.
  * Keeps host-unregistered ahead of bad argv and missing-model.
  */
 async function dispatchPublicRoleCommand(env, home, io, parsed, role, parse, run) {
-    const agentDir = resolveAgentDir(env, home);
-    const cwd = env.cwd ?? process.cwd();
-    const config = await loadAndValidateConfig(home, env.packageRoot);
-    const credentials = env.credentials ?? (await loadCredentialProviders(agentDir));
-    const seat = resolveEffectiveSeat(config, role, credentials, invocationFromParsed(parsed));
+    const parts = await loadPublicRoleDispatchParts(env, home);
+    const seat = resolveEffectiveSeat(parts.config, role, parts.credentials, invocationFromParsed(parsed));
     let parsedRoleArgv;
-    const result = await run(parsed.args, createRoleEnvironment(env, { role, home, agentDir, cwd, credentials, seat, config }, () => {
+    const result = await run(parsed.args, createRoleEnvironment(env, {
+        role,
+        home,
+        agentDir: parts.agentDir,
+        cwd: parts.cwd,
+        credentials: parts.credentials,
+        seat,
+        config: parts.config,
+    }, () => {
         parsedRoleArgv = parse(parsed.args);
     }), () => parsedRoleArgv);
     return {
@@ -176,11 +187,6 @@ function defaultIo() {
 function resolveHome(env) {
     return env.home ?? packageMachineHome();
 }
-function resolveAgentDir(env, home) {
-    return (env.agentDir ??
-        process.env.PI_CODING_AGENT_DIR ??
-        join(home, ".pi", "agent"));
-}
 function parseThinking(value) {
     // #683: opaque pass-through — no local whitelist.
     return value;
@@ -316,14 +322,6 @@ function requireCallableSeat(seat, axis, verb) {
         throw new CliUsageError(`unknown ${axis}-axis seat: ${seat}`);
     }
 }
-/** Single seat engine axis → run-options projection (#391 E2 / #883). */
-function projectSeatEngine(seat) {
-    return pickEngineAxis(seat);
-}
-/** Single seat.host → run-options projection (#595 / #617). */
-function projectSeatHost(seat) {
-    return { host: seat.host };
-}
 function loadAndValidateConfig(home, packageRoot) {
     return loadPublicCliConfig(home).then((config) => {
         try {
@@ -787,7 +785,7 @@ export async function runAkRole(argv, env) {
             }
             const config = await loadAndValidateConfig(home, env.packageRoot);
             const credentials = env.credentials ??
-                (await loadCredentialProviders(resolveAgentDir(env, home)));
+                (await loadCredentialProviders(resolvePublicAgentDir(env.agentDir, home)));
             const seats = effectiveSeatConfigurations(config, credentials, invocationFromParsed(parsed));
             io.stdout(renderRoles(seats));
             return { exitCode: 0 };
@@ -829,23 +827,20 @@ export async function runAkRole(argv, env) {
                 runId: resumeRequest.runId,
                 authority: env.principalAuthority ?? piDurablePrincipalAuthority,
             };
-            const agentDir = resolveAgentDir(env, home);
-            const cwd = env.cwd ?? process.cwd();
-            const config = await loadAndValidateConfig(home, env.packageRoot);
-            const credentials = env.credentials ?? (await loadCredentialProviders(agentDir));
+            const parts = await loadPublicRoleDispatchParts(env, home);
             const resumeRole = await peekRoleRunRole(home, resumeRequest.runId);
             // Missing durable role keeps the judge seat table. The resume entry
             // itself is one function; it reads the stored run.
             const seatRole = resumeRole ?? "judge";
-            const seat = resolveEffectiveSeat(config, seatRole, credentials, invocationFromParsed(parsed));
+            const seat = resolveEffectiveSeat(parts.config, seatRole, parts.credentials, invocationFromParsed(parsed));
             const result = await runPublicInstructionSeatResume(resumeRequest, createRoleEnvironment(env, {
                 role: seatRole,
                 home,
-                agentDir,
-                cwd,
-                credentials,
+                agentDir: parts.agentDir,
+                cwd: parts.cwd,
+                credentials: parts.credentials,
                 seat,
-                config,
+                config: parts.config,
             }), io);
             let current = result;
             while (current.exitCode === 0 && current.admitted?.correlationId !== undefined
@@ -860,9 +855,15 @@ export async function runAkRole(argv, env) {
                 const parentRole = await peekRoleRunRole(home, parentRunId);
                 if (parentRole === undefined)
                     break;
-                const parentSeat = resolveEffectiveSeat(config, parentRole, credentials, invocationFromParsed(parsed));
+                const parentSeat = resolveEffectiveSeat(parts.config, parentRole, parts.credentials, invocationFromParsed(parsed));
                 const parentEnv = createRoleEnvironment(env, {
-                    role: parentRole, home, agentDir, cwd, credentials, seat: parentSeat, config,
+                    role: parentRole,
+                    home,
+                    agentDir: parts.agentDir,
+                    cwd: parts.cwd,
+                    credentials: parts.credentials,
+                    seat: parentSeat,
+                    config: parts.config,
                 });
                 current = await continueParentAfterChild(parentRunId, current.admitted, parentEnv, io);
             }

package/dist/public-cli/config.js

@@ -490,6 +490,9 @@ function credentialProvidersFromAuthData(data) {
     xai: Object.prototype.hasOwnProperty.call(record, "xai")
   };
 }
+function resolvePublicAgentDir(explicit, home) {
+  return explicit ?? process.env.PI_CODING_AGENT_DIR ?? join(home, ".pi", "agent");
+}
 async function loadCredentialProviders(agentDir) {
   try {
     const raw = await readFile(join(agentDir, "auth.json"), "utf8");
@@ -519,6 +522,7 @@ export {
   providerConfigured,
   publicCliConfigPath,
   resolveEffectiveSeat,
+  resolvePublicAgentDir,
   resolvedSeatWithModel,
   savePublicCliConfig,
   setAutoResumeLimit,