@scotthuang/agent-knock-knock 0.13.11 → 0.13.13

package/dist/src/codex-app-server-read-client.js

@@ -0,0 +1,300 @@
+import fs from "node:fs";
+import path from "node:path";
+import { connectCodexUnixWebSocket } from "./codex-app-server-transport.js";
+const MAX_MESSAGE_BYTES = 8 * 1024 * 1024;
+const MAX_PENDING_REQUESTS = 16;
+const DEFAULT_TIMEOUT_MS = 5_000;
+const TURN_STATUSES = new Set(["completed", "interrupted", "failed", "inProgress"]);
+export class CodexAppServerReadError extends Error {
+    code;
+    rpcCode;
+    rpcMessage;
+    constructor(code, message, rpcCode, rpcMessage) {
+        super(message);
+        this.code = code;
+        this.rpcCode = rpcCode;
+        this.rpcMessage = rpcMessage;
+        this.name = "CodexAppServerReadError";
+    }
+}
+export class CodexAppServerReadClient {
+    transport;
+    timeoutMs;
+    metadata;
+    pending = new Map();
+    unsubscribe;
+    nextRequestId = 1;
+    closed = false;
+    constructor(transport, timeoutMs, metadata) {
+        this.transport = transport;
+        this.timeoutMs = timeoutMs;
+        this.metadata = metadata;
+        this.unsubscribe = [
+            transport.onMessage((message) => this.receive(message)),
+            transport.onDisconnect((error) => this.finish(error))
+        ];
+    }
+    static async connect(options) {
+        if (!path.isAbsolute(options.codexHome))
+            throw new Error("Codex home must be absolute");
+        const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 30_000) {
+            throw new Error("Codex app-server timeout must be between 1 and 30000 milliseconds");
+        }
+        const socketPath = path.join(options.codexHome, "app-server-control", "app-server-control.sock");
+        const transport = await (options.transportFactory ?? connectCodexUnixWebSocket)({ socketPath, timeoutMs });
+        const metadata = { socketPath, serverVersion: "", codexHome: "", platformFamily: "", platformOs: "" };
+        const client = new CodexAppServerReadClient(transport, timeoutMs, metadata);
+        try {
+            const result = await client.request("initialize", {
+                clientInfo: { name: "agent-knock-knock-read", title: "AKK read-only history", version: "1" },
+                capabilities: { experimentalApi: true }
+            });
+            Object.assign(metadata, parseCodexAppServerMetadata(result, options, socketPath));
+            transport.send(JSON.stringify({ method: "initialized" }));
+            return client;
+        }
+        catch (error) {
+            client.close();
+            throw error;
+        }
+    }
+    async readThread(threadId) {
+        const result = record(await this.request("thread/read", { threadId: identifier(threadId), includeTurns: false }));
+        const thread = record(result.thread);
+        if (thread.id !== threadId)
+            invalid("Codex app-server returned a different thread");
+        identifier(thread.sessionId);
+        if (typeof thread.cwd !== "string" || !path.isAbsolute(thread.cwd))
+            invalid("Invalid thread cwd");
+        if (thread.historyMode !== "legacy" && thread.historyMode !== "paginated")
+            invalid("Unknown thread history mode");
+        if (typeof thread.cliVersion !== "string")
+            invalid("Invalid thread CLI version");
+        validateThreadStatus(thread.status);
+        if (!Array.isArray(thread.turns))
+            invalid("Invalid thread turns");
+        thread.turns.forEach(validateTurn);
+        return thread;
+    }
+    async listTurns(options) {
+        if (options.itemsView && !["notLoaded", "summary", "full"].includes(options.itemsView)) {
+            throw new Error("Invalid Codex turn items view");
+        }
+        const result = await this.request("thread/turns/list", {
+            ...listParams(options), itemsView: options.itemsView ?? "notLoaded"
+        });
+        return parsePage(result, validateTurn);
+    }
+    async listItems(options) {
+        const params = listParams(options);
+        if (options.turnId !== undefined)
+            params.turnId = identifier(options.turnId);
+        const page = parsePage(await this.request("thread/items/list", params), validateItemEntry);
+        if (options.turnId && page.data.some((entry) => entry.turnId !== options.turnId)) {
+            invalid("Codex app-server returned items from a different turn");
+        }
+        return page;
+    }
+    close() {
+        if (!this.closed) {
+            this.finish(new CodexAppServerReadError("closed", "Codex app-server read connection closed"));
+        }
+        this.transport.close();
+    }
+    request(method, params) {
+        if (this.closed)
+            return Promise.reject(new CodexAppServerReadError("closed", "Codex app-server read connection closed"));
+        if (this.pending.size >= MAX_PENDING_REQUESTS)
+            return Promise.reject(new Error("Too many Codex app-server reads"));
+        const id = `akk-read-${this.nextRequestId++}`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new CodexAppServerReadError("timeout", `Codex app-server ${method} timed out`));
+            }, this.timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            try {
+                this.transport.send(JSON.stringify({ id, method, params }));
+            }
+            catch (error) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(error);
+            }
+        });
+    }
+    receive(message) {
+        try {
+            if (Buffer.byteLength(message) > MAX_MESSAGE_BYTES)
+                invalid("Codex app-server message exceeded its bound");
+            const response = record(JSON.parse(message));
+            // Never respond to server requests: doing so could answer another client's question.
+            if (response.method !== undefined || typeof response.id !== "string")
+                return;
+            const pending = this.pending.get(response.id);
+            if (!pending)
+                return;
+            clearTimeout(pending.timer);
+            this.pending.delete(response.id);
+            if (response.error !== undefined) {
+                const error = record(response.error);
+                pending.reject(new CodexAppServerReadError("rpc_error", "Codex app-server read was rejected", Number.isInteger(error.code) ? error.code : undefined, typeof error.message === "string" ? error.message.slice(0, 1024) : undefined));
+            }
+            else if (Object.hasOwn(response, "result")) {
+                pending.resolve(response.result);
+            }
+            else {
+                pending.reject(new CodexAppServerReadError("invalid_response", "Codex app-server response omitted result"));
+            }
+        }
+        catch (error) {
+            this.finish(error instanceof Error ? error : new Error("Invalid Codex app-server response"));
+            this.transport.close();
+        }
+    }
+    finish(error) {
+        this.closed = true;
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+        this.unsubscribe.forEach((unsubscribe) => unsubscribe());
+    }
+}
+export const connectCodexAppServerReadClient = CodexAppServerReadClient.connect;
+// Official app-server emits this only for an existing, loaded thread before its first input.
+// Callers must separately verify the selected thread's paginated/idle metadata before
+// interpreting this as an empty submission baseline.
+export function isCodexUnmaterializedThreadError(error, threadId) {
+    return error instanceof CodexAppServerReadError
+        && error.code === "rpc_error"
+        && error.rpcCode === -32600
+        && error.rpcMessage === `thread ${threadId} is not materialized yet; thread/turns/list is unavailable before first user message`;
+}
+export function parseCodexAppServerMetadata(value, options, socketPath) {
+    const result = record(value);
+    const version = typeof result.userAgent === "string" ? /^[^/]+\/([^\s]+)(?:\s|$)/u.exec(result.userAgent)?.[1] : undefined;
+    if (version !== options.expectedServerVersion) {
+        throw new CodexAppServerReadError("incompatible_server", "Codex app-server backend version does not match the required version");
+    }
+    if (typeof result.codexHome !== "string" || !path.isAbsolute(result.codexHome) || !sameHome(result.codexHome, options.codexHome)) {
+        throw new CodexAppServerReadError("incompatible_server", "Codex app-server backend home does not match the selected home");
+    }
+    if (typeof result.platformFamily !== "string" || typeof result.platformOs !== "string")
+        invalid("Missing Codex app-server platform metadata");
+    return { serverVersion: version, codexHome: result.codexHome, socketPath, platformFamily: result.platformFamily, platformOs: result.platformOs };
+}
+function sameHome(left, right) {
+    if (path.resolve(left) === path.resolve(right))
+        return true;
+    try {
+        return fs.realpathSync(left) === fs.realpathSync(right);
+    }
+    catch {
+        return false;
+    }
+}
+function listParams(options) {
+    const params = { threadId: identifier(options.threadId), limit: options.limit ?? 100 };
+    if (!Number.isSafeInteger(params.limit) || params.limit < 1 || params.limit > 100)
+        throw new Error("Codex history page limit must be between 1 and 100");
+    if (options.cursor !== undefined)
+        params.cursor = identifier(options.cursor, 4096);
+    if (options.sortDirection !== undefined) {
+        if (options.sortDirection !== "asc" && options.sortDirection !== "desc")
+            throw new Error("Invalid Codex history sort direction");
+        params.sortDirection = options.sortDirection;
+    }
+    return params;
+}
+function parsePage(value, validate) {
+    const page = record(value);
+    if (!Array.isArray(page.data) || page.data.length > 100)
+        invalid("Invalid bounded Codex history page");
+    const cursor = (value) => value == null ? null : identifier(value, 4096);
+    return { data: page.data.map(validate), nextCursor: cursor(page.nextCursor), backwardsCursor: cursor(page.backwardsCursor) };
+}
+function validateThreadStatus(value) {
+    const status = record(value);
+    if (["notLoaded", "idle", "systemError"].includes(status.type))
+        return;
+    if (status.type !== "active" || !Array.isArray(status.activeFlags) || status.activeFlags.some((flag) => flag !== "waitingOnApproval" && flag !== "waitingOnUserInput"))
+        invalid("Unknown Codex thread status");
+}
+function validateTurn(value) {
+    const turn = record(value);
+    identifier(turn.id);
+    if (!TURN_STATUSES.has(turn.status))
+        invalid("Unknown Codex turn status");
+    if (!Array.isArray(turn.items))
+        invalid("Invalid Codex turn items");
+    turn.items.forEach(validateItem);
+    if (!["notLoaded", "summary", "full"].includes(turn.itemsView))
+        invalid("Unknown Codex turn items view");
+    for (const field of ["startedAt", "completedAt", "durationMs"])
+        nullableNumber(turn[field]);
+    if (turn.error !== null && (typeof record(turn.error).message !== "string"))
+        invalid("Invalid Codex turn error");
+    return turn;
+}
+function validateItemEntry(value) {
+    const entry = record(value);
+    identifier(entry.turnId);
+    validateItem(entry.item);
+    nullableNumber(entry.startedAtMs);
+    nullableNumber(entry.completedAtMs);
+    return entry;
+}
+function validateItem(value) {
+    const item = record(value);
+    identifier(item.id);
+    identifier(item.type);
+    if (item.type === "userMessage") {
+        if (!Array.isArray(item.content))
+            invalid("Invalid Codex user message content");
+        for (const input of item.content) {
+            const content = record(input);
+            identifier(content.type);
+            if (content.type === "text" && typeof content.text !== "string")
+                invalid("Invalid Codex user message text");
+        }
+    }
+    if (item.type === "agentMessage") {
+        if (typeof item.text !== "string")
+            invalid("Invalid Codex agent message text");
+        if (item.delivery != null && item.delivery !== "async")
+            invalid("Unknown Codex agent message delivery");
+        if (item.questions != null) {
+            if (!Array.isArray(item.questions))
+                invalid("Invalid Codex async questions");
+            for (const value of item.questions) {
+                const question = record(value);
+                if (typeof question.title !== "string" || (question.options !== null && (!Array.isArray(question.options) || question.options.some((option) => typeof option !== "string"))))
+                    invalid("Invalid Codex async question");
+            }
+        }
+    }
+    if (item.type === "plan" && typeof item.text !== "string")
+        invalid("Invalid Codex proposed plan text");
+    return item;
+}
+function nullableNumber(value) {
+    if (value !== null && (typeof value !== "number" || !Number.isSafeInteger(value)))
+        invalid("Invalid Codex history timestamp");
+}
+function record(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        invalid("Invalid Codex app-server object");
+    return value;
+}
+function identifier(value, limit = 512) {
+    if (typeof value !== "string" || value.length === 0 || value.length > limit || /[\u0000-\u001f\u007f]/u.test(value))
+        invalid("Invalid Codex app-server identifier");
+    return value;
+}
+function invalid(message) {
+    throw new CodexAppServerReadError("invalid_response", message);
+}
+//# sourceMappingURL=codex-app-server-read-client.js.map

