@poodle64/librarian 2026.9.5 → 2026.9.7

package/dist/transcript.svelte.js

@@ -6,43 +6,62 @@
  * 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.
+/**
+ * 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
+ * blank-line-separated paragraphs addressed to the model are dropped.
+ *
+ * The LAST paragraph is never dropped, whatever it starts with: someone whose
+ * entire question is "You are wrong about the leave rule" must still see it.
+ */
+export function readerQuestion(question) {
+    const parts = question.split(/\n{2,}/);
+    let start = 0;
+    while (start < parts.length - 1 && /^(you are|you're|your role|act as|system:)\b/i.test(parts[start].trim()))
+        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
+ * 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 +83,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+/)
@@ -123,6 +136,8 @@ export class Transcript {
     sessionId = $state(null);
     model = $state(null);
     outcome = $state(null);
+    /** Sources for the answer, from the library's own `citations` frame. */
+    citations = $state([]);
     other = $state([]);
     /** Content-block index is per MESSAGE, so it repeats across turns; this
      * maps the live index onto a position in the flat list. Cleared whenever a
@@ -135,6 +150,7 @@ export class Transcript {
     reset() {
         this.blocks = [];
         this.outcome = null;
+        this.citations = [];
         this.other = [];
         this.#open.clear();
     }
@@ -154,8 +170,14 @@ export class Transcript {
             };
             return;
         }
+        // Emitted after the final assistant text, so it lands on a turn that is
+        // otherwise complete.
+        if (event.type === 'citations') {
+            this.citations = event.items ?? [];
+            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 +311,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 +325,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.7",
 	"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",
@@ -30,6 +30,18 @@
 			"types": "./dist/history.svelte.d.ts",
 			"svelte": "./dist/history.svelte.js"
 		},
+		"./citations": {
+			"types": "./dist/citations.d.ts",
+			"svelte": "./dist/citations.js"
+		},
+		"./attachments": {
+			"types": "./dist/attachments.d.ts",
+			"svelte": "./dist/attachments.js"
+		},
+		"./follow-scroll": {
+			"types": "./dist/follow-scroll.svelte.d.ts",
+			"svelte": "./dist/follow-scroll.svelte.js"
+		},
 		"./*": {
 			"types": "./dist/components/*/index.d.ts",
 			"svelte": "./dist/components/*/index.js"
@@ -55,6 +67,7 @@
 		"isomorphic-dompurify": "^3.23.0",
 		"jsdom": "^29.1.1",
 		"marked": "^18.0.11",
+		"playwright": "^1.62.0",
 		"publint": "^0.3.15",
 		"shiki": "^4.4.3",
 		"svelte": "^5.56.2",
@@ -67,7 +80,8 @@
 		"build": "svelte-kit sync && svelte-package && publint",
 		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
 		"test": "pnpm run build && vitest run",
-		"prepublishOnly": "pnpm run build"
+		"prepublishOnly": "pnpm run build",
+		"screenshots": "node scripts/screenshots.mjs"
 	},
 	"packageManager": "pnpm@10.28.0"
 }