zcw-shared 2.23.3 → 2.24.0

package/dist/functions/llm/createLlmReasoningStore.js

@@ -0,0 +1,167 @@
+export function createLlmReasoningStore(deps) {
+    function sha256Json(payload) {
+        return deps.sha256Hex(JSON.stringify(payload));
+    }
+    function normalizeToolCall(toolCall) {
+        const fnRaw = toolCall.function;
+        const fn = fnRaw && typeof fnRaw === 'object' && !Array.isArray(fnRaw)
+            ? fnRaw
+            : {};
+        let args = fn.arguments;
+        if (typeof args !== 'string') {
+            args = JSON.stringify(args ?? {}, Object.keys(args ?? {}).sort());
+        }
+        return {
+            id: toolCall.id,
+            type: toolCall.type ?? 'function',
+            function: {
+                name: String(fn.name ?? ''),
+                arguments: args,
+            },
+        };
+    }
+    function toolCallSignature(toolCall) {
+        const normalized = normalizeToolCall(toolCall);
+        delete normalized.id;
+        return sha256Json(normalized);
+    }
+    function toolCallIds(message) {
+        const ids = [];
+        const parts = message.tool_calls;
+        if (!Array.isArray(parts))
+            return ids;
+        for (const tc of parts) {
+            if (tc && typeof tc === 'object' && !Array.isArray(tc) && tc.id) {
+                ids.push(String(tc.id));
+            }
+        }
+        return ids;
+    }
+    function toolCallNames(message) {
+        const names = [];
+        const parts = message.tool_calls;
+        if (!Array.isArray(parts))
+            return names;
+        for (const tc of parts) {
+            if (!tc || typeof tc !== 'object' || Array.isArray(tc))
+                continue;
+            const fn = tc.function;
+            if (fn && typeof fn === 'object' && !Array.isArray(fn) && fn.name) {
+                names.push(String(fn.name));
+            }
+        }
+        return names;
+    }
+    function messageSignature(message) {
+        const toolCalls = Array.isArray(message.tool_calls)
+            ? message.tool_calls
+                .filter((tc) => tc && typeof tc === 'object' && !Array.isArray(tc))
+                .map((tc) => normalizeToolCall(tc))
+            : [];
+        return sha256Json({
+            content: message.content ?? '',
+            tool_calls: toolCalls,
+        });
+    }
+    function canonicalScopeMessage(message) {
+        const canonical = { role: message.role };
+        for (const key of ['content', 'name', 'tool_call_id', 'prefix']) {
+            if (key in message)
+                canonical[key] = message[key];
+        }
+        if (Array.isArray(message.tool_calls)) {
+            canonical.tool_calls = message.tool_calls
+                .filter((tc) => tc && typeof tc === 'object' && !Array.isArray(tc))
+                .map((tc) => normalizeToolCall(tc));
+        }
+        return canonical;
+    }
+    function conversationScope(messages, namespace = '') {
+        const scopeMessages = messages.map(canonicalScopeMessage);
+        const payload = namespace
+            ? { namespace, messages: scopeMessages }
+            : scopeMessages;
+        return sha256Json(payload);
+    }
+    function turnContextSignature(priorMessages) {
+        let lastUserIndex = -1;
+        for (let i = priorMessages.length - 1; i >= 0; i -= 1) {
+            if (priorMessages[i]?.role === 'user') {
+                lastUserIndex = i;
+                break;
+            }
+        }
+        let startIndex = 0;
+        if (lastUserIndex !== -1) {
+            startIndex = lastUserIndex;
+            while (startIndex > 0 &&
+                priorMessages[startIndex - 1]?.role === 'user') {
+                startIndex -= 1;
+            }
+        }
+        const contextMessages = priorMessages
+            .slice(startIndex)
+            .filter((m) => m.role !== 'system')
+            .map(canonicalScopeMessage);
+        return sha256Json(contextMessages);
+    }
+    function scopedReasoningKeys(message, scope) {
+        const keys = [`scope:${scope}:signature:${messageSignature(message)}`];
+        for (const id of toolCallIds(message)) {
+            keys.push(`scope:${scope}:tool_call:${id}`);
+        }
+        if (Array.isArray(message.tool_calls)) {
+            for (const tc of message.tool_calls) {
+                if (tc && typeof tc === 'object' && !Array.isArray(tc)) {
+                    keys.push(`scope:${scope}:tool_call_signature:${toolCallSignature(tc)}`);
+                }
+            }
+        }
+        for (const name of toolCallNames(message)) {
+            keys.push(`scope:${scope}:tool_name:${name}`);
+        }
+        return keys;
+    }
+    function portableReasoningKeys(message, cacheNamespace, priorMessages) {
+        if (!cacheNamespace)
+            return [];
+        const turnSignature = turnContextSignature(priorMessages);
+        const keys = [
+            `namespace:${cacheNamespace}:turn:${turnSignature}:signature:${messageSignature(message)}`,
+        ];
+        for (const id of toolCallIds(message)) {
+            keys.push(`namespace:${cacheNamespace}:turn:${turnSignature}:tool_call:${id}`);
+        }
+        if (Array.isArray(message.tool_calls)) {
+            for (const tc of message.tool_calls) {
+                if (tc && typeof tc === 'object' && !Array.isArray(tc)) {
+                    keys.push(`namespace:${cacheNamespace}:turn:${turnSignature}:tool_call_signature:${toolCallSignature(tc)}`);
+                }
+            }
+        }
+        for (const name of toolCallNames(message)) {
+            keys.push(`namespace:${cacheNamespace}:turn:${turnSignature}:tool_name:${name}`);
+        }
+        return keys;
+    }
+    function lookupReasoningKeys(message, scope, cacheNamespace, priorMessages) {
+        const keys = scopedReasoningKeys(message, scope);
+        keys.push(...portableReasoningKeys(message, cacheNamespace, priorMessages));
+        return [...new Set(keys)];
+    }
+    function storeReasoningKeys(message, scope, cacheNamespace, priorMessages) {
+        return lookupReasoningKeys(message, scope, cacheNamespace, priorMessages);
+    }
+    return {
+        toolCallSignature,
+        messageSignature,
+        canonicalScopeMessage,
+        conversationScope,
+        turnContextSignature,
+        scopedReasoningKeys,
+        portableReasoningKeys,
+        lookupReasoningKeys,
+        storeReasoningKeys,
+    };
+}
+//# sourceMappingURL=createLlmReasoningStore.js.map

