@scotthuang/agent-knock-knock 0.13.11 → 0.13.13

package/dist/src/codex-paginated-observation.js

@@ -0,0 +1,139 @@
+import { connectCodexAppServerReadClient, isCodexUnmaterializedThreadError } from "./codex-app-server-read-client.js";
+import { createCodexPaginatedTaskAnchor, codexPaginatedTurnRequestHash, codexPaginatedAsyncQuestionEvidence } from "./codex-paginated-task.js";
+export async function readCodexPaginatedAsyncQuestions(runtime) {
+    const binding = runtime.codexPaginatedThread;
+    if (!binding || !runtime.nativeTaskId || binding.threadId !== runtime.nativeSessionId)
+        return undefined;
+    const snapshot = await readCodexPaginatedTaskSnapshot({
+        codexHome: binding.codexHome, threadId: binding.threadId,
+        serverVersion: binding.serverVersion, boundaryTurnId: runtime.nativeTaskId
+    });
+    if (!snapshot.completeToBoundary)
+        return undefined;
+    const index = snapshot.turns.findIndex((turn) => turn.id === runtime.nativeTaskId);
+    return index < 0 ? undefined : codexPaginatedAsyncQuestionEvidence(snapshot.turns[index], snapshot.turns.slice(0, index));
+}
+export class CodexLegacyThreadHistoryError extends Error {
+    threadId;
+    constructor(threadId) {
+        super("The exact Codex foreground thread uses legacy history");
+        this.threadId = threadId;
+        this.name = "CodexLegacyThreadHistoryError";
+    }
+}
+/** Bounded reads never resume, subscribe to, create, or mutate native threads. */
+export async function readCodexPaginatedTaskSnapshot(input) {
+    const client = await (input.connect ?? connectCodexAppServerReadClient)({
+        codexHome: input.codexHome, expectedServerVersion: input.serverVersion
+    });
+    try {
+        const thread = await client.readThread(input.threadId);
+        if (thread.historyMode === "legacy")
+            throw new CodexLegacyThreadHistoryError(thread.id);
+        const listed = await readTurnsThroughBoundary(client, input.threadId, input.boundaryTurnId).catch((error) => {
+            if (!input.boundaryTurnId && thread.status.type === "idle" && isCodexUnmaterializedThreadError(error, input.threadId)) {
+                return { turns: [], complete: true };
+            }
+            throw error;
+        });
+        const turns = [];
+        for (const turn of listed.turns) {
+            turns.push({ ...turn, itemsView: "full", items: await readTurnItems(client, input.threadId, turn.id) });
+        }
+        return {
+            codexHome: client.metadata.codexHome,
+            serverVersion: client.metadata.serverVersion,
+            thread, turns, completeToBoundary: listed.complete
+        };
+    }
+    finally {
+        client.close();
+    }
+}
+async function readTurnsThroughBoundary(client, threadId, boundary) {
+    const turns = [];
+    const cursors = new Set();
+    const ids = new Set();
+    let cursor;
+    for (let pageNumber = 0; pageNumber < 64; pageNumber += 1) {
+        const page = await client.listTurns({ threadId, cursor, limit: 20, sortDirection: "desc", itemsView: "notLoaded" });
+        for (const turn of page.data) {
+            if (ids.has(turn.id))
+                throw new Error("Codex turn pagination repeated an item");
+            ids.add(turn.id);
+            turns.push(turn);
+            if (turn.id === boundary)
+                return { turns, complete: true };
+            if (turns.length > 128)
+                throw new Error("Codex task history exceeded the bounded observation window");
+        }
+        if (page.nextCursor === null)
+            return { turns, complete: boundary === undefined };
+        if (cursors.has(page.nextCursor))
+            throw new Error("Codex turn pagination repeated a cursor");
+        cursors.add(page.nextCursor);
+        cursor = page.nextCursor;
+    }
+    throw new Error("Codex turn pagination exceeded its page limit");
+}
+async function readTurnItems(client, threadId, turnId) {
+    const items = [];
+    const ids = new Set();
+    const cursors = new Set();
+    let cursor;
+    for (let pageNumber = 0; pageNumber < 64; pageNumber += 1) {
+        const page = await client.listItems({ threadId, turnId, cursor, limit: 100, sortDirection: "asc" });
+        for (const entry of page.data) {
+            if (ids.has(entry.item.id) || entry.turnId !== turnId)
+                throw new Error("Codex item identity changed during pagination");
+            ids.add(entry.item.id);
+            items.push(entry.item);
+            if (items.length > 1024)
+                throw new Error("Codex task items exceeded the bounded observation window");
+        }
+        if (page.nextCursor === null)
+            return items;
+        if (cursors.has(page.nextCursor))
+            throw new Error("Codex item pagination repeated a cursor");
+        cursors.add(page.nextCursor);
+        cursor = page.nextCursor;
+    }
+    throw new Error("Codex item pagination exceeded its page limit");
+}
+export async function captureCodexPaginatedTaskAnchor(input) {
+    const { binding } = input;
+    const client = await (input.connect ?? connectCodexAppServerReadClient)({
+        codexHome: binding.codexHome, expectedServerVersion: binding.serverVersion
+    });
+    try {
+        const thread = await client.readThread(binding.threadId);
+        if (thread.historyMode === "legacy")
+            throw new CodexLegacyThreadHistoryError(thread.id);
+        const page = await client.listTurns({ threadId: binding.threadId, limit: 2, sortDirection: "desc", itemsView: "notLoaded" }).catch((error) => {
+            if (thread.status.type === "idle" && isCodexUnmaterializedThreadError(error, binding.threadId))
+                return { data: [] };
+            throw error;
+        });
+        const latest = page.data[0];
+        if (!input.requestHash && latest?.status !== "inProgress")
+            return undefined;
+        const activeHash = !input.requestHash && latest
+            ? codexPaginatedTurnRequestHash({ ...latest,
+                items: await readTurnItems(client, binding.threadId, latest.id), itemsView: "full" }) : undefined;
+        if (!input.requestHash && !activeHash)
+            throw new Error("Active Codex turn has no unique text request");
+        return createCodexPaginatedTaskAnchor({
+            origin: input.requestHash ? "user_explicit_send" : "active_task",
+            captured_at: input.now.toISOString(), codex_home: binding.codexHome,
+            codex_version: binding.serverVersion, native_thread_id: binding.threadId,
+            process_uuid: binding.processUuid, process_birth: binding.processBirth,
+            pid: binding.pid, request_hash: input.requestHash ?? activeHash,
+            ...(input.requestHash && latest ? { baseline_latest_turn_id: latest.id } : {}),
+            ...(!input.requestHash && latest ? { turn_id: latest.id } : {})
+        });
+    }
+    finally {
+        client.close();
+    }
+}
+//# sourceMappingURL=codex-paginated-observation.js.map

