@scotthuang/agent-knock-knock 0.13.16 → 0.13.18

package/dist/src/codex-rollout-bound-completion.js

@@ -0,0 +1,357 @@
+// Completion proof for one already-accepted legacy Codex turn.
+import { assertPrivateRegularFile, CODEX_COMPLETION_MAX_BYTES, fileEndsWithNewline, openExactRollout, readCodexRolloutHeader, sameRolloutFileIdentity, sameRolloutIdentity, sameStableFile, } from "./codex-rollout-file.js";
+import { assertCodexRolloutLegacyHistory, optionalString, scanExactCodexTaskComplete, truncateCompletionText, } from "./codex-rollout-records.js";
+import { redactString, } from "./runtime-log.js";
+import { exactNativeThreadId, fingerprint, normalizedRolloutIdentity, requiredString, sha256Value, validateCodexRolloutAcceptanceAnchor, validateTerminalSubmissionAcceptanceEvidence, } from "./terminal-submission-facts.js";
+import fs from "node:fs";
+/**
+ * Scans the exact rollout and native turn proven by terminal acceptance.
+ *
+ * Unlike the general Codex context loader, this detector does not retain only
+ * a recent-turn window. It starts at the immutable pre-submission byte anchor
+ * and matches only the persisted acceptance UUID, so a delayed monitor can
+ * recover completion even after later native turns have been appended.
+ */
+export function detectCodexBoundRolloutCompletion(options) {
+    const prepared = prepareCompletionAcceptance(options);
+    if (prepared.status !== "ready")
+        return prepared;
+    const accepted = validateCompletionAcceptanceMetadata(prepared.context);
+    if (accepted.status !== "ready")
+        return accepted;
+    const bound = bindCompletionRollout(options.currentIdentity, accepted.context);
+    if (bound.status !== "ready")
+        return bound;
+    const context = bound.context;
+    const { rollout, rolloutDiagnostics, acceptanceId } = context;
+    let opened;
+    try {
+        opened = openExactRollout(rollout);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return codexCompletionFailure(/identity does not match/u.test(message)
+            ? "rollout_identity_mismatch"
+            : "rollout_unreadable", error, rolloutDiagnostics);
+    }
+    try {
+        const suffix = readCompletionSuffix(opened, context);
+        if (suffix.status !== "ready")
+            return suffix;
+        const scan = scanExactCodexTaskComplete(suffix.context.buffer.toString("utf8"), acceptanceId);
+        return projectCompletionScan(scan, context, suffix.context);
+    }
+    catch (error) {
+        return codexCompletionFailure("rollout_unreadable", error, rolloutDiagnostics);
+    }
+    finally {
+        try {
+            fs.closeSync(opened.fd);
+        }
+        catch {
+            // The scan result is already fenced by the descriptor identity and both
+            // file snapshots. A close failure cannot make it safe to retry a native
+            // turn, so do not replace that deterministic result with an exception.
+        }
+    }
+}
+function prepareCompletionAcceptance(options) {
+    let anchor;
+    try {
+        anchor = validateCodexRolloutAcceptanceAnchor(options.anchor);
+    }
+    catch (error) {
+        return codexCompletionFailure("invalid_anchor", error);
+    }
+    const initialDiagnostics = {
+        detector: "codex_exact_bound_rollout",
+        anchor_fingerprint: anchor.anchor_fingerprint,
+        scan_start_offset_bytes: anchor.offset_bytes
+    };
+    let requestHash;
+    let acceptance;
+    let expectedNativeThreadId;
+    try {
+        requestHash = sha256Value(options.requestHash, "terminal request hash");
+        expectedNativeThreadId = anchor.version === 1
+            ? anchor.native_thread_id
+            : exactNativeThreadId(options.acceptanceEvidence.nativeThreadId);
+        acceptance = validateTerminalSubmissionAcceptanceEvidence(options.acceptanceEvidence, {
+            source: "codex_rollout",
+            nativeThreadId: expectedNativeThreadId,
+            requestHash
+        });
+    }
+    catch (error) {
+        return codexCompletionFailure("invalid_acceptance_evidence", error, initialDiagnostics);
+    }
+    const acceptedCandidate = anchor.version === 3
+        ? anchor.candidate_rollouts.find((candidate) => candidate.native_thread_id === expectedNativeThreadId)
+        : undefined;
+    const scanStartOffset = acceptedCandidate?.offset_bytes ??
+        anchor.offset_bytes;
+    const baseDiagnostics = {
+        ...initialDiagnostics,
+        scan_start_offset_bytes: scanStartOffset,
+        native_thread_id: expectedNativeThreadId
+    };
+    return {
+        status: "ready",
+        context: {
+            anchor, acceptance, acceptedCandidate, expectedNativeThreadId,
+            scanStartOffset, baseDiagnostics
+        }
+    };
+}
+function validateCompletionAcceptanceMetadata(context) {
+    const { anchor, acceptance, scanStartOffset, baseDiagnostics } = context;
+    let acceptanceId;
+    try {
+        acceptanceId = exactNativeThreadId(acceptance.acceptanceId);
+    }
+    catch (error) {
+        return codexCompletionFailure("acceptance_turn_mismatch", error, baseDiagnostics);
+    }
+    const diagnostics = {
+        ...baseDiagnostics,
+        acceptance_id: acceptanceId
+    };
+    if (acceptance.anchorFingerprint !== anchor.anchor_fingerprint) {
+        return codexCompletionFailure("acceptance_anchor_mismatch", new Error("Codex acceptance evidence belongs to a different byte anchor"), diagnostics);
+    }
+    const evidenceTurnId = optionalString(acceptance.metadata?.turn_id);
+    if (evidenceTurnId !== undefined) {
+        let normalizedEvidenceTurnId;
+        try {
+            normalizedEvidenceTurnId = exactNativeThreadId(evidenceTurnId);
+        }
+        catch (error) {
+            return codexCompletionFailure("acceptance_turn_mismatch", error, diagnostics);
+        }
+        if (normalizedEvidenceTurnId !== acceptanceId) {
+            return codexCompletionFailure("acceptance_turn_mismatch", new Error("Codex acceptance metadata names a different native turn"), diagnostics);
+        }
+    }
+    let evidenceAnchorOffset;
+    try {
+        evidenceAnchorOffset = optionalSafeOffset(acceptance.metadata?.anchor_offset_bytes);
+    }
+    catch (error) {
+        return codexCompletionFailure("invalid_acceptance_evidence", error, diagnostics);
+    }
+    if (evidenceAnchorOffset !== undefined &&
+        evidenceAnchorOffset !== scanStartOffset) {
+        return codexCompletionFailure("acceptance_anchor_mismatch", new Error("Codex acceptance evidence has a different byte offset"), diagnostics);
+    }
+    return {
+        status: "ready",
+        context: { ...context, acceptanceId, diagnostics }
+    };
+}
+function bindCompletionRollout(current, context) {
+    const { anchor, acceptedCandidate, expectedNativeThreadId, diagnostics } = context;
+    try {
+        if (exactNativeThreadId(current.sessionId) !== expectedNativeThreadId ||
+            requiredString(current.processUuid, "Codex process UUID") !==
+                anchor.process_uuid ||
+            requiredString(current.processBirth, "Codex process birth") !==
+                anchor.process_birth) {
+            throw new Error("Codex process or native thread identity changed during completion polling");
+        }
+    }
+    catch (error) {
+        return codexCompletionFailure("binding_identity_mismatch", error, diagnostics);
+    }
+    if (!current.rollout) {
+        return codexCompletionFailure("rollout_identity_mismatch", new Error("the accepted Codex Turn lost its persisted exact rollout identity"), diagnostics);
+    }
+    let rollout;
+    try {
+        rollout = normalizedRolloutIdentity(current.rollout);
+    }
+    catch (error) {
+        return codexCompletionFailure("rollout_identity_mismatch", error, diagnostics);
+    }
+    const rolloutDiagnostics = {
+        ...diagnostics,
+        rollout_identity_fingerprint: fingerprint(rollout)
+    };
+    const anchoredRollout = anchor.version === 3
+        ? acceptedCandidate?.rollout
+        : anchor.rollout;
+    const anchoredRolloutMatches = !anchoredRollout || (anchor.version === 3
+        ? sameRolloutFileIdentity(anchoredRollout, rollout)
+        : sameRolloutIdentity(anchoredRollout, rollout));
+    if (!anchoredRolloutMatches) {
+        return codexCompletionFailure("rollout_identity_mismatch", new Error("Codex rollout identity changed after terminal acceptance"), rolloutDiagnostics);
+    }
+    return {
+        status: "ready",
+        context: { ...context, rollout, rolloutDiagnostics }
+    };
+}
+function readCompletionSuffix(opened, context) {
+    const { acceptance, scanStartOffset, rolloutDiagnostics } = context;
+    const before = opened.stat;
+    try {
+        assertPrivateRegularFile(before);
+    }
+    catch (error) {
+        return codexCompletionFailure("rollout_unreadable", error, rolloutDiagnostics);
+    }
+    let evidenceEndOffset;
+    try {
+        evidenceEndOffset = optionalSafeOffset(acceptance.metadata?.observed_end_offset_bytes);
+    }
+    catch (error) {
+        return codexCompletionFailure("invalid_acceptance_evidence", error, rolloutDiagnostics);
+    }
+    if (before.size < scanStartOffset ||
+        (evidenceEndOffset !== undefined && before.size < evidenceEndOffset)) {
+        return codexCompletionFailure("rollout_truncated", new Error("Codex rollout was truncated after native acceptance"), {
+            ...rolloutDiagnostics,
+            observed_end_offset_bytes: before.size
+        });
+    }
+    const bytesToRead = before.size - scanStartOffset;
+    const observedDiagnostics = {
+        ...rolloutDiagnostics,
+        observed_end_offset_bytes: before.size
+    };
+    if (bytesToRead > CODEX_COMPLETION_MAX_BYTES) {
+        return codexCompletionFailure("scan_limit_exceeded", new Error("Codex bound completion suffix exceeded the safe scan limit"), observedDiagnostics);
+    }
+    try {
+        if (before.size > 0) {
+            assertCodexRolloutLegacyHistory(readCodexRolloutHeader(opened.fd, before.size));
+        }
+    }
+    catch (error) {
+        return codexCompletionFailure("rollout_unreadable", error, observedDiagnostics);
+    }
+    if (bytesToRead === 0) {
+        return codexCompletionPending("exact_turn_not_complete", observedDiagnostics, "no post-anchor Codex rollout records are available yet");
+    }
+    if (!fileEndsWithNewline(opened.fd, before.size)) {
+        return codexCompletionPending("partial_rollout_record", observedDiagnostics, "the exact Codex rollout ends with a partial JSONL record");
+    }
+    const buffer = Buffer.allocUnsafe(bytesToRead);
+    const bytesRead = fs.readSync(opened.fd, buffer, 0, bytesToRead, scanStartOffset);
+    const after = fs.fstatSync(opened.fd);
+    if (bytesRead !== bytesToRead || !sameStableFile(before, after)) {
+        return codexCompletionPending("rollout_changed_during_scan", observedDiagnostics, "the exact Codex rollout changed while completion was scanned");
+    }
+    return {
+        status: "ready",
+        context: { buffer, observedEndOffsetBytes: before.size, observedDiagnostics }
+    };
+}
+function projectCompletionScan(scan, context, suffix) {
+    const { acceptanceId, expectedNativeThreadId, anchor, rolloutDiagnostics, scanStartOffset } = context;
+    const { observedDiagnostics, observedEndOffsetBytes } = suffix;
+    const scanDiagnostics = {
+        ...observedDiagnostics,
+        scanned_records: scan.scannedRecords,
+        observed_task_complete_records: scan.observedTaskCompleteRecords,
+        observed_turn_aborted_records: scan.observedTurnAbortedRecords
+    };
+    if (scan.status === "failure") {
+        return codexCompletionFailure(scan.code, scan.detail, scanDiagnostics);
+    }
+    if (scan.status === "pending") {
+        return codexCompletionPending("exact_turn_not_complete", scanDiagnostics, "the accepted Codex native turn has no durable task_complete record yet");
+    }
+    if (scan.status === "aborted") {
+        const reason = truncateCompletionText(redactString(scan.reason ?? "interrupted"));
+        const completion = {
+            source: "durable",
+            outcome: "failure",
+            text: truncateCompletionText(redactString(`Codex task stopped: ${reason}`)),
+            ...(scan.timestamp ? { timestamp: scan.timestamp } : {}),
+            id: acceptanceId,
+            confidence: "high",
+            metadata: {
+                match: "bound_rollout_turn_aborted",
+                turn_id: acceptanceId,
+                native_thread_id: expectedNativeThreadId,
+                anchor_fingerprint: anchor.anchor_fingerprint,
+                rollout_identity_fingerprint: rolloutDiagnostics.rollout_identity_fingerprint,
+                abort_reason: reason,
+                scan_start_offset_bytes: scanStartOffset,
+                observed_end_offset_bytes: observedEndOffsetBytes,
+                scanned_records: scan.scannedRecords,
+                observed_task_complete_records: scan.observedTaskCompleteRecords,
+                observed_turn_aborted_records: scan.observedTurnAbortedRecords
+            }
+        };
+        return {
+            status: "completed",
+            completion,
+            diagnostics: {
+                ...scanDiagnostics,
+                code: "abort_found"
+            }
+        };
+    }
+    const completion = {
+        source: "durable",
+        outcome: "success",
+        text: truncateCompletionText(redactString(scan.text)),
+        ...(scan.timestamp ? { timestamp: scan.timestamp } : {}),
+        id: acceptanceId,
+        confidence: "high",
+        metadata: {
+            match: "bound_rollout_task_complete",
+            turn_id: acceptanceId,
+            native_thread_id: expectedNativeThreadId,
+            anchor_fingerprint: anchor.anchor_fingerprint,
+            rollout_identity_fingerprint: rolloutDiagnostics.rollout_identity_fingerprint,
+            scan_start_offset_bytes: scanStartOffset,
+            observed_end_offset_bytes: observedEndOffsetBytes,
+            scanned_records: scan.scannedRecords,
+            observed_task_complete_records: scan.observedTaskCompleteRecords,
+            observed_turn_aborted_records: scan.observedTurnAbortedRecords
+        }
+    };
+    return {
+        status: "completed",
+        completion,
+        diagnostics: {
+            ...scanDiagnostics,
+            code: "completion_found"
+        }
+    };
+}
+function codexCompletionPending(code, diagnostics, detail) {
+    return {
+        status: "pending",
+        diagnostics: {
+            ...diagnostics,
+            code,
+            detail
+        }
+    };
+}
+function codexCompletionFailure(code, error, diagnostics = {
+    detector: "codex_exact_bound_rollout"
+}) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return {
+        status: "failure",
+        diagnostics: {
+            ...diagnostics,
+            code,
+            detail: truncateCompletionText(redactString(detail))
+        }
+    };
+}
+function optionalSafeOffset(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new Error("Codex acceptance evidence byte offset is invalid");
+    }
+    return Number(value);
+}
+//# sourceMappingURL=codex-rollout-bound-completion.js.map