package/dist/functions/llm/createLlmReasoningStore.js.map

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

package/dist/functions/markdown/cwMarkdownAst.d.ts

@@ -0,0 +1,68 @@
+export interface InlineTextNode {
+    type: 'text';
+    value: string;
+}
+export interface InlineBoldNode {
+    type: 'bold';
+    children: CwMarkdownInlineNode[];
+}
+export interface InlineItalicNode {
+    type: 'italic';
+    children: CwMarkdownInlineNode[];
+}
+export interface InlineCodeNode {
+    type: 'code';
+    value: string;
+}
+export interface InlineLinkNode {
+    type: 'link';
+    href: string;
+    title?: string;
+    children: CwMarkdownInlineNode[];
+}
+export interface InlineImageNode {
+    type: 'image';
+    src: string;
+    alt?: string;
+    title?: string;
+}
+export interface InlineImMentionNode {
+    type: 'imMention';
+    userId: string;
+    label?: string;
+}
+export type CwMarkdownInlineNode = InlineTextNode | InlineBoldNode | InlineItalicNode | InlineCodeNode | InlineLinkNode | InlineImageNode | InlineImMentionNode;
+export interface CwMarkdownHeadingBlock {
+    type: 'heading';
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    content: CwMarkdownInlineNode[];
+}
+export interface CwMarkdownParagraphBlock {
+    type: 'paragraph';
+    content: CwMarkdownInlineNode[];
+}
+export interface CwMarkdownCodeBlock {
+    type: 'codeBlock';
+    language?: string;
+    code: string;
+}
+export interface CwMarkdownBlockquoteBlock {
+    type: 'blockquote';
+    children: CwMarkdownBlock[];
+}
+export interface CwMarkdownListBlock {
+    type: 'list';
+    ordered: boolean;
+    start?: number;
+    items: CwMarkdownInlineNode[][];
+}
+export interface CwMarkdownHrBlock {
+    type: 'hr';
+}
+export interface CwMarkdownTableBlock {
+    type: 'table';
+    columnAlign: ('left' | 'center' | 'right')[];
+    header: CwMarkdownInlineNode[][];
+    body: CwMarkdownInlineNode[][][];
+}
+export type CwMarkdownBlock = CwMarkdownHeadingBlock | CwMarkdownParagraphBlock | CwMarkdownCodeBlock | CwMarkdownBlockquoteBlock | CwMarkdownListBlock | CwMarkdownHrBlock | CwMarkdownTableBlock;

