deepclause-sdk 0.0.89 → 0.1.1

package/dist/visualize/ascii.js.map

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

package/dist/visualize/display.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared "diagram → terminal image" step.
+ *
+ * Both `/viz` (user-typed) and the authoring agent's `visualize` tool use this,
+ * so a diagram is painted the same way everywhere: resolve the terminal's image
+ * protocol, rasterize the SVG (no browser), and encode an inline image. Returns
+ * undefined when the terminal has no image support or no rasterizer is
+ * installed, so the caller can fall back to the ASCII tree.
+ */
+import { type GraphicsMode } from './graphics.js';
+export interface DiagramImageSource {
+    svg: string;
+    width: number;
+    height: number;
+}
+export interface DiagramImageOptions {
+    /** `auto` (default) or a forced protocol; `ascii`/`off` disable the image. */
+    graphics?: GraphicsMode;
+    maxWidthCells?: number;
+    maxHeightCells?: number;
+}
+/** Encode a diagram as inline terminal-image lines, or undefined. */
+export declare function renderDiagramImage(source: DiagramImageSource, options?: DiagramImageOptions): Promise<string[] | undefined>;
+//# sourceMappingURL=display.d.ts.map

package/dist/visualize/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/visualize/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhG,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qEAAqE;AACrE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAe/B"}

package/dist/visualize/display.js

@@ -0,0 +1,29 @@
+/**
+ * Shared "diagram → terminal image" step.
+ *
+ * Both `/viz` (user-typed) and the authoring agent's `visualize` tool use this,
+ * so a diagram is painted the same way everywhere: resolve the terminal's image
+ * protocol, rasterize the SVG (no browser), and encode an inline image. Returns
+ * undefined when the terminal has no image support or no rasterizer is
+ * installed, so the caller can fall back to the ASCII tree.
+ */
+import { rasterizeSvg } from './raster.js';
+import { renderTerminalImage, resolveGraphicsProtocol } from './graphics.js';
+/** Encode a diagram as inline terminal-image lines, or undefined. */
+export async function renderDiagramImage(source, options = {}) {
+    const protocol = resolveGraphicsProtocol(options.graphics ?? 'auto');
+    if (!protocol) {
+        return undefined;
+    }
+    const png = await rasterizeSvg(source.svg, { width: source.width, height: source.height });
+    if (!png) {
+        return undefined;
+    }
+    const image = renderTerminalImage(png, {
+        protocol,
+        maxWidthCells: options.maxWidthCells ?? 80,
+        maxHeightCells: options.maxHeightCells,
+    });
+    return image?.lines;
+}
+//# sourceMappingURL=display.js.map

package/dist/visualize/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/visualize/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAqB,MAAM,eAAe,CAAC;AAehG,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA0B,EAC1B,UAA+B,EAAE;IAEjC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3F,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,EAAE;QACrC,QAAQ;QACR,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;QAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC;IACH,OAAO,KAAK,EAAE,KAAK,CAAC;AACtB,CAAC"}

package/dist/visualize/graphics.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Terminal graphics over `@earendil-works/pi-tui`'s `terminal-image` module.
+ *
+ * We reuse pi's Kitty / iTerm2 inline-image encoding and its capability
+ * detection (Kitty, Ghostty, WezTerm, iTerm2 — tmux-aware); when the terminal
+ * advertises no image protocol the caller falls back to `renderMermaidAscii`.
+ *
+ * The returned `lines` mirror pi-tui's `Image` component: the escape sequence
+ * plus the empty padding rows the TUI must reserve for the image.
+ */
+/** User-facing graphics selection (`/viz --graphics=<mode>`). */
+export type GraphicsMode = 'auto' | 'kitty' | 'iterm2' | 'ascii' | 'off';
+export type GraphicsProtocol = 'kitty' | 'iterm2';
+/** Resolve the protocol to use for a mode, or undefined for ASCII/no image. */
+export declare function resolveGraphicsProtocol(mode?: GraphicsMode): GraphicsProtocol | undefined;
+/** True when the current terminal can display inline images. */
+export declare function graphicsSupported(): boolean;
+export interface RenderedImage {
+    /** Lines to emit: the escape sequence plus reserved padding rows. */
+    lines: string[];
+    columns: number;
+    rows: number;
+    protocol: GraphicsProtocol;
+}
+export interface RenderImageOptions {
+    protocol: GraphicsProtocol;
+    maxWidthCells?: number;
+    maxHeightCells?: number;
+}
+/**
+ * Encode a PNG buffer for inline display. Returns undefined when the PNG is not
+ * recognizable or sizing fails.
+ */
+export declare function renderTerminalImage(png: Buffer, options: RenderImageOptions): RenderedImage | undefined;
+//# sourceMappingURL=graphics.d.ts.map

