dsh-output-styles 0.3.2 → 0.4.0

package/lib/index.js

@@ -4,6 +4,7 @@ import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { watch } from "node:fs";
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { deriveEventMessage, foldSurface } from "@deepseek-ai/dsh-session/surface";
 //#region src/config.ts
 /**
 * Serializable configuration, schema, and direct-call defaults.
@@ -23,7 +24,21 @@ const Config = z.object({
 	sectionOrder: z.number().default(90),
 	truncationMarker: z.string().default("\n\n[style truncated]"),
 	includeBuiltins: z.boolean().default(true),
-	watchStyles: z.boolean().default(true)
+	watchStyles: z.boolean().default(true),
+	rules: z.array(z.object({
+		match: z.object({
+			tool: z.string().required(false),
+			contentType: z.union([
+				z.const("text"),
+				z.const("markdown"),
+				z.const("html")
+			]).required(false),
+			session: z.string().required(false)
+		}).required(false),
+		style: z.string().min(1),
+		priority: z.number().required(false)
+	})).default([]),
+	enableExport: z.boolean().default(true)
 });
 /**
 * Resolve the same defaults for direct callers that bypass the Cordis Loader,
@@ -40,15 +55,344 @@ function resolveConfig(config, defaultStylesDir) {
 	if (!Number.isFinite(sectionOrder)) throw new Error(`dsh-output-styles: sectionOrder must be a finite number, got ${String(config.sectionOrder)}`);
 	const includeBuiltins = config.includeBuiltins ?? true;
 	const customDirs = (Array.isArray(config.stylesDir) ? config.stylesDir : config.stylesDir === void 0 || config.stylesDir === "" ? [] : [config.stylesDir]).map((dir) => resolve(dir));
+	const stylesDirs = includeBuiltins ? [defaultStylesDir, ...customDirs] : customDirs;
+	for (const rule of config.rules ?? []) {
+		const match = rule.match ?? {};
+		if (match.tool !== void 0 && match.tool !== "*" && /[^a-zA-Z0-9_-]/.test(match.tool)) throw new Error(`dsh-output-styles: rule tool ${JSON.stringify(match.tool)} must be a tool name or '*'`);
+		if (rule.style === "" || /[^a-z0-9-]/.test(rule.style)) throw new Error(`dsh-output-styles: rule style ${JSON.stringify(rule.style)} must be a kebab-case renderer id`);
+		if (rule.priority !== void 0 && !Number.isFinite(rule.priority)) throw new Error(`dsh-output-styles: rule priority must be a finite number, got ${String(rule.priority)}`);
+	}
 	return {
-		stylesDirs: includeBuiltins ? [defaultStylesDir, ...customDirs] : customDirs,
+		stylesDirs,
 		maxStyleChars,
 		defaultStyle: config.defaultStyle ?? "",
 		compatJson: config.compatJson ?? true,
 		sectionOrder,
 		truncationMarker: config.truncationMarker ?? "\n\n[style truncated]",
 		includeBuiltins,
-		watchStyles: config.watchStyles ?? true
+		watchStyles: config.watchStyles ?? true,
+		rules: (config.rules ?? []).map((rule) => ({
+			...rule,
+			priority: rule.priority ?? 0
+		})),
+		enableExport: config.enableExport ?? true
+	};
+}
+//#endregion
+//#region src/renderers.ts
+/**
+* Validates a renderer before registration: id grammar, name, description,
+* match shape, priority, presenter function. Throws on the first violation
+* (fail-loud — a bad renderer never sits in the registry).
+* @param renderer - candidate renderer.
+*/
+function validateRenderer(renderer) {
+	if (typeof renderer !== "object" || renderer === null) throw new Error("renderer must be an object");
+	if (typeof renderer.id !== "string" || !/^[a-z0-9][a-z0-9-]*$/.test(renderer.id)) throw new Error(`invalid renderer id ${JSON.stringify(renderer.id)}: use kebab-case`);
+	if (typeof renderer.name !== "string" || renderer.name === "") throw new Error("renderer name must be a non-empty string");
+	if (typeof renderer.description !== "string" || renderer.description === "") throw new Error("renderer description must be a non-empty string");
+	if (!Array.isArray(renderer.match)) throw new Error("renderer match must be an array");
+	for (const match of renderer.match) {
+		if (match.tool !== void 0) {
+			if (!(Array.isArray(match.tool) ? match.tool : [match.tool]).every((item) => typeof item === "string")) throw new Error("renderer match.tool must be a string or string array");
+		}
+		if (match.contentType !== void 0) {
+			if (!(Array.isArray(match.contentType) ? match.contentType : [match.contentType]).every((item) => typeof item === "string")) throw new Error("renderer match.contentType must be a string or string array");
+		}
+	}
+	if (typeof renderer.priority !== "number" || !Number.isFinite(renderer.priority)) throw new Error("renderer priority must be a finite number");
+	if (typeof renderer.presenter !== "function") throw new Error("renderer presenter must be a function");
+}
+/** Match one rule fact (a string, a string list, or undefined=any) against a value. */
+function factMatches(fact, value) {
+	if (fact === void 0) return true;
+	if (typeof fact === "string") return fact === "*" || fact === value;
+	return fact.includes("*") || fact.includes(value);
+}
+/** Whether a renderer matches a render request. */
+function rendererMatches(renderer, context) {
+	if (renderer.match.length === 0) return true;
+	return renderer.match.some((match) => factMatches(match.tool, context.tool) && factMatches(match.contentType, context.contentType));
+}
+/** Whether a configured rule matches a render request. */
+function ruleMatches(rule, context) {
+	if (rule.match.tool !== void 0 && rule.match.tool !== "*" && rule.match.tool !== context.tool) return false;
+	if (rule.match.contentType !== void 0 && rule.match.contentType !== context.contentType) return false;
+	if (rule.match.session !== void 0 && rule.match.session !== context.sessionId) return false;
+	return true;
+}
+/**
+* The renderer registry: reversible registration, ordered resolution, and
+* rule-driven rendering. Registration is a caller-owned effect (the runtime
+* hands register()'s disposer to ctx.effect); the registry itself is pure
+* state with no timers, listeners, or I/O.
+*/
+var RendererRegistry = class {
+	renderers = /* @__PURE__ */ new Map();
+	order = 0;
+	/** Register a renderer; the disposer removes exactly this registration. */
+	register(renderer) {
+		validateRenderer(renderer);
+		if (this.renderers.has(renderer.id)) throw new Error(`renderer ${JSON.stringify(renderer.id)} is already registered`);
+		const order = this.order++;
+		this.renderers.set(renderer.id, {
+			renderer,
+			order
+		});
+		return () => {
+			if (this.renderers.get(renderer.id)?.order === order) this.renderers.delete(renderer.id);
+		};
+	}
+	/** Every registered renderer, deterministic order (priority desc, registration asc). */
+	list() {
+		return [...this.renderers.values()].sort((a, b) => b.renderer.priority - a.renderer.priority || a.order - b.order).map((entry) => entry.renderer);
+	}
+	/** Resolve the renderers that match a request, highest priority first. */
+	resolve(context) {
+		return this.list().filter((renderer) => rendererMatches(renderer, context));
+	}
+	/**
+	* Render text through the rule table, then the matching renderer pipeline:
+	* the first matching rule names a renderer (applied alone, it is explicit),
+	* otherwise every matching renderer applies in priority order (each sees the
+	* previous renderer's output — composition, not competition).
+	* @param text - the raw model-visible text.
+	* @param context - tool / content-type / session facts.
+	* @param rules - configured style rules, highest priority first.
+	* @returns the auditable result (original always preserved).
+	*/
+	render(text, context, rules = []) {
+		const hit = [...rules].sort((a, b) => b.priority - a.priority).find((rule) => ruleMatches(rule, context));
+		if (hit !== void 0) {
+			const renderer = this.renderers.get(hit.style);
+			if (renderer === void 0) throw new Error(`rule style ${JSON.stringify(hit.style)} names no registered renderer (available: ${this.list().map((item) => item.id).join(", ") || "none"})`);
+			const rendered = renderer.renderer.presenter(text, context);
+			return {
+				original: text,
+				rendered,
+				rendererId: renderer.renderer.id,
+				changed: rendered !== text
+			};
+		}
+		let rendered = text;
+		let rendererId;
+		for (const renderer of this.resolve(context)) {
+			rendered = renderer.presenter(rendered, context);
+			rendererId = renderer.id;
+		}
+		return {
+			original: text,
+			rendered,
+			...rendererId === void 0 ? {} : { rendererId },
+			changed: rendered !== text
+		};
+	}
+};
+/** Collapse whitespace runs and blank-line stacks; trim the ends. */
+function compact(text, maxLines, maxChars, marker) {
+	const collapsed = text.split(/\r?\n/).map((line) => line.replace(/[ \t]+/g, " ").trimEnd()).reduce((lines, line) => {
+		if (line === "" && lines[lines.length - 1] === "") return lines;
+		lines.push(line);
+		return lines;
+	}, []).join("\n").trim();
+	let out = maxLines > 0 && collapsed.split("\n").length > maxLines ? collapsed.split("\n").slice(0, maxLines).join("\n") + marker : collapsed;
+	if (maxChars > 0 && out.length > maxChars) out = out.slice(0, maxChars) + marker;
+	return out;
+}
+/** Turn a list-shaped text into consistently numbered steps. */
+function enumerate(text) {
+	const lines = text.split(/\r?\n/);
+	if (lines.filter((line) => /^\s*(?:[-*•]|\d+[.)])\s+/.test(line)).length === 0) return text;
+	let counter = 0;
+	return lines.map((line) => {
+		if (!/^\s*(?:[-*•]|\d+[.)])\s+/.test(line)) return line;
+		counter += 1;
+		return line.replace(/^\s*(?:[-*•]|\d+[.)])\s+/, `${counter}. `);
+	}).join("\n");
+}
+/**
+* The built-in style renderers, mirroring the two headline styles: `concise`
+* compacts whitespace under a line/char budget, `step-by-step` numbers list
+* items consistently. Their ids double as `/style`-compatible names in the
+* rule table.
+*/
+const BUILTIN_RENDERERS = [{
+	id: "concise",
+	name: "Concise",
+	description: "Compacts whitespace runs and blank lines, and caps the presented text at a budget with a truncation marker.",
+	match: [],
+	priority: 10,
+	presenter: (text) => compact(text, 40, 4e3, "\n\n[truncated]")
+}, {
+	id: "step-by-step",
+	name: "Step-by-step",
+	description: "Numbers list items (dashes, bullets, or digits) consistently from 1 so the presentation reads as ordered steps.",
+	match: [],
+	priority: 10,
+	presenter: (text) => enumerate(text)
+}];
+//#endregion
+//#region src/export.ts
+/**
+* Session export: a pure projection of the current session's message surface
+* into Markdown or sanitized HTML, with renderer application on top. The
+* extraction reads only the public `session.events` log through the official
+* `deriveEventMessage` projection — the same rule the harness uses to build
+* model requests — so the exported document is reconstructable from the log.
+* Every render application preserves the original text beside the rendered
+* one, keeping the auditable pair intact inside the export document.
+*
+* Host-side module (imports the dsh-session surface projection); the pure
+* Markdown/HTML/sanitize functions stay free of both DOM and I/O.
+* @module dsh-output-styles/export
+*/
+/**
+* Extract the message surface of a session log as plain lines. Tool calls and
+* tool results render as labeled lines so the transcript stays readable; the
+* content is never summarized — this is a projection, not an interpretation.
+* @param events - the session log, in seq order.
+* @returns the conversation lines in surface order.
+*/
+function conversationLines(events) {
+	const { nodes } = foldSurface(events);
+	const lines = [];
+	for (const seq of nodes) {
+		const event = events.find((item) => item.seq === seq);
+		if (event === void 0) continue;
+		const message = deriveEventMessage(event);
+		if (message === null) continue;
+		const described = describeMessage(message);
+		if (described.text === "") continue;
+		lines.push(described);
+	}
+	return lines;
+}
+/**
+* Project one derived message into an export line: string content becomes a
+* user/assistant line; a content carrying only tool_use parts becomes a tool
+* call line; only tool_result parts become a tool result line. Mixed content
+* keeps the text parts and the message role.
+*/
+function describeMessage(message) {
+	const content = message.content;
+	const baseRole = message.role === "assistant" ? "assistant" : "user";
+	if (typeof content === "string") return {
+		role: baseRole,
+		text: content.trim()
+	};
+	if (Array.isArray(content)) {
+		const textParts = [];
+		const toolUses = [];
+		const toolResults = [];
+		for (const part of content) {
+			if (part === null || typeof part !== "object") continue;
+			const record = part;
+			if (record["type"] === "text" && typeof record["text"] === "string") textParts.push(record["text"]);
+			else if (record["type"] === "tool_use") toolUses.push(String(record["name"] ?? "tool"));
+			else if (record["type"] === "tool_result") {
+				const raw = record["content"];
+				const body = typeof raw === "string" ? raw : Array.isArray(raw) ? raw.map((item) => typeof item === "object" && item !== null && typeof item["text"] === "string" ? item["text"] : "").join(" ") : "";
+				toolResults.push(body.trim());
+			}
+		}
+		if (textParts.length === 0 && toolUses.length > 0) {
+			const first = toolUses[0];
+			return first === void 0 ? {
+				role: "tool",
+				text: "[tool call]"
+			} : {
+				role: "tool",
+				tool: first,
+				text: toolUses.map((name) => `[tool call: ${name}]`).join("\n")
+			};
+		}
+		if (textParts.length === 0 && toolResults.length > 0) return {
+			role: "tool",
+			tool: "tool-result",
+			text: toolResults.join("\n")
+		};
+		return {
+			role: baseRole,
+			text: textParts.join("\n").trim()
+		};
+	}
+	return {
+		role: baseRole,
+		text: ""
+	};
+}
+/**
+* Sanitize one text for HTML embedding: escape the five markup-significant
+* characters and strip control characters except newline/tab. Pure function,
+* covered by extreme-case tests (tags, null bytes, huge inputs).
+* @param text - the raw text.
+* @returns the HTML-safe text.
+*/
+function sanitizeText(text) {
+	return text.replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+/**
+* Render one export line as a Markdown block: headings by role and fenced
+* blocks for tool lines so multi-line content never breaks the transcript.
+* @param line - the export line.
+* @returns the Markdown text.
+*/
+function lineToMarkdown(line) {
+	if (line.tool !== void 0) return `### \`${line.tool}\`\n\n\`\`\`text\n${line.text}\n\`\`\``;
+	return `${line.role === "user" ? "## User" : "## Assistant"}\n\n${line.text}`;
+}
+/** Build the complete Markdown document for a set of lines. */
+function toMarkdown(lines) {
+	const body = lines.map(lineToMarkdown).join("\n\n");
+	return `# Session export\n\n${body === "" ? "_No messages yet._" : body}\n`;
+}
+/** Build the complete sanitized HTML document for a set of lines. */
+function toHtml(lines) {
+	const body = lines.map((line) => {
+		const safe = sanitizeText(line.text).replace(/\n/g, "<br>");
+		if (line.tool !== void 0) return `<h3><code>${sanitizeText(line.tool)}</code></h3>\n<pre>${safe}</pre>`;
+		return `<h2>${line.role === "user" ? "User" : "Assistant"}</h2>\n<p>${safe}</p>`;
+	}).join("\n");
+	return `<!doctype html>
+<html lang="en">
+<head><meta charset="utf-8"><title>Session export</title></head>
+<body>
+<h1>Session export</h1>\n${body === "" ? "<p><em>No messages yet.</em></p>" : body}\n</body>\n</html>\n`;
+}
+/**
+* Apply the renderer pipeline to every line of a conversation (per-tool and
+* per-content-type rules decide which renderer touches which line) and build
+* the export document. Both the rendered document and the original lines
+* stay inside the returned document, so the render application is auditable.
+* @param registry - the renderer registry.
+* @param lines - the extracted conversation lines.
+* @param format - export format.
+* @param rules - configured style rules.
+* @param now - exportedAt timestamp (injected for deterministic tests).
+* @returns the complete export document.
+*/
+function renderExport(registry, lines, format, rules, now = /* @__PURE__ */ new Date()) {
+	const rendered = [];
+	const presented = lines.map((line) => {
+		const result = registry.render(line.text, {
+			tool: line.tool ?? "",
+			contentType: "markdown"
+		}, rules);
+		rendered.push(result);
+		return {
+			...line,
+			text: result.rendered
+		};
+	});
+	const document = format === "markdown" ? toMarkdown(presented) : toHtml(presented);
+	return {
+		plugin: "dsh-output-styles",
+		schema: "output-export-v1",
+		format,
+		exportedAt: now.toISOString(),
+		text: document,
+		lines: presented,
+		rendered
 	};
 }
 //#endregion
@@ -390,6 +734,93 @@ async function apply(ctx, config) {
 			selectionFor: (sessionId) => runtime.selectionFor(sessionId)
 		}));
 	});