package/dist/src/codex-app-server-read-client.js.map

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

package/dist/src/codex-app-server-transport.d.ts

@@ -0,0 +1,11 @@
+/** Internal transport; public read and interaction clients each restrict its methods. */
+export interface CodexAppServerReadTransport {
+    send(message: string): void;
+    onMessage(listener: (message: string) => void): () => void;
+    onDisconnect(listener: (error: Error) => void): () => void;
+    close(): void;
+}
+export declare function connectCodexUnixWebSocket(options: {
+    socketPath: string;
+    timeoutMs: number;
+}): Promise<CodexAppServerReadTransport>;

package/dist/src/codex-app-server-transport.js

@@ -0,0 +1,47 @@
+import fs from "node:fs";
+import net from "node:net";
+const MAX_MESSAGE_BYTES = 8 * 1024 * 1024;
+export async function connectCodexUnixWebSocket(options) {
+    const stat = fs.statSync(options.socketPath);
+    if (!stat.isSocket() || (stat.mode & 0o077) !== 0 || (process.getuid && stat.uid !== process.getuid())) {
+        throw new Error("Codex app-server control socket is not private to the current user");
+    }
+    const WebSocketClient = (await import("ws")).default;
+    return new Promise((resolve, reject) => {
+        const socket = new WebSocketClient("ws://localhost/", {
+            createConnection: () => net.createConnection({ path: options.socketPath }),
+            handshakeTimeout: options.timeoutMs,
+            maxPayload: MAX_MESSAGE_BYTES,
+            perMessageDeflate: false,
+            followRedirects: false
+        });
+        const failed = (error) => { socket.terminate(); reject(error); };
+        socket.once("error", failed);
+        socket.once("open", () => {
+            socket.removeListener("error", failed);
+            socket.on("error", () => { });
+            resolve({
+                send: (message) => socket.send(message),
+                close: () => socket.terminate(),
+                onMessage: (listener) => {
+                    const receive = (data, binary) => {
+                        if (binary) {
+                            socket.terminate();
+                            return;
+                        }
+                        listener(data.toString());
+                    };
+                    socket.on("message", receive);
+                    return () => socket.removeListener("message", receive);
+                },
+                onDisconnect: (listener) => {
+                    const closed = () => listener(new Error("Codex app-server disconnected"));
+                    socket.on("error", listener);
+                    socket.on("close", closed);
+                    return () => { socket.removeListener("error", listener); socket.removeListener("close", closed); };
+                }
+            });
+        });
+    });
+}
+//# sourceMappingURL=codex-app-server-transport.js.map