package/dist/src/codex-paginated-observation.js.map

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

package/dist/src/codex-paginated-questionnaire-runtime.d.ts

@@ -0,0 +1,33 @@
+import { type CodexAppServerInteractionClient, type CodexAppServerInteractionOptions } from "./codex-app-server-interaction-client.js";
+import { type CodexBlockingQuestionDraft } from "./codex-app-server-questionnaire.js";
+import { type CodexPaginatedTaskCheckpoint } from "./codex-paginated-task.js";
+import type { TerminalWatch } from "./terminal-watch-record.js";
+import { type TerminalWatchObservation } from "./terminal-watch-service.js";
+import { type TerminalInteractionAuthorizationContext, type TerminalInteractionAuthorizationDecision, type TerminalInteractionBeforeDispatchContext, type TerminalInteractionResponseExecution } from "./terminal-interaction-response-bridge.js";
+import type { TerminalControlRef } from "./terminal-control-ref.js";
+import type { TerminalInteractionSubjectResponse } from "./terminal-interaction-protocol.js";
+export type CodexPaginatedQuestionnaireClient = Pick<CodexAppServerInteractionClient, "listPendingQuestions" | "answer" | "close">;
+export type CodexPaginatedQuestionnaireConnect = (options: CodexAppServerInteractionOptions) => Promise<CodexPaginatedQuestionnaireClient>;
+export declare function observeCodexPaginatedBlockingQuestion(input: {
+    watch: TerminalWatch;
+    checkpoint: CodexPaginatedTaskCheckpoint;
+    now: Date;
+    responseDecision: (surfaceId: string, fingerprint: string) => {
+        executable: boolean;
+        suppress: boolean;
+    };
+    connect?: CodexPaginatedQuestionnaireConnect;
+}): Promise<TerminalWatchObservation | undefined>;
+/** Dispatches one exact native response, or privately advances a multi-question batch. */
+export declare function respondCodexPaginatedBlockingQuestion(input: {
+    watch: TerminalWatch;
+    checkpoint: CodexPaginatedTaskCheckpoint;
+    terminalControl: TerminalControlRef;
+    response: TerminalInteractionSubjectResponse;
+    expectedFingerprint: string;
+    now: () => Date;
+    authorize: (context: TerminalInteractionAuthorizationContext) => TerminalInteractionAuthorizationDecision | Promise<TerminalInteractionAuthorizationDecision>;
+    beforeDispatch: (context: TerminalInteractionBeforeDispatchContext) => void | Promise<void>;
+    persistDraft: (draft: CodexBlockingQuestionDraft | undefined) => void;
+    connect?: CodexPaginatedQuestionnaireConnect;
+}): Promise<TerminalInteractionResponseExecution>;

