@scotthuang/agent-knock-knock 0.12.11 → 0.12.12

package/dist/src/terminal-status-facts.js

@@ -0,0 +1,199 @@
+import { isExecutorKind } from "./executors.js";
+import { executorForConversation, sessionIdForConversation, turnIdForConversation } from "./protocol.js";
+import { isRecord, nonBlankString as stringValue } from "./value-guards.js";
+export function summarizeConversation(conversation, ports) {
+    const executor = executorForConversation(conversation);
+    const callbackDelivery = isRecord(conversation.callback_delivery)
+        ? conversation.callback_delivery
+        : undefined;
+    const callbackDisposition = callbackDelivery
+        ? ports.callbackRetryDisposition(callbackDelivery)
+        : undefined;
+    return {
+        session_id: sessionIdForConversation(conversation),
+        turn_id: turnIdForConversation(conversation),
+        conversation_id: conversation.conversation_id,
+        agent: executor.kind,
+        executor,
+        session: executor.session,
+        status: conversation.status,
+        request: conversation.user_request,
+        workspace: conversation.workspace,
+        openclaw_session: conversation.openclaw_session,
+        response_rounds_used: conversation.response_rounds_used,
+        soft_limit: conversation.soft_limit,
+        hard_limit: conversation.hard_limit,
+        created_at: conversation.created_at,
+        updated_at: conversation.updated_at,
+        idle_since: conversation.idle_since,
+        closed_at: conversation.closed_at,
+        ...(callbackDelivery
+            ? {
+                callback_delivery: {
+                    status: callbackDelivery.status,
+                    attempts: callbackDelivery.attempts,
+                    attempt_state: callbackDisposition?.state,
+                    attempt_pid: callbackDelivery.attempt_pid,
+                    lease_expires_at: callbackDelivery.attempt_lease_expires_at,
+                    next_attempt_at: callbackDelivery.next_attempt_at,
+                    last_error: callbackDelivery.last_error === undefined
+                        ? undefined
+                        : ports.textSummary(String(callbackDelivery.last_error))
+                }
+            }
+            : {}),
+        state_path: conversation.state_path,
+        event_log_path: conversation.event_log_path
+    };
+}
+export function isDiscoverableTmuxConversation(conversation) {
+    if (!isRecord(conversation) || !isRecord(conversation.executor)) {
+        return false;
+    }
+    const kind = stringValue(conversation.executor.kind)?.toLowerCase();
+    return kind !== undefined &&
+        isExecutorKind(kind) &&
+        conversation.executor.transport === "tmux";
+}
+export function persistedExecutorLogFields(conversation) {
+    if (isDiscoverableTmuxConversation(conversation)) {
+        const executor = executorForConversation(conversation);
+        return {
+            agent: executor.kind,
+            executor_session: executor.session
+        };
+    }
+    const rawExecutor = isRecord(conversation?.executor) ? conversation.executor : {};
+    return {
+        agent: stringValue(rawExecutor.kind) ?? "unsupported",
+        executor_session: stringValue(rawExecutor.session)
+    };
+}
+export function summarizeEvent(event) {
+    return {
+        ts: event.ts,
+        event: event.event,
+        from: event.from,
+        to: event.to,
+        type: event.type,
+        status: event.status,
+        round: event.round,
+        body: typeof event.body === "string" ? event.body.slice(0, 500) : undefined
+    };
+}
+export function codexTerminalContextFromHistory(input) {
+    const { id, confidence, match, process, context, terminalControl, terminalStatus, limitations, candidates } = input;
+    return {
+        conversation_id: id,
+        source: "terminal_control",
+        confidence,
+        match,
+        about: rolloutAbout(context, terminalStatus),
+        codex_session: context.source,
+        evidence: {
+            process,
+            terminal_control: terminalControl,
+            terminal_status: terminalStatus,
+            initial_request: bestSessionIntent(context),
+            title: context.source.title,
+            recent_messages: visibleRolloutMessages(context).slice(-8),
+            recent_commands: context.commands.slice(-8),
+            candidates
+        },
+        limitations
+    };
+}
+export function managedConversationAbout(conversation, events, terminalStatus) {
+    const request = truncateText(String(conversation.user_request ?? "").trim(), 220);
+    const recent = recentMessageEvidence(events).at(-1)?.body;
+    const parts = [
+        request ? `Initial request: ${request}` : undefined,
+        recent ? `Latest visible message: ${truncateText(recent, 180)}` : undefined,
+        terminalStatus?.activity_state
+            ? `Current terminal state: ${terminalStatus.activity_state}.`
+            : undefined
+    ].filter(Boolean);
+    return parts.length > 0
+        ? parts.join(" ")
+        : "No durable task content is available for this AKK-managed session.";
+}
+export function rolloutAbout(context, terminalStatus) {
+    const title = truncateText(String(context.source.title ?? "").trim(), 180);
+    const intent = bestSessionIntent(context);
+    const latestAssistant = [...visibleRolloutMessages(context)].reverse()
+        .find((message) => message.role === "assistant")?.text;
+    const latestCommand = context.commands.at(-1)?.command;
+    const parts = [
+        intent
+            ? `Initial request: ${truncateText(intent, 220)}`
+            : title ? `Codex title: ${title}` : undefined,
+        latestAssistant
+            ? `Latest visible progress: ${truncateText(latestAssistant, 180)}`
+            : undefined,
+        latestCommand
+            ? `Recent command: ${truncateText(latestCommand, 140)}`
+            : undefined,
+        terminalStatus?.activity_state
+            ? `Current terminal state: ${terminalStatus.activity_state}.`
+            : undefined
+    ].filter(Boolean);
+    return parts.length > 0
+        ? parts.join(" ")
+        : "Codex history was found, but it did not include enough visible message content to summarize the session.";
+}
+export function screenOnlyAbout(input) {
+    const { process, terminalStatus } = input;
+    const activity = terminalStatus?.activity_reason ?? terminalStatus?.activity_state;
+    const excerpt = terminalStatus?.screen?.excerpt;
+    const parts = [
+        process?.cwd ? `This Codex process is running in ${process.cwd}.` : undefined,
+        activity ? `Terminal activity: ${truncateText(String(activity), 180)}` : undefined,
+        excerpt ? `Visible screen: ${truncateText(String(excerpt), 220)}` : undefined
+    ].filter(Boolean);
+    return parts.length > 0
+        ? parts.join(" ")
+        : "Only active process metadata is available; no Codex conversation history or terminal screen content could be read.";
+}
+export function bestSessionIntent(context) {
+    const firstUser = visibleRolloutMessages(context)
+        .find((message) => message.role === "user")?.text;
+    if (firstUser) {
+        return firstUser;
+    }
+    const title = cleanIntentText(context.source.title);
+    if (title) {
+        return title;
+    }
+    return undefined;
+}
+export function visibleRolloutMessages(context) {
+    return context.messages.filter((message) => !isEnvironmentContextMessage(message.text));
+}
+export function cleanIntentText(value) {
+    const text = String(value ?? "").replace(/\s+/g, " ").trim();
+    return text && !isEnvironmentContextMessage(text) ? text : undefined;
+}
+export function isEnvironmentContextMessage(value) {
+    return /^\s*<environment_context[\s>]/u.test(String(value ?? ""));
+}
+function recentMessageEvidence(events) {
+    return events
+        .filter((event) => event.event === "message" && typeof event.body === "string")
+        .slice(-8)
+        .map((event) => ({
+        ts: event.ts,
+        from: event.from,
+        to: event.to,
+        type: event.type,
+        round: event.round,
+        body: truncateText(event.body, 800)
+    }));
+}
+export function truncateText(value, maxLength) {
+    const text = String(value ?? "").replace(/\s+/g, " ").trim();
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return `${text.slice(0, Math.max(0, maxLength - 3))}...`;
+}
+//# sourceMappingURL=terminal-status-facts.js.map

