@kortix/ui 0.14.5 → 0.14.7

package/dist/session/status/session-error-banner.js

@@ -140,6 +140,12 @@ function GatewayMetaLine({ leading, details, }) {
 function DiagnosticFold({ summary, children }) {
     return (_jsxs("details", { className: "group/fold text-xs", children: [_jsxs("summary", { className: cn('text-muted-foreground hover:text-foreground flex w-fit cursor-pointer list-none', 'duration-fast items-center gap-1 transition-colors select-none', '[&::-webkit-details-marker]:hidden'), children: [_jsx(CaretRightIcon, { className: "size-3 shrink-0 group-open/fold:rotate-90" }), summary] }), children] }));
 }
+function FailureList({ failures, className }) {
+    const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
+    return (_jsx("ol", { className: className, children: failures.map((failure) => (_jsxs("li", { children: [_jsx("span", { className: "text-foreground font-medium", children: failureTarget(failure) }), " \u00B7", ' ', failure.status !== undefined
+                    ? tI18nComplete('textf6a6d0e934f4', { value0: failure.status })
+                    : '', String(failure.code), " \u00B7 ", failure.message] }, failure.attempt))) }));
+}
 /**
  * The per-candidate failure chain, collapsed. It is the diagnostic, not the
  * message: a reader who wants to know WHY every route failed opens it; everyone
@@ -150,9 +156,7 @@ function GatewayAttemptFailureList({ details }) {
     const failures = details?.attemptFailures;
     if (!failures?.length)
         return null;
-    return (_jsx(DiagnosticFold, { summary: failures.length === 1 ? tI18nComplete.raw('textce4c96225f63') : `${failures.length} attempts`, children: _jsx("ol", { className: "text-muted-foreground mt-1 list-decimal space-y-1 pl-4 wrap-anywhere", children: failures.map((failure) => (_jsxs("li", { children: [_jsx("span", { className: "text-foreground font-medium", children: failureTarget(failure) }), " \u00B7", ' ', failure.status !== undefined
-                        ? tI18nComplete('textf6a6d0e934f4', { value0: failure.status })
-                        : '', String(failure.code), " \u00B7 ", failure.message] }, failure.attempt))) }) }));
+    return (_jsx(DiagnosticFold, { summary: failures.length === 1 ? tI18nComplete.raw('textce4c96225f63') : `${failures.length} attempts`, children: _jsx(FailureList, { failures: failures, className: "text-muted-foreground mt-1 list-decimal space-y-1 pl-4 wrap-anywhere" }) }));
 }
 /**
  * Which row a plain-text turn error renders, and whether it opens. The one
@@ -212,9 +216,7 @@ function TurnErrorCheckpoint({ text, gateway, raw, defaultOpen, action, modelOpt
     if (!canOpen) {
         return (_jsxs("div", { role: "alert", className: className, children: [row, hint, action] }));
     }
-    return (_jsx("div", { role: "alert", className: className, children: _jsx(ChainOfThoughtStep, { defaultOpen: defaultOpen, children: _jsxs(_Fragment, { children: [_jsx(DisclosureTrigger, { children: _jsx("div", { className: "group/trigger cursor-pointer", children: row }) }), hint, action, _jsx(DisclosureContent, { children: _jsxs("div", { className: "mt-3 flex flex-col gap-2 pl-7", children: [_jsx(GatewayMetaLine, { details: gateway }), failures.length > 0 ? (_jsx("ol", { className: "text-muted-foreground list-decimal space-y-1 pl-4 text-xs wrap-anywhere", children: failures.map((failure) => (_jsxs("li", { children: [_jsx("span", { className: "text-foreground font-medium", children: failureTarget(failure) }), ' ', "\u00B7", ' ', failure.status !== undefined
-                                                ? tI18nComplete('textf6a6d0e934f4', { value0: failure.status })
-                                                : '', String(failure.code), " \u00B7 ", failure.message] }, failure.attempt))) })) : null, raw ? (_jsx("pre", { className: "bg-muted text-muted-foreground max-h-40 overflow-auto rounded-md px-3 py-2 font-mono text-xs whitespace-pre-wrap wrap-anywhere", children: raw })) : null] }) })] }) }) }));
+    return (_jsx("div", { role: "alert", className: className, children: _jsx(ChainOfThoughtStep, { defaultOpen: defaultOpen, children: _jsxs(_Fragment, { children: [_jsx(DisclosureTrigger, { children: _jsx("div", { className: "group/trigger cursor-pointer", children: row }) }), hint, action, _jsx(DisclosureContent, { children: _jsxs("div", { className: "mt-3 flex flex-col gap-2 pl-7", children: [_jsx(GatewayMetaLine, { details: gateway }), failures.length > 0 ? (_jsx(FailureList, { failures: failures, className: "text-muted-foreground list-decimal space-y-1 pl-4 text-xs wrap-anywhere" })) : null, raw ? (_jsx("pre", { className: "bg-muted text-muted-foreground max-h-40 overflow-auto rounded-md px-3 py-2 font-mono text-xs whitespace-pre-wrap wrap-anywhere", children: raw })) : null] }) })] }) }) }));
 }
 /**
  * Renders a turn-level or send-failure error inline.

package/dist/session/status/session-starting-loader.d.ts

@@ -1,20 +1,21 @@
-import { type SessionStartResult, type SessionStartStage } from '@kortix/sdk';
+import { type SessionStartResult } from '@kortix/sdk';
+/**
+ * What a session shows while its Kortix Computer comes up: nothing, unless the
+ * wake needs attention. Opening a session wakes its computer in the background,
+ * and a send goes out as soon as it is up, so a routine wake has nothing to
+ * say. Two states speak: an escalation or retry note from the server, and a
+ * wake stuck past `STUCK_AFTER_MS` that the caller may restart.
+ *
+ * All the heavy lifting (provision / wake / runtime readiness) is server-side
+ * behind POST /sessions/:id/start.
+ */
 /**
  * After this long, offer a manual restart. Sandboxes occasionally wedge (e.g. a
  * stuck provider-side proxy) with no server-side signal that anything is wrong —
  * a stop/start of the sandbox is the known fix, so surface it as a fallback
- * instead of leaving the user staring at "Connecting" indefinitely.
+ * instead of leaving the user waiting indefinitely.
  */
 export declare const STUCK_AFTER_MS = 45000;
-interface Step {
-    /** User-visible label for the active startup stage. */
-    label: string;
-}
-/**
- * Accepted for input compatibility. Both values intentionally render the same
- * loader.
- */
-type BootStepVariant = 'stepper' | 'compact';
 type StartFailure = SessionStartResult['failure'];
 /**
  * Keep the server's retry visible while `/start` waits for its retry clock.
@@ -26,14 +27,6 @@ export declare function sessionWakeStatusNote(input: {
     note?: string | null;
     now: number;
 }): string | null;
-/** Copy is deliberately parallel, so stage changes read as one continuous task. */
-export declare const STEPS: Step[];
-/**
- * Resolve which step is CURRENTLY active from the backend stage plus how long
- * we've been in it. The index is the floor we KNOW we're at — earlier steps are
- * genuinely complete, later ones haven't started.
- */
-export declare function activeStep(stage: SessionStartStage, msInStage: number): number;
 /**
  * Whether the stuck-boot restart offer may render. Restart is the session
  * owner's or a project manager's; the server answers anyone else 403
@@ -53,31 +46,31 @@ export declare function RestartFallback({ show, pending, onRestart, className, b
     className?: string;
     buttonClassName?: string;
 }): import("react").JSX.Element | null;
-export declare function SessionStartingLoader({ stage, 
-/** Delay before the content appears. Warm opens avoid flashing the loader. */
-delayMs, projectId, sessionId, 
+/**
+ * The wake's status where nothing else can paint: the side panel, a chat with
+ * no runtime yet, a resume with nothing saved. A routine wake renders nothing.
+ */
+export declare function SessionStartingLoader({ projectId, sessionId, 
 /** Honest one-liner from the SDK wake escalation ladder. */
 note, reason, failure, }: {
-    stage?: SessionStartStage;
-    delayMs?: number;
     projectId?: string;
     sessionId?: string;
-    variant?: BootStepVariant;
     note?: string | null;
     reason?: string | null;
     failure?: StartFailure;
-}): import("react").JSX.Element;
+}): import("react").JSX.Element | null;
 /**
- * Compact status above a readable conversation while its runtime wakes. The
- * transcript remains scrollable because only the restart control accepts input.
+ * Compact status above a readable conversation while its runtime wakes, shown
+ * only when the wake needs attention: an escalation or retry note, or a stuck
+ * wake with a Restart. A normal wake renders nothing. The transcript remains
+ * scrollable because only the restart control accepts input.
  */
