@juspay/neurolink 12.30.2 → 12.31.1

package/dist/cli/loop/optionsSchema.d.ts

@@ -4,4 +4,4 @@ import type { OptionSchema, TextGenerationOptions } from "../../types/index.js";
  * This object provides metadata for validation and help text in the CLI loop.
  * It is derived from the main TextGenerationOptions interface to ensure consistency.
  */
-export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region" | "csvOptions" | "pdfOptions" | "imageOptions" | "videoOptions" | "tts" | "stt" | "thinkingConfig" | "requestId" | "fileRegistry" | "abortSignal" | "toolFilter" | "excludeTools" | "toolChoice" | "prepareStep" | "credentials" | "onFinish" | "onError" | "processors" | "piiDetection" | "responseValidation" | "inputValidation" | "toolExecutionCapture" | "toolExecutionRecorder" | "toolRoots">, OptionSchema>;
+export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region" | "csvOptions" | "pdfOptions" | "imageOptions" | "videoOptions" | "officeOptions" | "tts" | "stt" | "thinkingConfig" | "requestId" | "fileRegistry" | "abortSignal" | "toolFilter" | "excludeTools" | "toolChoice" | "prepareStep" | "credentials" | "onFinish" | "onError" | "processors" | "piiDetection" | "responseValidation" | "inputValidation" | "toolExecutionCapture" | "toolExecutionRecorder" | "toolRoots">, OptionSchema>;

package/dist/cli/proxy-clients/codex.js

@@ -158,23 +158,28 @@ export async function setCodexProxySettings(baseUrl) {
             logger.warn(`[proxy] Codex: config.toml declares [${duplicate}] more than once; leaving it untouched`);
             return false;
         }
