@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

package/dist/src/codex-native-public-projection.js

@@ -0,0 +1,182 @@
+import { backendObservationStopped, backendTaskRecoveryProjection } from "./backend-task-recovery.js";
+import { createHash } from "node:crypto";
+import { createCodexNativeConversationId } from "./codex-native-identity.js";
+import { parseCodexNativeConversationId } from "./codex-native-identity.js";
+import { isRecord } from "./value-guards.js";
+const semanticId = (kind, parts) => `${kind}:${createHash("sha256").update(JSON.stringify(parts)).digest("hex")}`;
+const questionId = (interaction, nativeId) => semanticId("q", [interaction.id, nativeId]);
+const optionId = (interaction, nativeId, option) => semanticId("o", [interaction.id, nativeId, option]);
+/** Keep native request projections separate from terminal screen-derived questionnaire contracts. */
+export function validateNativeInteractionProjections(value, conversationId, watchId) {
+    if (typeof conversationId !== "string" || !Array.isArray(value) || value.length > 128)
+        throw new Error("Invalid native interaction projection");
+    const identity = parseCodexNativeConversationId(conversationId);
+    const ids = new Set();
+    for (const item of value) {
+        assertNativeInteractionProjection(item, { threadId: identity.threadId, conversationId, watchId, ids });
+        ids.add(item.interaction_id);
+        for (const question of item.questions)
+            assertNativeQuestionProjection(question);
+    }
+    return value;
+}
+function assertNativeInteractionProjection(item, expected) {
+    if (!isRecord(item) || typeof item.interaction_id !== "string" || !/^codex-native-interaction:[0-9a-f]{64}$/u.test(item.interaction_id)
+        || expected.ids.has(item.interaction_id) || item.native_thread_id !== expected.threadId || typeof item.native_turn_id !== "string"
+        || item.status !== "pending" || !["command_approval", "file_approval", "blocking_question", "async_question"].includes(String(item.kind))
+        || !Array.isArray(item.questions) || item.questions.length > 16
+        || (expected.watchId ? item.watch_id !== expected.watchId : item.conversation_id !== expected.conversationId)) {
+        throw new Error("Native interaction identity mismatch");
+    }
+}
+function assertNativeQuestionProjection(question) {
+    if (!isRecord(question) || typeof question.question_id !== "string" || !/^q:[0-9a-f]{64}$/u.test(question.question_id)
+        || typeof question.title !== "string" || !["single_select", "free_text"].includes(String(question.response_kind))
+        || !Array.isArray(question.options) || question.options.some(option => !isNativeOptionProjection(option))) {
+        throw new Error("Invalid native question projection");
+    }
+}
+function isNativeOptionProjection(option) {
+    return isRecord(option) && typeof option.option_id === "string" &&
+        /^o:[0-9a-f]{64}$/u.test(option.option_id) && typeof option.label === "string";
+}
+export function nativeInteractionProjection(interaction, conversationId, watchId) {
+    const target = watchId ? { watch_id: watchId } : { conversation_id: conversationId };
+    const approval = interaction.kind === "command_approval" || interaction.kind === "file_approval";
+    return {
+        ...target, interaction_id: interaction.id, kind: interaction.kind, status: "pending",
+        native_thread_id: interaction.threadId, native_turn_id: interaction.turnId,
+        ...(interaction.command ? { command: interaction.command } : {}),
+        ...(interaction.reason ? { reason: interaction.reason } : {}),
+        ...(interaction.networkApprovalContext ? { network: interaction.networkApprovalContext } : {}),
+        ...(interaction.cwd ? { cwd: interaction.cwd } : {}),
+        ...(interaction.changes ? { file_changes: interaction.changes } : {}),
+        ...(interaction.kind === "async_question" ? { delivery_modes: ["steer_current_turn"] } : {}),
+        questions: interaction.questions.map(question => ({
+            question_id: questionId(interaction, question.id), title: question.title,
+            ...(question.isSecret ? { is_secret: true } : {}),
+            response_kind: question.options.length ? "single_select" : "free_text",
+            allow_free_text: !question.options.length || question.isOther === true || interaction.kind === "async_question",
+            options: question.options.map(option => ({ option_id: optionId(interaction, question.id, option), label: option }))
+        })),
+        available_actions: approval
+            ? { approve: { tool: "agent_knock_knock_approve", input: { ...target, interaction_id: interaction.id } } }
+            : { respond: { tool: "agent_knock_knock_respond_interaction", input: { ...target, interaction_id: interaction.id } } }
+    };
+}
+/** Resolve advertised opaque IDs against fresh native questions, never against labels supplied by a caller. */
+export function nativeQuestionResponse(interaction, value) {
+    assertNativeQuestionResponseEnvelope(interaction, value);
+    const answers = {};
+    for (const answer of value.answers) {
+        if (!isRecord(answer))
+            throw new Error("Invalid question answer");
+        const question = interaction.questions.find(q => questionId(interaction, q.id) === answer.question_id);
+        if (!question || Object.hasOwn(answers, question.id))
+            throw new Error("Question ID is absent or duplicated");
+        Object.defineProperty(answers, question.id, { value: [nativeQuestionAnswerText(interaction, question, answer)], enumerable: true });
+    }
+    return { answers };
+}
+function assertNativeQuestionResponseEnvelope(interaction, value) {
+    if (!isRecord(value) || value.interaction_id !== interaction.id || !Array.isArray(value.answers) ||
+        value.answers.length !== interaction.questions.length ||
+        Object.keys(value).some(key => !["interaction_id", "answers", "delivery_mode"].includes(key))) {
+        throw new Error("Answer must match the current Codex CLI interaction and every question");
+    }
+    if (value.delivery_mode !== undefined && (interaction.kind !== "async_question" || value.delivery_mode !== "steer_current_turn")) {
+        throw new Error("This Codex CLI question does not support the requested delivery mode");
+    }
+    if (!["blocking_question", "async_question"].includes(interaction.kind))
+        throw new Error("Current interaction is an approval, not a question");
+}
+function nativeQuestionAnswerText(interaction, question, answer) {
+    if (answer.response_kind === "single_select")
+        return nativeSelectedOptionText(interaction, question, answer);
+    if (answer.response_kind === "free_text")
+        return nativeFreeTextAnswer(interaction, question, answer);
+    throw new Error("Unsupported Codex CLI response kind");
+}
+function nativeSelectedOptionText(interaction, question, answer) {
+    if (Object.keys(answer).some(key => !["question_id", "response_kind", "selected_option_ids"].includes(key)) ||
+        !Array.isArray(answer.selected_option_ids) || answer.selected_option_ids.length !== 1)
+        throw new Error("Select one advertised option ID");
+    const selected = answer.selected_option_ids[0];
+    const option = question.options.find(o => optionId(interaction, question.id, o) === selected);
+    if (option === undefined)
+        throw new Error("Selected option is no longer available");
+    return option;
+}
+function nativeFreeTextAnswer(interaction, question, answer) {
+    if (Object.keys(answer).some(key => !["question_id", "response_kind", "text"].includes(key)) ||
+        question.options.length && !question.isOther && interaction.kind !== "async_question" ||
+        typeof answer.text !== "string" || !answer.text.trim() || answer.text.length > 8192 || /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/u.test(answer.text)) {
+        throw new Error("Free text is invalid or not allowed for this question");
+    }
+    return answer.text;
+}
+export function nativeTurnProjection(turn) {
+    if (!turn)
+        return null;
+    const messages = turn.items.filter(item => item.type === "agentMessage" && typeof item.text === "string");
+    const finals = messages.filter(item => item.phase === "final_answer");
+    const text = (finals.length ? finals : messages.filter(item => item.phase == null)).map(item => item.text).join("\n\n");
+    return { id: turn.id, status: turn.status, items_complete: turn.itemsComplete,
+        ...(turn.status !== "inProgress" && turn.itemsComplete ? { final_text: text } : { response_text: text }) };
+}
+export function codexNativeSessionProjection(identity, snapshot, backendVersion, interactionsScanned = false) {
+    const id = createCodexNativeConversationId(identity);
+    const active = snapshot.turns.filter(turn => turn.status === "inProgress");
+    const watch = snapshot.loaded && active.length === 1 && active[0].id === snapshot.latestTurnId;
+    return {
+        id, conversation_id: id, source: "codex_cli", agent: "codex",
+        title: snapshot.thread.name ?? snapshot.thread.preview ?? "Codex CLI", cwd: snapshot.thread.cwd,
+        native_thread_id: identity.threadId, native_turn_id: snapshot.latestTurnId,
+        backend_version: backendVersion, connection_state: snapshot.loaded ? "loaded_backend_verified" : "not_loaded",
+        activity_state: snapshot.thread.status.type,
+        active_flags: snapshot.thread.status.type === "active" ? snapshot.thread.status.activeFlags : [],
+        interaction_requests_scanned: interactionsScanned,
+        pending_interaction_count: interactionsScanned ? snapshot.pendingInteractions.length : null,
+        attention_required: snapshot.pendingInteractions.length > 0 || snapshot.thread.status.type === "active" && snapshot.thread.status.activeFlags.length > 0,
+        capabilities: { status: true, send: snapshot.canSend, watch, interaction_notify: watch,
+            interaction_respond: snapshot.loaded, approve: snapshot.loaded, set_permissions: snapshot.loaded },
+        interaction_state: snapshot.pendingInteractions.map(item => nativeInteractionProjection(item, id)),
+        latest_turn: nativeTurnProjection(snapshot.turns.find(turn => turn.id === snapshot.latestTurnId)),
+        available_actions: {
+            status: { tool: "agent_knock_knock_status", input: { conversation_id: id } },
+            ...(snapshot.canSend ? { send: { tool: "agent_knock_knock_send", input: { conversation_id: id } } } : {}),
+            ...(watch ? { watch: { tool: "agent_knock_knock_watch", input: { conversation_id: id } } } : {}),
+            ...(snapshot.loaded ? { permission_options: { tool: "agent_knock_knock_permission_options", input: { conversation_id: id } } } : {})
+        }
+    };
+}
+export function codexNativeTaskProjection(task) {
+    const intent = task.send_intent;
+    const { recovery_actions, ...recovery } = backendTaskRecoveryProjection(task);
+    const stopped = backendObservationStopped(task);
+    const active = !stopped && (task.status === "watching" || task.status === "awaiting_acceptance");
+    const notifications = task.notifications.map(note => ({ id: note.id, notification_id: note.id, status: note.status, attempts: note.attempts,
+        ...(note.outcome && "error_code" in note.outcome ? { error_code: note.outcome.error_code } : {}) }));
+    return {
+        watch_id: task.id, conversation_id: task.native_id, source: "codex_cli", status: task.closed_at ? "closed" : task.status,
+        ...recovery, observation_status: task.status, observation_active: active,
+        available_actions: recovery_actions,
+        native_thread_id: task.target.threadId, native_turn_id: task.native_turn_id ?? null,
+        observation_mode: task.native_turn_id ? "exact_task" : "pending_acceptance", anchor_state: task.native_turn_id ? "verified" : "pending",
+        created_at: task.created_at, updated_at: task.updated_at, observed_at: task.observed_at,
+        observation_error: task.observation_error, final_text: task.final_text,
+        pending_interaction_count: task.pending_interactions.length,
+        interaction_state: task.pending_interactions.map(item => nativeInteractionProjection(item, task.native_id, task.id)),
+        callback_configured: Boolean(task.callback_route), callback_expected: Boolean(task.callback_route && !stopped &&
+            (active || notifications.some(note => ["ready", "leased", "retry_wait"].includes(note.status)))),
+        callback_notifications: notifications,
+        capabilities: { close: task.kind === "send" && !task.closed_at, renew: !task.closed_at, recover: !task.closed_at,
+            retry_callback: !stopped && task.notifications.some(note => ["failed", "retry_wait"].includes(note.status) && note.outcome?.disposition === "retryable_failure"),
+            callback: Boolean(task.callback_route) && !stopped, interaction_notify: active && Boolean(task.callback_route),
+            interaction_respond: active, approve: active },
+        ...(intent ? { message_id: intent.message_id, delivered: intent.state === "accepted", send_state: intent.state,
+            delivery_receipt: intent.state === "accepted" ? "native_task_verified" : intent.state === "not_sent" ? "not_sent" : "acceptance_unproven",
+            agent_acceptance: intent.state === "accepted" ? "proven" : "unproven", send_error: intent.error_code, resend_allowed: false } : {})
+    };
+}
+//# sourceMappingURL=codex-native-public-projection.js.map

