@danypops/pi-papyrus 0.54.1 → 0.55.0

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

@@ -0,0 +1,82 @@
+import { type Artifact, TOOL_DETAILS_BODY_MAX_CHARACTERS, TOOL_DETAILS_MAX_ITEMS } from "@danypops/papyrus";
+import {
+	type ArtifactFocusAnnotation,
+	artifactSummary,
+	boundedText,
+	completeness,
+	PAPYRUS_TOOL_DETAILS_SCHEMA,
+	type ResultCompleteness,
+	type ToolArtifact,
+	type ToolArtifactSummary,
+	type ToolDetailsBase,
+} from "./shared.ts";
+
+export interface ArtifactToolDetails extends ToolDetailsBase {
+	kind: "artifact";
+	artifact: ToolArtifact;
+	completeness: ResultCompleteness;
+	focus?: ArtifactFocusAnnotation;
+}
+
+export interface ArtifactListToolDetails extends ToolDetailsBase {
+	kind: "artifact-list";
+	rows: ToolArtifactSummary[];
+	total: number;
+	completeness: ResultCompleteness;
+}
+
+export interface TransitionToolDetails extends ToolDetailsBase {
+	kind: "transition";
+	artifact: ToolArtifactSummary;
+	fromStatus: string;
+	toStatus: string;
+}
+
+export function createArtifactDetails(operation: string, artifact: Artifact, focus?: ArtifactFocusAnnotation): ArtifactToolDetails {
+	const body = boundedText(artifact.body, TOOL_DETAILS_BODY_MAX_CHARACTERS);
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "artifact",
+		operation,
+		artifact: {
+			...artifactSummary(artifact),
+			body: body.value,
+			createdAt: artifact.created_at,
+			updatedAt: artifact.updated_at,
+		},
+		completeness: body.completeness,
+		...(focus ? { focus } : {}),
+	};
+}
+
+export function createArtifactListDetails(
+	operation: string,
+	artifacts: readonly Artifact[],
+	total = artifacts.length,
+): ArtifactListToolDetails {
+	const rows = artifacts.slice(0, TOOL_DETAILS_MAX_ITEMS).map(artifactSummary);
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "artifact-list",
+		operation,
+		rows,
+		total,
+		completeness: completeness(Math.max(total, artifacts.length), rows.length),
+	};
+}
+
+export function createTransitionDetails(
+	operation: string,
+	artifact: Artifact,
+	fromStatus: string,
+	toStatus: string,
+): TransitionToolDetails {
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "transition",
+		operation,
+		artifact: artifactSummary(artifact),
+		fromStatus,
+		toStatus,
+	};
+}

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

@@ -0,0 +1,49 @@
+import { TOOL_DETAILS_MAX_ITEMS, TOOL_DETAILS_ROW_OUTPUT_MAX_CHARACTERS } from "@danypops/papyrus";
+import {
+	type ArtifactSummarySource,
+	artifactSummary,
+	completeness,
+	isBoundedString,
+	isRecord,
+	PAPYRUS_TOOL_DETAILS_SCHEMA,
+	type ResultCompleteness,
+	type ToolArtifactSummary,
+	type ToolDetailsBase,
+} from "./shared.ts";
+
+export interface DiscussionRoundSummary {
+	roundNumber: number;
+	actor: string;
+	content: string;
+}
+
+export interface DiscussionToolDetails extends ToolDetailsBase {
+	kind: "discussion";
+	/** Absent for discuss.rounds, which returns rounds with no parent discussion in its own output. */
+	discussion?: ToolArtifactSummary;
+	rounds: DiscussionRoundSummary[];
+	completeness: ResultCompleteness;
+}
+
+export function createDiscussionDetails(
+	operation: string,
+	rounds: readonly DiscussionRoundSummary[],
+	discussion?: ArtifactSummarySource,
+): DiscussionToolDetails {
+	const boundedRounds = rounds.slice(0, TOOL_DETAILS_MAX_ITEMS).map((round) => ({
+		...round,
+		content: round.content.slice(0, TOOL_DETAILS_ROW_OUTPUT_MAX_CHARACTERS),
+	}));
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "discussion",
+		operation,
+		...(discussion ? { discussion: artifactSummary(discussion) } : {}),
+		rounds: boundedRounds,
+		completeness: completeness(rounds.length, boundedRounds.length),
+	};
+}
+
+export function isDiscussionRoundSummary(value: unknown): value is DiscussionRoundSummary {
+	return isRecord(value) && Number.isSafeInteger(value.roundNumber) && isBoundedString(value.actor) && isBoundedString(value.content);
+}

package/extension/src/tool-rendering/render-model/execution-plan.ts

@@ -0,0 +1,88 @@
+import { TOOL_DETAILS_MAX_ITEMS } from "@danypops/papyrus";
+import {
+	boundedStringArray,
+	completeness,
+	isBoundedArray,
+	isBoundedString,
+	isRecord,
+	isStringArray,
+	PAPYRUS_TOOL_DETAILS_SCHEMA,
+	type ResultCompleteness,
+	type ToolDetailsBase,
+} from "./shared.ts";
+
+export interface ExecutionPlanNode {
+	id: string;
+	title: string;
+	status: string;
+	active: boolean;
+	state: string;
+	layer: number | null;
+	prerequisiteIds: string[];
+	successorIds: string[];
+}
+
+export interface ExecutionPlanToolDetails extends ToolDetailsBase {
+	kind: "execution-plan";
+	nodes: ExecutionPlanNode[];
+	layers: string[][];
+	cycleIds: string[];
+	completeness: ResultCompleteness;
+}
+
+export function boundedExecutionPlanNodes(nodes: readonly ExecutionPlanNode[]): ExecutionPlanNode[] {
+	return nodes.slice(0, TOOL_DETAILS_MAX_ITEMS).map((node) => ({
+		...node,
+		prerequisiteIds: boundedStringArray(node.prerequisiteIds),
+		successorIds: boundedStringArray(node.successorIds),
+	}));
+}
+
+export function boundedLayers(layers: readonly (readonly string[])[]): string[][] {
+	return layers.slice(0, TOOL_DETAILS_MAX_ITEMS).map((layer) => boundedStringArray(layer));
+}
+
+export function createExecutionPlanDetails(
+	operation: string,
+	nodes: readonly ExecutionPlanNode[],
+	layers: readonly (readonly string[])[],
+	cycleIds: readonly string[],
+): ExecutionPlanToolDetails {
+	const boundedNodes = boundedExecutionPlanNodes(nodes);
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "execution-plan",
+		operation,
+		nodes: boundedNodes,
+		layers: boundedLayers(layers),
+		cycleIds: boundedStringArray(cycleIds),
+		completeness: completeness(nodes.length, boundedNodes.length),
+	};
+}
+
+export function isExecutionPlanNode(value: unknown): value is ExecutionPlanNode {
+	return (
+		isRecord(value) &&
+		isBoundedString(value.id) &&
+		isBoundedString(value.title) &&
+		isBoundedString(value.status) &&
+		typeof value.active === "boolean" &&
+		isBoundedString(value.state) &&
+		(value.layer === null || Number.isSafeInteger(value.layer)) &&
+		isStringArray(value.prerequisiteIds) &&
+		isStringArray(value.successorIds)
+	);
+}
+
+export function isLayers(value: unknown): value is string[][] {
+	return isBoundedArray(value, TOOL_DETAILS_MAX_ITEMS, (entry): entry is string[] => isStringArray(entry));
+}
+
+export function isExecution(value: unknown): value is { nodes: ExecutionPlanNode[]; layers: string[][]; cycleIds: string[] } {
+	return (
+		isRecord(value) &&
+		isBoundedArray(value.nodes, TOOL_DETAILS_MAX_ITEMS, isExecutionPlanNode) &&
+		isLayers(value.layers) &&
+		isStringArray(value.cycleIds)
+	);
+}

package/extension/src/tool-rendering/render-model/gate-run.ts

