@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/deferred-foreground-preparation-service.d.ts

@@ -0,0 +1,72 @@
+import type { CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
+import type { DeferredForegroundApplicationScope, DeferredForegroundBindingBoundary, DeferredForegroundDispatchSnapshot, DeferredForegroundTerminalFacts } from "./deferred-foreground-boundary.js";
+import { type DeferredForegroundTransfer, type DeferredForegroundTransferSourceKind, type DeferredForegroundTransferSourceRolloutAuthority, type DeferredForegroundTransferSourceTurnAuthority } from "./deferred-foreground-transfer.js";
+import { type ManagedSessionState } from "./managed-session.js";
+import type { CodexCandidateSetRolloutAcceptanceAnchor } from "./terminal-submission-acceptance.js";
+export interface DeferredForegroundFreshAuthority {
+    sourceKind: DeferredForegroundTransferSourceKind;
+    sourceRolloutAuthority: DeferredForegroundTransferSourceRolloutAuthority;
+    sourceTurnHistory?: DeferredForegroundTransferSourceTurnAuthority[];
+    dispatchSnapshot?: DeferredForegroundDispatchSnapshot;
+    sourceAbandonmentFingerprint?: string;
+    exactSource: boolean;
+}
+export interface DeferredForegroundPreparationRequest {
+    scope: DeferredForegroundApplicationScope;
+    terminal: DeferredForegroundTerminalFacts;
+    sourceSession?: ManagedSessionState;
+    nativeIdentityVerifiedAbsent: boolean;
+    candidateInventory?: CodexOpenRootRolloutInventory;
+    requestText: string;
+    expectedTerminalToken?: string;
+    allowImplicitFreshAuthority: boolean;
+}
+export interface DeferredForegroundPreparationPorts {
+    authority: {
+        processIncarnation(pid: number): {
+            processUuid: string;
+            processBirth: string;
+        };
+        observeFresh(input: {
+            sourceSession: ManagedSessionState;
+            candidateInventory?: CodexOpenRootRolloutInventory;
+            liveIncarnation: {
+                processUuid: string;
+                processBirth: string;
+            };
+        }): DeferredForegroundFreshAuthority | undefined;
+        revalidate(scope: DeferredForegroundApplicationScope, boundary: DeferredForegroundBindingBoundary): Promise<void>;
+        assertExclusive(scope: DeferredForegroundApplicationScope, boundary: DeferredForegroundBindingBoundary, nativeThreadId: string, excludedManagedSessionId?: string): Promise<void>;
+        candidateInventoryUnclaimed(input: {
+            sourceSession: ManagedSessionState;
+            inventory: CodexOpenRootRolloutInventory;
+            includeDetached: boolean;
+        }): boolean;
+        abandonmentStillFresh(input: {
+            sourceSession: ManagedSessionState;
+            sourceTurnHistory?: DeferredForegroundTransferSourceTurnAuthority[];
+            sourceAbandonmentFingerprint?: string;
+            dispatchSnapshot: DeferredForegroundDispatchSnapshot;
+        }): boolean;
+        transferMatchesTerminal(transfer: DeferredForegroundTransfer): boolean;
+    };
+    identity: {
+        targetSessionId(): string;
+        transferId(): string;
+        captureCandidateAnchor(inventory: CodexOpenRootRolloutInventory, now: Date): CodexCandidateSetRolloutAcceptanceAnchor;
+        bindingToken(input: {
+            sourceSession: ManagedSessionState;
+            authority: DeferredForegroundFreshAuthority;
+            candidateInventory?: CodexOpenRootRolloutInventory;
+        }): string;
+        requestHash(requestText: string): string;
+    };
+    runtime: {
+        now(): Date;
+        pid(): number;
+        log(level: "info" | "warn" | "error", event: string, fields: {
+            [key: string]: unknown;
+        }): void;
+    };
+}
+export declare function prepareDeferredForegroundBinding(request: DeferredForegroundPreparationRequest, ports: DeferredForegroundPreparationPorts): Promise<DeferredForegroundBindingBoundary | undefined>;

package/dist/src/deferred-foreground-preparation-service.js

@@ -0,0 +1,179 @@
+import { isFinalDeferredForegroundTransferStatus } from "./deferred-foreground-transfer-policy.js";
+import { managedSessionBindingToken, managedSessionRevision } from "./managed-session.js";
+import { isCompleteNativeRollout } from "./terminal-authority-policy.js";
+export async function prepareDeferredForegroundBinding(request, ports) {
+    const source = request.sourceSession;
+    const candidateMode = Boolean(request.candidateInventory?.roots.length);
+    if (!eligible(request, source, candidateMode))
+        return undefined;
+    assertImplicitAuthority(request, source, candidateMode);
+    const processUuid = source.binding.native_process.process_uuid;
+    const processBirth = source.binding.native_process.process_birth;
+    const workspace = request.terminal.workspace;
+    const liveIncarnation = ports.authority.processIncarnation(request.terminal.pid);
+    const authority = ports.authority.observeFresh({
+        sourceSession: source,
+        candidateInventory: request.candidateInventory,
+        liveIncarnation
+    });
+    if (!processUuid || !processBirth || !workspace ||
+        !request.terminal.canonicalEndpoint || !request.terminal.endpoint ||
+        !authority?.exactSource || !authority.dispatchSnapshot ||
+        (authority.sourceRolloutAuthority ===
+            "explicitly_abandoned_predecessor" &&
+            !authority.sourceAbandonmentFingerprint)) {
+        return undefined;
+    }
+    const token = ports.identity.bindingToken({
+        sourceSession: source,
+        authority,
+        ...(candidateMode ? { candidateInventory: request.candidateInventory } : {})
+    });
+    if (!request.allowImplicitFreshAuthority &&
+        request.expectedTerminalToken !== token) {
+        throw new Error("deferred Codex foreground binding requires the fresh exact terminal " +
+            "token advertised by AKK list");
+    }
+    logImplicitAuthority(request, source, ports);
+    const boundary = buildBoundary(request, source, authority, ports);
+    await revalidateBeforePublication(request, boundary, source, authority, ports);
+    assertNoExistingTransfer(request, source, ports);
+    request.scope.saveTransfer({
+        schema: "agent-knock-knock/deferred-foreground-transfer",
+        version: 2,
+        transfer_id: boundary.transferId,
+        status: "prepared",
+        input_stage: "none",
+        terminal_id: request.terminal.conversationId,
+        terminal_endpoint: request.terminal.endpoint,
+        process_pid: request.terminal.pid,
+        process_uuid: processUuid,
+        process_birth: processBirth,
+        workspace,
+        source_session_id: source.session_id,
+        source_expected_revision: managedSessionRevision(source),
+        source_binding_token: managedSessionBindingToken(source),
+        source_previous_last_transition_id: source.last_transition_id,
+        source_before_binding: source.binding,
+        source_kind: authority.sourceKind,
+        ...(authority.sourceRolloutAuthority ===
+            "explicitly_abandoned_predecessor"
+            ? { source_rollout_authority: authority.sourceRolloutAuthority }
+            : {}),
+        ...(authority.sourceAbandonmentFingerprint
+            ? { source_abandonment_fingerprint: authority.sourceAbandonmentFingerprint }
+            : {}),
+        ...(authority.sourceTurnHistory
+            ? { source_turn_history: authority.sourceTurnHistory }
+            : {}),
+        target_session_id: boundary.targetSessionId,
+        target_expected_revision: null,
+        previous_dispatch_status: authority.dispatchSnapshot.status,
+        previous_dispatch_fingerprint: authority.dispatchSnapshot.fingerprint,
+        request_hash: ports.identity.requestHash(request.requestText),
+        dispatcher_pid: ports.runtime.pid(),
+        prepared_at: ports.runtime.now().toISOString()
+    }, null);
+    return boundary;
+}
+function eligible(request, source, candidateMode) {
+    return request.terminal.agent === "codex" && Boolean(source?.binding) &&
+        (request.nativeIdentityVerifiedAbsent || candidateMode) &&
+        Boolean(request.expectedTerminalToken || request.allowImplicitFreshAuthority);
+}
+function assertImplicitAuthority(request, source, candidateMode) {
+    if (request.allowImplicitFreshAuthority &&
+        (request.expectedTerminalToken !== undefined || !candidateMode ||
+            !isCompleteNativeRollout(source.binding?.native_process.rollout))) {
+        throw new Error("implicit Codex candidate authority requires one fresh complete " +
+            "nonempty rollout inventory for a rollout-backed source");
+    }
+}
+function buildBoundary(request, source, authority, ports) {
+    const targetSessionId = ports.identity.targetSessionId();
+    const transferId = ports.identity.transferId();
+    const inventory = request.candidateInventory;
+    const candidateAcceptanceAnchor = inventory?.roots.length
+        ? ports.identity.captureCandidateAnchor(inventory, ports.runtime.now())
+        : undefined;
+    return {
+        terminal: request.terminal,
+        transferId,
+        targetSessionId,
+        sourceSessionId: source.session_id,
+        sourceBoundRevision: managedSessionRevision(source),
+        sourceBoundBindingToken: managedSessionBindingToken(source),
+        processUuid: source.binding.native_process.process_uuid,
+        processBirth: source.binding.native_process.process_birth,
+        previousDispatchSnapshot: authority.dispatchSnapshot,
+        sourceKind: authority.sourceKind,
+        sourceRolloutAuthority: authority.sourceRolloutAuthority,
+        ...(authority.sourceAbandonmentFingerprint
+            ? { sourceAbandonmentFingerprint: authority.sourceAbandonmentFingerprint }
+            : {}),
+        ...(source.last_transition_id
+            ? { sourcePreviousLastTransitionId: source.last_transition_id }
+            : {}),
+        ...(authority.sourceTurnHistory
+            ? { sourceTurnHistory: authority.sourceTurnHistory }
+            : {}),
+        ...(candidateAcceptanceAnchor ? { candidateAcceptanceAnchor } : {})
+    };
+}
+async function revalidateBeforePublication(request, boundary, source, authority, ports) {
+    await ports.authority.revalidate(request.scope, boundary);
+    await ports.authority.assertExclusive(request.scope, boundary, source.binding.native_thread_id, source.session_id);
+    const inventory = request.candidateInventory;
+    if (inventory && !ports.authority.candidateInventoryUnclaimed({
+        sourceSession: source,
+        inventory,
+        includeDetached: authority.sourceRolloutAuthority ===
+            "explicitly_abandoned_predecessor"
+    })) {
+        throw new Error("a Codex rollout candidate is already claimed by another Session");
+    }
+    if (inventory && authority.sourceRolloutAuthority ===
+        "explicitly_abandoned_predecessor") {
+        for (const root of inventory.roots) {
+            await ports.authority.assertExclusive(request.scope, boundary, root.sessionId, root.sessionId.toLowerCase() ===
+                source.binding.native_thread_id?.toLowerCase()
+                ? source.session_id
+                : undefined);
+        }
+    }
+    if (authority.sourceRolloutAuthority ===
+        "explicitly_abandoned_predecessor" &&
+        !ports.authority.abandonmentStillFresh({
+            sourceSession: source,
+            sourceTurnHistory: authority.sourceTurnHistory,
+            sourceAbandonmentFingerprint: authority.sourceAbandonmentFingerprint,
+            dispatchSnapshot: authority.dispatchSnapshot
+        })) {
+        throw new Error("the explicitly abandoned Codex predecessor authority changed; " +
+            "refresh AKK list");
+    }
+}
+function assertNoExistingTransfer(request, source, ports) {
+    const existing = request.scope.listTransfers().find((candidate) => !isFinalDeferredForegroundTransferStatus(candidate.status) &&
+        (candidate.source_session_id === source.session_id ||
+            ports.authority.transferMatchesTerminal(candidate)));
+    if (existing) {
+        throw new Error(`deferred foreground transfer ${existing.transfer_id} is still ` +
+            `${existing.status}; refresh AKK list before sending`);
+    }
+}
+function logImplicitAuthority(request, source, ports) {
+    if (!request.allowImplicitFreshAuthority)
+        return;
+    ports.runtime.log("info", "deferred_codex_implicit_candidate_authority", {
+        terminal_id: request.terminal.conversationId,
+        terminal_target: request.terminal.target,
+        source_session_id: source.session_id,
+        inventory_status: request.candidateInventory?.status,
+        inventory_fingerprint: request.candidateInventory?.inventoryFingerprint,
+        candidate_count: request.candidateInventory?.roots.length,
+        authority_scope: "terminal_follow_current",
+        terminal_input_sent: false
+    });
+}
+//# sourceMappingURL=deferred-foreground-preparation-service.js.map

package/dist/src/deferred-foreground-preparation-service.js.map

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

package/dist/src/deferred-foreground-recovery-cli-adapter.d.ts

@@ -0,0 +1,139 @@
+import type { CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
+import type { DeferredForegroundApplicationScope } from "./deferred-foreground-boundary.js";
+import type { DeferredForegroundTransfer } from "./deferred-foreground-transfer.js";
+import { type ManagedSessionState } from "./managed-session.js";
+import { type Conversation } from "./protocol.js";
+import type { TerminalControlRef } from "./terminal-agent-adapter.js";
+import type { TerminalNativeIdentity as NativeAgentSessionIdentity } from "./terminal-binding-authority.js";
+import type { DeferredCodexForegroundBindingBoundary, TerminalDispatchTerminal } from "./terminal-dispatch-composition.js";
+import { type TerminalBridgeSubmissionMutation } from "./terminal-dispatch-receipt.js";
+import { type CodexRolloutAcceptanceAnchor } from "./terminal-submission-acceptance.js";
+export interface DeferredForegroundRecoveryAdapterPorts {
+    native: {
+        processIncarnation(pid: number): {
+            processUuid: string;
+            processBirth: string;
+        };
+        inventory(input: {
+            options: Record<string, any>;
+            pid: number;
+            cwd?: string;
+        }): Promise<CodexOpenRootRolloutInventory>;
+        identity(input: {
+            options: Record<string, any>;
+            agent: "codex";
+            pid: number;
+            cwd?: string;
+        }): Promise<NativeAgentSessionIdentity | undefined>;
+    };
+    turn: {
+        terminalControl(value: unknown): TerminalControlRef | undefined;
+        storeDir(conversation: Conversation): string | undefined;
+        withIdentity(conversation: Conversation, identity: NativeAgentSessionIdentity): Conversation;
+        withSubmission(mutation: TerminalBridgeSubmissionMutation): Conversation;
+    };
+    ledger: {
+        load(control: TerminalControlRef): Record<string, any> | undefined;
+        save(control: TerminalControlRef, ledger: Record<string, unknown>): void;
+        matchesControl(ledger: Record<string, any> | undefined, control: TerminalControlRef): boolean;
+        bindingFields(conversation: Conversation): Record<string, unknown>;
+        previousSnapshotMatches(input: {
+            transfer: DeferredForegroundTransfer;
+            terminalControl: TerminalControlRef;
+            ledger: Record<string, any> | undefined;
+        }): boolean;
+    };
+    authority: {
+        assertFrozen(input: {
+            storeDir: string;
+            transfer: DeferredForegroundTransfer;
+            terminalControl: TerminalControlRef;
+        }): void;
+        assertTurnIdentity(input: {
+            conversation: Conversation;
+            currentIdentity: NativeAgentSessionIdentity;
+            operation: string;
+        }): void;
+    };
+    application: {
+        abortBeforeInput(input: {
+            options: Record<string, any>;
+            scope: DeferredForegroundApplicationScope;
+            boundary: DeferredCodexForegroundBindingBoundary;
+            reason: string;
+            terminalInputNotStartedAt?: string;
+        }): void;
+        commit(input: {
+            options: Record<string, any>;
+            scope: DeferredForegroundApplicationScope;
+            boundary: DeferredCodexForegroundBindingBoundary;
+            identity: NativeAgentSessionIdentity;
+            acceptedAt: string;
+        }): Promise<ManagedSessionState>;
+    };
+}
+interface DeferredForegroundTurnAuthority {
+    conversation: Conversation;
+    statePath: string;
+    logPath: string;
+    takeover: Record<string, any>;
+    submission: Record<string, any>;
+    anchor: CodexRolloutAcceptanceAnchor;
+}
+export declare function deferredCodexBoundaryFromTransfer(ports: DeferredForegroundRecoveryAdapterPorts, { terminal, transfer }: {
+    terminal: TerminalDispatchTerminal;
+    transfer: DeferredForegroundTransfer;
+}): DeferredCodexForegroundBindingBoundary;
+export declare function loadDeferredForegroundTurnAuthority(ports: DeferredForegroundRecoveryAdapterPorts, { storeDir, terminal, transfer, scope }: {
+    storeDir: string;
+    terminal: TerminalDispatchTerminal;
+    transfer: DeferredForegroundTransfer;
+    scope?: DeferredForegroundApplicationScope;
+}): DeferredForegroundTurnAuthority;
+export declare function assertDeferredForegroundLedgerAuthority(ports: DeferredForegroundRecoveryAdapterPorts, { storeDir, terminal, transfer, ledger, statePath, expectedMessageBodyHash }: {
+    storeDir: string;
+    terminal: Pick<TerminalDispatchTerminal, "terminalControl">;
+    transfer: DeferredForegroundTransfer;
+    ledger: Record<string, any>;
+    statePath: string;
+    expectedMessageBodyHash?: string;
+}): void;
+export declare function assertDeferredForegroundResolvedZeroInputLedger(ports: DeferredForegroundRecoveryAdapterPorts, { storeDir, terminal, transfer, ledger, statePath }: {
+    storeDir: string;
+    terminal: Pick<TerminalDispatchTerminal, "terminalControl">;
+    transfer: DeferredForegroundTransfer;
+    ledger: Record<string, any>;
+    statePath: string;
+}): void;
+export declare function deferredCodexDurableInputNotStartedAt(_ports: DeferredForegroundRecoveryAdapterPorts, scope: DeferredForegroundApplicationScope, transfer: DeferredForegroundTransfer): string | undefined;
+interface AbortPreparedDeferredTurnInput {
+    options: Record<string, any>;
+    scope: DeferredForegroundApplicationScope;
+    storeDir: string;
+    terminal: TerminalDispatchTerminal;
+    transfer: DeferredForegroundTransfer;
+    boundary: DeferredCodexForegroundBindingBoundary;
+    terminalInputNotStartedAt?: string;
+}
+export declare function abortPreparedDeferredForegroundTurn(ports: DeferredForegroundRecoveryAdapterPorts, input: AbortPreparedDeferredTurnInput): void;
+interface RecoverAcceptedDeferredDispatchInput {
+    options: Record<string, any>;
+    scope: DeferredForegroundApplicationScope;
+    storeDir: string;
+    terminal: TerminalDispatchTerminal;
+    transfer: DeferredForegroundTransfer;
+    boundary: DeferredCodexForegroundBindingBoundary;
+}
+export declare function recoverAcceptedDeferredForegroundDispatch(ports: DeferredForegroundRecoveryAdapterPorts, input: RecoverAcceptedDeferredDispatchInput): Promise<boolean>;
+interface PersistCommittedAcceptanceInput {
+    options: Record<string, any>;
+    scope: DeferredForegroundApplicationScope;
+    storeDir: string;
+    terminal: TerminalDispatchTerminal;
+    transfer: DeferredForegroundTransfer;
+}
+export declare function persistCommittedDeferredForegroundTurnAcceptance(ports: DeferredForegroundRecoveryAdapterPorts, input: PersistCommittedAcceptanceInput): Promise<{
+    conversation: Conversation;
+    identity: NativeAgentSessionIdentity;
+}>;
+export {};