package/dist/src/codex-rollout-bound-completion.js.map

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

package/dist/src/codex-rollout-file.d.ts

@@ -0,0 +1,15 @@
+import { type CodexRolloutIdentity } from "./terminal-submission-facts.js";
+import fs from "node:fs";
+export declare const CODEX_COMPLETION_MAX_BYTES: number;
+export declare function readCodexRolloutHeader(fd: number, size: number): Buffer;
+export declare function readExactBytes(fd: number, offset: number, length: number): Buffer;
+export declare function openExactRollout(rollout: CodexRolloutIdentity): {
+    fd: number;
+    stat: fs.Stats;
+};
+export declare function assertPrivateRegularFile(stat: fs.Stats): void;
+export declare function fileEndsWithNewline(fd: number, size: number): boolean;
+export declare function byteAtOffset(fd: number, offset: number): number | undefined;
+export declare function sameStableFile(left: fs.Stats, right: fs.Stats): boolean;
+export declare function sameRolloutIdentity(left: CodexRolloutIdentity, right: CodexRolloutIdentity): boolean;
+export declare function sameRolloutFileIdentity(left: CodexRolloutIdentity, right: CodexRolloutIdentity): boolean;

package/dist/src/codex-rollout-file.js

@@ -0,0 +1,98 @@
+// Descriptor identity and stable byte reads for legacy Codex rollouts.
+import { parsedInteger, } from "./terminal-submission-facts.js";
+import fs from "node:fs";
+import path from "node:path";
+export const CODEX_COMPLETION_MAX_BYTES = 256 * 1024 * 1024;
+const CODEX_ROLLOUT_HEADER_MAX_BYTES = 1024 * 1024;
+const NO_FOLLOW_FLAG = typeof fs.constants.O_NOFOLLOW === "number"
+    ? fs.constants.O_NOFOLLOW
+    : 0;
+export function readCodexRolloutHeader(fd, size) {
+    const bytesToRead = Math.min(size, CODEX_ROLLOUT_HEADER_MAX_BYTES);
+    const buffer = readExactBytes(fd, 0, bytesToRead);
+    const newline = buffer.indexOf(0x0a);
+    if (newline < 0) {
+        throw new Error("Codex active-task rollout header exceeded the safe read limit");
+    }
+    return buffer.subarray(0, newline + 1);
+}
+export function readExactBytes(fd, offset, length) {
+    const buffer = Buffer.allocUnsafe(length);
+    let total = 0;
+    while (total < length) {
+        const read = fs.readSync(fd, buffer, total, length - total, offset + total);
+        if (read === 0) {
+            break;
+        }
+        total += read;
+    }
+    if (total !== length) {
+        throw new Error("Codex rollout changed while it was being read");
+    }
+    return buffer;
+}
+export function openExactRollout(rollout) {
+    if (!path.isAbsolute(rollout.path)) {
+        throw new Error("Codex rollout path is not absolute");
+    }
+    const before = fs.lstatSync(rollout.path);
+    if (!before.isFile() || before.isSymbolicLink()) {
+        throw new Error("Codex rollout path is not a regular file");
+    }
+    const fd = fs.openSync(rollout.path, fs.constants.O_RDONLY | NO_FOLLOW_FLAG);
+    try {
+        const stat = fs.fstatSync(fd);
+        if (BigInt(stat.dev) !== parsedInteger(rollout.device) ||
+            BigInt(stat.ino) !== parsedInteger(rollout.inode)) {
+            throw new Error("Codex rollout descriptor identity does not match its open file");
+        }
+        return { fd, stat };
+    }
+    catch (error) {
+        fs.closeSync(fd);
+        throw error;
+    }
+}
+export function assertPrivateRegularFile(stat) {
+    if (!stat.isFile()) {
+        throw new Error("Codex rollout is not a regular file");
+    }
+    if (process.platform !== "win32" &&
+        typeof process.getuid === "function" &&
+        stat.uid !== process.getuid()) {
+        throw new Error("Codex rollout is not owned by the current user");
+    }
+    if (process.platform !== "win32" && (stat.mode & 0o022) !== 0) {
+        throw new Error("Codex rollout is writable by another user");
+    }
+}
+export function fileEndsWithNewline(fd, size) {
+    if (size <= 0) {
+        return true;
+    }
+    const last = Buffer.allocUnsafe(1);
+    return fs.readSync(fd, last, 0, 1, size - 1) === 1 && last[0] === 0x0a;
+}
+export function byteAtOffset(fd, offset) {
+    const buffer = Buffer.allocUnsafe(1);
+    return fs.readSync(fd, buffer, 0, 1, offset) === 1
+        ? buffer[0]
+        : undefined;
+}
+export function sameStableFile(left, right) {
+    return left.dev === right.dev &&
+        left.ino === right.ino &&
+        left.size === right.size &&
+        left.mtimeMs === right.mtimeMs &&
+        left.ctimeMs === right.ctimeMs;
+}
+export function sameRolloutIdentity(left, right) {
+    return left.fd === right.fd &&
+        sameRolloutFileIdentity(left, right);
+}
+export function sameRolloutFileIdentity(left, right) {
+    return left.device === right.device &&
+        left.inode === right.inode &&
+        left.path === right.path;
+}
+//# sourceMappingURL=codex-rollout-file.js.map

