@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/adapters/markdown-tables.d.ts

@@ -0,0 +1,37 @@
+import type Token from "markdown-it/lib/token.mjs";
+export interface MarkdownTable {
+    headers: string[];
+    rows: string[][];
+    /** Source line span, so a caller can slice the prose around it. */
+    startLine: number;
+    endLine: number;
+}
+/**
+ * Models sometimes draw the separator row in ASCII-art style (`+---+---+`),
+ * which GFM does not recognise. Rewriting those pluses is enough to make the
+ * table parse; every other line is left exactly as written.
+ */
+export declare function normalizeMarkdownTables(source: string): string;
+export declare function inlinePlainText(tokens: Token[] | null | undefined): string;
+/** Every table in `source`, in document order, with its line span. */
+export declare function extractMarkdownTables(source: string): MarkdownTable[];
+/**
+ * Display width in monospace cells, by the East Asian Width convention.
+ *
+ * Padding by code-point count misaligns a Chinese table so badly that the
+ * result reads worse than the raw pipes it replaced, so this is a large
+ * improvement — but it is an approximation, not a guarantee. Verified against
+ * Discord's rendering: its code-block CJK fallback font is *not* exactly twice
+ * the Latin advance, so a column mixing `USB-C Hub` with `無線藍牙耳機` still
+ * ends up a little ragged. No amount of space padding fixes that, because the
+ * ratio is not an integer; the only exact answers are giving up columns for
+ * CJK tables entirely, and that trade was considered and declined — close
+ * alignment reads better than no table.
+ */
+export declare function displayWidth(text: string): number;
+/**
+ * Render a table as aligned monospace rows, for a platform with no table
+ * support of its own. The caller decides whether to fence it.
+ */
+export declare function renderMonospaceTable(table: MarkdownTable): string;
+//# sourceMappingURL=markdown-tables.d.ts.map

package/dist/adapters/markdown-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-tables.d.ts","sourceRoot":"","sources":["../../src/adapters/markdown-tables.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AAkBnD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAS1E;AAoCD,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAUrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6BjD;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAsBjE"}

package/dist/adapters/markdown-tables.js

