@hanzo/rooms 0.1.11 → 0.1.12

package/dist/Drive.js

@@ -1,26 +1,24 @@
 'use client';
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { ArrowRight, ChevronDown, ChevronRight, Clock, Cloud, Download, File as FileIcon, FileArchive, FileAudio, FileCode, FileImage, FileText, FileVideo, Folder, FolderInput, FolderPlus, HardDrive, LayoutGrid, List, MoreHorizontal, PanelLeft, Plus, Search, Trash2, Upload, } from 'lucide-react';
+import { ArrowRight, ChevronDown, ChevronRight, Clock, Cloud, Download, File as FileIcon, FileArchive, FileAudio, FileCode, FileImage, FileText, FileVideo, Folder, FolderInput, FolderPlus, HardDrive, ListTree, MessageSquare, LayoutGrid, List, MoreHorizontal, PanelLeft, Plus, Search, Trash2, Upload, } from 'lucide-react';
 import { Box, Button, Text, View, XStack, YStack } from '@hanzo/ui';
 import { useIam, useOrganizations } from '@hanzo/iam/react';
 import { useAi } from './lib/ai.js';
-import { useOpen } from './open.js';
+import { empty, useOpen } from './open.js';
+import { attach, channel } from './pane.js';
+import { useRooms } from './host.js';
+import { Badge, Contents, Hits } from './Contents.js';
+import { weigh as size } from './lib/attach.js';
+import { dropped, filesIn, forget, pool, register, search, settled, slug, upload, } from './lib/files.js';
 import { checkoutUrl } from './lib/pay.js';
 import { BAD, mix } from './lib/mix.js';
 const blame = (e) => {
     const text = e instanceof Error ? e.message : String(e ?? '');
     return text || 'The store did not say what went wrong.';
 };
