@akagilnc/pi-workflow-roles 0.1.5845 → 0.1.5853

package/dist/navigator-attendance.js

@@ -1,393 +1,49 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import {} from "typebox";
+import { mintNavigatorInvocationId, NAVIGATOR_INVOCATION_ENTRY } from "./navigator-invocation-identity.js";
 import {
-  NAVIGATOR_INVOCATION_ENTRY,
-  NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
-  mintNavigatorInvocationId
-} from "./navigator-invocation-identity.js";
-import { PACKAGED_ROLE_REGISTRY } from "./packaged-role-registry.js";
-import {
-  activationBookDirectory,
-  resolveActivationLedgerHome
-} from "./activation-ledger-topology.js";
-import { createNativeNavigatorSessionFactory } from "./navigator-public-session.js";
-import {
-  NAVIGATOR_PREPARE_TOOL_NAME,
   NavigatorUnavailableError,
-  navigatorModelSettingPath,
-  navigatorProviderFailure,
-  navigatorProviderFailureFromDiagnostics,
-  navigatorProviderFailureFromError,
-  navigatorProviderFailureFromPublicTerminal,
-  navigatorProviderFailureFromStatus,
-  navigatorUnavailableError,
-  parseNavigatorModelSetting,
-  readNavigatorModelSetting,
-  resolveNavigatorSeatSelection,
-  writeNavigatorModelSetting
-} from "./navigator-session-contracts.js";
-import { sitianReport } from "./sitian-facade.js";
-import { issueRoot, subjectPath } from "./work-subject-identity.js";
-import { createReceiptDeliveryPolicy } from "./receipt-delivery-policy.js";
-import {
-  byStatusToPlainObject,
-  mergePreparedAdvice,
-  navigatorAdviceBodySchema,
-  pickPreparedProse,
-  preparedAdviceFromUnknown
-} from "./package-contracts/navigator-output.js";
-import { sha256Hex } from "./sha256.js";
-import { isRecord } from "./unknown-value.js";
+  navigatorUnavailableError
+} from "./navigator-lookup.js";
+import { pickPreparedProse } from "./package-contracts/navigator-output.js";
+import { subjectPath } from "./work-subject-identity.js";
 const NAVIGATOR_EVENT_TYPE = "ak-navigator-attendance";
