@gajae-code/coding-agent 0.11.10 → 0.12.0

package/dist/types/gjc-runtime/team-launch.d.ts

@@ -2,7 +2,7 @@ import type { GjcTeamConfig, GjcTeamSnapshot, GjcTeamStartOptions, GjcTeamTask,
 /** Launch-specific option wiring kept separate from runtime dispatch. */
 export declare function withTeamLaunchTransport(options: GjcTeamStartOptions, mailboxDeliveryTransport: GjcTeamStartOptions["mailboxDeliveryTransport"]): GjcTeamStartOptions;
 /** @internal Exported for unit tests. */
-export declare function buildWorkerCommand(config: GjcTeamConfig, worker: GjcTeamWorker, platform?: NodeJS.Platform): string;
+export declare function buildWorkerCommand(config: GjcTeamConfig, worker: GjcTeamWorker, platform?: NodeJS.Platform, promptOverride?: string): string;
 interface GjcTmuxBinary {
     command: string;
     isPsmux: boolean;

package/dist/types/gjc-runtime/team-runtime.d.ts

@@ -186,6 +186,7 @@ export interface WorkerHeartbeatFile {
     last_turn_at: string;
     turn_count: number;
     alive: boolean;
+    process_start_time?: string;
 }
 export interface GjcWorkerIntegrationAttemptRequestResult {
     requested: boolean;
@@ -199,7 +200,7 @@ export interface GjcWorkerIntegrationAttemptRequestResult {
 export interface GjcWorkerIntegrationAttemptOptions {
     signal?: AbortSignal;
 }
-export declare const GJC_TEAM_API_OPERATIONS: readonly ["send-message", "broadcast", "mailbox-list", "mailbox-mark-delivered", "mailbox-mark-notified", "notification-list", "notification-read", "notification-replay", "notification-mark-pane-attempt", "worker-startup-ack", "create-task", "read-task", "list-tasks", "update-task", "claim-task", "transition-task-status", "transition-task", "release-task-claim", "read-config", "read-manifest", "read-worker-status", "update-worker-status", "read-worker-heartbeat", "recover-stale-claims", "update-worker-heartbeat", "write-worker-inbox", "write-worker-identity", "append-event", "read-events", "read-traces", "await-event", "write-shutdown-request", "read-shutdown-ack", "read-monitor-snapshot", "write-monitor-snapshot", "read-task-approval", "write-task-approval"];
+export declare const GJC_TEAM_API_OPERATIONS: readonly ["send-message", "broadcast", "mailbox-list", "mailbox-mark-delivered", "mailbox-mark-notified", "notification-list", "notification-read", "notification-replay", "notification-mark-pane-attempt", "worker-startup-ack", "create-task", "read-task", "list-tasks", "update-task", "claim-task", "transition-task-status", "transition-task", "release-task-claim", "read-config", "read-manifest", "read-worker-status", "update-worker-status", "read-worker-heartbeat", "recover-stale-claims", "update-worker-heartbeat", "read-worker-memory-guard", "update-worker-memory-guard", "apply-worker-memory-guard", "write-worker-inbox", "write-worker-identity", "append-event", "read-events", "read-traces", "await-event", "write-shutdown-request", "read-shutdown-ack", "read-monitor-snapshot", "write-monitor-snapshot", "read-task-approval", "write-task-approval"];
 export interface GjcTeamRuntimeTestSeams {
     nowMs?: () => number;
     continuationTmuxDispatch?: (command: string, args: readonly string[]) => {

package/dist/types/gjc-runtime/team-store.d.ts

@@ -107,6 +107,18 @@ export interface GjcTeamApiClaimResult {
     claim_token?: string;
     reason?: string;
 }
+export type GjcTeamWorkerClaimSelection = {
+    kind: "none";
+} | {
+    kind: "exact";
+    task: GjcTeamTask;
+    claim: GjcTeamTaskClaim;
+} | {
+    kind: "ambiguous";
+    tasks: GjcTeamTask[];
+};
+export declare function selectCurrentClaimedTaskForWorker(tasks: readonly GjcTeamTask[], workerId: string): GjcTeamWorkerClaimSelection;
+export declare function findGjcTeamClaimedTaskForWorker(tasks: readonly GjcTeamTask[], workerId: string): GjcTeamTask | undefined;
 type EventAppender = (event: {
     type: string;
     task_id?: string;

package/dist/types/gjc-runtime/team-worker-memory-guard.d.ts

@@ -0,0 +1,92 @@
+import { type StateWriterOptions } from "./state-writer";
+export type GjcTeamWorkerMemoryGuardState = "idle" | "advisory" | "retrying" | "checkpointed" | "replaced" | "blocked";
+export type GjcTeamWorkerMemoryGuardCheckpointKind = "clean" | "eligible" | "protected_only" | "conflicted" | "git_error";
+export type GjcTeamWorkerMemoryGuardPidProbe = {
+    kind: "live";
+    start_time: string;
+} | {
+    kind: "absent";
+} | {
+    kind: "unverifiable";
+    reason: string;
+};
+export interface GjcTeamWorkerMemoryGuardCheckpoint {
+    kind: GjcTeamWorkerMemoryGuardCheckpointKind;
+    files: string[];
+    head?: string | null;
+    commit?: string | null;
+    recorded_at: string;
+}
+export interface GjcTeamWorkerMemoryGuardReplacement {
+    old_pane_id?: string;
+    new_pane_id?: string;
+    recorded_at: string;
+}
+export interface GjcTeamWorkerMemoryGuardLedger {
+    schema_version: 1;
+    worker_id: string;
+    platform: string;
+    state: GjcTeamWorkerMemoryGuardState;
+    automatic_action_allowed: boolean;
+    retry_count: number;
+    retry_limit: number;
+    current_task_id?: string;
+    last_incident_id?: string;
+    last_reason?: string;
+    last_pid_probe?: GjcTeamWorkerMemoryGuardPidProbe;
+    last_checkpoint?: GjcTeamWorkerMemoryGuardCheckpoint;
+    last_replacement?: GjcTeamWorkerMemoryGuardReplacement;
+    updated_at: string;
+}
+export interface GjcTeamWorkerMemoryGuardSelectionCandidate {
+    worker_id: string;
+    platform: string;
+    excess_bytes: number;
+    retry_count: number;
+    retry_limit: number;
+    blocked?: boolean;
+    current_task_id?: string;
+}
+export interface GjcTeamWorkerMemoryGuardSelection {
+    worker_id: string;
+    excess_bytes: number;
+    retry_count: number;
+    current_task_id?: string;
+}
+export declare function workerMemoryGuardLedgerPath(dir: string, workerId: string): string;
+export declare function normalizeGjcTeamWorkerMemoryGuardPidProbe(value: unknown): GjcTeamWorkerMemoryGuardPidProbe | undefined;
+export declare function isCanonicalGjcTeamWorkerMemoryGuardCheckpoint(value: unknown): value is GjcTeamWorkerMemoryGuardCheckpoint;
+export declare function isCanonicalGjcTeamWorkerMemoryGuardReplacement(value: unknown): value is GjcTeamWorkerMemoryGuardReplacement;
+export declare function isCanonicalGjcTeamWorkerMemoryGuardPidProbe(value: unknown): value is GjcTeamWorkerMemoryGuardPidProbe;
+export declare function isCanonicalGjcTeamWorkerMemoryGuardLedger(value: unknown): value is GjcTeamWorkerMemoryGuardLedger;
+export declare function createInitialGjcTeamWorkerMemoryGuardLedger(input: {
+    workerId: string;
+    platform: string;
+    now: string;
+    retryLimit?: number;
+}): GjcTeamWorkerMemoryGuardLedger;
+export declare function selectGjcTeamWorkerMemoryGuardCandidate(candidates: readonly GjcTeamWorkerMemoryGuardSelectionCandidate[]): GjcTeamWorkerMemoryGuardSelection | undefined;
+export type TeamWorkerMemoryGuardAction = "advisory" | "replace" | "blocked";
+export type TeamWorkerMemoryGuardResult = "noop" | "scheduled" | "succeeded" | "failed" | "blocked";
+export interface TeamWorkerMemoryGuardLedgerEntry {
+    schema_version: 1;
+    recorded_at: string;
+    incident_id: string;
+    team_name: string;
+    worker_id: string;
+    task_id: string;
+    claim_token: string;
+    attempt: number;
+    platform: NodeJS.Platform;
+    action: TeamWorkerMemoryGuardAction;
+    result: TeamWorkerMemoryGuardResult;
+    reason: string;
+}
+export declare function isCanonicalTeamWorkerMemoryGuardLedgerEntry(value: unknown): value is TeamWorkerMemoryGuardLedgerEntry;
+export declare function teamWorkerMemoryGuardDir(workerDirPath: string): string;
+export declare function teamWorkerMemoryGuardLedgerPath(workerDirPath: string): string;
+export declare function canMutateTeamWorkerMemoryGuard(platform: NodeJS.Platform): boolean;
+export declare function advisoryReasonForTeamWorkerMemoryGuard(platform: NodeJS.Platform): string | undefined;
+export declare function appendTeamWorkerMemoryGuardLedgerEntry(workerDirPath: string, entry: TeamWorkerMemoryGuardLedgerEntry, options?: StateWriterOptions): Promise<string>;
+export declare function readTeamWorkerMemoryGuardLedger(workerDirPath: string): Promise<TeamWorkerMemoryGuardLedgerEntry[]>;
+export declare function nextTeamWorkerMemoryGuardAttempt(entries: readonly TeamWorkerMemoryGuardLedgerEntry[], incidentId: string): number;

package/dist/types/gjc-runtime/tmux-owner-isolation.d.ts

@@ -267,6 +267,13 @@ export interface LifecyclePaths {
     journalFile: string;
 }
 export declare function lifecyclePaths(stateDir: string, sessionId: string, generation: string): LifecyclePaths;
+export interface MemoryGuardClaimPaths {
+    root: string;
+    databaseFile: string;
+    walFile: string;
+    shmFile: string;
+}
+export declare function memoryGuardClaimPaths(stateDir: string, sessionId: string): MemoryGuardClaimPaths;
 export declare function replaceOwnerGeneration(stateDir: string, sessionId: string, generation?: string, expectedBaseline?: OwnerGenerationBaseline): Promise<string>;
 export type OwnerGenerationBaseline = {
     state: "absent";

package/dist/types/gjc-runtime/ultragoal-receipt-freshness.d.ts

@@ -39,6 +39,14 @@ export declare function computeUltragoalPlanGeneration(input: {
     basis: UltragoalCompletionVerification["basis"];
 };
 export declare function findLedgerReceiptEvent(ledger: readonly UltragoalLedgerEvent[], receipt: UltragoalCompletionVerification): UltragoalLedgerEvent | null;
+/**
+ * A final-aggregate receipt whose recorded ledger checkpoint quality gate is
+ * missing a clean `criticReview` OKAY can never satisfy the completion guard,
+ * yet is not "stale" under {@link validateReceiptFreshBase}. Detect it so an
+ * identical-evidence complete replay can re-verify and re-mint with a
+ * corrected gate instead of no-opping into a permanently blocked run.
+ */
+export declare function finalAggregateReceiptMissingCriticOkay(ledger: readonly UltragoalLedgerEvent[], receipt: UltragoalCompletionVerification): boolean;
 export declare function validateReceiptFreshBase(input: {
     plan: UltragoalPlan;
     ledger: readonly UltragoalLedgerEvent[];

package/dist/types/gjc-runtime/workflow-manifest.d.ts

@@ -1,6 +1,7 @@
 /**
  * TypeScript is the authoritative source of truth for GJC workflow manifests.
- * Keep the checked-in JSON projection synchronized manually with this module.
+ * Any JSON manifest projection is derived from this module and must never be
+ * hand-edited.
  */
 import { type CanonicalGjcWorkflowSkill } from "../skill-state/canonical-skills";
 export interface WorkflowState {
@@ -17,9 +18,7 @@ export interface WorkflowVerb {
     name: string;
     planned?: boolean;
     /** Invocation surface that exposes this verb in the real CLI parser. */
-    surface?: "state-action" | "command-positional" | "command-flag" | "draft-action";
-    /** Legacy surface retained for callers that have not migrated to normal typed commands. */
-    compatibilityOnly?: boolean;
+    surface?: "state-action" | "command-positional" | "command-flag";
 }
 export interface TypedArgSpec {
     name: string;
@@ -27,7 +26,6 @@ export interface TypedArgSpec {
     enumValues?: string[];
     required?: boolean;
     appliesToVerbs?: string[];
-    compatibilityOnly?: boolean;
     planned?: boolean;
 }
 export interface RetentionPolicy {

package/dist/types/internal-urls/local-root-gc.d.ts

@@ -0,0 +1,2 @@
+import type { GcStoreAdapter } from "../gjc-runtime/gc-runtime";
+export declare const localRootsGcAdapter: GcStoreAdapter;

package/dist/types/main.d.ts

@@ -96,7 +96,7 @@ export declare const BARE_RESUME_INTERACTIVE_ERROR = "--resume requires an inter
 export declare function resolveManagedAgentDirForScope(_cwd: string): string;
 export declare const BARE_RESUME_OPEN_ERROR = "Could not open the selected session. Use --resume <id>.";
 export declare function runInteractiveMode(session: AgentSession, version: string, changelogMarkdown: string | undefined, notifs: (InteractiveModeNotify | null)[], startupUpdate: StartupUpdateOrchestrator, initialMessages: string[], setExtensionUIContext: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers: LspStartupServerInfo[] | undefined, mcpManager: MCPManager | undefined, eventBus?: EventBus, initialMessage?: string, initialImages?: ImageContent[], createInteractiveMode?: CreateInteractiveMode, resumeAction?: "continue-tail" | "open-idle"): Promise<void>;
-declare function getChangelogForDisplay(parsed: Args): Promise<string | undefined>;
+export declare function getChangelogForDisplay(parsed: Args): Promise<string | undefined>;
 export declare function createSessionManager(parsed: Args, cwd: string, activeSettings?: Settings): Promise<SessionManager | undefined>;
 /**
  * Research-mode (RLM) preset hook. Lets `gjc rlm` augment the session options

package/dist/types/memories/index.d.ts

@@ -25,4 +25,6 @@ export declare function clearMemoryData(agentDir: string, cwd: string): Promise<
  * Force-enqueue global consolidation maintenance work.
  */
 export declare function enqueueMemoryConsolidation(agentDir: string, cwd: string, sourceUpdatedAt?: number): void;
+/** Secret scrubbing applied to every phase-2 consolidation output. Test seam. */
+export declare function redactMemorySecretsForTesting(input: string): string;
 export declare function getMemoryRoot(agentDir: string, cwd: string): string;

package/dist/types/modes/acp/acp-agent.d.ts

@@ -1,10 +1,15 @@
-import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type DeleteSessionRequest, type DeleteSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
+import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type AvailableCommand, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type DeleteSessionRequest, type DeleteSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
 import { type AcpProviderRegistration, AcpSdkAdapter } from "../../sdk/acp";
 import type { AcpStartupOptions } from "./startup-options";
 export declare const ACP_BOOTSTRAP_RACE_GUARD_MS = 50;
 type JsonObject = Record<string, unknown>;
 /** Applies ACP's offset cursor after narrowing the broker listing to the requested cwd. */
-export declare function paginateAcpSessions(listed: unknown[], cwd: string | undefined, offset: number): ListSessionsResponse;
+export declare function paginateAcpSessions(listed: unknown[], cwd: string | undefined, offset: number, sessionMetadata?: ReadonlyMap<string, {
+    title?: string;
+    updatedAt?: string;
+}>): ListSessionsResponse;
+/** Build the ACP command palette from the shared builtins and live SDK skill state. */
+export declare function acpAvailableCommandsFromSkills(query: unknown): AvailableCommand[];
 export type TranscriptReplayBlock = {
     type: "text";
     text: string;
@@ -27,8 +32,8 @@ export interface TranscriptReplayContent {
     };
 }
 export declare function transcriptReplayContent(entry: unknown): TranscriptReplayContent;
-/** Maps live canonical SDK config and model queries into the ACP 1.2.1 session state surface. */
-export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?: unknown): {
+/** Maps live canonical SDK config and the selected model catalog into the ACP 1.2.1 session state surface. */
+export declare function acpSessionStateFromConfig(query: unknown, modelCatalogQuery?: unknown, modelPreset?: string): {
     configOptions: ({
         id: string;
         name: string;
@@ -40,7 +45,7 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
         }[];
     } | {
         id: "model";
-        name: "Model";
+        name: string;
         type: "select";
         currentValue: string;
         options: {
@@ -67,7 +72,7 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
         })[];
     } | {
         id: "thinking";
-        name: "Thinking";
+        name: string;
         type: "select";
         currentValue: string;
         options: {
@@ -94,7 +99,7 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
         })[];
     } | {
         id: "steeringMode";
-        name: "Steering queue";
+        name: string;
         type: "select";
         currentValue: string;
         options: {
@@ -121,7 +126,7 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
         })[];
     } | {
         id: "followUpMode";
-        name: "Follow-up queue";
+        name: string;
         type: "select";
         currentValue: string;
         options: {
@@ -148,7 +153,7 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
         })[];
     } | {
         id: "interruptMode";
-        name: "Interrupt mode";
+        name: string;
         type: "select";
         currentValue: string;
         options: {
@@ -190,6 +195,14 @@ export declare function acpPromptPayload(blocks: PromptRequest["prompt"]): {
         mimeType: string;
     }>;
 };
+/**
+ * `AcpSdkAdapterError.code` is an internal string, but the SDK only derives a
+ * JSON-RPC code from a `RequestError`. Everything else collapses to an opaque
+ * `-32603 Internal error`, which hides the reason and defeats client-side
+ * recovery (an ACP client cannot see that it must authenticate). Map the codes
+ * that have a defined ACP/JSON-RPC counterpart onto a real `RequestError`.
+ */
+export declare function acpRequestFailure(error: unknown): unknown;
 /** Registers a permission provider only when the ACP client requires prompts. */
 export declare function acpProviderRegistrations(capabilities: ClientCapabilities | undefined, env?: NodeJS.ProcessEnv): AcpProviderRegistration[];
 /** Maps ACP permission handling to the session's canonical SDK policy. */

package/dist/types/modes/components/assistant-message.d.ts

@@ -10,11 +10,13 @@ export declare class AssistantMessageComponent extends Container {
     #private;
     private hideThinkingBlock;
     private readonly onImageUpdate?;
-    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, viewportAnchorId?: string);
+    private readonly onVisibleMutation?;
+    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, viewportAnchorId?: string, onVisibleMutation?: (() => void) | undefined);
     invalidate(): void;
     setHideThinkingBlock(hide: boolean): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;
     setUsageInfo(usage: Usage): void;
     updateContent(message: AssistantMessage, options?: AssistantMessageUpdateOptions): void;
+    dispose(): void;
 }
 export {};

package/dist/types/modes/components/irc-sidebar.d.ts

@@ -2,12 +2,50 @@ import { type Component, type ViewportAnchorProvider, type ViewportAnchorRender
 import type { IrcObservationLedger } from "../irc-observation-ledger";
 export declare const IRC_SIDEBAR_WIDTH_RATIO = 0.3;
 export declare const IRC_SIDEBAR_MAX_RENDER_ROWS = 2048;
+export declare const __ircSidebarPerfCounters: {
+    enabled: boolean;
+    projectionMemoHits: number;
+    projectionMemoMisses: number;
+    recordsVisited: number;
+    sourceBytes: number;
+    rows: number;
+    styledCacheHits: number;
+    styledCacheMisses: number;
+    wrapCalls: number;
+    snapshot(): {
+        projectionMemoHits: number;
+        projectionMemoMisses: number;
+        recordsVisited: number;
+        sourceBytes: number;
+        rows: number;
+        styledCacheHits: number;
+        styledCacheMisses: number;
+        wrapCalls: number;
+    };
+    enable(): void;
+    disable(): void;
+    reset(): void;
+};
 /** Computes transcript/sidebar widths while preserving at least half the terminal for the transcript. */
 export declare function computeIrcSplitWidths(width: number): {
     leftWidth: number;
     separatorWidth: number;
     rightWidth: number;
 };
+type SemanticLine = Readonly<{
+    kind: "header" | "body" | "elision" | "blank";
+    text: string;
+    sender?: string;
+    recipient?: string;
+    time?: string;
+}>;
+export type IrcSidebarSemanticProjection = Readonly<{
+    token: string;
+    lines: readonly SemanticLine[];
+}>;
+/** The authoritative bounded, display-neutral IRC sidebar projection. */
+export declare function getIrcSidebarSemanticProjection(ledger: IrcObservationLedger, width: number): IrcSidebarSemanticProjection;
+export declare function getIrcSidebarSemanticToken(ledger: IrcObservationLedger, width: number): string;
 export interface IrcSidebarTheme {
     fg(color: "dim" | "accent", text: string): string;
     bold(text: string): string;
@@ -26,7 +64,10 @@ export declare class IrcSplitViewComponent implements ViewportAnchorProvider {
     get visible(): boolean;
     effectiveSidebarVisible(width?: number): boolean;
     setVisible(visible: boolean): void;
+    invalidateTheme(): void;
+    resetSource(): void;
     render(width: number): string[];
     renderWithViewportAnchors(width: number): ViewportAnchorRender;
     invalidate(): void;
 }
+export {};

package/dist/types/modes/components/queue-pane.d.ts

@@ -1,12 +1,20 @@
 import { Container } from "@gajae-code/tui";
 import type { QueuedMessageEditEntry } from "../../session/agent-session";
+type QueueSelectorAction = "tui.select.confirm" | "tui.select.cancel";
+type QueueSelectorNavigationAction = "tui.select.up" | "tui.select.down" | "tui.select.pageUp" | "tui.select.pageDown";
 export declare class QueuePaneComponent extends Container {
     #private;
     constructor(entries: QueuedMessageEditEntry[], options: {
         selectedIndex?: number;
+        formatKeyHint?: (key: string) => string;
+        formatSelectAction?: (action: QueueSelectorAction) => string;
+        matchesSelectAction?: (keyData: string, action: QueueSelectorAction) => boolean;
+        resolveSelectNavigation?: (keyData: string) => QueueSelectorNavigationAction | undefined;
+        onSelect: (entry: QueuedMessageEditEntry) => void;
         onDelete: (entry: QueuedMessageEditEntry, index: number) => void;
         onMove: (entry: QueuedMessageEditEntry, index: number, direction: "up" | "down") => void;
         onClose: () => void;
     });
     handleInput(keyData: string): void;
 }
+export {};

package/dist/types/modes/components/queued-message-selector.d.ts

@@ -1,11 +1,17 @@
 import { Container, SelectList } from "@gajae-code/tui";
 import type { QueuedMessageEditEntry } from "../../session/agent-session";
 type QueuedMessageMoveDirection = "up" | "down";
+type QueueSelectorAction = "tui.select.confirm" | "tui.select.cancel";
+type QueueSelectorNavigationAction = "tui.select.up" | "tui.select.down" | "tui.select.pageUp" | "tui.select.pageDown";
 export type { QueuedMessageMoveDirection };
 export declare class QueuedMessageSelectorComponent extends Container {
     #private;
     constructor(entries: QueuedMessageEditEntry[], onSelect: (entry: QueuedMessageEditEntry) => void, onDelete: (entry: QueuedMessageEditEntry, selectedIndex: number) => void, onMove: (entry: QueuedMessageEditEntry, selectedIndex: number, direction: QueuedMessageMoveDirection) => void, onCancel: () => void, options?: {
         selectedIndex?: number;
+        formatKeyHint?: (key: string) => string;
+        formatSelectAction?: (action: QueueSelectorAction) => string;
+        matchesSelectAction?: (keyData: string, action: QueueSelectorAction) => boolean;
+        resolveSelectNavigation?: (keyData: string) => QueueSelectorNavigationAction | undefined;
     });
     handleInput(keyData: string): void;
     getSelectList(): SelectList;

package/dist/types/modes/components/read-tool-group.d.ts

@@ -8,12 +8,11 @@ type ReadRenderArgs = {
     file_path?: string;
     sel?: string;
 };
-type ReadToolGroupOptions = {
-    showContentPreview?: boolean;
-};
 export declare class ReadToolGroupComponent extends Container implements ToolExecutionHandle {
     #private;
-    constructor(options?: ReadToolGroupOptions);
+    constructor(options?: {
+        showContentPreview?: boolean;
+    });
     updateArgs(args: ReadRenderArgs, toolCallId?: string): void;
     updateResult(result: {
         content: Array<{
@@ -32,5 +31,6 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
      */
     setManuallyExpanded(expanded: boolean): void;
     getComponent(): Component;
+    consumeVisibleTranscriptChange(): boolean;
 }
 export {};

package/dist/types/modes/components/session-observer-overlay.d.ts

@@ -9,4 +9,8 @@ export declare class SessionObserverOverlayComponent extends TranscriptViewerOve
     refreshFromRegistry(): void;
     handleInput(keyData: string): void;
 }
+/**
+ * This deliberately remains the eager full-history projection. PR2 owns projection
+ * virtualization/incrementalization; source acquisition above only controls snapshot safety.
+ */
 export declare function entriesFromMessages(entries: readonly SessionMessageEntry[]): TranscriptViewerEntry[];

package/dist/types/modes/components/settings-selector.d.ts

@@ -58,6 +58,8 @@ export interface SettingsCallbacks {
     getStatusLinePreview?: (width?: number) => string;
     /** Called when plugins change */
     onPluginsChanged?: () => void;
+    /** Called when an interactive setting cannot be committed. */
+    onError?: (message: string) => void;
     /** Called when settings panel is closed */
     onCancel: () => void;
 }

package/dist/types/modes/components/tool-execution.d.ts

@@ -5,6 +5,8 @@ export interface ToolExecutionOptions {
     editFuzzyThreshold?: number;
     editAllowFuzzy?: boolean;
     hashlineAutoDropPureInsertDuplicates?: boolean;
+    /** Internal observer for visible asynchronous renderer mutations. */
+    onVisibleTranscriptMutation?: () => void;
 }
 export interface ToolExecutionHandle {
     updateArgs(args: any, toolCallId?: string): void;
@@ -29,6 +31,11 @@ export interface ToolExecutionHandle {
      * back to {@link setExpanded}.
      */
     setManuallyExpanded?(expanded: boolean): void;
+    /**
+     * Internal capability for dispatchers that need exact synchronous visible-output
+     * detection. Optional so existing structural handles remain source compatible.
+     */
+    consumeVisibleTranscriptChange?(): boolean;
 }
 /**
  * Component that renders a tool call with its result (updateable)
@@ -52,6 +59,7 @@ export declare class ToolExecutionComponent extends Container {
         details?: any;
         isError?: boolean;
     }, isPartial?: boolean, _toolCallId?: string): void;
+    consumeVisibleTranscriptChange(): boolean;
     /**
      * Stop spinner animation and cleanup resources.
      */

package/dist/types/modes/components/welcome.d.ts

@@ -14,6 +14,7 @@ export interface WelcomeComponentOptions {
     getViewportRows?: () => number | undefined;
     getReservedBottomRows?: (termWidth: number) => number;
     changelogMarkdown?: string;
+    rightGutterWidth?: number;
     collapseChangelog?: boolean;
     buildLabel?: string;
     keyDisplayContext?: KeyDisplayContext;

package/dist/types/modes/controllers/event-controller.d.ts

@@ -3,7 +3,10 @@ import type { InteractiveModeContext } from "../../modes/types";
 import type { AgentSessionEvent } from "../../session/agent-session";
 /** Test-only performance counters for advisory baseline tests. */
 export declare const __eventControllerPerfCounters: {
+    enabled: boolean;
     messageUpdateContentVisits: number;
+    enable(): void;
+    disable(): void;
     reset(): void;
 };
 export declare class EventController {

package/dist/types/modes/interactive-mode.d.ts

@@ -34,8 +34,12 @@ import { PromptSuggestionController } from "./prompt-suggestion-controller";
 import type { Theme } from "./theme/theme";
 import { type CompactionQueuedMessage, type ComposerSubmissionOptions, type InteractiveModeContext, type IrcArrivalSnapshot, type SubmittedUserInput, type TodoItem, type TodoPhase, type TranscriptRebuildPolicy } from "./types";
 import type { ParsedIrcMessage } from "./utils/irc-message";
-export declare function getDefaultComposerPlaceholder(context?: KeyDisplayContext): string;
+export declare function getDefaultComposerPlaceholder(context?: KeyDisplayContext, keybindings?: Pick<KeybindingsManager, "getDisplayString">): string;
 export declare const DEFAULT_COMPOSER_PLACEHOLDER: string;
+export declare function getComposerPlaceholder(keybindings: Pick<KeybindingsManager, "getDisplayString">, context: KeyDisplayContext, options: {
+    readonly busy: boolean;
+    readonly busyPromptMode: "steer" | "queue";
+}): string;
 export declare function getWelcomeTranscriptReservedRows(chatContainer: Container, width: number): number;
 export type WelcomeBannerSettingMode = "auto" | "unicode" | "square" | "ascii";
 export declare function resolveWelcomeLogoMode(mode: WelcomeBannerSettingMode, env?: Record<string, string | undefined>, platform?: NodeJS.Platform): WelcomeLogoMode;
@@ -177,6 +181,8 @@ export declare class InteractiveMode implements InteractiveModeContext {
     }): Promise<void>;
     flushPendingBashComponents(): void;
     isKnownSlashCommand(text: string): boolean;
+    /** Advances the sticky-viewport source only for semantic transcript output. */
+    recordVisibleTranscriptMutation(): void;
     addMessageToChat(message: AgentMessage, options?: {
         populateHistory?: boolean;
     }): Component[];

package/dist/types/modes/irc-observation-ledger.d.ts

@@ -1,5 +1,18 @@
 import type { ParsedIrcMessage } from "./utils/irc-message";
 type InlineMode = "persistent" | "ephemeral";
+export declare const IRC_OBSERVATION_LEDGER_MAX_RECORDS = 10000;
+export declare const IRC_OBSERVATION_LEDGER_MAX_RETAINED_UTF8_BYTES: number;
+export declare const IRC_OBSERVATION_LEDGER_MAX_SEEN_IDENTITIES = 100000;
+export declare const __ircLedgerPerfCounters: {
+    enabled: boolean;
+    epochAdvances: number;
+    snapshot(): {
+        epochAdvances: number;
+    };
+    enable(): void;
+    disable(): void;
+    reset(): void;
+};
 export type IrcObservationRecord = Readonly<ParsedIrcMessage & {
     mode: InlineMode;
     observedAt: number;
@@ -10,6 +23,7 @@ export type IrcObservationRecord = Readonly<ParsedIrcMessage & {
 /** Runtime-only IRC observations. This intentionally has no persistence layer. */
 export declare class IrcObservationLedger {
     #private;
+    get mutationEpoch(): number;
     /** Inline observations expire after 10 seconds; closed-panel observations persist inline. */
     observe(message: ParsedIrcMessage, panelVisibleAtObservation: boolean): IrcObservationRecord | undefined;
     getRecord(observationId: string): IrcObservationRecord | undefined;
@@ -17,6 +31,8 @@ export declare class IrcObservationLedger {
     getInlineProjection(now: number): readonly IrcObservationRecord[];
     /** Returns and clears IDs whose retained payload was released. */
     drainEvictedObservationIds(): readonly string[];
-    reset(): void;
+    reset(options?: {
+        retireCurrentSessionIdentities?: boolean;
+    }): void;
 }
 export {};

package/dist/types/modes/types.d.ts

@@ -218,6 +218,8 @@ export interface InteractiveModeContext {
     getAssistantViewportAnchorId?(message: AssistantMessage): string;
     findLastAssistantMessage(): AssistantMessage | undefined;
     extractAssistantText(message: AssistantMessage): string;
+    /** Records one semantic visible-transcript mutation for the sticky viewport. */
+    recordVisibleTranscriptMutation?(): void;
     updateEditorTopBorder(): void;
     updateEditorBorderColor(): void;
     rebuildChatFromMessages(policy: TranscriptRebuildPolicy): void;

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -6,6 +6,22 @@ import { type SessionContext } from "../../session/session-manager";
 import { type ParsedIrcMessage } from "./irc-message";
 export type { TranscriptRebuildPolicy } from "../../modes/types";
 export declare function prepareTranscriptRebuild(ui: TUI, policy: TranscriptRebuildPolicy): void;
+export declare const RESUME_PROGRESS_COMMIT_TIMEOUT_MS = 250;
+export interface ResumeProgressLease {
+    readonly committed: Promise<boolean>;
+    clear(): void;
+}
+/**
+ * Mount a resume loader on the live status rail and wait for its render generation
+ * to commit before session I/O begins. The commit is advisory: a stopped or
+ * unavailable terminal resolves false and callers continue without blocking.
+ *
+ * Fail open (no-op lease, committed=false) when the status rail or UI lacks the
+ * child-mutation/render-commit surface required to mount progress. Headless and
+ * minimal controller contexts keep resume/migration semantics; full interactive
+ * TUI containers retain progress-before-switch.
+ */
+export declare function acquireResumeProgressLease(ctx: Pick<InteractiveModeContext, "ui" | "statusContainer">): ResumeProgressLease;
 interface RenderInitialMessagesOptions {
     preserveExistingChat?: boolean;
 }

package/dist/types/runtime/memory-domain.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryGuardDomainSnapshot, MemoryGuardWorkerSample } from "./memory-guard-contract";
+export interface MemoryGuardDomainInput {
+    effectiveLimitBytes: number;
+    totalUsageBytes: number;
+    parentBytes: number;
+    parentReserveBytes: number;
+    workers: readonly MemoryGuardWorkerSample[];
+}
+export declare function computeMemoryGuardDomain(input: MemoryGuardDomainInput): MemoryGuardDomainSnapshot;