@poodle64/librarian 2026.9.28 → 2026.10.0

package/dist/session.svelte.js

@@ -12,17 +12,17 @@
  * Every Claude Code event carries a `uuid`, and one already folded is
  * skipped: a watch route replays from the first event, so opening it again
  * after the session moves on folds only what is new. A frame the server adds
- * itself (an error, the library's citations) carries none, and is known by
+ * itself (an error, the citations) carries none, and is known by
  * the event it follows.
  */
 import { contentOf, fold, foldState } from './transcript.svelte';
 /** The events a run is made of. One arriving after its turn settled is the
  *  next run, whether or not its prompt was echoed. */
 const RUN = new Set(['stream_event', 'assistant', 'user', 'result']);
-/** Everything else that lands on a turn: the library's trailing frames, and
- *  a stream that broke. Anything else (`system`, rate limits) is the CLI
+/** Everything else that lands on a turn: the citations, and a stream that
+ *  broke. Anything else (`system`, rate limits) is the CLI
  *  talking about itself. */
-const FOLDED = new Set([...RUN, 'library_error', 'citations', 'suggestions']);
+const FOLDED = new Set([...RUN, 'agent_error', 'citations']);
 export class Session {
     /** One per run, in order: plain objects, so a host may spread one to add
      *  its own `artefact`. */
@@ -66,7 +66,7 @@ export class Session {
         const last = this.turns.at(-1);
         const settled = last?.outcome != null && !last.outcome.unreachable;
         // The watch broke while nothing was running, and no run failed.
-        if (event.type === 'library_error' && settled)
+        if (event.type === 'agent_error' && settled)
             return;
         // A run whose prompt was never echoed — a session started without the
         // replay flag, or one that failed before it said anything — still has
@@ -88,8 +88,7 @@ export class Session {
             at,
             blocks: [],
             outcome: null,
-            citations: [],
-            suggestions: []
+            citations: []
         });
         this.#folds.push(foldState());
     }

package/dist/transcript.svelte.d.ts

@@ -6,10 +6,8 @@
  * deltas that belong to each. An event type this does not know about is kept
  * verbatim under `other`, so nothing is silently dropped.
  */
-import type { AgentEvent, Depth } from './client';
+import type { AgentEvent } from './client';
 import type { Citation } from './citations';
-import type { LibrarianCopy } from './copy';
-export type { Depth };
 export interface TextBlock {
     kind: 'text';
     index: number;
@@ -50,9 +48,9 @@ export interface Outcome {
 /**
  * The question as the READER asked it.
  *
- * A host prepends a system preamble to every question before it goes to the
- * library — cadmus sends `{room.preamble}\n\n{question}` — and echoing that
- * back into the transcript shows a colleague the machine room. Leading
+ * A host may prepend a system preamble to every question before it goes to
+ * the persona, and echoing that back into the transcript shows a colleague
+ * the machinery. Leading
  * blank-line-separated paragraphs addressed to the model are dropped.
  *
  * The LAST paragraph is never dropped, whatever it starts with: someone whose
@@ -85,12 +83,12 @@ export interface ToolWords {
 /** A host's words for its persona's tools. `undefined` leaves the call to
  *  `describe()`, the package's own. */
 export type DescribeTool = (block: ToolBlock) => ToolWords | undefined;
-/** What Milton DID, in a reader's own words — never the tool's name or the
+/** What the persona DID, in a reader's own words — never the tool's name or the
  * raw command it ran.
  *
  * The collapsed row is read by someone asking a question about documents, not
  * by an engineer: `Bash ls -1 .` tells them nothing and looks like a leak from
- * the machine room. Milton never narrates how he searched, so a tool this
+ * the machinery. The persona never narrates how it searched, so a tool this
  * does not recognise falls back to something that names no mechanism at all.
  * A persona with tools of its own brings a `DescribeTool` in front of this.
  */
@@ -120,10 +118,8 @@ export declare class Transcript {
     sessionId: string | null;
     model: string | null;
     outcome: Outcome | null;
-    /** Sources for the answer, from the library's own `citations` frame. */
+    /** Sources for the answer, from the app's `citations` frame. */
     citations: Citation[];
-    /** Follow-ups the librarian named, from the `suggestions` frame after it. */
-    suggestions: string[];
     other: AgentEvent[];
     reset(): void;
     apply(event: AgentEvent): void;
@@ -133,7 +129,6 @@ export interface FoldTarget {
     blocks: Block[];
     outcome: Outcome | null;
     citations?: Citation[];
-    suggestions?: string[];
 }
 /** Where one turn's fold keeps its place between events. */
 export interface FoldState {
@@ -201,18 +196,15 @@ export interface Turn {
     blocks: Block[];
     outcome: Outcome | null;
     citations?: Citation[];
-    /** Follow-ups offered after this answer. Absent on a turn read back from
-     *  history: they belonged to the moment it was asked. */
-    suggestions?: string[];
     /** Something this turn produced for the reader to open, carded under the
      *  answer once the turn settles. */
     artefact?: Artefact;
     /** What the host asked for when this was not a plain question
      *  (`'briefing'`), in its own word, as `client.ask()` sent it. */
     kind?: string;
-    /** How hard the persona worked on this one, as `client.ask()` sent it.
-     *  Absent, a host that never offers the choice. */
-    depth?: Depth;
+    /** The collection this question was narrowed to, by name, as `client.ask()`
+     *  sent it. Absent asked across every collection the person may read. */
+    collection?: string;
     /** Where this answer's read-only view lives while it is shared, as the
      *  host's own address. Absent while it is not. */
     shared?: string;
@@ -239,7 +231,7 @@ export interface Artefact {
  * 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. Milton's between-tool narration was rendering unfolded, as answer prose.
+ * 3. 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
@@ -254,8 +246,8 @@ export interface Artefact {
  * and re-derived on every event, so re-homing is just the next call returning
  * a different shape.
  *
- * The cost of the rule is a real answer that Milton interrupts to go back to
- * the shelf: its first half folds away. That is the trade taken knowingly —
+ * The cost of the rule is a real answer that the persona interrupts to go back to
+ * its tools: its first half folds away. That is the trade taken knowingly —
  * the position of a block is the only signal the stream gives, and a rule read
  * off the prose itself would be unexplainable the first time it misfired.
  */
@@ -263,26 +255,20 @@ export declare function segment(blocks: Block[], describeTool?: DescribeTool): S
 /** 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 shelf, no corpus.
+ * 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: `Quick · 56 s · about
- * A$0.34`. Depth first (absent on a turn the host never asked one for, or
- * one read back before the feature shipped), then the duration, then what it
- * cost — only when the host can price it (`formatCost`) and the run actually
+ * 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
  * spent something, since a zero-cost run (a local model) has nothing worth
- * saying about money.
+ * saying about money: `56.3s · about A$0.34`.
  *
  * The host prices `outcome.costUsd`, never this package: the currency and
  * the rate are the app's own setting, not something a shared component
  * should be converting.
- *
- * A turn asked with no depth at all renders exactly what this line always
- * has (`56.3s`, one decimal, no gap) — a host that never wires depth sees no
- * change here either.
  */
-export declare function outcomeLine(outcome: Outcome, depth: Depth | undefined, words: Pick<LibrarianCopy, 'depthQuick' | 'depthThorough'>, formatCost?: (usd: number) => string): string;
+export declare function outcomeLine(outcome: Outcome, formatCost?: (usd: number) => string): string;
 /**
  * What a turn's calls read that a reader can open, numbered in the order it
  * was first read: the host's `ToolWords.source`, as the sources the answer

package/dist/transcript.svelte.js

@@ -9,9 +9,9 @@
 /**
  * The question as the READER asked it.
  *
- * A host prepends a system preamble to every question before it goes to the
- * library — cadmus sends `{room.preamble}\n\n{question}` — and echoing that
- * back into the transcript shows a colleague the machine room. Leading
+ * A host may prepend a system preamble to every question before it goes to
+ * the persona, and echoing that back into the transcript shows a colleague
+ * the machinery. Leading
  * blank-line-separated paragraphs addressed to the model are dropped.
  *
  * The LAST paragraph is never dropped, whatever it starts with: someone whose
@@ -25,12 +25,12 @@ export function readerQuestion(question) {
         start += 1;
     return parts.slice(start).join('\n\n').trim();
 }
-/** What Milton DID, in a reader's own words — never the tool's name or the
+/** What the persona DID, in a reader's own words — never the tool's name or the
  * raw command it ran.
  *
  * The collapsed row is read by someone asking a question about documents, not
  * by an engineer: `Bash ls -1 .` tells them nothing and looks like a leak from
- * the machine room. Milton never narrates how he searched, so a tool this
+ * the machinery. The persona never narrates how it searched, so a tool this
  * does not recognise falls back to something that names no mechanism at all.
  * A persona with tools of its own brings a `DescribeTool` in front of this.
  */
@@ -152,17 +152,14 @@ export class Transcript {
     sessionId = $state(null);
     model = $state(null);
     outcome = $state(null);
-    /** Sources for the answer, from the library's own `citations` frame. */
+    /** Sources for the answer, from the app's `citations` frame. */
     citations = $state([]);
-    /** Follow-ups the librarian named, from the `suggestions` frame after it. */
-    suggestions = $state([]);
     other = $state([]);
     #fold = foldState();
     reset() {
         this.blocks = [];
         this.outcome = null;
         this.citations = [];
-        this.suggestions = [];
         this.other = [];
         this.#fold = foldState();
     }
@@ -201,25 +198,16 @@ export function fold(into, state, event) {
         };
         return true;
     }
-    // Emitted after the final assistant text, so it lands on a turn that is
-    // otherwise complete. Both frames put their payload on `items`, so each
-    // keeps only what its own shape admits: a `citations` frame carrying
-    // strings, or a `suggestions` frame carrying objects, is the library
-    // having changed under us, and rendering it would be worse than
-    // rendering nothing.
+    // The app emits this before the persona's answer, from the passages it
+    // retrieved for the question.
     if (event.type === 'citations') {
         into.citations = (event.items ?? []).filter((item) => typeof item === 'object' && item !== null);
         return true;
     }
-    // Last of the two, and only when the librarian named any.
-    if (event.type === 'suggestions') {
-        into.suggestions = (event.items ?? []).filter((item) => typeof item === 'string' && item.trim().length > 0);
-        return true;
-    }
     // 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') {
+    if (event.type === 'agent_error') {
         into.outcome = { isError: true, unreachable: true, error: event.error };
         return true;
     }
@@ -341,7 +329,7 @@ function renderResult(content) {
  * 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. Milton's between-tool narration was rendering unfolded, as answer prose.
+ * 3. 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
@@ -356,8 +344,8 @@ function renderResult(content) {
  * and re-derived on every event, so re-homing is just the next call returning
  * a different shape.
  *
- * The cost of the rule is a real answer that Milton interrupts to go back to
- * the shelf: its first half folds away. That is the trade taken knowingly —
+ * The cost of the rule is a real answer that the persona interrupts to go back to
+ * its tools: its first half folds away. That is the trade taken knowingly —
  * the position of a block is the only signal the stream gives, and a rule read
  * off the prose itself would be unexplainable the first time it misfired.
  */
@@ -416,7 +404,7 @@ function sameStep(last, block, words) {
         return false;
     if (block.kind === 'thinking')
         return true;
-    // Two narration sentences are two things Milton said; collapsing them to
+    // Two narration sentences are two things the persona said; collapsing them to
     // one row with a count would lose the second one entirely.
     if (block.kind === 'text')
         return false;
@@ -432,33 +420,24 @@ function count(group, [one, many]) {
 /** 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 shelf, no corpus.
+ * it organises what it knows is not — no collection count, no corpus.
  */
 export function summariseActivity(group) {
     const parts = group.tallies.map((t) => `${t.count} ${t.count === 1 ? t.one : t.many}`);
     return parts.length ? parts.join(' · ') : 'Looked into it';
 }
 /**
- * What a settled answer took, as one quiet line: `Quick · 56 s · about
- * A$0.34`. Depth first (absent on a turn the host never asked one for, or
- * one read back before the feature shipped), then the duration, then what it
- * cost — only when the host can price it (`formatCost`) and the run actually
+ * 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
  * spent something, since a zero-cost run (a local model) has nothing worth
- * saying about money.
+ * saying about money: `56.3s · about A$0.34`.
  *
  * The host prices `outcome.costUsd`, never this package: the currency and
  * the rate are the app's own setting, not something a shared component
  * should be converting.
- *
- * A turn asked with no depth at all renders exactly what this line always
- * has (`56.3s`, one decimal, no gap) — a host that never wires depth sees no
- * change here either.
  */
-export function outcomeLine(outcome, depth, words, formatCost) {
-    const seconds = (outcome.durationMs ?? 0) / 1000;
-    if (!depth)
-        return `${seconds.toFixed(1)}s`;
-    const parts = [depth === 'quick' ? words.depthQuick : words.depthThorough, `${Math.round(seconds)} s`];
+export function outcomeLine(outcome, formatCost) {
+    const parts = [`${((outcome.durationMs ?? 0) / 1000).toFixed(1)}s`];
     if (formatCost && outcome.costUsd)
         parts.push(formatCost(outcome.costUsd));
     return parts.join(' · ');

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@poodle64/librarian",
-	"version": "2026.9.28",
+	"version": "2026.10.0",
 	"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",
@@ -35,10 +35,6 @@
 			"types": "./dist/chat.svelte.d.ts",
 			"svelte": "./dist/chat.svelte.js"
 		},
-		"./history": {
-			"types": "./dist/history.svelte.d.ts",
-			"svelte": "./dist/history.svelte.js"
-		},
 		"./citations": {
 			"types": "./dist/citations.d.ts",
 			"svelte": "./dist/citations.js"

package/dist/history.svelte.d.ts

@@ -1,37 +0,0 @@
-/**
- * Past conversations.
- *
- * Held in the browser, deliberately and provisionally. The agent's own session
- * survives server-side — Claude Code keeps it and `--resume` reaches it — so
- * what is missing is only the RENDERED transcript, which is a display concern.
- * Persisting that here needs no schema, no migration and no decision about
- * whose conversation it is.
- *
- * Namespaced by the caller: two apps, or two rooms in one app, must not share
- * a `localStorage` key, so the namespace is a constructor argument rather than
- * a module-level constant.
- */
-export interface StoredTurn {
-    question: string;
-    answer: string;
-}
-export interface Conversation {
-    id: string;
-    /** The agent's session id, which is what `--resume` needs. */
-    sessionId: string | null;
-    title: string;
-    updated: number;
-    turns: StoredTurn[];
-}
-export declare class History {
-    #private;
-    items: Conversation[];
-    constructor(namespace: string);
-    load(): void;
-    save(conversation: Conversation): void;
-    remove(id: string): void;
-}
-/** One store per namespace — a distinct `localStorage` key per app or room. */
-export declare function createHistory(namespace: string): History;
-/** A conversation is named by its first question, trimmed to something legible. */
-export declare function titleFrom(question: string): string;

package/dist/history.svelte.js

@@ -1,59 +0,0 @@
-/**
- * Past conversations.
- *
- * Held in the browser, deliberately and provisionally. The agent's own session
- * survives server-side — Claude Code keeps it and `--resume` reaches it — so
- * what is missing is only the RENDERED transcript, which is a display concern.
- * Persisting that here needs no schema, no migration and no decision about
- * whose conversation it is.
- *
- * Namespaced by the caller: two apps, or two rooms in one app, must not share
- * a `localStorage` key, so the namespace is a constructor argument rather than
- * a module-level constant.
- */
-const LIMIT = 40;
-export class History {
-    items = $state([]);
-    #key;
-    constructor(namespace) {
-        this.#key = namespace;
-    }
-    load() {
-        if (typeof localStorage === 'undefined')
-            return;
-        try {
-            this.items = JSON.parse(localStorage.getItem(this.#key) ?? '[]');
-        }
-        catch {
-            this.items = [];
-        }
-    }
-    save(conversation) {
-        const rest = this.items.filter((c) => c.id !== conversation.id);
-        this.items = [conversation, ...rest].slice(0, LIMIT);
-        this.#flush();
-    }
-    remove(id) {
-        this.items = this.items.filter((c) => c.id !== id);
-        this.#flush();
-    }
-    #flush() {
-        if (typeof localStorage === 'undefined')
-            return;
-        try {
-            localStorage.setItem(this.#key, JSON.stringify(this.items));
-        }
-        catch {
-            // A full quota costs history, never the conversation in progress.
-        }
-    }
-}
-/** One store per namespace — a distinct `localStorage` key per app or room. */
-export function createHistory(namespace) {
-    return new History(namespace);
-}
-/** A conversation is named by its first question, trimmed to something legible. */
-export function titleFrom(question) {
-    const flat = question.replace(/\s+/g, ' ').trim();
-    return flat.length > 60 ? `${flat.slice(0, 57)}…` : flat;
-}