@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/terminal-dispatch-capability.js

@@ -0,0 +1,133 @@
+import path from "node:path";
+import { sameTerminalControlIncarnation, terminalEndpointFromControlRef, terminalRuntimeResourceKey } from "./terminal-control-ref.js";
+import { canonicalMutationResource, capabilityGatedRepositoryOperation } from "./mutation-transaction.js";
+const bindTerminal = capabilityGatedRepositoryOperation(["terminal", "storeWriter", "state"], "terminal", (terminalControl) => terminalControl);
+const bindStore = capabilityGatedRepositoryOperation(["terminal", "storeWriter", "state"], "storeWriter", (storeDir) => storeDir);
+const bindTerminalWriterStore = capabilityGatedRepositoryOperation(["terminal", "storeWriter"], "storeWriter", (storeDir) => storeDir);
+const bindState = capabilityGatedRepositoryOperation(["terminal", "storeWriter", "state"], "state", (resource) => resource);
+export function bindTerminalDispatchRoute(scopes, resources) {
+    const terminalControl = bindTerminal(scopes, resources);
+    const storeDir = bindStore(scopes, resources);
+    const state = bindState(scopes, resources);
+    if (typeof resources.terminal.key !== "string" ||
+        resources.terminal.key.trim() === "" ||
+        !terminalIncarnationMatches(terminalControl, terminalControl) ||
+        !terminalResourceKeyMatches(resources.terminal.key, terminalControl)) {
+        throw new Error("terminal dispatch terminal resource is invalid");
+    }
+    if (typeof storeDir !== "string") {
+        throw new Error("terminal dispatch Store resource is invalid");
+    }
+    const canonicalStoreDir = path.resolve(storeDir);
+    if (storeDir !== canonicalStoreDir ||
+        resources.storeWriter.key !== canonicalStoreDir) {
+        throw new Error("terminal dispatch Store resource key and value do not match");
+    }
+    if (typeof state?.statePath !== "string" ||
+        typeof state?.logPath !== "string") {
+        throw new Error("terminal dispatch state resource is invalid");
+    }
+    const canonicalState = terminalDispatchStateResourceForStore(canonicalStoreDir, state.statePath, state.logPath);
+    if (resources.state.key !== canonicalState.key ||
+        state.statePath !== canonicalState.value.statePath ||
+        state.logPath !== canonicalState.value.logPath) {
+        throw new Error("terminal dispatch state resource key and value do not match");
+    }
+    return Object.freeze({
+        terminalControl,
+        terminalKey: resources.terminal.key,
+        storeDir: canonicalStoreDir,
+        statePath: canonicalState.value.statePath,
+        logPath: canonicalState.value.logPath
+    });
+}
+export function assertTerminalDispatchRouteMatches(route, expected) {
+    const expectedState = terminalDispatchStateResourceForStore(expected.storeDir, expected.statePath, expected.logPath).value;
+    if (route.terminalKey !== expected.terminalKey ||
+        !terminalIncarnationMatches(route.terminalControl, expected.terminalControl) ||
+        route.storeDir !== path.resolve(expected.storeDir) ||
+        route.statePath !== expectedState.statePath ||
+        route.logPath !== expectedState.logPath) {
+        throw new Error("terminal dispatch operation escaped its exact mutation route");
+    }
+}
+export function withExactTerminalDispatchRoute(route, expected, operation) {
+    assertTerminalDispatchRouteMatches(route, expected);
+    return operation(route);
+}
+function terminalIncarnationMatches(active, expected) {
+    try {
+        const activePid = Number(terminalEndpointFromControlRef(active).processAnchorPid);
+        const expectedPid = Number(terminalEndpointFromControlRef(expected).processAnchorPid);
+        return Number.isSafeInteger(activePid) && activePid > 1 &&
+            Number.isSafeInteger(expectedPid) && expectedPid > 1 &&
+            sameTerminalControlIncarnation(active, expected);
+    }
+    catch {
+        return false;
+    }
+}
+function terminalResourceKeyMatches(key, terminalControl) {
+    try {
+        return key === terminalRuntimeResourceKey(terminalControl);
+    }
+    catch {
+        return false;
+    }
+}
+export function terminalDispatchStateMutationResource(scopes, resources, statePath, logPath) {
+    const storeDir = bindTerminalWriterStore(scopes, resources);
+    if (typeof storeDir !== "string") {
+        throw new Error("terminal dispatch Store resource is invalid");
+    }
+    const canonicalStoreDir = path.resolve(storeDir);
+    if (storeDir !== canonicalStoreDir ||
+        resources.storeWriter.key !== canonicalStoreDir) {
+        throw new Error("terminal dispatch Store resource is not canonical");
+    }
+    return terminalDispatchStateResourceForStore(canonicalStoreDir, statePath, logPath);
+}
+export function terminalDispatchStateResourceForStore(storeDir, statePath, logPath) {
+    const canonicalStoreDir = path.resolve(storeDir);
+    const canonicalStatePath = path.resolve(statePath);
+    const conversationDir = path.dirname(canonicalStatePath);
+    if (path.basename(canonicalStatePath) !== "state.json" ||
+        path.dirname(conversationDir) !==
+            path.join(canonicalStoreDir, "conversations")) {
+        throw new Error("terminal dispatch state does not belong to the active Store");
+    }
+    const canonicalLogPath = path.resolve(logPath);
+    if (canonicalLogPath !== path.join(conversationDir, "events.ndjson")) {
+        throw new Error("terminal dispatch event log does not match its conversation state");
+    }
+    const route = Object.freeze({
+        statePath: canonicalStatePath,
+        logPath: canonicalLogPath
+    });
+    return canonicalMutationResource(canonicalStatePath, route);
+}
+export function terminalDispatchStateLockPath(resource) {
+    return `${resource.value.statePath}.lock`;
+}
+export function bindTerminalDispatchCapabilities({ scopes, resources, repositories, local }) {
+    bindTerminalDispatchRoute(scopes, resources);
+    return {
+        applicationPorts: {
+            synchronizeStageProgress: local.synchronizeStageProgress,
+            state: {
+                save: (conversation) => repositories.state.save(scopes, resources, conversation)
+            },
+            ledger: {
+                save: (ledger, phase) => repositories.ledger.save(scopes, resources, ledger, phase),
+                restore: (reason, at) => repositories.ledger.restore(scopes, resources, reason, at)
+            },
+            audit: {
+                append: (event) => repositories.audit.append(scopes, resources, event),
+                appendPreparedMessage: () => repositories.audit.appendPreparedMessage(scopes, resources),
+                ...local.audit
+            },
+            rollbackBeforeInput: () => repositories.rollbackBeforeInput(scopes, resources)
+        }
+    };
+}
+//# sourceMappingURL=terminal-dispatch-capability.js.map

package/dist/src/terminal-dispatch-capability.js.map

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

package/dist/src/terminal-dispatch-completion-cli-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { TerminalCompletionEvidence, TerminalDurableCompletionRequest } from "./terminal-agent-adapter.js";
+export type TerminalCompletionTurn = Readonly<Record<string, unknown>>;
+export interface TerminalDispatchCompletionEnvironment {
+    syntheticTerminalAcceptanceAllowed(): boolean;
+}
+export interface ExactBoundCodexCompletionInput {
+    conversation: TerminalCompletionTurn;
+    nativeTakeover?: Readonly<Record<string, unknown>>;
+    request: TerminalDurableCompletionRequest;
+    runtime?: Readonly<Record<string, unknown>>;
+}
+export interface TerminalDispatchCompletionCliAdapter {
+    requiresExactBoundCodexCompletion(conversation: TerminalCompletionTurn): boolean;
+    detectExactBoundCodexCompletion(input: ExactBoundCodexCompletionInput): {
+        handled: boolean;
+        completion?: TerminalCompletionEvidence;
+    };
+}
+/** Keep exact-rollout completion policy behind one command-scoped boundary. */
+export declare function createTerminalDispatchCompletionCliAdapter(input: {
+    environment: TerminalDispatchCompletionEnvironment;
+}): TerminalDispatchCompletionCliAdapter;

package/dist/src/terminal-dispatch-completion-cli-adapter.js

@@ -0,0 +1,96 @@
+import { terminalBridgeSubmission } from "./terminal-dispatch-receipt.js";
+import { detectCodexBoundRolloutCompletion } from "./terminal-submission-acceptance.js";
+import { isRecord, nonBlankString } from "./value-guards.js";
+/** Keep exact-rollout completion policy behind one command-scoped boundary. */
+export function createTerminalDispatchCompletionCliAdapter(input) {
+    const requiresExactBoundCodexCompletion = (conversation) => requiresExactBound(input.environment, conversation);
+    return Object.freeze({
+        requiresExactBoundCodexCompletion,
+        detectExactBoundCodexCompletion: (request) => detectExactBound(request, requiresExactBoundCodexCompletion)
+    });
+}
+function requiresExactBound(environment, conversation) {
+    const submission = terminalBridgeSubmission(conversation);
+    if (submission?.status !== "agent_accepted") {
+        return false;
+    }
+    const nativeTakeover = isRecord(conversation.native_session_takeover)
+        ? conversation.native_session_takeover
+        : undefined;
+    const modernProductionTurn = Number(nativeTakeover?.terminal_agent_identity_protocol) === 1 &&
+        !environment.syntheticTerminalAcceptanceAllowed();
+    if (modernProductionTurn) {
+        return true;
+    }
+    return isRecord(nativeTakeover?.codex_rollout_acceptance_anchor) &&
+        isRecord(submission.acceptance_evidence) &&
+        submission.acceptance_evidence.source === "codex_rollout";
+}
+function detectExactBound(input, requiresExactBoundCodexCompletion) {
+    const submission = terminalBridgeSubmission(input.conversation);
+    if (submission?.status !== "agent_accepted") {
+        return { handled: false };
+    }
+    if (!requiresExactBoundCodexCompletion(input.conversation)) {
+        return { handled: false };
+    }
+    const acceptanceEvidence = isRecord(submission.acceptance_evidence)
+        ? submission.acceptance_evidence
+        : undefined;
+    if (acceptanceEvidence?.source !== "codex_rollout") {
+        throw new Error("[codex_exact_bound_rollout:invalid_acceptance_evidence] " +
+            "the accepted modern Codex Turn has no exact rollout acceptance evidence");
+    }
+    const anchor = isRecord(input.nativeTakeover?.codex_rollout_acceptance_anchor)
+        ? input.nativeTakeover.codex_rollout_acceptance_anchor
+        : undefined;
+    if (!anchor) {
+        throw new Error("[codex_exact_bound_rollout:invalid_anchor] " +
+            "the accepted modern Codex Turn has no exact rollout byte anchor");
+    }
+    return exactBoundResult(input, anchor, acceptanceEvidence);
+}
+function exactBoundResult(input, anchor, acceptanceEvidence) {
+    const nativeRollout = isRecord(input.runtime?.nativeRollout)
+        ? input.runtime.nativeRollout
+        : undefined;
+    const result = detectCodexBoundRolloutCompletion({
+        anchor: anchor,
+        acceptanceEvidence: acceptanceEvidence,
+        currentIdentity: {
+            sessionId: nonBlankString(input.runtime?.nativeSessionId) ??
+                nonBlankString(input.runtime?.sessionId) ??
+                "",
+            processUuid: nonBlankString(input.runtime?.nativeProcessUuid),
+            processBirth: nonBlankString(input.runtime?.nativeProcessBirth),
+            ...(nativeRollout ? { rollout: {
+                    fd: String(nativeRollout.fd ?? ""),
+                    device: String(nativeRollout.device ?? ""),
+                    inode: String(nativeRollout.inode ?? ""),
+                    path: String(nativeRollout.path ?? "")
+                } } : {})
+        },
+        requestHash: nonBlankString(input.request.requestHash) ??
+            nonBlankString(input.nativeTakeover?.terminal_bridge_request_hash) ??
+            ""
+    });
+    if (result.status === "failure") {
+        throw new Error(`[codex_exact_bound_rollout:${result.diagnostics.code}] ${result.diagnostics.detail ??
+            "the exact bound rollout is not safely inspectable"}`);
+    }
+    if (result.status === "pending") {
+        return { handled: true };
+    }
+    return {
+        handled: true,
+        completion: {
+            ...result.completion,
+            metadata: {
+                ...result.completion.metadata,
+                context_match: "exact_bound_rollout",
+                detector_code: result.diagnostics.code
+            }
+        }
+    };
+}
+//# sourceMappingURL=terminal-dispatch-completion-cli-adapter.js.map