-export declare function SessionConnectingBanner({ stage, projectId, sessionId, className, note, reason, failure, }: {
-    stage?: SessionStartStage;
+export declare function SessionConnectingBanner({ projectId, sessionId, className, note, reason, failure, }: {
     projectId?: string;
     sessionId?: string;
     className?: string;
     note?: string | null;
     reason?: string | null;
     failure?: StartFailure;
-}): import("react").JSX.Element;
+}): import("react").JSX.Element | null;
 export {};

package/dist/session/status/session-starting-loader.js

@@ -3,37 +3,26 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Button } from '../../primitives/button.js';
 import Loading from '../../primitives/loading.js';
 import { useRestartProjectSession } from '../../internal/hooks/projects/use-restart-project-session.js';
-import { useLocalizedUiCatalog } from '../../i18n/ui-catalog/use-localized-ui-catalog.js';
 import { useTranslations } from '../../i18n/index.js';
 import { cn } from '../../lib/utils.js';
 import { useProjectSession } from '@kortix/sdk/react';
 import { ArrowCounterClockwiseIcon as RotateCcw } from '@phosphor-icons/react';
 import { useEffect, useRef, useState } from 'react';
 /**
- * The ONE loader shown while a session's Kortix Computer comes up — full-screen
- * for resumes, and dead-center in the side panel while a fresh session boots.
- * All the heavy lifting (provision / wake / OpenCode readiness + pin) is
- * server-side behind POST /sessions/:id/start; this just reports the real stage.
+ * What a session shows while its Kortix Computer comes up: nothing, unless the
+ * wake needs attention. Opening a session wakes its computer in the background,
+ * and a send goes out as soon as it is up, so a routine wake has nothing to
+ * say. Two states speak: an escalation or retry note from the server, and a
+ * wake stuck past `STUCK_AFTER_MS` that the caller may restart.
  *
- * Visual: one stable heading, one short stage label, one four-stage rail, and
- * one small spinner. The spinner is the only perpetual motion. The rail moves
- * only when the backend stage advances, so it never claims progress we do not
- * have.
+ * All the heavy lifting (provision / wake / runtime readiness) is server-side
+ * behind POST /sessions/:id/start.
  */
