@akagilnc/pi-workflow-roles 0.1.5368 → 0.1.5375

package/dist/public-cli/post-admission.js

@@ -43,13 +43,14 @@ import { recordRunStart } from "../host-session-record.js";
 import { attemptProducedFreshSubmission, classifyPostAdmissionFailure, controlledFailureInputFromResolution, exitCodeForTerminalOutcome, explicitInternalKnownFailureClassificationInput, formatCliDiagnostic, formatErrorCauseDetail, formatTerminalResult, inspectJudgeSession, isLawfulTypedTerminalOutcome, presentFailureTerminal, publishedFailureErrorPath, presentStructuralRejection, resolveAuditedRunnerFailureResolution, resolveControlledFailureResumeObservation, settleFailureTerminalResult, settleHostEndedNoReceipt, attachRecordedSubmissions, rewritePublishedFailureErrorPath, } from "./settlement.js";
 import {} from "./terminal.js";
 import { ensureRealArtifactsDirectory, persistReturnedRunState, runWithAutoResumeLoop, TurnDispatchedFailure, writeHardenedArtifactFile, } from "./auto-resume.js";
+import { isRecord, errorText } from "../unknown-value.js";
 function projectRelocatedTurnIdentity(request, result, admitted, relocation) {
     const rewrite = (value) => rewriteRunDirectoryPathValue(value, relocation.oldRunDirectory, relocation.newRunDirectory);
     const mutableRequest = request;
     mutableRequest.runDirectory = admitted.runDirectory;
     mutableRequest.principal = admitted.principal;
     const activation = mutableRequest.activation;
-    if (activation !== null && typeof activation === "object" && !Array.isArray(activation)) {
+    if (isRecord(activation)) {
         for (const field of ["taskPath", "packetPath", "prerequisitesPath", "inputPath", "requestManifestPath"]) {
             const record = activation;
             if (field in record)
@@ -352,7 +353,7 @@ export async function dispatchPostAdmissionTurn(input) {
                         continue;
                     }
                     const payload = row.accepted;
-                    if (payload === null || typeof payload !== "object" || Array.isArray(payload))
+                    if (!isRecord(payload))
                         continue;
                     ticketNumber = readDeclaredTicketNumber(payload.ticketNumber);
                     if (ticketNumber !== undefined)
@@ -1167,7 +1168,7 @@ async function presentResumeFailurePointer(io, thrown, publish) {
             cause.thrownCause = formatErrorCauseDetail(thrown.cause);
         }
         presentStructuralRejection({
-            message: thrown instanceof Error ? thrown.message : String(thrown),
+            message: errorText(thrown),
             cause,
         }, io);
     }

package/dist/public-cli/run-lifecycle.js

@@ -18,6 +18,7 @@ import { rewriteAdmittedRoleRunPage, rewriteRunDirectoryPathValue, } from "../ro
 import { appendEngineSessionMaterial, engineSessionMaterialFromOptions, pickEngineAxis, } from "../package-resources/engine-material.js";
 import { packagedResumeSourcePath, packagedRoleMetadata, } from "../packaged-role-registry.js";
 import { admittedReviewerBaseFault, recordEffectiveInvocationModel, requireAuthorityRef, isReviewerLens, } from "./invocation.js";
+import { isRecord, errorText, isEnoent } from "../unknown-value.js";
 /** Providers eligible for v1 typed-429 resume (Codex / xAI only).
  * @deprecated v1 429-only gate removed by #416 (owner 2026-08-22: "根本不要有限制"). Kept for compatibility; do not use for new branching.
  */
@@ -72,7 +73,7 @@ export async function writeRoleRunState(runDirectory, record) {
     await writeFile(join(runDirectory, RUN_STATE_FILE), `${JSON.stringify(payload, null, 2)}\n`, "utf8");
 }
 function parseSameTicketSummonsMaterials(raw) {
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+    if (!isRecord(raw))
         return undefined;
     const record = raw;
     const instruction = typeof record.instruction === "string" ? record.instruction : undefined;
@@ -84,9 +85,7 @@ function parseSameTicketSummonsMaterials(raw) {
         ? record.sourceRunPath
         : undefined;
     let sourceRun;
-    if (record.sourceRun !== null &&
-        typeof record.sourceRun === "object" &&
-        !Array.isArray(record.sourceRun)) {
+    if (isRecord(record.sourceRun)) {
         const sr = record.sourceRun;
         if (typeof sr.runId === "string" &&
             sr.runId.trim() !== "" &&
@@ -119,7 +118,7 @@ function parseSameTicketSummonsMaterials(raw) {
     };
 }
 function parseCurrentCourtState(raw) {
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+    if (!isRecord(raw))
         return undefined;
     const record = raw;
     if (typeof record.courtAttemptId !== "string" || record.courtAttemptId.length === 0) {
@@ -150,7 +149,7 @@ async function readRoleRunStateRaw(runDirectory) {
     return raw;
 }
 function parseRoleRunIdentity(raw, runDirectory) {
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+    if (!isRecord(raw)) {
         throw new TypeError("Invalid run-state.json");
     }
     const record = raw;
@@ -202,8 +201,7 @@ async function readRoleRunStateDisk(runDirectory) {
     };
     let resumable;
     if (record.resumable !== undefined && record.resumable !== null) {
-        if (typeof record.resumable === "object" &&
-            !Array.isArray(record.resumable)) {
+        if (isRecord(record.resumable)) {
             const r = record.resumable;
             if (r.httpStatus === 429 &&
                 typeof r.provider === "string" &&
@@ -767,7 +765,7 @@ export async function readRunParentPath(runDirectory) {
             return undefined;
         throw error;
     }
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+    if (!isRecord(raw)) {
         return undefined;
     }
     const record = raw;
@@ -916,7 +914,7 @@ async function loadResumableRunRecord(home, runId, authority) {
     let sourceRun;
     try {
         const raw = JSON.parse(await readFile(run.admittedRequestPath, "utf8"));
-        if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
+        if (isRecord(raw)) {
             const record = raw;
             const storedRunDirectory = typeof record.runDirectory === "string" && record.runDirectory.trim() !== ""
                 ? record.runDirectory
@@ -983,9 +981,7 @@ async function loadResumableRunRecord(home, runId, authority) {
             if (typeof record.caseRunsPath === "string" && record.caseRunsPath.trim() !== "") {
                 caseRunsPath = record.caseRunsPath;
             }
-            if (record.caseIdentity !== null &&
-                typeof record.caseIdentity === "object" &&
-                !Array.isArray(record.caseIdentity)) {
+            if (isRecord(record.caseIdentity)) {
                 const ci = record.caseIdentity;
                 if (typeof ci.issueNumber === "number" &&
                     Number.isSafeInteger(ci.issueNumber) &&
@@ -999,9 +995,7 @@ async function loadResumableRunRecord(home, runId, authority) {
             if (typeof record.sourceRunPath === "string" && record.sourceRunPath.trim() !== "") {
                 sourceRunPath = record.sourceRunPath;
             }
-            if (record.sourceRun !== null &&
-                typeof record.sourceRun === "object" &&
-                !Array.isArray(record.sourceRun)) {
+            if (isRecord(record.sourceRun)) {
                 const sr = record.sourceRun;
                 if (typeof sr.runId === "string" &&
                     sr.runId.trim() !== "" &&
@@ -1029,9 +1023,7 @@ async function loadResumableRunRecord(home, runId, authority) {
                 record.mergerInputPath.trim() !== "") {
                 mergerInputPath = record.mergerInputPath;
             }
-            if (record.derived !== null &&
-                typeof record.derived === "object" &&
-                !Array.isArray(record.derived)) {
+            if (isRecord(record.derived)) {
                 const d = record.derived;
                 if (typeof d.targetObjectId === "string" &&
                     typeof d.sourceObjectId === "string" &&
@@ -1061,9 +1053,7 @@ async function loadResumableRunRecord(home, runId, authority) {
     let model;
     try {
         const invocationRaw = JSON.parse(await readFile(join(run.runDirectory, "invocation.json"), "utf8"));
-        if (invocationRaw !== null &&
-            typeof invocationRaw === "object" &&
-            !Array.isArray(invocationRaw)) {
+        if (isRecord(invocationRaw)) {
             const rec = invocationRaw;
             if (typeof rec.provider === "string" && typeof rec.model === "string") {
                 model = {
@@ -1087,9 +1077,7 @@ async function loadResumableRunRecord(home, runId, authority) {
         if (error instanceof CliUsageError) {
             throw error;
         }
-        if (!(error instanceof Error &&
-            "code" in error &&
-            error.code === "ENOENT")) {
+        if (!isEnoent(error)) {
             throw new CliUsageError(`role run invocation identity is unreadable: ${runId}`, { cause: error });
         }
     }
@@ -1331,7 +1319,7 @@ function admitResumedRole(loaded) {
                 parsedRepository = parseCollectorRepository(repositoryDisplay);
             }
             catch (error) {
-                const detail = error instanceof Error ? error.message : String(error);
+                const detail = errorText(error);
                 throw new CliUsageError(detail, { cause: error });
             }
             if (parsedRepository.canonical !== repository) {

package/dist/public-cli/settlement.js

@@ -167,6 +167,7 @@ function coordinatesFromAdmitted(authority, admitted) {
     return authority.decode(admitted.principal);
 }
 import { coalesceSubmissionRows, exitCodeForTerminalOutcome, formatTerminalResult, isLawfulTypedTerminalOutcome, adviceNavigatorFact, } from "./terminal.js";
+import { isEnoent, isMissingPathError, isRecord } from "../unknown-value.js";
 export { exitCodeForTerminalOutcome, formatTerminalResult, isLawfulTypedTerminalOutcome, };
 // A resumable public Terminal omits artifact paths (#108); its actual error
 // publication remains available only to the CLI's resume presentation seam.
@@ -239,7 +240,7 @@ export async function inspectJudgeSession(sessionFile) {
         return { state: "present" };
     }
     catch (error) {
-        if (isMissingPathError(error))
+        if (isEnoent(error))
             return { state: "missing" };
         return {
             state: "unreadable",
@@ -493,18 +494,6 @@ export function explicitInternalKnownFailureClassificationInput(failure) {
  * the budget to start a cold full host turn (owner 2026-09-17 #959).
  */
 export const NAVIGATOR_POST_ROLE_GRACE_MS = 10_000;
-function isMissingPathError(error) {
-    return (error instanceof Error &&
-        "code" in error &&
-        error.code === "ENOENT");
-}
-/** Face clear only: path not enterable as a face (ENOENT or file mid-path). */
-function isAbsentFacePathError(error) {
-    return (error instanceof Error &&
-        "code" in error &&
-        (error.code === "ENOENT" ||
-            error.code === "ENOTDIR"));
-}
 /**
  * Preserve session-read failure identity as a typed session cause.
  * SyntaxError keeps its name so durable settlement does not wash malformed JSONL
@@ -665,7 +654,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
         parentEntries = await readBoundSessionEntries(sessionFile);
     }
     catch (error) {
-        if (isMissingPathError(error))
+        if (isEnoent(error))
             return undefined;
         throw sessionReadFailure(error, "failed to read parent session for auditor binding");
     }
@@ -682,7 +671,7 @@ async function loadBoundAuditorVolumes(sessionFile) {
             sawAnyDirectory = true;
         }
         catch (error) {
-            if (isMissingPathError(error))
+            if (isEnoent(error))
                 continue;
             throw sessionReadFailure(error, "failed to read bound auditor session directory");
         }
@@ -887,7 +876,7 @@ export async function resolveAuditedRunnerFailureResolution(input) {
             return resolutionOf(terminatingFailure);
     }
     catch (error) {
-        if (!isMissingPathError(error)) {
+        if (!isEnoent(error)) {
             const failure = sessionReadFailure(error, "failed to recover typed terminating-tool failure");
             return resolutionOf({
                 cause: "session",
@@ -1005,9 +994,6 @@ export function controlledFailureInputFromResolution(resolution) {
             : {}),
     };
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function safelyRead(object, key) {
     try {
         return { readable: true, value: object[key] };
@@ -1024,9 +1010,7 @@ function toolResultText(message) {
         return "";
     return content
         .map((part) => {
-        if (typeof part === "object" &&
-            part !== null &&
-            !Array.isArray(part) &&
+        if (isRecord(part) &&
             typeof part.text === "string") {
             return part.text;
         }
@@ -1611,7 +1595,7 @@ async function extractNavigatorFactFromAdmittedSession(sessionFile) {
         return extractNavigatorFact(entries);
     }
     catch (error) {
-        if (isMissingPathError(error)) {
+        if (isEnoent(error)) {
             return {
                 disposition: "unavailable",
                 source: "unknown",
@@ -1638,7 +1622,7 @@ async function removeFaceIfPresent(path) {
         // force:true already ignores ENOENT; ENOTDIR = face path not enterable
         // (artifacts-as-file mid-path) — same absent-face semantics as the reader.
         // Other errno stay loud (失败诚实).
-        if (isAbsentFacePathError(error))
+        if (isMissingPathError(error))
             return;
         throw error;
     }
@@ -1722,7 +1706,7 @@ async function readLawfulSettlementEntries(sessionFile) {
     }
     catch (error) {
         // Missing path is absence of a lawful outcome; callers classify via session inspect.
-        if (isMissingPathError(error))
+        if (isEnoent(error))
             return undefined;
         // Malformed JSONL and other read failures keep typed session identity.
         throw error instanceof Error &&
@@ -2028,7 +2012,7 @@ function countersignTerminalFromEntries(entries) {
             continue;
         if (entry.customType !== SECRETARIAT_GATE_OFFICER_ENTRY_TYPE)
             continue;
-        const data = entry.data !== null && typeof entry.data === "object" && !Array.isArray(entry.data)
+        const data = isRecord(entry.data)
             ? entry.data
             : undefined;
         if (data === undefined || !packagedDurableOfficerEntry(data.officer))

package/dist/public-role-summons.js

@@ -3,6 +3,7 @@ import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import { join } from "node:path";
 import { promisify } from "node:util";
+import { isRecord, errorText } from "./unknown-value.js";
 const AK_ROLE_PACKAGE_ROOT_ENV = "AK_ROLE_PACKAGE_ROOT";
 const execFileAsync = promisify(execFile);
 function createCapturingIo() {
@@ -291,7 +292,7 @@ async function summonParallelReviewerLenses(options) {
     if (error instanceof AggregateError) {
       return [error.message, ...error.errors.map(describeFailure)].join("\n");
     }
-    return error instanceof Error ? error.message : String(error);
+    return errorText(error);
   };
   const failedResult = (error) => ({
     exitCode: 1,
@@ -472,7 +473,7 @@ async function summonGateOfficer(options) {
     const correlationId = parentRunId;
     const { isSafePositiveTicketNumber, readBoardTicketNumber } = await import("./run-ticket-number.js");
     const parentTicket = await readBoardTicketNumber(options.sourceRunDirectory);
-    const submittedTicket = options.submission !== null && typeof options.submission === "object" && !Array.isArray(options.submission) ? options.submission.ticketNumber : void 0;
+    const submittedTicket = isRecord(options.submission) ? options.submission.ticketNumber : void 0;
     const courtTicket = isSafePositiveTicketNumber(submittedTicket) ? submittedTicket : parentTicket;
     const instruction = options.reask ?? gateReviewInstruction ?? "";
     return summonPublicRole({

package/dist/receipt-delivery-policy.js

@@ -1,8 +1,6 @@
+import { isRecord } from "./unknown-value.js";
 const RECEIPT_DELIVERY_TURN_LIMIT = 2;
 const NO_RECEIPT_LIFECYCLE_ENTRY_TYPE = "ak-no-receipt-lifecycle";
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function parseNoReceiptLifecycleFacts(input) {
   if (!isRecord(input) || typeof input.terminalToolCalled !== "boolean" || input.deliveryTurns !== RECEIPT_DELIVERY_TURN_LIMIT || input.sessionCompletion !== "settled-without-accepted-receipt" || input.acceptedReceipt !== false || typeof input.runPointer !== "string" || input.runPointer.trim() === "" || typeof input.attemptPointer !== "string" || input.attemptPointer.trim() === "" || !Array.isArray(input.rejectedReceipts) || !input.rejectedReceipts.every((item) => isRecord(item) && typeof item.reason === "string")) {
     throw new TypeError("malformed no-receipt lifecycle facts");

package/dist/role-run-placement.js

@@ -5,9 +5,7 @@ import {
   ensureRealDirectoryTree
 } from "./activation-ledger-topology.js";
 import { requireSafePositiveTicketNumber } from "./run-ticket-number.js";
-function isMissingPathError(error) {
-  return error instanceof Error && "code" in error && error.code === "ENOENT";
-}
+import { isEnoent } from "./unknown-value.js";
 async function listBookRunDirectories(bookDir) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
@@ -16,7 +14,7 @@ async function listBookRunDirectories(bookDir) {
     try {
       entries = await readdir(runsDir, { withFileTypes: true });
     } catch (error) {
-      if (isMissingPathError(error)) return;
+      if (isEnoent(error)) return;
       throw error;
     }
     for (const entry of entries) {
@@ -32,7 +30,7 @@ async function listBookRunDirectories(bookDir) {
   try {
     subjects = await readdir(bookDir, { withFileTypes: true });
   } catch (error) {
-    if (isMissingPathError(error)) return out.sort();
+    if (isEnoent(error)) return out.sort();
     throw error;
   }
   for (const subject of subjects) {

package/dist/role-run-relocation.js

@@ -10,6 +10,7 @@ import { existsSync } from "node:fs";
 import { readdir, readFile, writeFile } from "node:fs/promises";
 import { join, sep } from "node:path";
 import { AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE } from "./compliance-transport.js";
+import { isRecord, isEnoent } from "./unknown-value.js";
 const ADMITTED_PAGE_FIELDS = [
     "runDirectory",
     "admittedRequestPath",
@@ -39,11 +40,6 @@ const OFFICER_POINTER_FIELDS = ["sessionFile", "runDirectory"];
 const SITIAN_RECORD_FIELDS = ["sessionParent"];
 const SESSION_HEADER_FIELDS = ["parentSession"];
 const BINDING_PARENT_FIELDS = ["sessionFile"];
-function isEnoent(error) {
-    return (error instanceof Error &&
-        "code" in error &&
-        error.code === "ENOENT");
-}
 /** Rewrite one path value that points at or under oldRunDirectory. */
 export function rewriteRunDirectoryPathValue(value, oldRunDirectory, newRunDirectory) {
     if (typeof value !== "string")
@@ -111,18 +107,15 @@ function collectRewrites(input) {
     }
     return out;
 }
-function isPlainObject(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 /** Typed notary/source-run locator: only runDirectory is a path. */
 function rewriteSourceRunLocator(value, rewrites) {
-    if (!isPlainObject(value))
+    if (!isRecord(value))
         return;
     rewriteRunDirectoryPathFieldsAgainstRewrites(value, SOURCE_RUN_LOCATOR_FIELDS, rewrites);
 }
 /** Same-ticket summons materials: typed source-run + frozen attachment pointers. */
 function rewriteSummonsMaterials(value, rewrites) {
-    if (!isPlainObject(value))
+    if (!isRecord(value))
         return;
     rewriteRunDirectoryPathFieldsAgainstRewrites(value, SUMMONS_PATH_FIELDS, rewrites);
     rewriteSourceRunLocator(value.sourceRun, rewrites);
@@ -137,12 +130,12 @@ export function rewriteAdmittedRoleRunPage(page, rewrites) {
     rewriteSourceRunLocator(page.sourceRun, rewrites);
     if (Array.isArray(page.attachments)) {
         for (const attachment of page.attachments) {
-            if (isPlainObject(attachment)) {
+            if (isRecord(attachment)) {
                 rewriteRunDirectoryPathFieldsAgainstRewrites(attachment, ["frozenPath"], rewrites);
             }
         }
     }
-    if (isPlainObject(page.principal)) {
+    if (isRecord(page.principal)) {
         rewriteRunDirectoryPathFieldsAgainstRewrites(page.principal, ["sessionDirectory", "sessionFile"], rewrites);
     }
 }
@@ -150,7 +143,7 @@ async function rewriteOfficerPointerFile(path, rewrites) {
     if (!existsSync(path))
         return;
     const page = JSON.parse(await readFile(path, "utf8"));
-    if (!isPlainObject(page))
+    if (!isRecord(page))
         return;
     // Only the typed direct-officer pointer shape — never arbitrary .pointer.json.
     if (page.kind !== "direct-officer-run-pointer")
@@ -190,7 +183,7 @@ async function rewriteSitianRecordsJsonl(path, rewrites) {
             out.push(line);
             continue;
         }
-        if (!isPlainObject(parsed)) {
+        if (!isRecord(parsed)) {
             out.push(line);
             continue;
         }
@@ -241,7 +234,7 @@ async function rewriteSessionTranscriptBindings(path, rewrites) {
             out.push(line);
             continue;
         }
-        if (!isPlainObject(parsed)) {
+        if (!isRecord(parsed)) {
             out.push(line);
             continue;
         }
@@ -254,8 +247,8 @@ async function rewriteSessionTranscriptBindings(path, rewrites) {
         }
         else if (parsed.type === "custom" &&
             parsed.customType === AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE &&
-            isPlainObject(parsed.data) &&
-            isPlainObject(parsed.data.parent)) {
+            isRecord(parsed.data) &&
+            isRecord(parsed.data.parent)) {
             const parent = parsed.data.parent;
             const before = parent.sessionFile;
             rewriteRunDirectoryPathFieldsAgainstRewrites(parent, BINDING_PARENT_FIELDS, rewrites);
@@ -343,11 +336,11 @@ export async function rewriteRoleRunDurablePages(input) {
         const page = JSON.parse(await readFile(statePath, "utf8"));
         const before = JSON.stringify(page);
         rewriteRunDirectoryPathFieldsAgainstRewrites(page, RUN_STATE_PAGE_FIELDS, rewrites);
-        if (isPlainObject(page.principal)) {
+        if (isRecord(page.principal)) {
             rewriteRunDirectoryPathFieldsAgainstRewrites(page.principal, ["sessionDirectory", "sessionFile"], rewrites);
         }
         // Open court summons: source-run locators + frozen attachment path pointers.
-        if (isPlainObject(page.currentCourt)) {
+        if (isRecord(page.currentCourt)) {
             rewriteSummonsMaterials(page.currentCourt.summons, rewrites);
         }
         if (JSON.stringify(page) !== before) {

package/dist/run-terminal-artifacts.js

@@ -9,6 +9,7 @@
 import { readdir, readFile } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
 import { roleRunArtifactsDirectory } from "./role-run-placement.js";
+import { isRecord, errorText, isMissingPathError } from "./unknown-value.js";
 export const RUN_TERMINAL_ARTIFACT_FILES = [
     "report.json",
     "error.json",
@@ -26,17 +27,6 @@ export const RUN_TERMINAL_ERROR_FALLBACK_RELATIVE_PATHS = [
 ];
 /** Unique open-ended failure names: error.<uuid>.json (publisher stem + uuid). */
 const UNIQUE_ERROR_FALLBACK_NAME = /^error\.[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.json$/i;
-function isMissingPathError(error) {
-    return (error instanceof Error
-        && "code" in error
-        && (error.code === "ENOENT" || error.code === "ENOTDIR"));
-}
-function errorText(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 /**
  * Minimum producer-owned face shared by settlement terminal artifacts
  * (report / error / audit-incomplete). Consumer-driven: enough to identify a

package/dist/run-ticket-number.js

@@ -1,9 +1,7 @@
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
+import { isEnoent, isRecord } from "./unknown-value.js";
 const MIGRATION_TICKET_DERIVATION_PAGE = "migration-ticket-derivation.json";
-function isEnoent(error) {
-  return error instanceof Error && "code" in error && error.code === "ENOENT";
-}
 function isSafePositiveTicketNumber(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 1;
 }
@@ -30,7 +28,7 @@ function ticketFromRecord(record) {
 async function readJsonObject(path) {
   try {
     const raw = JSON.parse(await readFile(path, "utf8"));
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+    if (!isRecord(raw)) {
       return void 0;
     }
     return raw;

package/dist/session-assistant-usage.js

@@ -1,4 +1,5 @@
 import { join } from "node:path";
+import { errorText } from "./unknown-value.js";
 export async function readAssistantUsageFromSessionFile(sessionFile) {
     const { readFile } = await import("node:fs/promises");
     let text;
@@ -19,7 +20,7 @@ export async function readAssistantUsageFromSessionFile(sessionFile) {
             .map((line) => JSON.parse(line));
     }
     catch (error) {
-        throw new Error(`session usage parse failed (${sessionFile}): ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        throw new Error(`session usage parse failed (${sessionFile}): ${errorText(error)}`, { cause: error });
     }
     let total = 0;
     let input = 0;

package/dist/session-dialogue.js

@@ -1,17 +1,4 @@
-/**
- * 对话事实适配（ADR 0075 `dialogue-only` / `no-tool-output` / `speaker-required`）。
- *
- * 「对话」＝人类输入内容 + 助手回话内容，由各宿主的**结构化会话事件**适配而来。
- * 排除按来源、不按正文：说话人自己写下的文字一律原样保留，其中引用了 ADR 段落
- * 或工具结果也不删（#901 Out of Scope「不做正文过滤」）。
- *
- * 不入录的是工具结果载荷、附件记录与注入块——它们是独立的机器事件，不是谁说的话。
- *
- * 适配规则按宿主并列，不硬套某一宿主的类型名；一行产出 0..n 条对话事实。
- */
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
+import { isRecord } from "./unknown-value.js";
 /**
  * 原生 id：行级或消息体级主键的单一实现（bound 解析与落盘共用）。
  * Pi/CC：行上 `uuid`/`id`；Codex：`response_item.payload.id`（或 `message.id`）。

package/dist/sitian-reader.js

@@ -1,8 +1,6 @@
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
+import { isRecord, errorText } from "./unknown-value.js";
 async function readSitianRecords(recordFile) {
   if (!existsSync(recordFile)) {
     return { records: [], diagnostics: [] };
@@ -32,7 +30,7 @@ async function readSitianRecords(recordFile) {
         kind: "malformed",
         line: index + 1,
         raw: line,
-        error: error instanceof Error ? error.message : String(error)
+        error: errorText(error)
       });
     }
   }

package/dist/submission-correctable-error.js

@@ -1,4 +1,5 @@
 import { GatekeeperDecisionError, ParentQueueReaskError, WorkerCommitReminderError, WorkerPrefixReminderError, WorkerUnfinishedReasonReminderError, } from "./submission-errors.js";
+import { errorText } from "./unknown-value.js";
 /** Shared, unforgeable identity for submission errors that the same session may correct. */
 const correctableSubmissionErrorBrand = Symbol("ak-roles.correctable-submission-error");
 export class CorrectableSubmissionError extends Error {
@@ -25,7 +26,7 @@ export function isCorrectableExecuteError(error) {
  * Consumed by the ACP envelope tool catch; host adapters wrap transport shape only.
  */
 export function projectCorrectableExecuteRejection(error) {
-    const diagnostic = error instanceof Error ? error.message : String(error);
+    const diagnostic = errorText(error);
     if (error instanceof GatekeeperDecisionError) {
         return { diagnostic, details: { ...error.result } };
     }

package/dist/submission-errors.js

@@ -1,4 +1,5 @@
 import { readableGateItem } from "./readable-gate-item.js";
+import { isRecord } from "./unknown-value.js";
 /**
  * Tool-result text the parent model sees (#753 / #750 evidence).
  * continue | escalate → officer receipt verbatim (JSON when structured).
@@ -61,7 +62,7 @@ export function unreadableDiscriminatorNotice(field, received) {
 }
 /** The received discriminator only — never the rest of the receipt. */
 export function receivedDiscriminator(receipt, field) {
-    if (receipt === null || typeof receipt !== "object" || Array.isArray(receipt))
+    if (!isRecord(receipt))
         return undefined;
     if (!Object.hasOwn(receipt, field))
         return undefined;

package/dist/submission-gate.js

@@ -10,7 +10,7 @@ export function latestQueueStatus(terminal) {
     if (outcome.kind !== "accepted")
         return undefined;
     const latest = outcome.payloads?.[outcome.payloads.length - 1];
-    if (latest !== null && typeof latest === "object" && !Array.isArray(latest)) {
+    if (isRecord(latest)) {
         const status = latest.status;
         if (typeof status === "string" && status.trim() !== "")
             return status;
@@ -29,6 +29,7 @@ export function latestQueuePayload(terminal) {
     return payloads.length === 0 ? undefined : payloads[payloads.length - 1];
 }
 import { sessionFileFromPublicSummon } from "./session-assistant-usage.js";
+import { isRecord } from "./unknown-value.js";
 /**
  * Shared-envelope default officer summon (ADR 0018).
  * Role modules must not own this drive seam — only project results.

package/dist/submission-ledger.js

@@ -7,6 +7,7 @@ import { findRunDirectoryById } from "./public-cli/run-lifecycle.js";
 import { isCorrectableExecuteError } from "./submission-correctable-error.js";
 import { failOnInfrastructureFailureDeclaration, infrastructureFailureDiagnostic } from "./package-contracts/terminating-infrastructure.js";
 import { REVIEW_SUBMISSION_OUTPUT_TOOL_NAME } from "./review-submission.js";
+import { isRecord, errorText } from "./unknown-value.js";
 /**
  * Admitted run identity for the ledger subject.
  * Prefer AK_ROLE_RUN_DIR via sole runDirectory→runId parser (public-CLI correlation);
@@ -464,9 +465,7 @@ export function createSubmissionLedgerHost(host, outputTools, failInfrastructure
                         // host-failure seam. Tool identity comes from the registry map.
                         const reviewEscalate = tool.name === REVIEW_SUBMISSION_OUTPUT_TOOL_NAME
                             && infrastructureFailureDiagnostic(params) !== undefined
-                            && params !== null
-                            && typeof params === "object"
-                            && !Array.isArray(params)
+                            && isRecord(params)
                             && params.status === "escalate";
                         if (!reviewEscalate) {
                             failOnInfrastructureFailureDeclaration(params, {
@@ -485,7 +484,7 @@ export function createSubmissionLedgerHost(host, outputTools, failInfrastructure
                                 toolCallId,
                                 outcome: "correctable-rejection",
                                 code: "typed-bounce",
-                                diagnostic: error instanceof Error ? error.message : String(error),
+                                diagnostic: errorText(error),
                                 role,
                                 accepted: params,
                             });
@@ -497,7 +496,7 @@ export function createSubmissionLedgerHost(host, outputTools, failInfrastructure
                                 attemptId,
                                 toolCallId,
                                 outcome: "infrastructure",
-                                diagnostic: error instanceof Error ? error.message : String(error),
+                                diagnostic: errorText(error),
                                 role,
                                 accepted: params,
                             });