@poodle64/librarian 2026.10.3 → 2026.10.5

package/dist/components/agent-transcript/agent-transcript.svelte

@@ -15,6 +15,8 @@
 <script lang="ts">
 	import CheckIcon from '@lucide/svelte/icons/check';
 	import CopyIcon from '@lucide/svelte/icons/copy';
+	import PencilIcon from '@lucide/svelte/icons/pencil';
+	import FileTextIcon from '@lucide/svelte/icons/file-text';
 	import RefreshCwIcon from '@lucide/svelte/icons/refresh-cw';
 	import {
 		outcomeLine,
@@ -33,7 +35,10 @@
 		splitSources,
 		type Citation
 	} from '../../citations';
-	import { DEFAULT_PERSONA, personaName, resolveCopy, type ChatCopy } from '../../copy';
+	import { DEFAULT_PERSONA, fill, personaName, resolveCopy, type ChatCopy } from '../../copy';
+	import { webKey, webSources } from '../../web-sources';
+	import { newestPerName, writtenKey, type Written, type WrittenUrl } from '../../written';
+	import type { Visual } from '../../visuals';
 	import type { Verdict } from '../../chat.svelte';
 	import AnswerMark from '../answer-mark/answer-mark.svelte';
 	import AnswerShare from '../answer-share/answer-share.svelte';
@@ -41,7 +46,8 @@
 	import ActivityGroup from '../activity-group/activity-group.svelte';
 	import ArtefactCard from '../artefact-card/artefact-card.svelte';
 	import Markdown from '../markdown/markdown.svelte';
-	import SourceList from '../source-list/source-list.svelte';
+	import SourceFold from '../source-fold/source-fold.svelte';
+	import WrittenCard from '../written-card/written-card.svelte';
 
 	/** Everything one turn renders from: what `Conversation` hands a host's
 	 *  own `turn` snippet, so it can render this component or its own. */
@@ -76,6 +82,23 @@
 		onopenartefact?: () => void;
 		/** The persona's own words for its tools, and what they read. */
 		describeTool?: DescribeTool;
+		/** The names of the files that went with the question, shown as chips. */
+		files?: string[];
+		/** Replaces this question with `text` and asks it again from here
+		 *  (`Chat.edit`), resolving false when that did not go through. Omit
+		 *  and no edit control renders: not while an answer is being written. */
+		onedit?: (text: string) => Promise<boolean>;
+		/** The documents the persona wrote answering it, carded under the answer. */
+		written?: Written[];
+		/** The version the reading column shows now, by `writtenKey`. */
+		showingWritten?: string;
+		/** Opens a version in the reading column. Omit and the cards only link. */
+		onopenwritten?: (written: Written) => void;
+		/** Where a version downloads. Omit and no download links render. */
+		writtenUrl?: WrittenUrl;
+		/** Renderers by a fence's language: a block of one is drawn by its
+		 *  component in the answer. Absent, every fence is code. */
+		visuals?: Record<string, Visual>;
 		/** When an answer this page did not start began, epoch ms: it is still
 		 *  being written, and the clock counts from then. */
 		answering?: number;
@@ -111,6 +134,13 @@
 		artefactOpen = false,
 		onopenartefact,
 		describeTool,
+		files = [],
+		onedit,
+		written = [],
+		showingWritten,
+		onopenwritten,
+		writtenUrl,
+		visuals,
 		answering,
 		onmark,
 		shared,
@@ -183,6 +213,51 @@
 
 	const hasAnswer = $derived(texts.length > 0);
 
