@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

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

@@ -0,0 +1,93 @@
+/**
+ * Pure ordinary-dispatch gate. The caller owns every Store/terminal read and
+ * supplies only the facts observed at the existing preflight boundary.
+ */
+export declare function isActiveTerminalDispatchStatus(status: unknown): boolean;
+export declare function isRecoverableTerminalDispatchStatus(status: unknown): boolean;
+export type TerminalDispatchReceiptStatus = "submitted" | "enter_dispatched" | "agent_accepted";
+export interface TerminalDispatchLedgerFacts {
+    readonly status?: string;
+    readonly lifecycle: boolean;
+    readonly transitionId?: string;
+    readonly ownerConversationId?: string;
+}
+export interface TerminalDispatchOwnerFacts {
+    readonly conversationId: string;
+    readonly status: string;
+    readonly released: boolean;
+    readonly continuingSameTurn: boolean;
+    readonly exactReplay: boolean;
+}
+export interface TerminalDispatchPreflightFacts {
+    readonly ledger: TerminalDispatchLedgerFacts;
+    readonly owner?: TerminalDispatchOwnerFacts;
+}
+export type TerminalDispatchPreflightPlan = {
+    action: "proceed";
+    basis: "no_blocking_dispatch" | "released_owner" | "continuing_same_turn";
+} | {
+    action: "reject";
+    reason: "unresolved_lifecycle" | "terminal_level_dispatch" | "owner_unavailable" | "active_owner";
+    status?: string;
+    transitionId?: string;
+    ownerConversationId?: string;
+    ownerStatus?: string;
+} | {
+    action: "replay";
+    proofLevel: "submitted" | "enter_dispatched" | "agent_accepted";
+};
+export interface TerminalDispatchReplayAcceptance {
+    readonly accepted: boolean;
+    readonly invalid: boolean;
+}
+export type TerminalDispatchLedgerAuthority = "absent" | "unreadable" | "resolved" | "stale_process_incarnation" | "inactive_status" | "active";
+export type TerminalDispatchOwnerAuthority = "unavailable" | "released" | "terminal_mismatch" | "generation_mismatch" | "current";
+export declare function decideTerminalDispatchOwnership(ledger: TerminalDispatchLedgerAuthority, owner?: TerminalDispatchOwnerAuthority): {
+    state: "conflict";
+    code: "ledger_unreadable";
+    basis?: undefined;
+} | {
+    state: "none";
+    basis: "absent" | "inactive_status" | "resolved" | "stale_process_incarnation";
+    code?: undefined;
+} | {
+    state: "needs_owner";
+    basis?: undefined;
+    code?: undefined;
+} | {
+    readonly state: "conflict";
+    readonly code: "owner_unavailable";
+    basis?: undefined;
+} | {
+    state: "none";
+    basis: "released_owner";
+    code?: undefined;
+} | {
+    basis?: undefined;
+    state: "conflict";
+    code: "owner_terminal_mismatch";
+} | {
+    basis?: undefined;
+    state: "current";
+    code?: undefined;
+} | {
+    basis?: undefined;
+    state: "conflict";
+    code: "owner_generation_mismatch";
+};
+export { decideTerminalSendAuthority, type TerminalSendAuthority, type TerminalSendAuthorityFacts } from "./terminal-action-projection.js";
+/**
+ * Preserve the legacy lazy Store read: only an ordinary active receipt status
+ * reaches owner loading, and an unresolved lifecycle ledger wins first.
+ */
+export declare function terminalDispatchPreflightRequiresOwner(ledger: TerminalDispatchLedgerFacts): boolean;
+/**
+ * Reduce already-observed dispatch facts to one side-effect-free next action.
+ * Error wording, output envelopes and replay receipt construction remain in
+ * the CLI compatibility shell.
+ */
+export declare function decideTerminalDispatchPreflight(facts: TerminalDispatchPreflightFacts): TerminalDispatchPreflightPlan;
+export declare function decideTerminalDispatchReplayAcceptance({ delivered, submissionOutcome }: {
+    delivered: boolean;
+    submissionOutcome: string;
+}): TerminalDispatchReplayAcceptance;

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

