@scotthuang/agent-knock-knock 0.13.16 → 0.13.17

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

@@ -0,0 +1,49 @@
+export declare const CODEX_VERSION_PATTERN: RegExp;
+export interface CodexJsonlRecordAtOffset {
+    value: Record<string, any>;
+    offsetBytes: number;
+}
+export declare function parseCodexJsonlRecords(buffer: Buffer, label: string): CodexJsonlRecordAtOffset[];
+export declare function assertExistingCodexRolloutHeader(buffer: Buffer, nativeThreadId: string): string;
+/**
+ * Persisted anchors must check the history contract without widening their
+ * existing thread/version requirements. Older legacy headers can be minimal.
+ */
+export declare function assertCodexRolloutLegacyHistory(buffer: Buffer): void;
+export declare function positiveByteLimit(value: number | undefined, fallback: number, label: string): number;
+export declare function safeByteOffset(value: unknown, label: string): number;
+type ExactCodexTaskCompleteScan = {
+    status: "completed";
+    text: string;
+    timestamp?: string;
+    scannedRecords: number;
+    observedTaskCompleteRecords: number;
+    observedTurnAbortedRecords: number;
+} | {
+    status: "aborted";
+    reason?: string;
+    timestamp?: string;
+    scannedRecords: number;
+    observedTaskCompleteRecords: number;
+    observedTurnAbortedRecords: number;
+} | {
+    status: "pending";
+    scannedRecords: number;
+    observedTaskCompleteRecords: number;
+    observedTurnAbortedRecords: number;
+} | {
+    status: "failure";
+    code: "invalid_rollout_jsonl" | "duplicate_exact_completion" | "duplicate_exact_abort" | "conflicting_exact_settlement" | "later_turn_started" | "invalid_exact_completion" | "invalid_exact_abort";
+    detail: string;
+    scannedRecords: number;
+    observedTaskCompleteRecords: number;
+    observedTurnAbortedRecords: number;
+};
+export declare function scanExactCodexTaskComplete(text: string, acceptanceId: string): ExactCodexTaskCompleteScan;
+export declare function truncateCompletionText(value: string): string;
+export declare function exactCodexUserResponseText(content: unknown): string | undefined;
+export declare function isRetryableProviderIoError(error: unknown): boolean;
+export declare function optionalString(value: unknown): string | undefined;
+export declare function fingerprintText(value: string): string;
+export declare function isRecord(value: unknown): value is Record<string, any>;
+export {};

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