-const LOADER_DELAY_MS = 100;
-/**
- * How long we sit in the backend `starting` stage before softly advancing from
- * "Loading your workspace" to "Waking the agent". Both happen within that one
- * backend stage (clone → OpenCode boot), so the advance reflects real order.
- */
-const STARTING_SUBSTEP_MS = 5_000;
-/** After this long, show copy that sets expectations for a cold start. */
-const SLOW_AFTER_MS = 15_000;
 /**
  * After this long, offer a manual restart. Sandboxes occasionally wedge (e.g. a
  * stuck provider-side proxy) with no server-side signal that anything is wrong —
  * a stop/start of the sandbox is the known fix, so surface it as a fallback
- * instead of leaving the user staring at "Connecting" indefinitely.
+ * instead of leaving the user waiting indefinitely.
  */
 export const STUCK_AFTER_MS = 45_000;
 /**
@@ -64,42 +53,14 @@ export function sessionWakeStatusNote(input) {
     const duration = minutes > 0 ? `${minutes}m\u00a0${remainder}s` : `${remainder}s`;
     return `Still starting your computer. Trying again in ${duration} (attempt ${nextAttempt}).`;
 }
-/** Copy is deliberately parallel, so stage changes read as one continuous task. */
-export const STEPS = [
-    { label: 'Reserving your computer' },
-    { label: 'Loading your workspace' },
-    { label: 'Waking the agent' },
-    { label: 'Connecting' },
-];
-/**
- * Resolve which step is CURRENTLY active from the backend stage plus how long
- * we've been in it. The index is the floor we KNOW we're at — earlier steps are
- * genuinely complete, later ones haven't started.
- */
-export function activeStep(stage, msInStage) {
-    if (stage === 'provisioning')
-        return 0;
-    if (stage === 'starting')
-        return msInStage >= STARTING_SUBSTEP_MS ? 2 : 1;
-    return 3;
-}
-/**
- * The shared boot clock: a 1s tick that resolves the current active step from
- * the backend stage plus time-in-stage, and exposes `now` for elapsed-time UI.
- */
-function useBootProgress(stage) {
+/** A 1 s tick: the retry countdown and the stuck clock read it. */
+function useNow() {
     const [now, setNow] = useState(() => Date.now());
     useEffect(() => {
         const id = setInterval(() => setNow(Date.now()), 1_000);
         return () => clearInterval(id);
     }, []);
-    const [stageEnteredAt, setStageEnteredAt] = useState(now);
-    const [prevStage, setPrevStage] = useState(stage);
-    if (prevStage !== stage) {
-        setPrevStage(stage);
-        setStageEnteredAt(now);
-    }
-    return { active: activeStep(stage, now - stageEnteredAt), now };
+    return now;
 }
 /**
  * The boot clock a restart carries. The shared restart hook owns the whole
@@ -139,52 +100,42 @@ export function RestartFallback({ show, pending, onRestart, className, buttonCla
     return (_jsxs("div", { className: cn('mt-5 w-full', className), children: [_jsx("p", { className: "text-muted-foreground mb-2 text-xs text-pretty", children: tI18nComplete.raw('textbeda94e911d3') }), _jsxs(Button, { type: "button", variant: "secondary", size: "sm", className: cn('w-full active:scale-[0.96]', buttonClassName), disabled: pending, onClick: onRestart, children: [pending ? (_jsx(Loading, { className: "size-3.5 shrink-0 text-current motion-reduce:animate-none" })) : (_jsx(RotateCcw, { className: "size-3.5 shrink-0" })), pending ? tI18nComplete.raw('text75d0f1469d16') : tI18nComplete.raw('textcb886371afc6')] })] }));
 }
 /**
- * One stable headline, one source of perpetual motion, and an honest four-stage
- * rail. Progress changes immediately when the backend stage changes.
+ * The wake's status where nothing else can paint: the side panel, a chat with
+ * no runtime yet, a resume with nothing saved. A routine wake renders nothing.
  */
-function QuietProgressLoader({ active, canRestart, note, onRestart, pending, show, slow, stuck, }) {
-    const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
-    const steps = useLocalizedUiCatalog(STEPS);
-    const step = steps[Math.min(active, steps.length - 1)];
-    return (_jsx("div", { className: "flex h-full min-h-0 w-full flex-1 items-center justify-center px-4 sm:px-8", children: show ? (_jsxs("div", { role: "status", "aria-live": "polite", className: "flex w-full max-w-xs items-start gap-3", children: [_jsx(Loading, { variant: "spokes", className: "text-muted-foreground mt-0.5 size-4 shrink-0 motion-reduce:animate-none" }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("h2", { className: "text-foreground text-sm font-medium text-balance", children: tI18nComplete.raw('textac4e05b19878') }), _jsx("p", { className: "text-muted-foreground mt-1 text-xs text-pretty", children: note ?? step.label }), _jsx("div", { role: "progressbar", "aria-label": tI18nComplete.raw('text4cbf9c0d5628'), "aria-valuemin": 1, "aria-valuemax": steps.length, "aria-valuenow": active + 1, "aria-valuetext": `Step ${active + 1} of ${steps.length}: ${step.label}`, className: "mt-3 grid grid-cols-4 gap-1.5", children: steps.map((item, index) => (_jsx("span", { "aria-hidden": true, className: cn('h-1 rounded-full', index <= active ? 'bg-kortix-green' : 'bg-border/70') }, item.label))) }), slow ? (_jsx("p", { className: "text-muted-foreground mt-3 text-xs text-pretty", children: tI18nComplete.raw('textbb2ab0401c3c') })) : null, _jsx(RestartFallback, { show: stuck && canRestart, pending: pending, onRestart: onRestart })] })] })) : null }));
-}
-export function SessionStartingLoader({ stage = 'provisioning', 
-/** Delay before the content appears. Warm opens avoid flashing the loader. */
-delayMs = LOADER_DELAY_MS, projectId, sessionId, 
+export function SessionStartingLoader({ projectId, sessionId, 
 /** Honest one-liner from the SDK wake escalation ladder. */
 note, reason, failure, }) {
-    const [delayElapsed, setDelayElapsed] = useState(false);
-    const show = delayMs <= 0 || delayElapsed;
-    useEffect(() => {
-        if (delayMs <= 0)
-            return;
-        const timeout = setTimeout(() => setDelayElapsed(true), delayMs);
-        return () => clearTimeout(timeout);
-    }, [delayMs]);
     const { data: session } = useProjectSession(projectId, sessionId);
     const restart = useRestartProjectSession(projectId ?? '', sessionId ?? '');
-    const { active, now } = useBootProgress(stage);
+    const now = useNow();
     const statusNote = sessionWakeStatusNote({ reason, failure, note, now });
     const clockStart = useRestartedBootClock(restart);
-    const slow = now - clockStart >= SLOW_AFTER_MS;
-    const stuck = now - clockStart >= STUCK_AFTER_MS;
-    const canRestart = canOfferBootRestart(session, projectId, sessionId);
-    return (_jsx(QuietProgressLoader, { active: active, canRestart: canRestart, note: statusNote, onRestart: restart.restart, pending: restart.isPending, show: show, slow: slow, stuck: stuck }));
+    const restartable = now - clockStart >= STUCK_AFTER_MS && canOfferBootRestart(session, projectId, sessionId);
+    if (!statusNote && !restartable)
+        return null;
+    return (_jsx("div", { className: "flex h-full min-h-0 w-full flex-1 items-center justify-center px-4 sm:px-8", children: _jsxs("div", { role: "status", "aria-live": "polite", className: "flex w-full max-w-xs items-start gap-3", children: [_jsx(Loading, { variant: "spokes", className: "text-muted-foreground mt-0.5 size-4 shrink-0 motion-reduce:animate-none" }), _jsxs("div", { className: "min-w-0 flex-1", children: [statusNote ? _jsx("p", { className: "text-muted-foreground text-xs text-pretty", children: statusNote }) : null, _jsx(RestartFallback, { show: restartable, pending: restart.isPending, onRestart: restart.restart, className: statusNote ? 'mt-3' : 'mt-0' })] })] }) }));
 }
 /**
- * Compact status above a readable conversation while its runtime wakes. The
- * transcript remains scrollable because only the restart control accepts input.
+ * Compact status above a readable conversation while its runtime wakes, shown
+ * only when the wake needs attention: an escalation or retry note, or a stuck
+ * wake with a Restart. A normal wake renders nothing. The transcript remains
+ * scrollable because only the restart control accepts input.
  */
-export function SessionConnectingBanner({ stage = 'provisioning', projectId, sessionId, className, note, reason, failure, }) {
+export function SessionConnectingBanner({ projectId, sessionId, className, note, reason, failure, }) {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const { data: session } = useProjectSession(projectId, sessionId);
     const restart = useRestartProjectSession(projectId ?? '', sessionId ?? '');
-    const { active, now } = useBootProgress(stage);
+    const now = useNow();
     const statusNote = sessionWakeStatusNote({ reason, failure, note, now });
     const clockStart = useRestartedBootClock(restart);
     const stuck = now - clockStart >= STUCK_AFTER_MS;
     const canRestart = canOfferBootRestart(session, projectId, sessionId);
-    const steps = useLocalizedUiCatalog(STEPS);
-    const step = steps[Math.min(active, steps.length - 1)];
-    return (_jsx("div", { role: "status", "aria-live": "polite", "data-session-connecting-banner": "", className: cn('pointer-events-none absolute inset-x-0 top-0 z-30 flex justify-center px-3 pt-3', className), children: _jsxs("div", { className: "bg-background/85 text-muted-foreground flex max-w-full items-center gap-2 rounded-full border px-3 py-1.5 text-xs shadow-xs backdrop-blur-sm", children: [_jsx(Loading, { variant: "spokes", className: "size-3.5 shrink-0 text-current motion-reduce:animate-none" }), _jsx("span", { className: "min-w-0 text-pretty", children: statusNote ?? step.label }), stuck && canRestart ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "pointer-events-auto -mr-2 h-6 px-2 text-xs", disabled: restart.isPending, onClick: restart.restart, children: restart.isPending ? tI18nComplete.raw('text75d0f1469d16') : 'Restart' })) : null] }) }));
+    // A normal wake is silent: opening the session wakes its computer in the
+    // background, and a send goes out as soon as it is up. The pill speaks only
+    // when something is wrong: the wake escalated or waits on a retry
+    // (`statusNote`), or it is stuck and can be restarted.
+    if (!statusNote && !(stuck && canRestart))
+        return null;
+    return (_jsx("div", { role: "status", "aria-live": "polite", "data-session-connecting-banner": "", className: cn('pointer-events-none absolute inset-x-0 top-0 z-30 flex justify-center px-3 pt-3', className), children: _jsxs("div", { className: "bg-background/85 text-muted-foreground flex max-w-full items-center gap-2 rounded-full border px-3 py-1.5 text-xs shadow-xs backdrop-blur-sm", children: [_jsx(Loading, { variant: "spokes", className: "size-3.5 shrink-0 text-current motion-reduce:animate-none" }), _jsx("span", { className: "min-w-0 text-pretty", children: statusNote ?? tI18nComplete.raw('textbeda94e911d3') }), stuck && canRestart ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "pointer-events-auto -mr-2 h-6 px-2 text-xs", disabled: restart.isPending, onClick: restart.restart, children: restart.isPending ? tI18nComplete.raw('text75d0f1469d16') : 'Restart' })) : null] }) }));
 }