-/** Format byte count nicely */
-const weigh = (bytes) => {
-    if (!bytes)
-        return '—';
-    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
-    const step = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1);
-    const size = bytes / 1024 ** step;
-    return `${size < 10 && step > 0 ? size.toFixed(1) : Math.round(size)} ${units[step]}`;
-};
+/** A size as a row shows it; nothing is a dash. */
+const weigh = (bytes) => (bytes ? size(bytes) : '—');
 /** Format timestamp */
 const when = (stamp) => {
     if (!stamp)
@@ -36,11 +34,6 @@ const when = (stamp) => {
 };
 /** The store publishes a bucket's own display name; the slug is the fallback. */
 const getBucketDisplayName = (b) => (typeof b === 'string' ? b : b?.displayName || b?.name) || 'Drive';
-const bucketName = (workspace) => workspace
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-    .slice(0, 40) || 'hanzo';
 const wire = (key) => key.split('/').map(encodeURIComponent).join('/');
 const objects = (bucket) => `/v1/s3/buckets/${encodeURIComponent(bucket)}/objects`;
 async function putBytes(client, bucket, key, body, type) {
@@ -121,9 +114,13 @@ export function Drive() {
     const { client } = useAi();
     const { user, isAuthenticated } = useIam();
     const ready = Boolean(client && isAuthenticated);
-    const { bucket, openBucket } = useOpen();
+    const { bucket, openBucket, room } = useOpen();
+    const { router } = useRooms();
     const { currentOrg } = useOrganizations();
     const workspace = currentOrg?.displayName || currentOrg?.name || 'hanzo';
+    // THE WORKSPACE'S BUCKET is the one named for the org: where a file put into a
+    // chat lands (lib/files `workspace`), so it is where Drive opens.
+    const home = currentOrg?.name ? slug(currentOrg.name) : null;
     const [navSection, setNavSection] = useState('my-drive');
     const [viewMode, setViewMode] = useState('list');
     const [searchQuery, setSearchQuery] = useState('');
@@ -143,6 +140,12 @@ export function Drive() {
     // What the drive actually holds, measured. There is no quota route, so there
     // is no quota drawn: a number nobody publishes would be a number invented.
     const [usage, setUsage] = useState(null);
+    // WHAT THE INDEX SAYS of each object in the open bucket, by key: queued,
+    // indexing (and which stage), ready, kept-not-indexed or failed.
+    const [index, setIndex] = useState(() => new Map());
+    // A search's passages, and the file whose contents are open beside the list.
+    const [hits, setHits] = useState(null);
+    const [contents, setContents] = useState(null);
     const fileInputRef = useRef(null);
     const folderInputRef = useRef(null);
     const dragCounter = useRef(0);
@@ -180,15 +183,80 @@ export function Drive() {
     // THE DRIVE IS A BUCKET THE ORG OWNS. It used to fall back to the literal
     // "my-drive", which is a nav label rather than a name the store answers to —
     // so every read 404'd and every write went nowhere.
-    const activeBucket = bucket || buckets?.[0]?.name || null;
+    const landing = (home && buckets?.some((b) => b.name === home) ? home : buckets?.[0]?.name) || null;
+    const activeBucket = bucket || landing;
     // YOU LAND IN THE DRIVE, not in a chooser. The root view lists buckets and
     // projects, and the toolbar's verbs all act on an OPEN bucket — so opening
     // the org's first one is what makes New, upload and the listing agree about
     // where they are. It is also what a drive does: the files, on arrival.
     useEffect(() => {
-        if (!bucket && buckets && buckets.length > 0)
-            openBucket(buckets[0].name);
-    }, [bucket, buckets, openBucket]);
+        if (!bucket && landing)
+            openBucket(landing);
+    }, [bucket, landing, openBucket]);
+    // THE INDEX'S WORD on this bucket's files, read again every few seconds while
+    // any of them is still moving through its stages.
+    useEffect(() => {
+        if (!ready || !client || !activeBucket) {
+            setIndex(new Map());
+            return;
+        }
+        let live = true;
+        let clock;
+        const pass = () => filesIn(client, activeBucket)
+            .then((list) => {
+            if (!live)
+                return;
+            setIndex(new Map(list.map((f) => [f.key, f])));
+            if (list.some((f) => !settled(f)))
+                clock = setTimeout(pass, 4000);
+        })
+            .catch(() => { });
+        void pass();
+        return () => {
+            live = false;
+            if (clock)
+                clearTimeout(clock);
+        };
+    }, [ready, client, activeBucket, reload]);
+    // SEARCH READS THE FILES, not just their names: three characters or more ask
+    // the index for the passages that match, beside the name filter.
+    useEffect(() => {
+        const q = searchQuery.trim();
+        if (!ready || !client || q.length < 3) {
+            setHits(null);
+            return;
+        }
+        let live = true;
+        const clock = setTimeout(() => {
+            search(client, q, 12)
+                .then((out) => live && setHits(out.passages ?? []))
+                .catch(() => live && setHits([]));
+        }, 400);
+        return () => {
+            live = false;
+            clearTimeout(clock);
+        };
+    }, [ready, client, searchQuery]);
+    /** Opens a file's contents beside the list, at a section when one is named. */
+    const showContents = useCallback((id, at) => {
+        const known = [...index.values()].find((f) => f.id === id);
+        if (known)
+            return setContents({ file: known, at });
+        if (!client)
+            return;
+        void client.http
+            .json({ path: `/v1/knowledge/files/${encodeURIComponent(id)}` })
+            .then((f) => setContents({ file: f, at }))
+            .catch((e) => setFailed(blame(e)));
+    }, [index, client]);
+    /** ASK IN CHAT: a new conversation with the file put into it, by reference. */
+    const askInChat = useCallback((f) => {
+        if (!client)
+            return;
+        empty();
+        attach(channel({ room, thread: null, agent: null }), [f], { api: client, org: currentOrg?.name ?? null });
+        router.push('/chat');
+    }, [client, room, currentOrg, router]);
     // WHAT IS AT THIS LEVEL. The store's listing takes `recursive`; passing
     // `delimiter` (S3's own word) is silently ignored, so a flat listing came
     // back and every folder read as a file.
@@ -252,21 +320,30 @@ export function Drive() {
             setBusy(null);
         }
     }, [client, activeBucket, busy]);
-    // UPLOAD is two calls and the bytes skip the platform: mint a presigned PUT,
-    // then send the file straight to the store. A PUT at the object's own address
-    // is not a route the platform has — that address mints URLs and deletes.
+    // UPLOAD skips the platform: the bytes go straight to the store through
+    // presigned PUTs — one for a small file, one per 16 MB part for a large one,
+    // resumed from the parts the store holds when a connection drops — several
+    // files at once. Each lands as a workspace file: registered with the index,
+    // which reads it into contents, passages and links.
     const handleUpload = useCallback((files) => {
         if (!files)
             return;
         const list = Array.from(files);
         if (!list.length || !client || !activeBucket)
             return;
-        void run(`Uploading ${list[0].name}`, async (say) => {
-            for (const file of list) {
-                say(`Uploading ${file.name}`);
-                const name = file.webkitRelativePath || file.name;
-                await putBytes(client, activeBucket, `${prefix}${name}`, file, file.type || undefined);
-            }
+        void run(`Uploading ${list.length === 1 ? list[0].name : `${list.length} files`}`, async (say) => {
+            const sent = new Map();
+            const total = list.reduce((n, f) => n + f.size, 0) || 1;
+            const tell = () => say(`Uploading ${list.length === 1 ? list[0].name : `${list.length} files`} — ${Math.floor(([...sent.values()].reduce((a, b) => a + b, 0) / total) * 100)}%`);
+            await pool(list, 3, async (file) => {
+                const f = file;
+                const key = `${prefix}${f.relative || f.webkitRelativePath || file.name}`;
+                await upload(client, activeBucket, key, file, (fraction) => {
+                    sent.set(file, fraction * file.size);
+                    tell();
+                });
+                await register(client, activeBucket, key);
+            });
         });
     }, [client, activeBucket, prefix, run]);
     const handleCreateFolder = useCallback((folderName) => {
@@ -296,18 +373,27 @@ export function Drive() {
         if (!client || !activeBucket)
             return;
         const key = `${prefix}${entry.key}`;
+        // A deleted file leaves the index too, so search and chat stop citing it.
+        const unindex = async (k) => {
+            const f = index.get(k);
+            if (f)
+                await forget(client, f.id).catch(() => { });
+        };
         void run(`Deleting ${entry.key}`, async (say) => {
-            if (!entry.isDir)
-                return remove(client, activeBucket, key);
+            if (!entry.isDir) {
+                await remove(client, activeBucket, key);
+                return unindex(key);
+            }
             const root = key.endsWith('/') ? key : `${key}/`;
             const out = await client.http.json({ path: objects(activeBucket), query: { prefix: root, recursive: 'true' } });
             for (const e of (out?.objects ?? []).filter((x) => !x.isDir)) {
                 say(`Deleting ${e.key}`);
                 await remove(client, activeBucket, root + e.key);
+                await unindex(root + e.key);
             }
             await remove(client, activeBucket, root).catch(() => { });
         });
-    }, [client, activeBucket, prefix, run]);
+    }, [client, activeBucket, prefix, run, index]);
     // DOWNLOAD follows a presigned GET. The object's platform address answers a
     // signed URL, not the bytes, and it needs the caller's token — which an
     // anchor href does not carry.
@@ -380,8 +466,8 @@ export function Drive() {
             e.stopPropagation();
             dragCounter.current = 0;
             setOver(false);
-            if (e.dataTransfer.files)
-                handleUpload(e.dataTransfer.files);
+            if (e.dataTransfer.files?.length)
+                void dropped(e.dataTransfer).then(handleUpload);
         }, children: [_jsx("input", { ref: fileInputRef, type: "file", multiple: true, hidden: true, onChange: (e) => {
                     handleUpload(e.target.files);
                     e.currentTarget.value = '';
@@ -435,7 +521,7 @@ export function Drive() {
                                                     setNaming(null);
                                                 if (e.key === 'Enter')
                                                     handleCreateFolder(naming.value);
-                                            }, placeholder: "Folder name", "aria-label": "Folder name" }), ...BARE }), _jsx(Button, { variant: "primary", size: "sm", onClick: () => handleCreateFolder(naming.value), children: "Create" }), _jsx(Button, { variant: "ghost", size: "sm", color: "$soft", onClick: () => setNaming(null), children: "Cancel" })] })) : null, busy ? (_jsxs(Text, { fontSize: "$2", color: "$soft", children: [busy, "\u2026"] })) : null, bucket || prefix ? (_jsx(YStack, { gap: "$2", children: _jsxs(YStack, { borderWidth: 1, borderColor: "$borderColor", rounded: 8, overflowX: "auto", overflowY: "hidden", children: [_jsxs(View, { display: "grid", gridTemplateColumns: FILES, minW: "min-content", px: 16, py: 10, borderBottomWidth: 1, borderColor: "$borderColor", children: [_jsx(Text, { ...HEAD, children: "NAME" }), _jsx(Text, { ...HEAD, children: "TYPE" }), _jsx(Text, { ...HEAD, children: "UPDATED \u2193" }), _jsx(Text, { ...HEAD, children: "SIZE" }), _jsx(View, {})] }), !filteredEntries || filteredEntries.length === 0 ? (_jsx(Text, { py: 36, px: 16, text: "center", fontSize: "$2", color: "$faint", children: "None" })) : (filteredEntries.map((e) => {
+                                            }, placeholder: "Folder name", "aria-label": "Folder name" }), ...BARE }), _jsx(Button, { variant: "primary", size: "sm", onClick: () => handleCreateFolder(naming.value), children: "Create" }), _jsx(Button, { variant: "ghost", size: "sm", color: "$soft", onClick: () => setNaming(null), children: "Cancel" })] })) : null, busy ? (_jsxs(Text, { fontSize: "$2", color: "$soft", "data-slot": "drive-busy", children: [busy, "\u2026"] })) : null, hits && hits.length ? _jsx(Hits, { hits: hits, onOpen: (p) => showContents(p.file.id, p.section.id) }) : null, bucket || prefix ? (_jsx(YStack, { gap: "$2", children: _jsxs(YStack, { borderWidth: 1, borderColor: "$borderColor", rounded: 8, overflowX: "auto", overflowY: "hidden", children: [_jsxs(View, { display: "grid", gridTemplateColumns: FILES, minW: "min-content", px: 16, py: 10, borderBottomWidth: 1, borderColor: "$borderColor", children: [_jsx(Text, { ...HEAD, children: "NAME" }), _jsx(Text, { ...HEAD, children: "TYPE" }), _jsx(Text, { ...HEAD, children: "UPDATED \u2193" }), _jsx(Text, { ...HEAD, children: "SIZE" }), _jsx(View, {})] }), !filteredEntries || filteredEntries.length === 0 ? (_jsx(Text, { py: 36, px: 16, text: "center", fontSize: "$2", color: "$faint", children: "None" })) : (filteredEntries.map((e) => {
                                             const isFolder = e.isDir || e.key.endsWith('/');
                                             const cleanName = e.key.replace(/\/+$/, '');
                                             return (_jsxs(View, { display: "grid", gridTemplateColumns: FILES, minW: "min-content", px: 16, py: 11, items: "center", cursor: "pointer", borderBottomWidth: 1, borderColor: "$borderColor", transition: "100ms", hoverStyle: { bg: '$hover' }, onClick: () => {
@@ -445,10 +531,16 @@ export function Drive() {
                                                     else {
                                                         handleDownload(e);
                                                     }
-                                                }, children: [_jsxs(XStack, { items: "center", gap: "$2.5", minW: 0, children: [_jsx(Glyph, { entry: e, size: 16 }), _jsx(Text, { ...NAME, children: cleanName })] }), _jsx(View, { items: "flex-start", children: _jsx(Text, { ...CHIP, children: isFolder ? 'Folder' : cleanName.split('.').pop()?.toUpperCase() || 'File' }) }), _jsx(Text, { ...CELL, children: when(e.lastModified) }), _jsx(Text, { ...CELL, children: weigh(e.size) }), _jsxs(View, { position: "relative", items: "flex-start", children: [_jsx(More, { onPress: (ev) => {
+                                                }, children: [_jsxs(XStack, { items: "center", gap: "$2.5", minW: 0, children: [_jsx(Glyph, { entry: e, size: 16 }), _jsxs(YStack, { minW: 0, children: [_jsx(Text, { ...NAME, children: cleanName }), !isFolder && index.get(prefix + e.key) ? _jsx(Badge, { f: index.get(prefix + e.key) }) : null] })] }), _jsx(View, { items: "flex-start", children: _jsx(Text, { ...CHIP, children: isFolder ? 'Folder' : cleanName.split('.').pop()?.toUpperCase() || 'File' }) }), _jsx(Text, { ...CELL, children: when(e.lastModified) }), _jsx(Text, { ...CELL, children: weigh(e.size) }), _jsxs(View, { position: "relative", items: "flex-start", children: [_jsx(More, { onPress: (ev) => {
                                                                     ev.stopPropagation();
                                                                     setItemMenuKey(itemMenuKey === e.key ? null : e.key);
-                                                                } }), itemMenuKey === e.key ? (_jsxs(YStack, { position: "absolute", r: 0, t: "100%", bg: "var(--popover)", borderWidth: 1, borderColor: "$borderColor", rounded: 8, boxShadow: "var(--shadow-lg)", z: "var(--z-dropdown)", p: 4, minW: 140, onClick: (ev) => ev.stopPropagation(), children: [!isFolder ? (_jsx(Pick, { icon: Download, label: "Download", onPress: () => {
+                                                                } }), itemMenuKey === e.key ? (_jsxs(YStack, { position: "absolute", r: 0, t: "100%", bg: "var(--popover)", borderWidth: 1, borderColor: "$borderColor", rounded: 8, boxShadow: "var(--shadow-lg)", z: "var(--z-dropdown)", p: 4, minW: 140, onClick: (ev) => ev.stopPropagation(), children: [!isFolder && index.get(prefix + e.key) ? (_jsxs(_Fragment, { children: [_jsx(Pick, { icon: ListTree, label: "Contents", onPress: () => {
+                                                                                    setItemMenuKey(null);
+                                                                                    setContents({ file: index.get(prefix + e.key) });
+                                                                                } }), _jsx(Pick, { icon: MessageSquare, label: "Ask in chat", onPress: () => {
+                                                                                    setItemMenuKey(null);
+                                                                                    askInChat(index.get(prefix + e.key));
+                                                                                } })] })) : null, !isFolder ? (_jsx(Pick, { icon: Download, label: "Download", onPress: () => {
                                                                             setItemMenuKey(null);
                                                                             handleDownload(e);
                                                                         } })) : null, _jsx(Pick, { icon: Trash2, label: "Delete", tone: BAD, onPress: () => {
@@ -462,5 +554,5 @@ export function Drive() {
                                                             const targetBucket = buckets[0]?.name || 'hanzo';
                                                             openBucket(targetBucket);
                                                             setPrefix(`projects/${p.name || p.id}/`);
-                                                        }, display: "grid", gridTemplateColumns: PROJECTS, minW: "min-content", px: 16, py: 11, items: "center", cursor: "pointer", borderBottomWidth: 1, borderColor: "$borderColor", transition: "100ms", hoverStyle: { bg: '$hover' }, children: [_jsxs(XStack, { items: "center", gap: "$2.5", minW: 0, children: [_jsx(Folder, { size: 16, color: "var(--foreground)" }), _jsx(Text, { ...NAME, children: p.name })] }), _jsx(View, { items: "flex-start", children: _jsx(Text, { ...CHIP, children: p.type }) }), _jsx(Text, { ...CELL, children: p.updated }), _jsx(Text, { ...CELL, children: p.size }), _jsx(View, { items: "flex-start", children: _jsx(More, { onPress: (e) => e.stopPropagation() }) })] }, p.id))))] })] })] }))] })] }), over ? (_jsx(Box, { position: "absolute", t: 0, l: 0, r: 0, b: 0, z: 1000, bg: VEIL, borderWidth: 2, borderStyle: "dashed", borderColor: "var(--ring)", rounded: "$3", display: "flex", items: "center", justify: "center", pointerEvents: "none", children: _jsxs(YStack, { items: "center", gap: "$2", children: [_jsx(Upload, { size: 36, color: "currentColor" }), _jsxs(Text, { fontSize: "$4", fontWeight: "600", color: "$ink", children: ["Drop files to upload to ", bucket || workspace] })] }) })) : null] }));
+                                                        }, display: "grid", gridTemplateColumns: PROJECTS, minW: "min-content", px: 16, py: 11, items: "center", cursor: "pointer", borderBottomWidth: 1, borderColor: "$borderColor", transition: "100ms", hoverStyle: { bg: '$hover' }, children: [_jsxs(XStack, { items: "center", gap: "$2.5", minW: 0, children: [_jsx(Folder, { size: 16, color: "var(--foreground)" }), _jsx(Text, { ...NAME, children: p.name })] }), _jsx(View, { items: "flex-start", children: _jsx(Text, { ...CHIP, children: p.type }) }), _jsx(Text, { ...CELL, children: p.updated }), _jsx(Text, { ...CELL, children: p.size }), _jsx(View, { items: "flex-start", children: _jsx(More, { onPress: (e) => e.stopPropagation() }) })] }, p.id))))] })] })] }))] })] }), contents && client ? (_jsx(Contents, { api: client, file: contents.file, at: contents.at, onClose: () => setContents(null), onAsk: askInChat, onFollow: (id, at) => showContents(id, at) })) : null, over ? (_jsx(Box, { position: "absolute", t: 0, l: 0, r: 0, b: 0, z: 1000, bg: VEIL, borderWidth: 2, borderStyle: "dashed", borderColor: "var(--ring)", rounded: "$3", display: "flex", items: "center", justify: "center", pointerEvents: "none", children: _jsxs(YStack, { items: "center", gap: "$2", children: [_jsx(Upload, { size: 36, color: "currentColor" }), _jsxs(Text, { fontSize: "$4", fontWeight: "600", color: "$ink", children: ["Drop files to upload to ", bucket || workspace] })] }) })) : null] }));
 }

