@danypops/pi-papyrus 0.59.1 → 0.59.3

package/extension/src/index.ts

@@ -152,6 +152,7 @@ export function buildTaskWidgetSection(
 export class TaskOverlay {
 	private widgetGroup: PapyrusWidgetGroup | undefined;
 	private snapshot: TaskGraph = { nodes: [], rootIds: [] };
+	private degraded = false;
 	private projectRoot: string | undefined;
 	private sessionId: string | undefined;
 	private generation = 0;
@@ -188,7 +189,8 @@ export class TaskOverlay {
 		if (!this.projectRoot) return;
 		const generation = this.generation;
 		const sessionId = this.sessionId;
-		let snapshot: TaskGraph;
+		let snapshot = this.snapshot;
+		let degraded = false;
 		try {
 			snapshot = await callServicePassive<Record<string, unknown>, TaskGraph>("tasks.graph", {
 				limit: 500,
@@ -196,10 +198,11 @@ export class TaskOverlay {
 				session_id: sessionId,
 			});
 		} catch {
-			snapshot = { nodes: [], rootIds: [] };
+			degraded = true;
 		}
 		if (generation !== this.generation) return;
 		this.snapshot = snapshot;
+		this.degraded = degraded;
 		try {
 			this.widgetGroup?.requestUpdate();
 		} catch {
@@ -225,12 +228,15 @@ export class TaskOverlay {
 	/** Theme-free existence check -- PapyrusWidgetGroup's own eager (pre-paint) hide decision needs
 	 * this without needing a theme, which is only ever available inside the widget's own render(width). */
 	hasOpenWork(): boolean {
-		return buildTaskWidgetProjection(this.snapshot).openTotal > 0;
+		return this.degraded || buildTaskWidgetProjection(this.snapshot).openTotal > 0;
 	}
 
-	/** undefined when there is no open work to show -- PapyrusWidgetGroup's own signal to omit this section entirely. */
+	/** Returns current tasks, retaining stale rows or an unavailable status while the service recovers. */
 	buildSection(theme: Theme): WidgetSection | undefined {
-		return buildTaskWidgetSection(theme, buildTaskWidgetProjection(this.snapshot), this.rotation);
+		const section = buildTaskWidgetSection(theme, buildTaskWidgetProjection(this.snapshot), this.rotation);
+		if (section) return this.degraded ? { ...section, label: `${section.label} · stale` } : section;
+		if (this.degraded) return { label: "Tasks · unavailable", render: () => ["Papyrus service unavailable; retrying."] };
+		return undefined;
 	}
 
 	/**
@@ -267,6 +273,7 @@ export class NoteOverlay {
 	private widgetGroup: PapyrusWidgetGroup | undefined;
 	private notes: NoteWidgetRow[] = [];
 	private totalOpenCount = 0;
+	private degraded = false;
 	private projectRoot: string | undefined;
 	private generation = 0;
 	private readonly poll = new BoundedPoll();
@@ -289,8 +296,9 @@ export class NoteOverlay {
 		if (!this.projectRoot) return;
 		const generation = this.generation;
 		const projectRoot = this.projectRoot;
-		let notes: NoteWidgetRow[] = [];
-		let totalOpenCount = 0;
+		let notes = this.notes;
+		let totalOpenCount = this.totalOpenCount;
+		let degraded = false;
 		try {
 			const rows = await callServicePassive<Record<string, unknown>, Artifact[]>("notes.list", {
 				project_root: projectRoot,
@@ -299,11 +307,12 @@ export class NoteOverlay {
 			totalOpenCount = rows.length;
 			notes = rows.slice(0, NOTE_WIDGET_OPEN_LIMIT).map((row) => ({ id: row.id, title: row.title }));
 		} catch {
-			// A missing daemon is the normal passive-startup case.
+			degraded = true;
 		}
 		if (generation !== this.generation) return;
 		this.totalOpenCount = totalOpenCount;
 		this.notes = notes;
+		this.degraded = degraded;
 		try {
 			this.widgetGroup?.requestUpdate();
 		} catch {
@@ -313,12 +322,15 @@ export class NoteOverlay {
 
 	/** Theme-free existence check -- see TaskOverlay's own hasOpenWork() for why this needs to stay theme-free. */
 	hasOpenNotes(): boolean {
-		return this.totalOpenCount > 0;
+		return this.degraded || this.totalOpenCount > 0;
 	}
 
-	/** undefined when there are no open notes -- PapyrusWidgetGroup's own signal to omit this section entirely. */
+	/** Returns current notes, retaining stale rows or an unavailable status while the service recovers. */
 	buildSection(): WidgetSection | undefined {
-		return buildNoteWidgetSection(this.notes, this.totalOpenCount, this.rotation);
+		const section = buildNoteWidgetSection(this.notes, this.totalOpenCount, this.rotation);
+		if (section) return this.degraded ? { ...section, label: `${section.label} · stale` } : section;
+		if (this.degraded) return { label: "Notes · unavailable", render: () => ["Papyrus service unavailable; retrying."] };
+		return undefined;
 	}
 
 	startPolling(intervalMs: number = NOTE_WIDGET_POLL_INTERVAL_MS): void {

package/extension/src/tool-rendering/index.ts

@@ -53,6 +53,8 @@ function simpleDetailsText(details: Exclude<PapyrusToolDetails, { kind: "artifac
 			].join("\n");
 		case "preview":
 			return `${details.title}\n${details.content}${details.completeness.truncated ? `\n[truncated ${details.completeness.omitted} characters]` : ""}`;
+		case "semantic-text":
+			return details.text;
 		case "error":
 			return `${details.code}: ${details.message}`;
 		case "execution-plan":

package/extension/src/tool-rendering/render-model/index.ts

@@ -18,6 +18,7 @@ import { type GraphToolDetails, isGraphEdge } from "./graph.ts";
 import type { LeaseToolDetails } from "./lease.ts";
 import type { ErrorToolDetails, NoFocusToolDetails, PreviewToolDetails } from "./misc.ts";
 import type { InvocationToolDetails, PlaybookInvocationToolDetails, PlaybookMissingArgumentsToolDetails } from "./playbook.ts";
+import type { SemanticTextToolDetails } from "./semantic-text.ts";
 import {
 	isArtifactSummary,
 	isBoundedArray,
@@ -51,7 +52,8 @@ export type PapyrusToolDetails =
 	| DiscussionToolDetails
 	| TaskCompletionToolDetails
 	| NoFocusToolDetails
-	| LeaseToolDetails;
+	| LeaseToolDetails
+	| SemanticTextToolDetails;
 
 /** Validate renderer details restored from session history before using them as typed presentation state. */
 export function parsePapyrusToolDetails(value: unknown): PapyrusToolDetails | undefined {
@@ -176,6 +178,10 @@ export function parsePapyrusToolDetails(value: unknown): PapyrusToolDetails | un
 				(value.note === undefined || isBoundedString(value.note))
 				? (value as unknown as LeaseToolDetails)
 				: undefined;
+		case "semantic-text":
+			return isBoundedString(value.text, TOOL_DETAILS_BODY_MAX_CHARACTERS) && isCompleteness(value.completeness)
+				? (value as unknown as SemanticTextToolDetails)
+				: undefined;
 		default:
 			return undefined;
 	}
@@ -212,6 +218,7 @@ export {
 	type PlaybookMissingArgumentsToolDetails,
 	type ToolInvocationCreated,
 } from "./playbook.ts";
+export { createSemanticTextDetails, type SemanticTextToolDetails } from "./semantic-text.ts";
 export {
 	type ArtifactFocusAnnotation,
 	createModelContent,

package/extension/src/tool-rendering/render-model/semantic-text.ts

@@ -0,0 +1,20 @@
+import { TOOL_DETAILS_BODY_MAX_CHARACTERS } from "@danypops/papyrus";
+import { boundedText, PAPYRUS_TOOL_DETAILS_SCHEMA, type ResultCompleteness, type ToolDetailsBase } from "./shared.ts";
+
+/** Carries an operation's bounded semantic text channel for human presentation. */
+export interface SemanticTextToolDetails extends ToolDetailsBase {
+	kind: "semantic-text";
+	text: string;
+	completeness: ResultCompleteness;
+}
+
+export function createSemanticTextDetails(operation: string, text: string): SemanticTextToolDetails {
+	const bounded = boundedText(text, TOOL_DETAILS_BODY_MAX_CHARACTERS);
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "semantic-text",
+		operation,
+		text: bounded.value,
+		completeness: bounded.completeness,
+	};
+}

package/extension/src/tools/renderers/index.ts

@@ -33,8 +33,9 @@ import {
 	createNoFocusDetails,
 	createPlaybookInvocationDetails,
 	createPlaybookMissingArgumentsDetails,
-	createPreviewDetails,
+	createSemanticTextDetails,
 	createTaskCompletionDetails,
+	type PapyrusToolDetails,
 	parsePapyrusToolDetails,
 } from "../../tool-rendering/render-model.ts";
 import { recordRenderDiagnostic, shapeFingerprint } from "../render-diagnostics.ts";
@@ -52,7 +53,16 @@ import {
 	renderPlaybookInvocationResult,
 	renderPlaybookMissingArguments,
 } from "./playbook.ts";
-import { boundedJsonPreview, focusAnnotation, isArtifact, isArtifactArray, isTaskFocus, renderNoFocusedTask } from "./shared.ts";
+import {
+	boundedJsonPreview,
+	focusAnnotation,
+	isArtifact,
+	isArtifactArray,
+	isSemanticTextOutput,
+	isTaskFocus,
+	renderNoFocusedTask,
+	semanticText,
+} from "./shared.ts";
 import { isTaskCompletion, renderTaskCompletion } from "./task-completion.ts";
 import { isTaskExecutionPlan, renderTaskExecutionPlan } from "./task-execution.ts";
 
@@ -133,17 +143,16 @@ export function papyrusVehicleRenderers(descriptor: VehicleOperationDescriptor):
  * before Pi ever persists it -- the seam papyrusVehicleRenderers' own renderResult never had
  * (it only converts shape at render time, from whatever the legacy {vehicle, output} path
  * already persisted verbatim, lease tokens and all). Every branch here mirrors the same
- * shape-detection papyrusVehicleRenderers's own renderResult uses, so the two stay in lockstep;
- * anything genuinely unmatched still becomes a real, bounded PreviewToolDetails rather than an
- * unprojected raw passthrough -- the one requirement this whole seam exists to satisfy.
+ * shape-detection papyrusVehicleRenderers's own renderResult uses, plus the server's explicit
+ * semantic text channel. An output matching no legal discriminated-union variant fails closed
+ * instead of silently persisting and rendering raw JSON.
  */
-function projectPapyrusPresentation(descriptor: VehicleOperationDescriptor, output: unknown): JsonValue {
-	if (isArtifactArray(output)) return createArtifactListDetails(descriptor.name, output) as unknown as JsonValue;
-	if (isArtifact(output)) return createArtifactDetails(descriptor.name, output) as unknown as JsonValue;
-	if (isTaskFocus(output)) return createArtifactDetails(descriptor.name, output.artifact, focusAnnotation(output)) as unknown as JsonValue;
-	if (output === null && descriptor.name === "tasks.focused") return createNoFocusDetails(descriptor.name) as unknown as JsonValue;
-	if (isTaskExecutionPlan(output))
-		return createExecutionPlanDetails(descriptor.name, output.nodes, output.layers, output.cycleIds) as unknown as JsonValue;
+function projectPapyrusPresentation(descriptor: VehicleOperationDescriptor, output: unknown): PapyrusToolDetails {
+	if (isArtifactArray(output)) return createArtifactListDetails(descriptor.name, output);
+	if (isArtifact(output)) return createArtifactDetails(descriptor.name, output);
+	if (isTaskFocus(output)) return createArtifactDetails(descriptor.name, output.artifact, focusAnnotation(output));
+	if (output === null && descriptor.name === "tasks.focused") return createNoFocusDetails(descriptor.name);
+	if (isTaskExecutionPlan(output)) return createExecutionPlanDetails(descriptor.name, output.nodes, output.layers, output.cycleIds);
 	if (isPlaybookInvocationResult(output)) {
 		return createPlaybookInvocationDetails(descriptor.name, {
 			playbookId: output.playbookId,
@@ -152,18 +161,18 @@ function projectPapyrusPresentation(descriptor: VehicleOperationDescriptor, outp
 			rootTaskIds: output.rootTaskIds,
 			entryTaskId: output.entryTaskId,
 			execution: output.execution,
-		}) as unknown as JsonValue;
+		});
 	}
 	if (isPlaybookMissingArguments(output)) {
-		return createPlaybookMissingArgumentsDetails(descriptor.name, output.playbookId, output.missingArguments) as unknown as JsonValue;
+		return createPlaybookMissingArgumentsDetails(descriptor.name, output.playbookId, output.missingArguments);
 	}
-	if (isDiscussionAndRounds(output))
-		return createDiscussionDetails(descriptor.name, output.rounds, output.discussion) as unknown as JsonValue;
-	if (isDiscussionRoundsOnly(output)) return createDiscussionDetails(descriptor.name, output.rounds) as unknown as JsonValue;
-	if (isDiscussionListOutput(output)) return createArtifactListDetails(descriptor.name, output.discussions) as unknown as JsonValue;
-	if (isTaskCompletion(output)) return createTaskCompletionDetails(descriptor.name, output) as unknown as JsonValue;
-	if (isTaskLeaseView(output)) return createLeaseDetails(descriptor.name, output) as unknown as JsonValue;
-	return createPreviewDetails(descriptor.name, descriptor.name, boundedJsonPreview(output)) as unknown as JsonValue;
+	if (isDiscussionAndRounds(output)) return createDiscussionDetails(descriptor.name, output.rounds, output.discussion);
+	if (isDiscussionRoundsOnly(output)) return createDiscussionDetails(descriptor.name, output.rounds);
+	if (isDiscussionListOutput(output)) return createArtifactListDetails(descriptor.name, output.discussions);
+	if (isTaskCompletion(output)) return createTaskCompletionDetails(descriptor.name, output);
+	if (isTaskLeaseView(output)) return createLeaseDetails(descriptor.name, output);
+	if (isSemanticTextOutput(output)) return createSemanticTextDetails(descriptor.name, semanticText(output));
+	throw new Error(`${descriptor.name} produced no legal presentation variant`);
 }
 
 function renderFromPapyrusPresentation(
@@ -194,15 +203,19 @@ function renderFromPapyrusPresentation(
 			return renderLease(presentation, theme);
 		case "preview":
 			return new Text(theme.fg("toolOutput", presentation.content), 0, 0);
+		case "semantic-text":
+			return new Text(theme.fg("toolOutput", presentation.text), 0, 0);
 		case "transition":
 		case "graph":
 		case "gate-run":
 		case "invocation":
 		case "error":
-			// Reachable only if a future caller starts producing these kinds through this seam
-			// (today's Papyrus Vehicle outputs never do) -- a bounded JSON preview is still a
-			// real, safe rendering rather than a crash.
+			// These variants are produced by native tools and remain valid when replayed through this shared renderer.
 			return new Text(theme.fg("toolOutput", boundedJsonPreview(presentation)), 0, 0);
+		default: {
+			const exhaustive: never = presentation;
+			return exhaustive;
+		}
 	}
 }
 
@@ -218,7 +231,8 @@ export function papyrusVehiclePresentations(descriptor: VehicleOperationDescript
 	return {
 		projector: {
 			maxBytes: TOOL_DETAILS_MAX_SERIALIZED_CHARACTERS,
-			project: (output: unknown, _request: PiVehicleInvocationRequest) => projectPapyrusPresentation(descriptor, output),
+			project: (output: unknown, _request: PiVehicleInvocationRequest) =>
+				projectPapyrusPresentation(descriptor, output) as unknown as JsonValue,
 		},
 		renderResult(result, options, theme, context) {
 			if (!options.isPartial && !context.isError) {

package/extension/src/tools/renderers/shared.ts

@@ -72,6 +72,31 @@ export function renderNoFocusedTask(theme: Theme): Component {
 	return new Text(theme.fg("dim", "No focused task."), 0, 0);
 }
 
+export interface SemanticTextOutput {
+	content: Array<{ type: "text"; text: string }>;
+}
+
+/** Recognizes the server's explicit model-facing semantic channel without projecting sibling payload fields. */
+export function isSemanticTextOutput(value: unknown): value is SemanticTextOutput {
+	if (typeof value !== "object" || value === null) return false;
+	const content = (value as Record<string, unknown>).content;
+	return (
+		Array.isArray(content) &&
+		content.length > 0 &&
+		content.every(
+			(block) =>
+				typeof block === "object" &&
+				block !== null &&
+				(block as Record<string, unknown>).type === "text" &&
+				typeof (block as Record<string, unknown>).text === "string",
+		)
+	);
+}
+
+export function semanticText(output: SemanticTextOutput): string {
+	return output.content.map((block) => block.text).join("\n");
+}
+
 /** What renderDiscussionAndRounds/renderTaskCompletion actually read -- satisfied by both a raw
  * Artifact (the live duck-typed output path) and the leaner projected ToolArtifactSummary (the
  * typed-DTO path), with no cast needed at either call site. */

package/extension/src/tools/vehicle-notes-client.ts

@@ -23,7 +23,6 @@
  * had died.
  */
 
-import { createAgentNotifier } from "@danypops/vehicle-client-pi/agent-poll-ticker";
 import { createReconnectingVehicleClient, daemonInstanceIdentity } from "@danypops/vehicle-client/daemon-client";
 import { RemoteVehicleClient } from "@danypops/vehicle-client/http";
 import {
@@ -32,6 +31,7 @@ import {
 	registerVehicleToolsWhenReady,
 	type VehicleReadyEvent,
 } from "@danypops/vehicle-client-pi";
+import { createAgentNotifier } from "@danypops/vehicle-client-pi/agent-poll-ticker";
 import { VehicleApprovalOutcomePoll } from "@danypops/vehicle-client-pi/vehicle-approval-outcome-poll";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { discussLiveFollowUp } from "../discuss/discuss-live-follow-up.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danypops/pi-papyrus",
-  "version": "0.59.1",
+  "version": "0.59.3",
   "description": "Pi host extension for Papyrus: native tools, TUI panels, and context injection over the daemon-backed graph store",
   "license": "MIT",
   "type": "module",
@@ -20,7 +20,7 @@
   },
   "dependencies": {
     "@danypops/jittor": "^0.19.2",
-    "@danypops/papyrus": "^0.60.7",
+    "@danypops/papyrus": "^0.60.10",
     "@danypops/vehicle-client": "^0.10.3",
     "@danypops/vehicle-core": "^0.18.5",
     "@danypops/vehicle-server": "^0.25.2",