@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

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

@@ -0,0 +1,120 @@
+import { backendCallbackMaxAttempts, backendObservationStopped } from "./backend-task-recovery.js";
+import { randomUUID } from "node:crypto";
+import { parseCallbackAttemptOutcome } from "./callback-transport.js";
+import { createDurableNotificationLease, decideDurableNotificationRetry, reduceDurableNotificationSettlement } from "./durable-notification-kernel.js";
+/** Lease and durable checkpoint semantics are shared with the other AKK transports. */
+export function createNativeNotificationOutbox(deps) {
+    const now = deps.now ?? (() => new Date());
+    const uuid = deps.randomUUID ?? randomUUID;
+    const maxAttempts = deps.maxDeliveryAttempts ?? 4;
+    function update(id, operation) {
+        return deps.repository.withLock(id, () => {
+            const task = deps.repository.load(id);
+            if (!task)
+                throw new Error("Codex native Watch not found");
+            operation(task);
+            task.updated_at = now().toISOString();
+            return deps.repository.save(task, task.revision);
+        });
+    }
+    function stale(task, note) {
+        if (note.envelope.event.type === "codex_native_watch.timed_out") {
+            const expected = `${task.id}:timed_out${task.renewal_count ? `:${task.renewal_count}` : ""}`;
+            if (task.status !== "timed_out" || note.id !== expected)
+                return true;
+        }
+        const interactionId = note.envelope.event.metadata?.interaction_id;
+        return typeof interactionId === "string" && !task.pending_interactions.some(interaction => interaction.id === interactionId);
+    }
+    function settle(id, notificationId, attemptId, outcome) {
+        update(id, task => {
+            const n = task.notifications.find(candidate => candidate.id === notificationId);
+            if (!n || n.attempt_id !== attemptId)
+                return;
+            const lateAcceptance = outcome.disposition === "accepted" && n.status === "uncertain" &&
+                n.outcome?.disposition === "uncertain" && n.outcome.error_code === "codex_native_callback_lease_expired";
+            if (n.status !== "leased" && !lateAcceptance)
+                return;
+            if (outcome.disposition === "retryable_failure" && stale(task, n)) {
+                n.status = "failed";
+                n.outcome = { disposition: "permanent_failure", error_code: "codex_native_callback_stale" };
+                delete n.retry_at;
+                return;
+            }
+            n.outcome = outcome;
+            const result = reduceDurableNotificationSettlement({ attempt: n.attempts, outcome, retryEnabled: !backendObservationStopped(task) && !stale(task, n),
+                maxRetryAttempts: backendCallbackMaxAttempts(n, maxAttempts) - 1 });
+            if (result.state === "accepted")
+                n.status = "accepted";
+            else if (result.state === "failed" && result.retryAuthorized) {
+                n.status = "retry_wait";
+                n.retry_at = new Date(now().getTime() + (deps.retryDelayMs ?? 5000) * 2 ** (n.attempts - 1)).toISOString();
+            }
+            else
+                n.status = outcome.disposition === "uncertain" ? "uncertain" : "failed";
+        });
+    }
+    return {
+        async deliverPending(id, notificationId) {
+            let claimed;
+            update(id, task => {
+                for (const n of task.notifications) {
+                    if (notificationId && n.id !== notificationId)
+                        continue;
+                    if (n.status === "leased" && Date.parse(n.lease_expires_at) <= now().getTime()) {
+                        n.status = "uncertain";
+                        n.outcome = { disposition: "uncertain", error_code: "codex_native_callback_lease_expired", observed_at: now().toISOString() };
+                        continue;
+                    }
+                    if (backendObservationStopped(task) || !deps.deliver)
+                        continue;
+                    if (["ready", "retry_wait"].includes(n.status) && stale(task, n)) {
+                        n.status = "failed";
+                        n.outcome = { disposition: "permanent_failure", error_code: "codex_native_callback_stale" };
+                        delete n.retry_at;
+                        continue;
+                    }
+                    const decision = decideDurableNotificationRetry(n.status === "ready"
+                        ? { phase: "ready", attempt: n.attempts, maxAttempts: backendCallbackMaxAttempts(n, maxAttempts) - 1 }
+                        : n.status === "retry_wait"
+                            ? { phase: "retry_wait", attempt: n.attempts, maxAttempts: backendCallbackMaxAttempts(n, maxAttempts) - 1, nowMs: now().getTime(), retryAt: n.retry_at, retryAuthorized: true }
+                            : { phase: "settled", attempt: n.attempts });
+                    if (decision.state !== "retryable")
+                        continue;
+                    const lease = createDurableNotificationLease({ previousAttempts: n.attempts, attemptId: uuid(), attemptedAt: now().toISOString(),
+                        leaseBaseMs: now().getTime(), leaseMs: deps.deliveryLeaseMs ?? 30_000 });
+                    n.status = "leased";
+                    n.attempts = lease.attempt;
+                    n.attempt_id = lease.attemptId;
+                    n.lease_expires_at = lease.leaseExpiresAt;
+                    claimed = { task: structuredClone(task), notification: structuredClone(n) };
+                    break;
+                }
+            });
+            if (!claimed)
+                return;
+            const { task, notification: n } = claimed;
+            let outcome;
+            try {
+                const context = deps.resolveCallbackContext?.(task);
+                const current = deps.repository.load(id);
+                if (!current || backendObservationStopped(current) || stale(current, n)) {
+                    settle(id, n.id, n.attempt_id, { disposition: "permanent_failure", error_code: "codex_native_callback_stopped" });
+                    return;
+                }
+                outcome = parseCallbackAttemptOutcome(await deps.deliver({ route: task.callback_route, envelope: n.envelope,
+                    attempt: { number: n.attempts, id: n.attempt_id }, context,
+                    reportCheckpoint: checkpoint => {
+                        const parsed = parseCallbackAttemptOutcome(checkpoint);
+                        if (parsed.disposition === "accepted")
+                            settle(id, n.id, n.attempt_id, parsed);
+                    } }));
+            }
+            catch {
+                outcome = { disposition: "uncertain", error_code: "codex_native_callback_outcome_unknown", observed_at: now().toISOString() };
+            }
+            settle(id, n.id, n.attempt_id, outcome);
+        }
+    };
+}
+//# sourceMappingURL=codex-native-outbox.js.map

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

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