package/dist/src/codex-native-public-projection.js.map

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

package/dist/src/codex-native-record-store.d.ts

@@ -0,0 +1,27 @@
+export interface NativeDurableRecord {
+    id: string;
+    revision: number;
+    created_at: string;
+}
+export interface NativeRecordRepository<T extends NativeDurableRecord> {
+    load(id: string): T | undefined;
+    list(): T[];
+    scanForReconciliation(): {
+        tasks: T[];
+        errors: {
+            id: string;
+            error_code: string;
+        }[];
+    };
+    save(record: T, expectedRevision: number | null): T;
+    withLock<R>(id: string, operation: () => R): R;
+}
+/** Native task and response ledgers share atomic writes, private paths and CAS. */
+export declare function createNativeRecordRepository<T extends NativeDurableRecord>(options: {
+    storeDir: string;
+    directory: string;
+    prefix: string;
+    acquire(lockPath: string): () => void;
+    assert(value: unknown): asserts value is T;
+    assertUpdate(previous: T, next: T): void;
+}): NativeRecordRepository<T>;

package/dist/src/codex-native-record-store.js

@@ -0,0 +1,111 @@
+import fs from "node:fs";
+import path from "node:path";
+import { assertRealDirectory, atomicSaveJsonFile, isNodeError, readJsonFileNoFollow } from "./durable-json-file.js";
+import { assertStoreReadable, ensureDir, withStoreWriterLease } from "./store.js";
+function privatePath(file, directory) {
+    const stat = fs.lstatSync(file);
+    if (stat.isSymbolicLink() || (directory ? !stat.isDirectory() : !stat.isFile()) ||
+        (stat.mode & 0o077) !== 0 || (process.getuid && stat.uid !== process.getuid())) {
+        throw new Error("Codex native state must be an owner-private regular " + (directory ? "directory" : "file"));
+    }
+}
+/** Native task and response ledgers share atomic writes, private paths and CAS. */
+export function createNativeRecordRepository(options) {
+    const root = path.join(options.storeDir, options.directory);
+    const validId = new RegExp(`^${options.prefix}[a-zA-Z0-9_-]{8,128}$`);
+    function statePath(id) {
+        if (!validId.test(id))
+            throw new Error("Invalid Codex native state ID");
+        return path.join(root, `${id}.json`);
+    }
+    function load(id) {
+        const file = statePath(id);
+        if (!fs.existsSync(options.storeDir))
+            return undefined;
+        assertStoreReadable(options.storeDir);
+        try {
+            assertRealDirectory(root, "Codex native state");
+            privatePath(root, true);
+            privatePath(file, false);
+            const record = readJsonFileNoFollow(file, "Codex native state");
+            options.assert(record);
+            if (record.id !== id)
+                throw new Error("Codex native record filename identity mismatch");
+            return record;
+        }
+        catch (error) {
+            if (isNodeError(error, "ENOENT"))
+                return undefined;
+            throw error;
+        }
+    }
+    function scan(isolate) {
+        const result = { tasks: [], errors: [] };
+        if (!fs.existsSync(options.storeDir))
+            return result;
+        assertStoreReadable(options.storeDir);
+        if (!fs.existsSync(root))
+            return result;
+        privatePath(root, true);
+        for (const entry of fs.readdirSync(root)) {
+            const file = path.join(root, entry);
+            try {
+                privatePath(file, false);
+            }
+            catch (error) {
+                if (isNodeError(error, "ENOENT"))
+                    continue;
+                throw error;
+            }
+            if (entry.endsWith(".json.lock") || entry.endsWith(".json.lock.reclaim") || entry.startsWith(".") && entry.endsWith(".tmp"))
+                continue;
+            if (!entry.endsWith(".json"))
+                throw new Error("Unknown Codex native state file");
+            const id = entry.slice(0, -5);
+            statePath(id);
+            try {
+                const record = readJsonFileNoFollow(file, "Codex native state");
+                options.assert(record);
+                if (record.id !== id)
+                    throw new Error("Codex native record filename identity mismatch");
+                result.tasks.push(record);
+            }
+            catch (error) {
+                if (!isolate || isNodeError(error, "EACCES") || isNodeError(error, "ELOOP"))
+                    throw error;
+                result.errors.push({ id, error_code: "codex_native_record_invalid" });
+            }
+        }
+        result.tasks.sort((a, b) => b.created_at.localeCompare(a.created_at) || a.id.localeCompare(b.id));
+        return result;
+    }
+    return {
+        load, list: () => scan(false).tasks, scanForReconciliation: () => scan(true),
+        withLock: (id, operation) => withStoreWriterLease(options.storeDir, () => {
+            const file = statePath(id);
+            ensureDir(root);
+            privatePath(root, true);
+            const release = options.acquire(`${file}.lock`);
+            try {
+                return operation();
+            }
+            finally {
+                release();
+            }
+        }),
+        save: (record, revision) => withStoreWriterLease(options.storeDir, () => {
+            const previous = load(record.id);
+            if ((previous?.revision ?? null) !== revision)
+                throw new Error("Codex native state revision conflict");
+            if (previous)
+                options.assertUpdate(previous, record);
+            const saved = { ...record, revision: (revision ?? 0) + 1 };
+            options.assert(saved);
+            atomicSaveJsonFile(statePath(saved.id), saved, {
+                rootLabel: "AKK store", directoryLabel: "Codex native state", fileLabel: "Codex native record", ensureDirectory: ensureDir
+            });
+            return saved;
+        })
+    };
+}
+//# sourceMappingURL=codex-native-record-store.js.map