package/dist/src/codex-paginated-questionnaire-runtime.js

@@ -0,0 +1,157 @@
+import { createHash } from "node:crypto";
+import { connectCodexAppServerInteractionClient } from "./codex-app-server-interaction-client.js";
+import { buildCodexAppServerQuestionnaireOffer, accumulateCodexAppServerQuestionnaireAnswer } from "./codex-app-server-questionnaire.js";
+import { validateCodexPaginatedTaskCheckpoint } from "./codex-paginated-task.js";
+import { terminalWatchObservationFence } from "./terminal-watch-service.js";
+import { createTerminalInteractionAggregate } from "./terminal-interaction-core.js";
+import { TerminalInteractionDispatchReservedError, TerminalInteractionInputNotStartedError } from "./terminal-interaction-response-bridge.js";
+async function openQuestion(watch, checkpoint, now, connect) {
+    const anchor = watch.anchor;
+    const turnId = checkpoint.acceptance_evidence?.acceptanceId;
+    if (anchor.schema !== "agent-knock-knock/codex-paginated-task-anchor" || !turnId)
+        return undefined;
+    validateCodexPaginatedTaskCheckpoint(checkpoint, anchor);
+    const client = await connect({ nativeTurnId: turnId, binding: {
+            codexHome: anchor.codex_home, serverVersion: anchor.codex_version,
+            threadId: anchor.native_thread_id, pid: anchor.pid, processUuid: anchor.process_uuid,
+            processBirth: anchor.process_birth, observedAt: anchor.captured_at
+        } });
+    try {
+        const requests = [...client.listPendingQuestions()].filter((pending) => pending.isBlocking)
+            .sort((a, b) => a.itemId.localeCompare(b.itemId));
+        const draft = checkpoint.blocking_question_draft;
+        const pending = requests.find((request) => request.itemId === draft?.itemId && request.requestId === draft.requestId) ?? requests[0];
+        if (!pending) {
+            await closeClient(client);
+            return undefined;
+        }
+        if (pending.threadId !== anchor.native_thread_id || pending.turnId !== turnId) {
+            throw new Error("Codex pending question belongs to another native task");
+        }
+        const matchingDraft = pending.itemId === draft?.itemId && pending.requestId === draft.requestId ? draft : undefined;
+        const built = buildCodexAppServerQuestionnaireOffer({ pending,
+            subject: { kind: "terminal_watch", watch_id: watch.watch_id, anchor_fingerprint: anchor.anchor_fingerprint },
+            canonicalEndpointIdentity: watch.terminal.terminal_endpoint, draft: matchingDraft, now
+        });
+        if (built.status === "invalidated")
+            throw new Error(built.reason);
+        return { client, pending, built, draft: matchingDraft };
+    }
+    catch (error) {
+        await closeClient(client);
+        throw error;
+    }
+}
+export async function observeCodexPaginatedBlockingQuestion(input) {
+    let opened;
+    try {
+        opened = await openQuestion(input.watch, input.checkpoint, input.now, input.connect ?? connectCodexAppServerInteractionClient);
+    }
+    catch {
+        return undefined;
+    }
+    if (!opened)
+        return undefined;
+    try {
+        const offer = opened.built.offer;
+        const decision = input.responseDecision(offer.surfaceId, offer.promptFingerprint);
+        const projection = decision.executable ? offer.projection : {
+            ...offer.projection, response_authority: "notify_only",
+            capabilities: { ...offer.projection.capabilities, respond: false }
+        };
+        const checkpoint = { ...input.checkpoint };
+        if (!opened.draft)
+            delete checkpoint.blocking_question_draft;
+        const question = projection.questions[0];
+        return {
+            ...terminalWatchObservationFence(input.watch), kind: "interaction", observed_at: input.now.toISOString(),
+            observation_checkpoint: checkpoint,
+            evidence_fingerprint: createHash("sha256").update(JSON.stringify({
+                schema: "agent-knock-knock/terminal-watch-interaction-event",
+                version: 1,
+                watch_id: input.watch.watch_id,
+                interaction_id: projection.interaction_id,
+                surface_id: offer.surfaceId
+            })).digest("hex"),
+            reason_code: projection.capabilities.respond ? "codex_native_question_response_requested" : "codex_native_question_requires_manual_response",
+            current_interaction: { projection, aggregate: createTerminalInteractionAggregate(projection, input.now.toISOString()) },
+            ...(decision.suppress ? { suppress_notification: true } : {}),
+            ...(!projection.capabilities.respond ? { manual_interaction: {
+                    kind: "questionnaire", response_kind: question.response_kind,
+                    required: question.required, parser_status: "manual_required",
+                    prompt: question.prompt, current_step: projection.step.index, total_steps: projection.step.total,
+                    ...(question.response_kind === "single_select" ? { options: question.options.map(({ label, description }) => ({ label, description })) } : {})
+                } } : {})
+        };
+    }
+    finally {
+        await closeClient(opened.client);
+    }
+}
+/** Dispatches one exact native response, or privately advances a multi-question batch. */
+export async function respondCodexPaginatedBlockingQuestion(input) {
+    let opened;
+    try {
+        opened = await openQuestion(input.watch, input.checkpoint, input.now(), input.connect ?? connectCodexAppServerInteractionClient);
+    }
+    catch {
+        throw new TerminalInteractionInputNotStartedError("The exact native Codex question is unavailable before response");
+    }
+    if (!opened || opened.built.status !== "ready") {
+        if (opened)
+            await closeClient(opened.client);
+        throw new TerminalInteractionInputNotStartedError("The exact native Codex question is no longer executable");
+    }
+    try {
+        const offer = opened.built.offer;
+        if (offer.promptFingerprint !== input.expectedFingerprint || offer.projection.interaction_id !== input.response.interaction_id) {
+            throw new TerminalInteractionInputNotStartedError("The native Codex question changed before response");
+        }
+        const result = accumulateCodexAppServerQuestionnaireAnswer({
+            pending: opened.pending, offer, canonicalEndpointIdentity: input.watch.terminal.terminal_endpoint,
+            response: input.response, draft: opened.draft, now: input.now()
+        });
+        if (result.status === "invalidated")
+            throw new TerminalInteractionInputNotStartedError(result.reason);
+        const context = { agent: "codex", terminalControl: input.terminalControl,
+            fingerprint: offer.promptFingerprint, projection: offer.projection, response: input.response };
+        const authority = await input.authorize(context);
+        if (!authority.approved)
+            throw new TerminalInteractionInputNotStartedError(authority.reason ?? "Codex question response authority changed");
+        await input.beforeDispatch(context);
+        try {
+            if (result.status === "advance")
+                input.persistDraft(result.draft);
+            else {
+                const receipt = await opened.client.answer(result.requestId, result.answers);
+                requireConfirmedAnswer(receipt, result.requestId, opened.pending.itemId);
+                input.persistDraft(undefined);
+            }
+        }
+        catch (error) {
+            if (error instanceof TerminalInteractionDispatchReservedError)
+                throw error;
+            throw new TerminalInteractionDispatchReservedError("key_uncertain", "Native Codex response or private checkpoint update is uncertain");
+        }
+        return { responded: true, blocked: false, interactionId: offer.projection.interaction_id,
+            questionId: offer.projection.questions[0].question_id,
+            responseKind: input.response.answers[0].response_kind,
+            outcome: result.status === "advance" ? "submitted_or_advanced" : "confirmed" };
+    }
+    finally {
+        await closeClient(opened.client);
+    }
+}
+function requireConfirmedAnswer(receipt, requestId, itemId) {
+    if (receipt.status !== "confirmed" || receipt.requestId !== requestId ||
+        receipt.itemId !== itemId) {
+        throw new TerminalInteractionDispatchReservedError("key_uncertain", "The exact native Codex answer is not durably confirmed");
+    }
+}
+async function closeClient(client) {
+    try {
+        await client.close();
+    }
+    catch { /* Cleanup cannot change an already confirmed response. */ }
+}
+//# sourceMappingURL=codex-paginated-questionnaire-runtime.js.map

