@scotthuang/agent-knock-knock 0.13.15 → 0.13.17

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;