@@ -0,0 +1,122 @@
+/**
+ * Pure ordinary-dispatch gate. The caller owns every Store/terminal read and
+ * supplies only the facts observed at the existing preflight boundary.
+ */
+const TERMINAL_LEVEL_BLOCKING_STATUSES = new Set([
+    "prepared",
+    "text_injected",
+    "dispatching",
+    "uncertain",
+    "not_accepted"
+]);
+export function isActiveTerminalDispatchStatus(status) {
+    return typeof status === "string" && (TERMINAL_LEVEL_BLOCKING_STATUSES.has(status) ||
+        terminalDispatchReceiptStatus(status) !== undefined);
+}
+export function isRecoverableTerminalDispatchStatus(status) {
+    return status === "verified" || isActiveTerminalDispatchStatus(status);
+}
+export function decideTerminalDispatchOwnership(ledger, owner) {
+    if (ledger === "unreadable") {
+        return { state: "conflict", code: "ledger_unreadable" };
+    }
+    if (ledger !== "active")
+        return { state: "none", basis: ledger };
+    if (!owner)
+        return { state: "needs_owner" };
+    if (owner === "unavailable") {
+        return { state: "conflict", code: "owner_unavailable" };
+    }
+    if (owner === "released") {
+        return { state: "none", basis: "released_owner" };
+    }
+    if (owner === "terminal_mismatch") {
+        return {
+            state: "conflict",
+            code: "owner_terminal_mismatch"
+        };
+    }
+    return owner === "current"
+        ? { state: "current" }
+        : {
+            state: "conflict",
+            code: "owner_generation_mismatch"
+        };
+}
+export { decideTerminalSendAuthority } from "./terminal-action-projection.js";
+/**
+ * Preserve the legacy lazy Store read: only an ordinary active receipt status
+ * reaches owner loading, and an unresolved lifecycle ledger wins first.
+ */
+export function terminalDispatchPreflightRequiresOwner(ledger) {
+    return !(ledger.lifecycle && ledger.status !== "resolved") && terminalDispatchReceiptStatus(ledger.status) !== undefined;
+}
+/**
+ * Reduce already-observed dispatch facts to one side-effect-free next action.
+ * Error wording, output envelopes and replay receipt construction remain in
+ * the CLI compatibility shell.
+ */
+export function decideTerminalDispatchPreflight(facts) {
+    const { ledger } = facts;
+    if (ledger.lifecycle && ledger.status !== "resolved") {
+        return {
+            action: "reject",
+            reason: "unresolved_lifecycle",
+            status: ledger.status,
+            transitionId: ledger.transitionId
+        };
+    }
+    if (TERMINAL_LEVEL_BLOCKING_STATUSES.has(ledger.status ?? "")) {
+        return {
+            action: "reject",
+            reason: "terminal_level_dispatch",
+            status: ledger.status,
+            ownerConversationId: ledger.ownerConversationId
+        };
+    }
+    const receiptStatus = terminalDispatchReceiptStatus(ledger.status);
+    if (!receiptStatus) {
+        return { action: "proceed", basis: "no_blocking_dispatch" };
+    }
+    const owner = facts.owner;
+    if (!owner) {
+        return {
+            action: "reject",
+            reason: "owner_unavailable",
+            status: ledger.status
+        };
+    }
+    if (owner.released) {
+        return { action: "proceed", basis: "released_owner" };
+    }
+    if (owner.continuingSameTurn) {
+        return { action: "proceed", basis: "continuing_same_turn" };
+    }
+    if (owner.exactReplay) {
+        return {
+            action: "replay",
+            proofLevel: receiptStatus
+        };
+    }
+    return {
+        action: "reject",
+        reason: "active_owner",
+        status: ledger.status,
+        ownerConversationId: owner.conversationId,
+        ownerStatus: owner.status
+    };
+}
+function terminalDispatchReceiptStatus(status) {
+    return status === "submitted" ||
+        status === "enter_dispatched" ||
+        status === "agent_accepted"
+        ? status
+        : undefined;
+}
+export function decideTerminalDispatchReplayAcceptance({ delivered, submissionOutcome }) {
+    return {
+        accepted: delivered,
+        invalid: submissionOutcome === "uncertain"
+    };
+}
+//# sourceMappingURL=terminal-dispatch-policy.js.map

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

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

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