@@ -0,0 +1,164 @@
+import MarkdownIt from "markdown-it";
+/**
+ * Locating GFM tables in a response, as plain data.
+ *
+ * Every platform needs the same thing from a markdown table and renders it
+ * differently: Slack has a native table block, Discord has no table support at
+ * all and needs monospace alignment. Only the *finding* is common, so that is
+ * what lives here — callers keep their own rendering, and neither has to carry
+ * a second markdown parser to get at the cells.
+ *
+ * Prose is deliberately not re-serialized from tokens anywhere: callers slice
+ * it verbatim from the source using the line span reported here, so the
+ * platform's own renderer stays responsible for everything that is not a table.
+ */
+const markdown = new MarkdownIt({ html: false });
+/**
+ * Models sometimes draw the separator row in ASCII-art style (`+---+---+`),
+ * which GFM does not recognise. Rewriting those pluses is enough to make the
+ * table parse; every other line is left exactly as written.
+ */
+export function normalizeMarkdownTables(source) {
+    return source
+        .split("\n")
+        .map((line) => {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("|") || !trimmed.endsWith("|"))
+            return line;
+        if (!/^[|+\-:\s]+$/.test(trimmed) || !trimmed.includes("+"))
+            return line;
+        return line.replaceAll("+", "|");
+    })
+        .join("\n");
+}
+export function inlinePlainText(tokens) {
+    if (!tokens)
+        return "";
+    let text = "";
+    for (const token of tokens) {
+        if (token.type === "text" || token.type === "code_inline")
+            text += token.content;
+        else if (token.type === "softbreak" || token.type === "hardbreak")
+            text += "\n";
+        else if (token.children)
+            text += inlinePlainText(token.children);
+    }
+    return text;
+}
+function parseOne(tokens, index) {
+    const open = tokens[index];
+    if (open?.type !== "table_open" || !open.map)
+        return null;
+    const headers = [];
+    const rows = [];
+    let currentRow = null;
+    let inHead = false;
+    let i = index + 1;
+    for (; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token === undefined || token.type === "table_close")
+            break;
+        if (token.type === "thead_open")
+            inHead = true;
+        else if (token.type === "thead_close")
+            inHead = false;
+        else if (token.type === "tr_open")
+            currentRow = [];
+        else if (token.type === "tr_close" && currentRow) {
+            if (inHead)
+                headers.push(...currentRow);
+            else
+                rows.push(currentRow);
+            currentRow = null;
+        }
+        else if (token.type === "inline" && currentRow) {
+            currentRow.push(inlinePlainText(token.children) || token.content);
+        }
+    }
+    // A header with no body is not a table anyone wants rendered as one.
+    if (!headers.length || !rows.length)
+        return null;
+    return {
+        table: { headers, rows, startLine: open.map[0], endLine: tokens[i]?.map?.[1] ?? open.map[1] },
+        next: i,
+    };
+}
+/** Every table in `source`, in document order, with its line span. */
+export function extractMarkdownTables(source) {
+    const tokens = markdown.parse(normalizeMarkdownTables(source), {});
+    const tables = [];
+    for (let index = 0; index < tokens.length; index++) {
+        const found = parseOne(tokens, index);
+        if (!found)
+            continue;
+        tables.push(found.table);
+        index = found.next;
+    }
+    return tables;
+}
+/**
+ * Display width in monospace cells, by the East Asian Width convention.
+ *
+ * Padding by code-point count misaligns a Chinese table so badly that the
+ * result reads worse than the raw pipes it replaced, so this is a large
+ * improvement — but it is an approximation, not a guarantee. Verified against
+ * Discord's rendering: its code-block CJK fallback font is *not* exactly twice
+ * the Latin advance, so a column mixing `USB-C Hub` with `無線藍牙耳機` still
+ * ends up a little ragged. No amount of space padding fixes that, because the
+ * ratio is not an integer; the only exact answers are giving up columns for
+ * CJK tables entirely, and that trade was considered and declined — close
+ * alignment reads better than no table.
+ */
+export function displayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        const wide = (code >= 0x1100 && code <= 0x115f) || // Hangul Jamo
+            (code >= 0x2e80 && code <= 0xa4cf) || // CJK radicals … Yi
+            (code >= 0xac00 && code <= 0xd7a3) || // Hangul syllables
+            (code >= 0xf900 && code <= 0xfaff) || // CJK compatibility ideographs
+            (code >= 0xfe30 && code <= 0xfe6f) || // CJK compatibility forms
+            (code >= 0xff00 && code <= 0xff60) || // full-width forms
+            (code >= 0xffe0 && code <= 0xffe6) ||
+            (code >= 0x1f300 && code <= 0x1faff) || // emoji
+            // Wide symbols scattered through Miscellaneous Symbols and Dingbats.
+            // ✅ and ❌ carry most verdict columns a model writes, so getting these
+            // wrong drifts the alignment of exactly the tables this exists for.
+            code === 0x2705 ||
+            (code >= 0x270a && code <= 0x270b) ||
+            code === 0x2728 ||
+            code === 0x274c ||
+            code === 0x274e ||
+            (code >= 0x2753 && code <= 0x2755) ||
+            code === 0x2757 ||
+            (code >= 0x2795 && code <= 0x2797) ||
+            code === 0x27b0 ||
+            code === 0x27bf;
+        width += wide ? 2 : 1;
+    }
+    return width;
+}
+function pad(text, width) {
+    return text + " ".repeat(Math.max(0, width - displayWidth(text)));
+}
+/**
+ * Render a table as aligned monospace rows, for a platform with no table
+ * support of its own. The caller decides whether to fence it.
+ */
+export function renderMonospaceTable(table) {
+    const columns = table.headers.length;
+    const rows = table.rows.map((row) => 
+    // Ragged rows are common in generated markdown; pad rather than drop them.
+    Array.from({ length: columns }, (_, index) => row[index] ?? ""));
+    const widths = Array.from({ length: columns }, (_, index) => Math.max(displayWidth(table.headers[index] ?? ""), ...rows.map((row) => displayWidth(row[index] ?? ""))));
+    const line = (cells) => cells
+        .map((cell, index) => pad(cell, widths[index] ?? 0))
+        .join("  ")
+        .trimEnd();
+    return [
+        line(table.headers),
+        widths.map((width) => "─".repeat(width)).join("  "),
+        ...rows.map(line),
+    ].join("\n");
+}
+//# sourceMappingURL=markdown-tables.js.map

