@hanzo/ui 8.27.3 → 8.27.5

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

@@ -1 +1 @@
-{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../src/chat/Message.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,OAAO,EAAQ,MAAM,EAAU,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE3D;wDACwD;AACxD,KAAK,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,CAAA;AAErE;;;;;;;GAOG;AACH,wBAAgB,KAAK,gCAEpB;AAED,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;6DACyD;IACzD,IAAI,CAAC,EAAE,KAAK,CAAA;CACb;AAED,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,IAAY,EACZ,IAAI,EACJ,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,YAAY,+BAyDd"}
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../src/chat/Message.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,OAAO,EAAQ,MAAM,EAAU,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE3D;wDACwD;AACxD,KAAK,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,CAAA;AAErE;;;;;;;GAOG;AACH,wBAAgB,KAAK,gCAEpB;AAED,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;6DACyD;IACzD,IAAI,CAAC,EAAE,KAAK,CAAA;CACb;AAED,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,IAAY,EACZ,IAAI,EACJ,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,YAAY,+BAyDd"}

package/dist/chat/Message.js

@@ -8,7 +8,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * turn is a muted aside. The contrast is what says who is speaking, so there is
  * no name and no timestamp, and `icon` is opt-in.
  *
- * Content is `children`: the markdown pipeline stays with the surface.
+ * Content is `children`: the markdown pipeline stays with the surface. A turn
+ * that arrived as a list of parts puts `<Parts>` there — `Chat` does exactly
+ * that — so this component keeps knowing nothing about the wire.
  */
 import { Text, XStack, YStack } from '@hanzo/gui';
 import { ink } from '../backends/gui/ink.js';

package/dist/chat/Message.js.map

@@ -1 +1 @@
-{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../src/chat/Message.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;GASG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGjD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAsB3C;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK;IACnB,OAAO,KAAC,MAAM,OAAK,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAC,MAAM,wBAAe,CAAA;AAC9F,CAAC;AAgBD,MAAM,UAAU,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,IAAI,EACJ,GAAG,KAAK,EACK;IACb,8EAA8E;IAC9E,4BAA4B;IAC5B,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM;QACtC,OAAO,CACL,KAAC,MAAM,OACD,IAAI,CAAC,SAAS,CAAC,eAIR,IAAI,EACf,KAAK,EAAC,MAAM,EACZ,OAAO,EAAC,QAAQ,EAChB,EAAE,EAAC,IAAI,KACH,KAAK,YAET,KAAC,IAAI,IAAC,QAAQ,EAAC,IAAI,EAAC,KAAK,EAAC,OAAO,EAAC,IAAI,EAAC,QAAQ,YAC5C,QAAQ,GACJ,GACA,CACV,CAAA;IAEH,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAA;IAC5B,OAAO,CACL,MAAC,MAAM,OACD,IAAI,CAAC,SAAS,CAAC,eACR,IAAI,EACf,KAAK,EAAC,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,EACzC,GAAG,EAAC,IAAI;QACR,qEAAqE;QACrE,oDAAoD;QACpD,KAAK,WACD,KAAK,aAER,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,MAAM,IAAC,EAAE,EAAC,IAAI,YAAE,IAAI,GAAU,CAAC,CAAC,CAAC,IAAI,EACvD,MAAC,MAAM,OACD,IAAI,CAAC,cAAc,CAAC,iBACX,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EACtC,GAAG,EAAC,IAAI;gBACR,yDAAyD;gBACzD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KACtB,CAAC,IAAI,IAAI;oBACX,EAAE,EAAE,QAAQ;oBACZ,OAAO,EAAE,IAAI;oBACb,EAAE,EAAE,IAAI;oBACR,EAAE,EAAE,IAAI;iBACT,CAAC,KACE,IAAI,aAEP,GAAG,CAAC,QAAQ,CAAC,EACb,IAAI,CAAC,CAAC,CAAC,KAAC,KAAK,KAAG,CAAC,CAAC,CAAC,IAAI,EACvB,OAAO,CAAC,CAAC,CAAC,KAAC,MAAM,IAAC,GAAG,EAAC,IAAI,EAAC,KAAK,EAAC,QAAQ,YAAE,OAAO,GAAU,CAAC,CAAC,CAAC,IAAI,IAC7D,IACF,CACV,CAAA;AACH,CAAC"}
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../src/chat/Message.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGjD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAsB3C;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK;IACnB,OAAO,KAAC,MAAM,OAAK,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAC,MAAM,wBAAe,CAAA;AAC9F,CAAC;AAgBD,MAAM,UAAU,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,IAAI,EACJ,GAAG,KAAK,EACK;IACb,8EAA8E;IAC9E,4BAA4B;IAC5B,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM;QACtC,OAAO,CACL,KAAC,MAAM,OACD,IAAI,CAAC,SAAS,CAAC,eAIR,IAAI,EACf,KAAK,EAAC,MAAM,EACZ,OAAO,EAAC,QAAQ,EAChB,EAAE,EAAC,IAAI,KACH,KAAK,YAET,KAAC,IAAI,IAAC,QAAQ,EAAC,IAAI,EAAC,KAAK,EAAC,OAAO,EAAC,IAAI,EAAC,QAAQ,YAC5C,QAAQ,GACJ,GACA,CACV,CAAA;IAEH,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAA;IAC5B,OAAO,CACL,MAAC,MAAM,OACD,IAAI,CAAC,SAAS,CAAC,eACR,IAAI,EACf,KAAK,EAAC,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,EACzC,GAAG,EAAC,IAAI;QACR,qEAAqE;QACrE,oDAAoD;QACpD,KAAK,WACD,KAAK,aAER,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,MAAM,IAAC,EAAE,EAAC,IAAI,YAAE,IAAI,GAAU,CAAC,CAAC,CAAC,IAAI,EACvD,MAAC,MAAM,OACD,IAAI,CAAC,cAAc,CAAC,iBACX,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EACtC,GAAG,EAAC,IAAI;gBACR,yDAAyD;gBACzD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KACtB,CAAC,IAAI,IAAI;oBACX,EAAE,EAAE,QAAQ;oBACZ,OAAO,EAAE,IAAI;oBACb,EAAE,EAAE,IAAI;oBACR,EAAE,EAAE,IAAI;iBACT,CAAC,KACE,IAAI,aAEP,GAAG,CAAC,QAAQ,CAAC,EACb,IAAI,CAAC,CAAC,CAAC,KAAC,KAAK,KAAG,CAAC,CAAC,CAAC,IAAI,EACvB,OAAO,CAAC,CAAC,CAAC,KAAC,MAAM,IAAC,GAAG,EAAC,IAAI,EAAC,KAAK,EAAC,QAAQ,YAAE,OAAO,GAAU,CAAC,CAAC,CAAC,IAAI,IAC7D,IACF,CACV,CAAA;AACH,CAAC"}

package/dist/chat/Parts.cjs

@@ -0,0 +1,159 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.show = void 0;
+exports.join = join;
+exports.Piece = Piece;
+exports.Parts = Parts;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * Parts — a streamed turn, drawn by what each piece of it IS.
+ *
+ * A completion's content is a list of parts, and until now this package had one
+ * answer for all of them: `words` flattens the list to prose and DROPS every
+ * part that is not text. An image, a tool call, a citation, an artifact — all of
+ * it arrived on the wire and none of it reached the screen. Six surfaces wrote
+ * six switch statements over the same union to get it back.
+ *
+ * `MessagePart` is that union, closed, and `Parts` is the dispatcher over it.
+ * Closed is the decision: `words`'s `Part` stays OPEN because it reads the wire
+ * and must survive a type it has never heard of, while this one is the CANON —
+ * the set a surface can exhaustively handle, and the set this package promises
+ * to draw. A part whose `type` is outside it still contributes its text, exactly
+ * as `words` does, so an unknown part degrades to prose instead of vanishing.
+ *
+ * Nothing here is new furniture. Every branch dispatches to a piece this package
+ * already had: `Code` for a tool's arguments and its output, `Step` for the call
+ * itself, `Failure` for an error, `Sources` for citations, `ArtifactCard` for a
+ * produced thing. That is the whole reason a typed renderer belongs here rather
+ * than in each surface — the parts were already drawn, one per surface, with no
+ * agreement about which part got which drawing.
+ *
+ * MARKDOWN IS STILL NOT HERE. `prose` is where a surface's pipeline enters, and
+ * with none supplied the words render plainly. 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 no parser and takes the rendered nodes.
+ */
+const gui_1 = require("@hanzo/gui");
+const lucide_icons_2_1 = require("@hanzogui/lucide-icons-2");
+const Pane_1 = require("../agents/Pane.cjs");
+const ink_1 = require("../backends/gui/ink.cjs");
+const slot_1 = require("../backends/gui/slot.cjs");
+const Code_1 = require("./Code.cjs");
+const Failure_1 = require("./Failure.cjs");
+const Preview_1 = require("./Preview.cjs");
+const Sources_1 = require("./Sources.cjs");
+const Step_1 = require("./Step.cjs");
+/**
+ * Adjacent prose, put back together.
+ *
+ * The wire splits a sentence across parts — and mid-word, which is why `words`
+ * joins with no separator — so drawing each text part as its own block would
+ * break one paragraph into a dozen and hand a markdown parser fragments that are
+ * not markdown. Runs of `text` and runs of `reasoning` each collapse to one;
+ * everything else passes through untouched and in order.
+ *
+ * This is what makes `Parts` a strict improvement on `words` rather than a
+ * different-looking one: an all-text turn renders exactly the string `words`
+ * would have produced.
+ */
+function join(parts) {
+    const out = [];
+    for (const part of parts) {
+        const last = out[out.length - 1];
+        if ((part.type === 'text' || part.type === 'reasoning') &&
+            last &&
+            last.type === part.type) {
+            out[out.length - 1] = { type: part.type, text: last.text + part.text };
+            continue;
+        }
+        out.push(part);
+    }
+    return out;
+}
+/**
+ * What a tool was asked, or answered, as text.
+ *
+ * The wire sends JSON, so a caller holding the parsed object should not have to
+ * re-serialise it at every call site — that is six copies of two lines. The
+ * fallback exists because this takes `unknown` and a value that cannot be
+ * serialised must not take the page down with it.
+ */
+const show = (value) => {
+    if (value == null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+};
+exports.show = show;
+/** A size a person can read. Every surface writes this one; here it is once. */
+const weigh = (bytes) => {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let n = bytes;
+    let i = 0;
+    while (n >= 1024 && i < units.length - 1) {
+        n /= 1024;
+        i += 1;
+    }
+    return `${i === 0 ? n : n.toFixed(1)} ${units[i]}`;
+};
+/**
+ * One part.
+ *
+ * It spreads no residual props and owns no box, which is the one place this
+ * package's house rule does not apply: a piece IS whichever component its type
+ * names, and giving it a wrapper of its own would put an anonymous div between
+ * every part and the column that spaces them. `Parts` is the box.
+ *
+ * Named `Piece` and not `Part` because `Part` is already the name of `words`'s
+ * open wire type on this barrel, and a module cannot export one name as both a
+ * type and a value.
+ */
+function Piece({ part, prose, onRetry, onOpen, onSource }) {
+    switch (part.type) {
+        case 'text':
+            return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: prose ? prose(part.text, part) : (0, ink_1.ink)(part.text) });
+        case 'reasoning':
+            // Dimmed rather than recoloured: a surface's markdown paints its own
+            // colours, and a token on the container would not reach inside them.
+            return ((0, jsx_runtime_1.jsx)(gui_1.YStack, { ...(0, slot_1.slot)('reasoning'), opacity: 0.72, children: prose ? prose(part.text, part) : (0, ink_1.ink)(part.text) }));
+        case 'toolCall':
+            return ((0, jsx_runtime_1.jsx)(Step_1.Step, { name: part.name, status: "running", detail: part.id, children: part.args == null ? undefined : (0, jsx_runtime_1.jsx)(Code_1.Code, { language: "json", children: (0, exports.show)(part.args) }) }));
+        case 'toolResult':
+            return ((0, jsx_runtime_1.jsx)(Step_1.Step, { name: part.name, status: part.status ?? 'done', detail: part.id, children: part.result == null ? undefined : (0, jsx_runtime_1.jsx)(Code_1.Code, { language: "json", children: (0, exports.show)(part.result) }) }));
+        case 'image':
+            return ((0, jsx_runtime_1.jsx)(gui_1.YStack, { ...(0, slot_1.slot)('image'), maxW: 420, rounded: "$4", overflow: "hidden", borderWidth: 1, borderColor: "$borderColor", children: (0, jsx_runtime_1.jsx)(gui_1.Image, { src: part.url, alt: part.alt ?? '', style: { width: '100%', height: 'auto', display: 'block' } }) }));
+        case 'file':
+            return ((0, jsx_runtime_1.jsxs)(gui_1.XStack, { ...(0, slot_1.slot)('file'), items: "center", gap: "$2", maxW: 420, px: "$2.5", py: "$2", rounded: "$4", borderWidth: 1, borderColor: "$borderColor", bg: "$panel", children: [(0, jsx_runtime_1.jsx)(lucide_icons_2_1.Paperclip, { size: 13, color: "$quiet" }), (0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$2", color: "$ink", numberOfLines: 1, flex: 1, children: part.name }), part.size == null ? null : ((0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$1", color: "$quiet", children: weigh(part.size) }))] }));
+        case 'citation':
+            return (0, jsx_runtime_1.jsx)(Sources_1.Sources, { sources: part.sources, onOpen: onSource });
+        case 'artifact':
+            // Held, so shown. `Preview` renders it with scripting disabled, which is
+            // what makes drawing model-authored markup a different question from
+            // loading a `uiResource`'s url — see that arm, and `Preview`'s own note.
+            return part.markup ? ((0, jsx_runtime_1.jsx)(Preview_1.Preview, { title: part.title, markup: part.markup })) : ((0, jsx_runtime_1.jsx)(Pane_1.ArtifactCard, { title: part.title, kind: part.kind, onOpen: onOpen ? () => onOpen(part) : undefined }));
+        case 'uiResource':
+            return ((0, jsx_runtime_1.jsx)(Step_1.Step, { name: part.uri, detail: part.mime, children: part.text ? (0, jsx_runtime_1.jsx)(Code_1.Code, { language: part.mime ?? 'text', children: part.text }) : undefined }));
+        case 'error':
+            return (0, jsx_runtime_1.jsx)(Failure_1.Failure, { onRetry: onRetry, children: part.text });
+        default: {
+            // The union is closed and the WIRE is not, which is the one place those
+            // two facts have to meet. A part this does not know contributes its text
+            // and nothing else — the same answer `words` gives, so nothing a surface
+            // sends can go missing without also having been missing before.
+            const unknown = part;
+            return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: unknown.text ? (0, ink_1.ink)(unknown.text) : null });
+        }
+    }
+}
+/** A turn's parts, in order, spaced. Goes in a `Message`'s children — `Chat`
+ *  puts it there for a turn whose content is a list. */
+function Parts({ parts, prose, onRetry, onOpen, onSource, ...props }) {
+    return ((0, jsx_runtime_1.jsx)(gui_1.YStack, { ...(0, slot_1.slot)('parts'), width: "100%", gap: "$2", ...props, children: join(parts).map((part, i) => ((0, jsx_runtime_1.jsx)(Piece, { part: part, prose: prose, onRetry: onRetry, onOpen: onOpen, onSource: onSource }, `${part.type}-${i}`))) }));
+}

