dsh-kenari-plugin 0.1.1

package/lib/tools/docs.js

@@ -0,0 +1,209 @@
+/**
+ * 文档与模型目录工具：kenari_search_docs（本地检索 /llms-full.txt，无需 key）
+ * 与 kenari_list_models（目录走 catalog.ts 的 TTL 缓存，公开端点）。
+ * @module dsh-kenari-plugin/tools/docs
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { formatPricingLines, formatTokenPrice } from '../catalog.js';
+/** /llms-full.txt 的内存缓存：文档量大（约 130KB），进程内只抓一次。 */
+let llmsFullCache;
+/** 文档全文抓取（公开端点，无需 key）；失败上抛由 execute 层转错误文本。 */
+async function fetchLlmsFull(ttlMs) {
+    if (ttlMs > 0 && llmsFullCache !== undefined && Date.now() - llmsFullCache.fetchedAt < ttlMs) {
+        return llmsFullCache.text;
+    }
+    const response = await fetch('https://kenari.id/llms-full.txt', {
+        headers: { Accept: 'text/plain' },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!response.ok)
+        throw new Error(`llms-full.txt HTTP ${response.status}`);
+    const text = await response.text();
+    llmsFullCache = { text, fetchedAt: Date.now() };
+    return text;
+}
+/** 文档分节：按一级/二级标题切，保留标题行以便模型引用章节名。 */
+function splitSections(text) {
+    const sections = [];
+    const lines = text.split('\n');
+    let title = '(前言)';
+    let body = [];
+    for (const line of lines) {
+        if (/^#{1,2} /.test(line)) {
+            if (body.length > 0)
+                sections.push({ title, body: body.join('\n') });
+            title = line.replace(/^#+ /, '');
+            body = [];
+        }
+        else {
+            body.push(line);
+        }
+    }
+    if (body.length > 0)
+        sections.push({ title, body: body.join('\n') });
+    return sections;
+}
+/** 命中打分：查询词按出现次数累加，标题命中权重 ×4。 */
+function scoreSection(section, terms) {
+    let score = 0;
+    const titleLower = section.title.toLowerCase();
+    const bodyLower = section.body.toLowerCase();
+    for (const term of terms) {
+        const t = term.toLowerCase();
+        if (t.length === 0)
+            continue;
+        let inTitle = 0;
+        let idx = titleLower.indexOf(t);
+        while (idx !== -1) {
+            inTitle++;
+            idx = titleLower.indexOf(t, idx + t.length);
+        }
+        score += inTitle * 4;
+        let inBody = 0;
+        idx = bodyLower.indexOf(t);
+        while (idx !== -1) {
+            inBody++;
+            idx = bodyLower.indexOf(t, idx + t.length);
+        }
+        score += inBody;
+    }
+    return score;
+}
+/** 单节正文截断：够 context 而不淹没模型。 */
+const SECTION_BODY_CHARS = 2500;
+/** 模型条目 → 人读多行块（能力、上下文、价格、非 token 单价、告警）。 */
+export function formatModelEntry(resolved) {
+    const model = resolved.model;
+    const bits = [];
+    bits.push(`ctx ${model.context_length ?? '未知'}`);
+    if (model.tool_call === true)
+        bits.push('工具调用');
+    if (model.reasoning === true) {
+        const options = model.reasoning_options ?? [];
+        bits.push(options.length > 0 ? `推理（${options.join('/')}）` : '推理');
+    }
+    if (model.owned_by !== undefined)
+        bits.push(`by ${model.owned_by}`);
+    const inputModalities = model.modalities?.input ?? [];
+    if (inputModalities.length > 0)
+        bits.push(`输入 ${inputModalities.join('+')}`);
+    const lines = [`- ${model.id}${resolved.free ? '（免费）' : ''} — ${bits.join('，')}`, `  ${formatTokenPrice(model)}`];
+    const pricingLines = formatPricingLines(model);
+    if (pricingLines.length > 0)
+        lines.push(`  ${pricingLines.join('；')}`);
+    const aliases = resolved.aliases.filter((alias) => alias !== model.id);
+    if (aliases.length > 0)
+        lines.push(`  别名：${aliases.join('、')}`);
+    for (const warning of resolved.warnings)
+        lines.push(`  ⚠️ ${warning}`);
+    return lines.join('\n');
+}
+/** 免费模型首选（新账户 Rp 0 也能跑通全流程）。 */
+const RECOMMENDED_FREE_MODEL = 'step-3-7-flash:free';
+/** 注册文档检索与模型目录两个公开工具（不消耗余额）。 */
+export function registerDocsTools(deps, register) {
+    register(defineTool({
+        name: 'kenari_search_docs',
+        description: 'Search the Kenari (kenari.id) documentation — quickstart, API reference, billing, routing, BYOK, error codes. Free, no API key needed.',
+        parameters: {
+            query: { type: 'string', required: true, description: 'What to look up, e.g. "streaming", "error codes", "shared keys".' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    text: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        timeoutMs: 45_000,
+        isConcurrencySafe: () => true,
+        async execute(args) {
+            try {
+                const full = await fetchLlmsFull(deps.config.docsCacheTtlMs ?? 3_600_000);
+                const terms = args.query.split(/[\s,，、]+/).filter((term) => term.length > 0);
+                if (terms.length === 0) {
+                    return { text: '查询为空：请给出检索词。' };
+                }
+                const scored = splitSections(full)
+                    .map((section) => ({ section, score: scoreSection(section, terms) }))
+                    .filter((entry) => entry.score > 0)
+                    .sort((a, b) => b.score - a.score)
+                    .slice(0, 4);
+                if (scored.length === 0) {
+                    return { text: `文档中没有匹配 "${args.query}" 的章节。可尝试的检索词：streaming、error codes、billing、BYOK、routing、tools。` };
+                }
+                const parts = scored.map(({ section, score }) => {
+                    const body = section.body.length > SECTION_BODY_CHARS ? `${section.body.slice(0, SECTION_BODY_CHARS)}\n…（已截断）` : section.body;
+                    return `## ${section.title}\n${body}\n（相关度 ${score}）`;
+                });
+                return { text: `Kenari 文档检索结果（${scored.length} 节，来源 https://kenari.id/llms-full.txt）：\n\n${parts.join('\n\n')}` };
+            }
+            catch (err) {
+                return { text: `kenari 文档检索失败：${String(err)}` };
+            }
+        },
+    }));
+    register(defineTool({
+        name: 'kenari_list_models',
+        description: 'List Kenari models with live per-token IDR prices, context window, capabilities, and non-token unit prices. Public catalog, free. Filter by id/provider substring, by specialized modality, or to free models only.',
+        parameters: {
+            search: { type: 'string', description: 'Optional substring to filter by model id or provider.' },
+            modality: {
+                type: 'string',
+                description: 'Omit this for chat/session models (the common case). Set it only to list a specialized capability catalog instead of chat models.',
+                enum: ['embedding', 'rerank', 'moderation'],
+            },
+            free_only: { type: 'boolean', description: 'Return only free models (id ends with :free or pricing.free).' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    text: { type: 'string', required: true },
+                    free_ids: { type: 'array', items: { type: 'string' } },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        timeoutMs: 30_000,
+        isConcurrencySafe: () => true,
+        async execute(args) {
+            const all = await deps.catalog.list(args.modality);
+            const described = all.map((model) => deps.catalog.describe(model));
+            const search = args.search?.toLowerCase();
+            const filtered = described.filter((entry) => {
+                if (args.free_only === true && !entry.free)
+                    return false;
+                if (search === undefined || search.length === 0)
+                    return true;
+                return entry.id.toLowerCase().includes(search) || (entry.model.owned_by ?? '').toLowerCase().includes(search);
+            });
+            const freeIds = described.filter((entry) => entry.free).map((entry) => entry.id);
+            if (filtered.length === 0) {
+                return {
+                    text: `目录中没有匹配的模型（search=${args.search ?? '（无）'}, modality=${args.modality ?? 'chat'}, free_only=${args.free_only === true ? '是' : '否'}）。`,
+                    free_ids: freeIds,
+                };
+            }
+            const free = filtered.filter((entry) => entry.free);
+            const paid = filtered.filter((entry) => !entry.free);
+            const sections = [];
+            if (free.length > 0)
+                sections.push(`【免费模型 ${free.length} 个】\n${free.map(formatModelEntry).join('\n')}`);
+            if (paid.length > 0)
+                sections.push(`【付费模型 ${paid.length} 个】\n${paid.map(formatModelEntry).join('\n')}`);
+            const hint = freeIds.includes(RECOMMENDED_FREE_MODEL)
+                ? `\n\n新账户（Rp 0）建议先用 ${RECOMMENDED_FREE_MODEL}：免费且在三条协议线上都可用。`
+                : '';
+            return {
+                text: `Kenari 模型目录（${filtered.length}/${all.length} 个，token 价格单位 IDR / 1M tokens）：\n\n${sections.join('\n\n')}${hint}`,
+                free_ids: freeIds,
+            };
+        },
+    }));
+}
+//# sourceMappingURL=docs.js.map

package/lib/tools/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGnD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEpE,kDAAkD;AAClD,IAAI,aAA8D,CAAA;AAElE,gDAAgD;AAChD,KAAK,UAAU,aAAa,CAAC,KAAa;IACxC,IAAI,KAAK,GAAG,CAAC,IAAI,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;QAC7F,OAAO,aAAa,CAAC,IAAI,CAAA;IAC3B,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,iCAAiC,EAAE;QAC9D,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;QACjC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAA;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,aAAa,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;IAC/C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,qCAAqC;AACrC,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,QAAQ,GAAsC,EAAE,CAAA;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,KAAK,GAAG,MAAM,CAAA;IAClB,IAAI,IAAI,GAAa,EAAE,CAAA;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACpE,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;YAChC,IAAI,GAAG,EAAE,CAAA;QACX,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACpE,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,iCAAiC;AACjC,SAAS,YAAY,CAAC,OAAwC,EAAE,KAAe;IAC7E,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QAC5B,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC/B,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,EAAE,CAAA;YACT,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;QAC7C,CAAC;QACD,KAAK,IAAI,OAAO,GAAG,CAAC,CAAA;QACpB,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC1B,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,EAAE,CAAA;YACR,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;QAC5C,CAAC;QACD,KAAK,IAAI,MAAM,CAAA;IACjB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,+BAA+B;AAC/B,MAAM,kBAAkB,GAAG,IAAI,CAAA;AAE/B,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,CAAA;IAChD,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC/C,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAA;QAC7C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACnE,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;IACnE,MAAM,eAAe,GAAG,KAAK,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAA;IACrD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC5E,MAAM,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACjH,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC9C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC,CAAA;IACtE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC/D,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAA;IACtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,gCAAgC;AAChC,MAAM,sBAAsB,GAAG,qBAAqB,CAAA;AAEpD,gCAAgC;AAChC,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,QAAuD;IACxG,QAAQ,CAAC,UAAU,CAAC;QAClB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,wIAAwI;QACrJ,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kEAAkE,EAAE;SAC3H;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACzC;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC/D;QACD,SAAS,EAAE,MAAM;QACjB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;QAC7B,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,SAAS,CAAC,CAAA;gBACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBAC5E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAA;gBACjC,CAAC;gBACD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC;qBAC/B,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;qBACpE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;qBAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;qBACjC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBACd,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,EAAE,IAAI,EAAE,YAAY,IAAI,CAAC,KAAK,iEAAiE,EAAE,CAAA;gBAC1G,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;oBAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAA;oBAC7H,OAAO,MAAM,OAAO,CAAC,KAAK,KAAK,IAAI,UAAU,KAAK,GAAG,CAAA;gBACvD,CAAC,CAAC,CAAA;gBACF,OAAO,EAAE,IAAI,EAAE,iBAAiB,MAAM,CAAC,MAAM,8CAA8C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAA;YACnH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI,EAAE,iBAAiB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAA;YACjD,CAAC;QACH,CAAC;KACF,CAAC,CAAC,CAAA;IAEH,QAAQ,CAAC,UAAU,CAAC;QAClB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,qNAAqN;QAClO,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;YAChG,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mIAAmI;gBAChJ,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC;aAC5C;YACD,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+DAA+D,EAAE;SAC7G;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;iBACvD;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC/D;QACD,SAAS,EAAE,MAAM;QACjB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;QAC7B,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAClD,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAA;YACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC1C,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI;oBAAE,OAAO,KAAK,CAAA;gBACxD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAA;gBAC5D,OAAO,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC/G,CAAC,CAAC,CAAA;YACF,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAChF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,IAAI,EAAE,qBAAqB,IAAI,CAAC,MAAM,IAAI,KAAK,cAAc,IAAI,CAAC,QAAQ,IAAI,MAAM,eAAe,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;oBAC1I,QAAQ,EAAE,OAAO;iBAClB,CAAA;YACH,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACpD,MAAM,QAAQ,GAAa,EAAE,CAAA;YAC7B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,QAAQ,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACvG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,QAAQ,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACvG,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC;gBACnD,CAAC,CAAC,qBAAqB,sBAAsB,iBAAiB;gBAC9D,CAAC,CAAC,EAAE,CAAA;YACN,OAAO;gBACL,IAAI,EAAE,eAAe,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,sCAAsC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE;gBACtH,QAAQ,EAAE,OAAO;aAClB,CAAA;QACH,CAAC;KACF,CAAC,CAAC,CAAA;AACL,CAAC"}

package/lib/tools/documents.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OCR 工具：POST /v1/ocr，按页计费；reuse_id 复用已解析文档不再计费。
+ * 会话内复用：同一次 execute 的返回值带 reuse_id，模型下次直接回传即免重复扣费。
+ * @module dsh-kenari-plugin/tools/documents
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import type { ToolsDeps } from './shared.js';
+/** 注册 kenari_ocr。 */
+export declare function registerOcrTool(deps: ToolsDeps, register: (tool: ReturnType<typeof defineTool>) => void): void;
+//# sourceMappingURL=documents.d.ts.map

package/lib/tools/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAwB5C,qBAAqB;AACrB,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,GAAG,IAAI,CAgF9G"}

package/lib/tools/documents.js

@@ -0,0 +1,118 @@
+/**
+ * OCR 工具：POST /v1/ocr，按页计费；reuse_id 复用已解析文档不再计费。
+ * 会话内复用：同一次 execute 的返回值带 reuse_id，模型下次直接回传即免重复扣费。
+ * @module dsh-kenari-plugin/tools/documents
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { billSpend, spendGuard } from './shared.js';
+import { kenariPost } from '../http.js';
+/** data URL 解析：`data:<media-type>;base64,<payload>`，负载要求 canonical base64。 */
+function parseDataUrl(dataUrl) {
+    const match = /^data:([!#$%&'*+.^_`|~a-zA-Z0-9/-]+);base64,([A-Za-z0-9+/]+={0,2})$/.exec(dataUrl);
+    if (match === null) {
+        throw new Error('file_data 必须是 data:<media-type>;base64,<内容> 形式的 data URL（Kenari 不抓取 http URL）');
+    }
+    return { mediaType: match[1], bytes: Uint8Array.from(Buffer.from(match[2], 'base64')) };
+}
+/** Kenari 接受的文档媒体类型（OpenAPI：pdf 与四种位图）。 */
+const ACCEPTED_MEDIA_TYPES = new Set([
+    'application/pdf',
+    'image/png',
+    'image/jpeg',
+    'image/webp',
+    'image/gif',
+    'image/tiff',
+]);
+/** 注册 kenari_ocr。 */
+export function registerOcrTool(deps, register) {
+    register(defineTool({
+        name: 'kenari_ocr',
+        description: 'Read a PDF or document image to text via Kenari OCR. Billed per page from your Kenari balance (~15 MB limit). Send file_data as a data URL, or pass reuse_id from a previous call to re-read the same document free of charge.',
+        parameters: {
+            file_data: { type: 'string', description: 'The document as a data URL: data:application/pdf;base64,... or an image data URL. Provide this OR reuse_id, never both.' },
+            reuse_id: { type: 'string', description: 'Echo of a previously issued reuse_id to serve the stored reading at no cost. Provide this OR file_data, never both.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    reuse_id: { type: 'string', required: true },
+                    pages: { type: 'integer' },
+                    cost_micro_idr: { type: 'integer' },
+                    text: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        timeoutMs: 400_000,
+        isConcurrencySafe: () => true,
+        async execute(args, exec) {
+            spendGuard(deps, exec, 'kenari_ocr');
+            if (args.file_data !== undefined && args.reuse_id !== undefined) {
+                throw new Error('file_data 与 reuse_id 不可同时提供');
+            }
+            if (args.file_data === undefined && args.reuse_id === undefined) {
+                throw new Error('必须提供 file_data（data URL）或 reuse_id 之一');
+            }
+            const body = { engine: 'ocr' };
+            if (args.reuse_id !== undefined) {
+                body.reuse_id = args.reuse_id;
+            }
+            else if (args.file_data !== undefined) {
+                // OpenAPI 要求 file: { filename, file_data }；filename 从数据源推断
+                const parsed = parseDataUrl(args.file_data);
+                if (!ACCEPTED_MEDIA_TYPES.has(parsed.mediaType)) {
+                    throw new Error(`不支持的媒体类型 ${parsed.mediaType}：接受 application/pdf、image/png、image/jpeg、image/webp、image/gif、image/tiff`);
+                }
+                const ext = mediaExtension(parsed.mediaType);
+                body.file = { filename: `document${ext}`, file_data: args.file_data };
+            }
+            // OCR 按页计费：长超时（大文档），超时不重试以免重复扣费
+            const ocrOptions = {
+                timeoutMs: deps.http.config.generationTimeoutMs ?? 180_000,
+                retries: 1,
+                retryTimeouts: false,
+            };
+            const result = await kenariPost(deps.http, '/ocr', body, undefined, ocrOptions);
+            if (result.reuse_id === undefined) {
+                throw new Error('kenari: OCR 响应缺少 reuse_id，无法建立会话内复用');
+            }
+            const text = (result.content ?? [])
+                .map((block) => block.text ?? '')
+                .filter((part) => part.length > 0)
+                .join('\n\n');
+            const summary = [
+                `OCR 完成：${result.pages ?? '?'} 页，置信度${result.confidence === null || result.confidence === undefined ? '未知' : ` ${Math.round(result.confidence * 100)}%`}${result.low_confidence === true ? '（低置信度告警）' : ''}。`,
+                `复用凭证 reuse_id：${result.reuse_id} —— 下次读同一文档传这个 id，不再计费。`,
+            ];
+            summary.push('', text);
+            const billed = await billSpend(deps, exec, {
+                tool: 'kenari_ocr',
+                costMicroIdr: result.cost_micro_idr,
+                note: result.cost_micro_idr === 0 ? '复用命中，本次免费' : '按页计费',
+            });
+            if (billed.length > 0)
+                summary.push(billed.trimStart());
+            return {
+                reuse_id: result.reuse_id,
+                ...(result.pages !== undefined ? { pages: result.pages } : {}),
+                ...(result.cost_micro_idr !== undefined ? { cost_micro_idr: result.cost_micro_idr } : {}),
+                text: summary.join('\n'),
+            };
+        },
+    }));
+}
+/** 媒体类型 → 文件扩展名（仅用于 filename 字段）。 */
+function mediaExtension(mediaType) {
+    switch (mediaType) {
+        case 'application/pdf': return '.pdf';
+        case 'image/png': return '.png';
+        case 'image/jpeg': return '.jpg';
+        case 'image/webp': return '.webp';
+        case 'image/gif': return '.gif';
+        case 'image/tiff': return '.tiff';
+        default: return '';
+    }
+}
+//# sourceMappingURL=documents.js.map

package/lib/tools/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,8EAA8E;AAC9E,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,KAAK,GAAG,qEAAqE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjG,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAA;AACzF,CAAC;AAED,2CAA2C;AAC3C,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,iBAAiB;IACjB,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,YAAY;CACb,CAAC,CAAA;AAEF,qBAAqB;AACrB,MAAM,UAAU,eAAe,CAAC,IAAe,EAAE,QAAuD;IACtG,QAAQ,CAAC,UAAU,CAAC;QAClB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,gOAAgO;QAC7O,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yHAAyH,EAAE;YACrK,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qHAAqH,EAAE;SACjK;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC5C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC1B,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACzC;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC/D;QACD,SAAS,EAAE,OAAO;QAClB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;QAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;YACpC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;YAChD,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;YAC1D,CAAC;YAED,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;YACvD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;YAC/B,CAAC;iBAAM,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACxC,2DAA2D;gBAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAC3C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;oBAChD,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,CAAC,SAAS,0EAA0E,CAAC,CAAA;gBACzH,CAAC;gBACD,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;gBAC5C,IAAI,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAE,WAAW,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAA;YACvE,CAAC;YAED,gCAAgC;YAChC,MAAM,UAAU,GAAyB;gBACvC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,OAAO;gBAC1D,OAAO,EAAE,CAAC;gBACV,aAAa,EAAE,KAAK;aACrB,CAAA;YACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAc,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;YAC5F,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;YACxD,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;iBAChC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;iBAChC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;iBACjC,IAAI,CAAC,MAAM,CAAC,CAAA;YACf,MAAM,OAAO,GAAa;gBACxB,UAAU,MAAM,CAAC,KAAK,IAAI,GAAG,SAAS,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG;gBAC7M,iBAAiB,MAAM,CAAC,QAAQ,yBAAyB;aAC1D,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;YAEtB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE;gBACzC,IAAI,EAAE,YAAY;gBAClB,YAAY,EAAE,MAAM,CAAC,cAAc;gBACnC,IAAI,EAAE,MAAM,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;aACzD,CAAC,CAAA;YACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;YAEvD,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzF,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;aACzB,CAAA;QACH,CAAC;KACF,CAAC,CAAC,CAAA;AACL,CAAC;AAED,qCAAqC;AACrC,SAAS,cAAc,CAAC,SAAiB;IACvC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAiB,CAAC,CAAC,OAAO,MAAM,CAAA;QACrC,KAAK,WAAW,CAAC,CAAC,OAAO,MAAM,CAAA;QAC/B,KAAK,YAAY,CAAC,CAAC,OAAO,MAAM,CAAA;QAChC,KAAK,YAAY,CAAC,CAAC,OAAO,OAAO,CAAA;QACjC,KAAK,WAAW,CAAC,CAAC,OAAO,MAAM,CAAA;QAC/B,KAAK,YAAY,CAAC,CAAC,OAAO,OAAO,CAAA;QACjC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAA;IACpB,CAAC;AACH,CAAC"}

package/lib/tools/media.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 媒体工具族：图像生成/编辑、语音合成/转写、音乐生成、视频生成/续写/状态/下载。
+ * 二进制产物（图像、音频、视频）经 ctx.attachments 落盘；attachment ref 是纯 JSON，
+ * 放进规范 value 由 render 重建 image/file block，模型与 UI 都能看到产物。
+ * @module dsh-kenari-plugin/tools/media
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { ToolsDeps } from './shared.js';
+/** 规范 value 里的产物描述：kind 决定 render 重建成 image 还是 file block。 */
+export interface MediaAttachmentValue {
+    kind: 'image' | 'file';
+    /** ImageAttachmentRef 字段（image）。 */
+    attachmentId: string;
+    mediaType?: string;
+    width?: number;
+    height?: number;
+    /** FileAttachmentRef 字段（file）。 */
+    name?: string;
+    bytes: number;
+}
+/** 规范 value 的 attachments → ContentBlock（render 用；损坏的 ref 退化为文本）。 */
+export declare function renderAttachments(value: {
+    attachments?: MediaAttachmentValue[];
+}): ContentBlock[];
+/** 注册媒体工具族。 */
+export declare function registerMediaTools(deps: ToolsDeps, register: (tool: ReturnType<typeof defineTool>) => void): void;
+//# sourceMappingURL=media.d.ts.map

package/lib/tools/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/tools/media.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;IACtB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAuDD,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAA;CAAE,GAAG,YAAY,EAAE,CAuBjG;AAiED,eAAe;AACf,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,GAAG,IAAI,CAsajH"}