@poodle64/librarian 2026.9.5 → 2026.9.6

package/README.md

@@ -135,4 +135,18 @@ pnpm run test    # build + vitest
 
 1. Change a component; bump `version` in `package.json` (CalVer).
 2. `pnpm build`, which runs `svelte-package` then `publint`.
-3. Commit, tag `librarian-v<version>`, push the tag; CI publishes to public npm.
+3. Commit, tag `librarian-v<version>`, push the tag.
+4. `.github/workflows/publish.yaml` runs on that push and should publish via
+   npm OIDC trusted publishing: check it with
+   `gh run list --workflow=publish.yaml`. As of 2026.9.5 every run since
+   `ui-v2026.9.2` fails at the `npm publish` step with
+   `E404 Not Found - PUT .../@poodle64%2flibrarian` (an OIDC/trusted-publisher
+   binding issue, since `Build and test package` passes first). Until that
+   is diagnosed and fixed, publish manually from `packages/librarian/`:
+   ```bash
+   printf '//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}\n' > .npmrc
+   signet exec --identity huginn-claude --broker https://portcullis.godswood.au \
+     --credential npm-publish-token --env-var NODE_AUTH_TOKEN -- npm publish
+   rm -f .npmrc
+   ```
+   Confirm with `npm view @poodle64/librarian version`.

package/dist/client.js

@@ -23,7 +23,7 @@ export async function* ask(options) {
         signal: options.signal
     });
     if (!response.ok || !response.body) {
-        yield { type: 'library_error', error: `The agent answered ${response.status}.` };
+        yield { type: 'library_error', error: "Milton can't be reached right now." };
         return;
     }
     const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();

package/dist/components/composer/composer.svelte

@@ -39,16 +39,16 @@
 		onstop
 	}: Props = $props();
 
-	// What the agent is being asked about — chat with this document, this
-	// collection, or the whole library. Callers that have no narrower scope
-	// pass neither name, leaving "All collections" the sole entry — and a
-	// sole entry is not a choice, so `hasChoice` below hides it rather than
-	// rendering a chip with nothing to switch to.
+	// What Milton is being asked about — this document, this collection, or
+	// the whole library. Callers that have no narrower scope pass neither
+	// name, leaving "The whole library" the sole entry — and a sole entry is
+	// not a choice, so `hasChoice` below hides it rather than rendering a
+	// chip with nothing to switch to.
 	const choices = $derived(
 		[
 			documentName ? { id: 'document' as const, label: documentName } : null,
 			collectionName ? { id: 'collection' as const, label: collectionName } : null,
-			{ id: 'library' as const, label: 'All collections' }
+			{ id: 'library' as const, label: 'The whole library' }
 		].filter((c) => c !== null)
 	);
 
@@ -79,7 +79,7 @@
 		bind:value
 		onkeydown={keydown}
 		rows="2"
-		placeholder={running ? 'Queue another message…' : 'Ask anything'}
+		placeholder={running ? 'Queue another message…' : 'Ask Milton…'}
 		class="text-foreground placeholder:text-muted-foreground max-h-52 w-full resize-none bg-transparent px-4 pt-3 pb-2 text-base outline-none"
 	></textarea>
 

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

@@ -5,14 +5,13 @@
   dimmed sub-line. Borders and badge pills make a run of five calls read as
   five separate events rather than one train of thought.
 
-  The row says what the agent is DOING, not what it typed. A reader here is
-  asking about documents, not reading a terminal, and `Bash ls -1 .` looks
-  like a leak from the machine room. The raw command is one click away, so
-  nothing is hidden from anyone who wants it.
+  The row says what Milton DID, in a reader's own words — never the tool's
+  name or the raw command it ran. Expanding a settled row shows what came
+  back, never what was typed.
 -->
 <script lang="ts">
 	import ChevronRightIcon from '@lucide/svelte/icons/chevron-right';