-        // Snapshot the user's original selector once (survives crashes/restarts).
-        if (!fs.existsSync(getCodexSnapshotPath())) {
-            // Same preamble boundary the edit paths use. Matching document-wide would
-            // capture a `model_provider` belonging to a table — a legacy
-            // `[profiles.<name>]` block, say — and the restore would then write that
-            // profile's provider back as the top-level selector.
-            let providerMatch = null;
-            editTomlPreamble(original, (preamble) => {
-                providerMatch = preamble.match(CODEX_PROVIDER_LINE_RE);
-                return null;
-            });
-            // Ignore a stale managed selector line if present in the original.
-            const originalProviderLine = providerMatch && !/"neurolink"/.test(providerMatch[0])
-                ? providerMatch[0]
-                : null;
+        // Same preamble boundary the edit paths use. Matching document-wide would
+        // capture a `model_provider` belonging to a table — a legacy
+        // `[profiles.<name>]` block, say — and the restore would then write that
+        // profile's provider back as the top-level selector.
+        let providerMatch = null;
+        editTomlPreamble(original, (preamble) => {
+            providerMatch = preamble.match(CODEX_PROVIDER_LINE_RE);
+            return null;
+        });
+        // A selector naming "neurolink" is the one the proxy writes, possibly left
+        // by an earlier run, and never the user's choice.
+        const userProviderLine = providerMatch && !/"neurolink"/.test(providerMatch[0])
+            ? providerMatch[0]
+            : null;
+        const selectorIsOurs = providerMatch !== null && userProviderLine === null;
+        // Snapshot on first touch, and again whenever the top-level selector is
+        // not the proxy's. An unclean exit skips restore and leaves the snapshot
+        // behind; a provider the user then picks by hand, or a selector they
+        // remove, is newer than that snapshot and is what restore must bring back.
+        if (!fs.existsSync(getCodexSnapshotPath()) || !selectorIsOurs) {
             fs.mkdirSync(join(homedir(), ".neurolink"), { recursive: true });
-            await writeFileAtomic(getCodexSnapshotPath(), JSON.stringify({ originalProviderLine }, null, 2), 0o600);
+            await writeFileAtomic(getCodexSnapshotPath(), JSON.stringify({ originalProviderLine: userProviderLine }, null, 2), 0o600);
         }
         // Every proxy start applies. Rewriting a file that already matches only
         // widens the window for racing Codex's own saves.

package/dist/core/baseProvider.js

@@ -937,6 +937,7 @@ export class BaseProvider {
                 csvOptions: options.csvOptions,
                 pdfOptions: options.pdfOptions,
                 videoOptions: options.videoOptions,
+                officeOptions: options.officeOptions,
                 // Forward abort, tool filtering, and timeout options to prevent
                 // silent bypass when falling back from real streaming to fake streaming
                 abortSignal: options.abortSignal,

package/dist/core/modules/MessageBuilder.js

@@ -109,6 +109,11 @@ export class MessageBuilder {
                     // transcription flag are read downstream by the detector, and
                     // a reconstruction that omits them silently restores defaults.
                     videoOptions: options.videoOptions,
+                    // This object is rebuilt field by field, so anything not named
+                    // here never reaches the multimodal builder — the same way
+                    // audioFiles/videoFiles went missing in #284. Office options
+                    // steer XLSX sheet selection and rendering.
+                    officeOptions: options.officeOptions,
                     provider: options.provider,
                     model: options.model,
                     temperature: options.temperature,
@@ -244,6 +249,11 @@ export class MessageBuilder {
                     // transcription flag are read downstream by the detector, and
                     // a reconstruction that omits them silently restores defaults.
                     videoOptions: options.videoOptions,
+                    // This object is rebuilt field by field, so anything not named
+                    // here never reaches the multimodal builder — the same way
+                    // audioFiles/videoFiles went missing in #284. Office options
+                    // steer XLSX sheet selection and rendering.
+                    officeOptions: options.officeOptions,
                     provider: options.provider,
                     model: options.model,
                     temperature: options.temperature,

package/dist/neurolink.js

@@ -4284,6 +4284,7 @@ Current user's request: ${currentInput}`;
             // caller's video settings have ever reached a provider -- frames and
             // quality included, not just the native-video flags added alongside.
             videoOptions: options.videoOptions,
+            officeOptions: options.officeOptions,
             region: options.region,
             tts: options.tts,
             stt: options.stt,

package/dist/processors/document/ExcelProcessor.d.ts

@@ -36,7 +36,7 @@
  * ```
  */
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
-import type { FileInfo, ProcessOptions, ProcessedExcel, ProcessorFileProcessingResult } from "../../types/index.js";
+import type { ExcelWorksheet, FileInfo, OfficeProcessorOptions, ProcessOptions, ProcessedExcel, ProcessorFileProcessingResult } from "../../types/index.js";
 /**
  * Excel Processor - handles .xlsx and .xls files.
  * Uses exceljs library for parsing with support for large files.
@@ -136,6 +136,18 @@ export declare class ExcelProcessor extends BaseFileProcessor<ProcessedExcel> {
      */
     extractSheetRange(buffer: Buffer, sheet?: string | number, rowStart?: number, rowEnd?: number, columns?: string[]): Promise<string>;
 }
+/**
+ * Render processed worksheets into the text handed to the model.
+ *
+ * @param worksheets - Worksheets extracted from the workbook
+ * @param totalRows - Total row count across all extracted worksheets
+ * @param options - Office options; `sheetName` selects a single sheet and
+ *   `formatStyle` chooses the rendering (default `raw`, the tab-separated
+ *   preview that predates the option)
+ * @returns Prompt-ready text, or a message naming the available sheets when
+ *   `sheetName` matches none of them
+ */
+export declare function formatWorksheetsForPrompt(worksheets: ExcelWorksheet[], totalRows: number, options?: OfficeProcessorOptions): string;
 /**
  * Singleton Excel processor instance.
  * Use this for standard Excel processing operations.

package/dist/processors/document/ExcelProcessor.js

@@ -39,6 +39,7 @@ import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { tryImport } from "../../utils/tryImport.js";
+import { dedupeColumnNames } from "../../utils/csvProcessor.js";
 let _exceljs = null;
 async function loadExcelJS() {
     if (_exceljs) {
@@ -482,6 +483,123 @@ export class ExcelProcessor extends BaseFileProcessor {
     }
 }
 // =============================================================================
+// PROMPT FORMATTING
+// =============================================================================
+/** Rows beyond this per sheet are summarised rather than listed. */
+const PROMPT_PREVIEW_ROWS = 20;
+/** RFC 4180: quote a field that contains a comma, quote or newline. */
+function csvEscape(value) {
+    return /[",\r\n]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+/** A pipe inside a cell would otherwise split it into two columns. */
+function markdownEscape(value) {
+    return value
+        .replace(/\\/g, "\\\\")
+        .replace(/\|/g, "\\|")
+        .replace(/\r?\n/g, " ");
+}
+function cellText(value) {
+    return String(value ?? "");
+}
+function formatSheetRows(sheet, formatStyle) {
+    const previewRows = sheet.rows.slice(0, PROMPT_PREVIEW_ROWS);
+    if (previewRows.length === 0) {
+        return "";
+    }
+    switch (formatStyle) {
+        case "markdown": {
+            // `rows[0]` IS the header row (that is where `headers` came from), so
+            // the body always starts at index 1 — emitting row 0 again would
+            // duplicate the header underneath the separator.
+            const header = sheet.headers.length > 0 ? sheet.headers : previewRows[0].map(cellText);
+            const body = previewRows.slice(1);
+            const columnCount = Math.max(header.length, ...body.map((row) => row.length), 1);
+            const pad = (cells) => Array.from({ length: columnCount }, (_, i) => markdownEscape(cells[i] ?? ""));
+            return [
+                `| ${pad(header).join(" | ")} |`,
+                `| ${Array.from({ length: columnCount }, () => "---").join(" | ")} |`,
+                ...body.map((row) => `| ${pad(row.map(cellText)).join(" | ")} |`),
+            ].join("\n");
+        }
+        case "csv":
+            return previewRows
+                .map((row) => row.map((cell) => csvEscape(cellText(cell))).join(","))
+                .join("\n");
+        case "json": {
+            const rawHeader = sheet.headers.length > 0 ? sheet.headers : previewRows[0].map(cellText);
+            const body = previewRows.slice(1);
+            // A data row's own populated-cell count can exceed the header's — row
+            // extraction sizes each row on its own last populated cell, not a
+            // workbook-wide column count, so a header truncated by a merged cell
+            // (or a value landing in a column the header left blank) is a normal
+            // spreadsheet shape. "markdown" already sizes on the widest row for
+            // exactly this reason; do the same here instead of zipping strictly to
+            // header.length, which silently dropped every cell past it.
+            const columnCount = Math.max(rawHeader.length, ...body.map((row) => row.length), 1);
+            const extendedHeader = Array.from({ length: columnCount }, (_, i) => rawHeader[i] ?? `Column ${i + 1}`);
+            // Object.fromEntries silently drops a column when two header cells are
+            // literally the same string (a copy-pasted header, a merged-and-split
+            // sheet) — the later column's value overwrites the earlier one under
+            // the shared key. Dedupe first so every column keeps its own key.
+            const header = dedupeColumnNames(extendedHeader);
+            const objects = body.map((row) => Object.fromEntries(header.map((key, i) => [key, row[i] ?? null])));
+            return JSON.stringify(objects, null, 2);
+        }
+        case "raw":
+        default:
+            // Bug-for-bug with the pre-option behaviour: the header line is printed
+            // and then `rows` is printed in full, so row 1 appears twice. Callers
+            // that want a clean table ask for "markdown" or "csv".
+            return [
+                sheet.headers.join("\t"),
+                ...previewRows.map((row) => row.map(cellText).join("\t")),
+            ].join("\n");
+    }
+}
+/**
+ * Render processed worksheets into the text handed to the model.
+ *
+ * @param worksheets - Worksheets extracted from the workbook
+ * @param totalRows - Total row count across all extracted worksheets
+ * @param options - Office options; `sheetName` selects a single sheet and
+ *   `formatStyle` chooses the rendering (default `raw`, the tab-separated
+ *   preview that predates the option)
+ * @returns Prompt-ready text, or a message naming the available sheets when
+ *   `sheetName` matches none of them
+ */
+export function formatWorksheetsForPrompt(worksheets, totalRows, options) {
+    const requested = options?.sheetName;
+    let selected = worksheets;
+    if (requested !== undefined) {
+        selected = worksheets.filter((sheet) => sheet.name === requested);
+        if (selected.length === 0) {
+            const available = worksheets.map((sheet) => sheet.name).join(", ");
+            return `Sheet "${requested}" not found. Available sheets: ${available || "(none)"}`;
+        }
+    }
+    const formatStyle = options?.formatStyle ?? "raw";
+    const selectedRows = selected.reduce((sum, sheet) => sum + sheet.rowCount, 0);
+    const scope = requested !== undefined
+        ? `Spreadsheet: sheet "${requested}" of ${worksheets.length}, ${selectedRows} rows`
+        : `Spreadsheet: ${worksheets.length} sheet(s), ${totalRows} total rows`;
+    let text = `${scope}\n`;
+    for (const sheet of selected) {
+        text += `\n### Sheet: ${sheet.name}\n`;
+        text += `Columns (${sheet.columnCount}): ${sheet.headers.join(", ")}\n`;
+        text += `Rows: ${sheet.rowCount}\n`;
+        const rendered = formatSheetRows(sheet, formatStyle);
+        if (!rendered) {
+            continue;
+        }
+        text += `\nData:\n${rendered}\n`;
+        const remaining = sheet.rowCount - PROMPT_PREVIEW_ROWS;
+        if (remaining > 0) {
+            text += `... (${remaining} more rows)\n`;
+        }
+    }
+    return text;
+}
+// =============================================================================
 // SINGLETON INSTANCE
 // =============================================================================
 /**

package/dist/processors/document/WordProcessor.js

@@ -35,6 +35,7 @@ import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { tryImport } from "../../utils/tryImport.js";
+import { htmlToMarkdown } from "../../utils/htmlToMarkdown.js";
 let _mammoth = null;
 async function loadMammoth() {
     if (_mammoth) {
@@ -64,6 +65,22 @@ const SUPPORTED_WORD_EXTENSIONS = [".docx", ".doc"];
  * Word documents can be larger due to embedded images and complex formatting
  */
 const WORD_TIMEOUT_MS = 60000;
+/**
+ * Derive the document metrics from the extracted plain text.
+ *
+ * Counted off `textContent` rather than the markdown so the numbers describe
+ * the document's prose, not the syntax added to represent it.
+ */
+function measureText(textContent) {
+    const trimmed = textContent.trim();
+    return {
+        wordCount: trimmed ? trimmed.split(/\s+/).length : 0,
+        paragraphCount: textContent
+            .split(/\n+/)
+            .filter((line) => line.trim().length > 0).length,
+        characterCount: textContent.length,
+    };
+}
 // =============================================================================
 // WORD PROCESSOR CLASS
 // =============================================================================
@@ -144,7 +161,9 @@ export class WordProcessor extends BaseFileProcessor {
         return {
             textContent: "",
             htmlContent: "",
+            markdownContent: "",
             warnings: [],
+            ...measureText(""),
             buffer,
             mimetype: fileInfo.mimetype ||
                 "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
@@ -267,7 +286,9 @@ export class WordProcessor extends BaseFileProcessor {
                     filename: this.getFilename(fileInfo),
                     textContent,
                     htmlContent,
+                    markdownContent: htmlToMarkdown(htmlContent),
                     warnings,
+                    ...measureText(textContent),
                 },
             };
         }

package/dist/proxy/proxyHistoryTruncation.js

@@ -19,8 +19,8 @@ function record(value) {
  * (plain, carrying a complete tool pair, repeated, or opening with a signed
  * `thinking` block). A `role: "system"` message is not — the Messages API
  * requires the initial system prompt in the top-level `system` parameter.
- * Items with no role (Codex `function_call` / `function_call_output`) are not
- * turns and are left alone.
+ * Items with no role (Codex `*_call` / `*_call_output`) are not turns and are
+ * left alone.
  */
 function isDirectiveTurn(item) {
     return record(item) && item.role === "system";
@@ -28,13 +28,26 @@ function isDirectiveTurn(item) {
 function blocksOf(item) {
     return Array.isArray(item.content) ? item.content : [item];
 }
-/** Tool-call ids this item opens. */
+/**
+ * Tool-call ids this item opens.
+ *
+ * Matched on the `_call` suffix rather than an enumerated list of item types.
+ * The Responses API has several call families — `function_call`,
+ * `custom_tool_call`, `local_shell_call`, `computer_call` — and an unrecognised
+ * one is worse than useless here: it opens no id, so unit grouping cannot see
+ * the pair and truncation is free to cut between a call and its answer. A live
+ * Codex session failed exactly that way, upstream rejecting the request with
+ * "No tool call found for custom tool call output with call_id ...". Suffix
+ * matching keeps the next family from reintroducing it silently.
+ */
 function definedCallIds(item) {
     if (!record(item)) {
         return [];
     }
     const ids = [];
-    if (item.type === "function_call" && typeof item.call_id === "string") {
+    if (typeof item.type === "string" &&
+        item.type.endsWith("_call") &&
+        typeof item.call_id === "string") {
         ids.push(item.call_id);
     }
     for (const block of blocksOf(item)) {
@@ -46,13 +59,20 @@ function definedCallIds(item) {
     }
     return ids;
 }
-/** Tool-call ids this item answers. */
+/**
+ * Tool-call ids this item answers.
+ *
+ * Suffix-matched for the same reason `definedCallIds` is. `_call_output` is
+ * checked rather than `_call` because no output type ends in `_call`, so the
+ * two predicates stay disjoint without ordering between them.
+ */
 function referencedCallIds(item) {
     if (!record(item)) {
         return [];
     }
     const ids = [];
-    if (item.type === "function_call_output" &&
+    if (typeof item.type === "string" &&
+        item.type.endsWith("_call_output") &&
         typeof item.call_id === "string") {
         ids.push(item.call_id);
     }
@@ -69,7 +89,8 @@ function referencedCallIds(item) {
  * Group items so a tool call and every answer to it stay in one unit.
  *
  * A unit stays open while any call it opened is still unanswered, so removing
- * whole units can never strand a `tool_result` or a `function_call_output`.
+ * whole units can never strand a tool answer — an Anthropic `tool_result` or
+ * any Responses API `*_call_output`.
  */
 function groupIntoUnits(items) {
     const units = [];

package/dist/types/file.d.ts

@@ -611,6 +611,21 @@ export type OfficeProcessorOptions = {
     processAllSheets?: boolean;
     /** For presentations (pptx only): whether to include slide notes */
     includeSlideNotes?: boolean;
+    /**
+     * For spreadsheets (xlsx only): restrict processing to the named sheet.
+     * When the workbook has no sheet by that name the result says so and lists
+     * the names it does have, rather than silently falling back to every sheet.
+     * Omit to process every sheet (the default).
+     */
+    sheetName?: string;
+    /**
+     * For spreadsheets (xlsx only): how sheet data is rendered into the prompt.
+     * - `raw` (default): tab-separated preview — the long-standing behaviour
+     * - `csv`: comma-separated values with RFC 4180 quoting
+     * - `markdown`: a markdown table per sheet
+     * - `json`: an array of row objects keyed by the header row
+     */
+    formatStyle?: "raw" | "markdown" | "json" | "csv";
 };
 /**
  * File detector options

package/dist/types/generate.d.ts

@@ -18,7 +18,7 @@ import type { AvatarOptions, AvatarResult } from "./avatar.js";
 import type { MusicOptions, MusicResult } from "./music.js";
 import type { StandardRecord, ValidationSchema, ZodUnknownSchema } from "./aliases.js";
 import type { NeurolinkCredentials } from "./providers.js";
-import type { CSVProcessorOptions, VideoProcessorOptions, FileWithMetadata, MultimodalAudioEntry, MultimodalVideoEntry, VisionImageOutputFormat } from "./file.js";
+import type { CSVProcessorOptions, VideoProcessorOptions, OfficeProcessorOptions, FileWithMetadata, MultimodalAudioEntry, MultimodalVideoEntry, VisionImageOutputFormat } from "./file.js";
 import type { WorkflowConfig } from "./workflow.js";
 import type { Schema, Tool, ToolChoice } from "./tools.js";
 import type { StepResult, LanguageModel } from "./providers.js";
@@ -150,6 +150,11 @@ export type GenerateOptions = {
         music?: MusicOptions;
     };
     csvOptions?: CSVProcessorOptions;
+    /**
+     * Office document processing options. Currently consumed by the XLSX path
+     * (`sheetName`, `formatStyle`); see OfficeProcessorOptions.
+     */
+    officeOptions?: OfficeProcessorOptions;
     /** PDF processing options (#258). */
     pdfOptions?: {
         /** Password for an encrypted PDF (image-conversion fallback path). */
@@ -1437,6 +1442,11 @@ export type TextGenerationOptions = {
      * saying so.
      */
     videoOptions?: VideoProcessorOptions;
+    /**
+     * Office document processing options. Currently consumed by the XLSX path
+     * (`sheetName`, `formatStyle`); see OfficeProcessorOptions.
+     */
+    officeOptions?: OfficeProcessorOptions;
     /** PDF processing options (#258). */
     pdfOptions?: {
         /** Password for an encrypted PDF (image-conversion fallback path). */

package/dist/types/processor.d.ts

@@ -639,8 +639,19 @@ export type ProcessedWord = ProcessedFileBase & {
     textContent: string;
     /** HTML representation of the Word document */
     htmlContent: string;
+    /**
+     * Markdown rendering of `htmlContent`, preserving the structure that plain
+     * text loses: headings, ordered/unordered lists and tables.
+     */
+    markdownContent: string;
     /** Warnings from mammoth extraction (e.g., unsupported elements) */
     warnings: string[];
+    /** Whitespace-delimited word count of `textContent`. */
+    wordCount: number;
+    /** Count of non-empty text blocks in `textContent`. */
+    paragraphCount: number;
+    /** Character count of `textContent`, including whitespace. */
+    characterCount: number;
 };
 /**
  * Processed RTF document result.

package/dist/types/stream.d.ts

@@ -16,7 +16,7 @@ import type { AIModelProviderConfig, NeurolinkCredentials } from "./providers.js
 import type { TTSChunk, TTSOptions, TTSResult } from "./tts.js";
 import type { STTOptions, STTResult } from "./stt.js";
 import type { StandardRecord, ValidationSchema } from "./aliases.js";
-import type { CSVProcessorOptions, FileWithMetadata, VideoProcessorOptions, VisionImageOutputFormat } from "./file.js";
+import type { CSVProcessorOptions, FileWithMetadata, VideoProcessorOptions, VisionImageOutputFormat, OfficeProcessorOptions } from "./file.js";
 import type { WorkflowConfig } from "./workflow.js";
 import type { LanguageModel, StepResult } from "./providers.js";
 import type { Tool, ToolChoice } from "./tools.js";
@@ -366,6 +366,11 @@ export type StreamOptions = {
      * saying so.
      */
     videoOptions?: VideoProcessorOptions;
+    /**
+     * Office document processing options. Currently consumed by the XLSX path
+     * (`sheetName`, `formatStyle`); see OfficeProcessorOptions.
+     */
+    officeOptions?: OfficeProcessorOptions;
     /** PDF processing options (#258). */
     pdfOptions?: {
         /** Password for an encrypted PDF (image-conversion fallback path). */

package/dist/types/utilities.d.ts

@@ -321,3 +321,22 @@ export type ScalarRecoveryDecision = {
 } | {
     kind: "not-json";
 };
+/**
+ * An element in the parsed HTML tree used for Markdown conversion.
+ */
+export type MarkdownHtmlElementNode = {
+    kind: "element";
+    /** Lower-cased tag name. */
+    tag: string;
+    /** Lower-cased attribute names mapped to their decoded values. */
+    attrs: Record<string, string>;
+    children: MarkdownHtmlNode[];
+};
+/**
+ * A node in the parsed HTML tree used for Markdown conversion: either a text
+ * run or an element.
+ */
+export type MarkdownHtmlNode = {
+    kind: "text";
+    value: string;
+} | MarkdownHtmlElementNode;