+	// Pages the answer drew on, once it has settled: a link still being typed
+	// is not a source. They are numbered on from the library's, and a link to
+	// one reads as the same chip.
+	const web = $derived.by(() => {
+		if (running) return [];
+		const from = Math.max(0, ...sources.map((c) => c.n));
+		return webSources(blocks, answer).map((page, i) => ({ ...page, n: from + i + 1 }));
+	});
+	const webNumbers = $derived(new Map(web.map((page) => [webKey(page.url), page.n])));
+
+	// Which day the pages were read: today only for a turn asked today.
+	const readWhen = $derived.by(() => {
+		if (at === undefined) return '';
+		const when = new Date(at);
+		if (new Date().toDateString() === when.toDateString()) return words.readToday;
+		return fill(words.readOn, {
+			date: when.toLocaleDateString(undefined, { day: 'numeric', month: 'short', year: 'numeric' })
+		});
+	});
+
+	const cards = $derived(newestPerName(written));
+
+	const fileType = (file: string): string => {
+		const ext = /\.([A-Za-z0-9]{1,5})$/.exec(file)?.[1];
+		return ext ? ext.toUpperCase() : '';
+	};
+
+	let editing = $state(false);
+	let edited = $state('');
+	let sending = $state(false);
+
+	function startEdit() {
+		edited = asked;
+		editing = true;
+	}
+
+	async function sendEdit() {
+		const text = edited.trim();
+		if (!text || !onedit || sending) return;
+		sending = true;
+		const sent = await onedit(text);
+		sending = false;
+		if (sent) editing = false;
+	}
+
 	/**
 	 * What went wrong, if anything did — in words, whether or not the run gave
 	 * any.
@@ -251,12 +326,57 @@
 	     VS Code-style panel: this surface is read by people who arrive with
 	     those two as their model of what a chat looks like. A session whose
 	     stream never carried its prompt has no words to put here. -->
-	{#if asked}
+	{#if asked && editing}
+		<form
+			class="ds-lib-ask ds-lib-edit"
+			onsubmit={(event) => {
+				event.preventDefault();
+				void sendEdit();
+			}}
+		>
+			<textarea
+				class="ds-lib-edit-text"
+				rows="3"
+				aria-label={words.editQuestion}
+				bind:value={edited}
+			></textarea>
+			{#if files.length > 0}<p class="ds-lib-edit-note">{words.editFilesNote}</p>{/if}
+			<div class="ds-lib-edit-actions">
+				<button type="button" class="ds-lib-action" onclick={() => (editing = false)}>
+					{words.cancel}
+				</button>
+				<button type="submit" class="ds-lib-action" disabled={!edited.trim() || sending}>
+					{words.editSend}
+				</button>
+			</div>
+		</form>
+	{:else if asked}
 		<div class="ds-lib-ask">
-			<div class="ds-lib-bubble">{asked}</div>
-			{#if clock}
-				<time class="ds-lib-ask-time" datetime={clock.iso}>{clock.text}</time>
+			{#if files.length > 0}
+				<ul class="ds-lib-ask-files">
+					{#each files as file, i (i)}
+						<li class="ds-lib-ask-file">
+							<span class="ds-lib-ask-file-icon" aria-hidden="true"><FileTextIcon size={16} /></span>
+							<span class="ds-lib-ask-file-text">
+								<span class="ds-lib-ask-file-name">{file}</span>
+								{#if fileType(file)}<span class="ds-lib-ask-file-type">{fileType(file)}</span>{/if}
+							</span>
+						</li>
+					{/each}
+				</ul>
 			{/if}
+			<div class="ds-lib-bubble">{asked}</div>
+			<div class="ds-lib-ask-meta">
+				{#if onedit && !running}
+					<button type="button" class="ds-lib-action" onclick={startEdit}>
+						<PencilIcon size={14} />
+						<span>{words.editQuestion}</span>
+					</button>
+				{/if}
+				{#if clock}
+					<time class="ds-lib-ask-time" datetime={clock.iso}>{clock.text}</time>
+				{/if}
+			</div>
 		</div>
 	{/if}
 
@@ -279,7 +399,12 @@
 
 		{#each segments as seg (seg.index)}
 			{#if seg.kind === 'activity'}
-				<ActivityGroup group={seg} live={running && seg.index === lastIndex} />
+				<ActivityGroup
+					group={seg}
+					live={running && seg.index === lastIndex}
+					{written}
+					copy={words}
+				/>
 			{:else if !isArtefact}
 				<Markdown
 					content={seg.index === lastTextIndex && split.citations.length > 0
@@ -287,7 +412,10 @@
 						: seg.text}
 					streaming={running && seg.index === lastIndex}
 					{collectionNames}
+					{visuals}
+					copy={words}
 					citationNumbers={numbers}
+					{webNumbers}
 					oncite={(n) => {
 						const found = sources.find((c) => c.n === n);
 						if (found) oncite?.(found);
@@ -300,8 +428,18 @@
 			<ArtefactCard {artefact} open={artefactOpen} onopen={onopenartefact} copy={words} />
 		{/if}
 
-		{#if !isArtefact && sources.length > 0}
-			<SourceList {sources} {words} {oncite} />
+		{#each cards as doc (writtenKey(doc))}
+			<WrittenCard
+				written={doc}
+				open={showingWritten === writtenKey(doc)}
+				onopen={onopenwritten ? () => onopenwritten(doc) : undefined}
+				url={writtenUrl}
+				copy={words}
+			/>
+		{/each}
+
+		{#if !isArtefact && (sources.length > 0 || web.length > 0)}
+			<SourceFold library={sources} {web} {words} {oncite} {readWhen} />
 		{/if}
 
 		<!-- An empty `notHeld` is a host whose persona answers from no sources,
@@ -395,6 +533,84 @@
 		white-space: pre-wrap;
 	}
 
+	.ds-lib-ask-meta {
+		display: flex;
+		align-items: center;
+		gap: 0.5rem;
+	}
+
+	.ds-lib-ask-files {
+		display: flex;
+		flex-wrap: wrap;
+		justify-content: flex-end;
+		gap: 0.25rem;
+		margin: 0;
+		padding: 0;
+		list-style: none;
+	}
+
+	.ds-lib-ask-file {
+		display: flex;
+		max-width: 100%;
+		align-items: center;
+		gap: 0.625rem;
+		border: 1px solid var(--ds-color-border);
+		border-radius: var(--ds-radius-full);
+		padding: 0.375rem 0.875rem 0.375rem 0.5rem;
+	}
+
+	.ds-lib-ask-file-icon {
+		display: flex;
+		flex: none;
+		color: var(--ds-color-muted-foreground);
+	}
+
+	.ds-lib-ask-file-text {
+		display: flex;
+		min-width: 0;
+		flex-direction: column;
+		font-size: var(--ds-text-2xs);
+		line-height: 1.25;
+	}
+
+	.ds-lib-ask-file-name {
+		color: var(--ds-color-foreground);
+		font-size: 0.8125rem;
+		font-weight: 600;
+		overflow-wrap: anywhere;
+	}
+
+	.ds-lib-ask-file-type {
+		color: var(--ds-color-muted-foreground);
+	}
+
+	.ds-lib-edit {
+		align-items: stretch;
+	}
+
+	.ds-lib-edit-text {
+		width: 100%;
+		resize: vertical;
+		border: 1px solid var(--ds-color-border);
+		border-radius: var(--ds-radius-lg);
+		background: var(--ds-color-surface-1);
+		padding: 0.5rem 0.75rem;
+		color: var(--ds-color-foreground);
+		font: inherit;
+	}
+
+	.ds-lib-edit-note {
+		margin: 0;
+		color: var(--ds-color-muted-foreground);
+		font-size: var(--ds-text-2xs);
+	}
+
+	.ds-lib-edit-actions {
+		display: flex;
+		justify-content: flex-end;
+		gap: 0.25rem;
+	}
+
 	.ds-lib-ask-time,
 	.ds-lib-answer-time {
 		color: var(--ds-color-muted-foreground);

package/dist/components/agent-transcript/agent-transcript.svelte.d.ts

@@ -1,6 +1,8 @@
 import { type Artefact, type Block, type DescribeTool, type Outcome } from '../../transcript.svelte';
 import { type Citation } from '../../citations';
 import { type ChatCopy } from '../../copy';
+import { type Written, type WrittenUrl } from '../../written';
+import type { Visual } from '../../visuals';
 import type { Verdict } from '../../chat.svelte';
 /** Everything one turn renders from: what `Conversation` hands a host's
  *  own `turn` snippet, so it can render this component or its own. */
@@ -35,6 +37,23 @@ export interface AgentTranscriptProps {
     onopenartefact?: () => void;
     /** The persona's own words for its tools, and what they read. */
     describeTool?: DescribeTool;
+    /** The names of the files that went with the question, shown as chips. */
+    files?: string[];
+    /** Replaces this question with `text` and asks it again from here
+     *  (`Chat.edit`), resolving false when that did not go through. Omit
+     *  and no edit control renders: not while an answer is being written. */
+    onedit?: (text: string) => Promise<boolean>;
+    /** The documents the persona wrote answering it, carded under the answer. */
+    written?: Written[];
+    /** The version the reading column shows now, by `writtenKey`. */
+    showingWritten?: string;
+    /** Opens a version in the reading column. Omit and the cards only link. */
+    onopenwritten?: (written: Written) => void;
+    /** Where a version downloads. Omit and no download links render. */
+    writtenUrl?: WrittenUrl;
+    /** Renderers by a fence's language: a block of one is drawn by its
+     *  component in the answer. Absent, every fence is code. */
+    visuals?: Record<string, Visual>;
     /** When an answer this page did not start began, epoch ms: it is still
      *  being written, and the clock counts from then. */
     answering?: number;