package/dist/src/codex-native-record-store.js.map

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

package/dist/src/codex-native-response-service.d.ts

@@ -0,0 +1,69 @@
+import { type NativeRecordRepository } from "./codex-native-record-store.js";
+import { type CodexNativeStateRepository, type PersistedNativeInteraction } from "./codex-native-state-store.js";
+import type { CodexNativeIdentity, CodexNativeReceipt, CodexNativeSnapshot, NativeInteraction, NativeInteractionResponse } from "./codex-native-types.js";
+export type NativeResponseValue = NativeInteractionResponse | {
+    answer: string;
+};
+export interface NativeResponseInput {
+    target: CodexNativeIdentity;
+    nativeId: string;
+    controllerSession: string;
+    interactionId: string;
+    responseId: string;
+    response: NativeResponseValue;
+}
+export interface CodexNativeResponseRecord {
+    schema: "agent-knock-knock/codex-native-response";
+    version: 1;
+    revision: number;
+    id: string;
+    created_at: string;
+    updated_at: string;
+    target: CodexNativeIdentity;
+    native_id: string;
+    controller_session: string;
+    response_id: string;
+    interaction: PersistedNativeInteraction;
+    response: NativeResponseValue;
+    baseline_item_ids: string[];
+    baseline_item_status?: string;
+    client_user_message_id?: string;
+    state: "reserved" | "sent" | "confirmed" | "uncertain" | "not_sent";
+    /** Only explicit, proven-before-dispatch retries increment this counter. */
+    attempts?: number;
+    not_sent_history?: {
+        attempt: number;
+        observed_at: string;
+        error_code?: string;
+    }[];
+    evidence?: "exact_async_answer_observed" | "native_item_advanced" | "native_turn_settled" | "native_task_continued";
+    error_code?: string;
+}
+export type CodexNativeResponseRepository = NativeRecordRepository<CodexNativeResponseRecord>;
+export declare function createCodexNativeResponseStore(storeDir: string, locks: {
+    acquire(lockPath: string): () => void;
+}): CodexNativeResponseRepository;
+export interface NativeResponseDependencies {
+    repository: CodexNativeResponseRepository;
+    tasks: CodexNativeStateRepository;
+    observe(target: CodexNativeIdentity, exactTurnId?: string): Promise<CodexNativeSnapshot>;
+    respond(target: CodexNativeIdentity, interaction: NativeInteraction, response: NativeInteractionResponse): Promise<{
+        dispatchState: "sent";
+    }>;
+    answerAsync(target: CodexNativeIdentity, interaction: NativeInteraction, input: {
+        answer: string;
+        clientUserMessageId: string;
+    }): Promise<CodexNativeReceipt>;
+    now?(): Date;
+    randomUUID?(): string;
+}
+export declare function createCodexNativeResponseService(deps: NativeResponseDependencies): {
+    respond: (input: NativeResponseInput, watchAuthority?: {
+        turnId: string;
+        check(): void;
+    }) => Promise<CodexNativeResponseRecord>;
+    reconcile: (id: string) => Promise<CodexNativeResponseRecord>;
+    status: (id: string) => CodexNativeResponseRecord;
+    list: () => CodexNativeResponseRecord[];
+    respondWatch(watchId: string, input: Omit<NativeResponseInput, "target" | "nativeId">): Promise<CodexNativeResponseRecord>;
+};