package/dist/RightPane.d.ts

@@ -1,4 +1,4 @@
-import type { ChatMessage } from '@hanzo/ai/react';
+import { type ChatMessage } from '@hanzo/ai/react';
 /**
  * The column. `said` is the conversation it stands beside; without one it draws
  * the same shape with nothing in it, which is what a room nobody has spoken in

package/dist/RightPane.js

@@ -33,7 +33,11 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useMemo, useState } from 'react';
 import { ExternalLink, FileCode, Image as ImageMark, Paperclip, PanelRightClose, Plus, RotateCw, X, } from 'lucide-react';
 import { Box, DropdownMenu, DropdownMenuContent, DropdownMenuCheckboxItem, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, Text, View, XStack, YStack, } from '@hanzo/ui';
+import { useAi } from '@hanzo/ai/react';
 import { Card, Quiet, Row } from './card.js';
+import { said as told } from './lib/attach.js';
+import { download, fileOf } from './lib/files.js';
+import { org } from './lib/session.js';
 import { useOpen } from './open.js';
 import { address, channel, name as titleOf, openTab, pickTab, pin, shutTab, take, usePane, } from './pane.js';
 import { useProviders, useSkills } from './tools.js';
@@ -99,8 +103,13 @@ function outputs(said) {
     said.forEach((m, turn) => {
         if (m.role !== 'assistant')
             return;
+        // Files a turn carried by reference: their names in the turn, their bytes in the workspace.
+        const read = told(words(m));
+        for (const f of read.carried?.attached ?? []) {
+            out.push({ id: `sw${turn}.${f.id}`, name: f.name, kind: f.type.startsWith('image/') ? 'image' : 'file', file: f.id, mime: f.type });
+        }
         let n = 0;
-        for (const [, info, body] of words(m).matchAll(FENCE)) {
+        for (const [, info, body] of read.text.matchAll(FENCE)) {
             n += 1;
             const named = fenceName(info, n);
             out.push({
@@ -140,7 +149,7 @@ function sources(said, held) {
         }
     });
     for (const h of held) {
-        out.push({ id: h.id, name: h.name, kind: h.kind === 'image' ? 'image' : 'file', href: h.href, mime: h.type });
+        out.push({ id: h.id, name: h.name, kind: h.type.startsWith('image/') ? 'image' : 'file', href: h.href || undefined, file: h.file?.id, mime: h.type });
     }
     return out;
 }
@@ -183,12 +192,13 @@ function Summary({ at, said, held }) {
  * thirty is the kind of furniture this repo has had to delete twice.
  */
 function Marks({ at, kind, title, icon, marks, children, }) {
+    const ai = useAi();
     const [all, setAll] = useState(false);
     const shown = all ? marks : marks.slice(0, FEW);
     const rest = marks.length - shown.length;
     return (_jsxs(Card, { kind: kind, icon: icon, title: title, action: _jsx(Add, { at: at }), children: [marks.length === 0 ? _jsx(Quiet, { children: children }) : null, shown.map((m) => {
                 const Mark = GLYPH[m.kind];
-                return (_jsx(Row, { icon: _jsx(Mark, { size: 16, "aria-hidden": true }), onPress: () => look(at, m), children: m.name }, m.id));
+                return (_jsx(Row, { icon: _jsx(Mark, { size: 16, "aria-hidden": true }), onPress: () => void look(at, m, ai), children: m.name }, m.id));
             }), rest > 0 ? (_jsxs(Row, { onPress: () => setAll(true), children: ["Show ", rest, " more"] })) : all && marks.length > FEW ? (_jsx(Row, { onPress: () => setAll(false), children: "Show fewer" })) : null] }));
 }
 /**
@@ -200,7 +210,17 @@ function Marks({ at, kind, title, icon, marks, children, }) {
  * `index.html` something you can actually see rather than something you can
  * only read the source of.
  */
