@nomix-ai/nomix-harness 0.2.4 → 0.2.6

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

@@ -1,5 +1,15 @@
-/** The object-replacement character backing every chip occurrence in the draft. */
+/** Legacy fixed-width object replacement character rejected from pasted text. */
 export const PLACEHOLDER = '';
+const REFERENCE_PLACEHOLDER_RE = /[\uE100-\uE11D\uFFFC]/gu;
+/**
+ * Build the inline draft text whose leading marker is decorated as the
+ * reference icon in the backdrop.
+ * @param reference - reference insertion with its cached display projection.
+ * @returns display text with one marker glyph followed by the complete label.
+ */
+export function referenceDraftText(reference) {
+    return `@${reference.label}`;
+}
 /** The machine never writes the queue; the wiring layer overlays the queue store's projection. */
 const EMPTY_QUEUE = [];
 /** Undo ring depth (bounded self-managed transaction log). */
@@ -42,10 +52,9 @@ function diffEdit(prev, next) {
     return { start: p, end: prev.length - s, insertedLength: next.length - s - p };
 }
 /**
- * Expand the draft's placeholders into their occurrences' clipboard text
- * (the persistence mirror and clipboard both write this
- * projection — U+FFFC never leaves the machine). Table order is offset
- * order, so one linear walk pairs placeholders with entries.
+ * Expand the draft's reference ranges into their occurrences' clipboard text
+ * for persistence and clipboard projection. Table order is offset order, so
+ * one linear walk pairs ranges with entries.
  * @param state - published input state.
  * @returns the plain-text projection of the draft.
  */
@@ -57,7 +66,7 @@ export function projectClipboard(state) {
     let cursor = 0;
     for (const o of occurrences) {
         out += draft.slice(cursor, o.offset) + o.clipboardText;
-        cursor = o.offset + 1;
+        cursor = o.offset + o.length;
     }
     return out + draft.slice(cursor);
 }
