@poodle64/librarian 2026.10.0 → 2026.10.1

package/README.md

@@ -174,7 +174,7 @@ on it fires once and never again.
 | Attachments              | nothing: `ask()` posts multipart (`question`, `resume`, `collection`, `files[]`) whenever `files` is non-empty, and JSON when it is not. The route must accept both                      |
 | Reading a cited document | `loadDocument(document_id) => Promise<{title, sections: [{anchor, heading, text}]}>`, proxied through the app's own authenticated route (caspo: `GET /api/sources/documents/{id}/content`) |
 | Asking again             | `onregenerate`: re-send the last question as a NEW turn; the package exposes the action and never re-asks by itself                                                                         |
-| Choosing a collection    | `Composer`'s `collections` (`{ name, summary }[]`, the ones the person may read) and `collection` (the chosen name; undefined is all of them), with `oncollection(name \| undefined)`. It renders from two collections up, each by its summary, never its name |
+| Choosing a collection    | `Composer`'s `collections` (`{ name, title?, description? }[]`, the ones the person may read) and `collection` (the chosen name; undefined is all of them), with `oncollection(name \| undefined)`. It renders from two collections up, each by its title (the name made readable where there is none) with the description as its hover, never a retrieval summary |
 | The empty state          | `welcome` and up to three `examples`                                                                                                                                                        |
 | What this surface covers | `scope`: one statement per persona, in the host's own words. Rendered above the first turn and folded to a line once the conversation starts                                                   |
 | The words themselves     | `copy`: a partial of `ChatCopy`. Every component resolves it itself, so overriding one line does not mean restating the rest                                                           |

package/dist/components/composer/composer.svelte

@@ -34,10 +34,21 @@
 	const DEFAULT_TURN_LIMIT = 8;
 
 	/** A collection a person may read, as the app lists it: `name` is what a
-	 *  question is narrowed to, `summary` is what the picker shows. */
+	 *  question is narrowed to, `title` is what the picker shows (the name,
+	 *  made readable, where there is none) and `description` is its one-line
+	 *  hover. A retrieval summary is never a field here: it is filing history. */
 	export interface CollectionChoice {
 		name: string;
-		summary: string;
+		title?: string;
+		description?: string;
+	}
+
+	/** `defence-housing` as a reader would first read it: "Defence housing". */
+	function titleOf(choice: CollectionChoice): string {
+		const given = choice.title?.trim();
+		if (given) return given;
+		const words = choice.name.replace(/[-_]+/g, ' ').trim();
+		return words ? words[0]!.toLocaleUpperCase() + words.slice(1) : choice.name;
 	}
 
 	interface Props {
@@ -121,7 +132,7 @@
 	// Who the question is put to: every collection the person may read, or one
 	// of them. A person with one collection (or none) has nothing to pick, so
 	// the row renders nothing rather than a chip that only reselects itself.
-	// A collection is shown by its summary, the words a reader knows it by.
+	// A collection is shown by its title, the words a reader knows it by.
 	const hasChoice = $derived(collections.length > 1);
 
 	// Three chips in a narrow column clipped all three to fragments
@@ -323,9 +334,10 @@
 							class="ds-lib-scope-chip"
 							aria-pressed={collection === choice.name}
 							class:is-chosen={collection === choice.name}
+							title={choice.description || undefined}
 							onclick={() => oncollection?.(choice.name)}
 						>
-							{choice.summary || choice.name}
+							{titleOf(choice)}
 						</button>
 					{/each}
 				</div>

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

@@ -1,9 +1,12 @@
 import { type ChatCopy } from '../../copy';
 /** A collection a person may read, as the app lists it: `name` is what a
- *  question is narrowed to, `summary` is what the picker shows. */
+ *  question is narrowed to, `title` is what the picker shows (the name,
+ *  made readable, where there is none) and `description` is its one-line
+ *  hover. A retrieval summary is never a field here: it is filing history. */
 export interface CollectionChoice {
     name: string;
-    summary: string;
+    title?: string;
+    description?: string;
 }
 interface Props {
     value: string;

package/dist/copy.d.ts

@@ -43,7 +43,7 @@ export interface ChatCopy {
     answeringPlaceholder: string;
     /** The composer's collection picker: its group's accessible name, and the
      *  choice that asks across everything the person may read. A collection is
-     *  shown by its own summary, supplied by the app. */
+     *  shown by its own title, supplied by the app. */
     collectionsLabel: string;
     allCollections: string;
     /** Past a few turns, the quiet line above the composer that offers to

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@poodle64/librarian",
-	"version": "2026.10.0",
+	"version": "2026.10.1",
 	"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",