package/dist/chat/Parts.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Parts — a streamed turn, drawn by what each piece of it IS.
+ *
+ * A completion's content is a list of parts, and until now this package had one
+ * answer for all of them: `words` flattens the list to prose and DROPS every
+ * part that is not text. An image, a tool call, a citation, an artifact — all of
+ * it arrived on the wire and none of it reached the screen. Six surfaces wrote
+ * six switch statements over the same union to get it back.
+ *
+ * `MessagePart` is that union, closed, and `Parts` is the dispatcher over it.
+ * Closed is the decision: `words`'s `Part` stays OPEN because it reads the wire
+ * and must survive a type it has never heard of, while this one is the CANON —
+ * the set a surface can exhaustively handle, and the set this package promises
+ * to draw. A part whose `type` is outside it still contributes its text, exactly
+ * as `words` does, so an unknown part degrades to prose instead of vanishing.
+ *
+ * Nothing here is new furniture. Every branch dispatches to a piece this package
+ * already had: `Code` for a tool's arguments and its output, `Step` for the call
+ * itself, `Failure` for an error, `Sources` for citations, `ArtifactCard` for a
+ * produced thing. That is the whole reason a typed renderer belongs here rather
+ * than in each surface — the parts were already drawn, one per surface, with no
+ * agreement about which part got which drawing.
+ *
+ * MARKDOWN IS STILL NOT HERE. `prose` is where a surface's pipeline enters, and
+ * with none supplied the words render plainly. 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 no parser and takes the rendered nodes.
+ */
+import { YStack } from '@hanzo/gui';
+import type { ComponentProps, ReactNode } from 'react';
+import { type ArtifactKind } from '../agents/Pane.js';
+import { type Source } from './Sources.js';
+import { type Ran } from './Step.js';
+/**
+ * One piece of a turn — the canonical set.
+ *
+ * Every member carries `type` and an optional `text`, which is what keeps
+ * `MessagePart[]` assignable to `words`'s `Part[]`: the same list answers "what
+ * was said" and "what is on screen" with no conversion between them.
+ *
+ * `toolCall` and `toolResult` are two states of one thing, not two things that
+ * arrive together — a streaming turn UPDATES the part in place as the result
+ * lands. A surface that appends both instead will see two steps, which is an
+ * honest picture of what it appended.
+ */
+export type MessagePart = 
+/** Prose. */
+{
+    type: 'text';
+    text: string;
+}
+/** Prose the model wrote while working, shown quieter than the answer. */
+ | {
+    type: 'reasoning';
+    text: string;
+}
+/** A tool the model asked for, and what it asked with. */
+ | {
+    type: 'toolCall';
+    name: string;
+    id?: string;
+    args?: unknown;
+    text?: string;
+}
+/** What the tool answered. `status` says how it went; absent means it landed. */
+ | {
+    type: 'toolResult';
+    name: string;
+    id?: string;
+    status?: Ran;
+    result?: unknown;
+    text?: string;
+} | {
+    type: 'image';
+    url: string;
+    alt?: string;
+    text?: string;
+} | {
+    type: 'file';
+    name: string;
+    url?: string;
+    mime?: string;
+    size?: number;
+    text?: string;
+}
+/** What the answer was drawn from. */
+ | {
+    type: 'citation';
+    sources: Source[];
+    text?: string;
+}
+/**
+ * Something the turn produced and the surface can open.
+ *
+ * `markup` is the thing ITSELF — a self-contained HTML document the model
+ * wrote — and when it is there the part draws as a `Preview` rather than as a
+ * card, because a card offering to open a thing we are holding is a worse
+ * answer than showing it. Absent, the card is all there is to draw.
+ */
+ | {
+    type: 'artifact';
+    title: string;
+    kind: ArtifactKind;
+    id?: string;
+    markup?: string;
+    text?: string;
+}
+/**
+ * A resource the model offers as an interface.
+ *
+ * Named and shown as source, never RUN. Executing a remote document inside the
+ * host page is the whole of cross-site scripting, and a component library
+ * cannot make that call for its consumers — a surface with a sandbox to run it
+ * in renders it itself, which is a decision it takes where its policy lives.
+ */
+ | {
+    type: 'uiResource';
+    uri: string;
+    mime?: string;
+    text?: string;
+}
+/** The turn did not arrive. */
+ | {
+    type: 'error';
+    text: string;
+};
+/**
+ * Adjacent prose, put back together.
+ *
+ * The wire splits a sentence across parts — and mid-word, which is why `words`
+ * joins with no separator — so drawing each text part as its own block would
+ * break one paragraph into a dozen and hand a markdown parser fragments that are
+ * not markdown. Runs of `text` and runs of `reasoning` each collapse to one;
+ * everything else passes through untouched and in order.
+ *
+ * This is what makes `Parts` a strict improvement on `words` rather than a
+ * different-looking one: an all-text turn renders exactly the string `words`
+ * would have produced.
+ */
+export declare function join(parts: readonly MessagePart[]): MessagePart[];
+/**
+ * What a tool was asked, or answered, as text.
+ *
+ * The wire sends JSON, so a caller holding the parsed object should not have to
+ * re-serialise it at every call site — that is six copies of two lines. The
+ * fallback exists because this takes `unknown` and a value that cannot be
+ * serialised must not take the page down with it.
+ */
+export declare const show: (value: unknown) => string;
+/** The controls a part can offer. Callbacks-out, as everything here is: the part
+ *  is data and knows nothing about what opening it means. */
+export interface PartActions {
+    /** Render prose. Absent, the words render plainly. */
+    prose?: (text: string, part: MessagePart) => ReactNode;
+    /** Run the turn again — an `error` part's control. Absent, none renders. */
+    onRetry?: () => void;
+    /** Open an `artifact` part. */
+    onOpen?: (part: Extract<MessagePart, {
+        type: 'artifact';
+    }>) => void;
+    /** Open one of a `citation` part's sources. */
+    onSource?: (source: Source) => void;
+}
+export interface PieceProps extends PartActions {
+    part: MessagePart;
+}
+/**
+ * One part.
+ *
+ * It spreads no residual props and owns no box, which is the one place this
+ * package's house rule does not apply: a piece IS whichever component its type
+ * names, and giving it a wrapper of its own would put an anonymous div between
+ * every part and the column that spaces them. `Parts` is the box.
+ *
+ * Named `Piece` and not `Part` because `Part` is already the name of `words`'s
+ * open wire type on this barrel, and a module cannot export one name as both a
+ * type and a value.
+ */
+export declare function Piece({ part, prose, onRetry, onOpen, onSource }: PieceProps): import("react").JSX.Element;
+export interface PartsProps extends PartActions, Omit<ComponentProps<typeof YStack>, 'children'> {
+    parts: readonly MessagePart[];
+}
+/** A turn's parts, in order, spaced. Goes in a `Message`'s children — `Chat`
+ *  puts it there for a turn whose content is a list. */
+export declare function Parts({ parts, prose, onRetry, onOpen, onSource, ...props }: PartsProps): import("react").JSX.Element;
+//# sourceMappingURL=Parts.d.ts.map

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

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

