import { claudeUserExplicitReadiness } from "./claude-user-explicit-input-proof.js"; import type { CodexOpenRootRolloutInventory } from "./agent-session-provider.js"; import type { ActiveTerminalProcess, TerminalAgentAdapter, TerminalNativeInspectionCapabilities, TerminalThreadLifecycleCapabilities } from "./terminal-agent-adapter.js"; import type { TerminalActivityState, TerminalBridgeStatus, TerminalDurableActivityState, TerminalNativeIdentityState } from "./terminal-agent-bridge.js"; import type { TerminalControlRef } from "./terminal-control-ref.js"; import { type TerminalModelControlCapabilities, type TerminalModelControlProfile, type TerminalModelControlResidualObservation } from "./terminal-model-control.js"; import type { TerminalNativeIdentity, TerminalNativeIdentityObservation } from "./terminal-binding-authority.js"; import type { TerminalDispatchLedgerDocument } from "./terminal-dispatch-ledger-codec.js"; import type { TerminalListIdentityRecheck } from "./terminal-list-native-identity-recheck.js"; import type { ClaudeTerminalAdmission } from "./claude-terminal-admission.js"; export interface TerminalListState { readonly approval_state: TerminalBridgeStatus["approval_state"] & { readonly screen_excerpt?: string; readonly error?: string; }; readonly activity_state: TerminalBridgeStatus["activity_state"]; readonly activity_reason: string; readonly screen_state: TerminalActivityState; readonly screen_reason: string; readonly capability_limitation?: string; readonly screen_excerpt?: string; readonly _terminal_status_snapshot?: TerminalBridgeStatus; } export interface EffectiveTerminalListState extends TerminalListState { readonly native_identity_state: TerminalNativeIdentityState; readonly durable_activity_state: TerminalDurableActivityState; readonly durable_activity_reason: string; } export interface TerminalNativeListIdentityFacts { readonly claudeAdmission?: ClaudeTerminalAdmission; readonly orphanedDispatch?: TerminalDispatchLedgerDocument; readonly nativeIdentityObservation: TerminalNativeIdentityObservation; readonly nativeIdentityRecheck?: TerminalListIdentityRecheck; readonly nativeWindowRole?: "background_view"; readonly nativeAgentIdentity?: TerminalNativeIdentity; readonly authorityNativeIdentityObservation: TerminalNativeIdentityObservation; readonly authorityNativeAgentIdentity?: TerminalNativeIdentity; readonly codexOpenRootRolloutInventory?: CodexOpenRootRolloutInventory; readonly nativeProcessUuid?: string; readonly nativeProcessBirth?: string; readonly nativeProcessEvidence?: string; } export interface TerminalListComposerFacts { readonly automatedInputComposerReady: boolean; readonly userExplicitComposerReady: boolean; readonly claudeUserExplicitReadiness?: ReturnType; /** Positive evidence that a non-Composer UI surface owns terminal input. */ readonly inputOwnerBlocked: boolean; } /** A deferred/disabled scan carries no input authority; failed capture is distinct from unsafe input. */ export declare function observeTerminalListState(input: { noApprovalScan?: boolean; listDiscoveryOnly?: boolean; discoveredActivity?: "idle" | "working" | "waiting"; observe(): Promise; }): Promise; /** A skipped or failed capture says nothing about the contents of the Composer. */ export declare function claudePhysicalSendReadinessFromListState(state: TerminalListState, options: { noApprovalScan?: boolean; listDiscoveryOnly?: boolean; }): ReturnType; /** Diagnostics do not carry the private transcript anchor or grant a physical fallback. */ export declare function claudeListAdmissionProjection(agent: string, facts: TerminalListTerminalFacts, send: boolean, deferred?: boolean): { managed_send_readiness?: undefined; thread_lifecycle_readiness?: undefined; _claude_managed_send_eligible?: undefined; } | { _claude_managed_send_eligible: boolean; managed_send_readiness?: undefined; thread_lifecycle_readiness?: undefined; } | { managed_send_readiness: { ready: boolean; reason: string; message: string; } | import("./claude-terminal-admission.js").ClaudeControlReadiness; thread_lifecycle_readiness: { ready: boolean; reason: string; message: string; } | import("./claude-terminal-admission.js").ClaudeControlReadiness; _claude_managed_send_eligible: boolean; }; export interface TerminalListPhysicalProcessIncarnation { readonly processUuid: string; readonly processBirth: string; readonly evidence?: string; } export interface TerminalListLatentClearResumeFacts { readonly sourceNativeThreadId: string; readonly fingerprint: string; } export interface TerminalListTerminalFacts { readonly physical: { readonly terminalId: string; readonly childPids: readonly number[]; readonly processIncarnation?: TerminalListPhysicalProcessIncarnation; }; readonly status: { /** One status observation supplies screen, activity, and approval facts. */ readonly observed: TerminalListState; readonly effective: EffectiveTerminalListState; readonly projected: EffectiveTerminalListState; readonly snapshot?: TerminalBridgeStatus; readonly statusCardNativeThreadId?: string; readonly hasInteraction: boolean; }; readonly native: TerminalNativeListIdentityFacts; readonly runtime: { readonly agentVersion?: string; readonly lifecycleCapability: TerminalThreadLifecycleCapabilities; readonly nativeInspectionCapability: TerminalNativeInspectionCapabilities; readonly modelControlCapability: TerminalModelControlCapabilities; readonly modelControlProfile?: TerminalModelControlProfile; readonly compatibilityWarnings: readonly string[]; }; readonly composer: TerminalListComposerFacts; readonly store: { readonly terminalHasBlockingTurn: boolean; readonly hasOrphanedDispatch: boolean; }; readonly codex: { readonly latentClearResume?: TerminalListLatentClearResumeFacts; readonly zeroRolloutModelControlVerified: boolean; }; readonly modelControlResidual?: TerminalModelControlResidualObservation; } export interface TerminalListTerminalFactPorts { observeStatus(agentVersion?: string): Promise; observeNativeIdentity(terminalId: string): Promise; projectEffectiveState(input: { terminalState: TerminalListState; native: TerminalNativeListIdentityFacts; }): EffectiveTerminalListState; observeAgentVersion(): string | undefined; observeTerminalHasBlockingTurn(): boolean; observeComposer(terminalState: EffectiveTerminalListState, agentVersion?: string): Promise; observePhysicalProcessIncarnation(): TerminalListPhysicalProcessIncarnation | undefined; observeLatentClearResume(input: { screen?: string; agentVersion?: string; }): TerminalListLatentClearResumeFacts | undefined; observeModelControlResidual(input: { agentVersion?: string; modelControlCapability: TerminalModelControlCapabilities; modelControlProfile?: TerminalModelControlProfile; native: TerminalNativeListIdentityFacts; zeroRolloutVerified: boolean; effectiveTerminalState: EffectiveTerminalListState; terminalHasInteraction: boolean; terminalHasBlockingTurn: boolean; hasOrphanedDispatch: boolean; }): Promise; projectStatusSnapshot(status: TerminalBridgeStatus, projection: EffectiveTerminalListState): TerminalBridgeStatus; } /** * Collect the immutable observation facts for one already-discovered terminal. * * This boundary does not create action authority, generate tokens, render * public JSON, write Store state, or send terminal input. Each observation port * is invoked at most once. The status result is the single source for screen, * activity, approval, and interaction facts; later styled-Composer and native * model-control observations remain explicitly separate fail-closed captures. */ export declare function collectTerminalListTerminalFacts(input: { session: ActiveTerminalProcess; terminalControl: TerminalControlRef; terminalId: string; childPids: readonly number[]; adapter: TerminalAgentAdapter; ports: TerminalListTerminalFactPorts; }): Promise;