@poodle64/librarian 2026.9.12 → 2026.9.14

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

@@ -25,7 +25,7 @@
 		trustMark,
 		type Citation
 	} from '../../citations';
-	import { resolveCopy, type LibrarianCopy } from '../../copy';
+	import { DEFAULT_COPY, resolveCopy, type LibrarianCopy } from '../../copy';
 	import Working from '../working/working.svelte';
 	import ActivityGroup from '../activity-group/activity-group.svelte';
 	import ArtefactCard from '../artefact-card/artefact-card.svelte';
@@ -133,9 +133,15 @@
 	 * a duration badge, and — worse — the "he holds nothing on this" line,
 	 * which is a claim about the shelf made off a run that never finished
 	 * looking.
+	 *
+	 * `error` still carries `DEFAULT_COPY.unreachable` verbatim from `client.ts`
+	 * — the stream layer has no `name` to compose with — so that exact default
+	 * is swapped for `words.unreachable`, which `Conversation`'s `name` prop
+	 * (or a host's own `copy` override) already resolved.
 	 */
 	const failure = $derived(
-		outcome?.error ?? (outcome?.isError ? words.answerFailed : null)
+		(outcome?.error === DEFAULT_COPY.unreachable ? words.unreachable : outcome?.error) ??
+			(outcome?.isError ? words.answerFailed : null)
 	);
 
 	// A failed turn settles too, and "Ask again" is the one thing a reader wants

package/dist/components/composer/composer.svelte

@@ -44,6 +44,8 @@
 		 *  control renders — studying is a mode of asking, never a tab, so a
 		 *  host with nothing to build offers none rather than a disabled one. */
 		onbriefing?: () => void;
+		/** The persona's display name; the placeholder in both states takes it. */
+		name?: string;
 	}
 
 	let {
@@ -57,7 +59,8 @@
 		onscope,
 		onsubmit,
 		onstop,
-		onbriefing
+		onbriefing,
+		name = 'Milton'
 	}: Props = $props();
 
 	// What Milton is being asked about — this document, this collection, or
@@ -214,7 +217,7 @@
 			onkeydown={keydown}
 			rows="1"
 			disabled={running}
-			placeholder={running ? 'Milton is answering…' : 'Ask Milton…'}
+			placeholder={running ? `${name} is answering…` : `Ask ${name}…`}
 			class="text-foreground placeholder:text-muted-foreground w-full resize-none bg-transparent px-4 pt-3 pb-2 text-base outline-none disabled:opacity-60"
 		></textarea>
 

package/dist/components/composer/composer.svelte.d.ts

@@ -17,6 +17,8 @@ interface Props {
      *  control renders — studying is a mode of asking, never a tab, so a
      *  host with nothing to build offers none rather than a disabled one. */
     onbriefing?: () => void;
+    /** The persona's display name; the placeholder in both states takes it. */
+    name?: string;
 }
 declare const Composer: import("svelte").Component<Props, {}, "value" | "files">;
 type Composer = ReturnType<typeof Composer>;

package/dist/components/conversation/conversation.svelte

@@ -31,6 +31,9 @@
 		/** `Transcript.version` — bumped per event. Text grows in place, so a
 		 *  count of turns is not enough to keep the scroll following. */
 		version?: number;
+		/** The persona's display name. The aria-label, the `welcome` default and
+		 *  the unreachable alert all take it. */
+		name?: string;
 		welcome?: string;
 		/** Up to three, shown in the empty state as tappable pills. */
 		examples?: string[];
@@ -59,7 +62,8 @@
 		turns,
 		running,
 		version = 0,
-		welcome = 'Ask Milton a question about the library.',
+		name = 'Milton',
+		welcome = `Ask ${name} a question about the library.`,
 		examples = [],
 		onexample,
 		scope,
@@ -73,6 +77,12 @@
 
 	const words = $derived(resolveCopy(copy));
 
+	// A host's own `copy.unreachable` still wins: it comes last in the spread.
+	const effectiveCopy = $derived<Partial<LibrarianCopy>>({
+		unreachable: `${name} can't be reached right now.`,
+		...copy
+	});
+
 	let viewport = $state<HTMLElement | null>(null);
 	let column = $state<Column>(null);
 	const follow = new FollowScroll();
@@ -107,6 +117,25 @@
 		viewport.scrollTop = viewport.scrollHeight;
 	});
 
