@scotthuang/agent-knock-knock 0.13.3 → 0.13.4

package/dist/src/terminal-agent-bridge.d.ts

@@ -1,99 +1,15 @@
 import type { ExecutorKind } from "./executors.js";
-import { type ActiveTerminalProcess, type TerminalAgentAdapter, type TerminalAgentAdapterCapabilities, type TerminalAgentAdapterRegistry, type TerminalApprovalDecision, type TerminalCompletionEvidence, type TerminalControlRef, type TerminalDurableCompletionRequest, type TerminalNativeInspectionEvidenceInventoryEntry, type TerminalNativeInspectionObservation, type TerminalNativeInspectionObservationRequest, type TerminalNativeInspectionPlan, type TerminalProcessSnapshot, type TerminalRuntimeIdentity, type TerminalScreenInspection } from "./terminal-agent-adapter.js";
+import { type ActiveTerminalProcess, type TerminalAgentAdapter, type TerminalAgentAdapterCapabilities, type TerminalAgentAdapterRegistry, type TerminalApprovalDecision, type TerminalCompletionEvidence, type TerminalControlRef, type TerminalDurableCompletionRequest, type TerminalNativeInspectionObservation, type TerminalNativeInspectionObservationRequest, type TerminalNativeInspectionPlan, type TerminalProcessSnapshot, type TerminalRuntimeIdentity, type TerminalScreenInspection } from "./terminal-agent-adapter.js";
 import { type TerminalDiscoveryDiagnosticLog, type TerminalControlProvider } from "./terminal-control-provider.js";
-import { type TerminalControlEvidence } from "./terminal-control-ref.js";
-import { type TerminalInteractionAnyProjection, type TerminalInteractionAnswer, type TerminalInteractionSubject } from "./terminal-interaction-protocol.js";
-import type { NativeQuestionnaireActionPlan, NativeQuestionnaireInspection } from "./terminal-questionnaire-adapter.js";
+import { type TerminalInteractionAnyProjection } from "./terminal-interaction-protocol.js";
+import { type TerminalInteractionResponseExecution, type TerminalInteractionResponseInput, type TerminalInteractionResponseOptions } from "./terminal-interaction-response-bridge.js";
 import { type TerminalModelCatalog, type TerminalModelControlPlan, type TerminalModelControlPorts, type TerminalModelControlRepairResult, type TerminalModelControlResidualObservation, type TerminalModelSwitchRequest, type TerminalModelSwitchResult } from "./terminal-model-control.js";
