@scotthuang/agent-knock-knock 0.13.18 → 0.14.1

package/dist/src/codex-native-response-service.js

@@ -0,0 +1,244 @@
+import { randomUUID } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
+import { createNativeRecordRepository } from "./codex-native-record-store.js";
+import { assertNativeIdentity, assertPersistedNativeInteraction, nonblank, persistNativeInteraction, validTime } from "./codex-native-state-store.js";
+import { CodexNativeTaskError, nativeDigest, nativeErrorCode, nativeTurn } from "./codex-native-task-service.js";
+function assertResponseSchema(r) {
+    if (!r || r.schema !== "agent-knock-knock/codex-native-response" || r.version !== 1 ||
+        !Number.isSafeInteger(r.revision) || r.revision < 1 || !/^codex-cli-response:[a-f0-9]{64}$/.test(r.id) ||
+        !validTime(r.created_at) || !validTime(r.updated_at) || !nonblank(r.controller_session) || !nonblank(r.response_id) ||
+        !["reserved", "sent", "confirmed", "uncertain", "not_sent"].includes(r.state) || !r.response || typeof r.response !== "object" ||
+        !Array.isArray(r.baseline_item_ids) || r.baseline_item_ids.some(id => !nonblank(id)))
+        throw new Error("Invalid Codex native response record");
+}
+function assertResponse(value) {
+    const r = value;
+    assertResponseSchema(r);
+    assertNativeIdentity(r.native_id, r.target);
+    assertPersistedNativeInteraction(r.interaction, r.target);
+    validateResponse(r.interaction, r.response);
+    if (r.interaction.kind === "async_question" && !nonblank(r.client_user_message_id))
+        throw new Error("Native async answer requires correlation identity");
+    if (r.state === "confirmed" && !r.evidence)
+        throw new Error("Native response confirmation requires observed evidence");
+    if (r.attempts !== undefined && (!Number.isSafeInteger(r.attempts) || r.attempts < 1))
+        throw new Error("Invalid native response attempt counter");
+    if (r.not_sent_history !== undefined && (!Array.isArray(r.not_sent_history) || r.not_sent_history.some(attempt => !Number.isSafeInteger(attempt.attempt) || attempt.attempt < 1 || !validTime(attempt.observed_at))))
+        throw new Error("Invalid native response attempt history");
+}
+export function createCodexNativeResponseStore(storeDir, locks) {
+    return createNativeRecordRepository({ storeDir, directory: "codex-native-responses", prefix: "codex-cli-response:", acquire: locks.acquire,
+        assert: assertResponse,
+        assertUpdate: (previous, next) => {
+            for (const key of ["id", "created_at", "target", "native_id", "controller_session", "response_id", "interaction", "response", "baseline_item_ids", "baseline_item_status", "client_user_message_id"]) {
+                if (!isDeepStrictEqual(previous[key], next[key]))
+                    throw new Error("Codex native response intent cannot change");
+            }
+            if (previous.state === "confirmed" && next.state !== "confirmed")
+                throw new Error("Codex native response proof cannot regress");
+        } });
+}
+function validateResponse(interaction, response) {
+    if (interaction.kind.endsWith("approval")) {
+        if (!("decision" in response) || !["accept", "decline", "cancel"].includes(response.decision))
+            throw new CodexNativeTaskError("invalid_argument", "Approval needs accept, decline or cancel");
+        return;
+    }
+    if (interaction.kind === "async_question" && "answer" in response && response.answer.trim())
+        return;
+    if (!("answers" in response) || !response.answers || typeof response.answers !== "object")
+        throw new CodexNativeTaskError("invalid_argument", "Question response requires answers");
+    const expected = interaction.questions.map(q => q.id).sort();
+    if (!isDeepStrictEqual(Object.keys(response.answers).sort(), expected) || Object.values(response.answers).some(answers => !Array.isArray(answers) || !answers.length || answers.some(answer => !nonblank(answer)))) {
+        throw new CodexNativeTaskError("invalid_argument", "Answers must address the exact pending question IDs");
+    }
+    if (interaction.kind === "async_question" && (expected.length !== 1 || response.answers[expected[0]].length !== 1))
+        throw new CodexNativeTaskError("invalid_argument", "Async question requires one answer");
+}
+function asyncAnswer(record) {
+    return "answer" in record.response ? record.response.answer : "answers" in record.response ? record.response.answers[record.interaction.questions[0].id][0] : "";
+}
+function echoedAnswer(record, snapshot) {
+    const turn = nativeTurn(snapshot, record.interaction.turnId);
+    if (!turn?.itemsComplete)
+        return false;
+    const messages = turn.items.filter(item => item.type === "userMessage" && item.clientId === record.client_user_message_id);
+    if (messages.length !== 1)
+        return false;
+    const text = messages[0].content?.filter(item => item.type === "text").map(item => item.text ?? "").join("\n") ?? messages[0].text;
+    if (typeof text !== "string")
+        return false;
+    const match = /^<send_user_message_question_reply>\s*([\s\S]+?)\s*<\/send_user_message_question_reply>$/u.exec(text);
+    try {
+        const answers = match && JSON.parse(match[1]);
+        const question = record.interaction.questions[0];
+        return Array.isArray(answers) && answers.length === 1 && answers[0].questionItemId === question.id &&
+            answers[0].question === question.title && answers[0].answer === asyncAnswer(record);
+    }
+    catch {
+        return false;
+    }
+}
+function reserveKnownNotSentRetry(repository, record, date) {
+    const attempted = record.attempts ?? 1;
+    record.not_sent_history = [...(record.not_sent_history ?? []), { attempt: attempted, observed_at: record.updated_at,
+            ...(record.error_code ? { error_code: record.error_code } : {}) }];
+    record.state = "reserved";
+    record.attempts = attempted + 1;
+    record.updated_at = date;
+    delete record.error_code;
+    return repository.save(record, record.revision);
+}
+function nativeWatchResponseAuthority(tasks, watchId, controllerSession) {
+    return tasks.withLock(watchId, () => {
+        const current = tasks.load(watchId);
+        if (!current || current.controller_session !== controllerSession)
+            throw new CodexNativeTaskError("codex_native_controller_mismatch", "Watch response requires its owning controller");
+        if (current.closed_at || current.unwatched_at || current.status === "cancelled")
+            throw new CodexNativeTaskError("codex_native_watch_stopped", "Stopped tasks cannot authorize interaction responses", "not_sent");
+        return current;
+    });
+}
+function assertWatchInteraction(task, existing, interactionId) {
+    const recordedForTask = existing?.native_id === task.native_id && existing.interaction.turnId === task.native_turn_id;
+    if (!recordedForTask && !task.pending_interactions.some(i => i.id === interactionId && i.turnId === task.native_turn_id)) {
+        throw new CodexNativeTaskError("stale_interaction", "Interaction does not belong to the watched native task");
+    }
+}
+export function createCodexNativeResponseService(deps) {
+    const repo = deps.repository;
+    const now = deps.now ?? (() => new Date());
+    const uuid = deps.randomUUID ?? randomUUID;
+    function status(id) {
+        const record = repo.load(id);
+        if (!record)
+            throw new CodexNativeTaskError("codex_native_response_not_found", "Native response was not found");
+        return record;
+    }
+    function update(id, operation) {
+        return repo.withLock(id, () => { const record = status(id); operation(record); record.updated_at = now().toISOString(); return repo.save(record, record.revision); });
+    }
+    async function reconcile(id) {
+        const before = status(id);
+        if (["confirmed", "not_sent", "reserved"].includes(before.state))
+            return before;
+        let snapshot;
+        try {
+            snapshot = await deps.observe(before.target, before.interaction.turnId);
+        }
+        catch (error) {
+            return update(id, record => { record.error_code = nativeErrorCode(error); });
+        }
+        if (snapshot.threadId !== before.target.threadId)
+            throw new CodexNativeTaskError("codex_native_identity_mismatch", "Native answer observation changed identity");
+        return update(id, record => {
+            const turn = nativeTurn(snapshot, record.interaction.turnId);
+            if (["confirmed", "not_sent", "reserved"].includes(record.state) || !turn)
+                return;
+            let evidence;
+            if (record.interaction.kind === "async_question") {
+                if (echoedAnswer(record, snapshot))
+                    evidence = "exact_async_answer_observed";
+            }
+            else if (!snapshot.pendingInteractions.some(i => i.id === record.interaction.id)) {
+                const item = turn.items.find(i => i.id === record.interaction.itemId);
+                if (item && typeof item.status === "string" && item.status !== record.baseline_item_status && item.status !== "inProgress")
+                    evidence = "native_item_advanced";
+                else if (turn.status !== "inProgress" && turn.itemsComplete)
+                    evidence = "native_turn_settled";
+                else if (record.interaction.kind === "blocking_question" && turn.items.some(i => !record.baseline_item_ids.includes(i.id) && i.type !== "userMessage"))
+                    evidence = "native_task_continued";
+            }
+            if (evidence) {
+                record.state = "confirmed";
+                record.evidence = evidence;
+                delete record.error_code;
+            }
+        });
+    }
+    async function respond(input, watchAuthority) {
+        watchAuthority?.check();
+        assertNativeIdentity(input.nativeId, input.target);
+        if (!input.responseId?.trim() || !input.interactionId?.trim() || !input.controllerSession?.trim())
+            throw new CodexNativeTaskError("invalid_argument", "Native response requires controller, interaction and response IDs");
+        const id = `codex-cli-response:${nativeDigest([input.target, input.interactionId])}`;
+        function duplicate(record) {
+            if (record.controller_session !== input.controllerSession || !isDeepStrictEqual(record.response, input.response) ||
+                record.native_id !== input.nativeId || record.interaction.id !== input.interactionId)
+                throw new CodexNativeTaskError("codex_native_response_conflict", "This interaction already has a different response intent");
+            return record;
+        }
+        const previous = repo.load(id);
+        if (previous) {
+            duplicate(previous);
+            if (previous.state !== "not_sent")
+                return reconcile(id);
+        }
+        const snapshot = await deps.observe(input.target, watchAuthority?.turnId);
+        watchAuthority?.check();
+        const interactions = snapshot.pendingInteractions.filter(i => i.id === input.interactionId && i.threadId === input.target.threadId);
+        const interaction = interactions.length === 1 ? interactions[0] : undefined;
+        if (!snapshot.loaded || snapshot.threadId !== input.target.threadId || !interaction || nativeTurn(snapshot, interaction.turnId)?.status !== "inProgress") {
+            throw new CodexNativeTaskError("stale_interaction", "The exact native interaction is no longer pending");
+        }
+        validateResponse(interaction, input.response);
+        const turn = nativeTurn(snapshot, interaction.turnId);
+        const date = now().toISOString();
+        const itemStatus = turn.items.find(item => item.id === interaction.itemId)?.status;
+        const intent = { schema: "agent-knock-knock/codex-native-response", version: 1, revision: 1, id,
+            created_at: date, updated_at: date, target: structuredClone(input.target), native_id: input.nativeId, controller_session: input.controllerSession,
+            response_id: input.responseId, interaction: persistNativeInteraction(interaction), response: structuredClone(input.response), state: "reserved", attempts: 1,
+            baseline_item_ids: turn.items.map(item => item.id), ...(typeof itemStatus === "string" ? { baseline_item_status: itemStatus } : {}),
+            ...(interaction.kind === "async_question" ? { client_user_message_id: uuid() } : {}) };
+        let created = false;
+        const reserved = repo.withLock(id, () => {
+            watchAuthority?.check();
+            const existing = repo.load(id);
+            if (existing) {
+                duplicate(existing);
+                if (existing.state !== "not_sent")
+                    return existing;
+                created = true;
+                return reserveKnownNotSentRetry(repo, existing, date);
+            }
+            created = true;
+            return repo.save(intent, null);
+        });
+        if (!created)
+            return reserved;
+        // A crashed or disconnected response is observed on recovery, never automatically replayed.
+        watchAuthority?.check();
+        update(id, record => { record.state = "uncertain"; });
+        try {
+            if (interaction.kind === "async_question") {
+                const receipt = await deps.answerAsync(input.target, interaction, { answer: asyncAnswer(reserved), clientUserMessageId: reserved.client_user_message_id });
+                if (receipt.turnId !== interaction.turnId || receipt.clientUserMessageId !== reserved.client_user_message_id)
+                    throw new Error("Native async answer receipt identity mismatch");
+            }
+            else
+                await deps.respond(input.target, interaction, input.response);
+            update(id, record => { if (record.state !== "confirmed")
+                record.state = "sent"; });
+        }
+        catch (error) {
+            update(id, record => {
+                if (record.state === "confirmed")
+                    return;
+                record.error_code = nativeErrorCode(error);
+                record.state = error?.dispatchState === "not_sent" ? "not_sent" : "uncertain";
+            });
+        }
+        return reconcile(id);
+    }
+    return {
+        respond, reconcile, status, list: () => repo.list(),
+        async respondWatch(watchId, input) {
+            const check = () => nativeWatchResponseAuthority(deps.tasks, watchId, input.controllerSession);
+            const task = check();
+            const existing = repo.load(`codex-cli-response:${nativeDigest([task.target, input.interactionId])}`);
+            assertWatchInteraction(task, existing, input.interactionId);
+            return respond({ ...input, target: task.target, nativeId: task.native_id }, { turnId: task.native_turn_id, check });
+        }
+    };
+}
+//# sourceMappingURL=codex-native-response-service.js.map