-const NAVIGATOR_TARGETS = PACKAGED_ROLE_REGISTRY.map(({ role, phases }) => ({ role, phases }));
-const prepareSchema = navigatorAdviceBodySchema;
-const INVOCATION_ENTRY = NAVIGATOR_INVOCATION_ENTRY;
-const SETTLEMENT_ENTRY = "ak-navigator-settlement";
-const unavailableKeys = /* @__PURE__ */ new Set(["context", "session", "model", "thinking", "auth", "quota", "transport", "unknown"]);
-function unavailableKey(value) {
-  return typeof value === "string" && unavailableKeys.has(value) ? value : void 0;
-}
-function rejectedPrepareReason(entries, start) {
-  const recent = entries.slice(start);
-  const prepareCalls = /* @__PURE__ */ new Set();
-  for (const entry of recent) {
-    if (!isRecord(entry) || entry.type !== "message" || !isRecord(entry.message) || entry.message.role !== "assistant" || !Array.isArray(entry.message.content)) continue;
-    for (const part of entry.message.content) {
-      if (isRecord(part) && part.type === "toolCall" && part.name === NAVIGATOR_PREPARE_TOOL_NAME && typeof part.id === "string") prepareCalls.add(part.id);
-    }
-  }
-  let reason;
-  for (const entry of recent) {
-    if (!isRecord(entry) || entry.type !== "message" || !isRecord(entry.message) || entry.message.role !== "toolResult" || entry.message.isError !== true) continue;
-    const callId = entry.message.toolCallId;
-    if (entry.message.toolName !== NAVIGATOR_PREPARE_TOOL_NAME || typeof callId !== "string" || !prepareCalls.has(callId)) {
-      return void 0;
-    }
-    const content = entry.message.content;
-    const text = Array.isArray(content) ? content.flatMap((part) => isRecord(part) && typeof part.text === "string" ? [part.text] : []).join("") : typeof content === "string" ? content : "";
-    if (text.trim() !== "") reason = text.trim();
-  }
-  return reason;
-}
-function normalizePreparedAdvice(value) {
-  return preparedAdviceFromUnknown(value);
-}
-function navigatorSubjectKey(subjectRoot, subject, provenance = "role_input") {
-  if (issueRoot(subjectRoot) !== void 0 || !subjectRoot.includes("/.ak/work/")) return subjectRoot;
-  if (provenance === "placeholder") return subjectRoot;
-  const normalized = subject.trim().replace(/\s+/g, " ");
-  if (normalized === "") return subjectRoot;
-  return `${subjectRoot}#${sha256Hex(normalized).slice(0, 32)}`;
-}
-function navigatorSubjectKeyForInput(subjectRoot, reference, cwd = process.cwd()) {
-  if (issueRoot(subjectRoot) !== void 0 || !subjectRoot.includes("/.ak/work/")) return subjectRoot;
-  const resolvedReference = resolve(cwd, reference);
-  const marker = "/runs/";
-  if (resolvedReference.includes(marker)) {
-    return subjectRoot;
-  }
-  return navigatorSubjectKey(subjectRoot, resolvedReference);
-}
-function createNavigatorPrepareTool(onOutput) {
-  return {
-    name: NAVIGATOR_PREPARE_TOOL_NAME,
-    label: "\u6E38\u5955\u4F7F\u51C6\u5907",
-    description: "\u63D0\u4EA4\u6E38\u5955\u4F7F\u6563\u6587\u5EFA\u8BAE\u3002",
-    parameters: prepareSchema,
-    async execute(_id, value) {
-      onOutput(value);
-      return { content: [], details: value, terminate: true };
-    }
-  };
-}
 function formatNavigatorReport(report) {
-  const playbookFailure = report.routePlaybookReadFailure === void 0 ? [] : [report.routePlaybookReadFailure];
-  if (report.disposition === "no-advice") return playbookFailure.join("\n");
-  if (report.disposition === "unavailable") {
-    return [...playbookFailure, ...report.unavailableReason ? [report.unavailableReason] : []].join("\n");
-  }
-  if (report.disposition === "arrival") {
-    return [...playbookFailure, ...report.arrivalMessage ? [report.arrivalMessage] : []].join("\n");
-  }
-  return [...playbookFailure, ...report.prose ? [report.prose] : []].join("\n");
+  if (report.disposition === "no-advice") return "";
+  if (report.disposition === "unavailable") return report.unavailableReason ?? "";
+  if (report.disposition === "arrival") return report.arrivalMessage ?? "";
+  return report.prose ?? "";
 }
 function createNavigatorAttendance(options) {
+  const { subjectKey } = options;
   let preparation;
   let preparationInFlight = false;
-  let sessionReady;
-  let session;
-  let subjectKey = options.subjectKey;
-  let contextError = options.contextError;
   let preparedAdvice;
-  const invocationPrincipal = options.invocationId ?? mintNavigatorInvocationId();
-  let activeInvocationId = invocationPrincipal;
-  let outputSink;
-  let settlementTail = Promise.resolve();
-  let settlementFailure;
   let preparationFailure;
-  let observedRoutePlaybookFailure;
+  let settlementTail = Promise.resolve();
   let disposed = false;
-  let closing;
+  const invocationId = options.invocationId ?? mintNavigatorInvocationId();
   const nestCancel = new AbortController();
-  const sessionHostContext = () => {
+  const lookupContext = () => {
     const parentSignal = options.context.signal;
     const signal = parentSignal === void 0 ? nestCancel.signal : AbortSignal.any([nestCancel.signal, parentSignal]);
     return { ...options.context, signal };
   };
-  const unavailable = (invocationId, reason) => {
-    const failure = reason instanceof NavigatorUnavailableError ? reason : navigatorUnavailableError("unknown", reason);
+  const unavailable = (reason) => {
+    const failure = navigatorUnavailableError("unknown", reason);
     return {
       disposition: "unavailable",
       unavailableReason: failure.message,
-      unavailableSource: failure.unavailableSource,
-      unavailableCause: failure.unavailableCause
-    };
-  };
-  const loadMaterialsAndSession = async (invocationId) => {
-    if (contextError !== void 0) throw navigatorUnavailableError("context", contextError);
-    const modelPromise = (async () => {
-      try {
-        const resolved = await resolveNavigatorSeatSelection(options.context);
-        return resolved.configuredLabel;
-      } catch (error) {
-        if (error instanceof NavigatorUnavailableError) throw error;
-        throw navigatorUnavailableError("model", error);
-      }
-    })();
-    const modelSetting = await modelPromise;
-    let model;
-    try {
-      model = parseNavigatorModelSetting(modelSetting);
-    } catch (error) {
-      throw navigatorUnavailableError("model", error);
-    }
-    const tool = createNavigatorPrepareTool((value) => {
-      outputSink?.(value);
-    });
-    if (session === void 0) {
-      sessionReady = (async () => {
-        let created;
-        try {
-          created = await options.createSession({
-            context: sessionHostContext(),
-            subject: subjectKey,
-            ...options.modelSettingPath === void 0 ? {} : { modelSettingPath: options.modelSettingPath },
-            tool
-          });
-        } catch (error) {
-          throw navigatorUnavailableError("session", error);
-        }
-        if (disposed) {
-          await created.dispose();
-          throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-        }
-        try {
-          await created.setModel?.(modelSetting, model.thinkingLevel);
-          if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-          created.appendEntry(INVOCATION_ENTRY, { invocationId, role: options.role, phase: options.phase, subjectKey });
-          if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-          session = created;
-          return created;
-        } catch (error) {
-          if (session !== created) await created.dispose();
-          throw error instanceof NavigatorUnavailableError ? error : navigatorUnavailableError("session", error);
-        }
-      })();
-      await sessionReady;
-      sessionReady = void 0;
-    } else {
-      try {
-        await session.setModel?.(modelSetting, model.thinkingLevel);
-      } catch (error) {
-        throw error instanceof NavigatorUnavailableError ? error : navigatorUnavailableError("session", error);
-      }
-      session.appendEntry(INVOCATION_ENTRY, { invocationId, role: options.role, phase: options.phase, subjectKey });
-    }
-    if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-    if (session === void 0) throw new Error("Navigator session was not created");
-    return session;
-  };
-  const prepare = async () => {
-    const invocationId = invocationPrincipal;
-    activeInvocationId = invocationId;
-    let output;
-    let prepareBatchRejected = false;
-    outputSink = (value) => {
-      const next = normalizePreparedAdvice(value);
-      if (output === void 0) {
-        output = value;
-        return;
-      }
-      const merged = mergePreparedAdvice(normalizePreparedAdvice(output), next);
-      output = {
-        ...merged?.prose === void 0 ? {} : { prose: merged.prose },
-        ...merged === void 0 || merged.byStatus.size === 0 ? {} : { byStatus: byStatusToPlainObject(merged.byStatus) }
-      };
+      unavailableSource: failure.unavailableSource
     };
-    const activeSession = await loadMaterialsAndSession(invocationId);
-    const request = JSON.stringify({
-      kind: "prepare",
-      role: options.role,
-      phase: options.phase,
-      invocationId,
-      subjectKey
-    });
-    try {
-      try {
-        if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-        const delivery = createReceiptDeliveryPolicy(options.deliveryRequestLimit);
-        const promptAllowingRejectedPrepare = async (text) => {
-          const entryStart = activeSession.entries().length;
-          prepareBatchRejected = false;
-          let promptFailure;
-          try {
-            await activeSession.prompt(text);
-          } catch (error) {
-            promptFailure = error;
-          }
-          const providerFailure = activeSession.providerFailure?.();
-          if (providerFailure !== void 0) {
-            throw navigatorUnavailableError(providerFailure.source, promptFailure ?? "Navigator provider failure", providerFailure.cause);
-          }
-          const rejectedReason = rejectedPrepareReason(activeSession.entries(), entryStart);
-          if (rejectedReason !== void 0) {
-            output = void 0;
-            prepareBatchRejected = true;
-            delivery.recordRejected(rejectedReason);
-            return;
-          }
-          if (promptFailure !== void 0) throw promptFailure;
-          const sessionNoReceipt = activeSession.noReceipt?.();
-          if (sessionNoReceipt !== void 0) {
-            delivery.recordNestedNoReceipt(sessionNoReceipt);
-            return;
-          }
-        };
-        await promptAllowingRejectedPrepare(request);
-        while (output === void 0 && prepareBatchRejected && delivery.nextAction() === "request-delivery") {
-          delivery.recordDeliveryRequest();
-          await promptAllowingRejectedPrepare(request);
-        }
-        if (output === void 0 && delivery.nextAction() === "request-delivery") {
-          delivery.closeBudget();
-        }
-        if (output === void 0 && delivery.nextAction() === "no-receipt" && activeSession.providerFailure?.() === void 0) {
-          preparedAdvice = void 0;
-          return void 0;
-        }
-      } catch (error) {
-        throw error instanceof NavigatorUnavailableError ? error : navigatorUnavailableError("transport", error);
-      }
-      if (output === void 0) {
-        const nativeFailure = [...activeSession.entries()].reverse().find((entry) => {
-          if (!isRecord(entry) || entry.type !== "message" || !isRecord(entry.message)) return false;
-          return entry.message.role === "assistant" && typeof entry.message.errorMessage === "string" && entry.message.errorMessage.trim() !== "";
-        });
-        const nativeMessage = isRecord(nativeFailure) && isRecord(nativeFailure.message) ? nativeFailure.message : void 0;
-        const errorMessage = nativeMessage !== void 0 && typeof nativeMessage.errorMessage === "string" ? nativeMessage.errorMessage : "Navigator did not submit direction advice";
-        const providerFailure = activeSession.providerFailure?.();
-        const source = providerFailure?.source ?? "unknown";
-        const cause = providerFailure?.cause ?? source;
-        throw navigatorUnavailableError(source, errorMessage, cause);
-      }
-      preparedAdvice = normalizePreparedAdvice(output);
-      return preparedAdvice;
-    } finally {
-      const playbookFailure = activeSession.routePlaybookReadFailure?.();
-      observedRoutePlaybookFailure = typeof playbookFailure === "string" && playbookFailure.trim() !== "" ? playbookFailure : void 0;
-      outputSink = void 0;
-    }
-  };
-  return {
-    setWorkContext(next) {
-      let closing2;
-      if (next.subjectKey !== subjectKey && session !== void 0) {
-        const previous = session;
-        session = void 0;
-        closing2 = previous.dispose();
-      }
-      subjectKey = next.subjectKey;
-      contextError = next.contextError;
-      return closing2;
-    },
-    prepare() {
-      if (disposed || preparation !== void 0) return;
-      preparationFailure = void 0;
-      preparedAdvice = void 0;
-      preparationInFlight = true;
-      preparation = prepare().finally(() => {
-        preparationInFlight = false;
-      });
-      void preparation.catch((error) => {
-        preparationFailure = error;
-      });
-    },
-    isPreparing() {
-      return preparationInFlight;
-    },
-    settle(settlement) {
-      const next = settlementTail.then(() => settleOnce(settlement));
-      settlementTail = next.catch((error) => {
-        settlementFailure = error;
-      });
-      return next;
-    },
-    dispose() {
-      disposed = true;
-      if (!nestCancel.signal.aborted) {
-        nestCancel.abort(navigatorUnavailableError(
-          "session",
-          new Error("Navigator attendance was disposed")
-        ));
-      }
-      activeInvocationId = void 0;
-      if (closing === void 0) {
-        const current = session;
-        session = void 0;
-        closing = Promise.resolve(current?.dispose()).then(() => void 0);
-      }
-      return closing;
-    }
   };
   async function settleOnce(settlement) {
     if (disposed) return;
-    const invocationId = activeInvocationId ?? invocationPrincipal;
     let report;
-    const settlementFact = {
-      invocationId,
-      subjectKey,
-      role: settlement.role,
-      phase: settlement.phase,
-      kind: settlement.kind,
-      ..."status" in settlement && settlement.status !== void 0 ? { status: settlement.status } : {}
-    };
     if (settlement.kind === "arrival") {
-      if (sessionReady !== void 0) {
-        try {
-          await sessionReady;
-        } catch (error) {
-          preparationFailure ??= error;
-        }
-      }
-      session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
-      if (preparationFailure !== void 0) {
-        report = unavailable(invocationId, preparationFailure);
-      } else {
-        report = {
-          disposition: "arrival",
-          ...settlement.message === void 0 ? {} : { arrivalMessage: settlement.message }
-        };
-      }
+      report = preparationFailure !== void 0 ? unavailable(preparationFailure) : {
+        disposition: "arrival",
+        ...settlement.message === void 0 ? {} : { arrivalMessage: settlement.message }
+      };
     } else {
-      if (sessionReady !== void 0) {
-        try {
-          await sessionReady;
-        } catch (error) {
-          preparationFailure ??= error;
-        }
-      }
       if (preparation !== void 0) {
         try {
           await preparation;
@@ -396,22 +52,14 @@ function createNavigatorAttendance(options) {
         }
         preparation = void 0;
       }
-      session?.appendEntry(SETTLEMENT_ENTRY, settlementFact);
       if (preparationFailure !== void 0) {
-        report = unavailable(invocationId, preparationFailure);
+        report = unavailable(preparationFailure);
       } else {
         const status = "status" in settlement ? settlement.status : void 0;
         const picked = pickPreparedProse(preparedAdvice, status);
-        if (typeof picked === "string" && picked.trim() !== "") {
-          report = { disposition: "advice", prose: picked };
-        } else {
-          report = { disposition: "no-advice" };
-        }
+        report = typeof picked === "string" && picked.trim() !== "" ? { disposition: "advice", prose: picked } : { disposition: "no-advice" };
       }
     }
-    if (observedRoutePlaybookFailure !== void 0) {
-      report = { ...report, routePlaybookReadFailure: observedRoutePlaybookFailure };
-    }
     const event = {
       version: 1,
       disposition: report.disposition,
@@ -422,8 +70,6 @@ function createNavigatorAttendance(options) {
       ...report.prose === void 0 ? {} : { prose: report.prose },
       ...report.unavailableReason === void 0 ? {} : { unavailableReason: report.unavailableReason },
       ...report.unavailableSource === void 0 ? {} : { unavailableSource: report.unavailableSource },
-      ...report.unavailableCause === void 0 ? {} : { unavailableCause: report.unavailableCause },
-      ...report.routePlaybookReadFailure === void 0 ? {} : { routePlaybookReadFailure: report.routePlaybookReadFailure },
       ...report.arrivalMessage === void 0 ? {} : { arrivalMessage: report.arrivalMessage }
     };
     if (disposed) return;
@@ -434,43 +80,47 @@ function createNavigatorAttendance(options) {
       throw error;
     }
     preparation = void 0;
-    sessionReady = void 0;
     preparedAdvice = void 0;
     preparationFailure = void 0;
-    observedRoutePlaybookFailure = void 0;
   }
-}
-function registerNavigatorModelCommand(pi, path = navigatorModelSettingPath()) {
-  pi.registerCommand("navigator-model", {
-    description: "Set the persistent Navigator model (provider/model[:max]).",
-    handler: async (args) => {
-      await writeNavigatorModelSetting(args.trim(), path);
+  return {
+    prepare() {
+      if (disposed || preparation !== void 0 || options.phase === "plan") return;
+      preparationFailure = void 0;
+      preparedAdvice = void 0;
+      preparationInFlight = true;
+      preparation = options.lookup({ context: lookupContext(), role: options.role }).then((prepared) => {
+        preparedAdvice = prepared;
+        return prepared;
+      }).finally(() => {
+        preparationInFlight = false;
+      });
+      void preparation.catch((error) => {
+        preparationFailure = error;
+      });
+    },
+    isPreparing() {
+      return preparationInFlight;
+    },
+    settle(settlement) {
+      const next = settlementTail.then(() => settleOnce(settlement));
+      settlementTail = next.catch(() => void 0);
+      return next;
+    },
+    dispose() {
+      disposed = true;
+      if (!nestCancel.signal.aborted) {
+        nestCancel.abort(navigatorUnavailableError("session", new Error("Navigator attendance was disposed")));
+      }
     }
-  });
+  };
 }
 export {
   NAVIGATOR_EVENT_TYPE,
-  NAVIGATOR_PREPARE_TOOL_NAME,
-  NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
-  NAVIGATOR_TARGETS,
+  NAVIGATOR_INVOCATION_ENTRY,
   NavigatorUnavailableError,
-  createNativeNavigatorSessionFactory,
   createNavigatorAttendance,
-  createNavigatorPrepareTool,
   formatNavigatorReport,
-  navigatorModelSettingPath,
-  navigatorProviderFailure,
-  navigatorProviderFailureFromDiagnostics,
-  navigatorProviderFailureFromError,
-  navigatorProviderFailureFromPublicTerminal,
-  navigatorProviderFailureFromStatus,
-  navigatorSubjectKey,
-  navigatorSubjectKeyForInput,
   navigatorUnavailableError,
-  parseNavigatorModelSetting,
-  readNavigatorModelSetting,
-  registerNavigatorModelCommand,
-  resolveNavigatorSeatSelection,
-  subjectPath,
-  writeNavigatorModelSetting
+  subjectPath
 };

package/dist/navigator-invocation-identity.js

@@ -3,7 +3,6 @@ import { isUuidV7, uuidv7 } from "./uuidv7.js";
 import { isRecord } from "./unknown-value.js";
 import { workSubjectKeysEqual } from "./work-subject-identity.js";
 const NAVIGATOR_INVOCATION_ENTRY = "ak-navigator-invocation";
-const NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY = "ak-navigator-route-playbook-failure";
 const NAVIGATOR_INFRASTRUCTURE_FAILURE_KIND = "role_infrastructure_failure";
 const NAVIGATOR_INFRASTRUCTURE_FAILURE_KEYS = [
   "kind",
@@ -187,7 +186,6 @@ export {
   NAVIGATOR_INFRASTRUCTURE_FAILURE_EVIDENCE_KEYS,
   NAVIGATOR_INFRASTRUCTURE_FAILURE_KIND,
   NAVIGATOR_INVOCATION_ENTRY,
-  NAVIGATOR_ROUTE_PLAYBOOK_FAILURE_ENTRY,
   buildNavigatorInfrastructureFailureFact,
   classifyPackagedRoleTerminalResult,
   extractInfrastructureFailureEvidence,

package/dist/navigator-lookup-host.js

@@ -0,0 +1,41 @@
+/**
+ * 游奕使的非模型回合宿主（#1192 / ADR 0082「不适配者按类型开新管线」）。
+ * 不起宿主会话、不调模型：按结构化的目标角色查 navigator-route-table，
+ * 经提交账封一行，结算照常读账本。
+ */
+import { randomUUID } from "node:crypto";
+import { navigatorFullTable, navigatorRowsForRole } from "./navigator-route-table.js";
+import { PACKAGED_ROLE_REGISTRY } from "./packaged-role-registry.js";
+import { sealAcceptedSubmission } from "./submission-ledger.js";
+/** 记入 invocation 的宿主名：如实表明这一腿是查表，不冒用真实宿主。 */
+export const NAVIGATOR_LOOKUP_HOST = "lookup";
+function targetRole(forRole) {
+    const known = PACKAGED_ROLE_REGISTRY.find(({ role }) => role === forRole);
+    if (known === undefined)
+        throw new Error(`navigator lookup: unknown role ${forRole}`);
+    return known.role;
+}
+export function createNavigatorLookupHost() {
+    return {
+        async executeTurn(request) {
+            const { activation } = request;
+            if (activation.role !== "navigator") {
+                throw new Error(`navigator lookup host cannot run ${activation.role}`);
+            }
+            const accepted = activation.forRole === undefined
+                ? { byRole: navigatorFullTable() }
+                : { byStatus: navigatorRowsForRole(targetRole(activation.forRole)) };
+            sealAcceptedSubmission({
+                runDirectory: request.runDirectory,
+                cwd: request.cwd,
+                home: request.home,
+                role: "navigator",
+                accepted,
+                instruction: request.continuation.prompt,
+                toolCallId: `navigator-lookup:${randomUUID()}`,
+                ...(request.courtAttemptId === undefined ? {} : { courtAttemptId: request.courtAttemptId }),
+            });
+            return { code: 0, stderr: "", timedOut: false };
+        },
+    };
+}

package/dist/navigator-lookup.js

@@ -0,0 +1,68 @@
+import {
+  mergePreparedAdvice,
+  preparedAdviceFromUnknown
+} from "./package-contracts/navigator-output.js";
+import { runDirectoryFromHostContext } from "./host-contracts.js";
+class NavigatorUnavailableError extends Error {
+  unavailableSource;
+  originalCause;
+  constructor(source, message, originalCause) {
+    super(message);
+    this.name = "NavigatorUnavailableError";
+    this.unavailableSource = source;
+    this.originalCause = originalCause;
+  }
+}
+function navigatorUnavailableError(source, error) {
+  if (error instanceof NavigatorUnavailableError) return error;
+  const message = error instanceof Error ? error.message : String(error);
+  return new NavigatorUnavailableError(source, message, error);
+}
+async function ledgerHomeFor(context) {
+  const { tryHomeFromAkRolesPath } = await import("./activation-ledger-topology.js");
+  for (const path of [runDirectoryFromHostContext(context), context.sessionManager?.getSessionFile?.()]) {
+    if (typeof path !== "string" || path.trim() === "") continue;
+    const home = tryHomeFromAkRolesPath(path);
+    if (home !== void 0 && home.length > 0) return home;
+  }
+  return void 0;
+}
+function createNavigatorLookup(deps) {
+  const summon = deps?.summonPublicRole ?? (async (options) => (await import("./public-role-summons.js")).summonPublicRole(options));
+  return async ({ context, role }) => {
+    const home = await ledgerHomeFor(context);
+    let summoned;
+    try {
+      summoned = await summon({
+        role: "navigator",
+        argv: ["--role", role],
+        cwd: context.cwd,
+        ...home === void 0 ? {} : { home },
+        ...context.signal === void 0 ? {} : { signal: context.signal }
+      });
+    } catch (error) {
+      throw navigatorUnavailableError("session", error);
+    }
+    const outcome = summoned.terminal?.roleOutcome;
+    if (outcome === void 0) {
+      const detail = summoned.stderr?.trim() || `exit ${summoned.exitCode}`;
+      throw new NavigatorUnavailableError("session", `Navigator lookup produced no terminal (${detail})`);
+    }
+    if (outcome.kind === "failure") {
+      throw new NavigatorUnavailableError("session", outcome.diagnostic);
+    }
+    if (outcome.kind !== "accepted") {
+      throw new NavigatorUnavailableError("session", `Navigator lookup settled ${outcome.kind}`);
+    }
+    let prepared;
+    for (const payload of outcome.payloads ?? []) {
+      prepared = mergePreparedAdvice(prepared, preparedAdviceFromUnknown(payload));
+    }
+    return prepared;
+  };
+}
+export {
+  NavigatorUnavailableError,
+  createNavigatorLookup,
+  navigatorUnavailableError
+};