@@ -0,0 +1,298 @@
+// Pure legacy rollout record parsing, validation and completion scanning.
+import { codexThreadUsesLegacyRollout, } from "./codex-session-provider.js";
+import { exactNativeThreadId, validTimestamp, } from "./terminal-submission-facts.js";
+import { createHash, } from "node:crypto";
+const CODEX_COMPLETION_MAX_TEXT_LENGTH = 4000;
+export const CODEX_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
+export function parseCodexJsonlRecords(buffer, label) {
+    if (buffer.length > 0 && buffer[buffer.length - 1] !== 0x0a) {
+        throw new Error(`Codex ${label} ends with an incomplete JSONL record`);
+    }
+    const records = [];
+    let offset = 0;
+    while (offset < buffer.length) {
+        const newline = buffer.indexOf(0x0a, offset);
+        if (newline < 0) {
+            break;
+        }
+        const recordOffset = offset;
+        let lineBuffer = buffer.subarray(offset, newline);
+        if (lineBuffer.at(-1) === 0x0d) {
+            lineBuffer = lineBuffer.subarray(0, lineBuffer.length - 1);
+        }
+        offset = newline + 1;
+        const line = lineBuffer.toString("utf8");
+        if (!line.trim()) {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            throw new Error(`Codex ${label} contains invalid JSONL`);
+        }
+        if (!isRecord(parsed)) {
+            throw new Error(`Codex ${label} contains a non-object JSONL record`);
+        }
+        records.push({ value: parsed, offsetBytes: recordOffset });
+    }
+    return records;
+}
+export function assertExistingCodexRolloutHeader(buffer, nativeThreadId) {
+    const first = parseCodexJsonlRecords(buffer, "active-task rollout")[0]?.value;
+    const payload = first?.type === "session_meta" && isRecord(first.payload)
+        ? first.payload
+        : undefined;
+    if (!payload ||
+        exactNativeThreadId(payload.id) !== nativeThreadId ||
+        payload.originator !== "codex-tui" ||
+        payload.source !== "cli") {
+        throw new Error("Codex active-task rollout header does not identify the exact CLI thread");
+    }
+    if (!codexThreadUsesLegacyRollout(payload)) {
+        throw new Error("Codex rollout does not use legacy history");
+    }
+    const codexVersion = optionalString(payload.cli_version);
+    if (!codexVersion || !CODEX_VERSION_PATTERN.test(codexVersion)) {
+        throw new Error("Codex active-task rollout header has no exact CLI version");
+    }
+    return codexVersion;
+}
+/**
+ * Persisted anchors must check the history contract without widening their
+ * existing thread/version requirements. Older legacy headers can be minimal.
+ */
+export function assertCodexRolloutLegacyHistory(buffer) {
+    const first = parseCodexJsonlRecords(buffer, "rollout header")[0]?.value;
+    const payload = first?.type === "session_meta" && isRecord(first.payload)
+        ? first.payload
+        : undefined;
+    if (payload && !codexThreadUsesLegacyRollout(payload)) {
+        throw new Error("Codex rollout does not use legacy history");
+    }
+}
+export function positiveByteLimit(value, fallback, label) {
+    const result = value ?? fallback;
+    if (!Number.isSafeInteger(result) || result <= 0) {
+        throw new Error(`${label} byte limit is invalid`);
+    }
+    return result;
+}
+export function safeByteOffset(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new Error(`${label} is invalid`);
+    }
+    return Number(value);
+}
+export function scanExactCodexTaskComplete(text, acceptanceId) {
+    let scannedRecords = 0;
+    let observedTaskCompleteRecords = 0;
+    let observedTurnAbortedRecords = 0;
+    let exactTaskStartedIndex;
+    let laterTaskStartedIndex;
+    const exactMatches = [];
+    const exactAborts = [];
+    for (const rawLine of text.split("\n")) {
+        const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+        if (!line) {
+            continue;
+        }
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch {
+            return {
+                status: "failure",
+                code: "invalid_rollout_jsonl",
+                detail: `Codex bound completion suffix contains invalid JSONL at record ${scannedRecords + 1}`,
+                scannedRecords,
+                observedTaskCompleteRecords,
+                observedTurnAbortedRecords
+            };
+        }
+        const recordIndex = scannedRecords;
+        scannedRecords += 1;
+        if (isRecord(value) &&
+            value.type === "event_msg" &&
+            isRecord(value.payload) &&
+            value.payload.type === "task_started") {
+            const turnId = optionalString(value.payload.turn_id)?.toLowerCase();
+            if (turnId === acceptanceId) {
+                exactTaskStartedIndex ??= recordIndex;
+            }
+            else if (exactTaskStartedIndex !== undefined &&
+                laterTaskStartedIndex === undefined) {
+                laterTaskStartedIndex = recordIndex;
+            }
+            continue;
+        }
+        if (isRecord(value) &&
+            value.type === "event_msg" &&
+            isRecord(value.payload) &&
+            value.payload.type === "turn_aborted") {
+            observedTurnAbortedRecords += 1;
+            const turnId = optionalString(value.payload.turn_id)?.toLowerCase();
+            if (turnId === acceptanceId) {
+                exactAborts.push({ value, index: recordIndex });
+            }
+            continue;
+        }
+        if (!isRecord(value) ||
+            value.type !== "event_msg" ||
+            !isRecord(value.payload) ||
+            value.payload.type !== "task_complete") {
+            continue;
+        }
+        observedTaskCompleteRecords += 1;
+        const turnId = optionalString(value.payload.turn_id)?.toLowerCase();
+        if (turnId === acceptanceId) {
+            exactMatches.push({ value, index: recordIndex });
+        }
+    }
+    if (exactMatches.length > 1) {
+        return {
+            status: "failure",
+            code: "duplicate_exact_completion",
+            detail: "the exact accepted Codex turn has duplicate task_complete records",
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    if (exactAborts.length > 1) {
+        return {
+            status: "failure",
+            code: "duplicate_exact_abort",
+            detail: "the exact accepted Codex turn has duplicate turn_aborted records",
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    if (exactMatches.length > 0 && exactAborts.length > 0) {
+        return {
+            status: "failure",
+            code: "conflicting_exact_settlement",
+            detail: "the exact accepted Codex turn has conflicting completion and abort records",
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    const exactSettlementIndex = exactMatches[0]?.index ?? exactAborts[0]?.index;
+    if (laterTaskStartedIndex !== undefined &&
+        (exactSettlementIndex === undefined ||
+            laterTaskStartedIndex < exactSettlementIndex)) {
+        return {
+            status: "failure",
+            code: "later_turn_started",
+            detail: "a later Codex native turn started before the exact accepted turn settled",
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    if (exactAborts.length === 1) {
+        const match = exactAborts[0].value;
+        if (match.timestamp !== undefined && !validTimestamp(match.timestamp)) {
+            return {
+                status: "failure",
+                code: "invalid_exact_abort",
+                detail: "the exact Codex turn_aborted record has an invalid timestamp",
+                scannedRecords,
+                observedTaskCompleteRecords,
+                observedTurnAbortedRecords
+            };
+        }
+        const payload = match.payload;
+        return {
+            status: "aborted",
+            reason: optionalString(payload.reason),
+            ...(match.timestamp !== undefined
+                ? { timestamp: String(match.timestamp) }
+                : {}),
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    if (exactMatches.length === 0) {
+        return {
+            status: "pending",
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    const match = exactMatches[0].value;
+    const payload = match.payload;
+    const textValue = optionalString(payload.last_agent_message);
+    if (!textValue) {
+        return {
+            status: "failure",
+            code: "invalid_exact_completion",
+            detail: "the exact Codex task_complete record has no final agent message",
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    if (match.timestamp !== undefined && !validTimestamp(match.timestamp)) {
+        return {
+            status: "failure",
+            code: "invalid_exact_completion",
+            detail: "the exact Codex task_complete record has an invalid timestamp",
+            scannedRecords,
+            observedTaskCompleteRecords,
+            observedTurnAbortedRecords
+        };
+    }
+    return {
+        status: "completed",
+        text: textValue,
+        ...(match.timestamp !== undefined
+            ? { timestamp: String(match.timestamp) }
+            : {}),
+        scannedRecords,
+        observedTaskCompleteRecords,
+        observedTurnAbortedRecords
+    };
+}
+export function truncateCompletionText(value) {
+    return value.length <= CODEX_COMPLETION_MAX_TEXT_LENGTH
+        ? value
+        : `${value.slice(0, CODEX_COMPLETION_MAX_TEXT_LENGTH - 1)}…`;
+}
+export function exactCodexUserResponseText(content) {
+    if (!Array.isArray(content) || content.length !== 1) {
+        return undefined;
+    }
+    const item = content[0];
+    return isRecord(item) && item.type === "input_text" &&
+        typeof item.text === "string"
+        ? item.text
+        : undefined;
+}
+export function isRetryableProviderIoError(error) {
+    if (!isRecord(error) || typeof error.code !== "string") {
+        return false;
+    }
+    return new Set([
+        "EACCES", "EAGAIN", "EBUSY", "EIO", "EMFILE", "ENFILE", "ENOENT",
+        "EPERM", "ESTALE", "ETIMEDOUT"
+    ]).has(error.code);
+}
+export function optionalString(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value.trim()
+        : undefined;
+}
+export function fingerprintText(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=codex-rollout-records.js.map

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

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

package/dist/src/codex-sqlite-thread-query.d.ts

@@ -0,0 +1,85 @@
+import { type CodexThreadRow } from "./codex-session-provider.js";
+/** SQLite command protocol and file-stability evidence; no terminal identity inference. */
+export type CodexSqliteOpenMode = "readonly" | "query_only";
+export interface CodexSqliteThreadQueryRequest {
+    dbPath: string;
+    openMode: CodexSqliteOpenMode;
+    maxSessions: number;
+    nativeThreadId?: string;
+    filters?: CodexThreadQueryFilters;
+    afterSchema?: (columns: readonly string[]) => void | Promise<void>;
+}
+export interface CodexThreadQueryFilters {
+    cwd?: string;
+    source?: string;
+    archived?: boolean;
+    modelProvider?: string;
+    historyMode?: string;
+}
+export interface CodexSqliteThreadQueryResult {
+    columns: string[];
+    rows: CodexThreadRow[];
+}
+export type CodexSqliteThreadQueryRunner = (request: CodexSqliteThreadQueryRequest) => Promise<CodexSqliteThreadQueryResult>;
+export declare const NATIVE_THREAD_ID_PATTERN: RegExp;
+export declare const MAX_SQLITE_QUERY_OUTPUT_BYTES: number;
+export declare const MAX_SQLITE_ERROR_OUTPUT_BYTES: number;
+export declare const SQLITE_QUERY_TIMEOUT_MS = 10000;
+export interface CodexSqliteFileIdentity {
+    path: string;
+    exists: boolean;
+    kind?: "file" | "directory" | "other";
+    device?: string;
+    inode?: string;
+    size?: number;
+    mtimeMs?: number;
+    errorCode?: string;
+}
+export interface CodexSqliteFilesSnapshot {
+    dbPath: string;
+    main: CodexSqliteFileIdentity;
+    wal: CodexSqliteFileIdentity;
+    shm: CodexSqliteFileIdentity;
+}
+export interface CodexSqliteQueryFailure {
+    dbPath: string;
+    stage: string;
+    status: number | null;
+    detail: string;
+    files: CodexSqliteFilesSnapshot;
+    previousFailure?: CodexSqliteQueryFailure;
+}
+export declare class CodexSqliteSessionError extends Error {
+    readonly status: number | null;
+    readonly stage: string;
+    constructor({ message, status, stage }: {
+        message: string;
+        status: number | null;
+        stage: string;
+    });
+}
+export declare function runCodexSqliteThreadQuery(request: CodexSqliteThreadQueryRequest): Promise<CodexSqliteThreadQueryResult>;
+export declare function validateCodexThreadQueryResult(result: CodexSqliteThreadQueryResult): CodexThreadRow[];
+export declare function validateCodexThreadColumns(columns: readonly string[]): void;
+export declare function sqliteReadWriteUri(dbPath: string): string;
+export declare function inspectCodexSqliteFiles(dbPath: string): CodexSqliteFilesSnapshot;
+export declare function inspectCodexSqliteFile(filePath: string): CodexSqliteFileIdentity;
+export declare function assertStableCodexSqliteMain({ baseline, current, stage, selectedPath }: {
+    baseline: CodexSqliteFilesSnapshot;
+    current: CodexSqliteFilesSnapshot;
+    stage: string;
+    selectedPath?: string;
+}): void;
+export declare function codexSqliteQueryFailure(error: unknown, context: {
+    dbPath: string;
+    stage: string;
+    files: CodexSqliteFilesSnapshot;
+    previousFailure?: CodexSqliteQueryFailure;
+}): CodexSqliteQueryFailure;
+export declare function isSqliteCantOpen(failure: CodexSqliteQueryFailure): boolean;
+export declare function codexSqliteQueryDiagnosticError(failure: CodexSqliteQueryFailure): Error;
+export declare function formatCodexSqliteFiles(snapshot: CodexSqliteFilesSnapshot): string;
+export declare function latestStateDbPath(codexHome: string): string | undefined;
+export declare function buildThreadSelect(columns: string[], limit: number, filters?: CodexThreadQueryFilters): string;
+export declare function sqliteThreadFilterParameterCommands(filters: CodexThreadQueryFilters | undefined): string[];
+export declare function buildThreadByIdSelect(columns: string[], nativeThreadId: string): string;