package/dist/src/codex-native-response-service.js.map

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

package/dist/src/codex-native-runtime.d.ts

@@ -0,0 +1,46 @@
+import { CodexNativeClient } from "./codex-native-client.js";
+import { type CodexNativeTransportPort } from "./codex-native-task-service.js";
+import type { CallbackAttemptOutcome, CallbackTransportDeliverInput } from "./callback-transport.js";
+import type { CodexNativeClientOptions, CodexNativeIdentity, CodexNativeThread } from "./codex-native-types.js";
+export type CodexNativeClientPort = Pick<CodexNativeClient, "metadata" | "discover" | "readSnapshot" | "subscribe" | "start" | "respond" | "answerAsync" | "readPermissions" | "updatePermissions" | "close">;
+export interface CodexNativeRuntimeOptions {
+    storeDir: string;
+    codexHomes: string[];
+    openclawBin?: string;
+    clientFactory?(options: CodexNativeClientOptions): Promise<CodexNativeClientPort>;
+    callbackDeliver?(input: CallbackTransportDeliverInput): Promise<CallbackAttemptOutcome> | CallbackAttemptOutcome;
+}
+export interface CodexNativeCatalogEntry extends CodexNativeIdentity {
+    nativeId: string;
+    thread: CodexNativeThread;
+    backendVersion: string;
+}
+/** Keep subscriptions alive across polling; reconnects replay pending native requests. */
+export declare function createCodexNativeRuntime(options: CodexNativeRuntimeOptions): {
+    tasks: import("./codex-native-task-service.js").CodexNativeTaskService;
+    responses: {
+        respond: (input: import("./codex-native-response-service.js").NativeResponseInput, watchAuthority?: {
+            turnId: string;
+            check(): void;
+        }) => Promise<import("./codex-native-response-service.js").CodexNativeResponseRecord>;
+        reconcile: (id: string) => Promise<import("./codex-native-response-service.js").CodexNativeResponseRecord>;
+        status: (id: string) => import("./codex-native-response-service.js").CodexNativeResponseRecord;
+        list: () => import("./codex-native-response-service.js").CodexNativeResponseRecord[];
+        respondWatch(watchId: string, input: Omit<import("./codex-native-response-service.js").NativeResponseInput, "target" | "nativeId">): Promise<import("./codex-native-response-service.js").CodexNativeResponseRecord>;
+    };
+    transport: CodexNativeTransportPort;
+    catalog: {
+        discover(): Promise<{
+            sessions: CodexNativeCatalogEntry[];
+            errors: {
+                codexHome: string;
+                error_code: string;
+            }[];
+        }>;
+    };
+    clientFor: (identity: Pick<CodexNativeIdentity, "codexHome">) => Promise<CodexNativeClientPort>;
+    read: (identity: CodexNativeIdentity, exactTurnId?: string) => Promise<import("./codex-native-types.js").CodexNativeSnapshot>;
+    reconcile(watchId: string): Promise<import("./codex-native-state-store.js").CodexNativeTaskRecord>;
+    close(): Promise<void>;
+};
+export type CodexNativeRuntime = ReturnType<typeof createCodexNativeRuntime>;