@@ -98,7 +107,15 @@ export class InputMachine {
             imageIds: [],
             draftRev: this.draftRev,
             phase: this.phase,
-            ...(c ? { claim: { token: c.token, ...(c.hint !== undefined ? { hint: c.hint } : {}) } } : {}),
+            ...(c
+                ? {
+                    claim: {
+                        token: c.token,
+                        ...(c.hint !== undefined ? { hint: c.hint } : {}),
+                        ...(c.images === true ? { images: true } : {}),
+                    },
+                }
+                : {}),
             occurrences: this.occurrences,
             ...(this.paste !== undefined ? { paste: this.paste } : {}),
             queue: EMPTY_QUEUE,
@@ -152,15 +169,15 @@ export class InputMachine {
     }
     /**
      * Reconcile the occurrence table with one edit (old-draft coordinates):
-     * entries past the range shift by the length delta; entries whose
-     * placeholder sits inside the replaced range go away whole (a
-     * deletion/replacement intersecting a placeholder acts on the whole chip).
+     * entries past the range shift by the length delta; an edit that intersects
+     * a reference range removes its structured occurrence and leaves the edited
+     * characters as ordinary draft text.
      */
     reconcile(range) {
         const delta = range.insertedLength - (range.end - range.start);
         const kept = [];
         for (const o of this.occurrences) {
-            if (o.offset < range.start)
+            if (o.offset + o.length <= range.start)
                 kept.push(o);
             else if (o.offset >= range.end)
                 kept.push(delta === 0 ? o : { ...o, offset: o.offset + delta });
@@ -175,14 +192,16 @@ export class InputMachine {
         }
     }
     /** Mint one occurrence at a draft offset. */
-    mint(reference, offset) {
+    mint(reference, offset, length) {
         this.occurrenceSeq += 1;
         return {
             occurrenceId: this.occurrenceSeq,
             source: reference.source,
             ref: reference.ref,
             offset,
+            length,
             label: reference.label,
+            ...reference.appearance === undefined ? {} : { appearance: reference.appearance },
             clipboardText: reference.clipboardText,
         };
     }
@@ -243,19 +262,20 @@ export class InputMachine {
         return [];
     }
     /**
-     * Shared chip-insertion transaction: replace [span) with one placeholder
+     * Shared reference-insertion transaction: replace [span) with one inline
      * occurrence (insert-ref and paste-upgrade both land here). A separating
-     * space follows the chip unless one is already next.
-     * @returns the inserted length (placeholder plus optional gap).
+     * space follows the reference unless one is already next.
+     * @returns the inserted length (display text plus optional gap).
      */
     replaceSpanWithChip(reference, span) {
         this.pushTxn();
         this.typingRun = undefined;
         const tail = this.draft.slice(span.end);
         const gap = tail.length === 0 || tail[0] !== ' ' ? ' ' : '';
-        const inserted = PLACEHOLDER + gap;
+        const displayText = referenceDraftText(reference);
+        const inserted = displayText + gap;
         this.reconcile({ start: span.start, end: span.end, insertedLength: inserted.length });
-        this.withMinted([this.mint(reference, span.start)]);
+        this.withMinted([this.mint(reference, span.start, displayText.length)]);
         this.adopt(this.draft.slice(0, span.start) + inserted + tail);
         this.watchClaim();
         return inserted.length;
@@ -343,7 +363,7 @@ export class InputMachine {
     }
     // ---- paste plane ----
     /**
-     * Paste as one transaction: the text (U+FFFC-sanitized) replaces the
+     * Paste as one transaction: the text (reference-placeholder-sanitized) replaces the
      * selection; hot-snapshot sync matches componentize inside the SAME
      * transaction (one undo returns to pre-paste); a match attempt opens for
      * the async remainder while the phase still accepts reference mutations.
@@ -352,19 +372,20 @@ export class InputMachine {
         const { start, end } = selection;
         if (start < 0 || start > end || end > this.draft.length)
             return [];
-        const text = rawText.split(PLACEHOLDER).join('');
+        const text = rawText.replace(REFERENCE_PLACEHOLDER_RE, '');
         this.pushTxn(selection);
         this.typingRun = undefined;
         // Componentize: replace each matched token range (paste-text coordinates,
-        // disjoint by contract) with a placeholder while assembling the insert.
+        // disjoint by contract) with inline display text while assembling the insert.
         const sorted = [...components].sort((a, b) => a.start - b.start);
         const minted = [];
         let inserted = '';
         let cursor = 0;
         for (const c of sorted) {
             inserted += text.slice(cursor, c.start);
-            minted.push(this.mint(c.reference, start + inserted.length));
-            inserted += PLACEHOLDER;
+            const displayText = referenceDraftText(c.reference);
+            minted.push(this.mint(c.reference, start + inserted.length, displayText.length));
+            inserted += displayText;
             cursor = c.end;
         }
         inserted += text.slice(cursor);
@@ -432,7 +453,9 @@ export class InputMachine {
             this.phase = 'adjudicating';
             return [{ type: 'adjudicate', attempt, draft: this.draft }];
         }
-        return [{ type: 'default-sink', draft: this.draft, mode }];
+        const attempt = this.beginAttempt(mode);
+        this.phase = 'submitting';
+        return [{ type: 'default-sink', attempt, draft: this.draft, mode }];
     }
     onAdjudicated(attempt, outcome) {
         const flight = this.inflight;
@@ -450,11 +473,18 @@ export class InputMachine {
         }
         // 'handled' (source dealt internally), {insert} (no enter-time span
         // semantics), or a miss: all land plain; only the miss flows to the sink.
+        if (outcome === undefined) {
+            this.phase = 'submitting';
+            return [{
+                    type: 'default-sink',
+                    attempt,
+                    draft: attempt.draftSnapshot,
+                    mode: attempt.mode,
+                }];
+        }
         this.inflight = undefined;
         this.phase = 'plain';
-        return outcome === undefined
-            ? [{ type: 'default-sink', draft: attempt.draftSnapshot, mode: attempt.mode }]
-            : [];
+        return [];
     }
     onAdjudicationFailed(attempt, message) {
         if (this.phase !== 'adjudicating' || this.inflight?.attempt.seq !== attempt.seq)
@@ -473,7 +503,13 @@ export class InputMachine {
             this.phase = 'plain';
             this.claim = undefined;
             this.occurrences = [];
-            this.adopt('');
+            // Text appended after the sent snapshot during the Host round-trip
+            // survives the commit; edits interleaved with committed content cannot
+            // be separated from it, so only a pure suffix is retained.
+            const snapshot = flight.attempt.draftSnapshot;
+            this.adopt(this.draft !== snapshot && this.draft.startsWith(snapshot)
+                ? this.draft.slice(snapshot.length)
+                : '');
             // Committed content is gone for good: undo must not resurrect a sent draft.
             this.log = [];
             this.redoStack = [];
@@ -483,23 +519,24 @@ export class InputMachine {
                 ? [{ type: 'notice', level: ev.outcome.kind === 'error' ? 'error' : 'info', text: ev.outcome.text }]
                 : [];
         }
-        const text = ev.message ?? ev.outcome?.text ?? 'command failed';
-        // Drift guard: keep the enter-time draft (same claim) only while the
-        // live draft still equals it; user input typed during flight wins.
+        const text = ev.message ?? ev.outcome?.text;
+        // Keep the same command claim only while the live draft still equals the
+        // enter-time draft; user input typed during flight wins.
         // Claimed re-entry additionally requires the watch to hold — an
         // enter-path snapshot may carry leading whitespace the token never had.
         if (this.draft === flight.attempt.draftSnapshot
             && this.claim !== undefined && this.draft.startsWith(this.claim.token)) {
             this.phase = 'claimed';
-            return [{ type: 'notice', level: 'error', text }];
+            return text === undefined ? [] : [{ type: 'notice', level: 'error', text }];
         }
         this.phase = 'plain';
         this.claim = undefined;
-        return [{ type: 'notice', level: 'error', text }];
+        return text === undefined ? [] : [{ type: 'notice', level: 'error', text }];
     }
-    /** Ordinary send accepted: clear as a commit (no undo unit; sent content
-     *  must not be resurrectable — same discipline as submit-settled success). */
+    /** Cut undo state after an accepted image-only send. */
     onSendCommitted() {
+        if (this.phase !== 'plain')
+            return [];
         this.claim = undefined;
         this.occurrences = [];
         this.adopt('');

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

@@ -39,6 +39,7 @@ export declare const zh: {
     'image.fileTooLarge': string;
     'image.totalTooLarge': string;
     'image.tooManyPixels': string;
+    'image.dimensionTooLarge': string;
     'image.modelUnsupported': string;
     'image.subagentUnsupported': string;
     'image.sendFailed': string;
@@ -84,9 +85,15 @@ export declare const zh: {
     'chat.loadError': string;
     'chat.loadOlder': string;
     'chat.toBottom': string;
+    'fileOpen.title': string;
+    'fileOpen.unknown': string;
+    'fileOpen.folderTitle': string;
+    'fileOpen.folderUnknown': string;
     'message.extraBlock': string;
     'message.contextInjection': string;
     'message.contextRecall': string;
+    'message.referenceSummary': string;
+    'message.referenceSeparator': string;
     'message.context.instructions.loaded': string;
     'message.context.instructions.added': string;
     'message.context.instructions.updated': string;
@@ -126,6 +133,7 @@ export declare const zh: {
     'command.failed': string;
     'command.done': string;
     'command.title': string;
+    'command.imagesUnsupported': string;
     'approval.waiting': string;
     'approval.detail.aria': string;
     'approval.escalation': string;
@@ -206,6 +214,7 @@ export declare const en: {
     'image.fileTooLarge': string;
     'image.totalTooLarge': string;
     'image.tooManyPixels': string;
+    'image.dimensionTooLarge': string;
     'image.modelUnsupported': string;
     'image.subagentUnsupported': string;
     'image.sendFailed': string;
@@ -251,9 +260,15 @@ export declare const en: {
     'chat.loadError': string;
     'chat.loadOlder': string;
     'chat.toBottom': string;
+    'fileOpen.title': string;
+    'fileOpen.unknown': string;
+    'fileOpen.folderTitle': string;
+    'fileOpen.folderUnknown': string;
     'message.extraBlock': string;
     'message.contextInjection': string;
     'message.contextRecall': string;
+    'message.referenceSummary': string;
+    'message.referenceSeparator': string;
     'message.context.instructions.loaded': string;
     'message.context.instructions.added': string;
     'message.context.instructions.updated': string;
@@ -293,6 +308,7 @@ export declare const en: {
     'command.failed': string;
     'command.done': string;
     'command.title': string;
+    'command.imagesUnsupported': string;
     'approval.waiting': string;
     'approval.detail.aria': string;
     'approval.escalation': string;

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

@@ -43,6 +43,7 @@ export const zh = {
     'image.fileTooLarge': '单张图片不能超过 {size}',
     'image.totalTooLarge': '图片总大小超过 {size}，请移除部分图片',
     'image.tooManyPixels': '图片分辨率过大，请压缩后重试',
+    'image.dimensionTooLarge': '图片宽高不能超过 {size}px，请缩小后重试',
     'image.modelUnsupported': '当前模型不支持图片，请切换支持图片的模型',
     'image.subagentUnsupported': '子智能体会话暂不支持图片',
     'image.sendFailed': '图片发送失败（{reason}），请重新添加图片后再试',
@@ -88,9 +89,15 @@ export const zh = {
     'chat.loadError': '历史加载失败：{message}（{code}）',
     'chat.loadOlder': '加载更早',
     'chat.toBottom': '回到底部',
+    'fileOpen.title': '无法打开文件',
+    'fileOpen.unknown': '无法打开此文件',
+    'fileOpen.folderTitle': '无法打开文件夹',
+    'fileOpen.folderUnknown': '无法打开此文件夹',
     'message.extraBlock': '附加内容块',
     'message.contextInjection': '上下文注入',
     'message.contextRecall': '跨会话召回',
+    'message.referenceSummary': '引用会话 · {labels}',
+    'message.referenceSeparator': '、',
     'message.context.instructions.loaded': '已载入',
     'message.context.instructions.added': '已新增',
     'message.context.instructions.updated': '已更新',
@@ -130,6 +137,7 @@ export const zh = {
     'command.failed': '命令失败',
     'command.done': '已完成',
     'command.title': '命令',
+    'command.imagesUnsupported': '/{command} 不接受图片附件，请先移除图片',
     'approval.waiting': '等待审批',
     'approval.detail.aria': '审批详情',
     'approval.escalation': '工具 {toolName} 请求越权执行',
@@ -208,6 +216,7 @@ export const en = {
     'image.fileTooLarge': 'Each image must be smaller than {size}',
     'image.totalTooLarge': 'Images exceed {size} in total; remove some and try again',
     'image.tooManyPixels': 'Image resolution is too high; compress it and try again',
+    'image.dimensionTooLarge': 'Image sides must be at most {size}px; downscale it and try again',
     'image.modelUnsupported': 'The current model does not support images; switch to a model that does',
     'image.subagentUnsupported': 'Subagent sessions do not support images yet',
     'image.sendFailed': 'Sending images failed ({reason}); re-add them and try again',
@@ -253,9 +262,15 @@ export const en = {
     'chat.loadError': 'Failed to load history: {message} ({code})',
     'chat.loadOlder': 'Load earlier',
     'chat.toBottom': 'Back to bottom',
+    'fileOpen.title': 'Couldn’t open file',
+    'fileOpen.unknown': 'Couldn’t open this file',
+    'fileOpen.folderTitle': 'Couldn’t open folder',
+    'fileOpen.folderUnknown': 'Couldn’t open this folder',
     'message.extraBlock': 'Extra content block',
     'message.contextInjection': 'Context injection',
     'message.contextRecall': 'Session recall',
+    'message.referenceSummary': 'Referenced session · {labels}',
+    'message.referenceSeparator': ', ',
     'message.context.instructions.loaded': 'loaded',
     'message.context.instructions.added': 'added',
     'message.context.instructions.updated': 'updated',
@@ -295,6 +310,7 @@ export const en = {
     'command.failed': 'Command failed',
     'command.done': 'Completed',
     'command.title': 'Command',
+    'command.imagesUnsupported': '/{command} does not accept image attachments; remove them first',
     'approval.waiting': 'Waiting for approval',
     'approval.detail.aria': 'Approval details',
     'approval.escalation': 'Tool {toolName} requests privileged execution',

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

@@ -1,4 +1,4 @@
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../../../cordis/lib/index.js';
 import type { PropsLocale, PropsRuntime } from '../../../../../client-ui-slots/lib/index.js';
 import type { QueueAction, QueueItemId } from '../contract/queue.ts';
 /** Queue operations injected by the session-scoped registration. */

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

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+/** Reference domains with distinct composer and transcript glyphs. */
+export type ReferenceIconKind = 'session' | 'file' | 'folder';
+/** Props shared by inline reference glyphs. */
+export interface ReferenceIconProps {
+    kind: ReferenceIconKind;
+    size?: number;
+    className?: string | undefined;
+}
+/**
+ * Render the icon that identifies one inline reference domain.
+ * @param props - Reference kind, optional size, and optional CSS class.
+ * @returns The corresponding current-color SVG glyph.
+ */
+export declare function ReferenceIcon({ kind, size, className }: ReferenceIconProps): ReactNode;
+//# sourceMappingURL=ReferenceIcon.d.ts.map

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

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { IconBrowseOutline16, IconFolderClose16, } from '../../../../../client-ui-primitives/lib/index.js';
+/**
+ * Render the icon that identifies one inline reference domain.
+ * @param props - Reference kind, optional size, and optional CSS class.
+ * @returns The corresponding current-color SVG glyph.
+ */
+export function ReferenceIcon({ kind, size = 16, className }) {
+    switch (kind) {
+        case 'session':
+            return (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", "aria-hidden": true, children: _jsx("path", { d: "M8 0.597656C3.91296 0.597656 0.599716 3.91103 0.599609 7.99805C0.599609 9.13171 0.854567 10.2079 1.31152 11.1699L1.59277 11.7607L2.77441 11.1992L2.49414 10.6084L2.36035 10.3076C2.06865 9.59612 1.90723 8.81645 1.90723 7.99805C1.90733 4.63362 4.63554 1.90625 8 1.90625C11.3644 1.90635 14.0917 4.63368 14.0918 7.99805C14.0918 11.3625 11.3644 14.0907 8 14.0908C7.311 14.0908 6.80642 14.0414 6.35938 13.918C5.919 13.7963 5.50105 13.5929 5.00098 13.2441C4.26805 12.7329 3.21756 12.5526 2.35156 13.0996L2.33789 13.1084L2.32422 13.1182L1.74805 13.5234L2.18164 14.8184L3.05957 14.2002C3.37505 14.0068 3.84248 14.0319 4.25195 14.3174C4.84447 14.7307 5.39718 15.009 6.01172 15.1787C6.61963 15.3465 7.25579 15.3984 8 15.3984C12.087 15.3983 15.4004 12.0851 15.4004 7.99805C15.4003 3.9111 12.087 0.59776 8 0.597656ZM4.56836 8.50977V9.80371H8.12402V8.50977H4.56836ZM4.56836 7.30078H11.4619V6.00684H4.56836V7.30078Z", fill: "currentColor" }) }));
+        case 'file': return _jsx(IconBrowseOutline16, { size: size, className: className });
+        case 'folder': return _jsx(IconFolderClose16, { size: size, className: className });
+    }
+}
+//# sourceMappingURL=ReferenceIcon.js.map

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

@@ -7,9 +7,10 @@
  * through one property read; assignment through the tracker proxy and `#`
  * private fields bypass that rebinding.
  */
-import { Service } from '@nomix-ai/cordis';
-import type { Context } from '@nomix-ai/cordis';
+import { Service } from '../../../../cordis/lib/index.js';
+import type { Context } from '../../../../cordis/lib/index.js';
 import type { SessionFace, SessionId } from '../../../../client-runtime/lib/client.js';
+import type { SubmitImageAttachment, SubmitOutcome } from '../../../../client-ui-input-trigger/lib/client.js';
 import type { ImageAttachmentRef } from '../../../../attachment/lib/index.js';
 import type { ComposerAttachment } from './contract/slots.ts';
 import type { QueueAction, QueueItemId } from './contract/queue.ts';
@@ -95,8 +96,10 @@ export declare class ConversationController extends Service implements IConversa
      * @param text - serialized prompt text.
      * @param imageIds - ordered draft-local attachment ids.
      * @param mode - queue or steer delivery selected by composer policy.
+     * @param signal - optional cancellation for the complete Host admission.
+     * @returns the Host admission outcome; local attachment preparation failures reject.
      */
-    sendSession(session: SessionFace, text: string, imageIds: readonly DraftAttachmentId[], mode: InputSubmitMode): Promise<void>;
+    sendSession(session: SessionFace, text: string, imageIds: readonly DraftAttachmentId[], mode: InputSubmitMode, signal?: AbortSignal): Promise<SubmitOutcome>;
     /**
      * Create runtime-only draft images and their object URLs.
      * @param files - browser files to register after MIME validation.
@@ -109,6 +112,14 @@ export declare class ConversationController extends Service implements IConversa
      * @returns descriptors that remain live, in requested order.
      */
     draftImages(ids: readonly DraftAttachmentId[]): readonly ComposerAttachment[];
+    /**
+     * Serialize ordered draft images to command-submit wire payloads without
+     * sending or releasing them (the composer releases only after the command
+     * settles successfully).
+     * @param imageIds - ordered draft-local attachment ids.
+     * @returns base64 payloads in id order.
+     */
+    serializeDraftImages(imageIds: readonly DraftAttachmentId[]): Promise<readonly SubmitImageAttachment[]>;
     /**
      * Release one browser-owned draft image and preview URL.
      * @param id - draft attachment id.
@@ -144,5 +155,7 @@ export declare class ConversationController extends Service implements IConversa
     private requireSessions;
     /** Convert browser files to canonical base64 prompt parts. */
     private serializeImages;
+    /** Canonical base64 wire form of one browser image file. */
+    private encodeImage;
 }
 //# sourceMappingURL=service.d.ts.map

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

@@ -7,7 +7,7 @@
  * through one property read; assignment through the tracker proxy and `#`
  * private fields bypass that rebinding.
  */
-import { Service } from '@nomix-ai/cordis';
+import { Service } from '../../../../cordis/lib/index.js';
 /** Create one browser-only draft descriptor; only its id enters input state. */
 function browserDraftAttachment(file) {
     return {
@@ -78,18 +78,21 @@ export class ConversationController extends Service {
      * @param text - serialized prompt text.
      * @param imageIds - ordered draft-local attachment ids.
      * @param mode - queue or steer delivery selected by composer policy.
+     * @param signal - optional cancellation for the complete Host admission.
+     * @returns the Host admission outcome; local attachment preparation failures reject.
      */
-    async sendSession(session, text, imageIds, mode) {
+    async sendSession(session, text, imageIds, mode, signal) {
         const attachments = this.draftImages(imageIds);
         if (attachments.length !== imageIds.length) {
             throw new Error('conversation.sendSession: one or more draft images are no longer available');
         }
         const uploaded = await this.serializeImages(attachments.map(attachment => attachment.file));
         const content = [...uploaded, ...(text === '' ? [] : [{ type: 'text', text }])];
-        const result = await session.prompt(content, mode);
+        const result = await session.prompt(content, mode, signal);
         if (!result.ok)
-            throw new Error(`conversation.send failed: ${result.error.code}: ${result.error.message}`);
+            return { kind: 'error' };
         this.releaseDraftImages(attachments);
+        return { kind: 'success' };
     }
     /**
      * Create runtime-only draft images and their object URLs.
@@ -120,6 +123,20 @@ export class ConversationController extends Service {
         }
         return attachments;
     }
+    /**
+     * Serialize ordered draft images to command-submit wire payloads without
+     * sending or releasing them (the composer releases only after the command
+     * settles successfully).
+     * @param imageIds - ordered draft-local attachment ids.
+     * @returns base64 payloads in id order.
+     */
+    async serializeDraftImages(imageIds) {
+        const attachments = this.draftImages(imageIds);
+        if (attachments.length !== imageIds.length) {
+            throw new Error('conversation.serializeDraftImages: one or more draft images are no longer available');
+        }
+        return Promise.all(attachments.map(attachment => this.encodeImage(attachment.file)));
+    }
     /**
      * Release one browser-owned draft image and preview URL.
      * @param id - draft attachment id.
@@ -250,12 +267,15 @@ export class ConversationController extends Service {
     }
     /** Convert browser files to canonical base64 prompt parts. */
     serializeImages(images) {
-        return Promise.all(images.map(async (file) => ({
-            type: 'image',
+        return Promise.all(images.map(async (file) => ({ type: 'image', ...await this.encodeImage(file) })));
+    }
+    /** Canonical base64 wire form of one browser image file. */
+    async encodeImage(file) {
+        return {
             mediaType: imageMediaType(file.type),
             data: bytesToBase64(new Uint8Array(await file.arrayBuffer())),
             ...(file.name === '' ? {} : { name: file.name }),
-        })));
+        };
     }
 }
 function imageMediaType(value) {

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

@@ -125,7 +125,7 @@ export function ConversationRoot({ sessionId, useSession, useSessions, useWorksp
         // share one constraint (composer.dock = stats-line family).
         footer: !hero && zone !== undefined ? renderSlot('conversation.composer.dock', zone) : null,
     });
-    const composerBar = (_jsxs("div", { className: clsx(css.composerStack, hero && css.composerHero), children: [hero && _jsx(HeroGlow, { className: css.heroGlow }), hero && _jsx(HeroShell, { t: t }), hero && heroWorkspaceRow, zone !== undefined && renderSlot('conversation.input.dock', zone), inputBar] }));
+    const composerBar = (_jsxs("div", { className: clsx(css.composerStack, hero && css.composerHero), children: [hero && _jsx(HeroGlow, { className: css.heroGlow }), hero && _jsx(HeroShell, { t: t, renderSlot: renderSlot }), hero && heroWorkspaceRow, zone !== undefined && renderSlot('conversation.input.dock', zone), inputBar] }));
     const phase = settling ? 'settling' : hero ? 'hero' : 'active';
     const composer = renderSlotChain('conversation.composer', { interactions: pending, session }, { fallback: composerBar, overlay: true });
     // Sticky wraps the whole chain output (fallback + elected overlay), not

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

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 /** Strict per-session header/body content inserted into the resident conversation layout. */
 import { useEffect, useSyncExternalStore } from 'react';
 import clsx from 'clsx';
@@ -21,7 +21,11 @@ function deriveAncestry(list, id) {
         const summary = list.byId[cursor];
         if (summary === undefined)
             break;
-        chain.unshift({ id: summary.id, displayTitle: summary.displayTitle });
+        chain.unshift({
+            id: summary.id,
+            displayTitle: summary.displayTitle,
+            subagent: summary.origin === 'subagent',
+        });
         if (summary.origin !== 'subagent')
             break;
         cursor = summary.parentId;
@@ -51,7 +55,18 @@ export function ConversationSessionHeader({ sessionId, useSession, useSessions,
     const hideChrome = blank && composerPhase === 'blank';
     return (_jsx("header", { className: clsx(css.header, hideChrome && css.headerHidden), "aria-hidden": hideChrome || undefined, children: !hideChrome && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.titleRow, children: [_jsxs("div", { className: css.titleCluster, children: [_jsxs("nav", { className: css.crumbs, "aria-label": t('session.hierarchy'), children: [ancestry.map((summary, index) => {
                                             const last = index === ancestry.length - 1;
-                                            return (_jsxs("span", { className: css.crumbSeg, children: [index > 0 && _jsx("span", { className: css.crumbSep, children: "/" }), _jsx("button", { type: "button", className: clsx(css.crumb, last && css.crumbCurrent), disabled: last, onClick: () => { open(summary.id); }, children: summary.displayTitle })] }, summary.id));
+                                            const title = (_jsx("button", { type: "button", className: clsx(css.crumb, summary.subagent && css.crumbSubagent, last && css.crumbCurrent), disabled: last, onClick: () => { open(summary.id); }, children: summary.displayTitle }));
+                                            const lineage = last || summary.subagent;
+                                            const lineageOwner = {
+                                                lineageSessionId: summary.id,
+                                                displayTitle: summary.displayTitle,
+                                                ...last ? {} : { openTitle: () => { open(summary.id); } },
+                                            };
+                                            return (_jsxs("span", { className: css.crumbSeg, children: [index > 0 && _jsx("span", { className: css.crumbSep, children: "/" }), lineage
+                                                        ? summary.subagent
+                                                            ? renderSlot('conversation.session.header.lineage', lineageOwner, { fallback: title })
+                                                            : (_jsxs(_Fragment, { children: [title, renderSlot('conversation.session.header.lineage', lineageOwner, { fallback: null })] }))
+                                                        : title] }, summary.id));
                                         }), ancestry.length === 0 && _jsx("span", { className: css.crumbCurrent, children: sessionId })] }), _jsx("div", { className: css.headerActions, children: renderSlot('conversation.session.header.actions', {}) })] }), _jsx("div", { className: css.headerUtilities, children: renderSlot('conversation.session.header.utilities', {}) })] }), tabs.length > 1 && (_jsx("div", { className: css.tabs, role: "tablist", children: tabs.map(viewTab => (_jsx("button", { type: "button", role: "tab", "aria-selected": viewTab.id === active?.id, className: clsx(css.tab, viewTab.id === active?.id && css.tabActive), onClick: () => { actions.setView(viewTab.id); }, children: viewTab.label }, viewTab.id))) }))] })) }));
 }
 /**

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

@@ -41,6 +41,8 @@ export declare function HeroGlow({ className }: {
 export interface HeroShellProps {
     /** The owner's locale seat, passed down as a plain prop. */
     t: HeroTranslate;
+    /** Authorized renderer for the hero brand-mark slot. */
+    renderSlot: ConversationSlotProps['renderSlot'];
     /** Overlay content after the stack (modals). */
     children?: ReactNode;
 }
@@ -50,6 +52,6 @@ export interface HeroShellProps {
  * @param props - see {@link HeroShellProps}.
  * @returns the centered hero element tree.
  */
-export declare function HeroShell({ t, children }: HeroShellProps): import("react").JSX.Element;
+export declare function HeroShell({ t, renderSlot, children }: HeroShellProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=EmptyHero.d.ts.map

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

@@ -52,7 +52,9 @@ export function HeroGlow({ className }) {
  * @param props - see {@link HeroShellProps}.
  * @returns the centered hero element tree.
  */
-export function HeroShell({ t, children }) {
-    return (_jsxs("div", { className: css.root, children: [_jsxs("div", { className: css.stack, children: [_jsxs("div", { className: css.headline, children: [_jsx("span", { className: css.logoHitbox, children: _jsx(NomixLogo, { size: 34, className: css.logo }) }), _jsx("span", { className: css.headlineText, children: t('hero.headline') }), _jsx("span", { className: css.previewBadge, children: t('hero.preview') })] }), _jsx("div", { className: css.body })] }), children] }));
+export function HeroShell({ t, renderSlot, children }) {
+    return (_jsxs("div", { className: css.root, children: [_jsxs("div", { className: css.stack, children: [_jsxs("div", { className: css.headline, children: [_jsx("span", { className: css.fishHitbox, children: renderSlot('conversation.hero.brand.mark', { size: 34, className: css.fish }, {
+                                    fallback: _jsx(NomixLogo, { size: 34, className: css.fish }),
+                                }) }), _jsx("span", { className: css.headlineText, children: t('hero.headline') }), _jsx("span", { className: css.previewBadge, children: t('hero.preview') })] }), _jsx("div", { className: css.body })] }), children] }));
 }
 //# sourceMappingURL=EmptyHero.js.map