@@ -0,0 +1,65 @@
+import { type AgentMessage, type Conversation, type Executor } from "./protocol.js";
+import type { TerminalControlRef } from "./terminal-agent-adapter.js";
+import type { RecordedTerminalZeroInputAbort, TerminalDispatchAcceptance } from "./terminal-dispatch-application.js";
+import type { terminalSubmissionReplayReceipt } from "./terminal-dispatch-receipt.js";
+type ReplayReceipt = ReturnType<typeof terminalSubmissionReplayReceipt>;
+export interface TerminalDispatchPresentationContext {
+    message: AgentMessage;
+    executor: Executor;
+    terminalControl: TerminalControlRef;
+}
+export interface TerminalDispatchPresentationPorts {
+    write(value: Record<string, unknown>): void;
+    budget(conversation: Conversation): unknown;
+    nextAction(input: Readonly<{
+        conversationId: string;
+        sessionId: string;
+        turnId: string;
+        source: "terminal_control";
+        callbackExpected: boolean;
+    }>): unknown;
+    summarize(value: unknown): unknown;
+}
+export interface OpenClawYieldNextActionInput {
+    conversationId: string;
+    sessionId: string;
+    turnId: string;
+    source: "terminal_control";
+    callbackExpected: boolean;
+}
+export declare function openClawYieldNextAction({ conversationId, sessionId, turnId, source, callbackExpected }: OpenClawYieldNextActionInput): {
+    action: "yield";
+    reason: string;
+    source: "terminal_control";
+    conversation_id: string;
+    session_id: string;
+    turn_id: string;
+    callback_expected: boolean;
+    do_not: string;
+    expected_callback: string;
+};
+export declare function presentTerminalDispatchReplay(input: Readonly<{
+    owner: Conversation;
+    receipt: ReplayReceipt;
+    accepted: boolean;
+    acceptanceInvalid: boolean;
+    receiptConversationId: string;
+    receiptMessageId: string;
+    callbackExpected: boolean;
+}>, context: TerminalDispatchPresentationContext, ports: TerminalDispatchPresentationPorts): void;
+export declare function presentTerminalZeroInputAbort(failure: RecordedTerminalZeroInputAbort, context: TerminalDispatchPresentationContext, ports: TerminalDispatchPresentationPorts, monitorPid?: number | null): void;
+export declare function presentTerminalIdentityFailure(conversation: Conversation, reason: string, context: TerminalDispatchPresentationContext, ports: TerminalDispatchPresentationPorts, monitorPid?: number | null): void;
+export declare function presentTerminalUncertain(input: Readonly<{
+    conversation: Conversation;
+    stalledConversationIds: readonly string[];
+    textInjected: boolean;
+    enterDispatched: boolean;
+    monitorPid?: number | null;
+}>, context: TerminalDispatchPresentationContext, ports: TerminalDispatchPresentationPorts): void;
+export declare function presentTerminalCompleted(input: Readonly<{
+    conversation: Conversation;
+    acceptance?: TerminalDispatchAcceptance;
+    monitorPid?: number | null;
+    bookkeepingWarning?: string;
+}>, context: TerminalDispatchPresentationContext, ports: TerminalDispatchPresentationPorts): void;
+export {};

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