-function look(at, m) {
+async function look(at, m, api) {
+    if (!m.href && m.file) {
+        try {
+            const f = await fileOf(api, m.file);
+            openTab(at, await download(api, f.bucket, f.key), m.name);
+        }
+        catch {
+            // A file forgotten or a store unreachable opens nothing; the row stays.
+        }
+        return;
+    }
     const href = m.href ?? (m.body === undefined ? null : URL.createObjectURL(new Blob([m.body], { type: m.mime })));
     if (!href)
         return;
@@ -244,7 +264,8 @@ const Note = ({ children }) => (_jsx(DropdownMenuLabel, { children: _jsx(Text, {
  * and they put a skill one press away instead of two.
  */
 function Add({ at }) {
-    return (_jsxs(DropdownMenu, { placement: "bottom-end", maxHeight: 420, children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Box, { render: "button", "aria-label": "Add to this conversation", p: "$1", rounded: "$2", hoverStyle: { bg: '$hover' }, children: _jsx(Plus, { size: 16, "aria-hidden": true }) }) }), _jsxs(DropdownMenuContent, { align: "end", children: [_jsx(DropdownMenuItem, { onClick: () => take(at), children: _jsx(Word, { children: "Attach files" }) }), _jsx(DropdownMenuSeparator, {}), _jsx(Skills, {}), _jsx(DropdownMenuSeparator, {}), _jsx(Services, {})] })] }));
+    const ai = useAi();
+    return (_jsxs(DropdownMenu, { placement: "bottom-end", maxHeight: 420, children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Box, { render: "button", "aria-label": "Add to this conversation", p: "$1", rounded: "$2", hoverStyle: { bg: '$hover' }, children: _jsx(Plus, { size: 16, "aria-hidden": true }) }) }), _jsxs(DropdownMenuContent, { align: "end", children: [_jsx(DropdownMenuItem, { onClick: () => take(at, { api: ai, org: org() }), children: _jsx(Word, { children: "Attach files" }) }), _jsx(DropdownMenuSeparator, {}), _jsx(Skills, {}), _jsx(DropdownMenuSeparator, {}), _jsx(Services, {})] })] }));
 }
 /**
  * What this org's agents can reach for, as a section of this menu.

package/dist/lib/attach.d.ts

@@ -1,43 +1,50 @@
 /**
- * Files that go with a chat message.
+ * Files that go with a chat message — by REFERENCE.
  *
- * @hanzo/ai's `send(text, images)` carries a picture as an `image_url` part the
- * model reads, and nothing else rides that wire, so a file goes one of two
- * ways: an image as a `data:` URI beside the words, a text file as its own
- * words after the message, fenced under its name. Any other kind is refused by
- * name, before anything is held.
+ * A file put into a conversation is uploaded to the org's workspace and indexed
+ * there (`lib/files`). The turn carries what NAMES it — id, name, type, size —
+ * and the passages read from it for the question, each citing
+ * file › section › ¶n. No byte of the file rides the chat request, so there is
+ * no size a file must stay under to go with a message.
  *
- * This module judges and reads a file; `pane.ts` holds what it admits, per
- * conversation, for the composer's chips and the column's Sources alike.
+ * The names and the passages travel in one block after the words. The block is
+ * what the model reads; `said` takes it back off for drawing, so a person sees
+ * their words and the files' chips, never the passages.
  */
 import type { MessagePart } from '@hanzo/ui/chat';