+	// Asking for a briefing puts its card in the transcript AND opens the
+	// artefact in the column, closing whatever document was there — a
+	// colleague who just asked for one is asking to read it, not merely to
+	// see that it exists. Fires on the RUNNING → settled transition only, so
+	// reopening a past conversation whose last turn happens to be an
+	// artefact does not reopen a pane the reader may have since closed.
+	//
+	// Plain, not `$state`: read and written in the same effect, which would
+	// otherwise re-trigger itself forever (the pattern this file's `seen`
+	// already uses for the same reason).
+	let wasRunning = false;
+	$effect(() => {
+		const last = turns.at(-1);
+		if (wasRunning && !running && last?.kind === 'artefact' && !last.outcome?.isError) {
+			column = { kind: 'artefact', turn: last };
+		}
+		wasRunning = running;
+	});
+
 	function scrolled() {
 		if (viewport) follow.measure(metrics(viewport));
 	}
@@ -141,7 +170,7 @@
 			role="log"
 			aria-live="polite"
 			aria-busy={running}
-			aria-label="Conversation with Milton"
+			aria-label="Conversation with {name}"
 			class="min-h-0 flex-1 overflow-y-auto overscroll-contain"
 		>
 			<div class="mx-auto flex w-full max-w-[46rem] flex-col gap-8 px-4 py-6">
@@ -171,7 +200,7 @@
 				     sit at the top of the same column so a reader meets them in
 				     the same order whether or not they have asked anything yet. -->
 				{#if scope}
-					<ScopeStatement statement={scope} expanded={turns.length === 0} {copy} />
+					<ScopeStatement statement={scope} expanded={turns.length === 0} copy={effectiveCopy} />
 				{/if}
 
 				{#each turns as turn, index (turn.id)}
@@ -183,7 +212,7 @@
 						citations={turn.citations ?? []}
 						suggestions={turn.suggestions ?? []}
 						{collectionNames}
-						{copy}
+						copy={effectiveCopy}
 						kind={turn.kind}
 						title={turn.title}
 						onopenartefact={() => openArtefact(turn)}
@@ -216,11 +245,16 @@
 	</div>
 
 	{#if column?.kind === 'document' && loadDocument}
-		<DocumentPane citation={column.citation} {loadDocument} {copy} onclose={() => (column = null)} />
+		<DocumentPane
+			citation={column.citation}
+			{loadDocument}
+			copy={effectiveCopy}
+			onclose={() => (column = null)}
+		/>
 	{:else if column?.kind === 'artefact'}
 		<ArtefactPane
 			turn={column.turn}
-			{copy}
+			copy={effectiveCopy}
 			onclose={() => (column = null)}
 			oncite={(citation) => cite(citation)}
 		/>

package/dist/components/conversation/conversation.svelte.d.ts

@@ -8,6 +8,9 @@ interface Props {
     /** `Transcript.version` — bumped per event. Text grows in place, so a
      *  count of turns is not enough to keep the scroll following. */
     version?: number;
+    /** The persona's display name. The aria-label, the `welcome` default and
+     *  the unreachable alert all take it. */
+    name?: string;
     welcome?: string;
     /** Up to three, shown in the empty state as tappable pills. */
     examples?: string[];

package/dist/copy.d.ts

@@ -21,6 +21,9 @@ export interface LibrarianCopy {
     notHeld: string;
     /** Shown when the run itself ended in error and said nothing about why. */
     answerFailed: string;
+    /** Shown when the stream never opened at all. `Conversation`'s `name`
+     *  prop composes this default; a host overriding `copy` directly wins. */
+    unreachable: string;
     /** Heading over the list of what an answer cited. */
     sources: string;
     /** Heading over the follow-up questions the librarian offered. */

package/dist/copy.js

@@ -23,6 +23,7 @@ export const DEFAULT_COPY = {
     // A run can end `is_error` carrying no message at all, and a turn that
     // simply stops is the one thing a reader must not have to guess about.
     answerFailed: 'Milton stopped before he finished this one.',
+    unreachable: "Milton can't be reached right now.",
     sources: 'Sources',
     suggestions: 'Ask next',
     scope: 'What Milton answers from',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@poodle64/librarian",
-	"version": "2026.9.12",
+	"version": "2026.9.14",
 	"description": "Milton's conversation surface as a consumable Svelte 5 package: the stream client, transcript state and chat components (transcript, composer, markdown) every household app renders instead of rebuilding.",
 	"type": "module",
 	"license": "MIT",