@@ -0,0 +1,55 @@
+import { TOOL_DETAILS_MAX_ITEMS, TOOL_DETAILS_ROW_OUTPUT_MAX_CHARACTERS } from "@danypops/papyrus";
+import {
+	completeness,
+	isBoundedString,
+	isRecord,
+	PAPYRUS_TOOL_DETAILS_SCHEMA,
+	type ResultCompleteness,
+	type ToolDetailsBase,
+} from "./shared.ts";
+
+export interface ToolGateRow {
+	passed: boolean;
+	type: string;
+	target: string;
+	output: string;
+}
+
+export interface GateRunToolDetails extends ToolDetailsBase {
+	kind: "gate-run";
+	artifactId: string;
+	artifactTitle: string;
+	gates: ToolGateRow[];
+	completeness: ResultCompleteness;
+}
+
+export function createGateRunDetails(
+	operation: string,
+	artifactId: string,
+	artifactTitle: string,
+	gates: readonly ToolGateRow[],
+): GateRunToolDetails {
+	const boundedGates = gates.slice(0, TOOL_DETAILS_MAX_ITEMS).map((gate) => ({
+		...gate,
+		output: gate.output.slice(0, TOOL_DETAILS_ROW_OUTPUT_MAX_CHARACTERS),
+	}));
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "gate-run",
+		operation,
+		artifactId,
+		artifactTitle,
+		gates: boundedGates,
+		completeness: completeness(gates.length, boundedGates.length),
+	};
+}
+
+export function isGateRow(value: unknown): value is ToolGateRow {
+	return (
+		isRecord(value) &&
+		typeof value.passed === "boolean" &&
+		isBoundedString(value.type) &&
+		isBoundedString(value.target) &&
+		isBoundedString(value.output, TOOL_DETAILS_ROW_OUTPUT_MAX_CHARACTERS)
+	);
+}

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

@@ -0,0 +1,43 @@
+import { type Artifact, TOOL_DETAILS_MAX_EDGES, TOOL_DETAILS_MAX_ITEMS } from "@danypops/papyrus";
+import {
+	artifactSummary,
+	completeness,
+	isBoundedString,
+	isRecord,
+	PAPYRUS_TOOL_DETAILS_SCHEMA,
+	type ResultCompleteness,
+	type ToolArtifactSummary,
+	type ToolDetailsBase,
+} from "./shared.ts";
+
+export interface ToolGraphEdge {
+	from: string;
+	relation: string;
+	to: string;
+}
+
+export interface GraphToolDetails extends ToolDetailsBase {
+	kind: "graph";
+	nodes: ToolArtifactSummary[];
+	edges: ToolGraphEdge[];
+	nodeCompleteness: ResultCompleteness;
+	edgeCompleteness: ResultCompleteness;
+}
+
+export function createGraphDetails(operation: string, artifacts: readonly Artifact[], edges: readonly ToolGraphEdge[]): GraphToolDetails {
+	const nodes = artifacts.slice(0, TOOL_DETAILS_MAX_ITEMS).map(artifactSummary);
+	const boundedEdges = edges.slice(0, TOOL_DETAILS_MAX_EDGES).map((edge) => ({ ...edge }));
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "graph",
+		operation,
+		nodes,
+		edges: boundedEdges,
+		nodeCompleteness: completeness(artifacts.length, nodes.length),
+		edgeCompleteness: completeness(edges.length, boundedEdges.length),
+	};
+}
+
+export function isGraphEdge(value: unknown): value is ToolGraphEdge {
+	return isRecord(value) && isBoundedString(value.from) && isBoundedString(value.relation) && isBoundedString(value.to);
+}

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

@@ -0,0 +1,235 @@
+/**
+ * render-model/ -- typed, bounded Vehicle-result render details, one file per result-kind
+ * (already Strategy-shaped in spirit: one create-and-is-guard pair per kind), split out of the former
+ * single 827-line render-model.ts as part of a SOLID-audit-driven decomposition (see Doc
+ * "Modularity playbook: building-block-shaped TypeScript modules for papyrus/pi-papyrus" and the
+ * "pi-papyrus render-model.ts split" child of "Epic: Modularize papyrus/pi-papyrus god-files into
+ * building-block modules"). This file is the one place that assembles every kind into the
+ * PapyrusToolDetails union and validates a persisted one back (parsePapyrusToolDetails) -- the
+ * "wide internal, narrow public" shape: each sibling module owns one kind's own real complexity,
+ * this one only ever needs to know each kind's own type + guard, never re-derive it.
+ */
+import {
+	TOOL_DETAILS_BODY_MAX_CHARACTERS,
+	TOOL_DETAILS_MAX_EDGES,
+	TOOL_DETAILS_MAX_ITEMS,
+	TOOL_DETAILS_MAX_SERIALIZED_CHARACTERS,
+} from "@danypops/papyrus";
+import type { ArtifactListToolDetails, ArtifactToolDetails, TransitionToolDetails } from "./artifact.ts";
+import { type DiscussionToolDetails, isDiscussionRoundSummary } from "./discussion.ts";
+import { type ExecutionPlanToolDetails, isExecution, isExecutionPlanNode, isLayers } from "./execution-plan.ts";
+import { type GateRunToolDetails, isGateRow } from "./gate-run.ts";
+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 {
+	isArtifactSummary,
+	isBoundedArray,
+	isBoundedString,
+	isCompleteness,
+	isFocusAnnotation,
+	isRecord,
+	isStringArray,
+	isToolArtifact,
+	PAPYRUS_TOOL_DETAILS_SCHEMA,
+} from "./shared.ts";
+import {
+	isTaskBlockageSummary,
+	isTaskChecklistReviewSummary,
+	isTaskGateResultSummary,
+	type TaskCompletionToolDetails,
+} from "./task-completion.ts";
+
+export type PapyrusToolDetails =
+	| ArtifactToolDetails
+	| ArtifactListToolDetails
+	| TransitionToolDetails
+	| GraphToolDetails
+	| GateRunToolDetails
+	| InvocationToolDetails
+	| PreviewToolDetails
+	| ErrorToolDetails
+	| ExecutionPlanToolDetails
+	| PlaybookInvocationToolDetails
+	| PlaybookMissingArgumentsToolDetails
+	| DiscussionToolDetails
+	| TaskCompletionToolDetails
+	| NoFocusToolDetails
+	| LeaseToolDetails;
+
+/** Validate renderer details restored from session history before using them as typed presentation state. */
+export function parsePapyrusToolDetails(value: unknown): PapyrusToolDetails | undefined {
+	let serializedLength: number;
+	try {
+		serializedLength = JSON.stringify(value).length;
+	} catch {
+		return undefined;
+	}
+	if (
+		serializedLength > TOOL_DETAILS_MAX_SERIALIZED_CHARACTERS ||
+		!isRecord(value) ||
+		value.schemaVersion !== PAPYRUS_TOOL_DETAILS_SCHEMA ||
+		!isBoundedString(value.operation) ||
+		!isBoundedString(value.kind)
+	)
+		return undefined;
+
+	switch (value.kind) {
+		case "artifact":
+			return isToolArtifact(value.artifact) &&
+				isCompleteness(value.completeness) &&
+				(value.focus === undefined || isFocusAnnotation(value.focus))
+				? (value as unknown as ArtifactToolDetails)
+				: undefined;
+		case "artifact-list":
+			return isBoundedArray(value.rows, TOOL_DETAILS_MAX_ITEMS, isArtifactSummary) &&
+				Number.isSafeInteger(value.total) &&
+				Number(value.total) >= value.rows.length &&
+				isCompleteness(value.completeness)
+				? (value as unknown as ArtifactListToolDetails)
+				: undefined;
+		case "transition":
+			return isArtifactSummary(value.artifact) && isBoundedString(value.fromStatus) && isBoundedString(value.toStatus)
+				? (value as unknown as TransitionToolDetails)
+				: undefined;
+		case "graph":
+			return isBoundedArray(value.nodes, TOOL_DETAILS_MAX_ITEMS, isArtifactSummary) &&
+				isBoundedArray(value.edges, TOOL_DETAILS_MAX_EDGES, isGraphEdge) &&
+				isCompleteness(value.nodeCompleteness) &&
+				isCompleteness(value.edgeCompleteness)
+				? (value as unknown as GraphToolDetails)
+				: undefined;
+		case "gate-run":
+			return isBoundedString(value.artifactId) &&
+				isBoundedString(value.artifactTitle) &&
+				isBoundedArray(value.gates, TOOL_DETAILS_MAX_ITEMS, isGateRow) &&
+				isCompleteness(value.completeness)
+				? (value as unknown as GateRunToolDetails)
+				: undefined;
+		case "invocation": {
+			if (!isRecord(value.created)) return undefined;
+			return isBoundedString(value.runId) &&
+				isStringArray(value.created.tasks) &&
+				isStringArray(value.created.docs) &&
+				isStringArray(value.created.rules) &&
+				isStringArray(value.created.roots) &&
+				isCompleteness(value.completeness)
+				? (value as unknown as InvocationToolDetails)
+				: undefined;
+		}
+		case "preview":
+			return isBoundedString(value.title) &&
+				isBoundedString(value.content, TOOL_DETAILS_BODY_MAX_CHARACTERS) &&
+				isCompleteness(value.completeness)
+				? (value as unknown as PreviewToolDetails)
+				: undefined;
+		case "error":
+			return isBoundedString(value.code) && isBoundedString(value.message, TOOL_DETAILS_BODY_MAX_CHARACTERS)
+				? (value as unknown as ErrorToolDetails)
+				: undefined;
+		case "execution-plan":
+			return isBoundedArray(value.nodes, TOOL_DETAILS_MAX_ITEMS, isExecutionPlanNode) &&
+				isLayers(value.layers) &&
+				isStringArray(value.cycleIds) &&
+				isCompleteness(value.completeness)
+				? (value as unknown as ExecutionPlanToolDetails)
+				: undefined;
+		case "playbook-invocation": {
+			if (!isRecord(value.created)) return undefined;
+			return isBoundedString(value.playbookId) &&
+				isBoundedString(value.runId) &&
+				isStringArray(value.created.docs) &&
+				isStringArray(value.created.rules) &&
+				isStringArray(value.created.tasks) &&
+				isStringArray(value.rootTaskIds) &&
+				isBoundedString(value.entryTaskId) &&
+				isExecution(value.execution) &&
+				isCompleteness(value.completeness)
+				? (value as unknown as PlaybookInvocationToolDetails)
+				: undefined;
+		}
+		case "playbook-missing-arguments":
+			return isBoundedString(value.playbookId) && isStringArray(value.missingArguments)
+				? (value as unknown as PlaybookMissingArgumentsToolDetails)
+				: undefined;
+		case "discussion":
+			return (value.discussion === undefined || isArtifactSummary(value.discussion)) &&
+				isBoundedArray(value.rounds, TOOL_DETAILS_MAX_ITEMS, isDiscussionRoundSummary) &&
+				isCompleteness(value.completeness)
+				? (value as unknown as DiscussionToolDetails)
+				: undefined;
+		case "task-completion":
+			return isArtifactSummary(value.artifact) &&
+				isBoundedArray(value.gates, TOOL_DETAILS_MAX_ITEMS, isTaskGateResultSummary) &&
+				isBoundedArray(value.checklist, TOOL_DETAILS_MAX_ITEMS, isTaskChecklistReviewSummary) &&
+				typeof value.completed === "boolean" &&
+				(value.focused === undefined || isArtifactSummary(value.focused)) &&
+				isBoundedArray(value.blocked, TOOL_DETAILS_MAX_ITEMS, isTaskBlockageSummary) &&
+				isCompleteness(value.completeness)
+				? (value as unknown as TaskCompletionToolDetails)
+				: undefined;
+		case "no-focus":
+			return value as unknown as NoFocusToolDetails;
+		case "lease":
+			return isBoundedString(value.taskName) &&
+				isBoundedString(value.taskTitle) &&
+				isBoundedString(value.owner) &&
+				isBoundedString(value.claimedAt) &&
+				isBoundedString(value.leaseExpiresAt) &&
+				(value.heartbeatAt === undefined || isBoundedString(value.heartbeatAt)) &&
+				(value.note === undefined || isBoundedString(value.note))
+				? (value as unknown as LeaseToolDetails)
+				: undefined;
+		default:
+			return undefined;
+	}
+}
+
+export {
+	type ArtifactListToolDetails,
+	type ArtifactToolDetails,
+	createArtifactDetails,
+	createArtifactListDetails,
+	createTransitionDetails,
+	type TransitionToolDetails,
+} from "./artifact.ts";
+export { createDiscussionDetails, type DiscussionRoundSummary, type DiscussionToolDetails } from "./discussion.ts";
+export { createExecutionPlanDetails, type ExecutionPlanNode, type ExecutionPlanToolDetails } from "./execution-plan.ts";
+export { createGateRunDetails, type GateRunToolDetails, type ToolGateRow } from "./gate-run.ts";
+export { createGraphDetails, type GraphToolDetails, type ToolGraphEdge } from "./graph.ts";
+export { createLeaseDetails, type LeaseToolDetails } from "./lease.ts";
+export {
+	createErrorDetails,
+	createNoFocusDetails,
+	createPreviewDetails,
+	type ErrorToolDetails,
+	type NoFocusToolDetails,
+	type PreviewToolDetails,
+} from "./misc.ts";
+export {
+	createInvocationDetails,
+	createPlaybookInvocationDetails,
+	createPlaybookMissingArgumentsDetails,
+	type InvocationToolDetails,
+	type PlaybookInvocationCreated,
+	type PlaybookInvocationToolDetails,
+	type PlaybookMissingArgumentsToolDetails,
+	type ToolInvocationCreated,
+} from "./playbook.ts";
+export {
+	type ArtifactFocusAnnotation,
+	createModelContent,
+	type ModelContent,
+	PAPYRUS_TOOL_DETAILS_SCHEMA,
+	type ResultCompleteness,
+	type ToolArtifact,
+	type ToolArtifactSummary,
+} from "./shared.ts";
+export {
+	createTaskCompletionDetails,
+	type TaskBlockageSummary,
+	type TaskChecklistReviewSummary,
+	type TaskCompletionToolDetails,
+	type TaskGateResultSummary,
+} from "./task-completion.ts";

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

@@ -0,0 +1,40 @@
+import { TOOL_DETAILS_FIELD_MAX_CHARACTERS } from "@danypops/papyrus";
+import { PAPYRUS_TOOL_DETAILS_SCHEMA, type ToolDetailsBase } from "./shared.ts";
+
+/** tasks.claim/heartbeat_lease/release_lease/lease's own name-first view -- deliberately never carries the raw lease token; the model channel (which needs the real token for a later heartbeat/release call) is a separate, independent channel from this persisted, human-facing one. */
+export interface LeaseToolDetails extends ToolDetailsBase {
+	kind: "lease";
+	taskName: string;
+	taskTitle: string;
+	owner: string;
+	claimedAt: string;
+	leaseExpiresAt: string;
+	heartbeatAt?: string;
+	note?: string;
+}
+
+export function createLeaseDetails(
+	operation: string,
+	lease: {
+		taskName: string;
+		taskTitle: string;
+		owner: string;
+		claimedAt: string;
+		leaseExpiresAt: string;
+		heartbeatAt?: string;
+		note?: string;
+	},
+): LeaseToolDetails {
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "lease",
+		operation,
+		taskName: lease.taskName,
+		taskTitle: lease.taskTitle,
+		owner: lease.owner,
+		claimedAt: lease.claimedAt,
+		leaseExpiresAt: lease.leaseExpiresAt,
+		...(lease.heartbeatAt ? { heartbeatAt: lease.heartbeatAt } : {}),
+		...(lease.note ? { note: lease.note.slice(0, TOOL_DETAILS_FIELD_MAX_CHARACTERS) } : {}),
+	};
+}

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