-/** What a file contributes to a message once admitted. */
-export interface Admitted {
-    kind: 'image' | 'text';
-    /** A `data:` URI for an image, the words for a text file. */
-    data: string;
+import type { FileRef, Grounds } from './files.js';
+/** The files a turn reads: those put into it, and those carried from earlier turns. */
+export interface Carried {
+    attached: FileRef[];
+    reused: FileRef[];
 }
-/** A file as it goes with a message. */
-export type Going = Admitted & {
-    name: string;
-};
-export declare const IMAGE_MAX: number;
-export declare const TEXT_MAX: number;
-/** Which way a file goes with a message, or null when it cannot go. */
-export declare function kindOf(file: {
-    name: string;
-    type: string;
-}): Admitted['kind'] | null;
-/** A file read for a message, or the sentence that says why it cannot go. */
-export declare function admit(file: File): Promise<Admitted | string>;
+/** A size as a person reads it. */
+export declare function weigh(bytes: number): string;
 /**
- * The message as sent: the words, then each text file fenced with its name as
- * the info string — the shape a model writes a file in, and the one the
- * column's Sources reads back out of the turn. With no words and no text file,
- * the images' names, so the turn says what it carries.
+ * The message as sent: the words, then one block naming the files and holding
+ * what was read from them for this question.
+ *
+ * `why` says why there are no passages, when there are none — still indexing,
+ * stored without indexing, or the read failed — so the model says so rather
+ * than answering as though it had read the files.
+ */
+export declare function compose(text: string, carried: Carried, grounds: Grounds | null, why?: string): string;
+/** A turn read back: the words a person wrote, and the files it carried. */
+export interface Said {
+    text: string;
+    carried: Carried | null;
+    /** The citations the turn handed the model, numbered as it numbered them. */
+    cites: string[];
+}
+/** Takes the files block back off a turn, for drawing. */
+export declare function said(content: string): Said;
+/**
+ * Every file the conversation's turns have carried, once each, oldest first —
+ * what a later question in the same conversation reads again.
  */
-export declare function compose(text: string, files: readonly Going[]): string;
-/** The images of a message, as the URIs @hanzo/ai's `send` takes. */
-export declare const images: (files: readonly Going[]) => string[];
+export declare function carriedIn(turns: readonly {
+    role: string;
+    content?: unknown;
+}[]): FileRef[];
 /** A wire turn's parts — text and `image_url` — as the parts `@hanzo/ui/chat` draws. */
 export declare function partsOf(content: readonly unknown[]): MessagePart[];