package/dist/src/terminal-status-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-status-facts.js","sourceRoot":"","sources":["../../src/terminal-status-facts.ts"],"names":[],"mappings":"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"}

package/dist/src/terminal-submission-acceptance.d.ts

@@ -1,101 +1,8 @@
-import type { CodexOpenRootRolloutIdentity, CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
+import type { CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
 import type { TerminalCompletionEvidence } from "./terminal-agent-adapter.js";
-export interface TerminalSubmissionAcceptanceEvidence {
-    source: "codex_rollout" | "claude_transcript";
-    kind: "native_user_turn";
-    nativeThreadId: string;
-    requestHash: string;
-    acceptanceId: string;
-    acceptedAt?: string;
-    anchorFingerprint: string;
-    evidenceFingerprint: string;
-    metadata?: Record<string, string | number>;
-}
-export interface CodexRolloutIdentity {
-    fd: string;
-    device: string;
-    inode: string;
-    path: string;
-}
-interface CodexRolloutAcceptanceAnchorBase {
-    schema: "agent-knock-knock/codex-rollout-acceptance-anchor";
-    process_uuid: string;
-    process_birth: string;
-    captured_at: string;
-    file_existed: boolean;
-    offset_bytes: number;
-    anchor_fingerprint: string;
-}
-export interface CodexBoundRolloutAcceptanceAnchor extends CodexRolloutAcceptanceAnchorBase {
-    version: 1;
-    native_thread_id: string;
-    mode: "existing" | "pre_materialization";
-    rollout?: CodexRolloutIdentity;
-    expected_empty_native_session?: true;
-}
-/**
- * A process-bound anchor for a genuinely virgin Codex TUI. Codex does not
- * assign a native thread UUID or open a rollout until its first prompt is
- * submitted, so the UUID cannot safely be named before transport. The exact
- * process incarnation is still pinned here; acceptance must additionally
- * prove the newly materialized UUID, rollout, and request hash.
- */
-export interface CodexVirginRolloutAcceptanceAnchor extends CodexRolloutAcceptanceAnchorBase {
-    version: 2;
-    mode: "pre_materialization";
-    native_thread_id?: never;
-    native_thread_binding: "post_submission";
-    file_existed: false;
-    offset_bytes: 0;
-    rollout?: never;
-    expected_empty_native_session: true;
-}
-export interface CodexCandidateRolloutAcceptanceAnchorEntry {
-    native_thread_id: string;
-    rollout: CodexRolloutIdentity;
-    offset_bytes: number;
-}
-/**
- * A process-bound pre-submit snapshot for a terminal whose open-root
- * inventory is exact but cannot name one foreground root. Existing roots are
- * fenced at their byte offsets; roots opened after capture are admitted only
- * with a fresh exact session_meta header. No candidate is selected by mtime.
- */
-export interface CodexCandidateSetRolloutAcceptanceAnchor extends CodexRolloutAcceptanceAnchorBase {
-    version: 3;
-    mode: "candidate_set";
-    native_thread_binding: "post_submission";
-    file_existed: false;
-    offset_bytes: 0;
-    zero_file_baseline: boolean;
-    inventory_pid: number;
-    inventory_cwd?: string;
-    inventory_fingerprint: string;
-    candidate_rollouts: CodexCandidateRolloutAcceptanceAnchorEntry[];
-}
-export type CodexRolloutAcceptanceAnchor = CodexBoundRolloutAcceptanceAnchor | CodexVirginRolloutAcceptanceAnchor | CodexCandidateSetRolloutAcceptanceAnchor;
-export type CodexCandidateSetRolloutAcceptanceResult = {
-    status: "accepted";
-    identity: CodexOpenRootRolloutIdentity;
-    evidence: TerminalSubmissionAcceptanceEvidence;
-} | {
-    status: "pending";
-    inspected_candidates: number;
-    exact_matches: number;
-    incomplete_candidates?: number;
-} | {
-    status: "uncertain";
-    code: "multiple_exact_request_acceptances" | "candidate_inventory_changed" | "candidate_scan_invalid";
-    reason: string;
-    inspected_candidates: number;
-    exact_matches: number;
-};
-export interface CodexRolloutAcceptanceIdentity {
-    sessionId: string;
-    processUuid?: string;
-    processBirth?: string;
-    rollout?: CodexRolloutIdentity;
-}
+import { validateCodexRolloutAcceptanceAnchor, validateTerminalSubmissionAcceptanceEvidence, type CaptureCodexRolloutAcceptanceAnchorOptions, type CodexCandidateSetRolloutAcceptanceAnchor, type CodexCandidateSetRolloutAcceptanceRequest, type CodexCandidateSetRolloutAcceptanceResult, type CodexRolloutAcceptanceAnchor, type CodexRolloutAcceptanceIdentity, type CodexRolloutAcceptanceRequest, type TerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+export { validateCodexRolloutAcceptanceAnchor, validateTerminalSubmissionAcceptanceEvidence };
+export type { CodexBoundRolloutAcceptanceAnchor, CodexCandidateRolloutAcceptanceAnchorEntry, CodexCandidateSetRolloutAcceptanceAnchor, CodexRolloutAcceptanceAnchor, CodexCandidateSetRolloutAcceptanceResult, CodexRolloutAcceptanceIdentity, CodexRolloutIdentity, TerminalSubmissionAcceptanceEvidence, CodexVirginRolloutAcceptanceAnchor } from "./terminal-submission-facts.js";
 export type CodexBoundRolloutCompletionCode = "completion_found" | "exact_turn_not_complete" | "partial_rollout_record" | "rollout_changed_during_scan" | "invalid_anchor" | "invalid_acceptance_evidence" | "acceptance_anchor_mismatch" | "acceptance_turn_mismatch" | "binding_identity_mismatch" | "rollout_identity_mismatch" | "rollout_unreadable" | "rollout_truncated" | "scan_limit_exceeded" | "invalid_rollout_jsonl" | "duplicate_exact_completion" | "invalid_exact_completion";
 export interface CodexBoundRolloutCompletionDiagnostics {
     detector: "codex_exact_bound_rollout";
@@ -121,60 +28,13 @@ export type CodexBoundRolloutCompletionResult = {
     status: "failure";
     diagnostics: CodexBoundRolloutCompletionDiagnostics;
 };
-export declare function validateTerminalSubmissionAcceptanceEvidence(value: unknown, expected: {
-    source: TerminalSubmissionAcceptanceEvidence["source"];
-    nativeThreadId: string;
-    requestHash: string;
-}): TerminalSubmissionAcceptanceEvidence;
-export declare function terminalSubmissionReplayReceipt(options: {
-    proofLevel: "submitted" | "enter_dispatched" | "agent_accepted";
-    evidence?: unknown;
-    expected: {
-        source: TerminalSubmissionAcceptanceEvidence["source"];
-        nativeThreadId: string;
-        requestHash: string;
-    };
-}): {
-    replayed: true;
-    delivered: boolean;
-    status: "async_pending" | "submission_pending_acceptance" | "submission_uncertain";
-    submission_outcome: "agent_accepted" | "pending_acceptance" | "uncertain";
-    delivery_receipt: "agent_accepted" | "enter_dispatched" | "submitted";
-    do_not_retry?: true;
-    evidence_error?: string;
-};
-type CaptureCodexRolloutAcceptanceAnchorOptions = {
-    processUuid: string;
-    processBirth: string;
-    now?: Date;
-} & ({
-    nativeThreadId: string;
-    mode: "existing";
-    rollout: CodexRolloutIdentity;
-} | {
-    nativeThreadId: string;
-    mode: "pre_materialization";
-    expectedEmptyNativeSession: true;
-} | {
-    nativeThreadId?: undefined;
-    mode: "pre_materialization";
-    expectedEmptyNativeSession: true;
-});
 export declare function captureCodexRolloutAcceptanceAnchor(options: CaptureCodexRolloutAcceptanceAnchorOptions): CodexRolloutAcceptanceAnchor;
 export declare function captureCodexCandidateSetRolloutAcceptanceAnchor({ inventory: inventoryValue, now }: {
     inventory: CodexOpenRootRolloutInventory;
     now?: Date;
 }): CodexCandidateSetRolloutAcceptanceAnchor;
-export declare function detectCodexCandidateSetRolloutAcceptance({ anchor: anchorValue, currentInventory: inventoryValue, requestHash: requestHashValue }: {
-    anchor: CodexCandidateSetRolloutAcceptanceAnchor;
-    currentInventory: CodexOpenRootRolloutInventory;
-    requestHash: string;
-}): CodexCandidateSetRolloutAcceptanceResult;
-export declare function detectCodexRolloutAcceptance(options: {
-    anchor: CodexRolloutAcceptanceAnchor;
-    currentIdentity: CodexRolloutAcceptanceIdentity;
-    requestHash: string;
-}): TerminalSubmissionAcceptanceEvidence | undefined;
+export declare function detectCodexCandidateSetRolloutAcceptance({ anchor: anchorValue, currentInventory: inventoryValue, requestHash: requestHashValue }: CodexCandidateSetRolloutAcceptanceRequest): CodexCandidateSetRolloutAcceptanceResult;
+export declare function detectCodexRolloutAcceptance(options: CodexRolloutAcceptanceRequest): TerminalSubmissionAcceptanceEvidence | undefined;
 /**
  * Scans the exact rollout and native turn proven by terminal acceptance.
  *
@@ -189,5 +49,3 @@ export declare function detectCodexBoundRolloutCompletion(options: {
     currentIdentity: CodexRolloutAcceptanceIdentity;
     requestHash: string;
 }): CodexBoundRolloutCompletionResult;
-export declare function validateCodexRolloutAcceptanceAnchor(value: CodexRolloutAcceptanceAnchor): CodexRolloutAcceptanceAnchor;
-export {};

package/dist/src/terminal-submission-acceptance.js

@@ -2,108 +2,11 @@ import { createHash } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 import { redactString } from "./runtime-log.js";
-export function validateTerminalSubmissionAcceptanceEvidence(value, expected) {
-    if (!isRecord(value)) {
-        throw new Error("native acceptance evidence is unavailable");
-    }
-    const allowedKeys = new Set([
-        "source",
-        "kind",
-        "nativeThreadId",
-        "requestHash",
-        "acceptanceId",
-        "acceptedAt",
-        "anchorFingerprint",
-        "evidenceFingerprint",
-        "metadata"
-    ]);
-    if (Object.keys(value).some((key) => !allowedKeys.has(key))) {
-        throw new Error("native acceptance evidence contains unsupported fields");
-    }
-    if (value.source !== expected.source || value.kind !== "native_user_turn") {
-        throw new Error("native acceptance evidence has the wrong agent or kind");
-    }
-    if (requiredString(value.nativeThreadId, "native acceptance thread") !==
-        requiredString(expected.nativeThreadId, "expected native acceptance thread") ||
-        sha256Value(value.requestHash, "native acceptance request hash") !==
-            sha256Value(expected.requestHash, "expected native acceptance request hash")) {
-        throw new Error("native acceptance evidence does not match the exact request binding");
-    }
-    requiredString(value.acceptanceId, "native acceptance id");
-    sha256Value(value.anchorFingerprint, "native acceptance anchor fingerprint");
-    sha256Value(value.evidenceFingerprint, "native acceptance evidence fingerprint");
-    if (value.acceptedAt !== undefined && !validTimestamp(value.acceptedAt)) {
-        throw new Error("native acceptance evidence timestamp is invalid");
-    }
-    if (value.metadata !== undefined) {
-        if (!isRecord(value.metadata)) {
-            throw new Error("native acceptance evidence metadata is invalid");
-        }
-        const allowedMetadata = value.source === "codex_rollout"
-            ? new Set([
-                "turn_id",
-                "anchor_offset_bytes",
-                "observed_end_offset_bytes"
-            ])
-            : new Set([
-                "prompt_uuid",
-                "claude_version",
-                "transcript_file_id",
-                "anchor_offset_bytes",
-                "observed_end_offset_bytes",
-                "agent_started_at_ms"
-            ]);
-        for (const [key, item] of Object.entries(value.metadata)) {
-            if (!allowedMetadata.has(key) ||
-                !(typeof item === "string" ||
-                    (typeof item === "number" && Number.isFinite(item)))) {
-                throw new Error("native acceptance evidence metadata is not allowlisted");
-            }
-        }
-    }
-    const { evidenceFingerprint, ...base } = value;
-    if (fingerprint(base) !== evidenceFingerprint) {
-        throw new Error("native acceptance evidence fingerprint does not match");
-    }
-    return value;
-}
-export function terminalSubmissionReplayReceipt(options) {
-    if (options.proofLevel !== "agent_accepted") {
-        return {
-            replayed: true,
-            delivered: false,
-            status: "submission_pending_acceptance",
-            submission_outcome: "pending_acceptance",
-            delivery_receipt: options.proofLevel,
-            do_not_retry: true
-        };
-    }
-    try {
-        validateTerminalSubmissionAcceptanceEvidence(options.evidence, options.expected);
-        return {
-            replayed: true,
-            delivered: true,
-            status: "async_pending",
-            submission_outcome: "agent_accepted",
-            delivery_receipt: "agent_accepted"
-        };
-    }
-    catch (error) {
-        return {
-            replayed: true,
-            delivered: false,
-            status: "submission_uncertain",
-            submission_outcome: "uncertain",
-            delivery_receipt: "enter_dispatched",
-            do_not_retry: true,
-            evidence_error: error instanceof Error ? error.message : String(error)
-        };
-    }
-}
+import { exactNativeThreadId, fingerprint, normalizedRolloutIdentity, parsedInteger, requiredString, sha256Value, validTimestamp, validateCodexRolloutAcceptanceAnchor, validateTerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+export { validateCodexRolloutAcceptanceAnchor, validateTerminalSubmissionAcceptanceEvidence };
 const CODEX_ACCEPTANCE_MAX_BYTES = 16 * 1024 * 1024;
 const CODEX_COMPLETION_MAX_BYTES = 256 * 1024 * 1024;
 const CODEX_COMPLETION_MAX_TEXT_LENGTH = 4000;
-const NATIVE_THREAD_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
 const NO_FOLLOW_FLAG = typeof fs.constants.O_NOFOLLOW === "number"
     ? fs.constants.O_NOFOLLOW
     : 0;
@@ -898,91 +801,6 @@ function assertVirginRolloutHeader(options) {
         throw new Error("virgin Codex rollout predates its terminal submission anchor");
     }
 }
-export function validateCodexRolloutAcceptanceAnchor(value) {
-    if (!isRecord(value) ||
-        value.schema !== "agent-knock-knock/codex-rollout-acceptance-anchor" ||
-        (value.version !== 1 && value.version !== 2 && value.version !== 3) ||
-        !["existing", "pre_materialization", "candidate_set"].includes(String(value.mode)) ||
-        !Number.isSafeInteger(value.offset_bytes) ||
-        value.offset_bytes < 0 ||
-        typeof value.file_existed !== "boolean") {
-        throw new Error("Codex rollout acceptance anchor is invalid");
-    }
-    if (value.version === 1) {
-        exactNativeThreadId(value.native_thread_id);
-        if ("native_thread_binding" in value) {
-            throw new Error("bound Codex acceptance anchor has deferred binding state");
-        }
-    }
-    else if (value.version === 2 && (value.mode !== "pre_materialization" ||
-        value.native_thread_binding !== "post_submission" ||
-        "native_thread_id" in value)) {
-        throw new Error("virgin Codex acceptance anchor is inconsistent");
-    }
-    else if (value.version === 3 && (value.mode !== "candidate_set" ||
-        value.native_thread_binding !== "post_submission" ||
-        "native_thread_id" in value ||
-        value.file_existed !== false ||
-        value.offset_bytes !== 0 ||
-        typeof value.zero_file_baseline !== "boolean" ||
-        !Number.isSafeInteger(value.inventory_pid) ||
-        value.inventory_pid <= 1 ||
-        (value.inventory_cwd !== undefined &&
-            !path.isAbsolute(value.inventory_cwd)) ||
-        !/^[0-9a-f]{64}$/u.test(String(value.inventory_fingerprint)) ||
-        !Array.isArray(value.candidate_rollouts) ||
-        value.candidate_rollouts.length > 128 ||
-        value.zero_file_baseline !== (value.candidate_rollouts.length === 0))) {
-        throw new Error("candidate-set Codex acceptance anchor is inconsistent");
-    }
-    requiredString(value.process_uuid, "Codex process UUID");
-    requiredString(value.process_birth, "Codex process birth");
-    if (!validTimestamp(value.captured_at)) {
-        throw new Error("Codex acceptance capture timestamp is invalid");
-    }
-    sha256Value(value.anchor_fingerprint, "Codex acceptance anchor fingerprint");
-    const { anchor_fingerprint: _fingerprint, ...base } = value;
-    if (fingerprint(base) !== value.anchor_fingerprint) {
-        throw new Error("Codex rollout acceptance anchor fingerprint does not match");
-    }
-    if (value.version === 3) {
-        const seenThreads = new Set();
-        const seenFiles = new Set();
-        for (const candidate of value.candidate_rollouts) {
-            if (!isRecord(candidate)) {
-                throw new Error("Codex candidate-set rollout entry is invalid");
-            }
-            const nativeThreadId = exactNativeThreadId(candidate.native_thread_id);
-            const rollout = normalizedRolloutIdentity(candidate.rollout);
-            if (!Number.isSafeInteger(candidate.offset_bytes) ||
-                candidate.offset_bytes < 0 ||
-                seenThreads.has(nativeThreadId) ||
-                seenFiles.has(`${rollout.device}:${rollout.inode}`)) {
-                throw new Error("Codex candidate-set rollout entries are ambiguous");
-            }
-            seenThreads.add(nativeThreadId);
-            seenFiles.add(`${rollout.device}:${rollout.inode}`);
-        }
-        return value;
-    }
-    const rollout = "rollout" in value ? value.rollout : undefined;
-    if (value.file_existed !== (value.mode === "existing") ||
-        value.file_existed !== Boolean(rollout)) {
-        throw new Error("Codex rollout acceptance anchor file state is inconsistent");
-    }
-    if (value.mode === "existing" && rollout) {
-        normalizedRolloutIdentity(rollout);
-        if (value.expected_empty_native_session !== undefined) {
-            throw new Error("existing Codex acceptance anchor has pre-materialization state");
-        }
-    }
-    else if (value.offset_bytes !== 0 ||
-        rollout !== undefined ||
-        value.expected_empty_native_session !== true) {
-        throw new Error("Codex pre-materialization acceptance anchor is inconsistent");
-    }
-    return value;
-}
 function validateCodexOpenRootInventoryForAcceptance(value) {
     if (!isRecord(value) ||
         value.schema !==
@@ -1087,65 +905,20 @@ function sameStableFile(left, right) {
         left.mtimeMs === right.mtimeMs &&
         left.ctimeMs === right.ctimeMs;
 }
-function normalizedRolloutIdentity(value) {
-    const normalized = {
-        fd: requiredString(value.fd, "Codex rollout descriptor"),
-        device: requiredString(value.device, "Codex rollout device"),
-        inode: requiredString(value.inode, "Codex rollout inode"),
-        path: requiredString(value.path, "Codex rollout path")
-    };
-    parsedInteger(normalized.device);
-    parsedInteger(normalized.inode);
-    return normalized;
-}
 function sameRolloutIdentity(left, right) {
     return left.fd === right.fd &&
         left.device === right.device &&
         left.inode === right.inode &&
         left.path === right.path;
 }
-function exactNativeThreadId(value) {
-    const text = requiredString(value, "Codex native thread ID").toLowerCase();
-    if (!NATIVE_THREAD_ID_PATTERN.test(text)) {
-        throw new Error("Codex native thread ID is not an exact UUID");
-    }
-    return text;
-}
-function parsedInteger(value) {
-    try {
-        return BigInt(value);
-    }
-    catch {
-        throw new Error("Codex rollout file identity is not numeric");
-    }
-}
-function sha256Value(value, label) {
-    const text = requiredString(value, label).toLowerCase();
-    if (!/^[0-9a-f]{64}$/u.test(text)) {
-        throw new Error(`${label} is not a SHA-256 value`);
-    }
-    return text;
-}
-function requiredString(value, label) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new Error(`${label} is unavailable`);
-    }
-    return value.trim();
-}
 function optionalString(value) {
     return typeof value === "string" && value.trim().length > 0
         ? value.trim()
         : undefined;
 }
-function validTimestamp(value) {
-    return typeof value === "string" && Number.isFinite(Date.parse(value));
-}
 function fingerprintText(value) {
     return createHash("sha256").update(value).digest("hex");
 }
-function fingerprint(value) {
-    return createHash("sha256").update(JSON.stringify(value)).digest("hex");
-}
 function isRecord(value) {
     return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }