@nomix-ai/nomix-harness 0.2.4 → 0.2.6

package/dist/kernel/client-ui-conversation/lib/index.js

@@ -1,5 +1,5 @@
 import { settingsNamespace } from "../../settings/lib/index.js";
-import z from "@nomix-ai/schemastery";
+import z from "../../schemastery/lib/index.mjs";
 //#region lib/types/submission-settings.js
 /** Busy-Enter preference stored in the Host user-settings document. */
 /** Settings namespace owned by the conversation plugin. */

package/dist/kernel/client-ui-conversation/lib/types/client/apply.d.ts

@@ -1,5 +1,5 @@
 /** Registers the conversation components, shared store, and service callbacks. */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../../cordis/lib/index.js';
 import { type ConversationKey } from './locales.ts';
 declare module '@nomix-ai/nomix-client-ui-slots' {
     interface LocaleNamespaceMap {

package/dist/kernel/client-ui-conversation/lib/types/client/apply.js

@@ -163,6 +163,7 @@ export function apply(ctx) {
             'conversation.composer.dock': { kind: 'list', scope: 'session' },
             'conversation.input.left': { kind: 'list', scope: 'session' },
             'conversation.input.right': { kind: 'list', scope: 'session' },
+            'conversation.hero.brand.mark': { kind: 'single', scope: 'root' },
             'conversation.hero.workspace': { kind: 'single', scope: 'root' },
             'conversation.hero.agentPreset': { kind: 'single', scope: 'root' },
         },
@@ -214,6 +215,7 @@ export function apply(ctx) {
         name: 'conversation.session.header',
         locale: NS,
         children: {
+            'conversation.session.header.lineage': { kind: 'single', scope: 'session' },
             'conversation.session.header.actions': { kind: 'list', scope: 'session' },
             'conversation.session.header.utilities': { kind: 'list', scope: 'session' },
         },
@@ -237,6 +239,7 @@ export function apply(ctx) {
         // access control, model right); empty until their owning plugins
         // register.
         children: {
+            'conversation.input.attachments': { kind: 'single', scope: 'session-maybe' },
             'conversation.input.plan': { kind: 'single', scope: 'session' },
             'conversation.input.model': { kind: 'single', scope: 'session' },
         },
@@ -290,6 +293,7 @@ export function apply(ctx) {
                         inputTriggers.toggleSource('command', {
                             trigger: '/',
                             query: '',
+                            quoted: false,
                             position: snapshot.draft.slice(0, selection.start).trim() === '' ? 'leading' : 'inline',
                             span: { ...selection, draftRev: snapshot.draftRev },
                         });
@@ -334,6 +338,7 @@ export function apply(ctx) {
         locale: NS,
         children: {
             'conversation.chat.node': { kind: 'keyed', scope: 'session', inject: CHAT_NODE_INJECT },
+            'conversation.message.images': { kind: 'single', scope: 'session' },
         },
         store: chatStore,
         inject: (sessionId, actions) => {
@@ -347,10 +352,7 @@ export function apply(ctx) {
                 fileMentions: owner => ctx.get('chatFileMentions')?.forClosing(owner),
                 openFile: (path) => {
                     const cwd = sessions.list.getSnapshot().byId[sessionId]?.cwd;
-                    void workspaces.openPath(resolveWorkspacePath(cwd, path)).catch(() => {
-                        // Host/OS open failures stay silent in the chat row; the native
-                        // app surfaces its own error dialog when the path is unusable.
-                    });
+                    return workspaces.openPath(resolveWorkspacePath(cwd, path));
                 },
                 loadOlder: () => { void scoped.loadOlder(); },
                 loadImage: attachment => conversation.resolveImage(sessionId, attachment),

package/dist/kernel/client-ui-conversation/lib/types/client/chat/AssistantMarkdown.d.ts

@@ -1,19 +1,18 @@
 import type { AssistantBlock } from '../../../../../client-runtime/lib/client.js';
 import type { MarkdownFileMentions } from '../../../../../client-ui-primitives/lib/index.js';
-import { type ImageLoader } from '../../../../../client-ui-attachment/lib/index.js';
-import type { ChatViewSlotProps } from '../contract/slots.ts';
+import type { ChatNodeOwnerProps, ChatViewSlotProps } from '../contract/slots.ts';
 export interface AssistantMarkdownProps {
     blocks: readonly AssistantBlock[];
     streaming: boolean;
     /** Frozen partial of an aborted turn: rendered with a stopped marker. */
     interrupted?: boolean | undefined;
-    /** Session-authorized durable image loader. */
-    loadImage?: ImageLoader;
+    /** Render consecutive image blocks through the attachment slot. */
+    renderMessageImages: ChatNodeOwnerProps['renderMessageImages'];
     /** Resolved prose file mentions for this Assistant's closing turn. */
     mentions?: MarkdownFileMentions | undefined;
     /** The owning view's locale seat, passed down as a plain prop. */
     t: ChatViewSlotProps['t'];
 }
 /** Reasoning block as the Think variant summary row (figma 39:28304). */
-export declare const AssistantMarkdown: import("react").MemoExoticComponent<({ blocks, streaming, interrupted, loadImage, mentions, t, }: AssistantMarkdownProps) => import("react").JSX.Element | null>;
+export declare const AssistantMarkdown: import("react").MemoExoticComponent<({ blocks, streaming, interrupted, renderMessageImages, mentions, t, }: AssistantMarkdownProps) => import("react").JSX.Element | null>;
 //# sourceMappingURL=AssistantMarkdown.d.ts.map

package/dist/kernel/client-ui-conversation/lib/types/client/chat/AssistantMarkdown.js

@@ -9,15 +9,12 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // (`time` is omitted for mid-turn narration and while the turn still runs);
 // their branch action is enabled only when the node is also the completed
 // turn's transcript tail. Think / tool-head-only nodes stay chrome-free.
-import { memo, useMemo } from 'react';
+import { Fragment, memo, useMemo } from 'react';
 import { JsonBlock, MarkdownText } from '../../../../../client-ui-primitives/lib/index.js';
-import { ImageGallery } from '../../../../../client-ui-attachment/lib/index.js';
-import { messageImageLabels } from "../image-labels.js";
 import { ReasoningRow } from "./ReasoningRow.js";
 import css from './AssistantMarkdown.module.css';
 /** Reasoning block as the Think variant summary row (figma 39:28304). */
-export const AssistantMarkdown = memo(function AssistantMarkdown({ blocks, streaming, interrupted, loadImage, mentions, t, }) {
-    const imageLoader = loadImage ?? (() => Promise.reject(new Error(t('image.serviceUnavailable'))));
+export const AssistantMarkdown = memo(function AssistantMarkdown({ blocks, streaming, interrupted, renderMessageImages, mentions, t, }) {
     // Stable per locale revision (t identity changes on switch): a fresh object
     // per render would rebuild MarkdownText's component table every chunk.
     const codeLabels = useMemo(() => ({ copyLabel: t('copy'), copiedLabel: t('copied') }), [t]);
@@ -57,7 +54,10 @@ export const AssistantMarkdown = memo(function AssistantMarkdown({ blocks, strea
                     group.push(next);
                     i += 1;
                 }
-                rendered.push(_jsx(ImageGallery, { images: group, load: imageLoader, align: "start", labels: messageImageLabels(t) }, start));
+                rendered.push(_jsx(Fragment, { children: renderMessageImages({
+                        images: group.map(({ attachment }) => ({ attachment })),
+                        align: 'start',
+                    }) }, start));
                 break;
             }
             // Grouped into tool rows by ChatView; hasVisible above skips an empty shell.

package/dist/kernel/client-ui-conversation/lib/types/client/chat/AssistantNodeView.d.ts

@@ -1,4 +1,4 @@
 import type { ChatNodeViewProps } from '../contract/slots.ts';
 /** Streaming, settled, and interrupted Assistant states share one keyed renderer instance. */
-export declare const AssistantNodeView: import("react").MemoExoticComponent<({ node, useTurnData, openFile, loadImage, fileMentions, t, }: ChatNodeViewProps<"assistant-step">) => import("react").JSX.Element>;
+export declare const AssistantNodeView: import("react").MemoExoticComponent<({ node, useTurnData, openFile, renderMessageImages, fileMentions, t, }: ChatNodeViewProps<"assistant-step">) => import("react").JSX.Element>;
 //# sourceMappingURL=AssistantNodeView.d.ts.map

package/dist/kernel/client-ui-conversation/lib/types/client/chat/AssistantNodeView.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { memo, useMemo } from 'react';
 import { AssistantMarkdown } from "./AssistantMarkdown.js";
 /** Streaming, settled, and interrupted Assistant states share one keyed renderer instance. */
-export const AssistantNodeView = memo(function AssistantNodeView({ node, useTurnData, openFile, loadImage, fileMentions, t, }) {
+export const AssistantNodeView = memo(function AssistantNodeView({ node, useTurnData, openFile, renderMessageImages, fileMentions, t, }) {
     const data = node.data;
     const turn = node.location.kind === 'turn' || node.location.kind === 'step'
         ? node.location.turn
@@ -16,6 +16,6 @@ export const AssistantNodeView = memo(function AssistantNodeView({ node, useTurn
         return { turn, seq: data.finalNode.seq, openFile };
     }, [data.finalNode, openFile, tail, turn]);
     const mentions = useMemo(() => owner === undefined ? undefined : fileMentions(owner), [fileMentions, owner]);
-    return (_jsx(AssistantMarkdown, { blocks: data.blocks, streaming: data.status === 'running', interrupted: data.status === 'interrupted', loadImage: loadImage, mentions: mentions, t: t }));
+    return (_jsx(AssistantMarkdown, { blocks: data.blocks, streaming: data.status === 'running', interrupted: data.status === 'interrupted', renderMessageImages: renderMessageImages, mentions: mentions, t: t }));
 });
 //# sourceMappingURL=AssistantNodeView.js.map

package/dist/kernel/client-ui-conversation/lib/types/client/chat/ChatNodeSeat.d.ts

@@ -6,6 +6,6 @@ interface ChatNodeSeatProps extends ChatNodeOwnerProps {
     readonly t: ChatViewSlotProps['t'];
 }
 /** Subscribe and dispatch one stable Context key without observing sibling Nodes. */
-export declare const ChatNodeSeat: import("react").MemoExoticComponent<({ nodeKey, selectedCallId, cwd, openFile, inspectCall, forkAt, loadImage, fileMentions, useSession, renderSlot, t, }: ChatNodeSeatProps) => import("react").JSX.Element | null>;
+export declare const ChatNodeSeat: import("react").MemoExoticComponent<({ nodeKey, selectedCallId, cwd, openFile, inspectCall, forkAt, renderMessageImages, fileMentions, useSession, renderSlot, t, }: ChatNodeSeatProps) => import("react").JSX.Element | null>;
 export {};
 //# sourceMappingURL=ChatNodeSeat.d.ts.map

package/dist/kernel/client-ui-conversation/lib/types/client/chat/ChatNodeSeat.js

@@ -3,7 +3,7 @@ import { memo, useMemo } from 'react';
 import { JsonBlock } from '../../../../../client-ui-primitives/lib/index.js';
 import css from './ChatView.module.css';
 /** Subscribe and dispatch one stable Context key without observing sibling Nodes. */
-export const ChatNodeSeat = memo(function ChatNodeSeat({ nodeKey, selectedCallId, cwd, openFile, inspectCall, forkAt, loadImage, fileMentions, useSession, renderSlot, t, }) {
+export const ChatNodeSeat = memo(function ChatNodeSeat({ nodeKey, selectedCallId, cwd, openFile, inspectCall, forkAt, renderMessageImages, fileMentions, useSession, renderSlot, t, }) {
     const node = useSession(snapshot => snapshot.chat.nodes.get(nodeKey));
     const routedNode = node;
     const owner = useMemo(() => node === undefined
@@ -14,9 +14,11 @@ export const ChatNodeSeat = memo(function ChatNodeSeat({ nodeKey, selectedCallId
             openFile,
             inspectCall,
             forkAt,
-            loadImage,
+            renderMessageImages,
             fileMentions,
-        }, [node, selectedCallId, cwd, openFile, inspectCall, forkAt, loadImage, fileMentions]);
+        }, [
+        node, selectedCallId, cwd, openFile, inspectCall, forkAt, renderMessageImages, fileMentions,
+    ]);
     if (routedNode === undefined || owner === null)
         return null;
     // Runtime dispatch owns the correlation: every Node's discriminant is the

package/dist/kernel/client-ui-conversation/lib/types/client/chat/ChatView.js

@@ -1,8 +1,9 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 // ChatView: the default conversation view — one stable keyed parent list over
 // final business Nodes, plus paging, pending steering and bottom-follow.
 // Each row dispatches through 'conversation.chat.node'; ui-tool owns the
-// tool-call renderer and its recursive root/subcall composition.
+// tool-call renderer and its recursive root/subcall composition. A Host
+// open-path refusal from the injected opener is an in-page dialog here.
 //
 // Scroll: when nested under `[data-conversation-scroll]` (active conversation
 // column), that host is the scrollport and this view is flow content; when
@@ -12,8 +13,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Render economics: order changes only when rows enter, leave or move. Each
 // ChatNodeSeat subscribes to one Node key, so Assistant deltas and Tool
 // lifecycle updates replace only their own row without remounting it.
-import { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
-import { IconChevronDownOutline14 } from '../../../../../client-ui-primitives/lib/index.js';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { Button, IconChevronDownOutline14, Modal } from '../../../../../client-ui-primitives/lib/index.js';
 import { PendingSteeringBubble } from "./MessageItem.js";
 import { ChatNodeSeat } from "./ChatNodeSeat.js";
 import { formatRunDuration } from "./message-chrome.js";
@@ -80,6 +81,15 @@ function scrollPosition(list, scrollport) {
         scrollTop: scrollport.scrollTop,
     };
 }
+/** Host/OS refusal text for the file-open dialog; empty throws keep a locale fallback. */
+function openFailureMessage(error, fallback) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message === '' ? fallback : message;
+}
+/** ProducedFiles opens the session workspace as `.`. */
+function isFolderOpenPath(path) {
+    return path === '.';
+}
 function runningTurnStartTime(timeline) {
     let latest = null;
     for (const turn of timeline.turns.values()) {
@@ -125,7 +135,36 @@ export function ChatView({ useSession, useSessions, useStore, renderSlot, sessio
     const hasMore = useSession(s => s.hasMore);
     const loadingOlder = useSession(s => s.loadingOlder);
     const selectedCallId = useStore(s => s.selection?.callId);
+    const [fileOpenError, setFileOpenError] = useState(null);
+    const [fileOpenBusy, setFileOpenBusy] = useState(false);
+    // Close/retry must ignore a settlement that started before the latest
+    // gesture; otherwise a cancelled in-flight refusal reopens the dialog.
+    const fileOpenRequest = useRef(0);
+    const requestOpenFile = useCallback((path) => {
+        const id = ++fileOpenRequest.current;
+        setFileOpenBusy(true);
+        void openFile(path).then(() => {
+            if (id !== fileOpenRequest.current)
+                return;
+            setFileOpenError(null);
+            setFileOpenBusy(false);
+        }, (error) => {
+            if (id !== fileOpenRequest.current)
+                return;
+            setFileOpenError({
+                path,
+                message: openFailureMessage(error, t(isFolderOpenPath(path) ? 'fileOpen.folderUnknown' : 'fileOpen.unknown')),
+            });
+            setFileOpenBusy(false);
+        });
+    }, [openFile, t]);
+    const closeFileOpenError = useCallback(() => {
+        fileOpenRequest.current += 1;
+        setFileOpenError(null);
+        setFileOpenBusy(false);
+    }, []);
     const pendingSteering = useMemo(() => inbox.filter(item => item.placement === 'steering'), [inbox]);
+    const renderMessageImages = useCallback(owner => renderSlot('conversation.message.images', { ...owner, loadImage }), [loadImage, renderSlot]);
     const runningTurnStart = useMemo(() => runningTurnStartTime(timeline), [timeline]);
     const listRef = useRef(null);
     const columnRef = useRef(null);
@@ -329,11 +368,15 @@ export function ChatView({ useSession, useSessions, useStore, renderSlot, sessio
         }
         loadOlder();
     };
-    return (_jsx("div", { className: css.root, children: _jsxs("div", { ref: listRef, className: css.scroll, children: [_jsxs("div", { ref: columnRef, className: css.column, "data-chat-flow": "", children: [openState === 'loading' && _jsx("div", { className: css.hint, children: t('chat.loadingHistory') }), openState === 'error' && openError !== null && (_jsx("div", { className: css.openError, children: t('chat.loadError', { message: openError.message, code: openError.code }) })), hasMore && (_jsx("div", { className: css.older, children: _jsx("button", { type: "button", disabled: loadingOlder, onClick: loadOlderAnchored, children: loadingOlder ? t('loading') : t('chat.loadOlder') }) })), order.map(nodeKey => (_jsx(ChatNodeSeat, { nodeKey: nodeKey, useSession: useSession, selectedCallId: selectedCallId, cwd: cwd, openFile: openFile, inspectCall: inspectCall, forkAt: forkAt, loadImage: loadImage, fileMentions: fileMentions, renderSlot: renderSlot, t: t }, nodeKey))), running && _jsx(TurnStatus, { startTime: runningTurnStart, t: t }), pendingSteering.map(item => (_jsx(PendingSteeringBubble, { content: item.content, loadImage: loadImage, t: t }, item.id)))] }), !atBottom && (_jsx("div", { className: css.toBottomSlot, children: _jsx("button", { type: "button", className: css.toBottom, "aria-label": t('chat.toBottom'), onClick: () => {
-                            const local = listRef.current;
-                            /* v8 ignore next -- ref-null guard: the button only renders alongside the mounted list. */
-                            if (local !== null)
-                                toBottom(scrollerOf(local));
-                        }, children: _jsx(IconChevronDownOutline14, {}) }) }))] }) }));
+    return (_jsxs("div", { className: css.root, children: [_jsxs("div", { ref: listRef, className: css.scroll, children: [_jsxs("div", { ref: columnRef, className: css.column, "data-chat-flow": "", children: [openState === 'loading' && _jsx("div", { className: css.hint, children: t('chat.loadingHistory') }), openState === 'error' && openError !== null && (_jsx("div", { className: css.openError, children: t('chat.loadError', { message: openError.message, code: openError.code }) })), hasMore && (_jsx("div", { className: css.older, children: _jsx("button", { type: "button", disabled: loadingOlder, onClick: loadOlderAnchored, children: loadingOlder ? t('loading') : t('chat.loadOlder') }) })), order.map(nodeKey => (_jsx(ChatNodeSeat, { nodeKey: nodeKey, useSession: useSession, selectedCallId: selectedCallId, cwd: cwd, openFile: requestOpenFile, inspectCall: inspectCall, forkAt: forkAt, renderMessageImages: renderMessageImages, fileMentions: fileMentions, renderSlot: renderSlot, t: t }, nodeKey))), running && _jsx(TurnStatus, { startTime: runningTurnStart, t: t }), pendingSteering.map(item => (_jsx(PendingSteeringBubble, { content: item.content, renderMessageImages: renderMessageImages, t: t }, item.id)))] }), !atBottom && (_jsx("div", { className: css.toBottomSlot, children: _jsx("button", { type: "button", className: css.toBottom, "aria-label": t('chat.toBottom'), onClick: () => {
+                                const local = listRef.current;
+                                /* v8 ignore next -- ref-null guard: the button only renders alongside the mounted list. */
+                                if (local !== null)
+                                    toBottom(scrollerOf(local));
+                            }, children: _jsx(IconChevronDownOutline14, {}) }) }))] }), fileOpenError !== null && (_jsx(FileOpenErrorDialog, { path: fileOpenError.path, message: fileOpenError.message, busy: fileOpenBusy, onClose: closeFileOpenError, onRetry: () => { requestOpenFile(fileOpenError.path); }, t: t }))] }));
+}
+/** In-page Host open-path refusal: the wire reason plus a retry of the same path. */
+function FileOpenErrorDialog({ path, message, busy, onClose, onRetry, t, }) {
+    return (_jsx(Modal, { open: true, onClose: onClose, closeLabel: t('close'), title: t(isFolderOpenPath(path) ? 'fileOpen.folderTitle' : 'fileOpen.title'), description: message, footer: (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "outline", className: css.modalAction, onClick: onClose, children: t('cancel') }), _jsx(Button, { variant: "primary", className: css.modalAction, disabled: busy, onClick: onRetry, children: t('retry') })] })) }));
 }
 //# sourceMappingURL=ChatView.js.map

package/dist/kernel/client-ui-conversation/lib/types/client/chat/ContextInjectionRow.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from 'react';
 import { DisclosureRow, IconBrowseOutline16 } from '../../../../../client-ui-primitives/lib/index.js';
+import { ReferenceIcon } from "../reference/ReferenceIcon.js";
 import { contextBody } from "./ContextBody.js";
 import css from './ContextInjectionRow.module.css';
 /**
@@ -19,6 +20,8 @@ export function ContextInjectionRow({ content, source, provenance, form, t }) {
     // Resolved rather than declared: a form whose fields are unreadable renders
     // the opaque body, and the marker must say what the row actually shows.
     const { rendered, summary, body } = contextBody(form, { content, source, t });
-    return (_jsx(DisclosureRow, { className: css.root, icon: _jsx(IconBrowseOutline16, { size: 14 }), chevronClassName: css.chevron, title: t(provenance.role === 'recall' ? 'message.contextRecall' : 'message.contextInjection'), collapsedContent: provenance.label === null ? undefined : (_jsxs(_Fragment, { children: [_jsx("span", { className: css.sep, "aria-hidden": true }), _jsx("span", { className: css.source, "data-context-source": true, children: provenance.label }), summary !== null && (_jsxs(_Fragment, { children: [_jsx("span", { className: css.sep, "aria-hidden": true }), _jsx("span", { className: css.summary, "data-context-summary": true, children: summary })] }))] })), keepContentWhenOpen: true, open: open, expandable: true, expandOnRowClick: true, onToggle: () => { setOpen(value => !value); }, children: _jsx("div", { className: css.body, "data-context-injection-body": true, "data-context-form": rendered ?? undefined, children: body }) }));
+    return (_jsx(DisclosureRow, { className: css.root, icon: provenance.role === 'recall'
+            ? _jsx("span", { "data-context-recall-icon": true, children: _jsx(ReferenceIcon, { kind: "session" }) })
+            : _jsx(IconBrowseOutline16, { size: 14 }), chevronClassName: css.chevron, title: t(provenance.role === 'recall' ? 'message.contextRecall' : 'message.contextInjection'), collapsedContent: provenance.label === null ? undefined : (_jsxs(_Fragment, { children: [_jsx("span", { className: css.sep, "aria-hidden": true }), _jsx("span", { className: css.source, "data-context-source": true, children: provenance.label }), summary !== null && (_jsxs(_Fragment, { children: [_jsx("span", { className: css.sep, "aria-hidden": true }), _jsx("span", { className: css.summary, "data-context-summary": true, children: summary })] }))] })), keepContentWhenOpen: true, open: open, expandable: true, expandOnRowClick: true, onToggle: () => { setOpen(value => !value); }, children: _jsx("div", { className: css.body, "data-context-injection-body": true, "data-context-form": rendered ?? undefined, children: body }) }));
 }
 //# sourceMappingURL=ContextInjectionRow.js.map

package/dist/kernel/client-ui-conversation/lib/types/client/chat/MessageItem.d.ts

@@ -1,19 +1,18 @@
 import type { ReactNode } from 'react';
-import type { ChatNodeViewProps, ChatViewSlotProps } from '../contract/slots.ts';
-import { type ImageLoader } from '../../../../../client-ui-attachment/lib/index.js';
+import type { ChatNodeOwnerProps, ChatNodeViewProps, ChatViewSlotProps } from '../contract/slots.ts';
 /**
  * Render one Host-authoritative pending steering item with the same visual
  * language as its eventual durable transcript node.
  * @param props - Pending message content and conversation translator.
  * @returns the pending steering bubble.
  */
-export declare function PendingSteeringBubble({ content, loadImage, t }: {
+export declare function PendingSteeringBubble({ content, renderMessageImages, t }: {
     content: readonly unknown[];
-    loadImage?: ImageLoader;
+    renderMessageImages: ChatNodeOwnerProps['renderMessageImages'];
     t: ChatViewSlotProps['t'];
 }): ReactNode;
 /** User and admitted-steering keyed Chat renderer. */
-export declare const UserMessageNodeView: import("react").MemoExoticComponent<({ node, loadImage, t, }: ChatNodeViewProps<"user" | "steering">) => import("react").JSX.Element>;
+export declare const UserMessageNodeView: import("react").MemoExoticComponent<({ node, renderMessageImages, t, }: ChatNodeViewProps<"user" | "steering">) => import("react").JSX.Element>;
 /** Injected-context keyed Chat renderer. */
 export declare const ContextMessageNodeView: import("react").MemoExoticComponent<({ node, t }: ChatNodeViewProps<"context">) => import("react").JSX.Element>;
 /** Automatic compaction keyed Chat renderer. */

package/dist/kernel/client-ui-conversation/lib/types/client/chat/MessageItem.js

@@ -5,8 +5,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 // compaction marker, retry disclosure, and unknown-surface JSON rows.
 import { memo, useEffect, useMemo, useState } from 'react';
 import { JsonBlock, MessageText, StateDot } from '../../../../../client-ui-primitives/lib/index.js';
-import { ImageGallery } from '../../../../../client-ui-attachment/lib/index.js';
-import { messageImageLabels } from "../image-labels.js";
+import { ReferenceIcon } from "../reference/ReferenceIcon.js";
 import { CompactionItem } from "./CompactionItem.js";
 import { ContextInjectionRow } from "./ContextInjectionRow.js";
 import { MessageIconActions } from "./MessageIconActions.js";
@@ -88,18 +87,50 @@ function TurnMaxTokensItem({ t }) {
  * scan as the composer, minus the lexicon: sent tokens were validated at
  * compose time, so shape alone decorates).
  */
-function projectUserText(text) {
-    const re = /(^|\s)([/@][\w-]+)(?=\s|$)/g;
-    const parts = [];
-    let cursor = 0;
+function projectUserText(text, sessionLabels) {
+    const ranges = [];
+    for (const rawLabel of [...new Set(sessionLabels)].sort((a, b) => b.length - a.length)) {
+        const label = `@${rawLabel}`;
+        let start = text.indexOf(label);
+        while (start >= 0) {
+            ranges.push({ start, end: start + label.length, label, kind: 'session' });
+            start = text.indexOf(label, start + label.length);
+        }
+    }
+    const re = /(^|\s)(\/[\w-]+|@"[^"\n]+"|@[^\s]+)/gu;
     let m;
     while ((m = re.exec(text)) !== null) {
         const tokenStart = m.index + (m[1]?.length ?? 0);
-        const label = m[2] ?? '';
+        const rawLabel = m[2] ?? '';
+        const label = rawLabel.startsWith('@"')
+            ? rawLabel
+            : rawLabel.replace(/[.,;:!?，。；：！？]+$/gu, '');
+        if (label.length <= 1)
+            continue;
+        ranges.push({ start: tokenStart, end: tokenStart + label.length, label, kind: 'plain' });
+    }
+    ranges.sort((a, b) => a.start - b.start
+        || (a.kind === b.kind ? b.end - a.end : a.kind === 'session' ? -1 : 1));
+    const parts = [];
+    let cursor = 0;
+    for (const range of ranges) {
+        if (range.start < cursor)
+            continue;
+        const { start: tokenStart, end, label, kind } = range;
         if (tokenStart > cursor)
             parts.push(_jsx(MessageText, { text: text.slice(cursor, tokenStart) }, cursor));
-        parts.push(_jsx("span", { className: css.refChip, "data-ref-chip": label.startsWith('@') ? 'subagent' : 'skill', children: label }, tokenStart));
-        cursor = tokenStart + label.length;
+        const referenceKind = kind === 'session'
+            ? 'session'
+            : label.startsWith('@')
+                ? label.endsWith('/') ? 'folder' : 'file'
+                : undefined;
+        const displayLabel = referenceKind === undefined
+            ? label
+            : referenceKind === 'session'
+                ? label.slice(1)
+                : label.slice(1).replace(/^"|"$/gu, '').split(/[\\/]/u).filter(Boolean).at(-1) ?? label.slice(1);
+        parts.push(_jsxs("span", { className: css.refChip, "data-ref-chip": referenceKind ?? 'skill', title: label, children: [referenceKind !== undefined && (_jsx(ReferenceIcon, { kind: referenceKind, size: 16, className: css.refIcon })), displayLabel] }, tokenStart));
+        cursor = end;
     }
     if (parts.length === 0)
         return _jsx(MessageText, { text: text });
@@ -108,11 +139,11 @@ function projectUserText(text) {
     return _jsx(_Fragment, { children: parts });
 }
 /** Right-aligned bubble shared by user and steering rows. */
-function UserStyleBubble({ content, imageLoader, actions, pending = false, t, }) {
+function UserStyleBubble({ content, renderMessageImages, actions, pending = false, referenceLabels = [], t, }) {
     const { text, images, rest } = contentParts(content);
     const truncated = (total) => t('json.truncated', { total });
     const showBubble = text !== '' || rest.length > 0;
-    return (_jsxs("div", { className: css.userRow, "data-pending-steering": pending || undefined, "data-time-hover-root": true, children: [_jsxs("div", { className: css.userStack, children: [_jsx(ImageGallery, { images: images, load: imageLoader, align: "end", labels: messageImageLabels(t) }), showBubble && _jsxs("div", { className: css.bubble, children: [projectUserText(text), rest.map((block, i) => _jsx(JsonBlock, { label: t('message.extraBlock'), payload: block, truncatedLabel: truncated }, i))] })] }), actions?.(text)] }));
+    return (_jsxs("div", { className: css.userRow, "data-pending-steering": pending || undefined, "data-time-hover-root": true, children: [_jsxs("div", { className: css.userStack, children: [renderMessageImages({ images, align: 'end' }), showBubble && _jsxs("div", { className: css.bubble, children: [projectUserText(text, referenceLabels), rest.map((block, i) => _jsx(JsonBlock, { label: t('message.extraBlock'), payload: block, truncatedLabel: truncated }, i))] }), referenceLabels.length > 0 && (_jsx("div", { className: css.referenceSummary, children: t('message.referenceSummary', { labels: referenceLabels.join(t('message.referenceSeparator')) }) }))] }), actions?.(text)] }));
 }
 /**
  * Render one Host-authoritative pending steering item with the same visual
@@ -120,14 +151,13 @@ function UserStyleBubble({ content, imageLoader, actions, pending = false, t, })
  * @param props - Pending message content and conversation translator.
  * @returns the pending steering bubble.
  */
-export function PendingSteeringBubble({ content, loadImage, t }) {
-    const imageLoader = loadImage ?? (() => Promise.reject(new Error(t('image.serviceUnavailable'))));
-    return (_jsx(UserStyleBubble, { content: content, imageLoader: imageLoader, pending: true, t: t, actions: text => (_jsx(MessageIconActions, { text: text, clock: "start", className: css.actions, t: t })) }));
+export function PendingSteeringBubble({ content, renderMessageImages, t }) {
+    return (_jsx(UserStyleBubble, { content: content, renderMessageImages: renderMessageImages, pending: true, t: t, actions: text => (_jsx(MessageIconActions, { text: text, clock: "start", className: css.actions, t: t })) }));
 }
 /** User and admitted-steering keyed Chat renderer. */
-export const UserMessageNodeView = memo(function UserMessageNodeView({ node, loadImage, t, }) {
+export const UserMessageNodeView = memo(function UserMessageNodeView({ node, renderMessageImages, t, }) {
     const data = node.data;
-    return (_jsx(UserStyleBubble, { content: data.content, imageLoader: loadImage, t: t, actions: text => (_jsx(MessageIconActions, { text: text, time: data.time, clock: "start", className: css.actions, t: t })) }));
+    return (_jsx(UserStyleBubble, { content: data.content, renderMessageImages: renderMessageImages, ...data.referenceLabels === undefined ? {} : { referenceLabels: data.referenceLabels }, t: t, actions: text => (_jsx(MessageIconActions, { text: text, time: data.time, clock: "start", className: css.actions, t: t })) }));
 });
 /** Injected-context keyed Chat renderer. */
 export const ContextMessageNodeView = memo(function ContextMessageNodeView({ node, t }) {

package/dist/kernel/client-ui-conversation/lib/types/client/chat/StatsLine.d.ts

@@ -44,11 +44,13 @@ export declare function formatTokens(n: number): string;
  */
 export declare function formatDuration(ms: number): string;
 /**
- * Cache-hit share of prompt-side input over the whole durable log.
+ * Display-ready cache-hit share of prompt-side input over the whole durable log.
  * @param usage - the session's token-usage projection value.
- * @returns rounded integer percent, or null when no input was billed.
+ * @returns integer text when integer rounding stays below 100, otherwise the
+ * minimum decimal precision that still rounds below 100; a full hit returns
+ * 100, and no billed input returns null.
  */
-export declare function cacheHitPercent(usage: TokenUsageProjection): number | null;
+export declare function cacheHitPercent(usage: TokenUsageProjection): string | null;
 /**
  * Sum the three disjoint prompt-side billing buckets.
  * @param usage - the session's token-usage projection value.

package/dist/kernel/client-ui-conversation/lib/types/client/chat/StatsLine.js

@@ -78,16 +78,65 @@ export function formatDuration(ms) {
     const whole = Math.round(s);
     return `${Math.floor(whole / 60)}m${whole % 60}s`;
 }
+/** Round a cache-read ratio to an integer percentage, with positive ties rounded up. */
+function roundedIntegerPercent(cacheReadTokens, denominator) {
+    const denominatorQuotient = Math.floor(denominator / 200);
+    const denominatorRemainder = denominator % 200;
+    let lower = 0;
+    let upper = 100;
+    while (lower < upper) {
+        const candidate = Math.floor((lower + upper + 1) / 2);
+        const factor = candidate * 2 - 1;
+        const threshold = factor * denominatorQuotient
+            + Math.ceil(factor * denominatorRemainder / 200);
+        if (cacheReadTokens >= threshold) {
+            lower = candidate;
+        }
+        else {
+            upper = candidate - 1;
+        }
+    }
+    return lower;
+}
 /**
- * Cache-hit share of prompt-side input over the whole durable log.
+ * Display-ready cache-hit share of prompt-side input over the whole durable log.
  * @param usage - the session's token-usage projection value.
- * @returns rounded integer percent, or null when no input was billed.
+ * @returns integer text when integer rounding stays below 100, otherwise the
+ * minimum decimal precision that still rounds below 100; a full hit returns
+ * 100, and no billed input returns null.
  */
 export function cacheHitPercent(usage) {
     const denominator = billedInputTokens(usage);
-    return denominator === 0
-        ? null
-        : Math.round(usage.cacheReadTokens / denominator * 100);
+    if (denominator === 0)
+        return null;
+    const missedInputTokens = usage.uncachedInputTokens + usage.cacheWriteTokens;
+    if (missedInputTokens === 0)
+        return '100';
+    const integerPercent = roundedIntegerPercent(usage.cacheReadTokens, denominator);
+    if (integerPercent < 100)
+        return String(integerPercent);
+    // At the first distinguishing precision, the rounded result is 100 minus
+    // one to five units in the final decimal place. Scale only while the next
+    // multiplication remains at or below the denominator, then derive that
+    // final digit through exact small-factor comparisons.
+    let decimalPlaces = 1;
+    let scaledDoubleGap = missedInputTokens * 200;
+    const denominatorTens = Math.floor(denominator / 10);
+    while (scaledDoubleGap <= denominatorTens) {
+        scaledDoubleGap *= 10;
+        decimalPlaces += 1;
+    }
+    const denominatorOnes = denominator % 10;
+    let roundedLoss = 5;
+    for (let loss = 1; loss < 5; loss += 1) {
+        const factor = loss * 2 + 1;
+        const threshold = factor * denominatorTens + Math.floor(factor * denominatorOnes / 10);
+        if (scaledDoubleGap <= threshold) {
+            roundedLoss = loss;
+            break;
+        }
+    }
+    return `99.${'9'.repeat(decimalPlaces - 1)}${10 - roundedLoss}`;
 }
 /**
  * Sum the three disjoint prompt-side billing buckets.

package/dist/kernel/client-ui-conversation/lib/types/client/chat/register-node-renderers.d.ts

@@ -1,4 +1,4 @@
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../../../cordis/lib/index.js';
 /**
  * Register this package's business renderers behind the keyed Chat Node seat.
  * @param ctx - owning UI Conversation context.