agent-afk 5.127.4 → 5.128.0

package/dist/cli/_lib/stream-renderer-lifecycle.d.ts

@@ -8,7 +8,8 @@ import type { ThinkingLane } from '../commands/interactive/thinking-lane.js';
 import type { StreamingMarkdownRenderer } from '../markdown-stream.js';
 import type { Writer } from '../slash/types.js';
 import type { ProgressEvent } from '../../agent/types.js';
-export interface LifecycleContext {
+import { type TtfbTickCtx } from './stream-renderer-ttfb.js';
+export interface LifecycleContext extends TtfbTickCtx {
     compositor: TerminalCompositor | null;
     overlayComposer: OverlayComposer | null;
     stageTracker: ReturnType<typeof createStageTracker>;
@@ -20,9 +21,7 @@ export interface LifecycleContext {
     lastProgressByTask: Map<string, ProgressEvent>;
     thinkingMode: 'off' | 'summary' | 'live' | 'digest';
     out: Writer;
-    isTTY: boolean;
     sources: Map<string, SourceState>;
-    disposed: boolean;
     pauseTickInterval: ReturnType<typeof setInterval> | null;
     resizeUnsub: (() => void) | null;
 }
@@ -31,6 +30,8 @@ export declare function registerOverlaySlots(overlayComposer: OverlayComposer, c
     childActivity?: ChildActivityTracker;
     getInterrupting: () => boolean;
     getSoftStopping: () => boolean;
+    getTtfbStartedAt?: () => number | undefined;
+    isTtfbDone?: () => boolean;
 }): void;
 export declare function formatInterruptAffordance(interrupting: boolean): string;
 export declare function subscribeToResize(overlayComposer: OverlayComposer, disposed: boolean): () => void;

package/dist/cli/_lib/stream-renderer-options.d.ts

@@ -21,4 +21,5 @@ export interface StreamRendererOptions {
     reducedMotion?: boolean;
     compositor?: TerminalCompositor;
     onStageChange?: (stage: import('../commands/interactive/loop-stage.js').LoopStage, signals?: import('../commands/interactive/loop-stage.js').StageSignals) => void;
+    turnStartedAt?: number;
 }

package/dist/cli/_lib/stream-renderer-ttfb.d.ts

@@ -0,0 +1,15 @@
+import type { OverlayComposer } from './overlay-composer.js';
+export declare const TTFB_GRACE_MS = 2000;
+export interface TtfbTickCtx {
+    ttfbStartedAt: number | undefined;
+    ttfbDone: boolean;
+    lastTtfbAnnotation: string;
+    isTTY: boolean;
+    disposed: boolean;
+    overlayComposer: OverlayComposer | null;
+}
+export declare function checkTtfbAnnotation(ctx: TtfbTickCtx, now: number): boolean;
+export declare function applyFirstContent(isDone: boolean, setDone: () => void, overlayComposer: OverlayComposer | null): boolean;
+export declare function renderTtfbWaitingLine(getTtfbStartedAt: (() => number | undefined) | undefined, isTtfbDone: (() => boolean) | undefined, palette: {
+    dim: (s: string) => string;
+}): string;

package/dist/cli/_lib/stream-renderer.d.ts

@@ -37,12 +37,16 @@ export declare class StreamRenderer {
     private disposed;
     private pauseTickInterval;
     private resizeUnsub;
+    private readonly ttfbStartedAt;
+    private ttfbDone;
+    private lastTtfbAnnotation;
     readonly sink: (event: OutputEvent, meta?: SubagentProgressMeta) => void;
     constructor(opts: StreamRendererOptions);
     arm(): Promise<void>;
     getCompositor(): TerminalCompositor | null;
     setInterrupting(active: boolean): void;
     setSoftStopping(active: boolean): void;
+    notifyFirstContent(): void;
     private buildOrchestratorCtx;
     process(event: OutputEvent, meta?: SubagentProgressMeta): void;
     dispose(): Promise<void>;

package/dist/cli/commands/interactive/footer-subsystems.d.ts

@@ -4,6 +4,7 @@ import { createVerdictLedger } from './verdict-ledger.js';
 import { BackgroundStatusBar } from '../../background-status-bar.js';
 import { LoopStageBar } from './loop-stage.js';
 import { MascotBar } from './mascot-bar.js';
+import { HealthRail } from '../../health-rail.js';
 import { ShellPassthrough } from './shell-passthrough.js';
 import { BgResultNotifier } from './bg-result-notifier.js';
 import type { TurnState } from './repl-loop-shared.js';
@@ -12,6 +13,7 @@ export interface FooterSubsystems {
     bgStatusBar: BackgroundStatusBar;
     loopStageBar: LoopStageBar;
     mascotBar: MascotBar;
+    healthRail: HealthRail;
     verdictLedger: ReturnType<typeof createVerdictLedger>;
     shellPassthrough: ShellPassthrough;
     bgResultNotifier: BgResultNotifier;

package/dist/cli/commands/interactive/interrupt-picker.d.ts

@@ -0,0 +1,17 @@
+import type { TerminalCompositor } from '../../terminal-compositor.js';
+import type { TurnState } from './repl-loop-shared.js';
+export type InterruptChoice = 'stop' | 'cancel' | 'dismissed';
+export interface InterruptPickerOptions {
+    compositor: TerminalCompositor;
+    signal: AbortSignal;
+    onStop: () => void;
+    onCancel: () => void;
+}
+export declare function showInterruptPicker(opts: InterruptPickerOptions): Promise<InterruptChoice>;
+export interface LaunchInterruptPickerOptions {
+    compositor: TerminalCompositor;
+    turnState: TurnState;
+    onStop: () => void;
+    onCancel: () => void;
+}
+export declare function launchInterruptPicker(opts: LaunchInterruptPickerOptions): void;

package/dist/cli/commands/interactive/repl-loop-shared.d.ts

@@ -6,5 +6,6 @@ export interface TurnState {
     tryAbortShellForeground?: (() => boolean) | null;
     notifyInterrupting?: ((active: boolean) => void) | null;
     requestSoftStop?: (() => void) | null;
+    interruptPickerAbort?: AbortController | null;
 }
 export declare function buildPrompt(mode: PermissionMode): string;

package/dist/cli/commands/interactive/turn-handler.d.ts

@@ -9,13 +9,5 @@ export declare function runTurn(input: {
     text: string;
     attachments: ImageAttachment[];
 }, session: AgentSession, stats: SessionStats, h: TurnHandles, thinkingUi?: ThinkingUiMode, completionWriter?: CompletionWriter, inputSurface?: InputSurfaceRefs): Promise<void>;
-export type ContextTier = 'quiet' | 'normal' | 'caution' | 'near' | 'over';
-export declare function formatContextUsage(contextPct: number, contextLimit: number): {
-    tier: ContextTier;
-    text: string | null;
-};
-export declare function printTurnFooter(meta: {
-    durationMs?: number;
-    totalCostUsd?: number;
-    usage?: Record<string, unknown>;
-} | undefined, stats: SessionStats, write?: (line: string) => void): void;
+export type { ContextTier } from './turn-handler.footer.js';
+export { formatContextUsage, printTurnFooter } from './turn-handler.footer.js';

package/dist/cli/commands/interactive/turn-handler.footer.d.ts

@@ -0,0 +1,11 @@
+import type { SessionStats } from '../../slash/types.js';
+export type ContextTier = 'quiet' | 'normal' | 'caution' | 'near' | 'over';
+export declare function formatContextUsage(contextPct: number, contextLimit: number): {
+    tier: ContextTier;
+    text: string | null;
+};
+export declare function printTurnFooter(meta: {
+    durationMs?: number;
+    totalCostUsd?: number;
+    usage?: Record<string, unknown>;
+} | undefined, stats: SessionStats, write?: (line: string) => void): void;

package/dist/cli/commands/interactive/turn-handler.ttfb.d.ts

@@ -0,0 +1,12 @@
+import type { OutputEvent } from '../../../agent/types.js';
+import type { CompletionWriter } from './shared.js';
+export interface TurnTtfbState {
+    readonly startedAt: number;
+    received: boolean;
+}
+export declare function createTurnTtfbState(startedAt: number): TurnTtfbState;
+export declare function ttfbRendererOptions(state: TurnTtfbState): {
+    turnStartedAt?: number;
+};
+export declare function observeFirstContent(state: TurnTtfbState, event: OutputEvent, streamingStarted: boolean): boolean;
+export declare function emitPlainTtfbWaiting(completionWriter: CompletionWriter | undefined): void;

package/dist/cli/health-rail.d.ts

@@ -0,0 +1,25 @@
+import type { BackgroundAgentRegistry } from '../agent/background-registry.js';
+import type { SessionStats } from './slash/types.js';
+export interface HealthRailOptions {
+    stream?: NodeJS.WriteStream;
+    backgroundRegistry?: BackgroundAgentRegistry;
+    getExtraRows: () => number;
+}
+export declare class HealthRail {
+    private readonly stream;
+    private readonly registry;
+    private readonly getExtraRows;
+    private started;
+    private snapshot;
+    private onRowCountChange?;
+    private resizeUnsub;
+    private tickInterval;
+    constructor(opts: HealthRailOptions);
+    setRowCountChangeHandler(handler: (rows: number) => void): void;
+    start(): void;
+    stop(): void;
+    update(stats: SessionStats, contextRatioOverride?: number): void;
+    redraw(): void;
+    private repaint;
+    private clearRow;
+}

package/dist/cli/health-rail.format.d.ts

@@ -0,0 +1,8 @@
+export interface HealthRailFields {
+    totalTurns: number;
+    elapsedMs: number;
+    toolCalls: number;
+    activeSubs: number;
+    contextRatio: number;
+}
+export declare function formatHealthRail(fields: HealthRailFields, maxWidth: number): string;

package/dist/cli/render/picker.d.ts

@@ -11,5 +11,6 @@ export interface RunPickerOptions {
     signal?: AbortSignal;
     initialIndex?: number;
     initialSelected?: ReadonlySet<number>;
+    onCtrlC?: () => void;
 }
 export declare function runPicker(host: PickerHost, opts: RunPickerOptions): Promise<readonly string[] | null>;