@@ -0,0 +1,258 @@
+import { sessionIdForConversation, turnIdForConversation } from "./protocol.js";
+import { isRecord } from "./value-guards.js";
+export function openClawYieldNextAction({ conversationId, sessionId, turnId, source, callbackExpected }) {
+    const callbackText = callbackExpected
+        ? "The coding agent should report completion, questions, or errors through the existing Agent Knock Knock callback for this conversation."
+        : "No AKK-managed callback is registered for this raw terminal-controlled id; do not wait synchronously. Use AKK status/list later or attach/create an AKK conversation when callback delivery is required.";
+    return {
+        action: "yield",
+        reason: "The requested agent work was handed off asynchronously. End this OpenClaw turn now instead of waiting, polling, or treating the send as a synchronous agent result.",
+        source,
+        conversation_id: conversationId,
+        session_id: sessionId,
+        turn_id: turnId,
+        callback_expected: callbackExpected,
+        do_not: "Do not inspect event logs, process lists, terminal screens, files, stdout, or stderr while waiting unless the user explicitly asks for status.",
+        expected_callback: callbackText
+    };
+}
+export function presentTerminalDispatchReplay(input, context, ports) {
+    const sessionId = sessionIdForConversation(input.owner);
+    const turnId = turnIdForConversation(input.owner);
+    ports.write({
+        session_id: sessionId,
+        turn_id: turnId,
+        conversation: input.owner,
+        message: {
+            ...context.message,
+            id: input.receiptMessageId,
+            conversation_id: input.receiptConversationId,
+            session_id: sessionId,
+            turn_id: turnId,
+            metadata: {
+                ...(isRecord(context.message.metadata)
+                    ? context.message.metadata
+                    : {}),
+                task_id: input.receiptConversationId,
+                session_id: sessionId,
+                turn_id: turnId
+            }
+        },
+        delivered: input.receipt.delivered,
+        status: input.receipt.status,
+        submission_outcome: input.receipt.submission_outcome,
+        background: true,
+        callback_expected: input.callbackExpected,
+        terminal_control: context.terminalControl,
+        executor: context.executor,
+        replayed: input.receipt.replayed,
+        delivery_receipt: input.receipt.delivery_receipt,
+        ...(input.receipt.do_not_retry
+            ? { do_not_retry: input.receipt.do_not_retry }
+            : {}),
+        reason: input.accepted
+            ? "AKK replayed the durable native acceptance receipt for an identical active terminal request and did not send terminal input again."
+            : input.acceptanceInvalid
+                ? `AKK refused to replay an invalid native acceptance receipt (${input.receipt.evidence_error ?? "evidence validation failed"}); no terminal input was sent.`
+                : "AKK replayed the original transport-level receipt without upgrading it to native acceptance and did not send terminal input again.",
+        openclaw_next_action: input.accepted
+            ? ports.nextAction({
+                conversationId: input.receiptConversationId,
+                sessionId,
+                turnId,
+                source: "terminal_control",
+                callbackExpected: input.callbackExpected
+            })
+            : {
+                action: "inspect",
+                conversation_id: input.receiptConversationId,
+                session_id: sessionId,
+                turn_id: turnId,
+                do_not_retry: true,
+                reason: input.acceptanceInvalid
+                    ? "The stored native acceptance evidence is invalid; inspect and explicitly close this Turn."
+                    : "Only terminal transport is proven; wait for native acceptance or inspect the shared pane."
+            }
+    });
+}
+function zeroInputText(failure) {
+    const setup = failure.outcome.failureKind === "setup";
+    const blocker = failure.outcome.disposition === "inspect"
+        ? failure.outcome.blocker
+        : undefined;
+    if (failure.outcome.safeToRetry) {
+        return setup
+            ? {
+                reason: "AKK failed before terminal input; this terminal submission was not sent and may be retried.",
+                nextReason: "The failure occurred before any terminal input."
+            }
+            : {
+                reason: "AKK proved that terminal input never started; this submission may be retried.",
+                nextReason: "The terminal transport failed before any input operation succeeded."
+            };
+    }
+    if (!setup) {
+        return {
+            reason: "AKK proved terminal input never started but could not make every abort receipt and Session rollback durable; inspect before retrying.",
+            nextReason: "The pre-input failure could not be fully reconciled in durable state."
+        };
+    }
+    return blocker === "dispatch_ledger_restore"
+        ? {
+            reason: "AKK failed before terminal input but could not restore the terminal dispatch ledger; inspect and close the conversation before retrying.",
+            nextReason: "The terminal ledger could not be restored automatically."
+        }
+        : blocker === "raw_attach_rollback"
+            ? {
+                reason: "AKK failed before terminal input but could not detach the provisional raw-attach Session; inspect its exact binding before retrying.",
+                nextReason: "The provisional raw-attach Session could not be detached automatically."
+            }
+            : {
+                reason: "AKK failed before terminal input but could not persist the aborted receipt; inspect the conversation before retrying.",
+                nextReason: "The aborted receipt could not be made durable."
+            };
+}
+export function presentTerminalZeroInputAbort(failure, context, ports, monitorPid) {
+    const { reportedConversation, receiptConversation } = failure;
+    const text = zeroInputText(failure);
+    ports.write({
+        session_id: sessionIdForConversation(receiptConversation),
+        turn_id: turnIdForConversation(receiptConversation),
+        conversation: reportedConversation,
+        message: context.message,
+        delivered: false,
+        status: "submission_aborted",
+        submission_outcome: "aborted",
+        background: true,
+        callback_expected: false,
+        terminal_control: context.terminalControl,
+        monitor_pid: monitorPid ?? null,
+        executor: context.executor,
+        safe_to_retry: failure.outcome.safeToRetry,
+        do_not_retry: !failure.outcome.safeToRetry,
+        reason: text.reason,
+        openclaw_next_action: {
+            action: failure.outcome.safeToRetry ? "retry" : "inspect",
+            conversation_id: receiptConversation.conversation_id,
+            session_id: sessionIdForConversation(reportedConversation),
+            turn_id: turnIdForConversation(reportedConversation),
+            safe_to_retry: failure.outcome.safeToRetry,
+            do_not_retry: !failure.outcome.safeToRetry,
+            reason: text.nextReason
+        }
+    });
+}
+export function presentTerminalIdentityFailure(conversation, reason, context, ports, monitorPid) {
+    ports.write({
+        session_id: sessionIdForConversation(conversation),
+        turn_id: turnIdForConversation(conversation),
+        conversation,
+        message: context.message,
+        delivered: false,
+        status: "submission_uncertain",
+        submission_outcome: "uncertain",
+        background: true,
+        callback_expected: false,
+        terminal_control: context.terminalControl,
+        monitor_pid: monitorPid ?? null,
+        executor: context.executor,
+        delivery_receipt: "enter_dispatched",
+        do_not_retry: true,
+        reason,
+        openclaw_next_action: {
+            action: "inspect",
+            conversation_id: conversation.conversation_id,
+            session_id: sessionIdForConversation(conversation),
+            turn_id: turnIdForConversation(conversation),
+            do_not_retry: true,
+            reason: "The input was submitted, but AKK could not fence later side effects to an exact native session. Inspect the pane and close this Turn before continuing."
+        }
+    });
+}
+export function presentTerminalUncertain(input, context, ports) {
+    ports.write({
+        session_id: sessionIdForConversation(input.conversation),
+        turn_id: turnIdForConversation(input.conversation),
+        conversation: input.conversation,
+        message: context.message,
+        delivered: false,
+        status: "submission_uncertain",
+        submission_outcome: "uncertain",
+        background: true,
+        callback_expected: Boolean(input.conversation.gateway_method),
+        terminal_control: context.terminalControl,
+        monitor_pid: input.monitorPid ?? null,
+        executor: context.executor,
+        do_not_retry: true,
+        stalled_conversation_ids: input.stalledConversationIds,
+        reason: input.enterDispatched
+            ? "AKK dispatched Enter but native acceptance or its exact identity became uncertain. Do not retry automatically; inspect this conversation and pane."
+            : input.textInjected
+                ? "AKK injected text but could not prove that Enter was dispatched. Do not retry automatically; inspect this conversation and pane."
+                : "AKK could not prove that terminal input remained untouched. Inspect this conversation before retrying.",
+        openclaw_next_action: {
+            action: "inspect",
+            conversation_id: input.conversation.conversation_id,
+            session_id: sessionIdForConversation(input.conversation),
+            turn_id: turnIdForConversation(input.conversation),
+            do_not_retry: true,
+            reason: "The terminal submission outcome is uncertain. Inspect AKK status and the shared terminal pane before deciding whether to close or continue."
+        }
+    });
+}
+export function presentTerminalCompleted(input, context, ports) {
+    const outcome = input.acceptance?.outcome;
+    const accepted = outcome === "agent_accepted";
+    const pending = outcome === "pending_acceptance";
+    ports.write({
+        session_id: sessionIdForConversation(input.conversation),
+        turn_id: turnIdForConversation(input.conversation),
+        conversation: input.conversation,
+        message: context.message,
+        delivered: accepted,
+        status: accepted
+            ? "async_pending"
+            : pending
+                ? "submission_pending_acceptance"
+                : outcome === "not_accepted"
+                    ? "submission_not_accepted"
+                    : "submission_uncertain",
+        submission_outcome: outcome,
+        background: true,
+        callback_expected: Boolean(input.conversation.gateway_method && (accepted || pending)),
+        terminal_control: context.terminalControl,
+        monitor_pid: input.monitorPid ?? null,
+        executor: context.executor,
+        budget: ports.budget(input.conversation),
+        delivery_receipt: accepted
+            ? "agent_accepted"
+            : pending
+                ? "enter_dispatched"
+                : outcome,
+        ...(!accepted ? { do_not_retry: true } : {}),
+        ...(input.bookkeepingWarning
+            ? { bookkeeping_warning: ports.summarize(input.bookkeepingWarning) }
+            : {}),
+        openclaw_next_action: accepted
+            ? ports.nextAction({
+                conversationId: input.conversation.conversation_id,
+                sessionId: sessionIdForConversation(input.conversation),
+                turnId: turnIdForConversation(input.conversation),
+                source: "terminal_control",
+                callbackExpected: Boolean(input.conversation.gateway_method)
+            })
+            : {
+                action: pending ? "wait_for_acceptance" : "inspect",
+                conversation_id: input.conversation.conversation_id,
+                session_id: sessionIdForConversation(input.conversation),
+                turn_id: turnIdForConversation(input.conversation),
+                do_not_retry: true,
+                reason: pending
+                    ? "Terminal transport is proven and the background monitor is still waiting for native acceptance."
+                    : outcome === "not_accepted"
+                        ? "The exact draft is still present; inspect the composer and do not send a duplicate."
+                        : "Native acceptance evidence became uncertain; inspect the shared pane."
+            }
+    });
+}
+//# sourceMappingURL=terminal-dispatch-presenter.js.map

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

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

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