+	const renderers = new RendererRegistry();
+	for (const renderer of BUILTIN_RENDERERS) ctx.effect(() => renderers.register(renderer), `dsh-output-styles: renderer ${renderer.id}`);
+	let effectiveRules = resolved.rules;
+	const renderText = (text, context) => ctx.waterfall("output.render/before", {
+		text,
+		context
+	}, async (request) => renderers.render(request.text, request.context, effectiveRules));
+	const renderService = {
+		register: (renderer) => renderers.register(renderer),
+		list: () => renderers.list(),
+		resolve: (context) => renderers.resolve(context),
+		renderText
+	};
+	ctx.provide("outputRenderers", renderService);
+	installSettingsSection(ctx, settingsNamespace("output-style-rules"), z.object({ rules: z.array(z.object({
+		match: z.object({
+			tool: z.string().required(false),
+			contentType: z.union([
+				z.const("text"),
+				z.const("markdown"),
+				z.const("html")
+			]).required(false),
+			session: z.string().required(false)
+		}).required(false),
+		style: z.string().min(1),
+		priority: z.number().required(false)
+	})).default([]) }), { rules: resolved.rules }, {
+		setSource: (current) => {
+			effectiveRules = current().rules.map((rule) => ({
+				match: rule.match ?? {},
+				style: rule.style,
+				priority: rule.priority ?? 0
+			}));
+		},
+		onChange: () => {},
+		validate: (value) => {
+			for (const rule of value.rules) if (rule.style === "" || /[^a-z0-9-]/.test(rule.style)) throw new Error(`dsh-output-styles: rule style ${JSON.stringify(rule.style)} must be a kebab-case renderer id`);
+		}
+	});
+	if (resolved.enableExport) ctx.inject(["commands"], (commandCtx) => {
+		commandCtx.commands.register({
+			name: "export",
+			description: "Export this session as Markdown or HTML (renderer-aware)",
+			input: { hint: "[markdown|html] [--renderer=<id>]" },
+			handler: async ({ agent, rawInput }) => {
+				const input = parseExportInput(rawInput);
+				if (input.kind === "error") return {
+					kind: "error",
+					text: "usage: /export [markdown|html] [--renderer=<id>]"
+				};
+				const lines = conversationLines(agent.session.events);
+				const rules = input.renderer === void 0 ? [...effectiveRules] : [{
+					match: {},
+					style: input.renderer,
+					priority: 0
+				}];
+				return {
+					kind: "success",
+					text: renderExport(renderers, lines, input.format, rules).text
+				};
+			}
+		});
+	});
+}
+/** Parse `/export [markdown|html] [--renderer=<id>]` from the raw command input. */
+function parseExportInput(rawInput) {
+	const raw = String(rawInput ?? "").trim();
+	const parts = raw === "" ? [] : raw.split(/\s+/);
+	let format = "markdown";
+	let renderer;
+	for (const part of parts) {
+		if (part === "markdown" || part === "html") {
+			format = part;
+			continue;
+		}
+		const match = /^--renderer=([a-z0-9][a-z0-9-]*)$/.exec(part);
+		if (match !== null) {
+			renderer = match[1];
+			continue;
+		}
+		return { kind: "error" };
+	}
+	return {
+		kind: "ok",
+		format,
+		...renderer === void 0 ? {} : { renderer }
+	};
 }
 //#endregion
 //#region src/index.ts