package/dist/src/codex-native-runtime.js

@@ -0,0 +1,112 @@
+import { backendObservationStopped } from "./backend-task-recovery.js";
+import path from "node:path";
+import { CodexNativeClient } from "./codex-native-client.js";
+import { createCodexNativeConversationId } from "./codex-native-identity.js";
+import { createCodexNativeStateStore } from "./codex-native-state-store.js";
+import { createCodexNativeTaskService, nativeErrorCode } from "./codex-native-task-service.js";
+import { createCodexNativeResponseService, createCodexNativeResponseStore } from "./codex-native-response-service.js";
+import { createFileLockCliAdapter } from "./file-lock-cli-adapter.js";
+import { createOpenClawCallbackTransport } from "./openclaw-callback-transport.js";
+import { createHostProfileCallbackTransport } from "./host-profile-callback-transport.js";
+import { cliCwd, cliEnv, cliNow, cliNowMs, cliPid, cliSleepSync } from "./cli-runtime-context.js";
+/** Keep subscriptions alive across polling; reconnects replay pending native requests. */
+export function createCodexNativeRuntime(options) {
+    const homes = new Set(options.codexHomes.map(home => path.resolve(home)));
+    const clients = new Map();
+    async function clientFor(identity) {
+        const home = path.resolve(identity.codexHome);
+        if (!path.isAbsolute(identity.codexHome) || !homes.has(home))
+            throw new Error("Codex native target must belong to a configured local home");
+        let pending = clients.get(home);
+        if (!pending) {
+            pending = (options.clientFactory ?? CodexNativeClient.connect)({ codexHome: home });
+            clients.set(home, pending);
+            pending.catch(() => { if (clients.get(home) === pending)
+                clients.delete(home); });
+        }
+        return pending;
+    }
+    async function run(identity, operation) {
+        const client = await clientFor(identity);
+        try {
+            return await operation(client);
+        }
+        catch (error) {
+            if (["closed", "timeout", "invalid_response"].includes(nativeErrorCode(error))) {
+                client.close();
+                clients.delete(path.resolve(identity.codexHome));
+            }
+            throw error;
+        }
+    }
+    const transport = {
+        observe: (identity, turnId) => run(identity, async (client) => {
+            const snapshot = await client.readSnapshot(identity.threadId, turnId);
+            if (!snapshot.loaded)
+                return snapshot;
+            await client.subscribe(identity.threadId);
+            return client.readSnapshot(identity.threadId, turnId);
+        }),
+        start: (identity, input) => run(identity, client => client.start(identity.threadId, input))
+    };
+    const locks = createFileLockCliAdapter({ now: cliNow, nowMs: cliNowMs, pid: cliPid, sleepSync: cliSleepSync });
+    const lockPort = { acquire: (lock) => locks.acquire(lock) };
+    const repository = createCodexNativeStateStore(options.storeDir, lockPort);
+    const responseRepository = createCodexNativeResponseStore(options.storeDir, lockPort);
+    const legacy = createOpenClawCallbackTransport({ now: cliNow, environment: cliEnv,
+        redactConversation: () => { throw new Error("Codex native callbacks do not use managed conversations"); },
+        recordCallbackProcessDelivery: () => { throw new Error("Codex native callbacks use their durable outbox"); } });
+    const callbacks = createHostProfileCallbackTransport({ legacyTransport: legacy, environment: cliEnv, cwd: cliCwd(), now: cliNow });
+    const tasks = createCodexNativeTaskService({ repository, ...transport, now: cliNow,
+        deliver: options.callbackDeliver ?? (input => callbacks.deliver(input)),
+        resolveCallbackContext: task => ({ legacyOptions: { gatewayMethod: "chat.send", openclawSession: task.controller_session,
+                gatewaySession: task.controller_session, openclawBin: options.openclawBin } }) });
+    const responses = createCodexNativeResponseService({ repository: responseRepository, tasks: repository, observe: transport.observe, now: cliNow,
+        respond: (identity, interaction, response) => run(identity, client => client.respond(interaction, response)),
+        answerAsync: (identity, interaction, input) => run(identity, client => client.answerAsync(interaction, input)) });
+    const catalog = {
+        async discover() {
+            const sessions = [], errors = [];
+            for (const codexHome of homes) {
+                try {
+                    const client = await clientFor({ codexHome });
+                    for (const thread of await client.discover()) {
+                        const identity = { codexHome, threadId: thread.id };
+                        sessions.push({ ...identity, nativeId: createCodexNativeConversationId(identity), thread, backendVersion: client.metadata.serverVersion });
+                    }
+                }
+                catch (error) {
+                    errors.push({ codexHome, error_code: nativeErrorCode(error) });
+                }
+            }
+            return { sessions, errors };
+        }
+    };
+    return { tasks, responses, transport, catalog, clientFor,
+        read: (identity, exactTurnId) => run(identity, client => client.readSnapshot(identity.threadId, exactTurnId)),
+        async reconcile(watchId) {
+            const task = await tasks.reconcile(watchId);
+            if (backendObservationStopped(task))
+                return task;
+            for (const response of responseRepository.scanForReconciliation().tasks) {
+                if (["reserved", "sent", "uncertain"].includes(response.state) && response.native_id === task.native_id && response.interaction.turnId === task.native_turn_id) {
+                    try {
+                        await responses.reconcile(response.id);
+                    }
+                    catch { /* Response observation cannot revoke the independently verified task result. */ }
+                }
+            }
+            return task;
+        },
+        async close() {
+            const current = [...clients.values()];
+            clients.clear();
+            for (const pending of current) {
+                try {
+                    (await pending).close();
+                }
+                catch { /* Failed connection owns no subscription. */ }
+            }
+        } };
+}
+//# sourceMappingURL=codex-native-runtime.js.map