package/dist/adapters/markdown-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-tables.js","sourceRoot":"","sources":["../../src/adapters/markdown-tables.ts"],"names":[],"mappings":"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","sourcesContent":["import MarkdownIt from \"markdown-it\";\nimport type Token from \"markdown-it/lib/token.mjs\";\n\n/**\n * Locating GFM tables in a response, as plain data.\n *\n * Every platform needs the same thing from a markdown table and renders it\n * differently: Slack has a native table block, Discord has no table support at\n * all and needs monospace alignment. Only the *finding* is common, so that is\n * what lives here — callers keep their own rendering, and neither has to carry\n * a second markdown parser to get at the cells.\n *\n * Prose is deliberately not re-serialized from tokens anywhere: callers slice\n * it verbatim from the source using the line span reported here, so the\n * platform's own renderer stays responsible for everything that is not a table.\n */\n\nconst markdown = new MarkdownIt({ html: false });\n\nexport interface MarkdownTable {\n  headers: string[];\n  rows: string[][];\n  /** Source line span, so a caller can slice the prose around it. */\n  startLine: number;\n  endLine: number;\n}\n\n/**\n * Models sometimes draw the separator row in ASCII-art style (`+---+---+`),\n * which GFM does not recognise. Rewriting those pluses is enough to make the\n * table parse; every other line is left exactly as written.\n */\nexport function normalizeMarkdownTables(source: string): string {\n  return source\n    .split(\"\\n\")\n    .map((line) => {\n      const trimmed = line.trim();\n      if (!trimmed.startsWith(\"|\") || !trimmed.endsWith(\"|\")) return line;\n      if (!/^[|+\\-:\\s]+$/.test(trimmed) || !trimmed.includes(\"+\")) return line;\n      return line.replaceAll(\"+\", \"|\");\n    })\n    .join(\"\\n\");\n}\n\nexport function inlinePlainText(tokens: Token[] | null | undefined): string {\n  if (!tokens) return \"\";\n  let text = \"\";\n  for (const token of tokens) {\n    if (token.type === \"text\" || token.type === \"code_inline\") text += token.content;\n    else if (token.type === \"softbreak\" || token.type === \"hardbreak\") text += \"\\n\";\n    else if (token.children) text += inlinePlainText(token.children);\n  }\n  return text;\n}\n\nfunction parseOne(tokens: Token[], index: number): { table: MarkdownTable; next: number } | null {\n  const open = tokens[index];\n  if (open?.type !== \"table_open\" || !open.map) return null;\n\n  const headers: string[] = [];\n  const rows: string[][] = [];\n  let currentRow: string[] | null = null;\n  let inHead = false;\n  let i = index + 1;\n\n  for (; i < tokens.length; i++) {\n    const token = tokens[i];\n    if (token === undefined || token.type === \"table_close\") break;\n    if (token.type === \"thead_open\") inHead = true;\n    else if (token.type === \"thead_close\") inHead = false;\n    else if (token.type === \"tr_open\") currentRow = [];\n    else if (token.type === \"tr_close\" && currentRow) {\n      if (inHead) headers.push(...currentRow);\n      else rows.push(currentRow);\n      currentRow = null;\n    } else if (token.type === \"inline\" && currentRow) {\n      currentRow.push(inlinePlainText(token.children) || token.content);\n    }\n  }\n\n  // A header with no body is not a table anyone wants rendered as one.\n  if (!headers.length || !rows.length) return null;\n\n  return {\n    table: { headers, rows, startLine: open.map[0], endLine: tokens[i]?.map?.[1] ?? open.map[1] },\n    next: i,\n  };\n}\n\n/** Every table in `source`, in document order, with its line span. */\nexport function extractMarkdownTables(source: string): MarkdownTable[] {\n  const tokens = markdown.parse(normalizeMarkdownTables(source), {});\n  const tables: MarkdownTable[] = [];\n  for (let index = 0; index < tokens.length; index++) {\n    const found = parseOne(tokens, index);\n    if (!found) continue;\n    tables.push(found.table);\n    index = found.next;\n  }\n  return tables;\n}\n\n/**\n * Display width in monospace cells, by the East Asian Width convention.\n *\n * Padding by code-point count misaligns a Chinese table so badly that the\n * result reads worse than the raw pipes it replaced, so this is a large\n * improvement — but it is an approximation, not a guarantee. Verified against\n * Discord's rendering: its code-block CJK fallback font is *not* exactly twice\n * the Latin advance, so a column mixing `USB-C Hub` with `無線藍牙耳機` still\n * ends up a little ragged. No amount of space padding fixes that, because the\n * ratio is not an integer; the only exact answers are giving up columns for\n * CJK tables entirely, and that trade was considered and declined — close\n * alignment reads better than no table.\n */\nexport function displayWidth(text: string): number {\n  let width = 0;\n  for (const char of text) {\n    const code = char.codePointAt(0) ?? 0;\n    const wide =\n      (code >= 0x1100 && code <= 0x115f) || // Hangul Jamo\n      (code >= 0x2e80 && code <= 0xa4cf) || // CJK radicals … Yi\n      (code >= 0xac00 && code <= 0xd7a3) || // Hangul syllables\n      (code >= 0xf900 && code <= 0xfaff) || // CJK compatibility ideographs\n      (code >= 0xfe30 && code <= 0xfe6f) || // CJK compatibility forms\n      (code >= 0xff00 && code <= 0xff60) || // full-width forms\n      (code >= 0xffe0 && code <= 0xffe6) ||\n      (code >= 0x1f300 && code <= 0x1faff) || // emoji\n      // Wide symbols scattered through Miscellaneous Symbols and Dingbats.\n      // ✅ and ❌ carry most verdict columns a model writes, so getting these\n      // wrong drifts the alignment of exactly the tables this exists for.\n      code === 0x2705 ||\n      (code >= 0x270a && code <= 0x270b) ||\n      code === 0x2728 ||\n      code === 0x274c ||\n      code === 0x274e ||\n      (code >= 0x2753 && code <= 0x2755) ||\n      code === 0x2757 ||\n      (code >= 0x2795 && code <= 0x2797) ||\n      code === 0x27b0 ||\n      code === 0x27bf;\n    width += wide ? 2 : 1;\n  }\n  return width;\n}\n\nfunction pad(text: string, width: number): string {\n  return text + \" \".repeat(Math.max(0, width - displayWidth(text)));\n}\n\n/**\n * Render a table as aligned monospace rows, for a platform with no table\n * support of its own. The caller decides whether to fence it.\n */\nexport function renderMonospaceTable(table: MarkdownTable): string {\n  const columns = table.headers.length;\n  const rows = table.rows.map((row) =>\n    // Ragged rows are common in generated markdown; pad rather than drop them.\n    Array.from({ length: columns }, (_, index) => row[index] ?? \"\"),\n  );\n  const widths = Array.from({ length: columns }, (_, index) =>\n    Math.max(\n      displayWidth(table.headers[index] ?? \"\"),\n      ...rows.map((row) => displayWidth(row[index] ?? \"\")),\n    ),\n  );\n  const line = (cells: string[]): string =>\n    cells\n      .map((cell, index) => pad(cell, widths[index] ?? 0))\n      .join(\"  \")\n      .trimEnd();\n  return [\n    line(table.headers),\n    widths.map((width) => \"─\".repeat(width)).join(\"  \"),\n    ...rows.map(line),\n  ].join(\"\\n\");\n}\n"]}

package/dist/adapters/progressive-renderer.d.ts

@@ -0,0 +1,7 @@
+import type { ChatToolResult, ConversationResponder } from "../adapter.js";
+import type { ProgressiveRendererPlatform } from "./types.js";
+export declare function formatMarkdownToolResult(result: ChatToolResult): string;
+export declare function createProgressiveRenderer(platform: ProgressiveRendererPlatform): {
+    responder: ConversationResponder;
+};
+//# sourceMappingURL=progressive-renderer.d.ts.map

package/dist/adapters/progressive-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-renderer.d.ts","sourceRoot":"","sources":["../../src/adapters/progressive-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAQvB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CASvE;AAoCD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,2BAA2B,GAAG;IAChF,SAAS,EAAE,qBAAqB,CAAC;CAClC,CA+eA"}