@poodle64/librarian 2026.9.13 → 2026.9.15

package/dist/copy.js

@@ -2,48 +2,93 @@
  * Every word this package puts in front of a reader, in one place.
  *
  * Here rather than inline in each component because these sentences are the
- * package's opinion about how Milton talks to a colleague, and an app that
- * needs a different register — a different name for the librarian, a room
- * whose boundary is worded by its own subject-matter owner — must be able to
- * change one string without forking a component.
+ * package's opinion about how an agent talks to a colleague, and an app that
+ * needs a different register — a room whose boundary is worded by its own
+ * subject-matter owner — must be able to change one string without forking a
+ * component.
+ *
+ * NO STRING HERE NAMES A PERSONA. The name is an argument: a consuming app
+ * says who is speaking once, and every sentence the package renders is built
+ * from that. Milton is the library's own persona and therefore the default,
+ * which is a different thing from being baked in — a package that hardcodes
+ * one app's persona is a package that lies in every other app, and did:
+ * Pebblestone's Penny introduced herself as Milton for a fortnight.
  *
  * Every component takes `copy` as a PARTIAL and resolves it itself, so a host
- * overriding one line does not have to restate the other eleven, and a
- * component used directly behaves the same as one reached through
- * `Conversation`.
+ * overriding one line does not have to restate the others, and a component
+ * used directly behaves the same as one reached through `Conversation`.
  */