-	import { describe, summarise, type ToolBlock } from '../../transcript.svelte';
+	import { describe, type ToolBlock } from '../../transcript.svelte';
 
 	interface Props {
 		block: ToolBlock;
@@ -53,17 +52,12 @@
 		<span class="text-muted-foreground truncate">
 			<span class="text-foreground font-medium">{said.verb}</span>
 			{#if said.object}<span class="text-foreground/80">{said.object}</span>{/if}
-			{#if repeats > 1}<span class="text-muted-foreground">· {repeats} sections</span>{/if}
+			{#if repeats > 1}<span class="text-muted-foreground">· {repeats} pages</span>{/if}
 		</span>
 	</button>
 
 	{#if open}
 		<div class="border-border mt-1 ml-5.5 border-l pl-3">
-			<!-- The real command, for anyone who wants it. -->
-			<p class="text-muted-foreground font-mono text-xs break-all">
-				{block.name}
-				{summarise(block)}
-			</p>
 			{#if block.result}
 				<pre
 					class="text-muted-foreground mt-1 max-h-72 overflow-auto font-mono text-xs whitespace-pre-wrap">{block.result}</pre>

package/dist/components/working/working.svelte

@@ -18,15 +18,7 @@
 
 	let { label }: Props = $props();
 
-	const WORDS = [
-		'Starting',
-		'Reading the shelves',
-		'Rummaging',
-		'Cross-checking',
-		'Thumbing pages',
-		'Following a reference',
-		'Chasing it down'
-	];
+	const WORDS = ['Milton is looking', 'Milton is reading'];
 
 	let tick = $state(0);
 	let elapsed = $state(0);

package/dist/transcript.svelte.d.ts

@@ -34,12 +34,13 @@ export interface Outcome {
     isError?: boolean;
     error?: string;
 }
-/** What the agent is DOING, in words a reader who has never seen a shell knows.
+/** What Milton 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. The raw command is still one click away on expand, so this
- * hides nothing — it just stops the transcript opening with jargon.
+ * the machine room. Milton never narrates how he searched, so a tool this
+ * does not recognise falls back to something that names no mechanism at all.
  */
 export declare function describe(block: ToolBlock): {
     verb: string;
@@ -101,5 +102,9 @@ export type Segment = ActivityGroup | TextBlock;
  *    steps with the same label collapse to one row carrying a count.
  */
 export declare function segment(blocks: Block[]): Segment[];
-/** One line describing a whole investigation, for the collapsed state. */
+/** One line describing a whole investigation, for the collapsed state.
+ *
+ * Counts of what Milton did are fine ("1 search · 2 documents read"); how he
+ * organises what he knows is not — no collection count, no shelf, no corpus.
+ */
 export declare function summariseActivity(group: ActivityGroup): string;

package/dist/transcript.svelte.js

@@ -6,43 +6,44 @@
  * deltas that belong to each. An event type this does not know about is kept
  * verbatim under `other`, so nothing is silently dropped.
  */
-/** What the agent is DOING, in words a reader who has never seen a shell knows.
+/** What Milton 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. The raw command is still one click away on expand, so this
- * hides nothing — it just stops the transcript opening with jargon.
+ * the machine room. Milton never narrates how he searched, so a tool this
+ * does not recognise falls back to something that names no mechanism at all.
  */
 export function describe(block) {
     const input = parseInput(block);
     const command = typeof input.command === 'string' ? input.command : '';
     if (block.name === 'Read') {
         const path = str(input.file_path ?? input.path);
-        return { verb: 'Reading', object: documentName(path) };
+        return { verb: 'Read', object: documentName(path) };
     }
     if (block.name === 'Grep') {
-        return { verb: 'Searching for', object: str(input.pattern) };
+        return { verb: 'Looked for', object: str(input.pattern) };
     }
     if (block.name === 'Glob') {
-        return { verb: 'Looking for files', object: str(input.pattern) };
+        return { verb: 'Looked for documents', object: '' };
     }
     if (block.name === 'Bash') {
         if (/\bgrep\b|\brg\b/.test(command)) {
             const quoted = command.match(/["']([^"']{2,60})["']/);
-            return { verb: 'Searching for', object: quoted?.[1] ?? 'a phrase' };
+            return { verb: 'Looked for', object: quoted?.[1] ?? 'a phrase' };
         }
         if (/\bls\b/.test(command))
-            return { verb: 'Listing', object: listTarget(command) };
+            return { verb: 'Looked through the library', object: '' };
         if (/\bfind\b/.test(command))
-            return { verb: 'Looking for files', object: '' };
+            return { verb: 'Looked for documents', object: '' };
         if (/\bcat\b|\bhead\b|\bsed\b/.test(command)) {
-            return { verb: 'Reading', object: documentName(lastPath(command)) };
+            return { verb: 'Read', object: documentName(lastPath(command)) };
         }
         if (/\bwc\b/.test(command))
-            return { verb: 'Counting', object: '' };
-        return { verb: 'Running a command', object: '' };
+            return { verb: 'Checked', object: '' };
+        return { verb: 'Looked into it', object: '' };
     }
-    return { verb: block.name, object: summarise(block) };
+    return { verb: 'Looked into it', object: '' };
 }
 function parseInput(block) {
     try {
@@ -64,12 +65,6 @@ function documentName(path) {
         return prettify(segments.at(-2) ?? '');
     return prettify(page.replace(/\.md$/, ''));
 }
-function listTarget(command) {
-    const target = command.trim().split(/\s+/).at(-1) ?? '';
-    if (!target || target === '.' || target.startsWith('-'))
-        return 'the collections';
-    return prettify(target.replace(/\/$/, ''));
-}
 function lastPath(command) {
     return (command
         .split(/\s+/)
@@ -155,7 +150,7 @@ export class Transcript {
             return;
         }
         if (event.type === 'library_error') {
-            this.outcome = { isError: true, error: event.error ?? 'the agent failed' };
+            this.outcome = { isError: true, error: event.error ?? "Milton can't be reached right now." };
             return;
         }
         // A tool RESULT arrives as a user message carrying tool_result blocks.
@@ -289,9 +284,9 @@ function sameStep(a, b) {
 }
 function tally(group, block) {
     const { verb } = describe(block);
-    if (verb === 'Searching for')
+    if (verb === 'Looked for')
         group.searches += 1;
-    if (verb === 'Reading')
+    if (verb === 'Read')
         group.documents += 1;
     const collection = collectionOf(block);
     if (collection && !group.collections.includes(collection))
@@ -303,14 +298,16 @@ function collectionOf(block) {
     const match = raw.match(/(?:^|["'\s/])([a-z0-9]+(?:-[a-z0-9]+)+)\/local\//);
     return match?.[1] ?? '';
 }
-/** One line describing a whole investigation, for the collapsed state. */
+/** One line describing a whole investigation, for the collapsed state.
+ *
+ * Counts of what Milton did are fine ("1 search · 2 documents read"); how he
+ * organises what he knows is not — no collection count, no shelf, no corpus.
+ */
 export function summariseActivity(group) {
     const parts = [];
     if (group.searches)
         parts.push(`${group.searches} search${group.searches === 1 ? '' : 'es'}`);
     if (group.documents)
         parts.push(`${group.documents} document${group.documents === 1 ? '' : 's'} read`);
-    if (group.collections.length)
-        parts.push(`${group.collections.length} collection${group.collections.length === 1 ? '' : 's'}`);
-    return parts.length ? parts.join(' · ') : 'Worked on it';
+    return parts.length ? parts.join(' · ') : 'Looked into it';
 }

package/package.json

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