-/** A terminal send failed at a boundary that proves input never started. */
-export declare class TerminalInputNotStartedError extends Error {
-    readonly code = "AKK_TERMINAL_INPUT_NOT_STARTED";
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * Text is already in the terminal composer, but this bridge invocation proved
- * that it never called the Enter transport boundary.
- *
- * Callers may persist this as narrow recovery evidence. It says nothing about
- * whether the draft remains exact or whether a later human action submitted
- * it; those facts must be re-observed under the terminal lock.
- */
-export declare class TerminalEnterDispatchNotAttemptedError extends Error {
-    readonly code = "AKK_TERMINAL_ENTER_DISPATCH_NOT_ATTEMPTED";
-    readonly stage = "enter_not_attempted";
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * The caller's one-shot Enter reservation was invoked, so this recovery
- * attempt is permanently consumed even though C-m was not proven dispatched.
- */
-export declare class TerminalEnterDispatchReservedError extends Error {
-    readonly code = "AKK_TERMINAL_ENTER_DISPATCH_RESERVED";
-    readonly stage = "enter_reserved";
-    readonly doNotRetry = true;
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-export type NativeInspectionSubmissionStage = "not_started" | "text_injected" | "enter_uncertain";
-/** Machine-readable reason for a closed native-inspection submission failure. */
-export type NativeInspectionSubmissionDiagnostic = "unsupported_profile" | "capability_unavailable" | "identity_unverified" | "composer_not_ready" | "viewport_too_narrow" | "viewport_unavailable" | "text_delivery_unproven" | "composer_viewport_truncated" | "composer_not_exact" | "composer_drift" | "evidence_unproven" | "enter_uncertain";
-/**
- * A fail-closed native-inspection submission result.
- *
- * Only `not_started` proves that a caller may safely retry. Once text has
- * reached the composer, or Enter has been attempted, automated retries could
- * duplicate input or execute a different command after terminal drift.
- */
-export declare class NativeInspectionSubmissionError extends Error {
-    readonly stage: NativeInspectionSubmissionStage;
-    readonly code = "AKK_NATIVE_INSPECTION_SUBMISSION_FAILED";
-    readonly doNotRetry: boolean;
-    constructor(stage: NativeInspectionSubmissionStage, message: string, options?: {
-        cause?: unknown;
-        diagnostic?: NativeInspectionSubmissionDiagnostic;
-    });
-    readonly diagnostic?: NativeInspectionSubmissionDiagnostic;
-}
-/** A verified modal could not be dismissed across one exact key attempt. */
-export declare class NativeInspectionDismissalError extends Error {
-    readonly code = "AKK_NATIVE_INSPECTION_DISMISSAL_FAILED";
-    readonly doNotRetry = true;
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-export type TerminalInteractionReservedStage = "reservation_uncertain" | "text_uncertain" | "key_uncertain";
-/**
- * A response reservation or terminal input may already have happened. The
- * same interaction must never be dispatched automatically after this error.
- */
-export declare class TerminalInteractionDispatchReservedError extends Error {
-    readonly stage: TerminalInteractionReservedStage;
-    readonly code = "AKK_TERMINAL_INTERACTION_DISPATCH_RESERVED";
-    readonly doNotRetry = true;
-    constructor(stage: TerminalInteractionReservedStage, message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * A durable response reservation exists, but the bridge proved that no
- * terminal text or key delivery was attempted. The caller must discard the
- * one-shot offer and obtain a fresh status projection before trying again.
- */
-export declare class TerminalInteractionInputNotStartedError extends Error {
-    readonly code = "AKK_TERMINAL_INTERACTION_INPUT_NOT_STARTED";
-    readonly stage = "input_not_started";
-    readonly doNotRetry = true;
-    readonly requiresFreshOffer = true;
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
+import { type TerminalCodexStatusProbeResult, type TerminalNativeInspectionDismissalOptions, type TerminalNativeInspectionDismissalResult, type TerminalNativeInspectionOptions, type TerminalNativeInspectionResult } from "./terminal-native-inspection-bridge.js";
+import { type TerminalCodexComposerObservation, type TerminalSendOptions, type TerminalSendResult } from "./terminal-text-submission-bridge.js";
+export { TerminalEnterDispatchNotAttemptedError, TerminalEnterDispatchReservedError, TerminalInputNotStartedError, type TerminalCodexComposerObservation, type TerminalSendBoundaryContext, type TerminalSendOptions, type TerminalSendResult, type TerminalTransportStage, type TerminalTransportStageEvent } from "./terminal-text-submission-bridge.js";
+export { captureTerminalInteractionRuntimeOffer, TerminalInteractionDispatchReservedError, TerminalInteractionInputNotStartedError, type TerminalInteractionAuthorizationContext, type TerminalInteractionAuthorizationDecision, type TerminalInteractionBeforeDispatchContext, type TerminalInteractionReservedStage, type TerminalInteractionResponseExecution, type TerminalInteractionRuntimeOffer } from "./terminal-interaction-response-bridge.js";
+export { inspectCodexAsyncQuestionInputMode, type CodexAsyncQuestionInputMode } from "./terminal-composer-classifier.js";
+export { exactCodexReadyStyledComposerCapture, isExactClaudeIdleComposer, isExactClaudeNativeInspectionIdleComposer, NativeInspectionDismissalError, NativeInspectionSubmissionError, type NativeInspectionSubmissionDiagnostic, type NativeInspectionSubmissionStage, type TerminalCodexStatusProbeResult, type TerminalNativeInspectionBeforeDismissContext, type TerminalNativeInspectionBeforeEnterContext, type TerminalNativeInspectionDismissalOptions, type TerminalNativeInspectionDismissalResult, type TerminalNativeInspectionMaterializationEvidence, type TerminalNativeInspectionMaterializationKind, type TerminalNativeInspectionOptions, type TerminalNativeInspectionResult } from "./terminal-native-inspection-bridge.js";
 export type TerminalActivityState = "awaiting_approval" | "working" | "idle" | "unknown";
 export type TerminalNativeIdentityState = "resolved" | "ambiguous" | "verified_absent" | "unavailable";
 export type TerminalDurableActivityState = "working" | "idle" | "unknown";
@@ -162,52 +78,6 @@ export interface TerminalBridgeStatus {
     interaction_surface_id?: string;
     capability_limitation?: string;
 }
-export interface TerminalInteractionAuthorizationContext {
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    fingerprint: string;
-    projection: TerminalInteractionAnyProjection;
-    response: TerminalInteractionResponseInput;
-    runtime?: TerminalRuntimeIdentity;
-}
-export interface TerminalInteractionAuthorizationDecision {
-    approved: boolean;
-    reason?: string;
-}
-export interface TerminalInteractionBeforeDispatchContext {
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    fingerprint: string;
-    projection: TerminalInteractionAnyProjection;
-    response: TerminalInteractionResponseInput;
-    runtime?: TerminalRuntimeIdentity;
-}
-export interface TerminalInteractionResponseExecution {
-    responded: boolean;
-    blocked: boolean;
-    reason?: string;
-    interactionId: string;
-    questionId?: string;
-    responseKind?: TerminalInteractionAnswer["response_kind"];
-    outcome?: "submitted_or_advanced" | "custom_text_opened" | "confirmed" | "cancelled";
-}
-/** Input is validated against the freshly recaptured v1/v2 projection. */
-type TerminalInteractionResponseInput = {
-    readonly interaction_id: string;
-    readonly turn_id?: string;
-    readonly subject?: TerminalInteractionSubject;
-    readonly answers: readonly TerminalInteractionAnswer[];
-};
-export interface TerminalInteractionRuntimeOffer {
-    readonly projection: TerminalInteractionAnyProjection;
-    readonly promptFingerprint: string;
-    readonly surfaceId: string;
-    readonly actionPlan: NativeQuestionnaireActionPlan;
-    readonly nativeInspection: Exclude<NativeQuestionnaireInspection, {
-        status: "none";
-    }>;
-}
-type TerminalInteractionBridgeOffer = TerminalInteractionRuntimeOffer;
 export interface ResolvedTerminalConversation {
     conversationId: string;
     agent: ExecutorKind;
@@ -246,55 +116,6 @@ export interface TerminalIdentityVerificationResult {
     terminalControl?: TerminalControlRef;
 }
 export type TerminalIdentityVerifier = (request: TerminalIdentityVerificationRequest) => Promise<TerminalIdentityVerificationResult | void>;
-export type TerminalTransportStage = "text_injected" | "enter_dispatched";
-export interface TerminalTransportStageEvent {
-    stage: TerminalTransportStage;
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    multiline: boolean;
-}
-export interface TerminalSendBoundaryContext {
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    multiline: boolean;
-    text: string;
-}
-export interface TerminalSendOptions {
-    runtime?: TerminalRuntimeIdentity;
-    /** Runs after identity verification and immediately before text injection. */
-    beforeText?: (context: TerminalSendBoundaryContext) => void | Promise<void>;
-    /** Runs after exact composer/identity proof and immediately before Enter. */
-    beforeEnter?: (context: TerminalSendBoundaryContext) => void | Promise<void>;
-    /** Require Codex's exact stable composer proof even for a single-line send. */
-    requireExactComposerBeforeEnter?: boolean;
-    /**
-     * User-explicit managed-path guard. Recapture an exactly empty composer
-     * immediately before the first text-delivery call so a stale list/preflight
-     * observation can fall back without appending to a human draft.
-     */
-    requireExactEmptyComposerBeforeText?: boolean;
-    /** User-explicit physical Send may steer a mutable working composer. */
-    allowWorkingComposerForUserExplicit?: boolean;
-    /**
-     * Codex user-explicit managed Send only: after an exactly empty pre-text
-     * boundary has accepted the request, cross Codex's paste-suppression window
-     * and dispatch Enter without using a rendered Composer proof as a veto.
-     */
-    userExplicitEnterAfterTextWithoutComposerVeto?: boolean;
-    /**
-     * Retry-only authority from a preliminary exact-empty observation. After
-     * `beforeText` reserves the attempt, the bridge independently recaptures the
-     * same empty composer and then immediately makes its sole text-delivery call.
-     */
-    requireExactEmptyComposerAfterBeforeText?: {
-        preliminaryComposerDigest: string;
-    };
-    /**
-     * Awaited immediately after each irreversible transport boundary so the
-     * caller can durably persist the exact proof level before continuing.
-     */
-    onTransportStage?: (event: TerminalTransportStageEvent) => void | Promise<void>;
-}
 export interface TerminalModelControlBridgeOptions {
     runtime?: TerminalRuntimeIdentity;
     /** Revalidate Store/Turn/current-snapshot authority before every UI step. */
@@ -317,27 +138,6 @@ export type TerminalModelControlResidualBridgeResult = TerminalModelControlResid
 export interface TerminalModelControlRepairBridgeResult extends Omit<TerminalModelControlRepairResult, "terminalControl"> {
     terminalControl: TerminalControlRef;
 }
-export interface TerminalSendResult {
-    stage: "enter_dispatched";
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    multiline: boolean;
-}
-interface TerminalCodexStableComposerObservationBase {
-    terminalControl: TerminalControlRef;
-    digest: string;
-    stableCaptures: number;
-}
-type TerminalCodexObservedComposerState = "exact_draft" | "exact_empty" | "different_draft" | "working" | "approval_or_modal";
-/** Closed, content-redacting observation of the current Codex composer. */
-export type TerminalCodexComposerObservation = {
-    [State in TerminalCodexObservedComposerState]: TerminalCodexStableComposerObservationBase & {
-        state: State;
-    };
-}[TerminalCodexObservedComposerState] | {
-    state: "identity_drift" | "unavailable";
-    reason: string;
-};
 export interface TerminalCodexDraftSubmissionContext {
     terminalControl: TerminalControlRef;
     text: string;
@@ -379,70 +179,6 @@ export interface TerminalCodexUserExplicitSendResult {
     textInjectionCount: 1;
     enterCount: 1;
 }
-export type TerminalNativeInspectionMaterializationKind = "exact_slash_composer" | "exact_slash_popup";
-export interface TerminalNativeInspectionMaterializationEvidence {
-    kind: TerminalNativeInspectionMaterializationKind;
-    digest: string;
-    stableForMs: number;
-    stableCaptures: number;
-}
-export interface TerminalNativeInspectionBeforeEnterContext {
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    plan: TerminalNativeInspectionPlan;
-    preEnterScreenDigest: string;
-    materialization: TerminalNativeInspectionMaterializationEvidence;
-}
-export interface TerminalNativeInspectionOptions {
-    runtime?: TerminalRuntimeIdentity;
-    /**
-     * Gives the CLI one final in-lock authorization point for its Store binding
-     * and action-token fences. The bridge recaptures the exact composer and
-     * revalidates terminal identity again after this hook before pressing Enter.
-     */
-    beforeEnter?: (context: TerminalNativeInspectionBeforeEnterContext) => void | Promise<void>;
-}
-export interface TerminalNativeInspectionResult {
-    stage: "enter_dispatched";
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    command: string;
-    behaviorProfile: string;
-    preEnterScreenDigest: string;
-    preEnterEvidenceInventory: readonly TerminalNativeInspectionEvidenceInventoryEntry[];
-    materialization: TerminalNativeInspectionMaterializationEvidence;
-    enterCount: 1;
-}
-export interface TerminalCodexStatusProbeResult extends TerminalNativeInspectionResult {
-    agent: "codex";
-    /** Identity-fenced ANSI capture proving an empty/dim placeholder composer. */
-    preTextScreenDigest: string;
-    /**
-     * Bare SHA-256 of the final pre-Enter 240-line capture. This deliberately
-     * matches `status().screen.digest` when observed with the returned depth.
-     */
-    observationBaselineDigest: string;
-    /** Capture depth required for same-domain post-Enter freshness checks. */
-    observationScrollbackLines: 240;
-}
-export interface TerminalNativeInspectionBeforeDismissContext {
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    plan: TerminalNativeInspectionPlan;
-    evidenceFingerprint: string;
-}
-export interface TerminalNativeInspectionDismissalOptions {
-    runtime?: TerminalRuntimeIdentity;
-    scrollbackLines?: number;
-    beforeDismiss?: (context: TerminalNativeInspectionBeforeDismissContext) => void | Promise<void>;
-}
-export interface TerminalNativeInspectionDismissalResult {
-    stage: "dismiss_dispatched";
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    keys: readonly string[];
-    dismissCount: 1;
-}
 export interface TerminalNativeInspectionObservationResult {
     terminalControl: TerminalControlRef;
     status: TerminalBridgeStatus;
@@ -517,7 +253,9 @@ export declare class TerminalAgentBridge {
     inspectModelControlResidual(agent: ExecutorKind, terminalControl: TerminalControlRef, agentVersion: string, plan: TerminalModelControlPlan, options?: TerminalModelControlBridgeOptions): Promise<TerminalModelControlResidualBridgeResult>;
     repairModelControlResidual(agent: ExecutorKind, terminalControl: TerminalControlRef, agentVersion: string, plan: TerminalModelControlPlan, expectedResidualFingerprint: string, options?: TerminalModelControlBridgeOptions): Promise<TerminalModelControlRepairBridgeResult>;
     private modelControlPorts;
-    private verifyModelControlTerminalIdentity;
+    private textSubmissionBridge;
+    private interactionResponseBridge;
+    private nativeInspectionBridge;
     send(agent: ExecutorKind, terminalControl: TerminalControlRef, text: string, options?: TerminalSendOptions): Promise<TerminalSendResult>;
     /** Observe only the current, live Codex composer without exposing its text. */
     observeCodexComposer(terminalControl: TerminalControlRef, expectedText: string, options?: {
@@ -536,9 +274,6 @@ export declare class TerminalAgentBridge {
      * text, clears the composer, or emits C-c, and contains exactly one C-m call.
      */
     submitExactCodexDraft(terminalControl: TerminalControlRef, expectedText: string, options: TerminalCodexDraftSubmissionOptions): Promise<TerminalCodexDraftSubmissionResult>;
-    private verifyExactComposerBeforeEnter;
-    private claudeInjectedPasteProofPorts;
-    private verifyExactEmptyComposerBeforeText;
     /**
      * Submit one closed, adapter-owned native inspection command.
      *
@@ -551,13 +286,9 @@ export declare class TerminalAgentBridge {
      * Submit Codex's closed, version-profiled `/status` probe.
      *
      * Unlike the generic native-inspection entry point, callers provide only
-     * the detected Codex version, never a command or plan. The bridge proves an
-     * exact empty (or fully dim replace-on-type) ANSI composer before injecting
-     * text, then crosses Codex's paste suppression window under the same exact
-     * composer and terminal-identity fences used by native inspection.
+     * the detected Codex version, never a command or plan.
      */
     submitCodexStatusProbe(terminalControl: TerminalControlRef, agentVersion: string, options?: TerminalNativeInspectionOptions): Promise<TerminalCodexStatusProbeResult>;
-    private submitClosedNativeInspection;
     observeNativeInspection(agent: ExecutorKind, terminalControl: TerminalControlRef, request: TerminalNativeInspectionObservationRequest, options?: {
         runtime?: TerminalRuntimeIdentity;
         scrollbackLines?: number;
@@ -568,13 +299,6 @@ export declare class TerminalAgentBridge {
      * attempt and no automated retry across an uncertain dismissal boundary.
      */
     dismissNativeInspection(agent: ExecutorKind, terminalControl: TerminalControlRef, plan: TerminalNativeInspectionPlan, request: TerminalNativeInspectionObservationRequest, expectedEvidenceFingerprint: string, options?: TerminalNativeInspectionDismissalOptions): Promise<TerminalNativeInspectionDismissalResult>;
-    private captureCodexReadyComposer;
-    private assertFinalCodexStatusViewport;
-    private settleNativeInspectionComposer;
-    private revalidateNativeInspectionComposer;
-    private settleCodexMultilineComposer;
-    private settleCodexComposerObservation;
-    private captureCodexComposerSnapshot;
     /**
      * Prove that the exact managed draft is still present after Enter dispatch.
      * Two identity-fenced captures are required so transient repaint state never
@@ -618,20 +342,7 @@ export declare class TerminalAgentBridge {
          */
         beforeKeyDispatch?: (context: TerminalApprovalKeyDispatchContext) => void | Promise<void>;
     }): Promise<TerminalApprovalExecution>;
-    respondInteraction(agent: ExecutorKind, terminalControl: TerminalControlRef, response: TerminalInteractionResponseInput, options: {
-        agentVersion: string;
-        expectedFingerprint: string;
-        expectedExpiresAt: string;
-        scrollbackLines?: number;
-        runtime?: TerminalRuntimeIdentity;
-        authorize?: (context: TerminalInteractionAuthorizationContext) => TerminalInteractionAuthorizationDecision | Promise<TerminalInteractionAuthorizationDecision>;
-        /**
-         * Resolve only after the caller has durably persisted its one-shot
-         * dispatch receipt. A successful return is the offer lease acceptance
-         * boundary for the final read-only recapture.
-         */
-        beforeDispatch?: (context: TerminalInteractionBeforeDispatchContext) => void | Promise<void>;
-    }): Promise<TerminalInteractionResponseExecution>;
+    respondInteraction(agent: ExecutorKind, terminalControl: TerminalControlRef, response: TerminalInteractionResponseInput, options: TerminalInteractionResponseOptions): Promise<TerminalInteractionResponseExecution>;
     monitorPoll(options: {
         agent: ExecutorKind;
         terminalControl: TerminalControlRef;
@@ -645,47 +356,10 @@ export declare class TerminalAgentBridge {
         durableRequest?: TerminalDurableCompletionRequest;
     }): Promise<TerminalMonitorPoll>;
     private captureInspection;
-    private captureTerminalInteractionOffer;
     private verifyTerminalIdentity;
 }
-/**
- * Prove Claude Code's exact current idle input frame. This is shared by every
- * automated-input path: a loose or historical `❯` prompt is not authority to
- * inject text into the terminal.
- */
-export declare function isExactClaudeIdleComposer(screen: string): boolean;
-/**
- * Compatibility export retained for callers that adopted the native-status
- * name before the same exact-frame proof was reused by lifecycle handoff.
- */
-export declare function isExactClaudeNativeInspectionIdleComposer(screen: string): boolean;
-export declare function exactCodexReadyStyledComposerCapture(screen: string): {
-    digest: string;
-} | undefined;
-export type CodexAsyncQuestionInputMode = "absent" | "collapsed" | "expanded" | "ambiguous";
-/**
- * Classify Codex 0.154's non-blocking inline-question surface by current input
- * ownership. The shared `Queued follow-up inputs` heading is not sufficient:
- * ordinary queued messages use it too. An exact collapsed summary, after any
- * ordinary queue preview is removed, proves Send-safe ownership even when the
- * Composer is outside the viewport. Positive editor evidence without a
- * complete shape remains fail-closed because paste plus Enter would otherwise
- * submit the user's task as an answer.
- */
-export declare function inspectCodexAsyncQuestionInputMode(styledScreen: string): CodexAsyncQuestionInputMode;
 export declare function terminalApprovalFingerprint(agent: ExecutorKind, terminalControl: TerminalControlRef, inspection: TerminalScreenInspection, options?: {
     screen?: string;
     runtime?: TerminalRuntimeIdentity;
     decision?: TerminalApprovalDecision;
 }): string | undefined;
-export declare function captureTerminalInteractionRuntimeOffer(input: {
-    agent: ExecutorKind;
-    terminalControl: TerminalControlRef;
-    screen: string;
-    runtime?: TerminalRuntimeIdentity;
-    now: Date;
-    approvalBlocked?: boolean;
-    /** Exact durable Watch endpoint evidence for legacy provider refs. */
-    trustedTerminalEvidence?: TerminalControlEvidence;
-}): TerminalInteractionBridgeOffer | undefined;
-export {};