@poodle64/librarian 2026.10.3 → 2026.10.4

package/dist/components/tool-row/tool-row.svelte

@@ -7,34 +7,40 @@
 
   The row says what the persona DID, in a reader's own words — never the
   tool's name or the raw command it ran: the host's `DescribeTool`, or the
-  package's own `describe()`. Expanding a settled row shows what came back,
-  never what was typed.
+  package's own `describe()`. Expanding it shows what went in and what came
+  back, the way Claude Code's own panel does.
 -->
 <script lang="ts">
 	import ChevronRightIcon from '@lucide/svelte/icons/chevron-right';
 	import { describe, type ToolBlock, type ToolWords } from '../../transcript.svelte';
+	import { resolveCopy, type ChatCopy } from '../../copy';
 
 	interface Props {
 		block: ToolBlock;
 		running: boolean;
-		/** Identical consecutive steps folded into this row — five pages of one
-		 *  document is one act of reading to a human. */
-		repeats?: number;
 		/** The call in the persona's words. Absent takes the package's own. */
 		words?: ToolWords;
+		copy?: Partial<ChatCopy>;
 	}
 
-	let { block, running, repeats = 1, words }: Props = $props();
+	let { block, running, words, copy }: Props = $props();
 	let open = $state(false);
 
+	const label = $derived(resolveCopy(copy));
 	const settled = $derived(block.result !== undefined);
 	const said = $derived(words ?? describe(block));
 	const tone = $derived(block.isError ? 'error' : settled ? 'success' : 'info');
-	const again = $derived(
-		said.repeat
-			? `· ${repeats} ${repeats === 1 ? said.repeat[0] : said.repeat[1]}`
-			: `× ${repeats}`
-	);
+	// Pretty while it parses; the raw text while it is still arriving.
+	const input = $derived.by(() => {
+		try {
+			const parsed: unknown = JSON.parse(block.rawInput);
+			return typeof parsed === 'object' && parsed !== null && Object.keys(parsed).length === 0
+				? ''
+				: JSON.stringify(parsed, null, 2);
+		} catch {
+			return block.rawInput;
+		}
+	});
 </script>
 
 <div class="ds-lib-tool">
@@ -42,23 +48,27 @@
 		type="button"
 		class="ds-lib-tool-row"
 		onclick={() => (open = !open)}
-		disabled={!settled}
 		aria-expanded={open}
 	>
 		<span class="ds-lib-tool-chevron" class:is-open={open}>