@@ -0,0 +1,79 @@
+import { type Conversation } from "./protocol.js";
+import type { TerminalControlRef } from "./terminal-agent-adapter.js";
+import type { TerminalOrdinaryDispatchStatus } from "./terminal-dispatch-ledger-codec.js";
+import { terminalBridgeSubmission, type TerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+import { type UnknownRecord } from "./value-guards.js";
+export interface TerminalBridgeStateInput {
+    conversation: Conversation;
+    message: {
+        id: string;
+    };
+    requestText: string;
+    startedAt: string;
+    agentTimeoutMinutes: number;
+    agentHardTimeoutMinutes: number;
+    monitorLockVersion: number;
+    preSendScreenFingerprint?: string;
+    codexRolloutAcceptanceAnchor?: unknown;
+    claudeTranscriptAnchor?: unknown;
+    claudeHome?: string;
+}
+export interface TerminalBridgeSubmissionMutation {
+    conversation: Conversation;
+    messageId: string;
+    messageType?: "task" | "answer";
+    messageBody?: string;
+    requestText: string;
+    status: TerminalOrdinaryDispatchStatus;
+    preparedAt: string;
+    textInjectedAt?: string;
+    enterDispatchedAt?: string;
+    agentAcceptedAt?: string;
+    notAcceptedAt?: string;
+    submittedAt?: string;
+    uncertainAt?: string;
+    abortedAt?: string;
+    error?: string;
+    acceptanceEvidence?: TerminalSubmissionAcceptanceEvidence;
+    lastProvenStage?: "prepared" | "text_injected" | "enter_dispatched" | "agent_accepted";
+    safeToRetry?: boolean;
+}
+export interface TerminalBridgeSubmissionContext {
+    dispatcherPid: number;
+    storeDir?: string;
+    terminalControl?: TerminalControlRef;
+}
+export declare function withTerminalBridgeState({ conversation, message, requestText, startedAt, agentTimeoutMinutes, agentHardTimeoutMinutes, monitorLockVersion, preSendScreenFingerprint, codexRolloutAcceptanceAnchor, claudeTranscriptAnchor, claudeHome }: TerminalBridgeStateInput): Conversation;
+export declare function applyTerminalBridgeSubmission(mutation: TerminalBridgeSubmissionMutation, context: TerminalBridgeSubmissionContext): Conversation;
+export declare function terminalAcceptanceEvidenceForConversation(conversation: Conversation, requestText: string, evidence: unknown): TerminalSubmissionAcceptanceEvidence;
+export declare function terminalAcceptanceEvidenceExpectation(conversation: Conversation, requestText: string): {
+    source: TerminalSubmissionAcceptanceEvidence["source"];
+    nativeThreadId: string;
+    requestHash: string;
+};
+export declare function terminalSubmissionReplayReceipt(options: {
+    proofLevel: "submitted" | "enter_dispatched" | "agent_accepted";
+    evidence?: unknown;
+    expected: {
+        source: TerminalSubmissionAcceptanceEvidence["source"];
+        nativeThreadId: string;
+        requestHash: string;
+    };
+}): {
+    replayed: true;
+    delivered: boolean;
+    status: "async_pending" | "submission_pending_acceptance" | "submission_uncertain";
+    submission_outcome: "agent_accepted" | "pending_acceptance" | "uncertain";
+    delivery_receipt: "agent_accepted" | "enter_dispatched" | "submitted";
+    do_not_retry?: true;
+    evidence_error?: string;
+};
+export declare function terminalBridgeRequestFingerprint(value: unknown): string | undefined;
+export declare function terminalDispatchTextSummary(text: unknown, maxLength?: number): {
+    length: number;
+    preview?: string;
+};
+export declare function terminalBridgeEnabled(conversation: unknown): boolean;
+export { terminalBridgeSubmission };
+export declare function terminalBridgeSubmissionReceipts(conversation: Conversation): UnknownRecord[];
+export declare function unresolvedTerminalBridgeSubmission(conversation: Conversation): UnknownRecord | undefined;