package/dist/src/terminal-dispatch-completion-cli-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-dispatch-completion-cli-adapter.js","sourceRoot":"","sources":["../../src/terminal-dispatch-completion-cli-adapter.ts"],"names":[],"mappings":"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"}

package/dist/src/terminal-dispatch-composition.d.ts

@@ -0,0 +1,79 @@
+import type { DeferredForegroundTransferSourceKind, DeferredForegroundTransferSourceRolloutAuthority, DeferredForegroundTransferSourceTurnAuthority } from "./deferred-foreground-transfer.js";
+import type { NativeThreadTransition } from "./managed-session.js";
+import type { CanonicalStateMutationResources, CanonicalStateMutationScopes } from "./mutation-transaction.js";
+import type { AgentMessage, Conversation, Executor } from "./protocol.js";
+import type { ExecutorKind } from "./executors.js";
+import type { TerminalControlRef } from "./terminal-agent-adapter.js";
+import type { CodexPreMaterializationIdentity } from "./terminal-authority-policy.js";
+import type { BoundTerminalDispatchRoute } from "./terminal-dispatch-capability.js";
+import type { CodexCandidateSetRolloutAcceptanceAnchor } from "./terminal-submission-facts.js";
+export interface DeferredCodexForegroundDispatchSnapshot {
+    status: "none" | "resolved";
+    fingerprint: string;
+}
+export interface TerminalDispatchTerminal {
+    conversationId: string;
+    agent: ExecutorKind;
+    pid: number;
+    terminalControl: TerminalControlRef;
+}
+export interface VerifiedEmptyCodexHandoffBoundary {
+    terminal: TerminalDispatchTerminal;
+    detachedSourceSessionId: string;
+    detachedSourceRevision: number;
+    detachedSourceBindingToken: string;
+    processUuid: string;
+    processBirth: string;
+}
+export interface DeferredCodexForegroundBindingBoundary {
+    terminal: TerminalDispatchTerminal;
+    transferId: string;
+    targetSessionId: string;
+    sourceSessionId: string;
+    sourceBoundRevision: number;
+    sourceBoundBindingToken: string;
+    processUuid: string;
+    processBirth: string;
+    previousDispatchSnapshot: DeferredCodexForegroundDispatchSnapshot;
+    candidateAcceptanceAnchor?: CodexCandidateSetRolloutAcceptanceAnchor;
+    sourceKind: DeferredForegroundTransferSourceKind;
+    sourceRolloutAuthority: DeferredForegroundTransferSourceRolloutAuthority;
+    sourceAbandonmentFingerprint?: string;
+    sourceTurnHistory?: DeferredForegroundTransferSourceTurnAuthority[];
+    sourcePreviousLastTransitionId?: string;
+    sourceReservedRevision?: number;
+    sourceReservedBindingToken?: string;
+    targetPreparedRevision?: number;
+    targetPreparedBindingToken?: string;
+}
+export interface TerminalControlSendOptions extends Record<string, unknown> {
+    agentHardTimeoutMinutes?: number | string;
+    agentTimeoutMinutes?: number | string;
+    claudeHome?: string;
+    scrollbackLines?: number | string;
+    terminalAcceptancePollIntervalMs?: number | string;
+    terminalAcceptanceTimeoutMs?: number | string;
+}
+export interface TerminalControlSendRequest {
+    transaction: {
+        scopes: CanonicalStateMutationScopes;
+        resources: CanonicalStateMutationResources;
+    };
+    options: TerminalControlSendOptions;
+    conversation: Conversation;
+    nextConversation: Conversation;
+    executor: Executor;
+    message: AgentMessage;
+    recordMessageAfterSend?: boolean;
+    recordRawAttachmentAfterSend?: boolean;
+    onTerminalPreflightVerified?: (route: BoundTerminalDispatchRoute) => Promise<((route: BoundTerminalDispatchRoute) => void) | void> | ((route: BoundTerminalDispatchRoute) => void) | void;
+    allowedPreMaterializationIdentity?: CodexPreMaterializationIdentity;
+    allowedAdditionalIdentities?: CodexPreMaterializationIdentity[];
+    observedHandoff?: {
+        terminal: TerminalDispatchTerminal;
+        transition: NativeThreadTransition;
+    };
+    verifiedEmptyCodexHandoff?: VerifiedEmptyCodexHandoffBoundary;
+    deferredCodexForegroundBinding?: DeferredCodexForegroundBindingBoundary;
+    continuingTurnResponse?: boolean;
+}

