dsh-output-styles 0.3.2 → 0.4.0

package/lib/types/renderers.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The `output.render.*` protocol: a presenter registry that turns raw
+ * model-visible text into display text. A renderer is a pure function —
+ * `presenter(text, meta)` maps args to presentation data and never touches
+ * the DOM — matched by tool name and content type, ordered by priority.
+ * Every rendered result carries its original text alongside, so any consumer
+ * (this plugin's `/export`, third-party panels) can log both and keep the
+ * "model-visible ⟺ reconstructable" invariant.
+ *
+ * This module is dependency-free (no DOM, no node: imports, no DSH imports)
+ * so the protocol vocabulary itself is portable and unit-testable anywhere.
+ * @module dsh-output-styles/renderers
+ */
+/** Content-type vocabulary a renderer can match on. */
+export type ContentType = 'text' | 'markdown' | 'html';
+/** Match rule deciding whether a renderer applies to one render request. */
+export interface RendererMatch {
+    /** Tool names the renderer applies to ('*' = every tool); omitted = match all. */
+    readonly tool?: string | readonly string[];
+    /** Content types the renderer applies to; omitted = match all. */
+    readonly contentType?: ContentType | readonly ContentType[];
+}
+/** Facts a render request carries (structural; the DOM never reaches this layer). */
+export interface RenderContext {
+    /** The tool that produced the text, or '' for assistant/user prose. */
+    readonly tool: string;
+    /** The declared content type of the text ('text' when unknown). */
+    readonly contentType: ContentType;
+    /** The session the text belongs to (per-session rules match on it). */
+    readonly sessionId?: string;
+    /** Session-scoped extras a presenter may read (workspace title etc.). */
+    readonly meta?: Readonly<Record<string, string>>;
+}
+/** The renderer contract a third-party plugin registers. */
+export interface OutputRenderer {
+    /** Unique renderer id (kebab-case); the rule field and `/export --renderer` name it. */
+    readonly id: string;
+    /** Human-readable name. */
+    readonly name: string;
+    /** One sentence on what the presenter does. */
+    readonly description: string;
+    /** Applicability rules; an empty array matches everything. */
+    readonly match: readonly RendererMatch[];
+    /** Higher priority wins; ties break by registration order (earlier first). */
+    readonly priority: number;
+    /** Pure presentation function: args in, display data out. */
+    readonly presenter: (text: string, context: RenderContext) => string;
+}
+/** The auditable render result: original and rendered travel together. */
+export interface RenderedText {
+    /** The original model-visible text (never mutated). */
+    readonly original: string;
+    /** The presented text (equal to the original when nothing matched). */
+    readonly rendered: string;
+    /** The renderer that applied, or undefined when no renderer matched. */
+    readonly rendererId?: string;
+    /** Whether the presentation changed the text. */
+    readonly changed: boolean;
+}
+/** One per-session/per-tool style rule from the configuration. */
+export interface StyleRule {
+    /** Match facts; an empty object matches everything. */
+    readonly match: {
+        /** Tool name or '*' (omitted = any tool). */
+        readonly tool?: string;
+        /** Content type (omitted = any). */
+        readonly contentType?: ContentType;
+        /** Exact session id (omitted = any session) — the per-session axis. */
+        readonly session?: string;
+    };
+    /** Renderer id to apply (built-ins mirror the style names: concise, step-by-step). */
+    readonly style: string;
+    /** Higher priority wins; ties break by rule order (earlier first). */
+    readonly priority: number;
+}
+/** Registry handle returned by register(). */
+export type RendererDisposer = () => void;
+/**
+ * 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.
+ */
+export declare function validateRenderer(renderer: OutputRenderer): void;
+/**
+ * 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.
+ */
+export declare class RendererRegistry {
+    private readonly renderers;
+    private order;
+    /** Register a renderer; the disposer removes exactly this registration. */
+    register(renderer: OutputRenderer): RendererDisposer;
+    /** Every registered renderer, deterministic order (priority desc, registration asc). */
+    list(): OutputRenderer[];
+    /** Resolve the renderers that match a request, highest priority first. */
+    resolve(context: RenderContext): OutputRenderer[];
+    /**
+     * 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: string, context: RenderContext, rules?: readonly StyleRule[]): RenderedText;
+}
+/**
+ * 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.
+ */
+export declare const BUILTIN_RENDERERS: readonly OutputRenderer[];
+//# sourceMappingURL=renderers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../src/renderers.ts"],"names":[],"mappings":"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"}

package/lib/types/runtime.d.ts

@@ -141,4 +141,15 @@ export declare class OutputStyleRuntime {
  * @param config - configuration resolved by Cordis from the exported schema.
  */
 export declare function apply(ctx: Context, config: Config): Promise<void>;
+/** Parsed `/export` invocation. */
+type ExportInput = {
+    kind: 'ok';
+    format: 'markdown' | 'html';
+    renderer?: string;
+} | {
+    kind: 'error';
+};
+/** Parse `/export [markdown|html] [--renderer=<id>]` from the raw command input. */
+export declare function parseExportInput(rawInput: unknown): ExportInput;
+export {};
 //# sourceMappingURL=runtime.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAKlE,OAAO,KAAK,EAAE,MAAM,EAA2B,MAAM,iCAAiC,CAAA;AAGtF,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEtF,OAAO,EAAE,mBAAmB,EAA0C,KAAK,cAAc,EAA2B,MAAM,YAAY,CAAA;AAEtI,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,QAAwD,CAAA;AAEvF,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAQ1D;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAqB3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IApBzB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,cAAc,CAAc;IAEpC,2DAA2D;IAC3D,IAAI,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAE7C;IAED;;;;OAIG;gBAEgB,MAAM,EAAE,MAAM,CAAC,OAAO,mBAAmB,CAAC,EAC3D,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,OAAO,EAAE;QACP,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;QAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;QAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KAClC;IAWH,qDAAqD;IACrD,IAAI,KAAK,IAAI,SAAS,MAAM,EAAE,CAE7B;IAED,4EAA4E;IAC5E,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IAKtD;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,IAAI;IAI1C;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,GAAG,SAAS;IAI9D;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;IAO7D;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIzC;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAOxC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAUtC;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAItC;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAmBD;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwLvE"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"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"}

package/lib/types/types.d.ts

@@ -9,6 +9,7 @@
  */
 import type { SessionId } from '@deepseek-ai/dsh-session';
 import { z as zod } from 'zod';
+import type { OutputRenderer, RenderContext, RenderedText } from './renderers.ts';
 /** The reserved switch target that removes a session's selection. */
 export declare const OFF = "off";
 /**
@@ -75,4 +76,35 @@ declare module '@deepseek-ai/dsh-session-projection/types' {
         style: StyleSelectionView;
     }
 }
+/** The `ctx.outputRenderers` service: the output.render.* renderer registry. */
+export interface OutputRenderersService {
+    /** Register a renderer (returns the disposer; caller owns it via ctx.effect). */
+    register(renderer: OutputRenderer): () => void;
+    /** Every registered renderer, deterministic order (priority desc, registration asc). */
+    list(): OutputRenderer[];
+    /** Renderers matching a request, highest priority first. */
+    resolve(context: RenderContext): OutputRenderer[];
+    /** Render text through the `output.render/before` waterfall, then rules + matched renderers. */
+    renderText(text: string, context: RenderContext): Promise<RenderedText>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** The output.render.* renderer registry provided by dsh-output-styles. */
+        outputRenderers: OutputRenderersService;
+    }
+    interface Events {
+        /**
+         * Pre-render waterfall: listeners receive `{ text, context }` and MUST
+         * call `next()` with their transformed request (or the unchanged one);
+         * returning without `next()` short-circuits the render pipeline.
+         */
+        'output.render/before'(request: {
+            text: string;
+            context: RenderContext;
+        }, next: (request: {
+            text: string;
+            context: RenderContext;
+        }) => Promise<RenderedText>): Promise<RenderedText>;
+    }
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,CAAC,IAAI,GAAG,EAAE,MAAM,KAAK,CAAA;AAG9B,qEAAqE;AACrE,eAAO,MAAM,GAAG,QAAQ,CAAA;AAExB;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;CAA2D,CAAA;AAEpF,gDAAgD;AAChD,eAAO,MAAM,oBAAoB;;;;;;mBAQ/B,CAAA;AAEF,kDAAkD;AAClD,MAAM,WAAW,cAAe,SAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;CAAG;AAEjF;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;CAM9B,CAAA;AAEF,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,iFAAiF;AACjF,eAAO,MAAM,wBAAwB;;;;;;;;mBAQnC,CAAA;AAEF,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,oBAAoB;QAC5B,KAAK,EAAE,kBAAkB,CAAA;KAC1B;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,CAAC,IAAI,GAAG,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAEjF,qEAAqE;AACrE,eAAO,MAAM,GAAG,QAAQ,CAAA;AAExB;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;CAA2D,CAAA;AAEpF,gDAAgD;AAChD,eAAO,MAAM,oBAAoB;;;;;;mBAQ/B,CAAA;AAEF,kDAAkD;AAClD,MAAM,WAAW,cAAe,SAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;CAAG;AAEjF;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;CAM9B,CAAA;AAEF,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,iFAAiF;AACjF,eAAO,MAAM,wBAAwB;;;;;;;;mBAQnC,CAAA;AAEF,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,oBAAoB;QAC5B,KAAK,EAAE,kBAAkB,CAAA;KAC1B;CACF;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAA;IAC9C,wFAAwF;IACxF,IAAI,IAAI,cAAc,EAAE,CAAA;IACxB,4DAA4D;IAC5D,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE,CAAA;IACjD,gGAAgG;IAChG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACxE;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,2EAA2E;QAC3E,eAAe,EAAE,sBAAsB,CAAA;KACxC;IACD,UAAU,MAAM;QACd;;;;WAIG;QACH,sBAAsB,CAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,aAAa,CAAA;SAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,aAAa,CAAA;SAAE,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;KACrL;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-output-styles",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Claude Code outputStyles-equivalent runtime output-style switching for DeepSeek Harness",
   "type": "module",
   "sideEffects": false,
@@ -99,7 +99,7 @@
     },
     "install": {
       "mode": "transactional",
-      "adapter": "harness-profile",
+      "adapter": "profile-bundle",
       "failurePolicy": "generation-rollback",
       "touchesCurrentBeforeActivation": false
     },

package/src/config.ts

@@ -11,6 +11,23 @@
 import z from '@deepseek-ai/schemastery'
 import { resolve } from 'node:path'
 
+/** 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 {
   /**
@@ -42,6 +59,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. */
@@ -62,6 +83,10 @@ 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. */
@@ -74,6 +99,16 @@ export const Config: z<Config> = z.object({
   truncationMarker: z.string().default('\n\n[style truncated]'),
   includeBuiltins: 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),
 })
 
 /**
@@ -97,6 +132,18 @@ export function resolveConfig(config: Config, defaultStylesDir: string): Resolve
   const rawDirs = Array.isArray(config.stylesDir) ? config.stylesDir : config.stylesDir === undefined || config.stylesDir === '' ? [] : [config.stylesDir]
   const customDirs = rawDirs.map(dir => resolve(dir))
   const stylesDirs = includeBuiltins ? [defaultStylesDir, ...customDirs] : customDirs
+  for (const rule of config.rules ?? []) {
+    const match = rule.match ?? {}
+    if (match.tool !== undefined && 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 !== undefined && !Number.isFinite(rule.priority)) {
+      throw new Error(`dsh-output-styles: rule priority must be a finite number, got ${String(rule.priority)}`)
+    }
+  }
   return {
     stylesDirs,
     maxStyleChars,
@@ -106,5 +153,7 @@ export function resolveConfig(config: Config, defaultStylesDir: string): Resolve
     truncationMarker: config.truncationMarker ?? '\n\n[style truncated]',
     includeBuiltins,
     watchStyles: config.watchStyles ?? true,
+    rules: (config.rules ?? []).map(rule => ({ ...rule, priority: rule.priority ?? 0 })),
+    enableExport: config.enableExport ?? true,
   }
 }

package/src/export.ts

@@ -0,0 +1,199 @@
+/**
+ * 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 { deriveEventMessage, foldSurface } from '@deepseek-ai/dsh-session/surface'
+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 function conversationLines(events: readonly SessionEvent[]): ExportLine[] {
+  const { nodes } = foldSurface(events)
+  const lines: ExportLine[] = []
+  for (const seq of nodes) {
+    const event = events.find(item => item.seq === seq)
+    if (event === undefined) 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: { readonly content?: unknown; readonly role?: string }): ExportLine {
+  const content = message.content
+  const baseRole: 'user' | 'assistant' = message.role === 'assistant' ? 'assistant' : 'user'
+  if (typeof content === 'string') {
+    return { role: baseRole, text: content.trim() }
+  }
+  if (Array.isArray(content)) {
+    const textParts: string[] = []
+    const toolUses: string[] = []
+    const toolResults: string[] = []
+    for (const part of content) {
+      if (part === null || typeof part !== 'object') continue
+      const record = part as Record<string, unknown>
+      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 as Record<string, unknown>)['text'] === 'string' ? (item as Record<string, unknown>)['text'] : '').join(' ')
+            : ''
+        toolResults.push(body.trim())
+      }
+    }
+    if (textParts.length === 0 && toolUses.length > 0) {
+      const first = toolUses[0]
+      return first === undefined
+        ? { 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.
+ */
+export function sanitizeText(text: string): string {
+  // eslint-disable-next-line no-control-regex
+  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.
+ */
+export function lineToMarkdown(line: ExportLine): string {
+  if (line.tool !== undefined) {
+    return `### \`${line.tool}\`\n\n\`\`\`text\n${line.text}\n\`\`\``
+  }
+  const heading = line.role === 'user' ? '## User' : '## Assistant'
+  return `${heading}\n\n${line.text}`
+}
+
+/** Build the complete Markdown document for a set of lines. */
+export function toMarkdown(lines: readonly ExportLine[]): string {
+  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. */
+export function toHtml(lines: readonly ExportLine[]): string {
+  const body = lines.map((line) => {
+    const safe = sanitizeText(line.text).replace(/\n/g, '<br>')
+    if (line.tool !== undefined) {
+      return `<h3><code>${sanitizeText(line.tool)}</code></h3>\n<pre>${safe}</pre>`
+    }
+    const heading = line.role === 'user' ? 'User' : 'Assistant'
+    return `<h2>${heading}</h2>\n<p>${safe}</p>`
+  }).join('\n')
+  return '<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><title>Session export</title></head>\n<body>\n'
+    + `<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.
+ */
+export function renderExport(
+  registry: RendererRegistry,
+  lines: readonly ExportLine[],
+  format: 'markdown' | 'html',
+  rules: readonly import('./renderers.ts').StyleRule[],
+  now: Date = new Date(),
+): ExportDocument {
+  const rendered: RenderedText[] = []
+  const presented: ExportLine[] = 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,
+  }
+}