package/dist/src/codex-rollout-file.js.map

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

package/dist/src/codex-rollout-human-task.d.ts

@@ -0,0 +1,61 @@
+import { type TerminalCompletionEvidence } from "./terminal-agent-adapter.js";
+import { type CodexRolloutAcceptanceIdentity, type CodexRolloutIdentity } from "./terminal-submission-facts.js";
+/**
+ * Durable identity for one already-running Codex task that was started by the
+ * human in the TUI. The prompt itself is deliberately omitted; the exact root
+ * user row is represented only by its SHA-256 digest and native turn UUID.
+ */
+export interface CodexHumanStartedActiveTaskAnchor {
+    schema: "agent-knock-knock/codex-human-started-active-task-anchor";
+    version: 1;
+    native_thread_id: string;
+    process_uuid: string;
+    process_birth: string;
+    captured_at: string;
+    rollout: CodexRolloutIdentity;
+    turn_id: string;
+    request_hash: string;
+    codex_version: string;
+    task_started_offset_bytes: number;
+    user_message_offset_bytes: number;
+    observed_end_offset_bytes: number;
+    anchor_fingerprint: string;
+}
+export interface CaptureCodexHumanStartedActiveTaskOptions {
+    currentIdentity: CodexRolloutAcceptanceIdentity;
+    now?: Date;
+    maxBytes?: number;
+}
+export interface ObserveCodexHumanStartedActiveTaskOptions {
+    anchor: CodexHumanStartedActiveTaskAnchor;
+    currentIdentity: CodexRolloutAcceptanceIdentity;
+    maxBytes?: number;
+    /** Last complete, stable JSONL boundary returned by a prior observation. */
+    resumeOffsetBytes?: number;
+}
+export type CodexHumanStartedActiveTaskObservation = {
+    status: "pending";
+    observedEndOffsetBytes: number;
+    safeResumeOffsetBytes: number;
+} | {
+    status: "completed";
+    completion: TerminalCompletionEvidence & {
+        outcome: "success" | "failure";
+    };
+} | {
+    status: "invalidated";
+    reason: string;
+} | {
+    status: "unavailable";
+    reason: string;
+    retryable: true;
+};
+/**
+ * Capture the latest active native task in an exact open Codex rollout.
+ * This is intentionally separate from the pre-send acceptance anchor: all
+ * task-start and root-user evidence already exists when this function runs.
+ */
+export declare function captureCodexHumanStartedActiveTaskAnchor(options: CaptureCodexHumanStartedActiveTaskOptions): CodexHumanStartedActiveTaskAnchor | undefined;
+/** Observe only the exact human-started task named by the persisted anchor. */
+export declare function observeCodexHumanStartedActiveTask(options: ObserveCodexHumanStartedActiveTaskOptions): CodexHumanStartedActiveTaskObservation;
+export declare function validateCodexHumanStartedActiveTaskAnchor(value: unknown): CodexHumanStartedActiveTaskAnchor;