@zergai/ztc 0.4.0-beta.1 → 0.5.0-beta.1

package/dist/cli_ratatui.d.ts

@@ -1,3 +1,4 @@
+import { type DesktopRuntime } from './desktop/runtime.js';
 import { TuiProcess, NullTuiProcess, HeadlessPaneManager } from './ui/ratatui/index.js';
 import { getMirrorCommandUsages, isRichSlashUsage } from './agent/commands/mirror_usages.js';
 import { type Session } from './session.js';
@@ -11,6 +12,7 @@ import { registerInstance, deregisterInstance, updateInstance } from './instance
 import type { HookApprovalDecision } from './hooks/types.js';
 export { debugLog, getLogBuffer } from './utils/debug_log.js';
 interface RatatuiAppOptions {
+    detachEnvironment?: boolean;
     resumeSession?: Session;
     /**
      * Open the interactive resume page instead of resuming a specific session.
@@ -30,10 +32,14 @@ interface RatatuiAppOptions {
     navigatorHidden?: boolean;
     mux?: boolean;
     desktop?: boolean;
+    desktopRuntime?: DesktopRuntime | null;
     numZergsGrid?: {
         cols: number;
         rows: number;
     };
+    layoutPreset?: string;
+    layoutRefreshMs?: number;
+    layoutWorkers?: number;
     pane?: boolean;
     headlessMirror?: boolean;
     interactiveHeadless?: boolean;
@@ -102,7 +108,7 @@ export declare class RatatuiApp {
      * has to remember to clear this.
      */
     private verticalRun;
-    /** Draft parked when Up leaves it for history, restored by Down (Codex parity). */
+    /** Composer parked during history recall; Down or submission restores it. */
     private historyDraft;
     /**
      * Text the composer's kills removed (Ctrl+U, Ctrl+K, Ctrl+W, word deletes),
@@ -111,6 +117,7 @@ export declare class RatatuiApp {
      */
     private killRing;
     private killRingIndex;
+    private showYankHint;
     private static readonly KILL_RING_MAX;
     private agent;
     /** Mode the current `agent` was built for. Lets runAgent rebuild the agent
@@ -124,6 +131,7 @@ export declare class RatatuiApp {
     private agentBuiltForPlanFile;
     private readonly maxIterations?;
     private readonly initialPrompt?;
+    private initialPaneInput;
     private readonly instanceTitleProvider;
     private readonly instanceRegistry;
     /** Registry liveness heartbeat + stopped-peer reaper; cleared on exit. */
@@ -136,10 +144,14 @@ export declare class RatatuiApp {
     private resolveStartupReady;
     private startupFailure;
     private pendingAgentBind;
+    private readonly sessionToolResponseStore;
+    private sessionToolResponseBinding;
     /** Sticky failure for the current agent generation. A bind can reject before
      * the next turn observes its promise, so clearing only the promise would let
      * that unbound agent run. */
     private agentBindFailure;
+    /** Replay an explicit Clear after a first/loading store finishes restoring disk state. */
+    private sessionEvidenceClearPendingBind;
     private cols;
     private rows;
     private liveViewportHeight;
@@ -153,6 +165,11 @@ export declare class RatatuiApp {
     private lastAgentEventAt;
     private readonly stallHintMs;
     private shellCwd;
+    private detachEnvironment;
+    private readonly startupCatalogController;
+    private environmentRecord;
+    private environmentReturnCwd;
+    private environmentSessionCwd;
     private runLifecycle;
     private printedMessageIds;
     private pendingScrollbackLines;
@@ -179,9 +196,30 @@ export declare class RatatuiApp {
     private lastInputToRenderMs;
     private debug;
     private exitResolve;
+    private readonly exitComplete;
     private exiting;
     private desktopUpdateOwnerPhase;
     private lastPaneActivitySignature;
+    private readonly desktopTaskOwnerId;
+    private desktopTaskRunOwner;
+    private desktopTaskRunId;
+    private desktopTaskRevision;
+    private desktopTaskSignature;
+    private desktopTaskState;
+    private runtimeMutationInFlight;
+    private accountReloadPending;
+    private runtimeAccounts;
+    private runtimeUsage;
+    private runtimeUsageScope;
+    private runtimeProjectionRefresh;
+    private runtimeProjectionRefreshScope;
+    private runtimeProjectionRefreshAt;
+    private runtimeProjectionObservedAt;
+    private readonly desktopRuntimeRequests;
+    private desktopShareEffectInFlight;
+    private desktopShareCapture;
+    private readonly desktopShareRequests;
+    private desktopTaskRelayUnsubscribe;
     private currentRunStreamed;
     private _promptTooLongRetried;
     private toolGroups;
@@ -197,9 +235,35 @@ export declare class RatatuiApp {
     /** Busy Enter prompts waiting for the next completed tool batch. */
     private pendingSteering;
     private nativeSteeringInFlight;
+    private steeringAdmissionCount;
     private nativeSteeringTail;
+    private busyInputEpoch;
+    private busyInputControllers;
+    private busyInputTail;
+    private busyScopeChoice;
+    private busyScopeChoicePending;
     private pendingBusTrigger;
     private flushingQueue;
+    private agentTurnOwner;
+    private readonly agentTurnSettlements;
+    private cancelledTurnOwner;
+    private escapeStopArm;
+    private pendingAgentTurn;
+    private waitingInteraction;
+    private queuePaused;
+    private workspaceCoordinator;
+    private workspacePaused;
+    private workspaceResuming;
+    private workspacePausedSnapshot;
+    private workspacePausedEffectCwd;
+    private workspacePausedQueueId;
+    private workspacePendingInputs;
+    private workspaceDeferredRun;
+    private workspaceAdmissionTail;
+    private workspaceChoice;
+    private workspaceEpoch;
+    private workspaceLifetime;
+    private workspaceResumeWaiters;
     private queueEdit;
     private streamDeltaBuffer;
     private streamDeltaFlushTimer;
@@ -218,6 +282,8 @@ export declare class RatatuiApp {
     private readonly INPUT_BUFFER_DELAY;
     /** Pending render scheduled via queueMicrotask for the immediate path. */
     private pendingInputRender;
+    private clipboardTargetRevision;
+    private clipboardPastePending;
     private sessionId;
     /**
      * User-set session name (`/rename <name>` or `--name <name>`). Surfaced in
@@ -225,6 +291,8 @@ export declare class RatatuiApp {
      * on the CommandContext.
      */
     private sessionName;
+    private sessionLabels;
+    private lastInferredPaneTitle;
     private sessionManager;
     private readonly sessionFile?;
     private hostedSessionSettings;
@@ -233,6 +301,14 @@ export declare class RatatuiApp {
     private planMode;
     private currentPlan;
     private resumedSession;
+    private taskHandoff;
+    private restoredHandoffCorrections;
+    private handoffQueueSaveInFlight;
+    private handoffQueueSubmissionCount;
+    private handoffQueueReservedSlots;
+    private handoffQueueSubmissionTail;
+    private capturedQueueDrafts;
+    private queueAdmissionLifetime;
     private resumePicker;
     /** Session id awaiting a second Enter while the agent is mid-turn. */
     private resumeConfirmEntryId;
@@ -240,6 +316,9 @@ export declare class RatatuiApp {
     private formWidget;
     private selectWidget;
     private textInputWidget;
+    private legacyCommandPrompt;
+    private lastPromptWidgetId;
+    private legacyCommandPromptWidgetId;
     private questionnaireWidget;
     private settingsPanelWidget;
     private statusLinePanelWidget;
@@ -275,11 +354,13 @@ export declare class RatatuiApp {
     private pendingAskUser;
     private askUserData;
     private askUserAnswerPending;
+    private activeQuestionId;
     private pendingQuestionnaireCallback;
     private pendingQuestionnaireQuestions;
     private hookLifecycle;
     private pendingHookApprovals;
     private approvalQueue;
+    private activeApprovalWidgetId;
     private startupModePath;
     private startupZlicky;
     private mirrorServer;
@@ -292,7 +373,6 @@ export declare class RatatuiApp {
     private muxOnlyMirror;
     private mirrorClient;
     private pendingWidgetCallbacks;
-    private widgetIdCounter;
     private activeSettingsWidgetId;
     private muxMode;
     /**
@@ -330,6 +410,7 @@ export declare class RatatuiApp {
     private transcriptShipped;
     private static TRANSCRIPT_REBUILD_THROTTLE_MS;
     private desktopMode;
+    private desktopRuntime;
     private childPaneIds;
     private colonyPaneIds;
     /** Cache of latest pane list from pane_state events (including colony panes, filtered in switcher) */
@@ -354,6 +435,7 @@ export declare class RatatuiApp {
     private computerUseMode;
     private mlMode;
     private numZergsGrid;
+    private readonly startupLayout;
     private embeddedController;
     private benchController;
     private embeddedSystemName;
@@ -361,6 +443,8 @@ export declare class RatatuiApp {
     private benchName;
     private benchWorkflowId;
     private backgroundPollTimer;
+    private intakePollTimer;
+    private intakeNotifications;
     private readonly BACKGROUND_POLL_INTERVAL;
     private zmuxLayoutPaneCount;
     private paneRelay;
@@ -368,6 +452,10 @@ export declare class RatatuiApp {
     private supervisionManager;
     private recapController;
     private turnStartTime;
+    private activePromptTurn;
+    private streamingPromptTurn;
+    private promptRunTurns;
+    private promptMetadataTimer;
     private turnStartMessageCount;
     private turnStartTokens;
     private turnStartMode;
@@ -418,7 +506,26 @@ export declare class RatatuiApp {
     private ownPaneTitle;
     private syncOwnPaneTitle;
     private paneActivityTransport;
+    private syncTerminalInteraction;
     private syncOwnPaneActivity;
+    private desktopTaskBlockedReason;
+    private runtimeSwitchBlockedReason;
+    private reloadAccountAgent;
+    private applyAccountOperation;
+    private refreshRuntimeProjection;
+    private currentRuntimeUsage;
+    private desktopRuntimeProjection;
+    private handleDesktopRuntimeAction;
+    private openDesktopModelPicker;
+    private currentSessionEvidenceSnapshot;
+    /** Synchronous, detached capture of canonical retained state; no artifact retrieval or inference. */
+    private captureSessionEvidencePackage;
+    private desktopSessionShareProjection;
+    private desktopShareEvidenceRevision;
+    private handleDesktopSessionShareAction;
+    /** This projection describes live accepted queue sources; checkpoints do not grant dispatch ownership. */
+    private syncOwnPaneTaskControls;
+    private handleDesktopTaskAction;
     /**
      * Recreate the live agent in place (new backend resolved from current config)
      * and re-arm the hook watcher. Shared by /accounts use — both the CLI command
@@ -433,6 +540,7 @@ export declare class RatatuiApp {
      * Live changes are pushed over the socket afterwards (`set_keybindings`).
      */
     private zmuxKeymapEnv;
+    private clearLegacyCommandPrompt;
     private buildCommandContext;
     /**
      * Panels that replace the transcript while open.
@@ -447,6 +555,9 @@ export declare class RatatuiApp {
      * plain terminal and loses half the page under zmux.
      */
     private get fullPageSurfaceOpen();
+    private fullPageInteractionOccupied;
+    /** Shared keyboard ownership for rendering and pending composer work. */
+    private get widgetOwnsInput();
     /**
      * Run a slash command on behalf of the UI itself (no plan-mode gate, no
      * agent round trip). Used when zmux's shortcut page hands off to the editor.
@@ -458,6 +569,9 @@ export declare class RatatuiApp {
      */
     private executeCommandForTool;
     private startMirrorFromCommand;
+    private resolveOwnQuestion;
+    private handleQuestionAnswer;
+    private handleApprovalAnswer;
     private stopMirrorFromCommand;
     private handleDictationEvent;
     /**
@@ -519,6 +633,8 @@ export declare class RatatuiApp {
     /** Materialize plan state after first paint but before any agent can exist. */
     private ensureStartupPlanArtifact;
     private awaitStartupReady;
+    /** Retire awaited startup continuations without reporting user exit as failure. */
+    private assertStartupActive;
     start(): Promise<void>;
     private startRuntime;
     private checkForUpdates;
@@ -535,6 +651,7 @@ export declare class RatatuiApp {
     private shouldIgnorePaneClosed;
     private publishPaneSystemMessage;
     private trackPendingPaneLaunch;
+    private createWorkspaceLayoutOwner;
     private formatTime;
     private waitForTuiEvent;
     /**
@@ -563,12 +680,7 @@ export declare class RatatuiApp {
     private handleMirrorSupervisionCommand;
     private handleMirrorPaneViewportRead;
     private restoreMuxSessionIfNeeded;
-    /**
-     * Remove stale mux_state from the session file on disk so that
-     * the next resume starts clean with a single pane instead of
-     * repeatedly failing to restore broken state.
-     */
-    private discardStaleMuxState;
+    private resumeWorkspacePane;
     /**
      * Initialize Colony Agent Bridge. Called from start() after tui.start()
      * so the transport is ready to accept create_pane commands.
@@ -581,6 +693,7 @@ export declare class RatatuiApp {
      */
     private printStartupBanner;
     private typewriteMessage;
+    private hasPendingProseReveal;
     /**
      * Keep the reveal moving after the last delta of a burst has landed. The tick
      * only re-runs the path that draws the transcript (atomic rebuild in mux
@@ -688,6 +801,8 @@ export declare class RatatuiApp {
     private routeCancel;
     /** Cancel the current generation if one is active. */
     private cancelIfRunning;
+    private resetEscapeStop;
+    private getEscapeHint;
     /**
      * Add an error message that is visible in both local UI and mirror observers.
      */
@@ -714,7 +829,11 @@ export declare class RatatuiApp {
     private viewportHeightFor;
     private handleTuiEvent;
     private updateSelectionCompletion;
+    private retireClipboardPaste;
+    private clipboardInputTarget;
     private handleInput;
+    private startClipboardPaste;
+    private handleInputNow;
     /**
      * Show a window+pane switcher overlay (Ctrl+B W).
      *
@@ -758,12 +877,44 @@ export declare class RatatuiApp {
      */
     private setInputToText;
     private handleSubmit;
+    private localWorkspace;
+    private retireWorkspaceChoice;
+    /** Only accepted-but-unadmitted sources belong to this local pause. */
+    private retainWorkspaceInput;
+    private chooseWorkspaceAction;
+    private pauseWorkspace;
+    private guardWorkspaceAdmission;
+    private waitForWorkspaceContinuation;
+    private admitWorkspaceTool;
+    private continueWorkspace;
+    private isolateWorkspace;
+    /** Classify independently; admission decisions retain submission FIFO. */
+    private routeBusyInput;
+    private routingInteractionOccupied;
+    /** A transient choice shares the existing terminal and mirror widget contract. */
+    private chooseBusyInputRoute;
+    private retireBusyInputRouting;
+    /** Restore only an empty composer; retain a competing draft in the transcript. */
+    private restoreBusyDraft;
+    private admitBusySteering;
     /**
      * Run the agent on the current messages.
      * Extracted from handleSubmit so it can be reused by triggerAgentTurn
      * (e.g., after plan approval where messages are already added).
      */
     private runAgent;
+    /** Reserve an explicit continuation before any idle subscriber can drain Tab. */
+    private requestAgentTurn;
+    /** Keep native and browser answers on the same one-shot interaction owner. */
+    private guardInteractionCallback;
+    private completeBrowserAskUserAnswer;
+    /** Parent-routed answers are distinct from ordinary input on the pane bus. */
+    private acceptChildAskUserAnswer;
+    private dispatchPendingAgentWork;
+    private runAgentTurn;
+    private beginPromptTurn;
+    private syncPromptTurn;
+    private isOpenPromptMessage;
     /**
      * Fold the just-finished turn into the goal when the goal went terminal during
      * it. Keyed on the turn-start snapshot so a goal that was already terminal
@@ -790,6 +941,7 @@ export declare class RatatuiApp {
     private syncGoalPin;
     private maybeContinueGoal;
     /** Post a /goal status line to both the terminal transcript and the mirror. */
+    private publishCurrentGoal;
     private postGoalNote;
     /**
      * Kick off a post-turn recap if any trigger fires. See app/recap.ts.
@@ -804,6 +956,8 @@ export declare class RatatuiApp {
      * method would re-enter and dequeue twice, scrambling FIFO order.
      */
     private maybeFlushQueue;
+    /** Publish each accepted source once, at its actual admission boundary. */
+    private revealAdmittedSteering;
     /** Put steering that missed a tool boundary after the finished answer. */
     private movePendingSteeringToEnd;
     /** True while an agent turn is active (same definition as handleSubmit's busy check). */
@@ -837,6 +991,9 @@ export declare class RatatuiApp {
      * the stale draft is dropped instead of being queued.
      */
     private queueDraftViaTab;
+    /** Captured input has a transcript owner, but no accepted dispatch authority. */
+    private retainCapturedQueueDraft;
+    private settleCapturedQueueDrafts;
     /**
      * Option+Up: load the newest queued prompt into the composer for editing.
      * Returns false when nothing is queued so the caller can fall back to history.
@@ -867,6 +1024,8 @@ export declare class RatatuiApp {
      * when the queue is empty.
      */
     private removeEditedQueueEntry;
+    private persistQueuedCorrectionEdit;
+    private persistQueuedCorrectionOrder;
     private loadQueueEntryIntoComposer;
     private cloneInputState;
     /** Queue index currently loaded into the composer by the editor, if any. */
@@ -903,7 +1062,13 @@ export declare class RatatuiApp {
      */
     private getEffectiveAgentMode;
     private commandJobsUnsubscribe;
+    private commandPaneManagers;
+    private commandPaneBindings;
+    private ensureCommandPanes;
+    private projectCommandPanes;
     private commandJobStates;
+    private activeToolCheckpointHandler;
+    private toolCheckpointTurn;
     private createAgent;
     private awaitAgentBind;
     private bindAgentStore;
@@ -921,9 +1086,8 @@ export declare class RatatuiApp {
      * child sessions. The same policy gates auto-save, exit saving, and the
      * resume hint so a fresh launch can be resumed after it exits.
      *
-     * Non-colony pane children (regular sub-panes) are ephemeral —
-     * they don't persist sessions since the parent no longer restores
-     * child ZTC panes from mux_state.
+     * Empty ordinary child panes stay ephemeral. Active work persists without
+     * changing the parent's policy for restoring child layouts.
      */
     private shouldPersistSession;
     /**
@@ -957,6 +1121,10 @@ export declare class RatatuiApp {
     /**
      * Lazily create the SessionManager with current deps.
      */
+    private publishTaskHandoff;
+    private recordHandoffCorrection;
+    private captureHandoffCorrections;
+    private markHandoffDelivery;
     private ensureSessionManager;
     /**
      * Whether a message draws a row in the transcript.
@@ -1040,8 +1208,6 @@ export declare class RatatuiApp {
      * same guards, session bookkeeping, and directory handling.
      */
     private spawnZtcPane;
-    /** Hand a task to a freshly created ZTC pane as its first message. */
-    private sendTaskToZtcPane;
     /**
      * The Ctrl+B c chooser: bash, a ZTC pane, or any custom option the user added
      * in `/settings`.
@@ -1095,6 +1261,7 @@ export declare class RatatuiApp {
      * SSE drain — while the session save IS awaited because it's the user's data.
      */
     private finalizeShutdown;
+    private settleAgentTurnsForExit;
     /**
      * Restart this ZTC instance. Colony children delegate to the parent bridge
      * so the whole cell pane, mirror, and runtime entrypoint are recreated.
@@ -1147,10 +1314,10 @@ export declare class RatatuiApp {
      */
     private openResumePanel;
     /**
-     * Esc-while-idle prompt picker. Lists the prompts of this session and rewinds
+     * Explicit /rewind prompt picker. Lists the prompts of this session and rewinds
      * to the chosen one: everything from that prompt on leaves the transcript and
-     * the prompt returns to the composer for editing. Interrupting (Esc during a
-     * run) only stops the agent; this is the explicit way to take an exchange back
+     * the prompt returns to the composer for editing. Confirmed Escape during a
+     * run only stops the agent; this is the explicit way to take an exchange back
      * out of context.
      */
     private openRewindPanel;