-			{#if settled}<ChevronRightIcon size={12} />{/if}
+			<ChevronRightIcon size={12} />
 		</span>
 		<span class="ds-lib-tool-dot" data-tone={tone} class:is-live={!settled && running}></span>
 		<span class="ds-lib-tool-said">
 			<span class="ds-lib-tool-verb">{said.verb}</span>
 			{#if said.object}<span class="ds-lib-tool-object">{said.object}</span>{/if}
-			{#if repeats > 1}<span>{again}</span>{/if}
 		</span>
+		{#if block.isError}<span class="ds-lib-tool-failed">{label.stepFailed}</span>{/if}
 	</button>
 
 	{#if open}
 		<div class="ds-lib-tool-body">
+			{#if input}
+				<p class="ds-lib-tool-label">{label.stepInput}</p>
+				<pre class="ds-lib-tool-result">{input}</pre>
+			{/if}
 			{#if block.result}
+				<p class="ds-lib-tool-label">{label.stepResult}</p>
 				<pre class="ds-lib-tool-result">{block.result}</pre>
 			{/if}
 		</div>
@@ -87,10 +97,6 @@
 		cursor: pointer;
 	}
 
-	.ds-lib-tool-row:disabled {
-		cursor: default;
-	}
-
 	.ds-lib-tool-chevron {
 		display: flex;
 		width: 0.75rem;
@@ -150,8 +156,8 @@
 	}
 
 	.ds-lib-tool-result {
-		margin-top: 0.25rem;
-		max-height: 18rem;
+		margin: 0.125rem 0 0;
+		max-height: 12rem;
 		overflow: auto;
 		color: var(--ds-color-muted-foreground);
 		font-family: var(--ds-font-code);
@@ -159,6 +165,20 @@
 		white-space: pre-wrap;
 	}
 
+	.ds-lib-tool-label {
+		margin: 0.25rem 0 0;
+		color: var(--ds-color-muted-foreground);
+		font-size: var(--ds-text-2xs);
+		letter-spacing: 0.05em;
+		text-transform: uppercase;
+	}
+
+	.ds-lib-tool-failed {
+		flex: none;
+		color: var(--ds-color-status-error);
+		font-size: var(--ds-text-2xs);
+	}
+
 	.ds-lib-tool-lines {
 		margin: 0;
 		padding-inline-start: 1.375rem;

package/dist/components/tool-row/tool-row.svelte.d.ts

@@ -1,12 +1,11 @@
 import { type ToolBlock, type ToolWords } from '../../transcript.svelte';
+import { type ChatCopy } from '../../copy';
 interface Props {
     block: ToolBlock;
     running: boolean;
-    /** Identical consecutive steps folded into this row — five pages of one
-     *  document is one act of reading to a human. */
-    repeats?: number;
     /** The call in the persona's words. Absent takes the package's own. */
     words?: ToolWords;
+    copy?: Partial<ChatCopy>;
 }
 declare const ToolRow: import("svelte").Component<Props, {}, "">;
 type ToolRow = ReturnType<typeof ToolRow>;

package/dist/components/web-list/index.d.ts

@@ -0,0 +1,2 @@
+export { default as WebList } from './web-list.svelte';
+export { default } from './web-list.svelte';

package/dist/components/web-list/index.js

@@ -0,0 +1,2 @@
+export { default as WebList } from './web-list.svelte';
+export { default } from './web-list.svelte';

package/dist/components/web-list/web-list.svelte

@@ -0,0 +1,84 @@
+<!--
+  The web pages an answer drew on, apart from the library's numbered sources.
+  Never numbered; each opens in a new tab.
+-->
+<script lang="ts">
+	import type { ChatCopy } from '../../copy';
+	import type { WebSource } from '../../web-sources';
+
+	interface Props {
+		sources: WebSource[];
+		words: ChatCopy;
+	}
+
+	let { sources, words }: Props = $props();
+</script>
+
+<section class="ds-lib-web">
+	<h2 class="ds-lib-web-heading">{words.fromTheWeb}</h2>
+	<ul class="ds-lib-web-list">
+		{#each sources as source (source.url)}
+			<li>
+				<a class="ds-lib-web-link" href={source.url} target="_blank" rel="noopener noreferrer">
+					<span class="ds-lib-web-title">{source.title}</span>
+					<span class="ds-lib-web-host">{source.host}</span>
+				</a>
+			</li>
+		{/each}
+	</ul>
+</section>
+
+<style>
+	.ds-lib-web-heading {
+		margin: 0 0 0.375rem;
+		color: var(--ds-color-muted-foreground);
+		font-family: inherit;
+		font-size: var(--ds-text-2xs);
+		font-weight: 500;
+		letter-spacing: 0.05em;
+		text-transform: uppercase;
+	}
+
+	.ds-lib-web-list {
+		display: flex;
+		flex-direction: column;
+		gap: 0.125rem;
+		margin: 0;
+		border-top: 1px solid var(--ds-color-border);
+		padding: 0.375rem 0 0;
+		list-style: none;
+	}
+
+	.ds-lib-web-link {
+		display: flex;
+		align-items: baseline;
+		gap: 0.5rem;
+		border-radius: var(--ds-radius-md);
+		padding: 0.375rem 0.625rem;
+		color: inherit;
+		font-size: 0.875rem;
+		text-decoration: none;
+	}
+
+	.ds-lib-web-link:hover {
+		background: var(--ds-color-surface-2);
+	}
+
+	.ds-lib-web-link:focus-visible {
+		outline: 2px solid var(--ds-color-ring);
+		outline-offset: 2px;
+	}
+
+	.ds-lib-web-title {
+		min-width: 0;
+		color: var(--ds-color-foreground);
+		font-weight: 500;
+		overflow-wrap: anywhere;
+	}
+
+	.ds-lib-web-host {
+		flex: none;
+		color: var(--ds-color-muted-foreground);
+		font-size: var(--ds-text-2xs);
+	}
+</style>

package/dist/components/web-list/web-list.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { ChatCopy } from '../../copy';
+import type { WebSource } from '../../web-sources';
+interface Props {
+    sources: WebSource[];
+    words: ChatCopy;
+}
+declare const WebList: import("svelte").Component<Props, {}, "">;
+type WebList = ReturnType<typeof WebList>;
+export default WebList;

package/dist/components/written-card/index.d.ts

@@ -0,0 +1,2 @@
+export { default as WrittenCard } from './written-card.svelte';
+export { default } from './written-card.svelte';

package/dist/components/written-card/index.js

@@ -0,0 +1,2 @@
+export { default as WrittenCard } from './written-card.svelte';
+export { default } from './written-card.svelte';

package/dist/components/written-card/written-card.svelte

@@ -0,0 +1,130 @@
+<!--
+  A document the persona wrote, as a card in the turn: its name and version,
+  Open (the reading column shows that version) and a download link for the
+  source and for each format the app renders it as.
+-->
+<script lang="ts">
+	import FileTextIcon from '@lucide/svelte/icons/file-text';
+	import { fill, resolveCopy, type ChatCopy } from '../../copy';
+	import { downloads, type Written, type WrittenUrl } from '../../written';
+
+	interface Props {
+		written: Written;
+		/** The column is showing this version now. */
+		open?: boolean;
+		/** Omit and the card lists and links but does not open. */
+		onopen?: () => void;
+		/** Omit and no download links render. */
+		url?: WrittenUrl;
+		copy?: Partial<ChatCopy>;
+	}
+
+	let { written, open = false, onopen, url, copy }: Props = $props();
+
+	const words = $derived(resolveCopy(copy));
+</script>
+
+<div class="ds-lib-written" class:is-open={open}>
+	<span class="ds-lib-written-icon" aria-hidden="true"><FileTextIcon size={16} /></span>
+	<span class="ds-lib-written-text">
+		<span class="ds-lib-written-name">{written.name}</span>
+		<span class="ds-lib-written-version">{fill(words.writtenVersion, { n: written.version })}</span>
+	</span>
+	{#if onopen}
+		<button type="button" class="ds-lib-written-open" onclick={onopen}>
+			{open ? words.showingArtefact : words.openArtefact}
+		</button>
+	{/if}
+	{#if url}
+		<ul class="ds-lib-written-links" aria-label={words.download}>
+			{#each downloads(written, words) as link (link.format)}
+				<li><a href={url(written.name, written.version, link.format)}>{link.label}</a></li>
+			{/each}
+		</ul>
+	{/if}
+</div>
+
+<style>
+	.ds-lib-written {
+		display: flex;
+		flex-wrap: wrap;
+		align-items: center;
+		gap: 0.5rem 0.75rem;
+		border: 1px solid var(--ds-color-border);
+		border-radius: var(--ds-radius-lg);
+		background: var(--ds-color-surface-1);
+		padding: 0.625rem 0.75rem;
+	}
+
+	.ds-lib-written.is-open {
+		border-color: var(--ds-color-primary);
+	}
+
+	.ds-lib-written-icon {
+		display: flex;
+		width: 2rem;
+		height: 2rem;
+		flex: none;
+		align-items: center;
+		justify-content: center;
+		border: 1px solid var(--ds-color-border);
+		border-radius: var(--ds-radius-md);
+		color: var(--ds-color-muted-foreground);
+	}
+
+	.ds-lib-written-text {
+		display: flex;
+		min-width: 0;
+		flex: 1;
+		flex-direction: column;
+	}
+
+	.ds-lib-written-name {
+		font-size: 0.875rem;
+		font-weight: 500;
+		line-height: 1.25rem;
+		overflow-wrap: anywhere;
+	}
+
+	.ds-lib-written-version {
+		color: var(--ds-color-muted-foreground);
+		font-size: var(--ds-text-2xs);
+	}
+
+	.ds-lib-written-open {
+		border: 1px solid var(--ds-color-border);
+		border-radius: var(--ds-radius-md);
+		background: none;
+		padding: 0.25rem 0.625rem;
+		color: inherit;
+		font: inherit;
+		font-size: 0.8125rem;
+		cursor: pointer;
+	}
+
+	.ds-lib-written-open:focus-visible,
+	.ds-lib-written-links a:focus-visible {
+		outline: 2px solid var(--ds-color-ring);
+		outline-offset: 2px;
+	}
+
+	.ds-lib-written-links {
+		display: flex;
+		flex-basis: 100%;
+		flex-wrap: wrap;
+		gap: 0.75rem;
+		margin: 0;
+		padding: 0;
+		font-size: var(--ds-text-2xs);
+		list-style: none;
+	}
+
+	.ds-lib-written-links a {
+		color: var(--ds-color-muted-foreground);
+		text-decoration: underline;
+	}
+
+	.ds-lib-written-links a:hover {
+		color: var(--ds-color-foreground);
+	}
+</style>

package/dist/components/written-card/written-card.svelte.d.ts

@@ -0,0 +1,15 @@
+import { type ChatCopy } from '../../copy';
+import { type Written, type WrittenUrl } from '../../written';
+interface Props {
+    written: Written;
+    /** The column is showing this version now. */
+    open?: boolean;
+    /** Omit and the card lists and links but does not open. */
+    onopen?: () => void;
+    /** Omit and no download links render. */
+    url?: WrittenUrl;
+    copy?: Partial<ChatCopy>;
+}
+declare const WrittenCard: import("svelte").Component<Props, {}, "">;
+type WrittenCard = ReturnType<typeof WrittenCard>;
+export default WrittenCard;

package/dist/copy.d.ts

@@ -69,6 +69,25 @@ export interface ChatCopy {
     showingArtefact: string;
     /** Beside the clock on an answer this page did not start. */
     stillAnswering: string;
+    /** An expanded tool step: what went in, what came back, and a call that failed. */
+    stepInput: string;
+    stepResult: string;
+    stepFailed: string;
+    /** Editing a question already asked: the control, the send, and what the
+     *  edit does not carry. */
+    editQuestion: string;
+    editSend: string;
+    editFilesNote: string;
+    /** Web pages an answer drew on, listed apart from its numbered sources. */
+    fromTheWeb: string;
+    /** A document the persona wrote: its version (`{n}`), the version switcher's
+     *  name, and what each download is called. */
+    writtenVersion: string;
+    writtenVersions: string;
+    formatMarkdown: string;
+    formatHtml: string;
+    formatWord: string;
+    formatPdf: string;
     /** The answer mark: the two verdicts, the optional note, and after. */
     markHelpful: string;
     markNotHelpful: string;

package/dist/copy.js

@@ -80,6 +80,19 @@ export function copyFor(name = DEFAULT_PERSONA) {
         openArtefact: 'Open',
         showingArtefact: 'Showing',
         stillAnswering: `${who} is still answering`,
+        stepInput: 'Input',
+        stepResult: 'Result',
+        stepFailed: 'Failed',
+        editQuestion: 'Edit',
+        editSend: 'Send',
+        editFilesNote: 'Files attached to the original question are not sent again.',
+        fromTheWeb: 'From the web',
+        writtenVersion: 'Version {n}',
+        writtenVersions: 'Version',
+        formatMarkdown: 'Markdown',
+        formatHtml: 'HTML',
+        formatWord: 'Word',
+        formatPdf: 'PDF',
         markHelpful: 'Helpful',
         markNotHelpful: 'Not helpful',
         markNote: 'Anything to add? (optional)',

package/dist/transcript.svelte.d.ts

@@ -8,6 +8,7 @@
  */
 import type { AgentEvent } from './client';
 import type { Citation } from './citations';
+import type { Written } from './written';
 export interface TextBlock {
     kind: 'text';
     index: number;
@@ -66,12 +67,6 @@ export interface ToolWords {
     object: string;
     /** One dimmed line under the row. */
     detail?: string;
-    /** How the activity line counts the call, singular and plural:
-     *  `['search', 'searches']` reads "2 searches". Absent is not counted. */
-    tally?: [one: string, many: string];
-    /** How the row counts a run of identical calls: `['page', 'pages']`
-     *  reads "· 5 pages". Absent reads "× 5". */
-    repeat?: [one: string, many: string];
     /** Something the call read that a reader can open, listed under the
      *  answer and handed back to the host's `oncite` when tapped. */
     source?: {
@@ -120,6 +115,8 @@ export declare class Transcript {
     outcome: Outcome | null;
     /** Sources for the answer, from the app's `citations` frame. */
     citations: Citation[];
+    /** The document versions the persona wrote, in order. */
+    written: Written[];
     other: AgentEvent[];
     reset(): void;
     apply(event: AgentEvent): void;
@@ -129,6 +126,7 @@ export interface FoldTarget {
     blocks: Block[];
     outcome: Outcome | null;
     citations?: Citation[];
+    written?: Written[];
 }
 /** Where one turn's fold keeps its place between events. */
 export interface FoldState {
@@ -155,29 +153,18 @@ export declare function fold(into: FoldTarget, state: FoldState, event: AgentEve
 /** A message's content blocks; a user frame may carry a bare string instead. */
 export declare function contentOf(event: AgentEvent): Array<Record<string, unknown>>;
 export interface ActivityStep {
-    /** The block this step stands for; a repeated step keeps the FIRST.
+    /** The block this step stands for.
      *
      * A `text` block here is interstitial narration, not the answer — see
      * `segment()`. */
     block: Block;
-    /** How many identical consecutive steps collapsed into this one. */
-    repeats: number;
-    /** A tool step in the persona's words, resolved once here so the row, the
-     *  count and the collapse all agree. */
+    /** A tool step in the persona's words, resolved once here. */
     words?: ToolWords;
 }
-/** One count on the activity line: "2 searches". */
-export interface Tally {
-    one: string;
-    many: string;
-    count: number;
-}
 export interface ActivityGroup {
     kind: 'activity';
     index: number;
     steps: ActivityStep[];
-    /** What the steps counted as, in the order each first appeared. */
-    tallies: Tally[];
 }
 export type Segment = ActivityGroup | TextBlock;
 /** One question and the answer to it, as the transcript renders it.
@@ -196,6 +183,10 @@ export interface Turn {
     blocks: Block[];
     outcome: Outcome | null;
     citations?: Citation[];
+    /** The names of the files attached to the question. */
+    files?: string[];
+    /** The document versions the persona wrote answering it, in order. */
+    written?: Written[];
     /** Something this turn produced for the reader to open, carded under the
      *  answer once the turn settles. */
     artefact?: Artefact;
@@ -223,15 +214,11 @@ export interface Artefact {
 /**
  * Fold a turn's flat block list into what a reader should actually see.
  *
- * Three problems this solves, all reported off a real transcript:
+ * Two problems this solves, reported off a real transcript:
  *
- * 1. Fifteen tool rows stood between the question and the first word of the
- *    answer, so the answer had to be scrolled to. Contiguous activity becomes
- *    ONE group the caller can collapse.
- * 2. "Reading pspf guidelines 2026" appeared five times in a row — five pages
- *    of one document, which is one act of reading to a human. Consecutive
- *    steps with the same label collapse to one row carrying a count.
- * 3. The persona's between-tool narration was rendering unfolded, as answer prose.
+ * 1. Contiguous activity becomes ONE group, so the answer's prose is never
+ *    split by each step; every step stays its own collapsed row in it.
+ * 2. The persona's between-tool narration was rendering unfolded, as answer prose.
  *    The caller stream carries no `thinking` blocks at all — measured on
  *    production 11/09/2026 — so "Let me also check whether…" arrives as an
  *    ordinary `text` block, indistinguishable from the answer except by
@@ -239,7 +226,7 @@ export interface Artefact {
  *    narration; only the run of text after the LAST tool call is the answer.
  *    Narration folds into the activity group as a thinking-shaped step.
  *
- * That third rule is provisional while a turn streams, and deliberately so: a
+ * That second rule is provisional while a turn streams, and deliberately so: a
  * text block that is currently last IS the answer as far as anything can know,
  * and renders as prose. The tool call that arrives after it re-homes it into
  * the group. Nothing here holds state to make that work — `segment` is pure
@@ -252,12 +239,6 @@ export interface Artefact {
  * off the prose itself would be unexplainable the first time it misfired.
  */
 export declare function segment(blocks: Block[], describeTool?: DescribeTool): Segment[];
-/** One line describing a whole investigation, for the collapsed state.
- *
- * Counts of what the persona did are fine ("1 search · 2 documents read"); how
- * it organises what it knows is not — no collection count, no corpus.
- */
-export declare function summariseActivity(group: ActivityGroup): string;
 /**
  * What a settled answer took, as one quiet line: `56.3s`, then what it cost
  * — only when the host can price it (`formatCost`) and the run actually