-export const DEFAULT_COPY = {
-    verified: 'verified',
-    notVerified: 'not verified',
-    // Two sentences, both plain: what happened, and the likeliest reason. It
-    // says nothing about collections, indexes or retrieval — a colleague
-    // reading it has no model of any of those, and the room's own instruction
-    // to Milton forbids him naming them either.
-    notHeld: 'Milton answered this one without a source. He may not hold a document that covers it.',
-    // 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.',
-    sources: 'Sources',
-    suggestions: 'Ask next',
-    scope: 'What Milton answers from',
-    copyAnswer: 'Copy',
-    copiedAnswer: 'Copied',
-    askAgain: 'Ask again',
-    jumpToLatest: 'Jump to latest',
-    closeSource: 'Close source',
-    documentUnavailable: "That document can't be opened right now."
-};
+/** The library's own persona: the default wherever a consumer names none. */
+export const DEFAULT_PERSONA = 'Milton';
+/**
+ * The display name for a persona a host identified by its slug.
+ *
+ * A route parameter is `penny`, and a colleague reading the screen is talking
+ * to Penny. A host that already wrote the name the way it should read — any
+ * capital at all — is left alone, so "McTavish" and "eight" both survive.
+ */
+export function personaName(name) {
+    const given = name.trim();
+    if (!given)
+        return DEFAULT_PERSONA;
+    if (given !== given.toLowerCase())
+        return given;
+    return given
+        .split(/[\s_-]+/)
+        .filter(Boolean)
+        .map((word) => word[0].toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * The package's words, spoken by one named persona.
+ *
+ * Deliberately free of pronouns: the persona is whoever the consuming app
+ * says it is, and a sentence that guesses is wrong for half of them.
+ */
+export function copyFor(name = DEFAULT_PERSONA) {
+    const who = personaName(name);
+    return {
+        verified: 'verified',
+        notVerified: 'not verified',
+        // Two sentences, both plain: what happened, and the likeliest reason. It
+        // says nothing about collections, indexes or retrieval — a colleague
+        // reading it has no model of any of those, and the room's own
+        // instruction forbids naming them either.
+        notHeld: `${who} answered this one without a source. There may be no document here that covers it.`,
+        // 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: `${who} stopped before finishing this one.`,
+        unreachable: `${who} can't be reached right now.`,
+        sources: 'Sources',
+        suggestions: 'Ask next',
+        scope: `What ${who} answers from`,
+        welcome: `Ask ${who} a question.`,
+        askPlaceholder: `Ask ${who}…`,
+        answeringPlaceholder: `${who} is answering…`,
+        working: [`${who} is looking`, `${who} is reading`],
+        conversationLabel: `Conversation with ${who}`,
+        copyAnswer: 'Copy',
+        copiedAnswer: 'Copied',
+        askAgain: 'Ask again',
+        jumpToLatest: 'Jump to latest',
+        closeSource: 'Close source',
+        documentUnavailable: "That document can't be opened right now."
+    };
+}
+/** The library's own words, for a host that names no persona. */
+export const DEFAULT_COPY = copyFor();
 /**
- * The package's words with a host's overrides on top.
+ * One persona's words with a host's overrides on top.
  *
  * An explicitly `undefined` key is dropped rather than spread, because
  * `{...defaults, ...{ sources: undefined }}` leaves a component rendering
  * nothing at all — and that is exactly the shape a host produces by passing a
  * value it computed from state that has not loaded yet.
  */
-export function resolveCopy(overrides) {
+export function resolveCopy(overrides, name) {
+    const base = name === undefined ? DEFAULT_COPY : copyFor(name);
     if (!overrides)
-        return DEFAULT_COPY;
+        return base;
     const given = Object.fromEntries(Object.entries(overrides).filter(([, value]) => value !== undefined));
-    return { ...DEFAULT_COPY, ...given };
+    return { ...base, ...given };
 }

package/dist/transcript.svelte.d.ts

@@ -33,7 +33,12 @@ export interface Outcome {
     costUsd?: number;
     durationMs?: number;
     isError?: boolean;
+    /** A message the run itself gave. Words, never a code. */
     error?: string;
+    /** The stream never opened, or died before the run said anything. The
+     *  sentence a reader sees is the persona's own (`copy.unreachable`), which
+     *  only the rendering layer knows, so this carries the FACT and no words. */
+    unreachable?: boolean;
 }
 /**
  * The question as the READER asked it.
@@ -117,6 +122,11 @@ export type Segment = ActivityGroup | TextBlock;
 export interface Turn {
     id: string;
     question: string;
+    /** When the question was asked, epoch ms. A host that persists its
+     *  conversations supplies it; a host that does not gets one stamped when
+     *  the turn first appears on screen, which is right for a live turn and
+     *  honestly absent for one read back out of history. */
+    at?: number;
     blocks: Block[];
     outcome: Outcome | null;
     citations?: Citation[];

package/dist/transcript.svelte.js

@@ -189,8 +189,11 @@ export class Transcript {
             this.suggestions = (event.items ?? []).filter((item) => typeof item === 'string' && item.trim().length > 0);
             return;
         }
+        // No persona and no sentence at this layer: `client.ts` raises this for a
+        // stream that would not open or died half-way, and the turn renders the
+        // unreachable line in whichever persona's voice the host named.
         if (event.type === 'library_error') {
-            this.outcome = { isError: true, error: event.error ?? "Milton can't be reached right now." };
+            this.outcome = { isError: true, unreachable: true, error: event.error };
             return;
         }
         // A tool RESULT arrives as a user message carrying tool_result blocks.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@poodle64/librarian",
-	"version": "2026.9.13",
-	"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.",
+	"version": "2026.9.15",
+	"description": "An agent's conversation surface as a consumable Svelte 5 package: the stream client, transcript state and self-styling chat components (transcript, composer, markdown) every household app renders instead of rebuilding, speaking as whichever persona the app names.",
 	"type": "module",
 	"license": "MIT",
 	"repository": {
@@ -53,6 +53,7 @@
 	},
 	"peerDependencies": {
 		"svelte": "^5.54.0",
+		"@poodle64/design-tokens": "^2026.8.1",
 		"@poodle64/ui": "^2026.9.2",
 		"@lucide/svelte": "^1.7.0",
 		"marked": "^18.0.11",
@@ -61,6 +62,7 @@
 	},
 	"devDependencies": {
 		"@lucide/svelte": "^1.7.0",
+		"@poodle64/design-tokens": "workspace:*",
 		"@poodle64/ui": "workspace:*",
 		"@sveltejs/kit": "^2.63.0",
 		"@sveltejs/package": "^2.5.8",