package/dist/functions/markdown/cwMarkdownAst.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cwMarkdownAst.js.map

package/dist/functions/markdown/cwMarkdownAst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwMarkdownAst.js","sourceRoot":"","sources":["../../../src/functions/markdown/cwMarkdownAst.ts"],"names":[],"mappings":""}

package/dist/functions/markdown/markdownToSpeechPlainText.d.ts

@@ -0,0 +1,5 @@
+export type MarkdownToSpeechPlainTextOptions = {
+    mentionLabelResolver?: (userId: string) => string;
+    preprocessors?: Array<(content: string) => string>;
+};
+export declare function markdownToSpeechPlainText(content: string, options?: MarkdownToSpeechPlainTextOptions): string;

package/dist/functions/markdown/markdownToSpeechPlainText.js

@@ -0,0 +1,123 @@
+import { parseMarkdownBlocks } from './parseMarkdownBlocks.js';
+const SKIP_CODE_BLOCK_LANGS = new Set([
+    'mermaid',
+    'flow',
+    'flowchart',
+    'graph',
+    'chart',
+    'diagram',
+    'plantuml',
+    'vega',
+    'vega-lite',
+    'mindmap',
+    'sequence',
+    'gantt',
+    'pie',
+    'er',
+    'classdiagram',
+    'statediagram',
+]);
+function normalizeSpeechWhitespace(text) {
+    return text
+        .replace(/\u00a0/g, ' ')
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+function inlineNodesToSpeech(nodes, mentionLabelResolver) {
+    return nodes.map((node) => inlineNodeToSpeech(node, mentionLabelResolver)).join('');
+}
+function inlineNodeToSpeech(node, mentionLabelResolver) {
+    switch (node.type) {
+        case 'text':
+            return node.value;
+        case 'bold':
+        case 'italic':
+            return inlineNodesToSpeech(node.children, mentionLabelResolver);
+        case 'code':
+            return node.value;
+        case 'link': {
+            const label = inlineNodesToSpeech(node.children, mentionLabelResolver).trim();
+            return label || node.href.trim();
+        }
+        case 'image': {
+            const alt = node.alt?.trim();
+            if (alt)
+                return alt;
+            const title = node.title?.trim();
+            return title ?? '';
+        }
+        case 'imMention': {
+            const label = node.label?.trim();
+            if (label)
+                return label;
+            const resolved = mentionLabelResolver?.(node.userId)?.trim();
+            return resolved || `@${node.userId}`;
+        }
+        default:
+            return '';
+    }
+}
+function tableRowToSpeech(row, mentionLabelResolver) {
+    return row
+        .map((cells) => inlineNodesToSpeech(cells, mentionLabelResolver).trim())
+        .filter(Boolean)
+        .join('，');
+}
+function blockToSpeech(block, mentionLabelResolver) {
+    switch (block.type) {
+        case 'heading':
+        case 'paragraph':
+            return inlineNodesToSpeech(block.content, mentionLabelResolver).trim();
+        case 'codeBlock': {
+            const lang = block.language?.trim().toLowerCase() ?? '';
+            if (lang && SKIP_CODE_BLOCK_LANGS.has(lang))
+                return '';
+            const code = block.code.trim();
+            return code;
+        }
+        case 'blockquote':
+            return block.children
+                .map((child) => blockToSpeech(child, mentionLabelResolver))
+                .filter(Boolean)
+                .join('\n');
+        case 'list':
+            return block.items
+                .map((item) => inlineNodesToSpeech(item, mentionLabelResolver).trim())
+                .filter(Boolean)
+                .join('，');
+        case 'hr':
+            return '';
+        case 'table': {
+            const rows = [];
+            const header = tableRowToSpeech(block.header, mentionLabelResolver);
+            if (header)
+                rows.push(header);
+            for (const row of block.body) {
+                const line = tableRowToSpeech(row, mentionLabelResolver);
+                if (line)
+                    rows.push(line);
+            }
+            return rows.join('。');
+        }
+        default:
+            return '';
+    }
+}
+export function markdownToSpeechPlainText(content, options = {}) {
+    let raw = content ?? '';
+    if (!raw.trim())
+        return '';
+    for (const fn of options.preprocessors ?? []) {
+        raw = fn(raw);
+    }
+    const parts = parseMarkdownBlocks(raw)
+        .map((block) => blockToSpeech(block, options.mentionLabelResolver))
+        .map((part) => part.trim())
+        .filter(Boolean);
+    if (parts.length === 0) {
+        return normalizeSpeechWhitespace(raw);
+    }
+    return normalizeSpeechWhitespace(parts.join('\n'));
+}
+//# sourceMappingURL=markdownToSpeechPlainText.js.map

package/dist/functions/markdown/markdownToSpeechPlainText.js.map

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

package/dist/functions/markdown/parseGfmTable.d.ts

@@ -0,0 +1,6 @@
+import type { CwMarkdownTableBlock, CwMarkdownInlineNode } from './cwMarkdownAst.js';
+export declare function splitTableRow(line: string): string[];
+export declare function tryMatchGfmTable(lines: string[], start: number, parse?: (s: string) => CwMarkdownInlineNode[]): {
+    end: number;
+    block: CwMarkdownTableBlock;
+} | null;

package/dist/functions/markdown/parseGfmTable.js

@@ -0,0 +1,87 @@
+import { parseInline } from './parseInline.js';
+function isBlankLine(line) {
+    return /^\s*$/.test(line);
+}
+export function splitTableRow(line) {
+    const t = line.trim();
+    if (!t.includes('|'))
+        return [];
+    const parts = t.split('|').map((c) => c.trim());
+    if (parts[0] === '')
+        parts.shift();
+    if (parts.length > 0 && parts[parts.length - 1] === '')
+        parts.pop();
+    return parts;
+}
+function cellTextAlign(cell) {
+    const t = cell.trim();
+    const l = t.startsWith(':');
+    const r = t.length > 0 && t.endsWith(':') && t !== ':';
+    if (l && r)
+        return 'center';
+    if (r)
+        return 'right';
+    return 'left';
+}
+function isTableSeparatorLine(line) {
+    if (!line.trim().includes('|') || !/[-]/.test(line))
+        return false;
+    const cells = splitTableRow(line);
+    if (cells.length < 1)
+        return false;
+    return cells.every((cell) => {
+        const t = cell.trim();
+        if (!/[-]/.test(t))
+            return false;
+        if (!/^[:\s-]+$/.test(t))
+            return false;
+        return /-/.test(t.replace(/\s/g, ''));
+    });
+}
+function padRow(cells, n) {
+    const out = cells.slice(0, n);
+    while (out.length < n)
+        out.push('');
+    return out;
+}
+export function tryMatchGfmTable(lines, start, parse = parseInline) {
+    if (start + 1 >= lines.length)
+        return null;
+    const hLine = lines[start];
+    const sLine = lines[start + 1];
+    if (isBlankLine(hLine) || isBlankLine(sLine))
+        return null;
+    if (!hLine.trim().includes('|') || !isTableSeparatorLine(sLine))
+        return null;
+    const headerCells = splitTableRow(hLine);
+    const sepCells = splitTableRow(sLine);
+    if (headerCells.length < 1 || headerCells.length !== sepCells.length)
+        return null;
+    const n = headerCells.length;
+    const columnAlign = sepCells.map((c) => cellTextAlign(c));
+    const header = headerCells.map((c) => parse(c));
+    const body = [];
+    let j = start + 2;
+    while (j < lines.length) {
+        const line = lines[j];
+        if (isBlankLine(line))
+            break;
+        if (!line.trim().includes('|'))
+            break;
+        const rowCells = splitTableRow(line);
+        if (rowCells.length < 1)
+            break;
+        body.push(padRow(rowCells, n).map((c) => parse(c)));
+        j++;
+    }
+    return {
+        end: j,
+        block: {
+            type: 'table',
+            columnAlign,
+            header,
+            body,
+        },
+    };
+}
+//# sourceMappingURL=parseGfmTable.js.map

package/dist/functions/markdown/parseGfmTable.js.map

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

package/dist/functions/markdown/parseInline.d.ts

@@ -0,0 +1,2 @@
+import type { CwMarkdownInlineNode } from './cwMarkdownAst.js';
+export declare function parseInline(text: string): CwMarkdownInlineNode[];