package/dist/src/codex-native-public-projection.d.ts

@@ -0,0 +1,545 @@
+import type { CodexNativeTaskRecord, PersistedNativeInteraction } from "./codex-native-state-store.js";
+import type { CodexNativeIdentity, CodexNativeSnapshot, CodexNativeTurn, NativeInteractionResponse } from "./codex-native-types.js";
+/** Keep native request projections separate from terminal screen-derived questionnaire contracts. */
+export declare function validateNativeInteractionProjections(value: unknown, conversationId: unknown, watchId?: unknown): unknown[];
+export declare function nativeInteractionProjection(interaction: PersistedNativeInteraction, conversationId: string, watchId?: string): {
+    watch_id: string;
+    conversation_id?: undefined;
+    interaction_id: string;
+    kind: "async_question" | "blocking_question" | "command_approval" | "file_approval";
+    status: string;
+    native_thread_id: string;
+    native_turn_id: string;
+    command?: string | undefined;
+    reason?: string | undefined;
+    network?: {
+        host: string;
+        protocol: string;
+    } | undefined;
+    cwd?: string | undefined;
+    file_changes?: {
+        path: string;
+        kind?: string;
+        diff?: string;
+        diffTruncated?: boolean;
+    }[] | undefined;
+    delivery_modes?: string[] | undefined;
+    questions: {
+        question_id: string;
+        title: string;
+        is_secret?: boolean | undefined;
+        response_kind: string;
+        allow_free_text: boolean;
+        options: {
+            option_id: string;
+            label: string;
+        }[];
+    }[];
+    available_actions: {
+        approve: {
+            tool: string;
+            input: {
+                watch_id: string;
+                conversation_id?: undefined;
+                interaction_id: string;
+            } | {
+                watch_id?: undefined;
+                conversation_id: string;
+                interaction_id: string;
+            };
+        };
+        respond?: undefined;
+    } | {
+        approve?: undefined;
+        respond: {
+            tool: string;
+            input: {
+                watch_id: string;
+                conversation_id?: undefined;
+                interaction_id: string;
+            } | {
+                watch_id?: undefined;
+                conversation_id: string;
+                interaction_id: string;
+            };
+        };
+    };
+} | {
+    watch_id?: undefined;
+    conversation_id: string;
+    interaction_id: string;
+    kind: "async_question" | "blocking_question" | "command_approval" | "file_approval";
+    status: string;
+    native_thread_id: string;
+    native_turn_id: string;
+    command?: string | undefined;
+    reason?: string | undefined;
+    network?: {
+        host: string;
+        protocol: string;
+    } | undefined;
+    cwd?: string | undefined;
+    file_changes?: {
+        path: string;
+        kind?: string;
+        diff?: string;
+        diffTruncated?: boolean;
+    }[] | undefined;
+    delivery_modes?: string[] | undefined;
+    questions: {
+        question_id: string;
+        title: string;
+        is_secret?: boolean | undefined;
+        response_kind: string;
+        allow_free_text: boolean;
+        options: {
+            option_id: string;
+            label: string;
+        }[];
+    }[];
+    available_actions: {
+        approve: {
+            tool: string;
+            input: {
+                watch_id: string;
+                conversation_id?: undefined;
+                interaction_id: string;
+            } | {
+                watch_id?: undefined;
+                conversation_id: string;
+                interaction_id: string;
+            };
+        };
+        respond?: undefined;
+    } | {
+        approve?: undefined;
+        respond: {
+            tool: string;
+            input: {
+                watch_id: string;
+                conversation_id?: undefined;
+                interaction_id: string;
+            } | {
+                watch_id?: undefined;
+                conversation_id: string;
+                interaction_id: string;
+            };
+        };
+    };
+};
+/** Resolve advertised opaque IDs against fresh native questions, never against labels supplied by a caller. */
+export declare function nativeQuestionResponse(interaction: PersistedNativeInteraction, value: unknown): NativeInteractionResponse;
+export declare function nativeTurnProjection(turn: CodexNativeTurn | undefined): {
+    id: string;
+    status: "completed" | "failed" | "inProgress" | "interrupted";
+    items_complete: boolean;
+    final_text: string;
+} | {
+    id: string;
+    status: "completed" | "failed" | "inProgress" | "interrupted";
+    items_complete: boolean;
+    response_text: string;
+} | null;
+export declare function codexNativeSessionProjection(identity: CodexNativeIdentity, snapshot: CodexNativeSnapshot, backendVersion: string, interactionsScanned?: boolean): {
+    id: string;
+    conversation_id: string;
+    source: string;
+    agent: string;
+    title: {};
+    cwd: string;
+    native_thread_id: string;
+    native_turn_id: string | null;
+    backend_version: string;
+    connection_state: string;
+    activity_state: "active" | "idle" | "notLoaded" | "systemError";
+    active_flags: ("waitingOnApproval" | "waitingOnUserInput")[];
+    interaction_requests_scanned: boolean;
+    pending_interaction_count: number | null;
+    attention_required: boolean;
+    capabilities: {
+        status: boolean;
+        send: boolean;
+        watch: boolean;
+        interaction_notify: boolean;
+        interaction_respond: boolean;
+        approve: boolean;
+        set_permissions: boolean;
+    };
+    interaction_state: ({
+        watch_id: string;
+        conversation_id?: undefined;
+        interaction_id: string;
+        kind: "async_question" | "blocking_question" | "command_approval" | "file_approval";
+        status: string;
+        native_thread_id: string;
+        native_turn_id: string;
+        command?: string | undefined;
+        reason?: string | undefined;
+        network?: {
+            host: string;
+            protocol: string;
+        } | undefined;
+        cwd?: string | undefined;
+        file_changes?: {
+            path: string;
+            kind?: string;
+            diff?: string;
+            diffTruncated?: boolean;
+        }[] | undefined;
+        delivery_modes?: string[] | undefined;
+        questions: {
+            question_id: string;
+            title: string;
+            is_secret?: boolean | undefined;
+            response_kind: string;
+            allow_free_text: boolean;
+            options: {
+                option_id: string;
+                label: string;
+            }[];
+        }[];
+        available_actions: {
+            approve: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+            respond?: undefined;
+        } | {
+            approve?: undefined;
+            respond: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+        };
+    } | {
+        watch_id?: undefined;
+        conversation_id: string;
+        interaction_id: string;
+        kind: "async_question" | "blocking_question" | "command_approval" | "file_approval";
+        status: string;
+        native_thread_id: string;
+        native_turn_id: string;
+        command?: string | undefined;
+        reason?: string | undefined;
+        network?: {
+            host: string;
+            protocol: string;
+        } | undefined;
+        cwd?: string | undefined;
+        file_changes?: {
+            path: string;
+            kind?: string;
+            diff?: string;
+            diffTruncated?: boolean;
+        }[] | undefined;
+        delivery_modes?: string[] | undefined;
+        questions: {
+            question_id: string;
+            title: string;
+            is_secret?: boolean | undefined;
+            response_kind: string;
+            allow_free_text: boolean;
+            options: {
+                option_id: string;
+                label: string;
+            }[];
+        }[];
+        available_actions: {
+            approve: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+            respond?: undefined;
+        } | {
+            approve?: undefined;
+            respond: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+        };
+    })[];
+    latest_turn: {
+        id: string;
+        status: "completed" | "failed" | "inProgress" | "interrupted";
+        items_complete: boolean;
+        final_text: string;
+    } | {
+        id: string;
+        status: "completed" | "failed" | "inProgress" | "interrupted";
+        items_complete: boolean;
+        response_text: string;
+    } | null;
+    available_actions: {
+        status: {
+            tool: string;
+            input: {
+                conversation_id: string;
+            };
+        };
+        send?: {
+            tool: string;
+            input: {
+                conversation_id: string;
+            };
+        } | undefined;
+        watch?: {
+            tool: string;
+            input: {
+                conversation_id: string;
+            };
+        } | undefined;
+        permission_options?: {
+            tool: string;
+            input: {
+                conversation_id: string;
+            };
+        } | undefined;
+    };
+};
+export declare function codexNativeTaskProjection(task: CodexNativeTaskRecord): {
+    task_kind: "send" | "watch";
+    turn_id?: string | undefined;
+    management_state: string;
+    observation_state: string;
+    deadline_at: string;
+    renewal_count: number;
+    closed_at: string | undefined;
+    close_reason: string | undefined;
+    unwatched_at: string | undefined;
+    renewed_at: string | undefined;
+    recovered_at: string | undefined;
+    callback_in_flight: boolean;
+    retryable_callback_ids: string[];
+    watch_id: string;
+    conversation_id: string;
+    source: string;
+    status: string;
+    observation_status: import("./codex-native-state-store.js").CodexNativeTaskStatus;
+    observation_active: boolean;
+    available_actions: {
+        recover?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        renew?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        unwatch?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        close?: {
+            tool: string;
+            input: {
+                turn_id: string;
+            };
+        } | undefined;
+        retry_callback?: {
+            tool: string;
+            input: {
+                watch_id: string;
+                notification_id: string;
+            };
+        } | undefined;
+    };
+    native_thread_id: string;
+    native_turn_id: string | null;
+    observation_mode: string;
+    anchor_state: string;
+    created_at: string;
+    updated_at: string;
+    observed_at: string | undefined;
+    observation_error: string | undefined;
+    final_text: string | undefined;
+    pending_interaction_count: number;
+    interaction_state: ({
+        watch_id: string;
+        conversation_id?: undefined;
+        interaction_id: string;
+        kind: "async_question" | "blocking_question" | "command_approval" | "file_approval";
+        status: string;
+        native_thread_id: string;
+        native_turn_id: string;
+        command?: string | undefined;
+        reason?: string | undefined;
+        network?: {
+            host: string;
+            protocol: string;
+        } | undefined;
+        cwd?: string | undefined;
+        file_changes?: {
+            path: string;
+            kind?: string;
+            diff?: string;
+            diffTruncated?: boolean;
+        }[] | undefined;
+        delivery_modes?: string[] | undefined;
+        questions: {
+            question_id: string;
+            title: string;
+            is_secret?: boolean | undefined;
+            response_kind: string;
+            allow_free_text: boolean;
+            options: {
+                option_id: string;
+                label: string;
+            }[];
+        }[];
+        available_actions: {
+            approve: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+            respond?: undefined;
+        } | {
+            approve?: undefined;
+            respond: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+        };
+    } | {
+        watch_id?: undefined;
+        conversation_id: string;
+        interaction_id: string;
+        kind: "async_question" | "blocking_question" | "command_approval" | "file_approval";
+        status: string;
+        native_thread_id: string;
+        native_turn_id: string;
+        command?: string | undefined;
+        reason?: string | undefined;
+        network?: {
+            host: string;
+            protocol: string;
+        } | undefined;
+        cwd?: string | undefined;
+        file_changes?: {
+            path: string;
+            kind?: string;
+            diff?: string;
+            diffTruncated?: boolean;
+        }[] | undefined;
+        delivery_modes?: string[] | undefined;
+        questions: {
+            question_id: string;
+            title: string;
+            is_secret?: boolean | undefined;
+            response_kind: string;
+            allow_free_text: boolean;
+            options: {
+                option_id: string;
+                label: string;
+            }[];
+        }[];
+        available_actions: {
+            approve: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+            respond?: undefined;
+        } | {
+            approve?: undefined;
+            respond: {
+                tool: string;
+                input: {
+                    watch_id: string;
+                    conversation_id?: undefined;
+                    interaction_id: string;
+                } | {
+                    watch_id?: undefined;
+                    conversation_id: string;
+                    interaction_id: string;
+                };
+            };
+        };
+    })[];
+    callback_configured: boolean;
+    callback_expected: boolean;
+    callback_notifications: {
+        id: string;
+        notification_id: string;
+        status: "accepted" | "failed" | "leased" | "ready" | "retry_wait" | "uncertain";
+        attempts: number;
+        error_code?: string | undefined;
+    }[];
+    capabilities: {
+        close: boolean;
+        renew: boolean;
+        recover: boolean;
+        retry_callback: boolean;
+        callback: boolean;
+        interaction_notify: boolean;
+        interaction_respond: boolean;
+        approve: boolean;
+    };
+    message_id?: string | undefined;
+    delivered?: boolean | undefined;
+    send_state?: "accepted" | "not_sent" | "reserved" | "uncertain" | undefined;
+    delivery_receipt?: string | undefined;
+    agent_acceptance?: string | undefined;
+    send_error?: string | undefined;
+    resend_allowed?: boolean | undefined;
+};