package/dist/src/codex-native-runtime.js.map

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

package/dist/src/codex-native-semantic.d.ts

@@ -0,0 +1,17 @@
+type Params = Record<string, unknown>;
+type Context = {
+    sessionKey?: unknown;
+};
+/** A dispatched response is distinct from a subsequently verified native effect. */
+export declare function isNativeInteractionResponseError(value: unknown): boolean;
+/** Native targets carry the backend/thread identity, never terminal UI authority. */
+export declare function nativeConversationTarget(params: Params): string | undefined;
+/** Terminal aliases stay selectors; the CLI router proves the backend identity before dispatch. */
+export declare function routedCodexTerminalTarget(params: Params): string | undefined;
+export declare function routedCodexTerminalControlArgs(params: Params, config: Params, context: Context, action: "status" | "permissions" | "set-permissions"): string[] | undefined;
+export declare function validatedNativeWatchId(value: unknown): string | undefined;
+export declare function nativeSendToolArgs(params: Params, config: Params, context: Context, messageId?: string): string[] | undefined;
+export declare function nativePermissionToolArgs(params: Params, config: Params, context: Context, action: "status" | "permissions" | "set-permissions"): string[] | undefined;
+export declare function nativeApprovalToolArgs(params: Params, config: Params, context: Context): string[] | undefined;
+export declare function nativeInteractionToolArgs(params: Params, config: Params, context: Context): string[] | undefined;
+export {};