package/dist/src/terminal-dispatch-composition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-dispatch-composition.js.map

package/dist/src/terminal-dispatch-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-dispatch-composition.js","sourceRoot":"","sources":["../../src/terminal-dispatch-composition.ts"],"names":[],"mappings":""}

package/dist/src/terminal-dispatch-execution.d.ts

@@ -0,0 +1,290 @@
+import type { CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
+import type { ExecutorKind } from "./executors.js";
+import { type Conversation } from "./protocol.js";
+import type { ManagedSessionState, NativeThreadTransition } from "./managed-session.js";
+import type { TerminalControlRef, TerminalRuntimeIdentity } from "./terminal-agent-adapter.js";
+import { isCompleteNativeRollout, terminalNativeIdentityFence as codexIdentityFence, terminalNativeIdentityMatchesFence as nativeIdentityMatchesCodexPreMaterialization, type TerminalNativeIdentity } from "./terminal-binding-authority.js";
+import { nativeAgentIdentityMatchesTurn, type CodexAllowedCompanionSet } from "./terminal-authority-policy.js";
+import type { TerminalDispatchAcceptance } from "./terminal-dispatch-application.js";
+import type { TerminalDispatchLedgerDocument } from "./terminal-dispatch-ledger-codec.js";
+import { terminalSubmissionReplayReceipt } from "./terminal-dispatch-receipt.js";
+import { type CaptureCodexRolloutAcceptanceAnchorOptions, type CodexCandidateSetRolloutAcceptanceRequest, type CodexCandidateSetRolloutAcceptanceResult, type CodexCandidateSetRolloutAcceptanceAnchor, type CodexRolloutAcceptanceAnchor, type CodexRolloutAcceptanceRequest, type TerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+export { managedSessionRevision, nativeThreadTransitionRevision } from "./managed-session.js";
+export { nativeAgentIdentityMatchesTurn };
+export { codexIdentityFence, isCompleteNativeRollout, nativeIdentityMatchesCodexPreMaterialization };
+export type CodexPreMaterializationIdentity = NonNullable<TerminalRuntimeIdentity["allowedPreMaterializationNativeIdentity"]>;
+export type NativeAgentSessionIdentityObservation = {
+    status: "resolved";
+    identity: TerminalNativeIdentity;
+} | {
+    status: "verified_absent";
+    evidence: "native_identity_resolver_verified_absent";
+} | {
+    status: "unavailable";
+    reason: string;
+};
+interface ClaudeIdentityRow {
+    pid?: number;
+    sessionId?: string;
+    startedAt?: number;
+}
+export interface NativeIdentityResolutionRequest {
+    agent: ExecutorKind;
+    pid: number;
+    cwd?: string;
+    preferredSessionId?: string;
+    allowedCompanionIdentity?: CodexPreMaterializationIdentity;
+    allowedAdditionalIdentities?: readonly CodexPreMaterializationIdentity[];
+}
+export interface TerminalDispatchExecutionPorts {
+    clock: {
+        now(): Date;
+        nowMs(): number;
+        sleep(milliseconds: number): Promise<void>;
+    };
+    native: {
+        resolveCodex(request: Omit<NativeIdentityResolutionRequest, "agent">): Promise<TerminalNativeIdentity | undefined>;
+        inspectCodexOpenRoots(pid: number, cwd?: string): Promise<CodexOpenRootRolloutInventory>;
+        claudeRows(): readonly ClaudeIdentityRow[];
+        codexProcessIncarnation(pid: number): {
+            processUuid: string;
+            processBirth: string;
+        };
+    };
+    acceptance: {
+        captureCodex(request: CaptureCodexRolloutAcceptanceAnchorOptions): CodexRolloutAcceptanceAnchor;
+        detectCodexCandidates(request: CodexCandidateSetRolloutAcceptanceRequest): CodexCandidateSetRolloutAcceptanceResult;
+        detectBoundCodex(request: CodexRolloutAcceptanceRequest): TerminalSubmissionAcceptanceEvidence | undefined;
+        detectClaude(conversation: Conversation, terminalControl: TerminalControlRef): TerminalSubmissionAcceptanceEvidence | undefined;
+    };
+    terminal: {
+        proveExactDraftStillPresent(input: {
+            executor: ExecutorKind;
+            conversation: Conversation;
+            terminalControl: TerminalControlRef;
+            requestText: string;
+            scrollbackLines: number;
+        }): Promise<boolean>;
+    };
+    authority: {
+        assertTurnCurrent(conversation: Conversation, operation: string): void;
+    };
+}
+export interface TerminalAcceptanceDetectionRequest {
+    executor: ExecutorKind;
+    conversation: Conversation;
+    terminalControl: TerminalControlRef;
+}
+export interface TerminalAcceptancePollRequest extends TerminalAcceptanceDetectionRequest {
+    timeoutMs: number;
+    pollIntervalMs: number;
+    scrollbackLines: number;
+}
+export interface NativeIdentityPollRequest {
+    executor: ExecutorKind;
+    terminalControl: TerminalControlRef;
+    pid: number;
+    expectedSessionId?: string;
+    allowedPreMaterializationIdentity?: CodexPreMaterializationIdentity;
+    allowedAdditionalIdentities?: CodexPreMaterializationIdentity[];
+    requiredCodexAcceptance?: {
+        anchor: CodexRolloutAcceptanceAnchor;
+        requestHash: string;
+    };
+    attempts?: number;
+    delayMs?: number;
+}
+export type TerminalDispatchExecutionPreflight = {
+    action: "proceed";
+} | {
+    action: "replay";
+    owner: Conversation;
+    receipt: ReturnType<typeof terminalSubmissionReplayReceipt>;
+    accepted: boolean;
+    acceptanceInvalid: boolean;
+    receiptConversationId: string;
+    receiptMessageId: string;
+    callbackExpected: boolean;
+};
+export interface TerminalDispatchTransportLifecycle {
+    requireExactComposerBeforeEnter: boolean;
+    beforeText?: () => Promise<void>;
+    beforeEnter?: () => Promise<void>;
+    onTransportStage(input: {
+        stage: "text_injected" | "enter_dispatched";
+    }): Promise<void>;
+}
+interface RuntimeIdentityAssertion {
+    runtime?: TerminalRuntimeIdentity;
+    currentIdentity: TerminalNativeIdentity | undefined;
+    agent: ExecutorKind;
+    pid: number;
+}
+export declare function resolvedTerminalProcessIncarnation(input: {
+    terminal: {
+        agent: ExecutorKind;
+        pid: number;
+    };
+    identity?: TerminalNativeIdentity;
+    codexProcessIncarnation(pid: number): {
+        processUuid: string;
+        processBirth: string;
+    };
+}): {
+    processUuid?: string;
+    processBirth?: string;
+};
+export declare function managedSessionOwnerIsInactive(input: {
+    session: ManagedSessionState;
+    terminal: {
+        agent: ExecutorKind;
+        pid: number;
+    };
+    identity?: TerminalNativeIdentity;
+    isProcessAlive(pid: number): boolean;
+    codexProcessIncarnation(pid: number): {
+        processUuid: string;
+        processBirth: string;
+    };
+}): boolean;
+export declare function managedBindingMatchesLiveTerminal(input: {
+    session: ManagedSessionState;
+    terminal: {
+        agent: ExecutorKind;
+        pid: number;
+    };
+    identity?: TerminalNativeIdentity;
+    processIncarnation: {
+        processUuid?: string;
+        processBirth?: string;
+    };
+    claimMatches: boolean;
+    codexLingeringBeforeMatches(): boolean;
+}): boolean;
+export declare function codexKnownBeforeIdentityForTransition(input: {
+    session: ManagedSessionState;
+    transition?: NativeThreadTransition;
+    requireNewThread?: boolean;
+}): TerminalNativeIdentity | undefined;
+export declare function codexLingeringIdentityMatches(input: {
+    session: ManagedSessionState;
+    identity?: TerminalNativeIdentity;
+    transition?: NativeThreadTransition;
+    companions: CodexAllowedCompanionSet;
+}): boolean;
+export declare function logicalManagedSessionIdentity(input: {
+    session: ManagedSessionState;
+    observedIdentity?: TerminalNativeIdentity;
+    lingeringBeforeMatches: boolean;
+}): TerminalNativeIdentity | undefined;
+export declare function terminalRuntimeForLiveIdentity(input: {
+    terminal: {
+        agent: ExecutorKind;
+        pid: number;
+        terminalControl: TerminalControlRef;
+    };
+    identity?: TerminalNativeIdentity;
+    expectedEmptyNativeSession?: boolean;
+    physicalOnly?: boolean;
+    codexProcessIncarnation(pid: number): {
+        processUuid: string;
+        processBirth: string;
+    };
+}): TerminalRuntimeIdentity;
+export declare function terminalRuntimeIdentityBase(conversation: Conversation, terminalControl: TerminalControlRef): TerminalRuntimeIdentity;
+export declare function migratedTerminalBindingMatches(input: {
+    session: ManagedSessionState;
+    agent: ExecutorKind;
+    terminalAliasMatches: boolean;
+    terminalIncarnationMatches: boolean;
+    workspaceMatches: boolean;
+    terminalId?: string;
+    pid: number;
+    nativeThreadId?: string;
+    processUuid?: string;
+    processBirth?: string;
+    rollout?: unknown;
+}): boolean;
+export declare function selectBoundManagedSessionForTerminal(input: {
+    sessions: readonly ManagedSessionState[];
+    agent: ExecutorKind;
+    pid: number;
+    terminalTarget: string;
+    aliasMatches(session: ManagedSessionState): boolean;
+    exactMatches(session: ManagedSessionState): boolean;
+    sameIncarnation(session: ManagedSessionState): boolean;
+    ownerIsInactive(session: ManagedSessionState): boolean;
+}): ManagedSessionState | undefined;
+export declare function selectSoleBoundManagedSessionClaim(input: {
+    sessions: readonly ManagedSessionState[];
+    terminalTarget: string;
+    claims(session: ManagedSessionState): boolean;
+    ownerIsInactive(session: ManagedSessionState): boolean;
+}): ManagedSessionState | undefined;
+export declare function managedTurnMatchesTerminal(input: {
+    conversation: Conversation;
+    terminal: {
+        conversationId: string;
+        agent: ExecutorKind;
+        pid: number;
+    };
+    currentIdentity?: TerminalNativeIdentity;
+    storedControlExists: boolean;
+    terminalIncarnationMatches: boolean;
+    workspaceMatches: boolean;
+}): boolean;
+export declare function assertManagedSessionCanStartTurnPolicy(turns: readonly Conversation[], isBlocking: (conversation: Conversation) => boolean): void;
+export declare function terminalSubmissionPayload(payload: string): string;
+export declare class TerminalDispatchExecutionService {
+    #private;
+    constructor(syntheticAcceptanceOutcome: string | undefined, ports: TerminalDispatchExecutionPorts);
+    preflightRequiresOwner(ledger: TerminalDispatchLedgerDocument | undefined, lifecycle: boolean): boolean;
+    evaluatePreflight(input: {
+        ledger?: TerminalDispatchLedgerDocument;
+        owner?: Conversation;
+        conversation: Conversation;
+        requestHash: string;
+        requestText: string;
+        messageId: string;
+        terminalTarget: string;
+        ledgerLifecycle: boolean;
+        statePathMatches: boolean;
+        continuingTurnResponse: boolean;
+    }): TerminalDispatchExecutionPreflight;
+    transportLifecycle(input: {
+        observedHandoff?: {
+            verify(requireEmptyComposer: boolean): Promise<unknown>;
+        };
+        verifiedEmptyHandoff?: {
+            verify(requireEmptyComposer: boolean): Promise<unknown>;
+        };
+        deferredBinding?: {
+            verify(requireEmptyComposer: boolean): Promise<unknown>;
+            begin(at: string): unknown;
+            advance(stage: "text_injected" | "enter_dispatched", at: string): unknown;
+        };
+        recordStage(stage: "text_injected" | "enter_dispatched", at: string, afterDurable: () => Promise<void>): Promise<void>;
+    }): TerminalDispatchTransportLifecycle;
+    captureCodexAcceptanceAnchor(input: {
+        currentIdentity?: TerminalNativeIdentity;
+        expectedNativeThreadId?: string;
+        boundProcessUuid?: string;
+        boundProcessBirth?: string;
+        allowedPreMaterializationIdentity?: CodexPreMaterializationIdentity;
+        needsPostSendNativeBinding: boolean;
+        candidateSetAnchor?: CodexCandidateSetRolloutAcceptanceAnchor;
+    }): CodexRolloutAcceptanceAnchor | undefined;
+    resolveCurrentNativeIdentity(request: NativeIdentityResolutionRequest): Promise<TerminalNativeIdentity | undefined>;
+    observeCurrentNativeIdentity(request: NativeIdentityResolutionRequest): Promise<NativeAgentSessionIdentityObservation>;
+    inspectCodexOpenRootInventory(pid: number, cwd?: string): Promise<CodexOpenRootRolloutInventory>;
+    detectAcceptance(request: TerminalAcceptanceDetectionRequest): Promise<TerminalSubmissionAcceptanceEvidence | undefined>;
+    pollAcceptance(request: TerminalAcceptancePollRequest): Promise<TerminalDispatchAcceptance>;
+    assertRuntimeIdentity(input: RuntimeIdentityAssertion): void;
+    assertTurnIdentity(input: {
+        conversation: Conversation;
+        currentIdentity: TerminalNativeIdentity | undefined;
+        operation: string;
+    }): void;
+    withNativeIdentity(conversation: Conversation, identity: TerminalNativeIdentity): Conversation;
+    pollNativeIdentity(request: NativeIdentityPollRequest): Promise<TerminalNativeIdentity | undefined>;
+}