package/lib/types/config.d.ts

@@ -8,6 +8,22 @@
  * @module dsh-output-styles/config
  */
 import z from '@deepseek-ai/schemastery';
+/** One per-session/per-tool style rule: match facts + the renderer to apply. */
+export interface StyleRuleConfig {
+    /** Match facts; an empty object matches every render request. */
+    match: {
+        /** Tool name or '*' (omitted = any tool). */
+        tool?: string;
+        /** Content type (omitted = any). */
+        contentType?: 'text' | 'markdown' | 'html';
+        /** Exact session id (omitted = any session) — the per-session axis. */
+        session?: string;
+    };
+    /** Renderer id to apply; built-in ids mirror the style names (concise, step-by-step). */
+    style: string;
+    /** Higher priority wins; ties break by rule order (earlier first). */
+    priority?: number;
+}
 /** Plugin configuration supplied by the profile composition. */
 export interface Config {
     /**
@@ -39,6 +55,10 @@ export interface Config {
     includeBuiltins?: boolean;
     /** Reload the library when a style file changes on disk (default true). */
     watchStyles?: boolean;
+    /** Per-session/per-tool render rules (renderer registry); applied by `/export` and the render service. */
+    rules?: StyleRuleConfig[];
+    /** Register the `/export` command (Markdown/HTML session-export, renderer-aware). */
+    enableExport?: boolean;
 }
 /** Configuration after defaults have been resolved. */
 export interface ResolvedConfig {
@@ -58,6 +78,18 @@ export interface ResolvedConfig {
     includeBuiltins: boolean;
     /** Whether the library reloads on style-file changes. */
     watchStyles: boolean;
+    /** Per-session/per-tool render rules with resolved priorities. */
+    rules: Array<{
+        match: {
+            tool?: string;
+            contentType?: 'text' | 'markdown' | 'html';
+            session?: string;
+        };
+        style: string;
+        priority: number;
+    }>;
+    /** Whether the `/export` command registers. */
+    enableExport: boolean;
 }
 /** Loader-visible configuration schema and defaults. */
 export declare const Config: z<Config>;

package/lib/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,gEAAgE;AAChE,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC7B,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6GAA6G;IAC7G,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,sGAAsG;IACtG,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAA;IACxB,4DAA4D;IAC5D,eAAe,EAAE,OAAO,CAAA;IACxB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,wDAAwD;AACxD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAS3B,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAuBtF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,KAAK,EAAE;QACL,6CAA6C;QAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,oCAAoC;QACpC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;QAC1C,uEAAuE;QACvE,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC7B,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6GAA6G;IAC7G,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;IACzB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,sGAAsG;IACtG,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAA;IACxB,4DAA4D;IAC5D,eAAe,EAAE,OAAO,CAAA;IACxB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzI,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,wDAAwD;AACxD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAmB3B,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAqCtF"}

package/lib/types/export.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Session export: a pure projection of the current session's message surface
+ * into Markdown or sanitized HTML, with renderer application on top. The
+ * extraction reads only the public `session.events` log through the official
+ * `deriveEventMessage` projection — the same rule the harness uses to build
+ * model requests — so the exported document is reconstructable from the log.
+ * Every render application preserves the original text beside the rendered
+ * one, keeping the auditable pair intact inside the export document.
+ *
+ * Host-side module (imports the dsh-session surface projection); the pure
+ * Markdown/HTML/sanitize functions stay free of both DOM and I/O.
+ * @module dsh-output-styles/export
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { RendererRegistry, RenderedText } from './renderers.ts';
+/** One exported conversation line. */
+export interface ExportLine {
+    /** Speaker role: 'user', 'assistant', or 'tool'. */
+    readonly role: 'user' | 'assistant' | 'tool';
+    /** The original message text (or tool-call/tool-result rendering). */
+    readonly text: string;
+    /** Tool name for tool lines, otherwise undefined. */
+    readonly tool?: string;
+}
+/** A completed export document (renderer application included). */
+export interface ExportDocument {
+    readonly plugin: 'dsh-output-styles';
+    readonly schema: 'output-export-v1';
+    readonly format: 'markdown' | 'html';
+    readonly exportedAt: string;
+    /** The rendered document text (what the user copies/downloads). */
+    readonly text: string;
+    readonly lines: readonly ExportLine[];
+    readonly rendered: readonly RenderedText[];
+}
+/**
+ * Extract the message surface of a session log as plain lines. Tool calls and
+ * tool results render as labeled lines so the transcript stays readable; the
+ * content is never summarized — this is a projection, not an interpretation.
+ * @param events - the session log, in seq order.
+ * @returns the conversation lines in surface order.
+ */
+export declare function conversationLines(events: readonly SessionEvent[]): ExportLine[];
+/**
+ * Sanitize one text for HTML embedding: escape the five markup-significant
+ * characters and strip control characters except newline/tab. Pure function,
+ * covered by extreme-case tests (tags, null bytes, huge inputs).
+ * @param text - the raw text.
+ * @returns the HTML-safe text.
+ */
+export declare function sanitizeText(text: string): string;
+/**
+ * Render one export line as a Markdown block: headings by role and fenced
+ * blocks for tool lines so multi-line content never breaks the transcript.
+ * @param line - the export line.
+ * @returns the Markdown text.
+ */
+export declare function lineToMarkdown(line: ExportLine): string;
+/** Build the complete Markdown document for a set of lines. */
+export declare function toMarkdown(lines: readonly ExportLine[]): string;
+/** Build the complete sanitized HTML document for a set of lines. */
+export declare function toHtml(lines: readonly ExportLine[]): string;
+/**
+ * Apply the renderer pipeline to every line of a conversation (per-tool and
+ * per-content-type rules decide which renderer touches which line) and build
+ * the export document. Both the rendered document and the original lines
+ * stay inside the returned document, so the render application is auditable.
+ * @param registry - the renderer registry.
+ * @param lines - the extracted conversation lines.
+ * @param format - export format.
+ * @param rules - configured style rules.
+ * @param now - exportedAt timestamp (injected for deterministic tests).
+ * @returns the complete export document.
+ */
+export declare function renderExport(registry: RendererRegistry, lines: readonly ExportLine[], format: 'markdown' | 'html', rules: readonly import('./renderers.ts').StyleRule[], now?: Date): ExportDocument;
+//# sourceMappingURL=export.d.ts.map

package/lib/types/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAEpE,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,UAAU,EAAE,CAa/E;AAiDD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAMvD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAG/D;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAW3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,MAAM,EAAE,UAAU,GAAG,MAAM,EAC3B,KAAK,EAAE,SAAS,OAAO,gBAAgB,EAAE,SAAS,EAAE,EACpD,GAAG,GAAE,IAAiB,GACrB,cAAc,CAoBhB"}