package/dist/chat/Parts.js

@@ -0,0 +1,153 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Parts — a streamed turn, drawn by what each piece of it IS.
+ *
+ * A completion's content is a list of parts, and until now this package had one
+ * answer for all of them: `words` flattens the list to prose and DROPS every
+ * part that is not text. An image, a tool call, a citation, an artifact — all of
+ * it arrived on the wire and none of it reached the screen. Six surfaces wrote
+ * six switch statements over the same union to get it back.
+ *
+ * `MessagePart` is that union, closed, and `Parts` is the dispatcher over it.
+ * Closed is the decision: `words`'s `Part` stays OPEN because it reads the wire
+ * and must survive a type it has never heard of, while this one is the CANON —
+ * the set a surface can exhaustively handle, and the set this package promises
+ * to draw. A part whose `type` is outside it still contributes its text, exactly
+ * as `words` does, so an unknown part degrades to prose instead of vanishing.
+ *
+ * Nothing here is new furniture. Every branch dispatches to a piece this package
+ * already had: `Code` for a tool's arguments and its output, `Step` for the call
+ * itself, `Failure` for an error, `Sources` for citations, `ArtifactCard` for a
+ * produced thing. That is the whole reason a typed renderer belongs here rather
+ * than in each surface — the parts were already drawn, one per surface, with no
+ * agreement about which part got which drawing.
+ *
+ * MARKDOWN IS STILL NOT HERE. `prose` is where a surface's pipeline enters, and
+ * with none supplied the words render plainly. 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 no parser and takes the rendered nodes.
+ */
+import { Image, SizableText, XStack, YStack } from '@hanzo/gui';
+import { Paperclip } from '@hanzogui/lucide-icons-2';
+import { ArtifactCard } from '../agents/Pane.js';
+import { ink } from '../backends/gui/ink.js';
+import { slot } from '../backends/gui/slot.js';
+import { Code } from './Code.js';
+import { Failure } from './Failure.js';
+import { Preview } from './Preview.js';
+import { Sources } from './Sources.js';
+import { Step } from './Step.js';
+/**
+ * Adjacent prose, put back together.
+ *
+ * The wire splits a sentence across parts — and mid-word, which is why `words`
+ * joins with no separator — so drawing each text part as its own block would
+ * break one paragraph into a dozen and hand a markdown parser fragments that are
+ * not markdown. Runs of `text` and runs of `reasoning` each collapse to one;
+ * everything else passes through untouched and in order.
+ *
+ * This is what makes `Parts` a strict improvement on `words` rather than a
+ * different-looking one: an all-text turn renders exactly the string `words`
+ * would have produced.
+ */
+export function join(parts) {
+    const out = [];
+    for (const part of parts) {
+        const last = out[out.length - 1];
+        if ((part.type === 'text' || part.type === 'reasoning') &&
+            last &&
+            last.type === part.type) {
+            out[out.length - 1] = { type: part.type, text: last.text + part.text };
+            continue;
+        }
+        out.push(part);
+    }
+    return out;
+}
+/**
+ * What a tool was asked, or answered, as text.
+ *
+ * The wire sends JSON, so a caller holding the parsed object should not have to
+ * re-serialise it at every call site — that is six copies of two lines. The
+ * fallback exists because this takes `unknown` and a value that cannot be
+ * serialised must not take the page down with it.
+ */
+export const show = (value) => {
+    if (value == null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+};
+/** A size a person can read. Every surface writes this one; here it is once. */
+const weigh = (bytes) => {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let n = bytes;
+    let i = 0;
+    while (n >= 1024 && i < units.length - 1) {
+        n /= 1024;
+        i += 1;
+    }
+    return `${i === 0 ? n : n.toFixed(1)} ${units[i]}`;
+};
+/**
+ * One part.
+ *
+ * It spreads no residual props and owns no box, which is the one place this
+ * package's house rule does not apply: a piece IS whichever component its type
+ * names, and giving it a wrapper of its own would put an anonymous div between
+ * every part and the column that spaces them. `Parts` is the box.
+ *
+ * Named `Piece` and not `Part` because `Part` is already the name of `words`'s
+ * open wire type on this barrel, and a module cannot export one name as both a
+ * type and a value.
+ */
+export function Piece({ part, prose, onRetry, onOpen, onSource }) {
+    switch (part.type) {
+        case 'text':
+            return _jsx(_Fragment, { children: prose ? prose(part.text, part) : ink(part.text) });
+        case 'reasoning':
+            // Dimmed rather than recoloured: a surface's markdown paints its own
+            // colours, and a token on the container would not reach inside them.
+            return (_jsx(YStack, { ...slot('reasoning'), opacity: 0.72, children: prose ? prose(part.text, part) : ink(part.text) }));
+        case 'toolCall':
+            return (_jsx(Step, { name: part.name, status: "running", detail: part.id, children: part.args == null ? undefined : _jsx(Code, { language: "json", children: show(part.args) }) }));
+        case 'toolResult':
+            return (_jsx(Step, { name: part.name, status: part.status ?? 'done', detail: part.id, children: part.result == null ? undefined : _jsx(Code, { language: "json", children: show(part.result) }) }));
+        case 'image':
+            return (_jsx(YStack, { ...slot('image'), maxW: 420, rounded: "$4", overflow: "hidden", borderWidth: 1, borderColor: "$borderColor", children: _jsx(Image, { src: part.url, alt: part.alt ?? '', style: { width: '100%', height: 'auto', display: 'block' } }) }));
+        case 'file':
+            return (_jsxs(XStack, { ...slot('file'), items: "center", gap: "$2", maxW: 420, px: "$2.5", py: "$2", rounded: "$4", borderWidth: 1, borderColor: "$borderColor", bg: "$panel", children: [_jsx(Paperclip, { size: 13, color: "$quiet" }), _jsx(SizableText, { size: "$2", color: "$ink", numberOfLines: 1, flex: 1, children: part.name }), part.size == null ? null : (_jsx(SizableText, { size: "$1", color: "$quiet", children: weigh(part.size) }))] }));
+        case 'citation':
+            return _jsx(Sources, { sources: part.sources, onOpen: onSource });
+        case 'artifact':
+            // Held, so shown. `Preview` renders it with scripting disabled, which is
+            // what makes drawing model-authored markup a different question from
+            // loading a `uiResource`'s url — see that arm, and `Preview`'s own note.
+            return part.markup ? (_jsx(Preview, { title: part.title, markup: part.markup })) : (_jsx(ArtifactCard, { title: part.title, kind: part.kind, onOpen: onOpen ? () => onOpen(part) : undefined }));
+        case 'uiResource':
+            return (_jsx(Step, { name: part.uri, detail: part.mime, children: part.text ? _jsx(Code, { language: part.mime ?? 'text', children: part.text }) : undefined }));
+        case 'error':
+            return _jsx(Failure, { onRetry: onRetry, children: part.text });
+        default: {
+            // The union is closed and the WIRE is not, which is the one place those
+            // two facts have to meet. A part this does not know contributes its text
+            // and nothing else — the same answer `words` gives, so nothing a surface
+            // sends can go missing without also having been missing before.
+            const unknown = part;
+            return _jsx(_Fragment, { children: unknown.text ? ink(unknown.text) : null });
+        }
+    }
+}
+/** A turn's parts, in order, spaced. Goes in a `Message`'s children — `Chat`
+ *  puts it there for a turn whose content is a list. */
+export function Parts({ parts, prose, onRetry, onOpen, onSource, ...props }) {
+    return (_jsx(YStack, { ...slot('parts'), width: "100%", gap: "$2", ...props, children: join(parts).map((part, i) => (_jsx(Piece, { part: part, prose: prose, onRetry: onRetry, onOpen: onOpen, onSource: onSource }, `${part.type}-${i}`))) }));
+}
+//# sourceMappingURL=Parts.js.map

package/dist/chat/Parts.js.map

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

package/dist/chat/Persona.cjs

@@ -0,0 +1,34 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clip = void 0;
+exports.Persona = Persona;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * Persona — a face on the canvas, and what it is doing.
+ *
+ * A persona is not a new engine. It is a MAPPING: an emotion names a clip, the
+ * clip goes to `Backdrop`'s `clips` mode, and that mode's preloaded crossfade
+ * does the switching it already does — one live frame over another, never a
+ * flash of black. So a mood change is a prop change, and there is exactly one
+ * piece of machinery playing video in this package rather than two.
+ *
+ * The mapping is the whole component, and it is deliberately thin. What an
+ * emotion MEANS — when a persona is listening, when it is thinking — belongs to
+ * whatever is driving the conversation; a component that guessed would be
+ * guessing from the one place with the least information.
+ *
+ * `idle` is required and every other emotion is optional, so a persona with one
+ * clip is a legal persona and adding a mood is adding a file. `clip` is pure and
+ * exported, which is what lets a surface preload the next mood, or test the
+ * mapping, without mounting anything.
+ */
+const Backdrop_1 = require("../backdrop/Backdrop.cjs");
+/** The clip for this emotion, falling back to idle. */
+const clip = (scenes, emotion) => scenes[emotion] ?? scenes.idle;
+exports.clip = clip;
+function Persona({ scenes, emotion = 'idle', ...props }) {
+    // One clip, so it loops itself rather than ending and handing over — a mood
+    // holds until something changes it, which is what a mood is.
+    return (0, jsx_runtime_1.jsx)(Backdrop_1.Backdrop, { ...props, mode: "clips", clips: [(0, exports.clip)(scenes, emotion)] });
+}

package/dist/chat/Persona.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Persona — a face on the canvas, and what it is doing.
+ *
+ * A persona is not a new engine. It is a MAPPING: an emotion names a clip, the
+ * clip goes to `Backdrop`'s `clips` mode, and that mode's preloaded crossfade
+ * does the switching it already does — one live frame over another, never a
+ * flash of black. So a mood change is a prop change, and there is exactly one
+ * piece of machinery playing video in this package rather than two.
+ *
+ * The mapping is the whole component, and it is deliberately thin. What an
+ * emotion MEANS — when a persona is listening, when it is thinking — belongs to
+ * whatever is driving the conversation; a component that guessed would be
+ * guessing from the one place with the least information.
+ *
+ * `idle` is required and every other emotion is optional, so a persona with one
+ * clip is a legal persona and adding a mood is adding a file. `clip` is pure and
+ * exported, which is what lets a surface preload the next mood, or test the
+ * mapping, without mounting anything.
+ */
+import { type BackdropProps } from '../backdrop/Backdrop.js';
+/** What a persona is doing. The set a conversation can actually report. */
+export type Emotion = 'idle' | 'listening' | 'thinking' | 'speaking' | 'happy' | 'sad' | 'surprised';
+/** Which clip plays for each emotion. `idle` is required: it is what plays when
+ *  a persona has nothing for the emotion at hand, so there is always something
+ *  on the canvas and never a gap to design around. */
+export type Scenes = {
+    idle: string;
+} & Partial<Record<Emotion, string>>;
+/** The clip for this emotion, falling back to idle. */
+export declare const clip: (scenes: Scenes, emotion: Emotion) => string;
+export interface PersonaProps extends Omit<BackdropProps, 'mode' | 'clips'> {
+    scenes: Scenes;
+    /** What the persona is doing right now. Defaults to idle. */
+    emotion?: Emotion;
+}
+export declare function Persona({ scenes, emotion, ...props }: PersonaProps): import("react").JSX.Element;
+//# sourceMappingURL=Persona.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Persona.d.ts","sourceRoot":"","sources":["../../src/chat/Persona.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEnE,2EAA2E;AAC3E,MAAM,MAAM,OAAO,GACf,MAAM,GACN,WAAW,GACX,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,WAAW,CAAA;AAEf;;sDAEsD;AACtD,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AAExE,uDAAuD;AACvD,eAAO,MAAM,IAAI,WAAY,MAAM,WAAW,OAAO,KAAG,MAAwC,CAAA;AAEhG,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IACzE,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,OAAgB,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,+BAI3E"}