@@ -0,0 +1,45 @@
+import { TOOL_DETAILS_BODY_MAX_CHARACTERS, TOOL_DETAILS_FIELD_MAX_CHARACTERS } from "@danypops/papyrus";
+import { boundedText, PAPYRUS_TOOL_DETAILS_SCHEMA, type ResultCompleteness, type ToolDetailsBase } from "./shared.ts";
+
+export interface PreviewToolDetails extends ToolDetailsBase {
+	kind: "preview";
+	title: string;
+	content: string;
+	completeness: ResultCompleteness;
+}
+
+export function createPreviewDetails(operation: string, title: string, content: string): PreviewToolDetails {
+	const bounded = boundedText(content, TOOL_DETAILS_BODY_MAX_CHARACTERS);
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "preview",
+		operation,
+		title,
+		content: bounded.value,
+		completeness: bounded.completeness,
+	};
+}
+
+export interface ErrorToolDetails extends ToolDetailsBase {
+	kind: "error";
+	code: string;
+	message: string;
+}
+
+export function createErrorDetails(operation: string, code: string, message: string): ErrorToolDetails {
+	return {
+		schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA,
+		kind: "error",
+		operation,
+		code: code.slice(0, TOOL_DETAILS_FIELD_MAX_CHARACTERS),
+		message: message.slice(0, TOOL_DETAILS_BODY_MAX_CHARACTERS),
+	};
+}
+
+export interface NoFocusToolDetails extends ToolDetailsBase {
+	kind: "no-focus";
+}
+
+export function createNoFocusDetails(operation: string): NoFocusToolDetails {
+	return { schemaVersion: PAPYRUS_TOOL_DETAILS_SCHEMA, kind: "no-focus", operation };
+}