package/dist/src/codex-app-server-transport.js.map

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

package/dist/src/codex-async-question-adapter.d.ts

@@ -52,6 +52,8 @@ export interface CodexAsyncQuestionMatch {
     readonly source_question_index: number;
     readonly question: CodexAsyncQuestionSemanticQuestion;
     readonly selected_option_id?: string;
+    /** Exact paginated-history AnsweredQuestion tuple, never a public identifier. */
+    readonly native_question_id?: string;
 }
 export interface CodexAsyncQuestionPromptEvidence {
     readonly profile: string;
@@ -83,6 +85,9 @@ export type CodexAsyncQuestionOwnerPrivateActionPlan = {
         readonly max_characters: number;
     };
     readonly delivery: Readonly<Record<CodexAsyncQuestionDeliveryMode, "submit" | "queue">>;
+    /** Only a fully visible, profiled empty editor may authorize this navigation. */
+    readonly prompt_stack_back?: "shift_right" | "alt_down";
+    readonly prompt_stack_forward?: "shift_left" | "alt_up";
     readonly expected_region_sha256: string;
 };
 export type CodexAsyncQuestionInspection = {

package/dist/src/codex-async-question-adapter.js

@@ -1,4 +1,6 @@
+import { isCodexPaginatedVersion } from "./codex-lifecycle-compatibility.js";
 import { createHash } from "node:crypto";
+import { captureCodexFullscreenComposerFrame } from "./codex-fullscreen-composer-proof.js";
 /**
  * This adapter is deliberately version-bound. Later Codex releases gained
  * different durable answer identities; callers must not silently reuse this
@@ -6,7 +8,9 @@ import { createHash } from "node:crypto";
  */
 export const CODEX_ASYNC_QUESTION_PROFILES = Object.freeze({
     "0.154.0": "codex/0.154.0/request-user-input-async-v1",
-    "0.155.1": "codex/0.155.1/request-user-input-async-v1"
+    "0.155.1": "codex/0.155.1/request-user-input-async-v1",
+    "0.158.0": "codex/0.158.0/request-user-input-async-v2",
+    "0.159.0": "codex/0.159.0/request-user-input-async-v2"
 });
 export const CODEX_ASYNC_QUESTION_LIMITS = Object.freeze({
     maxRecords: 4_096,
@@ -19,7 +23,7 @@ export const CODEX_ASYNC_QUESTION_LIMITS = Object.freeze({
     maxScreenCharacters: 128 * 1024,
     maxScreenLines: 160
 });
-const ANSI_SEQUENCE_PATTERN = /[\u001B\u009B](?:(?:\[[0-?]*[ -/]*[@-~])|(?:\][^\u0007]*(?:\u0007|\u001B\\))|.)/gu;
+const ANSI_SEQUENCE_PATTERN = /[\u001B\u009B](?:(?:\[[0-?]*[ -/]*[@-~])|(?:\][^\u0007\u001B]*(?:\u0007|\u001B\\))|.)/gu;
 const UNSAFE_CONTROL_PATTERN = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/u;
 const IDENTIFIER_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/u;
 export function codexAsyncQuestionProfile(version) {
@@ -85,7 +89,7 @@ export function inspectCodexAsyncQuestion(input) {
     if (!normalizedEvidence) {
         return { state: "ambiguous", reason: "invalid_durable_evidence", profile };
     }
-    const collapsed = parseCollapsed(captured.lines);
+    const collapsed = parseCollapsed(captured.lines, profile);
     const expandedMarker = hasExpandedMarker(captured.lines);
     if (collapsed.status === "exact" && !expandedMarker) {
         return inspectCollapsedQuestion(collapsed, normalizedEvidence, profile);
@@ -157,6 +161,10 @@ export function codexAsyncQuestionMainComposerVisible(input) {
         return false;
     }
     const footer = captured.lines.at(-1)?.trim() ?? "";
+    if (isCodexPaginatedVersion(input.version)) {
+        return captureCodexFullscreenComposerFrame(input.screen, input.version)
+            ?.hasShortcutFooter === true;
+    }
     return /^(?:gpt-[\w.-]+(?:\s+\S+)?|[-\w.]+ default)\s+·\s+\S.*$/u
         .test(footer) && captured.lines.slice(0, -1).some((line) => /^[›»](?:\s|$)/u.test(line));
 }
@@ -241,6 +249,12 @@ function inspectExpandedQuestion(expanded, profile) {
                 steer_current_turn: "submit",
                 queue_next_turn: "queue"
             },
+            ...(expanded.promptStackBack === undefined
+                ? {}
+                : { prompt_stack_back: expanded.promptStackBack }),
+            ...(expanded.promptStackForward === undefined
+                ? {}
+                : { prompt_stack_forward: expanded.promptStackForward }),
             expected_region_sha256: exactDigest
         }
     };
@@ -277,7 +291,12 @@ function normalizeEvidenceEntry(value, profile) {
         const normalized = normalizeQuestion(question, sourceId, index);
         if (!normalized)
             return undefined;
-        questions.push(normalized);
+        questions.push({
+            ...normalized,
+            ...(isFullscreenProfile(profile)
+                ? { nativeQuestionId: JSON.stringify(["request_user_input_async", itemId, index]) }
+                : {})
+        });
     }
     return {
         itemId,
@@ -372,7 +391,10 @@ function collapsedMatch(evidence, pendingCount, profile) {
     return {
         source_id: current.entry.sourceId,
         source_question_index: current.question.sourceIndex,
-        question: current.question.semantic
+        question: current.question.semantic,
+        ...(current.question.nativeQuestionId === undefined
+            ? {}
+            : { native_question_id: current.question.nativeQuestionId })
     };
 }
 function captureLines(screen) {
@@ -392,7 +414,7 @@ function captureLines(screen) {
         lines.pop();
     return { status: "ok", lines };
 }
-function parseCollapsed(lines) {
+function parseCollapsed(lines, profile) {
     let header = -1;
     for (let index = lines.length - 1; index >= 0; index -= 1) {
         if (lines[index] === "• Queued follow-up inputs") {
@@ -427,12 +449,7 @@ function parseCollapsed(lines) {
     let hint = summary + 1;
     while (hint < lines.length && lines[hint].trim().length === 0)
         hint += 1;
-    const hintLine = lines[hint] ?? "";
-    const binding = hintLine === "    shift + ← to answer"
-        ? "shift_left"
-        : hintLine === "    ⌥ + ↑ to answer"
-            ? "alt_up"
-            : undefined;
+    const binding = collapsedOpenBinding(lines[hint] ?? "", profile);
     if (!binding)
         return { status: "partial" };
     return {
@@ -445,6 +462,14 @@ function parseCollapsed(lines) {
         exactLines: lines.slice(header, hint + 1)
     };
 }
+function collapsedOpenBinding(line, profile) {
+    const compact = isFullscreenProfile(profile);
+    if (line === (compact ? "    shift+← to answer" : "    shift + ← to answer")) {
+        return "shift_left";
+    }
+    return line === (compact ? "    ⌥+↑ to answer" : "    ⌥ + ↑ to answer")
+        ? "alt_up" : undefined;
+}
 function hasExpandedMarker(lines) {
     return lines.some((line) => /^ {2}enter submit\b/u.test(line) ||
         /^ {2}\d+ of(?: \d+)?/u.test(line) ||
@@ -472,8 +497,9 @@ function parseExpanded(lines, evidence, profile) {
         lines.slice(Math.max(0, footerStart - 5), footerStart).some((line) => normalizeText(line) === "Expand terminal to read the entire option")) {
         return { status: "ambiguous", reason: "clipped_question" };
     }
-    if (!/^enter submit ctrl \+ \] skip ⌥ \+ ↓ (?:main prompt|prev question)(?: (?:⌥ \+ ↑|shift \+ ←) (?:next question|queued messages))?$/u
-        .test(footer)) {
+    const compactFooter = /^enter submit ctrl\+\] skip (shift\+→|⌥\+↓) (main prompt|prev question)(?: (⌥\+↑|shift\+←) (next question|queued messages))?$/u.exec(footer);
+    if (isFullscreenProfile(profile) ? !compactFooter :
+        !/^enter submit ctrl \+ \] skip ⌥ \+ ↓ (?:main prompt|prev question)(?: (?:⌥ \+ ↑|shift \+ ←) (?:next question|queued messages))?$/u.test(footer)) {
         return { status: "ambiguous", reason: "unsupported_keymap" };
     }
     if (evidence.length === 0) {
@@ -508,13 +534,24 @@ function parseExpanded(lines, evidence, profile) {
         return { status: "ambiguous", reason: "question_match_ambiguous" };
     }
     const exact = unique[0];
-    void profile;
+    if (compactFooter &&
+        (exact.currentStep === 1) !== (compactFooter[2] === "main prompt")) {
+        return { status: "ambiguous", reason: "partial_or_unknown_surface" };
+    }
     return {
         status: "exact",
         currentStep: exact.currentStep,
         totalSteps: exact.totalSteps,
         match: exact.match,
-        exactLines: lines.slice(exact.start, lines.length)
+        exactLines: lines.slice(exact.start, lines.length),
+        ...(isFullscreenProfile(profile) && compactFooter
+            ? { promptStackBack: compactFooter[1] === "shift+→"
+                    ? "shift_right" : "alt_down" }
+            : {}),
+        ...(isFullscreenProfile(profile) && compactFooter?.[4] === "next question"
+            ? { promptStackForward: compactFooter[3] === "shift+←"
+                    ? "shift_left" : "alt_up" }
+            : {})
     };
 }
 function parseQuestionBody(lines, bodyStart, question, source, questionStart, footerStart, maximumPending) {
@@ -537,7 +574,10 @@ function parseAnswerRegion(lines, question, source) {
     const match = {
         source_id: source.sourceId,
         source_question_index: question.sourceIndex,
-        question: question.semantic
+        question: question.semantic,
+        ...(question.nativeQuestionId === undefined
+            ? {}
+            : { native_question_id: question.nativeQuestionId })
     };
     if (question.modelOptions.length === 0) {
         return normalizeText(lines[0] ?? "") === "Type your answer" &&
@@ -753,4 +793,8 @@ function stableJson(value) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function isFullscreenProfile(profile) {
+    return profile === CODEX_ASYNC_QUESTION_PROFILES["0.158.0"] ||
+        profile === CODEX_ASYNC_QUESTION_PROFILES["0.159.0"];
+}
 //# sourceMappingURL=codex-async-question-adapter.js.map