@poodle64/librarian 2026.9.20 → 2026.9.21

package/README.md

@@ -187,7 +187,10 @@ is watched rather than asked. `watch()` GETs its stream; `Session` folds it
 into turns: the prompt and every later message on the reader's side (the CLI
 echoes each one back under `--replay-user-messages`), each run's answer on the
 persona's, each settled by its own `result`. A stream without deltas is folded
-from its whole messages. Events are deduped by `uuid`, so opening the watch
+from its whole messages. A run under `--json-schema` hands in its answer by
+calling the CLI's `StructuredOutput` tool: that call is no step of the work,
+the words before it stay the answer, and what it handed in is the run's
+`outcome.structuredOutput`, the natural source of the host's `artefact`. Events are deduped by `uuid`, so opening the watch
 again after sending a message folds only what is new.
 
 ```svelte
@@ -413,7 +416,7 @@ pnpm run test         # build + vitest
 pnpm run screenshots  # the state grid, real engine (see below)
 ```
 
-`docs/screenshots/` is sixteen states x three widths x both themes, taken by
+`docs/screenshots/` is seventeen states x three widths x both themes, taken by
 `scripts/screenshots.mjs` against the console's `/librarian` lab route
 running from its own static build. The same script asserts what a screenshot
 cannot: that nothing scrolls sideways at any width, that the source pane

package/dist/components/agent-transcript/agent-transcript.svelte

@@ -186,9 +186,11 @@
 			: (outcome?.error ?? (outcome?.isError ? words.answerFailed : null))
 	);
 
-	// A failed turn settles too, and "Ask again" is the one thing a reader wants
-	// from it — there is just nothing to copy.
-	const settled = $derived(!running && (hasAnswer || Boolean(failure)));
+	// A run that ended has settled, whatever it said: a failed one, where "Ask
+	// again" is the one thing a reader wants, and one that handed in its answer
+	// under a schema and said nothing at all, whose artefact is the answer. A
+	// turn read back from history has no outcome and settles on its prose.
+	const settled = $derived(!running && (hasAnswer || outcome !== null));
 
 	/**
 	 * The persona answered and cited nothing, and we WATCHED it happen.

package/dist/session.svelte.js

@@ -55,6 +55,12 @@ export class Session {
         }
         if (!FOLDED.has(event.type))
             return;
+        // A user frame that is neither a replayed message nor a tool's result is
+        // the CLI nudging its own model (`isSynthetic`: "[structured-output-
+        // enforce] You MUST call the StructuredOutput tool…"): neither side of
+        // the conversation.
+        if (event.type === 'user' && !contentOf(event).some((b) => b.type === 'tool_result'))
+            return;
         // Settled by its own `result`. A stream that broke mid-run is not: the
         // run goes on, and a watch opened again folds the rest onto it.
         const last = this.turns.at(-1);

package/dist/transcript.svelte.js

@@ -366,9 +366,11 @@ export function segment(blocks, describeTool) {
     let current = null;
     let lastTool = -1;
     for (let i = 0; i < blocks.length; i += 1)
-        if (blocks[i].kind === 'tool')
+        if (isStep(blocks[i]))
             lastTool = i;
     for (const [i, block] of blocks.entries()) {
+        if (block.kind === 'tool' && !isStep(block))
+            continue;
         if (block.kind === 'text' && i > lastTool) {
             current = null;
             out.push(block);
@@ -397,6 +399,18 @@ export function segment(blocks, describeTool) {
     }
     return out;
 }
+/**
+ * The tool the CLI adds under `--json-schema`. Calling it hands in the run's
+ * answer, which arrives again whole on the `result` (`structured_output`): it
+ * is not a step of the work, and the words before it are the answer, not
+ * narration ahead of more work. Measured on Claude Code 2.1.283, where a run
+ * with a schema always ends in this call.
+ */
+const HANDS_IN = 'StructuredOutput';
+/** A call that is part of the work, rather than the handing-in of its answer. */
+function isStep(block) {
+    return block.kind === 'tool' && block.name !== HANDS_IN;
+}
 function sameStep(last, block, words) {
     if (last.block.kind !== block.kind)
         return false;
@@ -436,7 +450,7 @@ export function summariseActivity(group) {
 export function readFrom(blocks, describeTool) {
     const out = [];
     for (const block of blocks) {
-        if (block.kind !== 'tool' || block.result === undefined || block.isError)
+        if (block.kind !== 'tool' || !isStep(block) || block.result === undefined || block.isError)
             continue;
         const source = wordsFor(block, describeTool).source;
         if (!source || out.some((c) => c.document_id === source.id))

package/package.json

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