@kortix/ui 0.14.4 → 0.14.5

package/dist/session/print/session-print-header.d.ts

@@ -1,13 +1,3 @@
-/**
- * The masthead of a printed conversation.
- *
- * A PDF of a session is read away from the app — attached to a ticket, mailed
- * to a customer, filed as a record — so it has to say what it is on its own
- * face. On screen this renders nothing (`print.css` keeps `[data-print-header]`
- * display:none until the print media query), and it is in the DOM at all times
- * so that printing needs no re-render: `window.print()` is synchronous, and a
- * React commit scheduled beside it is not guaranteed to land first.
- */
 export interface SessionPrintHeaderProps {
     title: string;
     projectName?: string | null;

package/dist/session/print/session-print-header.js

@@ -1,5 +1,19 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The masthead of a printed conversation.
+ *
+ * A PDF of a session is read away from the app — attached to a ticket, mailed
+ * to a customer, filed as a record — so it has to say what it is on its own
+ * face. On screen this renders nothing (`print.css` keeps `[data-print-header]`
+ * display:none until the print media query), and it is in the DOM at all times
+ * so that printing needs no re-render: `window.print()` is synchronous, and a
+ * React commit scheduled beside it is not guaranteed to land first.
+ *
+ * The agent is named the way the composer names it: a host's `agentLabels`
+ * entry wins over the raw agent name.
+ */
+import { useUiHostConfig } from '../../providers/ui-provider.js';
 /** `16 September 2026 at 20:41` — unambiguous across locales, no slashes. */
 export function formatPrintedAt(date) {
     return new Intl.DateTimeFormat('en-GB', {
@@ -19,9 +33,10 @@ export function printHeaderMeta(input) {
         .join(' · ');
 }
 export function SessionPrintHeader({ title, projectName, agentName, now, }) {
+    const { agentLabels } = useUiHostConfig();
     const meta = printHeaderMeta({
         projectName,
-        agentName,
+        agentName: (agentName && agentLabels?.[agentName]) || agentName,
         printedAt: formatPrintedAt(now ?? new Date()),
     });
     return (

package/dist/session/status/session-surface.js

@@ -113,7 +113,7 @@ export function resolveResumeOverlay(input) {
  * skeleton rows instead of a restart card or the boot screen.
  */
 export function hasOrExpectsTranscript(input) {
-    return input.hasTranscript || input.savedTranscript === 'loading';
+    return input.hasTranscript || input.savedTranscript !== 'none';
 }
 /**
  * Should the local "brand new session" hint be forgotten?

package/dist/session/thread/optimistic-turn.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+import { parseSessionReferences } from './message-parsing.js';
 import type { SentAttachment } from '../composer/sent-attachment-previews.js';
 import { type AttachmentUploadStatus } from '../turn/user-message.js';
 /**
@@ -82,8 +83,11 @@ busy, deliveryStatus, className, }: {
  * app: chip in the composer, underline in the optimistic bubble, underline
  * again in the server turn.
  */
-export declare function HighlightMentions({ text, agentNames, onFileClick, }: {
+export declare function HighlightMentions({ text, sessions: parsedSessions, agentNames, onFileClick, }: {
     text: string;
+    /** The session refs the caller already stripped from `text`. Then `text` is
+     *  not parsed again: a second parse finds no refs and loses every title. */
+    sessions?: ReturnType<typeof parseSessionReferences>['sessions'];
     agentNames?: string[];
     onFileClick?: (path: string) => void;
 }): import("react").JSX.Element;

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

@@ -85,7 +85,7 @@ function OptimisticUserBubble({ text, agentNames, onFileClick, deferPreview, sta
     // Strip every ref block the composer folded into the prompt, in the order it
     // folded them in, so the bubble shows the sentence the user typed and the
     // attachments as tiles — never raw XML.
-    const { quotes, files, cleanText, pastes } = useMemo(() => {
+    const { quotes, files, cleanText, pastes, sessions } = useMemo(() => {
         // Pastes first, as on the sent turn: a ref inside a paste is paste text.
         const { text: afterPastes, pastes } = splitPastedContent(text);
         const { cleanText: afterReply, quotes } = parseReplyContexts(afterPastes);
@@ -93,8 +93,8 @@ function OptimisticUserBubble({ text, agentNames, onFileClick, deferPreview, sta
         const { cleanText: afterProjects } = parseProjectReferences(afterFiles);
         const { cleanText: afterFileMentions } = parseFileMentionReferences(afterProjects);
         const { cleanText: afterAgentMentions } = parseAgentMentionReferences(afterFileMentions);
-        const { cleanText } = parseSessionReferences(afterAgentMentions);
-        return { quotes, files, cleanText, pastes };
+        const { cleanText, sessions } = parseSessionReferences(afterAgentMentions);
+        return { quotes, files, cleanText, pastes, sessions };
     }, [text]);
     // Quotes are drawn where they were written, by the same component the sent
     // message uses — see `QuotedMessageBody`.
@@ -129,7 +129,7 @@ function OptimisticUserBubble({ text, agentNames, onFileClick, deferPreview, sta
         }));
         return [...pastes.map(pastedAttachment), ...fromText, ...fromStaged];
     }, [pastes, files, deferPreview, staged]);
-    return (_jsxs("div", { className: "ml-auto flex w-full max-w-[80%] flex-col items-end gap-2 self-end", children: [attachments.length > 0 && (_jsx(MessageAttachments, { attachments: attachments, status: uploadStatus })), (cleanText || quotedPieces) && (_jsx("div", { className: cn(BUBBLE_SURFACE, 'w-fit overflow-hidden'), children: quotedPieces ? (_jsx(QuotedMessageBody, { pieces: quotedPieces, renderText: (runText) => (_jsx(HighlightMentions, { text: runText, agentNames: agentNames, onFileClick: onFileClick })) })) : (_jsx("p", { className: BUBBLE_TEXT, children: _jsx(HighlightMentions, { text: cleanText, agentNames: agentNames, onFileClick: onFileClick }) })) })), _jsx(UserMessageActions, { timestamp: null, copyText: expandPastedContent(text), deliveryStatus: deliveryStatus })] }));
+    return (_jsxs("div", { className: "ml-auto flex w-full max-w-[80%] flex-col items-end gap-2 self-end", children: [attachments.length > 0 && (_jsx(MessageAttachments, { attachments: attachments, status: uploadStatus })), (cleanText || quotedPieces) && (_jsx("div", { className: cn(BUBBLE_SURFACE, 'w-fit overflow-hidden'), children: quotedPieces ? (_jsx(QuotedMessageBody, { pieces: quotedPieces, renderText: (runText) => (_jsx(HighlightMentions, { text: runText, sessions: sessions, agentNames: agentNames, onFileClick: onFileClick })) })) : (_jsx("p", { className: BUBBLE_TEXT, children: _jsx(HighlightMentions, { text: cleanText, sessions: sessions, agentNames: agentNames, onFileClick: onFileClick }) })) })), _jsx(UserMessageActions, { timestamp: null, copyText: expandPastedContent(text), deliveryStatus: deliveryStatus })] }));
 }
 /**
  * Highlight @mentions in plain text (for optimistic & user messages).
@@ -141,11 +141,13 @@ function OptimisticUserBubble({ text, agentNames, onFileClick, deferPreview, sta
  * app: chip in the composer, underline in the optimistic bubble, underline
  * again in the server turn.
  */
-export function HighlightMentions({ text, agentNames, onFileClick, }) {
+export function HighlightMentions({ text, sessions: parsedSessions, agentNames, onFileClick, }) {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     // Strip every ref block (project/file/agent/session) before processing
     // inline @ mentions so the visible text never shows raw XML.
     const { cleanText, sessions } = useMemo(() => {
+        if (parsedSessions)
+            return { cleanText: text, sessions: parsedSessions };
         const a = parseProjectReferences(text);
         const b = parseFileMentionReferences(a.cleanText);
         const c = parseAgentMentionReferences(b.cleanText);
@@ -154,7 +156,7 @@ export function HighlightMentions({ text, agentNames, onFileClick, }) {
             cleanText: d.cleanText,
             sessions: d.sessions,
         };
-    }, [text]);
+    }, [text, parsedSessions]);
     const sessionTitles = useMemo(() => sessions.map((s) => s.title), [sessions]);
     const segments = useMemo(() => {
         const built = buildMentionSegments({ text: cleanText, sessionTitles, agentNames });

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

@@ -2,6 +2,11 @@ import { type UseSessionResult } from '@kortix/sdk/react';
 export { SessionReportCard, deriveTurnErrorAbortState, deriveTurnErrorPresentation } from './transcript.js';
 interface SessionChatProps {
     sessionId: string;
+    /** A host's reply quote (`SessionThreadProps.quote`): each new id adds its text to the composer's quotes. */
+    hostQuote?: {
+        id: number;
+        text: string;
+    } | null;
     /** Durable Kortix project session id used by project-session APIs. */
     projectSessionId?: string;
     /** Complete SDK state for the root session. Omit for a read-only child session. */
@@ -59,4 +64,4 @@ interface SessionChatProps {
      */
     deferComposerFocus?: boolean;
 }
-export declare function SessionChat({ sessionId, projectSessionId, sessionState, projectId, boundAgentName, headerLeadingAction, hideHeader, readOnly, inputReplacement, initialScrollTop, savedHistoryScope, onContentReady, deferComposerFocus, }: SessionChatProps): import("react").JSX.Element;
+export declare function SessionChat({ sessionId, projectSessionId, sessionState, projectId, boundAgentName, headerLeadingAction, hideHeader, readOnly, inputReplacement, initialScrollTop, savedHistoryScope, onContentReady, deferComposerFocus, hostQuote, }: SessionChatProps): import("react").JSX.Element;

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

@@ -171,7 +171,7 @@ const TRANSCRIPT_THROTTLE_MS = 50;
 /** `useSessionMessages` input when no `useSession` owns this chat: reads nothing. */
 const DETACHED_SESSION_MESSAGES = { projectId: '', sessionId: '', runtimeSessionId: null };
 const NO_FULL_TEXTS = new Map();
-export function SessionChat({ sessionId, projectSessionId, sessionState, projectId, boundAgentName, headerLeadingAction, hideHeader, readOnly, inputReplacement, initialScrollTop, savedHistoryScope, onContentReady, deferComposerFocus, }) {
+export function SessionChat({ sessionId, projectSessionId, sessionState, projectId, boundAgentName, headerLeadingAction, hideHeader, readOnly, inputReplacement, initialScrollTop, savedHistoryScope, onContentReady, deferComposerFocus, hostQuote, }) {
     const tHardcodedUi = useTranslations('hardcodedUi');
     const tQueue = useTranslations('threads');
     const tComposerAttachments = useTranslations('hardcodedUi.composerAttachments');
@@ -283,6 +283,17 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         }
         lastScrollTopRef.current = top;
     }, []);
+    // A host's quote: each new id is one more request, like a "Reply" click.
+    const hostQuoteIdRef = useRef(null);
+    useEffect(() => {
+        const text = hostQuote?.text.trim();
+        if (!hostQuote || !text || hostQuoteIdRef.current === hostQuote.id)
+            return;
+        hostQuoteIdRef.current = hostQuote.id;
+        quoteRequestIdRef.current += 1;
+        const request = { id: quoteRequestIdRef.current, text };
+        setQuoteRequests((current) => [...current, request]);
+    }, [hostQuote]);
     // When user clicks "Reply" in the popup
     const handleSelectionReply = useCallback(() => {
         if (!selectionPopup)
@@ -1477,6 +1488,7 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         held: heldTurnIds,
         pricing: pricingLookup,
         hideOutOfContext,
+        foldCompactions: true,
     }), [lastTurnWorking, heldTurnIds, pricingLookup, hideOutOfContext]);
     // WHICH turn carries the shimmer (`live`), and which user bubbles are still
     // queued at the agent (`queued`): the working projection's turn, else this
@@ -1948,7 +1960,7 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
     // A compaction turn of any state (`turn.compaction`), so a failed attempt's
     // turn suppresses the optimistic "Compacting…" marker instead of leaving it
     // shimmering beside the failure row.
-    const hasCompactionTurn = useMemo(() => turns.some((turn) => turn.compaction !== null), [turns]);
+    const hasCompactionTurn = useMemo(() => turns.some((turn) => turn.compaction !== null || turn.blocks.some((block) => block.type === 'compaction')), [turns]);
     // Index of the LAST compaction turn (any state). Every FAILED attempt
     // before it is history the reader retried past — a run of retries renders
     // as ONE failure row (the latest), not a stack of near-identical lines.
@@ -3382,6 +3394,13 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
         // when the host router observes history and routes through it otherwise.
         shallowNavigate(qs ? `${pathname}?${qs}` : pathname, { replace: true });
     }, [readOnly, pathname, searchParams, shallowNavigate]);
+    // A session tab stays mounted, so a later `?cr=` (the turn-done toast's
+    // Review) must open the dialog too, not only the one read at mount.
+    const crParam = readOnly ? null : (searchParams?.get('cr') ?? null);
+    useEffect(() => {
+        if (crParam)
+            setOpenCrIdState(crParam);
+    }, [crParam]);
     const handleOpenOutcome = useCallback((outcome) => {
         // Change requests are the only kind a turn produces. `external` exists on
         // the union for `setup-links/setup-link-button.tsx`, which renders this
@@ -3448,7 +3467,7 @@ export function SessionChat({ sessionId, projectSessionId, sessionState, project
                                         // it — the "extra inset at the bottom of the session".
                                         className: SESSION_TRANSCRIPT_CLASS, children: [_jsxs("div", { className: "flex min-w-0 flex-col", children: [_jsx(SessionPrintHeader, { title: session?.title || 'Untitled', agentName: composerAgentName }), (hasOlder || showOlderLoading) && (_jsxs("div", { className: "mb-6 flex flex-col items-center gap-2", children: [hasOlder && (_jsx("div", { ref: olderSentinelRef, "aria-hidden": true, className: "h-px w-full" })), showOlderLoading && (_jsxs("div", { role: "status", className: "text-muted-foreground flex items-center gap-2 py-1 text-xs", children: [_jsx(Loading, { className: "size-3.5 shrink-0" }), tHardcodedUi.raw('i18nComplete.text85bf890776a7')] })), !showOlderLoading &&
                                                                 !olderPullFailed &&
-                                                                olderAutoloadExhausted({ hasOlder, autoLoadedPages }) && (_jsx(Button, { type: "button", variant: "outline-ghost", size: "sm", onClick: () => void handleLoadOlder(), children: tHardcodedUi.raw('i18nComplete.textf17671d83db0') })), olderPullFailed && !showOlderLoading && (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-muted-foreground text-xs", children: tHardcodedUi.raw('i18nComplete.textb03a0041ce33') }), _jsx(Button, { type: "button", variant: "outline-ghost", size: "sm", onClick: () => void handleLoadOlder(), children: tHardcodedUi.raw('i18nComplete.text942087cc2d41') })] }))] })), restoreNotice && !restoreDismissed && (_jsx(RestoreNotice, { notice: restoreNotice, onDismiss: () => dismissRestore(historyKey, restoreNotice.generation) })), _jsx(SessionOutcomesProvider, { projectSessionId: projectSessionId, turnSpans: turnSpans, onOpen: handleOpenOutcome, children: _jsxs(ToolActivateContext.Provider, { value: toolActivate, children: [showFirstPromptPreview &&
+                                                                olderAutoloadExhausted({ hasOlder, autoLoadedPages }) && (_jsx(Button, { type: "button", variant: "outline-ghost", size: "sm", onClick: () => void handleLoadOlder(), children: tHardcodedUi.raw('i18nComplete.textf17671d83db0') })), olderPullFailed && !showOlderLoading && (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-muted-foreground text-xs", children: tHardcodedUi.raw('i18nComplete.textb03a0041ce33') }), _jsx(Button, { type: "button", variant: "outline-ghost", size: "sm", onClick: () => void handleLoadOlder(), children: tHardcodedUi.raw('i18nComplete.text942087cc2d41') })] }))] })), restoreNotice && !restoreDismissed && (_jsx(RestoreNotice, { notice: restoreNotice, onDismiss: () => dismissRestore(historyKey, restoreNotice.generation) })), _jsx(SessionOutcomesProvider, { projectSessionId: projectSessionId, turnSpans: turnSpans, busy: effectiveBusy, onOpen: handleOpenOutcome, children: _jsxs(ToolActivateContext.Provider, { value: toolActivate, children: [showFirstPromptPreview &&
                                                                     firstPromptSource &&
                                                                     queuedSyntheticMessages.length === 0 && (_jsx(OptimisticTurn, { text: buildOptimisticPromptTextWithUploads(firstPromptSource.text, firstPromptSource.files), 
                                                                     // Preserve a real failed-send status through the

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

@@ -21,6 +21,15 @@ export interface SessionThreadProps {
     hideHeader?: boolean;
     /** Hide the composer: a transcript to read, not to answer. */
     readOnly?: boolean;
+    /**
+     * A quote the host adds to the composer's reply quotes (the card above the
+     * input), as a transcript selection's "Reply" does. Each new `id` adds its
+     * `text` once.
+     */
+    quote?: {
+        id: number;
+        text: string;
+    } | null;
     className?: string;
 }
-export declare function SessionThread({ session, hideHeader, readOnly, className }: SessionThreadProps): import("react").JSX.Element;
+export declare function SessionThread({ session, hideHeader, readOnly, quote, className }: SessionThreadProps): import("react").JSX.Element;

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

@@ -7,7 +7,7 @@ import { SessionPanelFallback } from '../panel/panel-fallback.js';
 import { SessionChat } from './session-chat.js';
 import { SessionStartingLoader } from '../status/session-starting-loader.js';
 import '../tool/tools/register.js';
-export function SessionThread({ session, hideHeader = false, readOnly = false, className }) {
+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 }, 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, { stage: session.stage === 'starting' ? 'starting' : 'provisioning', projectId: projectId, sessionId: sessionId })), _jsx(SessionPanelFallback, { projectId: projectId, projectSessionId: sessionId, runtimeSessionId: runtimeSessionId })] }) }) }));
 }

package/dist/session/turn/burst-step-body.js

@@ -5,6 +5,7 @@ import { ActivityGroupStep } from './activity-group-step.js';
 import { ActivityStep, StepLabelRow } from './activity-step.js';
 import { AnsweredQuestionStep, isAnsweredQuestionCall } from './answered-question-step.js';
 import { stepLabel } from '@kortix/sdk';
+import { CompactionMarker } from './compaction-card.js';
 import { ToolRegistry } from '../tool/shared/registry.js';
 /** A host's `ToolRegistry.register` row for this tool wins over the chip and question rows. */
 const hostRow = (call) => ToolRegistry.replaced(call.name, call.kind);
@@ -44,6 +45,9 @@ export function StepBody({ step, bareRow = false, running, sessionId, disableNav
         const calls = step.blocks;
         return isFileChipRun(calls) ? (_jsx(ActivityFileChipStep, { calls: calls, sessionId: sessionId, disableNavigation: disableNavigation })) : (_jsx(ActivityGroupStep, { step: { id: calls[0].call_id, family: step.family, label: step.label, parts: calls, status: step.status, durationMs: step.durationMs }, sessionId: sessionId, disableNavigation: disableNavigation }));
     }
+    if (step.block.type === 'compaction') {
+        return _jsx(CompactionMarker, { running: running && step.block.summary === null, summary: step.block.summary ?? undefined });
+    }
     // Neither tool nor reasoning: the label row only. The turn modules never
     // silently drop a block (`stepLabel` falls back to a generic 'Used' label).
     if (step.block.type !== 'tool_call') {