package/dist/src/codex-paginated-questionnaire-runtime.js.map

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

package/dist/src/codex-paginated-task.d.ts

@@ -0,0 +1,78 @@
+import { type CodexPaginatedVersion } from "./codex-lifecycle-compatibility.js";
+import type { CodexAppServerThread, CodexAppServerTurn } from "./codex-app-server-read-client.js";
+import type { CodexAsyncQuestionDurableEvidence } from "./codex-async-question-adapter.js";
+import type { TerminalCompletionEvidence } from "./terminal-agent-adapter.js";
+import { type CodexBlockingQuestionDraft } from "./codex-app-server-questionnaire.js";
+import { type TerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+export interface CodexPaginatedTaskAnchor {
+    schema: "agent-knock-knock/codex-paginated-task-anchor";
+    version: 1;
+    origin: "user_explicit_send" | "active_task";
+    captured_at: string;
+    codex_home: string;
+    codex_version: CodexPaginatedVersion;
+    native_thread_id: string;
+    process_uuid: string;
+    process_birth: string;
+    pid: number;
+    request_hash: string;
+    baseline_latest_turn_id?: string;
+    turn_id?: string;
+    anchor_fingerprint: string;
+}
+export interface CodexPaginatedTaskCheckpoint {
+    schema: "agent-knock-knock/codex-paginated-task-checkpoint";
+    version: 1;
+    safe_resume_offset_bytes: 0;
+    acceptance_evidence?: TerminalSubmissionAcceptanceEvidence;
+    /** Owner-private partial answers; never copy this field into callbacks. */
+    blocking_question_draft?: CodexBlockingQuestionDraft;
+}
+/** The reader proves contiguous descending turns through the required boundary. */
+export interface CodexPaginatedTaskSnapshot {
+    codexHome: string;
+    serverVersion: string;
+    thread: CodexAppServerThread;
+    turns: readonly CodexAppServerTurn[];
+    completeToBoundary: boolean;
+}
+interface AcceptedPaginatedTaskObservation {
+    evidence: TerminalSubmissionAcceptanceEvidence;
+    checkpoint: CodexPaginatedTaskCheckpoint;
+    questions: readonly CodexAsyncQuestionDurableEvidence[];
+}
+export type CodexPaginatedTaskObservation = {
+    status: "pending";
+    checkpoint: CodexPaginatedTaskCheckpoint;
+    questions: readonly CodexAsyncQuestionDurableEvidence[];
+} | ({
+    status: "accepted";
+} & AcceptedPaginatedTaskObservation) | ({
+    status: "completed";
+    completion: TerminalCompletionEvidence;
+} & AcceptedPaginatedTaskObservation) | {
+    status: "uncertain";
+    reason: string;
+} | {
+    status: "unavailable";
+    reason: string;
+    retryable: true;
+} | {
+    status: "invalidated";
+    reason: string;
+};
+export declare function createCodexPaginatedTaskAnchor(input: Omit<CodexPaginatedTaskAnchor, "schema" | "version" | "anchor_fingerprint">): CodexPaginatedTaskAnchor;
+export declare function validateCodexPaginatedTaskAnchor(value: unknown): CodexPaginatedTaskAnchor;
+export declare function createCodexPaginatedTaskCheckpoint(acceptanceEvidence?: TerminalSubmissionAcceptanceEvidence, blockingQuestionDraft?: CodexBlockingQuestionDraft): CodexPaginatedTaskCheckpoint;
+export declare function validateCodexPaginatedTaskCheckpoint(value: unknown, anchor?: CodexPaginatedTaskAnchor): CodexPaginatedTaskCheckpoint;
+/** Inspect already-read data only; this module never opens a socket or a file. */
+export declare function observeCodexPaginatedTask(input: {
+    anchor: CodexPaginatedTaskAnchor;
+    snapshot: CodexPaginatedTaskSnapshot;
+    checkpoint?: CodexPaginatedTaskCheckpoint;
+}): CodexPaginatedTaskObservation;
+/** Hash the native stored input; the pre-Send caller profiles input normalization. */
+export declare function codexPaginatedTurnRequestHash(turn: CodexAppServerTurn): string | undefined;
+/** Native completion clears its question queue, regardless of retained history. */
+export declare function codexPaginatedAsyncQuestionEvidence(turn: CodexAppServerTurn, newerTurns?: readonly CodexAppServerTurn[]): readonly CodexAsyncQuestionDurableEvidence[];
+export {};