@scotthuang/agent-knock-knock 0.12.3 → 0.12.5

package/dist/src/deferred-foreground-transfer.d.ts

@@ -0,0 +1,112 @@
+import { type ManagedTerminalBinding } from "./managed-session.js";
+import { type TerminalControlEvidence } from "./terminal-control-ref.js";
+export declare const DEFERRED_FOREGROUND_TRANSFER_SCHEMA: "agent-knock-knock/deferred-foreground-transfer";
+export declare const DEFERRED_FOREGROUND_TRANSFER_VERSION: 1;
+export type DeferredForegroundTransferStatus = "prepared" | "source_reserved" | "target_prepared" | "dispatch_started" | "committed" | "resolved" | "aborted" | "abort_resolved" | "uncertain";
+export type DeferredForegroundTransferInputStage = "none" | "dispatch_started" | "text_injected" | "enter_dispatched" | "agent_accepted";
+/**
+ * Durable authority for replacing one status-card-only Codex Session with a
+ * fresh provisional Session around an ordinary task submission.
+ *
+ * This record deliberately lives outside native lifecycle transitions.  It
+ * never authorizes a slash command or terminal-input replay; the ordinary
+ * terminal dispatch ledger remains the sole transport receipt authority.
+ */
+export interface DeferredForegroundTransfer {
+    schema: typeof DEFERRED_FOREGROUND_TRANSFER_SCHEMA;
+    version: typeof DEFERRED_FOREGROUND_TRANSFER_VERSION;
+    transfer_id: string;
+    revision?: number;
+    status: DeferredForegroundTransferStatus;
+    input_stage: DeferredForegroundTransferInputStage;
+    terminal_id: string;
+    terminal_endpoint: TerminalControlEvidence;
+    process_pid: number;
+    process_uuid: string;
+    process_birth: string;
+    workspace: string;
+    source_session_id: string;
+    source_expected_revision: number;
+    source_binding_token: string;
+    source_previous_last_transition_id?: string;
+    source_before_binding: ManagedTerminalBinding;
+    target_session_id: string;
+    target_expected_revision: null;
+    previous_dispatch_status: "none" | "resolved";
+    previous_dispatch_fingerprint: string;
+    target_prepared_revision?: number;
+    target_prepared_status?: "transitioning";
+    target_prepared_last_transition_id?: string;
+    target_prepared_binding_token?: string;
+    target_before_binding?: ManagedTerminalBinding;
+    request_hash: string;
+    dispatcher_pid: number;
+    prepared_at: string;
+    source_reserved_at?: string;
+    target_prepared_at?: string;
+    dispatch_started_at?: string;
+    text_injected_at?: string;
+    enter_dispatched_at?: string;
+    agent_accepted_at?: string;
+    message_id?: string;
+    turn_id?: string;
+    state_path?: string;
+    target_native_thread_id?: string;
+    target_accepted_revision?: number;
+    target_accepted_status?: "transitioning";
+    target_accepted_binding_token?: string;
+    target_accepted_binding?: ManagedTerminalBinding;
+    source_pre_retirement_revision?: number;
+    source_pre_retirement_status?: "transitioning";
+    source_pre_retirement_binding_token?: string;
+    source_pre_retirement_binding?: ManagedTerminalBinding;
+    source_retirement?: "binding_retained" | "binding_scrubbed_same_native_thread";
+    committed_at?: string;
+    target_after_revision?: number;
+    target_after_status?: "bound";
+    target_after_binding_token?: string;
+    source_after_revision?: number;
+    source_after_binding?: ManagedTerminalBinding;
+    source_after_binding_token?: string;
+    source_after_status?: "detached";
+    resolved_at?: string;
+    aborted_at?: string;
+    terminal_input_not_started_at?: string;
+    abort_cleanup_completed_at?: string;
+    abort_source_after_revision?: number;
+    abort_source_after_status?: "bound";
+    abort_source_after_binding_token?: string;
+    abort_source_after_binding?: ManagedTerminalBinding;
+    abort_target_after_status?: "absent" | "detached";
+    abort_target_after_revision?: number;
+    abort_target_after_binding_token?: string;
+    abort_target_after_binding?: ManagedTerminalBinding;
+    uncertain_at?: string;
+    recovered_at?: string;
+    error?: string;
+    do_not_retry?: boolean;
+}
+export interface DeferredForegroundTransferSaveOptions {
+    /** `null` means create-only; a number is the exact revision to replace. */
+    expectedRevision: number | null;
+}
+export declare class DeferredForegroundTransferConflictError extends Error {
+    readonly code = "AKK_DEFERRED_FOREGROUND_TRANSFER_CONFLICT";
+    readonly transferId: string;
+    readonly expectedRevision: number | null;
+    readonly actualRevision: number | null;
+    constructor(transferId: string, expectedRevision: number | null, actualRevision: number | null, detail?: string);
+}
+export declare function createDeferredForegroundTransferId(): string;
+export declare function deferredForegroundTransfersDir(storeDir: string): string;
+export declare function pathsForDeferredForegroundTransfer(transferId: string, storeDir: string): {
+    directory: string;
+    statePath: string;
+};
+export declare function assertDeferredForegroundTransfer(value: unknown, expectedTransferId?: string, options?: {
+    allowMissingRevision?: boolean;
+}): asserts value is DeferredForegroundTransfer;
+export declare function saveDeferredForegroundTransfer(storeDir: string, value: DeferredForegroundTransfer, options: DeferredForegroundTransferSaveOptions): DeferredForegroundTransfer;
+export declare function loadDeferredForegroundTransfer(storeDir: string, transferId: string): DeferredForegroundTransfer;
+export declare function tryLoadDeferredForegroundTransfer(storeDir: string, transferId: string): DeferredForegroundTransfer | undefined;
+export declare function listDeferredForegroundTransfers(storeDir: string): DeferredForegroundTransfer[];