@hanzo/ui 8.27.3 → 8.27.4

package/dist/backdrop/scene.js

@@ -0,0 +1,423 @@
+/**
+ * What paints behind a conversation, and the pure rules that read it.
+ *
+ * No React and no imports: every rule about what can play, what a link means and
+ * what a typed command does is decidable from data alone, so it is decidable in
+ * a test without rendering anything — and a surface can read a stored value
+ * before it has mounted anything.
+ *
+ * ONE switch. `mode: 'off'` is the only way to say "no backdrop"; there is
+ * deliberately no enable flag beside it, because a pair of them makes two states
+ * (off + video, on + off) that paint the same nothing, and that ambiguity is
+ * where a bug grows.
+ *
+ * WHAT CANNOT PLAY, AND WHY: only YouTube and Twitch are embeddable. Every DRM
+ * service — Netflix and its neighbours — publishes no embed, wraps playback in
+ * Widevine and forbids framing in its terms. There is no key and no clever
+ * iframe that changes that, so such a link is classed `other` and NEVER becomes
+ * a frame. A menu can offer it as a link that opens in a tab; anything else
+ * would be pretending.
+ *
+ * No provider password is ever asked for. A members-only or age-gated stream
+ * plays if — and only if — the viewer is already signed in to that provider in
+ * this browser, because the embed rides their own cookies. Collecting those
+ * credentials is not a feature this is missing; it is one it refuses.
+ */
+/** A blank canvas — the value a surface starts from and folds changes onto.
+ *  `off`, because a component library must not begin streaming video on its
+ *  own; a surface that wants footage says so. */
+export const BLANK = {
+    mode: 'off',
+    photo: '',
+    video: '',
+    playlist: [],
+    clips: [],
+    loop: true,
+    sound: false,
+};
+/** How long a live stream holds the canvas before the list moves on. A Twitch
+ *  channel never ends, so unlike a video it cannot announce its turn is up. */
+export const DWELL = 5 * 60 * 1000;
+/**
+ * The longest URL that will be kept. Browsers stopped being the limit long ago;
+ * the limit that matters is whatever storage a surface writes this to, one quota
+ * shared by every preference it holds. A URL is a string a visitor can paste, so
+ * without a ceiling one pasted megabyte fills that quota and the NEXT write of
+ * any unrelated setting is the one that throws. 2048 is what every server and
+ * proxy has accepted since forever, and far past any real link.
+ */
+const LONGEST = 2048;
+/** The longest list. Same quota, same reasoning: appending is a loop a visitor
+ *  can run, so it needs an end. Well past any list anyone watches. */
+const MOST = 64;
+/**
+ * A short list to choose from without knowing a link — offered, never a default
+ * (`BLANK` is the default, and it is off). Short by intent: the set someone can
+ * read in one glance, with the whole rest of the web one paste away.
+ */
+export const PRESETS = [
+    { id: 'cetaceans', label: 'Cetaceans', url: 'https://www.youtube.com/watch?v=UY5YH6B4A9o' },
+    { id: 'reef', label: 'Reef', url: 'https://www.youtube.com/watch?v=6lZ3CookYNg' },
+    { id: 'deep', label: 'Deep water', url: 'https://www.youtube.com/watch?v=7Exxd2ievAw' },
+];
+/**
+ * The media hosts a file may be loaded from besides the page's own origin.
+ *
+ * The Hanzo store is the default because it is where our surfaces keep footage.
+ * A brand serving from somewhere else passes its own list — every function here
+ * that reads a URL takes one — and whatever it passes must also be what its
+ * `img-src` / `media-src` policy allows, or the element is refused by the
+ * browser and paints nothing with no error anywhere.
+ */
+export const HOSTS = ['s3.hanzo.ai', 's3-api.hanzo.ai'];
+/**
+ * The URL if it is one worth loading, else ''. Anything that is not http(s) —
+ * `javascript:`, `data:`, `blob:` — is refused here, at the boundary, so no
+ * caller downstream has to remember to check.
+ */
+export function web(value) {
+    if (typeof value !== 'string' || value.trim() === '' || value.length > LONGEST)
+        return '';
+    try {
+        const url = new URL(value.trim());
+        return url.protocol === 'http:' || url.protocol === 'https:' ? url.href : '';
+    }
+    catch {
+        return '';
+    }
+}
+const named = (url) => {
+    try {
+        return new URL(url).hostname.replace(/^www\./, '').toLowerCase();
+    }
+    catch {
+        return '';
+    }
+};
+/** Any absolute URL resolves against this, so a relative path can be told from
+ *  one that only looks relative. Never fetched; it is a ruler, not a place. */
+const HERE = 'https://backdrop.invalid';
+/**
+ * A media file that may be painted or played, else ''.
+ *
+ * Narrower than `web`, and it is the one rule here that is not about what plays.
+ * An `<img>` or a `<video src>` fires a GET the moment it renders, with no click
+ * and no script, and a STORED one refires on every load afterwards — reporting
+ * the viewer's address to whoever owns the host, forever. So a file is ours: a
+ * path on this origin, kept RELATIVE because a surface is served under several
+ * brands' domains and a stored absolute origin would be wrong on all but one, or
+ * a file on a host the caller allows.
+ *
+ * A URL the browser's own policy would refuse is dropped HERE instead, where it
+ * can be answered honestly: a blocked element never fires `load`, so allowing it
+ * would mean a blank canvas and nothing anywhere saying why.
+ *
+ * Backslashes are why this parses rather than matches: `/\evil.example/x.png`
+ * looks like a path and resolves to a different host.
+ *
+ * A photo and a clip are the same question asked about two elements, so they are
+ * one function. Two copies would be two places to get the backslash wrong.
+ */
+export function media(value, hosts = HOSTS) {
+    if (typeof value !== 'string' || value.trim() === '' || value.length > LONGEST)
+        return '';
+    try {
+        const url = new URL(value.trim(), HERE);
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            return '';
+        if (url.origin === HERE)
+            return url.pathname + url.search;
+        return hosts.includes(named(url.href)) ? url.href : '';
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * A list of files from an array, or from a comma- or space-separated string —
+ * whichever a configuration value supplies. Every entry passes through `media`,
+ * so an unusable one is dropped rather than trusted, and the whole is capped for
+ * the same quota reason a playlist is.
+ */
+export function files(value, hosts = HOSTS) {
+    const raw = Array.isArray(value)
+        ? value.map((v) => (typeof v === 'string' ? v : ''))
+        : typeof value === 'string'
+            ? value.split(/[\s,]+/)
+            : [];
+    const out = [];
+    for (const entry of raw) {
+        const ok = media(entry, hosts);
+        if (ok && !out.includes(ok))
+            out.push(ok);
+        if (out.length >= MOST)
+            break;
+    }
+    return out;
+}
+/** Who serves this link, decided by host alone. */
+export function provider(url) {
+    const name = named(url);
+    if (name === 'youtube.com' || name === 'm.youtube.com' || name === 'music.youtube.com') {
+        return 'youtube';
+    }
+    if (name === 'youtu.be')
+        return 'youtube';
+    if (name === 'twitch.tv' || name === 'm.twitch.tv' || name === 'player.twitch.tv') {
+        return 'twitch';
+    }
+    return 'other';
+}
+/** A YouTube video id is exactly 11 of these. */
+const ID = /^[\w-]{11}$/;
+/**
+ * The video id inside a YouTube URL, or '' if there is not one. Accepts the
+ * forms people actually paste — watch links, share links, shorts, embeds — and a
+ * bare id, which is what the address bar leaves you with often enough.
+ */
+export function videoId(value) {
+    const raw = value.trim();
+    if (ID.test(raw))
+        return raw;
+    const url = web(raw);
+    if (!url || provider(url) !== 'youtube')
+        return '';
+    const { pathname, searchParams } = new URL(url);
+    const query = searchParams.get('v') ?? '';
+    if (ID.test(query))
+        return query;
+    // youtu.be/ID, /embed/ID, /shorts/ID, /live/ID — the id is the last segment.
+    const last = pathname.split('/').filter(Boolean).pop() ?? '';
+    return ID.test(last) ? last : '';
+}
+/**
+ * What to ask the Twitch player for: a live `channel`, or a recorded `video`.
+ * Empty `name` means the URL names neither.
+ *
+ * A CLIP names neither. `twitch.tv/<channel>/clip/<slug>` is a few seconds
+ * somebody cut out, and the player this builds cannot ask for one — that embed
+ * is a different host with a different parameter. Falling back to the channel
+ * would put a LIVE STREAM on the canvas in place of the clip that was asked for:
+ * not the thing, and not obviously not the thing. So it is unplayable, and a
+ * menu says so with a link out. Refusing what we cannot serve beats serving
+ * something else.
+ */
+export function channel(value) {
+    const none = { key: 'channel', name: '' };
+    const url = web(value);
+    if (!url || provider(url) !== 'twitch')
+        return none;
+    const parsed = new URL(url);
+    const parts = parsed.pathname.split('/').filter(Boolean);
+    const direct = parsed.searchParams.get('channel') ?? parsed.searchParams.get('video') ?? '';
+    if (direct)
+        return { key: parsed.searchParams.get('video') ? 'video' : 'channel', name: direct };
+    if (parts[0] === 'videos' && parts[1])
+        return { key: 'video', name: parts[1] };
+    if (parts.includes('clip'))
+        return none;
+    return { key: 'channel', name: parts[0] ?? '' };
+}
+/** A playlist entry from a pasted URL, or null if it is not a URL at all. */
+export function link(value) {
+    const url = web(value);
+    return url ? { url, provider: provider(url) } : null;
+}
+/** Whether this can actually go on the canvas. `other` never can. */
+export function playable(entry) {
+    if (entry.provider === 'youtube')
+        return videoId(entry.url) !== '';
+    if (entry.provider === 'twitch')
+        return channel(entry.url).name !== '';
+    return false;
+}
+/** Every YouTube player param that keeps the chrome out of frame. */
+const PLAYER = [
+    'autoplay=1',
+    'mute=1',
+    'controls=0',
+    'rel=0',
+    'playsinline=1',
+    'disablekb=1',
+    'fs=0',
+    'iv_load_policy=3',
+    'vq=hd1080',
+    // The listening handshake this enables is what lets the canvas wait for a real
+    // "playing" report before revealing anything.
+    'enablejsapi=1',
+].join('&');
+/**
+ * The embed URL for one or more YouTube videos.
+ *
+ * www.youtube.com, not youtube-nocookie: the nocookie host answers embeds with
+ * "video player configuration error" (153) in current Chrome.
+ *
+ * `loop` needs `playlist` even for a single video — that is YouTube's rule, not
+ * ours: a lone video with `loop=1` and no list plays once and stops.
+ */
+export function youtube(ids, loop, origin, start) {
+    const [first, ...rest] = ids;
+    const params = [PLAYER, `origin=${encodeURIComponent(origin)}`];
+    if (loop) {
+        params.push('loop=1', `playlist=${(rest.length ? rest : [first]).join(',')}`);
+    }
+    else if (rest.length) {
+        params.push(`playlist=${rest.join(',')}`);
+    }
+    // Where the video opens, in seconds. Native `start=` on the embed, so it is
+    // honoured before the first frame rather than seeked to after.
+    if (start && start > 0)
+        params.push(`start=${Math.floor(start)}`);
+    return `https://www.youtube.com/embed/${first}?${params.join('&')}`;
+}
+/**
+ * Optional knobs a brand carries in the SAME video URL, so one configuration
+ * value tunes all of them with no rebuild:
+ *   `start` / `t`  seconds to open on
+ *   `rate`         playback speed (YouTube quantises to its allowed steps —
+ *                  0.25/0.5/0.75/1/…, so 0.42 plays at the nearest, 0.5)
+ *   `zoom`         cover-crop scale, to push a corner watermark off-frame
+ * Absent keys return undefined and the caller keeps its own default.
+ */
+export function knobs(value) {
+    const url = web(value);
+    if (!url)
+        return {};
+    const q = new URL(url).searchParams;
+    const num = (k) => {
+        const v = q.get(k);
+        if (v == null)
+            return undefined;
+        const n = Number(v);
+        return Number.isFinite(n) ? n : undefined;
+    };
+    return { start: num('start') ?? num('t'), rate: num('rate'), zoom: num('zoom') };
+}
+/**
+ * The embed URL for a Twitch channel or VOD. `parent` is mandatory — Twitch
+ * refuses to frame for a host it was not told about — and must be the bare
+ * hostname, no scheme, no port.
+ */
+export function twitch(value, parent) {
+    const { key, name } = channel(value);
+    return (`https://player.twitch.tv/?${key}=${encodeURIComponent(name)}` +
+        `&parent=${encodeURIComponent(parent)}&muted=true&autoplay=true&controls=false`);
+}
+const MODES = ['off', 'photo', 'video', 'playlist', 'clips'];
+/**
+ * Fold an untrusted description of a backdrop onto the current one.
+ *
+ * This is the ONE gate, and it is deliberately total: anything it cannot make
+ * sense of is dropped and the current value kept, so no caller can push a scene
+ * into a shape the canvas has to defend against later. Everything a surface
+ * takes in comes through here — a settings panel, a card a model can propose,
+ * and the read back out of storage on the next load, which matters because bytes
+ * in storage are not ours and a rule enforced only on the way in lasts exactly
+ * until the page is refreshed.
+ */
+export function merge(current, change, hosts = HOSTS) {
+    if (typeof change !== 'object' || change === null)
+        return current;
+    const next = { ...current };
+    const given = change;
+    if (MODES.includes(given.mode))
+        next.mode = given.mode;
+    if (typeof given.loop === 'boolean')
+        next.loop = given.loop;
+    if (typeof given.sound === 'boolean')
+        next.sound = given.sound;
+    const photo = media(given.photo, hosts);
+    if (photo)
+        next.photo = photo;
+    if (given.video !== undefined && videoId(String(given.video))) {
+        next.video = String(given.video).trim();
+    }
+    if (Array.isArray(given.playlist)) {
+        // The provider is recomputed from the URL every time rather than believed: a
+        // caller claiming `provider: 'youtube'` for a netflix.com link must not be
+        // able to talk the canvas into framing it.
+        next.playlist = given.playlist
+            .map((entry) => link(typeof entry === 'string' ? entry : String(entry?.url ?? '')))
+            .filter((entry) => entry !== null)
+            .slice(0, MOST);
+    }
+    // Re-validated on the way in AND on the way out, the same as the playlist, so
+    // a file the media policy would refuse cannot reach a `<video src>` by having
+    // been written to storage under an older rule.
+    if (given.clips !== undefined)
+        next.clips = files(given.clips, hosts);
+    return next;
+}
+/**
+ * What a brand's single configuration string names.
+ *
+ * A list of direct video files — comma- or space-separated, or any value naming
+ * a media file the surface serves — opens on `clips`; anything else stays the
+ * YouTube video it has always been, so an existing single-URL value does not
+ * change meaning.
+ *
+ * Pure, and here rather than in a store, because "what does this value mean" is
+ * a rule about data, decidable in a test with no browser.
+ */
+export function scene(value, hosts = HOSTS) {
+    const list = files(value, hosts);
+    if (list.length > 0)
+        return { mode: 'clips', clips: list, video: '' };
+    return { mode: 'video', clips: [], video: value };
+}
+/**
+ * `/background` or `/bg`, and then a space or the end of the line — not merely a
+ * word boundary, which `/background-image …` also satisfies. A command is one of
+ * exactly two words; anything else is a message and is sent as one.
+ */
+const VERB = /^\/(?:background|bg)(?:\s|$)/i;
+/**
+ * Read a `/background` (or `/bg`) line typed into a composer.
+ *
+ * Answers the scene it asks for, or null when the line is not one of these
+ * commands or names something unusable — null meaning "not handled", so the
+ * caller sends it on as an ordinary message and the viewer can see for
+ * themselves that nothing was applied.
+ *
+ *   /bg off              stop painting anything
+ *   /bg photo <url>      a still image
+ *   /bg video <url>      one YouTube video
+ *   /bg add <url>        append to the playlist and switch to it
+ *   /bg loop on|off      repeat at the end
+ *
+ * There is no `/bg <url>` that guesses: guessing is a second way to say what
+ * `photo` and `video` already say exactly, and the guess is wrong precisely when
+ * the URL is unusual — which is when being wrong costs the most.
+ */
+export function command(input, current, hosts = HOSTS) {
+    const line = input.trim();
+    if (!VERB.test(line))
+        return null;
+    const [, verb = '', ...rest] = line.split(/\s+/);
+    const argument = rest.join(' ').trim();
+    switch (verb.toLowerCase()) {
+        case 'off':
+            return { ...current, mode: 'off' };
+        case 'photo': {
+            const url = media(argument, hosts);
+            return url ? { ...current, mode: 'photo', photo: url } : null;
+        }
+        case 'video':
+            return videoId(argument) ? { ...current, mode: 'video', video: argument.trim() } : null;
+        case 'add': {
+            // Through `merge` so the list has ONE keeper of its length, rather than a
+            // second append here that forgets what the first one enforces.
+            const entry = link(argument);
+            return entry && playable(entry)
+                ? merge(current, { mode: 'playlist', playlist: [...current.playlist, entry] }, hosts)
+                : null;
+        }
+        case 'loop': {
+            const on = argument.toLowerCase();
+            return on === 'on' || on === 'off' ? { ...current, loop: on === 'on' } : null;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=scene.js.map

package/dist/backdrop/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../src/backdrop/scene.ts"],"names":[],"mappings":"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"}

package/dist/chat/Chat.cjs

@@ -28,6 +28,10 @@ const jsx_runtime_1 = require("react/jsx-runtime");
  * component reads it, and lifting it would put a keystroke through the surface's
  * state on every letter.
  *
+ * That same call now draws a turn whose content is a LIST, through `Parts` — so
+ * an image, a tool call, a citation and an artifact reach the screen with
+ * nothing added at the call site. They used to be dropped there.
+ *
  * No transport, no store, no routing — `@hanzo/ui` stays fetch-free, so nothing
  * here imports `@hanzo/ai`. `messages` is read structurally, which is what lets
  * that hold while the two packages still compose exactly.
@@ -38,8 +42,26 @@ const ink_1 = require("../backends/gui/ink.cjs");
 const slot_1 = require("../backends/gui/slot.cjs");
 const Composer_1 = require("./Composer.cjs");
 const Message_1 = require("./Message.cjs");
+const Parts_1 = require("./Parts.cjs");
 const Thread_1 = require("./Thread.cjs");
 const words_1 = require("./words.cjs");
+/**
+ * A turn's content, drawn by what it is.
+ *
+ * A string is prose and always was. A LIST goes to `Parts`, which is the change:
+ * it used to go to `words`, which keeps the text and drops the image, the tool
+ * call and the citation — so a surface passing the wire's own turns saw only the
+ * prose in them, and had to write its own switch to see the rest.
+ *
+ * Nothing regresses on the way through. `Parts` joins adjacent prose before it
+ * draws (the wire splits a sentence mid-word), and a part whose type it does not
+ * know contributes its text, so an all-text turn renders the identical string
+ * `words` produced.
+ *
+ * The cast is the one place the open wire meets the closed union, and it is safe
+ * in exactly that direction: `Parts` reads `type` before it reads anything else.
+ */
+const draw = (said) => typeof said === 'string' || said == null ? ((0, ink_1.ink)((0, words_1.words)(said))) : ((0, jsx_runtime_1.jsx)(Parts_1.Parts, { parts: said }));
 function Chat({ messages, streaming = false, send: onSend, stop: onStop, body, empty, composer, ...thread }) {
     const [draft, setDraft] = (0, react_1.useState)('');
     // Clearing here rather than in an effect on `messages` is what keeps a send
@@ -63,5 +85,5 @@ function Chat({ messages, streaming = false, send: onSend, stop: onStop, body, e
     // from the composer lands on a `display: contents` wrapper or on the page,
     // and then reports a component that is fine as broken, or one that is broken
     // as fine.
-    return ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { flex: 1, width: "100%", ...(0, slot_1.slot)('chat'), children: [messages.length === 0 && empty ? (empty) : ((0, jsx_runtime_1.jsx)(Thread_1.Thread, { flex: 1, ...thread, children: messages.map((turn, i) => ((0, jsx_runtime_1.jsx)(Message_1.Message, { role: turn.role, busy: streaming && i === last && turn.role === 'assistant', children: body ? body(turn) : (0, ink_1.ink)((0, words_1.words)(turn.content)) }, turn.id))) })), (0, jsx_runtime_1.jsx)(Composer_1.Composer, { value: draft, onChange: setDraft, onSend: send, busy: streaming, ...(onStop ? { onStop } : {}), ...composer })] }));
+    return ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { flex: 1, width: "100%", ...(0, slot_1.slot)('chat'), children: [messages.length === 0 && empty ? (empty) : ((0, jsx_runtime_1.jsx)(Thread_1.Thread, { flex: 1, ...thread, children: messages.map((turn, i) => ((0, jsx_runtime_1.jsx)(Message_1.Message, { role: turn.role, busy: streaming && i === last && turn.role === 'assistant', children: body ? body(turn) : draw(turn.content) }, turn.id))) })), (0, jsx_runtime_1.jsx)(Composer_1.Composer, { value: draft, onChange: setDraft, onSend: send, busy: streaming, ...(onStop ? { onStop } : {}), ...composer })] }));
 }

package/dist/chat/Chat.d.ts

@@ -21,7 +21,7 @@ export interface Turn {
      * over: a completion's content is `string | ContentPart[]` (text beside an
      * image), so a turn holding an attachment could not be handed to this at all.
      * Narrowing the wire in a component fed BY the wire just relocates the
-     * mismatch to every caller. `words` is the flattener.
+     * mismatch to every caller. `words` flattens it to prose; `Parts` draws it.
      */
     content?: Said;
 }
@@ -45,12 +45,15 @@ export interface ChatProps extends Omit<ThreadProps, 'children' | 'ref'> {
     /** End the turn in flight. Absent, the composer offers no stop. */
     stop?: () => void;
     /**
-     * Render a turn's body. Defaults to its text.
+     * Render a turn's body. Defaults to `Parts` for a list and the words for a
+     * string.
      *
      * A surface with a markdown pipeline passes it here — the plugin set is
      * per-surface (nine plugins, one plugin, or a regex under a bundle ceiling
      * that cannot afford a parser), so this package ships none and renders the
-     * words plainly until someone says otherwise.
+     * words plainly until someone says otherwise. The usual form hands the
+     * pipeline to `Parts` rather than replacing it:
+     * `body={(t) => <Parts parts={t.content as MessagePart[]} prose={md} />}`.
      */
     body?: (turn: Turn) => ReactNode;
     /** Shown instead of the thread while nothing has been said. */

package/dist/chat/Chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../src/chat/Chat.tsx"],"names":[],"mappings":"AAgCA,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI7D,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EAAW,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,SAAS,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,IAAI,CAAA;CACf;AAED,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,KAAK,CAAC;IACtE,sCAAsC;IACtC,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;;;;;OAUG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,IAAI,CAAA;IACjB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAA;IAChC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;CAClC;AAED,wBAAgB,IAAI,CAAC,EACnB,QAAQ,EACR,SAAiB,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,GAAG,MAAM,EACV,EAAE,SAAS,+BAoDX"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../src/chat/Chat.tsx"],"names":[],"mappings":"AAoCA,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI7D,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EAAW,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,SAAS,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,IAAI,CAAA;CACf;AAED,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,KAAK,CAAC;IACtE,sCAAsC;IACtC,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;;;;;OAUG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,IAAI,CAAA;IACjB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAA;IAChC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;CAClC;AAyBD,wBAAgB,IAAI,CAAC,EACnB,QAAQ,EACR,SAAiB,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,GAAG,MAAM,EACV,EAAE,SAAS,+BAoDX"}

package/dist/chat/Chat.js

@@ -25,6 +25,10 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * component reads it, and lifting it would put a keystroke through the surface's
  * state on every letter.
  *
+ * That same call now draws a turn whose content is a LIST, through `Parts` — so
+ * an image, a tool call, a citation and an artifact reach the screen with
+ * nothing added at the call site. They used to be dropped there.
+ *
  * No transport, no store, no routing — `@hanzo/ui` stays fetch-free, so nothing
  * here imports `@hanzo/ai`. `messages` is read structurally, which is what lets
  * that hold while the two packages still compose exactly.
@@ -35,8 +39,26 @@ import { ink } from '../backends/gui/ink.js';
 import { slot } from '../backends/gui/slot.js';
 import { Composer } from './Composer.js';
 import { Message } from './Message.js';
+import { Parts } from './Parts.js';
 import { Thread } from './Thread.js';
 import { words } from './words.js';
+/**
+ * A turn's content, drawn by what it is.
+ *
+ * A string is prose and always was. A LIST goes to `Parts`, which is the change:
+ * it used to go to `words`, which keeps the text and drops the image, the tool
+ * call and the citation — so a surface passing the wire's own turns saw only the
+ * prose in them, and had to write its own switch to see the rest.
+ *
+ * Nothing regresses on the way through. `Parts` joins adjacent prose before it
+ * draws (the wire splits a sentence mid-word), and a part whose type it does not
+ * know contributes its text, so an all-text turn renders the identical string
+ * `words` produced.
+ *
+ * The cast is the one place the open wire meets the closed union, and it is safe
+ * in exactly that direction: `Parts` reads `type` before it reads anything else.
+ */
+const draw = (said) => typeof said === 'string' || said == null ? (ink(words(said))) : (_jsx(Parts, { parts: said }));
 export function Chat({ messages, streaming = false, send: onSend, stop: onStop, body, empty, composer, ...thread }) {
     const [draft, setDraft] = useState('');
     // Clearing here rather than in an effect on `messages` is what keeps a send
@@ -60,6 +82,6 @@ export function Chat({ messages, streaming = false, send: onSend, stop: onStop,
     // from the composer lands on a `display: contents` wrapper or on the page,
     // and then reports a component that is fine as broken, or one that is broken
     // as fine.
-    return (_jsxs(YStack, { flex: 1, width: "100%", ...slot('chat'), children: [messages.length === 0 && empty ? (empty) : (_jsx(Thread, { flex: 1, ...thread, children: messages.map((turn, i) => (_jsx(Message, { role: turn.role, busy: streaming && i === last && turn.role === 'assistant', children: body ? body(turn) : ink(words(turn.content)) }, turn.id))) })), _jsx(Composer, { value: draft, onChange: setDraft, onSend: send, busy: streaming, ...(onStop ? { onStop } : {}), ...composer })] }));
+    return (_jsxs(YStack, { flex: 1, width: "100%", ...slot('chat'), children: [messages.length === 0 && empty ? (empty) : (_jsx(Thread, { flex: 1, ...thread, children: messages.map((turn, i) => (_jsx(Message, { role: turn.role, busy: streaming && i === last && turn.role === 'assistant', children: body ? body(turn) : draw(turn.content) }, turn.id))) })), _jsx(Composer, { value: draft, onChange: setDraft, onSend: send, busy: streaming, ...(onStop ? { onStop } : {}), ...composer })] }));
 }
 //# sourceMappingURL=Chat.js.map

package/dist/chat/Chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.js","sourceRoot":"","sources":["../../src/chat/Chat.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAE7D,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,OAAO,EAAa,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,KAAK,EAAa,MAAM,SAAS,CAAA;AA2D1C,MAAM,UAAU,IAAI,CAAC,EACnB,QAAQ,EACR,SAAS,GAAG,KAAK,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,GAAG,MAAM,EACC;IACV,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IAEtC,4EAA4E;IAC5E,yEAAyE;IACzE,iEAAiE;IACjE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QACzB,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,QAAQ,CAAC,EAAE,CAAC,CAAA;QACZ,MAAM,CAAC,IAAI,CAAC,CAAA;IACd,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IAEnB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;IAEhC,4EAA4E;IAC5E,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,8EAA8E;IAC9E,gFAAgF;IAChF,4EAA4E;IAC5E,2EAA2E;IAC3E,6EAA6E;IAC7E,WAAW;IACX,OAAO,CACL,MAAC,MAAM,IAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,aAC3C,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAChC,KAAK,CACN,CAAC,CAAC,CAAC,CACF,KAAC,MAAM,IAAC,IAAI,EAAE,CAAC,KAAM,MAAM,YACxB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACzB,KAAC,OAAO,IAEN,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,IAAI,EAAE,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,YAEzD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAJxC,IAAI,CAAC,EAAE,CAKJ,CACX,CAAC,GACK,CACV,EACD,KAAC,QAAQ,IACP,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,IAAI,EACZ,IAAI,EAAE,SAAS,KACX,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC1B,QAAQ,GACZ,IACK,CACV,CAAA;AACH,CAAC"}
+{"version":3,"file":"Chat.js","sourceRoot":"","sources":["../../src/chat/Chat.tsx"],"names":[],"mappings":"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"}

package/dist/chat/Inspector.cjs

@@ -0,0 +1,51 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inspector = Inspector;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * Inspector — what the agent did, beside what it said.
+ *
+ * The thread carries the answer. This carries the evidence: a summary at the
+ * top, then the run's own regions underneath — what it was given, what it
+ * produced, what ran on the way. It is the pane a person reads to decide
+ * whether to believe the answer, which is why the summary is first and the
+ * detail is under it rather than the other way round.
+ *
+ * It is the CONTENTS of the right rail, not the rail. `Aside` is the column —
+ * the border, the width, the fact that it is a column at all — and this goes
+ * inside it. Two components because a surface hides the rail at narrow widths
+ * by not rendering it, and that decision has nothing to do with what is in it.
+ *
+ * ONE inspector, whatever the run was. A section carries `facts` (name to
+ * value) or `parts` (drawn by `Parts`), and `MessagePart` already covers every
+ * shape a run produces: tool calls and their results for a chat turn, files and
+ * console output for a coding run, `citation` for a research run's sources, an
+ * `artifact` for anything it made. A second panel per kind of run would be four
+ * copies of this file disagreeing about spacing.
+ *
+ * A section with nothing in it does not render, so a caller passes the same
+ * list every time and does not write the emptiness checks.
+ */
+const gui_1 = require("@hanzo/gui");
+const slot_1 = require("../backends/gui/slot.cjs");
+const Code_1 = require("./Code.cjs");
+const Parts_1 = require("./Parts.cjs");
+const filled = (section) => (section.facts != null && Object.keys(section.facts).length > 0) ||
+    (section.parts != null && section.parts.length > 0);
+function Inspector({ title = 'Run', summary, sections = [], placeholder, prose, onRetry, onOpen, onSource, ...props }) {
+    const shown = sections.filter(filled);
+    const bare = summary == null && shown.length === 0;
+    return ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { ...(0, slot_1.slot)('inspector'), flex: 1, minH: 0, width: "100%", ...props, children: [(0, jsx_runtime_1.jsx)(gui_1.XStack, { items: "center", px: "$1", pb: "$2", shrink: 0, children: (0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$1", color: "$soft", fontWeight: "600", children: title }) }), (0, jsx_runtime_1.jsx)(gui_1.ScrollView, { flex: 1, showsVerticalScrollIndicator: false, children: (0, jsx_runtime_1.jsxs)(gui_1.YStack, { gap: "$4", pb: "$4", children: [summary ? ((0, jsx_runtime_1.jsx)(gui_1.YStack, { ...(0, slot_1.slot)('inspector-summary'), p: "$3", gap: "$2", rounded: "$4", borderWidth: 1, borderColor: "$borderColor", bg: "$panel", children: (0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$2", color: "$ink", children: summary }) })) : null, shown.map((section) => ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { ...(0, slot_1.slot)('inspector-section'), gap: "$2", children: [(0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$1", color: "$quiet", fontWeight: "600", children: section.name }), section.facts ? (0, jsx_runtime_1.jsx)(Table, { facts: section.facts }) : null, section.parts?.length ? ((0, jsx_runtime_1.jsx)(Parts_1.Parts, { parts: section.parts, prose: prose, onRetry: onRetry, onOpen: onOpen, onSource: onSource })) : null] }, section.name))), bare && placeholder != null ? ((0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$2", color: "$soft", children: placeholder })) : null] }) })] }));
+}
+/**
+ * A record, as rows.
+ *
+ * A string is its own presentation; anything else goes through `Code`, because
+ * a nested object flattened into a line is unreadable and `show` already
+ * serialises one safely. That is the only rule here, and it is why this is a
+ * dozen lines rather than a formatting library.
+ */
+function Table({ facts }) {
+    return ((0, jsx_runtime_1.jsx)(gui_1.YStack, { ...(0, slot_1.slot)('inspector-facts'), rounded: "$4", borderWidth: 1, borderColor: "$borderColor", overflow: "hidden", children: Object.entries(facts).map(([name, value], i) => ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { gap: "$1.5", px: "$3", py: "$2", borderTopWidth: i === 0 ? 0 : 1, borderColor: "$borderColor", children: [(0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$1", color: "$quiet", children: name }), typeof value === 'string' ? ((0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$2", color: "$ink", children: value })) : ((0, jsx_runtime_1.jsx)(Code_1.Code, { language: "json", children: (0, Parts_1.show)(value) }))] }, name))) }));
+}