package/dist/visualize/graphics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../src/visualize/graphics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAEzE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElD,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,YAAqB,GAAG,gBAAgB,GAAG,SAAS,CASjG;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AA2BD,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,aAAa,GAAG,SAAS,CA8CvG"}

package/dist/visualize/graphics.js

@@ -0,0 +1,96 @@
+/**
+ * Terminal graphics over `@earendil-works/pi-tui`'s `terminal-image` module.
+ *
+ * We reuse pi's Kitty / iTerm2 inline-image encoding and its capability
+ * detection (Kitty, Ghostty, WezTerm, iTerm2 — tmux-aware); when the terminal
+ * advertises no image protocol the caller falls back to `renderMermaidAscii`.
+ *
+ * The returned `lines` mirror pi-tui's `Image` component: the escape sequence
+ * plus the empty padding rows the TUI must reserve for the image.
+ */
+import { allocateImageId, encodeITerm2, encodeKitty, getCapabilities, getCellDimensions, getPngDimensions, renderImage, } from '@earendil-works/pi-tui';
+/** Resolve the protocol to use for a mode, or undefined for ASCII/no image. */
+export function resolveGraphicsProtocol(mode = 'auto') {
+    if (mode === 'off' || mode === 'ascii') {
+        return undefined;
+    }
+    if (mode === 'kitty' || mode === 'iterm2') {
+        return mode;
+    }
+    const detected = getCapabilities().images;
+    return detected ?? undefined;
+}
+/** True when the current terminal can display inline images. */
+export function graphicsSupported() {
+    return resolveGraphicsProtocol('auto') !== undefined;
+}
+/**
+ * Fit an image (px) into a cell box, mirroring pi-tui's `calculateImageCellSize`
+ * (which the package does not re-export from its index).
+ */
+function fitToCells(dimensions, maxWidthCells, maxHeightCells) {
+    const cell = getCellDimensions();
+    const maxWidth = Math.max(1, Math.floor(maxWidthCells));
+    const maxHeight = maxHeightCells === undefined ? undefined : Math.max(1, Math.floor(maxHeightCells));
+    const imageWidth = Math.max(1, dimensions.widthPx);
+    const imageHeight = Math.max(1, dimensions.heightPx);
+    const widthScale = (maxWidth * cell.widthPx) / imageWidth;
+    const heightScale = maxHeight === undefined ? widthScale : (maxHeight * cell.heightPx) / imageHeight;
+    const scale = Math.min(widthScale, heightScale);
+    const columns = Math.max(1, Math.min(maxWidth, Math.ceil((imageWidth * scale) / cell.widthPx)));
+    let rows = Math.max(1, Math.ceil((imageHeight * scale) / cell.heightPx));
+    if (maxHeight !== undefined) {
+        rows = Math.min(maxHeight, rows);
+    }
+    return { columns, rows };
+}
+/**
+ * Encode a PNG buffer for inline display. Returns undefined when the PNG is not
+ * recognizable or sizing fails.
+ */
+export function renderTerminalImage(png, options) {
+    const base64 = png.toString('base64');
+    const dimensions = getPngDimensions(base64);
+    if (!dimensions) {
+        return undefined;
+    }
+    const maxWidth = Math.max(1, options.maxWidthCells ?? 80);
+    const detected = getCapabilities().images;
+    // When the requested protocol is the detected one, use pi-tui's `renderImage`:
+    // it registers Kitty metadata that the TUI needs for row reservation and
+    // scrolling. Forced mismatches fall back to the raw encoders.
+    if (detected === options.protocol) {
+        const result = renderImage(base64, dimensions, {
+            maxWidthCells: maxWidth,
+            maxHeightCells: options.maxHeightCells,
+            imageId: options.protocol === 'kitty' ? allocateImageId() : undefined,
+            moveCursor: false,
+        });
+        if (!result) {
+            return undefined;
+        }
+        const rowOffset = result.rows - 1;
+        const lines = options.protocol === 'kitty'
+            ? [result.sequence, ...Array(rowOffset).fill('')]
+            : [...Array(rowOffset).fill(''), `${rowOffset > 0 ? `\x1b[${rowOffset}A` : ''}${result.sequence}`];
+        return { lines, columns: result.columns, rows: result.rows, protocol: options.protocol };
+    }
+    const size = fitToCells(dimensions, maxWidth, options.maxHeightCells);
+    if (options.protocol === 'kitty') {
+        const sequence = encodeKitty(base64, { columns: size.columns, rows: size.rows, imageId: allocateImageId(), moveCursor: false });
+        const lines = [sequence];
+        for (let i = 0; i < size.rows - 1; i++) {
+            lines.push('');
+        }
+        return { lines, columns: size.columns, rows: size.rows, protocol: 'kitty' };
+    }
+    const sequence = encodeITerm2(base64, { width: size.columns, height: 'auto', preserveAspectRatio: true });
+    const lines = [];
+    for (let i = 0; i < size.rows - 1; i++) {
+        lines.push('');
+    }
+    const rowOffset = size.rows - 1;
+    lines.push(`${rowOffset > 0 ? `\x1b[${rowOffset}A` : ''}${sequence}`);
+    return { lines, columns: size.columns, rows: size.rows, protocol: 'iterm2' };
+}
+//# sourceMappingURL=graphics.js.map

package/dist/visualize/graphics.js.map

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

package/dist/visualize/image.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Resolve a media reference (`output(media(...))`, a file, inline SVG, or inline
+ * bytes) into a base64 PNG for terminal display, and to bytes for saving.
+ *
+ * Same pipeline as the diagram renderer: SVG → resvg, PNG passthrough, other
+ * rasters → optional `sharp` (`transcode.ts`). When no raster can be produced,
+ * the caller falls back to showing the path.
+ */
+export interface MediaInput {
+    /** Workspace-relative path (for file references). */
+    path?: string;
+    mimeType?: string;
+    /** `file` (default) | `inline_svg` | `inline_data`. */
+    kind?: string;
+    /** SVG source text (`inline_svg`) or base64 bytes (`inline_data`). */
+    data?: string;
+}
+export interface ResolvedMedia {
+    mimeType: string;
+    relPath?: string;
+    absPath?: string;
+    /** Base64 PNG when one could be produced (for inline terminal display). */
+    pngBase64?: string;
+    /** Raw bytes when read from a file. */
+    bytes?: Buffer;
+}
+/** Resolve a media reference to (optionally) a base64 PNG + path metadata. */
+export declare function resolveMedia(workspacePath: string, media: MediaInput): Promise<ResolvedMedia | undefined>;
+/**
+ * Materialize a media reference to a workspace file. Inline SVG/bytes and file
+ * references are written to `outPath` (workspace-relative). When the target is
+ * `.svg`, an inline SVG is written verbatim; otherwise raster content is written.
+ */
+export declare function saveMedia(workspacePath: string, media: MediaInput, outPath: string): Promise<{
+    path: string;
+    mimeType: string;
+}>;
+//# sourceMappingURL=image.d.ts.map

package/dist/visualize/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/visualize/image.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0BD,8EAA8E;AAC9E,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA+B/G;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA2B7C"}

package/dist/visualize/image.js

@@ -0,0 +1,95 @@
+/**
+ * Resolve a media reference (`output(media(...))`, a file, inline SVG, or inline
+ * bytes) into a base64 PNG for terminal display, and to bytes for saving.
+ *
+ * Same pipeline as the diagram renderer: SVG → resvg, PNG passthrough, other
+ * rasters → optional `sharp` (`transcode.ts`). When no raster can be produced,
+ * the caller falls back to showing the path.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { rasterizeSvg } from './raster.js';
+import { transcodeToPng } from './transcode.js';
+const DEFAULT_SVG_WIDTH = 900;
+const MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+};
+/** Mime for a reference: explicit wins, else inferred from the extension. */
+function inferMime(relPath, given) {
+    if (given) {
+        return given;
+    }
+    const ext = relPath ? path.extname(relPath).toLowerCase() : '';
+    return MIME_BY_EXT[ext] ?? 'image/png';
+}
+function isSvg(mimeType, source) {
+    return mimeType === 'image/svg+xml' || /^\s*<svg[\s>]/i.test(source);
+}
+/** Resolve a media reference to (optionally) a base64 PNG + path metadata. */
+export async function resolveMedia(workspacePath, media) {
+    const mimeType = inferMime(media.path, media.mimeType);
+    // Inline SVG text or inline bytes.
+    if (media.kind === 'inline_svg' || (media.data && isSvg(mimeType, media.data))) {
+        const png = await rasterizeSvg(media.data ?? '', { width: DEFAULT_SVG_WIDTH, height: 0 });
+        return { mimeType: 'image/svg+xml', pngBase64: png?.toString('base64') };
+    }
+    if (media.kind === 'inline_data' || (media.data && !media.path)) {
+        const bytes = Buffer.from(media.data ?? '', 'base64');
+        const png = await transcodeToPng(bytes, mimeType);
+        return { mimeType, pngBase64: png?.toString('base64'), bytes };
+    }
+    if (!media.path) {
+        return undefined;
+    }
+    const absPath = path.resolve(workspacePath, media.path);
+    let bytes;
+    try {
+        bytes = await fs.readFile(absPath);
+    }
+    catch {
+        return { mimeType, relPath: media.path, absPath };
+    }
+    if (mimeType === 'image/svg+xml') {
+        const png = await rasterizeSvg(bytes.toString('utf8'), { width: DEFAULT_SVG_WIDTH, height: 0 });
+        return { mimeType, relPath: media.path, absPath, bytes, pngBase64: png?.toString('base64') };
+    }
+    const png = await transcodeToPng(bytes, mimeType);
+    return { mimeType, relPath: media.path, absPath, bytes, pngBase64: png?.toString('base64') };
+}
+/**
+ * Materialize a media reference to a workspace file. Inline SVG/bytes and file
+ * references are written to `outPath` (workspace-relative). When the target is
+ * `.svg`, an inline SVG is written verbatim; otherwise raster content is written.
+ */
+export async function saveMedia(workspacePath, media, outPath) {
+    const resolved = await resolveMedia(workspacePath, media);
+    if (!resolved) {
+        throw new Error('empty media reference');
+    }
+    const abs = path.resolve(workspacePath, outPath);
+    await fs.mkdir(path.dirname(abs), { recursive: true });
+    if (outPath.toLowerCase().endsWith('.svg')) {
+        const svg = media.kind === 'inline_svg' || isSvg(media.mimeType, media.data ?? '')
+            ? (media.data ?? '')
+            : resolved.bytes?.toString('utf8');
+        if (svg) {
+            await fs.writeFile(abs, svg, 'utf8');
+            return { path: outPath, mimeType: 'image/svg+xml' };
+        }
+    }
+    if (resolved.pngBase64) {
+        await fs.writeFile(abs, Buffer.from(resolved.pngBase64, 'base64'));
+        return { path: outPath, mimeType: 'image/png' };
+    }
+    if (resolved.bytes) {
+        await fs.writeFile(abs, resolved.bytes);
+        return { path: outPath, mimeType: resolved.mimeType };
+    }
+    throw new Error(`cannot save media to ${outPath}`);
+}
+//# sourceMappingURL=image.js.map

package/dist/visualize/image.js.map

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

package/dist/visualize/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `deepclause visualize` — turn a harness (its `listing`, including `doc/2` and
+ * `module_doc/1`) into a Mermaid diagram.
+ *
+ * Two granularities, mirroring sop2harness:
+ *   - `presentation`: a general-audience overview (inputs, steps, answer).
+ *   - `spec`: engineering detail (decisions, thresholds, task/exec calls,
+ *     branches, fallbacks).
+ *
+ * The Mermaid source is always the deliverable; PNG/SVG rendering is best
+ * effort via `@mermaid-js/mermaid-cli` (`mmdc`) when it is available.
+ */
+export type DiagramMode = 'presentation' | 'spec';
+export interface DiagramPromptInput {
+    /** Entry predicate, e.g. `router/2`. */
+    entry: string;
+    mode: DiagramMode;
+    /** The harness `listing` text (source + `doc/2` annotations + manifest). */
+    listing: string;
+}
+/**
+ * Build the diagram-generation prompt. The model only sees the harness listing
+ * (source + docs) and the entry point, and must return Mermaid only.
+ */
+export declare function buildDiagramPrompt(input: DiagramPromptInput): string;
+/** Extract Mermaid source from a model reply (strips fences and leading prose). */
+export declare function extractMermaid(text: string): string;
+/** Light structural validation (same spirit as sop2harness). */
+export declare function validateMermaid(source: string): string[];
+/** A mermaid renderer command, if one is available. */
+export declare function findMermaidRenderer(): {
+    command: string;
+    args: string[];
+} | undefined;
+/**
+ * Render a `.mmd` file to an image. Returns the renderer used, or throws with a
+ * helpful message when no renderer is available.
+ */
+export declare function renderMermaidFile(mmdPath: string, outputPath: string): Promise<string>;
+/** Split `name/arity` (or `name`) into a predicate name and arity. */
+export declare function parseEntry(entry: string): {
+    name: string;
+    arity?: number;
+};
+/** Resolve the `.mmd` path and the optional image path from `--output`. */
+export declare function resolveOutputPaths(output: string | undefined, entry: string): {
+    mmdPath: string;
+    imagePath?: string;
+};
+/** Write the Mermaid source (creating directories as needed). */
+export declare function writeMermaid(mmdPath: string, source: string): Promise<void>;
+export * from './ascii.js';
+export * from './svg.js';
+export * from './raster.js';
+export * from './graphics.js';
+export * from './display.js';
+export * from './image.js';
+export * from './transcode.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/visualize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/visualize/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,MAAM,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAuCpE;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBxD;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAQrF;AAiBD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsC5F;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1E;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CASrH;AAED,iEAAiE;AACjE,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAID,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/visualize/index.js

@@ -0,0 +1,198 @@
+/**
+ * `deepclause visualize` — turn a harness (its `listing`, including `doc/2` and
+ * `module_doc/1`) into a Mermaid diagram.
+ *
+ * Two granularities, mirroring sop2harness:
+ *   - `presentation`: a general-audience overview (inputs, steps, answer).
+ *   - `spec`: engineering detail (decisions, thresholds, task/exec calls,
+ *     branches, fallbacks).
+ *
+ * The Mermaid source is always the deliverable; PNG/SVG rendering is best
+ * effort via `@mermaid-js/mermaid-cli` (`mmdc`) when it is available.
+ */
+import { spawnSync } from 'child_process';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+const DIAGRAM_TYPE = /^\s*(flowchart|graph|sequenceDiagram|classDiagram|stateDiagram|erDiagram|journey|gantt|pie)\b/i;
+/**
+ * Build the diagram-generation prompt. The model only sees the harness listing
+ * (source + docs) and the entry point, and must return Mermaid only.
+ */
+export function buildDiagramPrompt(input) {
+    const kind = input.mode === 'presentation'
+        ? [
+            'KIND: presentation — a general-audience overview.',
+            '- Show the skill name, its inputs, the main steps in order, and the final answer.',
+            '- Read like a process a stakeholder could follow. Avoid Prolog syntax and predicate names in labels.',
+        ].join('\n')
+        : [
+            'KIND: specification — engineering detail.',
+            '- Show every decision (choose/verify/rate/probability, holds), threshold, and rule fact.',
+            '- Show task/N and prompt/N model calls (with their typed outputs), exec/2 tool calls, branches,',
+            '  backtracking, and explicit fallback paths.',
+        ].join('\n');
+    return [
+        'You are a technical writer who turns DeepClause (Prolog/DML) agent harnesses into Mermaid diagrams.',
+        '',
+        `Produce ONE Mermaid diagram for the skill \`${input.entry}\` in the harness below.`,
+        '',
+        'OUTPUT RULES',
+        '- Return ONLY Mermaid source. No prose, no explanation, no ``` code fences.',
+        '- The first line must be `flowchart TD` or `flowchart LR`.',
+        '- Quote any node label containing spaces or punctuation: A["text"], B["x = 1"].',
+        '- Plain flowchart syntax only (nodes, edges, subgraphs). No `classDef`/`style`/`click` directives.',
+        '- Keep it readable: at most about 20 nodes.',
+        '',
+        'HARNESS SEMANTICS',
+        '- task/N, prompt/N: a model call (prompt/N has fresh context).',
+        '- exec(Tool(...)): a host tool call (usually bash).',
+        '- choose/verify/rate/probability, holds: a semantic judgment (a decision).',
+        '- Multiple clauses / `;` / `->`: alternative paths; show the "else"/fallback.',
+        '',
+        kind,
+        '',
+        `HARNESS (focus: ${input.entry}; the listing includes each predicate and its doc/2 annotation)`,
+        '```',
+        input.listing.trim() || '(empty harness)',
+        '```',
+    ].join('\n');
+}
+/** Extract Mermaid source from a model reply (strips fences and leading prose). */
+export function extractMermaid(text) {
+    let out = (text ?? '').trim();
+    const fence = out.match(/```(?:mermaid)?\s*\n?([\s\S]*?)```/i);
+    if (fence) {
+        out = fence[1].trim();
+    }
+    const lines = out.split('\n');
+    const start = lines.findIndex((line) => DIAGRAM_TYPE.test(line));
+    if (start > 0) {
+        out = lines.slice(start).join('\n').trim();
+    }
+    return out;
+}
+/** Light structural validation (same spirit as sop2harness). */
+export function validateMermaid(source) {
+    const issues = [];
+    const lines = source.split('\n').map((line) => line.trim()).filter(Boolean);
+    if (lines.length === 0) {
+        return ['the diagram is empty'];
+    }
+    const first = lines.find((line) => !line.startsWith('%%'));
+    if (!first) {
+        issues.push('no diagram body (only comments)');
+    }
+    else if (!DIAGRAM_TYPE.test(first)) {
+        issues.push(`unrecognized diagram type: ${first.split(/\s+/)[0]}`);
+    }
+    for (const [open, close] of [['{', '}'], ['[', ']'], ['(', ')']]) {
+        const opens = (source.match(new RegExp(`\\${open}`, 'g')) ?? []).length;
+        const closes = (source.match(new RegExp(`\\${close}`, 'g')) ?? []).length;
+        if (opens !== closes) {
+            issues.push(`unbalanced ${open}${close} (${opens}/${closes})`);
+        }
+    }
+    return issues;
+}
+/** A mermaid renderer command, if one is available. */
+export function findMermaidRenderer() {
+    const which = process.platform === 'win32' ? 'where' : 'which';
+    for (const candidate of ['mmdc', 'mmdc.cmd']) {
+        if (spawnSync(which, [candidate], { stdio: 'ignore' }).status === 0) {
+            return { command: candidate, args: [] };
+        }
+    }
+    return undefined;
+}
+/** Absolute path to a system Chromium/Chrome, for puppeteer to launch. */
+function findChrome() {
+    const which = process.platform === 'win32' ? 'where' : 'which';
+    for (const candidate of ['google-chrome', 'chromium', 'chromium-browser', 'chrome']) {
+        const result = spawnSync(which, [candidate], { encoding: 'utf8' });
+        if (result.status === 0) {
+            const first = (result.stdout ?? '').trim().split('\n')[0].trim();
+            if (first) {
+                return first;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Render a `.mmd` file to an image. Returns the renderer used, or throws with a
+ * helpful message when no renderer is available.
+ */
+export async function renderMermaidFile(mmdPath, outputPath) {
+    const renderer = findMermaidRenderer();
+    const command = renderer ? renderer.command : 'npx';
+    const args = renderer ? [...renderer.args] : ['--yes', '@mermaid-js/mermaid-cli'];
+    args.push('-i', mmdPath, '-o', outputPath, '-b', 'white');
+    const env = { ...process.env };
+    if (!env.PUPPETEER_EXECUTABLE_PATH) {
+        const chrome = findChrome();
+        if (chrome) {
+            env.PUPPETEER_EXECUTABLE_PATH = chrome;
+        }
+    }
+    // Reuse the system browser instead of downloading Chromium for puppeteer.
+    if (env.PUPPETEER_EXECUTABLE_PATH && env.PUPPETEER_SKIP_DOWNLOAD == null) {
+        env.PUPPETEER_SKIP_DOWNLOAD = 'true';
+    }
+    // Chrome sandbox flags (mirrors sop2harness's `mmdc -p <config>` usage).
+    const configPath = path.join(os.tmpdir(), `deepclause-mermaid-${process.pid}.json`);
+    await fs.writeFile(configPath, JSON.stringify({
+        args: ['--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage'],
+    }));
+    args.push('-p', configPath);
+    try {
+        const result = spawnSync(command, args, { env, encoding: 'utf8' });
+        if (result.status !== 0) {
+            const reason = (result.stderr || result.stdout || '').trim().split('\n').slice(-3).join(' ');
+            throw new Error(`Mermaid renderer failed${reason ? `: ${reason}` : ''}. `
+                + 'Install it with `npm i -g @mermaid-js/mermaid-cli` (or use `--output <file>.mmd`).');
+        }
+        return renderer ? renderer.command : 'npx @mermaid-js/mermaid-cli';
+    }
+    finally {
+        await fs.rm(configPath, { force: true });
+    }
+}
+/** Split `name/arity` (or `name`) into a predicate name and arity. */
+export function parseEntry(entry) {
+    const match = entry.trim().match(/^([A-Za-z_][A-Za-z0-9_]*)\s*\/\s*(\d+)$/);
+    if (match) {
+        return { name: match[1], arity: Number(match[2]) };
+    }
+    const bare = entry.trim().match(/^([A-Za-z_][A-Za-z0-9_]*)$/);
+    if (bare) {
+        return { name: bare[1] };
+    }
+    throw new Error(`invalid entry '${entry}': expected Name/Arity (e.g. router/2)`);
+}
+/** Resolve the `.mmd` path and the optional image path from `--output`. */
+export function resolveOutputPaths(output, entry) {
+    const fallback = `${entry.replace(/[^A-Za-z0-9_.-]/g, '_') || 'diagram'}.mmd`;
+    const target = output ?? fallback;
+    if (target.toLowerCase().endsWith('.mmd')) {
+        return { mmdPath: target };
+    }
+    const ext = path.extname(target);
+    const mmdPath = ext ? `${target.slice(0, -ext.length)}.mmd` : `${target}.mmd`;
+    return { mmdPath, imagePath: target };
+}
+/** Write the Mermaid source (creating directories as needed). */
+export async function writeMermaid(mmdPath, source) {
+    await fs.mkdir(path.dirname(path.resolve(mmdPath)), { recursive: true });
+    await fs.writeFile(mmdPath, `${source.trim()}\n`, 'utf8');
+}
+// Terminal rendering: Mermaid → Unicode tree, Mermaid → SVG → PNG (no browser),
+// and phone into pi-tui's Kitty/iTerm2 inline-image encoder.
+export * from './ascii.js';
+export * from './svg.js';
+export * from './raster.js';
+export * from './graphics.js';
+export * from './display.js';
+export * from './image.js';
+export * from './transcode.js';
+//# sourceMappingURL=index.js.map