package/dist/session/thread/chat-minimap-items.d.ts

@@ -1,11 +1,11 @@
 import type { SessionLogTurn } from '@kortix/sdk';
-export type MinimapMentionKind = 'agent' | 'file';
-export interface MinimapSegment {
+type MinimapMentionKind = 'agent' | 'file';
+interface MinimapSegment {
     /** For a mention this is the bare name — the `@` is drawn as an icon. */
     text: string;
     mention?: MinimapMentionKind;
 }
-export interface MinimapAttachment {
+interface MinimapAttachment {
     key: string;
     name: string;
 }
@@ -17,7 +17,7 @@ export interface MinimapItem {
     segments: MinimapSegment[];
     attachments: MinimapAttachment[];
 }
-export interface MinimapDash {
+interface MinimapDash {
     item: MinimapItem;
     index: number;
 }

package/dist/session/thread/first-prompt-handover.d.ts

@@ -15,7 +15,7 @@ export declare function transcriptCarriesFirstPrompt(turns: readonly Pick<Sessio
  * stand-in knew — text and file names — so it keeps drawing the bubble and the
  * pending tiles through any frame where its own parts are still streaming.
  */
-export interface FirstPromptHandoverInput {
+interface FirstPromptHandoverInput {
     /** The producer's copy exists (the boot preview store has this session). */
     hasPreview: boolean;
     /** The transcript's first user message carries its text right now. */
@@ -43,7 +43,7 @@ export interface FirstPromptHandoverInput {
      */
     transcriptEmpty?: boolean;
 }
-export interface FirstPromptHandover {
+interface FirstPromptHandover {
     /** Draw the stand-in bubble. */
     showStandIn: boolean;
     /** Hand the preview's text + file names to the real first turn. */
@@ -52,3 +52,4 @@ export interface FirstPromptHandover {
     released: boolean;
 }
 export declare function resolveFirstPromptHandover(input: FirstPromptHandoverInput): FirstPromptHandover;
+export {};

package/dist/session/thread/message-parsing.d.ts

@@ -18,7 +18,7 @@ export declare function parseSessionReferences(text: string): {
     cleanText: string;
     sessions: ParsedSessionRef[];
 };
-export interface ParsedProjectRef {
+interface ParsedProjectRef {
     id?: string;
     name: string;
     path?: string;
@@ -28,11 +28,11 @@ export declare function parseProjectReferences(text: string): {
     cleanText: string;
     projects: ParsedProjectRef[];
 };
-export interface ParsedFileMentionRef {
+interface ParsedFileMentionRef {
     path: string;
     name: string;
 }
-export interface ParsedAgentMentionRef {
+interface ParsedAgentMentionRef {
     name: string;
 }
 export declare function parseFileMentionReferences(text: string): {

package/dist/session/thread/session-chat.js

@@ -95,7 +95,6 @@ import { resolveSessionContentState } from '../status/session-load-state.js';
 import { nextOlderAutoloadArm, olderAutoloadExhausted, shouldLoadOlderHistory, } from './session-older-autoload.js';
 import { OLDER_LOADING_MIN_MS, useHeldOlderLoading } from './session-older-loading.js';
 import { HELD_COMMAND_ROW_PREFIX, canReleaseHeldCommand, heldCommandRows, } from '../composer/held-commands.js';
-import { useReadinessSettling } from '../status/use-readiness-settling.js';
 import { useSessionHistoryViewStore } from '../../internal/stores/session-history-view-store.js';
 import { downloadBlob } from '../../internal/lib/utils/download.js';
 import { RestoreNotice, hasOutOfContext } from './session-history.js';
@@ -389,7 +388,9 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
     const messages = thread?.messages.length ? thread.messages : undefined;
     // The thread for handlers that read it at call time (the optimistic answers cache).
     const threadRef = useRef(thread);
-    threadRef.current = thread;
+    useLayoutEffect(() => {
+        threadRef.current = thread;
+    }, [thread]);
     const messagesLoading = syncMessagesLoading;
     // Who wrote each user message. A one-person session stays unlabelled.
     const viewerId = useUiViewerId();
@@ -1285,6 +1286,7 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         autoLoadedPages,
         handleLoadOlder,
         scrollRef,
+        spacerElRef,
         sessionId,
         transcriptOnLog,
     ]);
@@ -1506,7 +1508,9 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
     const harnessSwitches = useMemo(() => sessionLogHarnessSwitches(sessionRecord?.harness?.history, turns), [sessionRecord?.harness?.history, turns]);
     // P5.6: load the whole of every text a turn shows as a preview, on request only.
     const fullTextsRef = useRef(loaded);
-    fullTextsRef.current = loaded;
+    useLayoutEffect(() => {
+        fullTextsRef.current = loaded;
+    });
     const loadFullTexts = useCallback((turnId, refs) => {
         const key = fullTextsRef.current.key;
         const mark = (state) => setFullTexts((prev) => {
@@ -3201,6 +3205,7 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
                     ? 'duration-slow max-h-130 translate-y-0 opacity-100'
                     : 'duration-slow pointer-events-none max-h-0 -translate-y-1 opacity-0'), children: _jsx(QuestionPrompt, { ref: questionPromptRef, request: renderedQuestion, onReply: handleQuestionReply, onReject: handleQuestionReject, onActionChange: handleQuestionActionChange }, renderedQuestion.id) })) : null] })), [
         sessionId,
+        sessionScopeAgentName,
         pendingPermissions,
         handlePermissionReply,
         renderedQuestion,
@@ -3208,10 +3213,6 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         handleQuestionReply,
         handleQuestionReject,
         handleQuestionActionChange,
-        tHardcodedUi,
-        local.model.fallback,
-        local.model.list,
-        handleModelChange,
     ]);
     // The rewound-path notice lives on the composer toolbar, beside send/stop —
     // send is what commits the path, so the control sits at the moment of
@@ -3271,15 +3272,10 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
     // its cause attached instead of a shrug. An actionable cause reports to
     // Sentry; a routine browser tab discard only leaves a breadcrumb.
     useReloadForensics(projectSessionId);
-    // Nothing has answered yet and the mount is young: the difference between
-    // "this session is asleep" and "we have not looked yet". Without it, every
-    // page load painted the waking notice for a beat over a session that was
-    // never asleep — which reads as a disconnect. See `settling`.
-    const composerSettling = useReadinessSettling(runtimePhase === 'connecting');
     // ONE answer for every surface that draws this session's runtime, and the
     // reason the composer no longer guesses: `unknown` and `connecting` are
-    // waits, and a wait is not a fault. Only the control plane saying the box is
-    // down earns the waking notice.
+    // waits, and a wait is not a fault. A routine wake says nothing either; only
+    // a parked box with no wake under way earns the asleep notice.
     const sessionConnection = projectSessionConnection({
         sandbox: projectSessionRow?.status ?? null,
         runtimeReady,
@@ -3292,7 +3288,6 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         pendingPrompt: allowSendBeforeReady && working.state === 'working',
         pendingDelivery: working.pendingDelivery,
         connection: sessionConnection,
-        settling: composerSettling,
         // Only an OPEN TURN the control plane is holding counts here. This tab's
         // optimistic receipt and a stream frame both survive a box that died
         // mid-turn, and a durable inbox row (which the projection also sources to
@@ -3405,8 +3400,9 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         // Change requests are the only kind a turn produces. `external` exists on
         // the union for `setup-links/setup-link-button.tsx`, which renders this
         // card inline in prose and handles its own open.
-        if (outcome.kind === 'change_request')
-            setOpenCrId(outcome.id.slice('cr:'.length));
+        if (outcome.kind === 'change_request') {
+            setOpenCrId(outcome.action.target ?? outcome.id.slice('cr:'.length));
+        }
     }, [setOpenCrId]);
     // While the session is still connecting / loading its content, render ONLY the
     // staged loader — never the session shell (header + input) at the same time.
@@ -3422,7 +3418,7 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         if (transcriptFreshness === 'error' && !hasMessages) {
             return (_jsx("div", { className: "bg-background relative flex h-full flex-col", "data-testid": "session-chat", children: _jsxs("div", { className: "flex flex-1 flex-col items-center justify-center gap-3 p-6", "data-testid": "session-transcript-error", children: [_jsx("p", { className: "text-muted-foreground text-sm", children: tHardcodedUi.raw('i18nComplete.text8d0cef2d3405') }), _jsx(Button, { variant: "outline", size: "sm", onClick: () => retryTranscript(), children: tHardcodedUi.raw('i18nComplete.text942087cc2d41') })] }) }));
         }
-        return (_jsx("div", { className: "bg-background relative flex h-full flex-col", "data-testid": "session-chat", children: _jsx(SessionStartingLoader, { stage: runtimeReady ? 'ready' : 'starting', variant: "compact", projectId: projectId, sessionId: projectSessionId }) }));
+        return (_jsx("div", { className: "bg-background relative flex h-full flex-col", "data-testid": "session-chat", children: _jsx(SessionStartingLoader, { projectId: projectId, sessionId: projectSessionId }) }));
     }
     return (
     // Outcomes' cache coherence and the shareable `?cr=` link both hinge on
@@ -3439,7 +3435,7 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
                     : welcomeWallpaper, !hideHeader && (_jsx(SessionSiteHeader, { sessionId: sessionId, sessionTitle: session?.title || 'Untitled', leadingAction: headerLeadingAction, parent: parentCrumb })), _jsx(SessionContextModal, { open: contextModalOpen, onOpenChange: setContextModalOpen, 
                     // A chat with no `useSession` source: the raw explorer lists the
                     // rows `useSessionSync` read for it.
-                    detachedRows: sessionState ? undefined : hookMessages, source: sessionState ?? DETACHED_SESSION_MESSAGES, session: session, providers: providers, allSessions: allSessions, servedModel: sessionServedModel, billedCost: sessionBilledCost(modelUsage) }), _jsx(CompactModal, { sessionId: sessionId, open: compactModalOpen, onOpenChange: setCompactModalOpen }), _jsx(ChangeRequestDetailDialog, { crId: openCrId, onClose: () => setOpenCrId(null) }), _jsxs(SessionBodyRow, { actionPanel: !hideHeader && !readOnly, children: [isNotFound ? (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col items-center justify-center gap-3 px-6 text-center", children: [_jsx("div", { className: "text-muted-foreground text-sm", children: tHardcodedUi.raw('componentsSessionSessionChat.line5821JsxTextThisSessionIsNotAccessibleRightNow') }), _jsx(Button, { asChild: true, variant: "outline", size: "sm", children: _jsx(Link, { href: "/", prefetch: true, onClick: () => {
+                    detachedRows: sessionState ? undefined : hookMessages, source: sessionState ?? DETACHED_SESSION_MESSAGES, session: session, providers: providers, allSessions: allSessions, servedModel: sessionServedModel, billedCost: sessionBilledCost(modelUsage) }), _jsx(CompactModal, { sessionId: sessionId, open: compactModalOpen, onOpenChange: setCompactModalOpen }), _jsx(ChangeRequestDetailDialog, { crId: openCrId, onClose: () => setOpenCrId(null), onOpenChangeRequest: setOpenCrId }), _jsxs(SessionBodyRow, { actionPanel: !hideHeader && !readOnly, children: [isNotFound ? (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col items-center justify-center gap-3 px-6 text-center", children: [_jsx("div", { className: "text-muted-foreground text-sm", children: tHardcodedUi.raw('componentsSessionSessionChat.line5821JsxTextThisSessionIsNotAccessibleRightNow') }), _jsx(Button, { asChild: true, variant: "outline", size: "sm", children: _jsx(Link, { href: "/", prefetch: true, onClick: () => {
                                             try {
                                                 if (sessionId)
                                                     useTabStore.getState().closeTab?.(sessionId);

package/dist/session/thread/session-history-scroll.d.ts

@@ -36,7 +36,7 @@
  * runs after layout and before paint. No frame is painted with the jump,
  * whenever the content lands.
  */
-export interface TurnScrollAnchor {
+interface TurnScrollAnchor {
     element: HTMLElement;
     /** The anchor's position in content space at capture time. */
     contentTop: number;
@@ -53,3 +53,4 @@ export declare function captureTurnScrollAnchor(container: HTMLElement): TurnScr
  * idempotent. An anchor that left the DOM is never written.
  */
 export declare function holdTurnScrollAnchor(container: HTMLElement, content: HTMLElement, anchor: TurnScrollAnchor | null): () => void;
+export {};

package/dist/session/thread/session-history.js

@@ -15,6 +15,7 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
  */
 import { ArrowsLeftRightIcon, ClockCounterClockwiseIcon, XIcon } from '@phosphor-icons/react';
 import { sessionLogFullTextAction, sessionLogReferencedTexts, } from '@kortix/sdk';
+import { useMemo } from 'react';
 import { Button } from '../../primitives/button.js';
 import { InfoBanner } from '../../primitives/info-banner.js';
 import { useLocale, useTranslations } from '../../i18n/index.js';
@@ -51,7 +52,8 @@ function missingLabel(t, kind, count) {
 export function RestoreNotice({ notice, onDismiss }) {
     const t = useTranslations('sessionUi.history');
     const locale = useLocale();
-    const items = new Intl.ListFormat(locale, { style: 'narrow', type: 'unit' }).format(notice.missing.map((m) => missingLabel(t, m.kind, m.count)));
+    const listFormat = useMemo(() => new Intl.ListFormat(locale, { style: 'narrow', type: 'unit' }), [locale]);
+    const items = listFormat.format(notice.missing.map((m) => missingLabel(t, m.kind, m.count)));
     return (
     // `info`: the neutral tone keeps `Alert`'s default fill under a hairline (two boundaries).
     _jsxs(InfoBanner, { tone: "info", role: "status", "data-restore-notice": "", className: "mb-6 rounded-md", icon: ClockCounterClockwiseIcon, title: t('restoreTitle'), action: _jsx(Button, { variant: "ghost", size: "icon-sm", onClick: onDismiss, "aria-label": t('restoreDismiss'), className: "text-muted-foreground", children: _jsx(XIcon, { className: "size-4" }) }), children: [notice.missing.length > 0 && _jsxs("span", { children: [t('restoreMissing', { items }), " "] }), t('restoreAgent')] }));

package/dist/session/thread/session-thread.js

@@ -9,5 +9,5 @@ import { SessionStartingLoader } from '../status/session-starting-loader.js';
 import '../tool/tools/register.js';
 export function SessionThread({ session, hideHeader = false, readOnly = false, quote, className }) {
     const { projectId, sessionId, runtimeSessionId } = session;
-    return (_jsx(ProjectScope, { projectId: projectId, sessionId: sessionId, children: _jsx(ProviderPoolDraftBoundary, { identity: `${projectId}/${sessionId}`, children: _jsxs("div", { "data-slot": "session-thread", className: cn('relative flex h-full min-h-0 flex-col', className), children: [runtimeSessionId ? (_jsx(SessionChat, { sessionId: runtimeSessionId, projectSessionId: sessionId, projectId: projectId, sessionState: session, hideHeader: hideHeader, readOnly: readOnly, hostQuote: quote }, runtimeSessionId)) : (_jsx(SessionStartingLoader, { stage: session.stage === 'starting' ? 'starting' : 'provisioning', projectId: projectId, sessionId: sessionId })), _jsx(SessionPanelFallback, { projectId: projectId, projectSessionId: sessionId, runtimeSessionId: runtimeSessionId })] }) }) }));
+    return (_jsx(ProjectScope, { projectId: projectId, sessionId: sessionId, children: _jsx(ProviderPoolDraftBoundary, { identity: `${projectId}/${sessionId}`, children: _jsxs("div", { "data-slot": "session-thread", className: cn('relative flex h-full min-h-0 flex-col', className), children: [runtimeSessionId ? (_jsx(SessionChat, { sessionId: runtimeSessionId, projectSessionId: sessionId, projectId: projectId, sessionState: session, hideHeader: hideHeader, readOnly: readOnly, hostQuote: quote }, runtimeSessionId)) : (_jsx(SessionStartingLoader, { projectId: projectId, sessionId: sessionId })), _jsx(SessionPanelFallback, { projectId: projectId, projectSessionId: sessionId, runtimeSessionId: runtimeSessionId })] }) }) }));
 }

package/dist/session/thread/transcript.js

@@ -43,6 +43,8 @@ import { Disclosure, DisclosureContent, DisclosureTrigger } from '../../primitiv
 import { useUserPreferencesStore } from '../../internal/stores/user-preferences-store.js';
 import { SubSessionModal } from './sub-session-modal.js';
 import { ToolPartRenderer, TurnLiveContext } from '../tool/tool-renderers.js';
+import { RecoveredCallsContext } from '../tool/shared/infrastructure.js';
+import { recoveredShellFailures } from '../turn/recovered-failures.js';
 import { cn } from '../../lib/utils.js';
 import { extractKortixSystemMessages, extractSessionReport, stripKortixSystemTags, } from '../../internal/lib/utils/kortix-system-tags.js';
 // Shared UI primitives (framework-agnostic, reusable on mobile)
@@ -959,6 +961,8 @@ function TurnUserBubble(props) {
                         ? () => onRemoveQueued(pendingPrompt.prompt_id)
                         : undefined })) : queuedStatus === 'sending' || queuedStatus === 'queued' || queuedStatus === 'interrupted' ? (_jsx(QueuedPromptProgress, { state: queuedStatus })) : undefined }) })) }));
 }
+/** One shared empty set: a live turn has no recovered calls yet. */
+const NO_RECOVERED_CALLS = new Set();
 /** The assistant's part tree: bursts, standalone deliverables, and prose
  *  between them, under one live-context provider. */
 function TurnToolBlocks(props) {
@@ -972,6 +976,8 @@ function TurnToolBlocks(props) {
     // Settled turns only: while working the split is null anyway, and the
     // filter re-runs the burst steps on every SSE frame.
     const split = useMemo(() => (fold && !working ? splitSessionLogTurnWork(segments.filter(segmentRendersSomething), { working }) : null), [fold, segments, working]);
+    // Settled turns only: while the turn runs, the next step has not happened yet.
+    const recovered = useMemo(() => (working ? NO_RECOVERED_CALLS : recoveredShellFailures(turnBlocks(turn))), [turn, working]);
     const renderSegment = (segment) => {
         const key = turnSegmentKey(segment);
         if (key === null)
@@ -984,13 +990,13 @@ function TurnToolBlocks(props) {
         // will. Provided here rather than per-row because `working` is a fact
         // about the TURN, and this block is the turn's whole part tree.
         // See `TurnLiveContext`.
-        _jsx(TurnLiveContext.Provider, { value: working, children: _jsx("div", { className: "space-y-3", children: split
-                    ? [
-                        _jsx(TurnWorkAccordion, { durationMs: durationMs, children: split.work.map(renderSegment) }, "turn-work"),
-                        ...split.hoisted.map(renderSegment),
-                        ...split.final.map(renderSegment),
-                    ]
-                    : segments.map(renderSegment) }) })) }));
+        _jsx(TurnLiveContext.Provider, { value: working, children: _jsx(RecoveredCallsContext.Provider, { value: recovered, children: _jsx("div", { className: "space-y-3", children: split
+                        ? [
+                            _jsx(TurnWorkAccordion, { durationMs: durationMs, children: split.work.map(renderSegment) }, "turn-work"),
+                            ...split.hoisted.map(renderSegment),
+                            ...split.final.map(renderSegment),
+                        ]
+                        : segments.map(renderSegment) }) }) })) }));
 }
 /** One segment of the turn's steps section: a burst, a show group, a
  *  standalone deliverable, or prose between bursts. Keyed by the first