dsh-data-domain-knowledge 0.1.0-alpha.1

package/lib/types/convert/host.js

@@ -0,0 +1,479 @@
+/**
+ * The convert host — the DSH-facing half of multi-format conversion.
+ *
+ * Since 0018 this lives inside `plugins/dsh-data-domain-knowledge` (issue 0018):
+ * conversion is a sub-capability of knowledge, mounted as one plugin, with one
+ * sidebar entry and one settings surface for the user. The kernel
+ * (`dsh-convert-core`) stays an independent, optional package that
+ * `core-loader.ts` imports lazily.
+ *
+ * Layering this file must keep:
+ *
+ *   kernel (convert-core)   input → knowledge-ready Markdown + assets + console
+ *   this host               settings, agent tools, /convert route, ingestion
+ *
+ * Nothing about parsing lives here; nothing about DSH lives in the kernel. That
+ * is why the same console still works standalone at `tita-convert`.
+ */
+import { stat } from 'node:fs/promises';
+import { basename, resolve } from 'node:path';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { ConvertCoreMissingError, loadConvertCore } from './core-loader.js';
+import { tmpRoot, workspaceOutputRoot } from '../layout.js';
+import { ingestDelivery } from './ingest.js';
+import { DEFAULT_CONVERT_CONFIG, failure, success, WRITE_TOOLS, } from './types.js';
+export { CONVERT_SETTINGS_NAMESPACE, DEFAULT_CONVERT_CONFIG, defaultConvertRoot } from './types.js';
+/** Route prefix the console and API are mounted on. Frozen contract. */
+export const MOUNT_PATH = '/convert';
+const PREVIEW_CHARS = 1200;
+/**
+ * 转换的设置 schema。
+ *
+ * 0029 起它**没有路径字段**：交付物与工作区都从知识插件的 `agentRoot` 推出来
+ * （`<agentRoot>/output/<日期>/`、`<agentRoot>/tmp/`）。一个 Agent 只有一个根路径，
+ * 所以这里再放一个 `rootDir` 就等于把「东西存在哪」这个答案劈成两半。
+ *
+ * 定义本身搬到了 `./settings-schema.js`（纯数据、可被 `Config` 组合并在
+ * `node --test` 里独立解析）；这里 re-export，保持既有出口不变。
+ */
+export { CONVERT_SETTINGS_SCHEMA } from './settings-schema.js';
+function output() {
+    return { schema: { type: 'json' }, render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }] };
+}
+function tool(toolName, description, parameters, execute) {
+    return defineTool({ name: toolName, description, parameters: parameters, output: output(), execute: execute });
+}
+function lineageOf(args, exec) {
+    const lineage = {};
+    const sessionId = typeof args.session_key === 'string' && args.session_key.trim() ? args.session_key.trim() : exec?.agent?.session.header.id;
+    if (sessionId)
+        lineage.sessionId = sessionId;
+    const fields = [
+        ['turnId', 'turn_id'], ['intentId', 'intent_id'], ['taskId', 'task_id'],
+        ['subtaskId', 'subtask_id'], ['parentSubtaskId', 'parent_subtask_id'], ['runId', 'run_id'], ['traceId', 'trace_id'], ['domain', 'domain'],
+    ];
+    for (const [target, source] of fields)
+        if (typeof args[source] === 'string' && args[source].trim())
+            lineage[target] = args[source].trim().slice(0, 160);
+    return Object.keys(lineage).length > 0 ? lineage : undefined;
+}
+async function readJsonBody(req, maxBytes = 2 * 1024 * 1024) {
+    const chunks = [];
+    let bytes = 0;
+    for await (const chunk of req) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
+        bytes += buffer.length;
+        if (bytes > maxBytes)
+            throw new Error('REQUEST_TOO_LARGE');
+        chunks.push(buffer);
+    }
+    if (!chunks.length)
+        return {};
+    return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+}
+function send(res, status, body) {
+    res.statusCode = status;
+    res.setHeader('content-type', 'application/json; charset=utf-8');
+    res.setHeader('cache-control', 'no-store');
+    res.end(JSON.stringify(body));
+}
+/** Compact task view for tools — the full ingest payload never enters context. */
+function taskView(task) {
+    const manifest = task.manifest;
+    return {
+        taskId: task.id,
+        state: task.state,
+        inputKind: task.inputKind,
+        title: manifest?.title ?? task.label,
+        sourceFormat: manifest?.sourceFormat ?? task.sourceFormat,
+        parser: manifest?.parser,
+        progress: task.progress,
+        stage: task.stage,
+        message: task.message,
+        error: task.error ?? null,
+        warnings: task.warnings.map(warning => warning.code),
+        attempts: task.attempts,
+        deliveryDir: task.deliveryDir,
+        assetCount: manifest?.assets.length ?? 0,
+        wordCount: manifest?.wordCount ?? 0,
+        contentHash: manifest?.contentHash,
+        externalId: manifest?.externalId,
+        sourceTypeCandidates: manifest?.ingest.sourceTypeCandidates ?? [],
+        sourceTypeRequired: manifest?.ingest.sourceTypeRequired ?? true,
+        preview: manifest?.ingest.content.slice(0, PREVIEW_CHARS) ?? null,
+    };
+}
+async function waitForTask(service, taskId, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const task = service.get(taskId);
+        if (!task)
+            return undefined;
+        if (task.state === 'succeeded' || task.state === 'failed' || task.state === 'cancelled')
+            return task;
+        await new Promise(resolve => setTimeout(resolve, 250));
+    }
+    return service.get(taskId);
+}
+export function applyConvert(ctx, deps) {
+    let config = { ...DEFAULT_CONVERT_CONFIG };
+    let service;
+    let starting;
+    let kernelHandler;
+    /**
+     * Set when the optional kernel could not be loaded. Kept as the original error
+     * so the tool/route layer can surface its code and install suggestion verbatim.
+     */
+    let dependencyError;
+    async function ensureService() {
+        if (service)
+            return service;
+        if (!starting) {
+            starting = loadConvertCore()
+                .then(async (core) => {
+                // 目录都从知识插件的根路径推出来：状态文件落在 `tmp/` 根（它是运行期
+                // 事实，不是交付物，所以不占日期桶），交付与工作区各自按日期分桶。
+                const root = deps.agentRoot();
+                const created = await core.createConvertService({
+                    rootDir: tmpRoot(root),
+                    outRoot: workspaceOutputRoot(deps.workspace?.() ?? process.cwd()),
+                    workRoot: tmpRoot(root),
+                    // 根路径契约里 output/ 与 tmp/ 的二级就是日期（`layout.ts`），所以插件
+                    // 显式打开分桶；独立内核保持扁平布局不受影响。
+                    bucketByDay: true,
+                    maxConcurrent: config.maxConcurrent,
+                    maxInputBytes: config.maxInputBytes,
+                    retentionDays: config.retentionDays,
+                });
+                service = created;
+                kernelHandler = core.createRequestHandler({ service: created, basePath: MOUNT_PATH });
+                dependencyError = undefined;
+                return created;
+            })
+                .catch(error => {
+                starting = undefined;
+                dependencyError = error;
+                return undefined;
+            });
+        }
+        return await starting;
+    }
+    async function resetService() {
+        const current = service;
+        service = undefined;
+        starting = undefined;
+        kernelHandler = undefined;
+        if (current)
+            await current.close().catch(() => undefined);
+    }
+    /** The kernel is optional; this is the single place its absence becomes an answer. */
+    function missingDependency(data) {
+        const error = dependencyError;
+        const message = error instanceof Error ? error.message : '转换内核 dsh-convert-core 不可用。';
+        const suggestion = error instanceof ConvertCoreMissingError
+            ? error.suggestion
+            : '安装可选依赖 dsh-convert-core 后重试。';
+        return failure(data, 'DEPENDENCY_MISSING', message, true, suggestion);
+    }
+    function knowledgeBaseUrl() {
+        const web = ctx.get('webServer');
+        const host = web?.host === '0.0.0.0' ? '127.0.0.1' : web?.host ?? '127.0.0.1';
+        return `http://${host}:${web?.port ?? 0}`;
+    }
+    /**
+     * Since 0018 the knowledge root is not resolved from another plugin's settings
+     * or an environment variable: the convert host runs inside the knowledge
+     * plugin and writes exactly where the live runtime reads.
+     *
+     * Since 0019 a delivery can also target a **specific** knowledge base: the
+     * panel imports a file into whichever base the user selected.
+     */
+    function resolveKnowledgeRoot() {
+        return { root: deps.knowledgeRoot(), source: 'knowledge-runtime' };
+    }
+    /** Ingest target for one knowledge base, falling back to the default base. */
+    function targetFor(kbId) {
+        const id = typeof kbId === 'string' && kbId.trim() ? kbId.trim() : undefined;
+        const resolved = id ? deps.resolveTarget?.(id) : undefined;
+        if (resolved)
+            return { ...resolved, baseId: id };
+        return { runtime: deps.runtime(), knowledgeRoot: deps.knowledgeRoot(), ...(id ? { baseId: id } : {}) };
+    }
+    /**
+     * 目标知识库中「存在且启用」的来源分类 id（0013）。
+     *
+     * 用作转换内核的候选提示，**取代内核按载体格式猜出来的那张表**——那张表会给出
+     * video / image 这类载体名，和「source_type 描述业务场景」直接冲突。分类判定
+     * 仍然由 knowledge 侧负责，这里只是把真实候选告诉调用方。
+     */
+    function sourceTypeCandidateIds(runtime) {
+        return (runtime.sourceTypes?.() ?? []).filter(def => def.enabled).map(def => def.id);
+    }
+    /**
+     * 设置来源。0.1.7 起设置随 `applyConvert(ctx, deps)` 的 `deps.config` 进来
+     * （插件 entry 的 `convert` 组），`settings.installSection` 那套命名空间注册
+     * 已经整个删除。组合层会合上 schema 默认值，这里再铺一层
+     * `DEFAULT_CONVERT_CONFIG` 兜底，好让直接调用 `applyConvert` 的装配方式也成立。
+     *
+     * 「改设置会让插件整个重载」这句话对 volatile 字段**不成立** —— loader 只就地改
+     * 引用再发一个事件（见 `settings-volatile.ts`）。所以重灌这件事由组合根在
+     * `loader/volatile-update` 时调 `reprocess()` 补上，这里只负责读值。
+     */
+    const readConfig = () => (typeof deps.config === 'function' ? deps.config() : deps.config) ?? {};
+    config = { ...DEFAULT_CONVERT_CONFIG, ...readConfig() };
+    void resetService();
+    ctx.on('tools/pre-execute', (exec, next) => {
+        if (WRITE_TOOLS.includes(exec.name)) {
+            return Promise.resolve({ kind: 'ask', reason: '该操作会转换本地内容，并写入 Tita Knowledge Store，需要本轮用户审批。' });
+        }
+        return next();
+    });
+    // ---------------------------------------------------------------- tools
+    ctx.tools.register(tool('convert_capabilities', 'Inspect the conversion kernel: available adapters, engine version, supported formats and where deliveries are written. Read-only; call this before promising a format will work.', { session_key: { type: 'string' } }, async () => {
+        const kernel = await ensureService();
+        if (!kernel)
+            return missingDependency({ adapters: [], supportedExtensions: [] });
+        // Forced: this is an explicit question ("can you convert X?"), not the console's
+        // poll, and the service caches the report so that poll stays cheap. An agent that
+        // just installed a binary and then asked would otherwise get the stale answer.
+        const report = await kernel.capabilities({ force: true });
+        const knowledge = resolveKnowledgeRoot();
+        return success({
+            adapters: report.adapters,
+            runtime: report.runtime,
+            defaults: report.defaults,
+            supportedExtensions: report.extensions,
+            rootDir: kernel.rootDir,
+            outDir: kernel.outDir,
+            consolePath: `${MOUNT_PATH}/`,
+            knowledgeRoot: knowledge.root,
+            knowledgeRootSource: knowledge.source,
+            knowledgeBaseUrl: knowledgeBaseUrl(),
+            ingestEnabled: config.ingestEnabled,
+        });
+    }));
+    ctx.tools.register(tool('convert_source', 'Convert a document (Word / PowerPoint / Excel / OpenDocument / RTF / EPUB / CSV / text-layer PDF) or inline text into knowledge-ready Markdown + local images. Async kernel task; returns taskId, delivery dir and ingest hints (source_type candidates, external_id, content_hash). Write operation: DSH asks the user once before execution.', {
+        kind: { type: 'string', enum: ['file', 'text'], required: true },
+        path: { type: 'string' },
+        text: { type: 'string' },
+        title: { type: 'string' },
+        source_type: { type: 'string' },
+        adapter: { type: 'string' },
+        wait: { type: 'boolean' },
+        session_key: { type: 'string' },
+        task_id: { type: 'string' },
+        subtask_id: { type: 'string' },
+        parent_subtask_id: { type: 'string' },
+        run_id: { type: 'string' },
+        turn_id: { type: 'string' },
+        trace_id: { type: 'string' },
+        domain: { type: 'string' },
+    }, async (args, exec) => {
+        const kernel = await ensureService();
+        if (!kernel)
+            return missingDependency({ taskId: null });
+        const kind = args.kind;
+        const candidates = sourceTypeCandidateIds(targetFor(args.kb).runtime);
+        const request = {
+            kind,
+            ...(candidates.length > 0 ? { sourceTypeCandidates: candidates } : {}),
+            ...(typeof args.text === 'string' ? { text: args.text } : {}),
+            ...(typeof args.title === 'string' && args.title.trim() ? { title: args.title.trim() } : {}),
+            ...(typeof args.source_type === 'string' && args.source_type.trim() ? { sourceType: args.source_type.trim(), sourceTypeSource: 'agent' } : {}),
+            ...(typeof args.adapter === 'string' && args.adapter.trim() ? { adapter: args.adapter.trim() } : {}),
+            ...(lineageOf(args, exec) ? { lineage: lineageOf(args, exec) } : {}),
+        };
+        // Local files are handed to the kernel as a path: it owns staging, size
+        // limits and cleanup, so the host never buffers a 256 MB file.
+        if (kind === 'file') {
+            if (typeof args.path !== 'string' || !args.path.trim()) {
+                return failure({ taskId: null }, 'PATH_REQUIRED', 'kind=file 必须提供本地绝对路径 path。', false, '用户上传的文件请走知识面板的「转换」页；Agent 侧只能读取本机已有路径。');
+            }
+            const absolute = resolve(args.path.trim());
+            try {
+                const info = await stat(absolute);
+                if (!info.isFile())
+                    return failure({ taskId: null }, 'PATH_NOT_A_FILE', `路径不是文件：${absolute}`);
+                if (info.size > config.maxInputBytes) {
+                    return failure({ taskId: null }, 'INPUT_TOO_LARGE', `文件 ${info.size} 字节超过上限 ${config.maxInputBytes}。`, false, '调大转换设置 maxInputBytes，或先压缩文件。');
+                }
+            }
+            catch (cause) {
+                return failure({ taskId: null }, 'PATH_UNREADABLE', `无法读取 ${absolute}：${cause instanceof Error ? cause.message : String(cause)}`);
+            }
+            request.localPath = absolute;
+            if (!request.title)
+                request.title = basename(absolute);
+        }
+        const submitted = await kernel.submit(request);
+        const shouldWait = args.wait !== false;
+        const finished = shouldWait ? await waitForTask(kernel, submitted.id, config.toolWaitMs) : submitted;
+        const view = taskView(finished ?? submitted);
+        return success({
+            ...view,
+            waited: shouldWait,
+            ingestHint: '调用 convert_ingest 把该任务写入知识库；它会把 Markdown 与图片一起落地，并返回 cardHints。',
+        });
+    }));
+    ctx.tools.register(tool('convert_task', 'Inspect the conversion queue: list, get, cancel, retry, or read the delivered Markdown/manifest of a task. Read-only.', {
+        action: { type: 'string', enum: ['list', 'get', 'cancel', 'retry', 'markdown', 'manifest'], required: true },
+        task_id: { type: 'string' },
+        limit: { type: 'integer' },
+    }, async (args) => {
+        const kernel = await ensureService();
+        if (!kernel)
+            return missingDependency({ tasks: [] });
+        const action = String(args.action);
+        if (action === 'list') {
+            const limit = Number.isFinite(args.limit) ? Math.max(1, Math.min(100, Number(args.limit))) : 20;
+            return success({ tasks: kernel.list().slice(0, limit).map(taskView) });
+        }
+        const taskId = typeof args.task_id === 'string' ? args.task_id.trim() : '';
+        if (!taskId)
+            return failure({ taskId: null }, 'TASK_ID_REQUIRED', `${action} 需要 task_id。`);
+        if (action === 'cancel')
+            return success(taskView(kernel.cancel(taskId)));
+        if (action === 'retry')
+            return success(taskView(await kernel.retry(taskId)));
+        if (action === 'markdown') {
+            const file = await kernel.readDeliveryFile(taskId, 'index.md');
+            if (!file)
+                return failure({ taskId }, 'ARTIFACT_NOT_FOUND', '该任务没有 index.md（未成功或已被清理）。');
+            return success({ taskId, markdown: file.data.toString('utf8') });
+        }
+        if (action === 'manifest') {
+            const file = await kernel.readDeliveryFile(taskId, 'manifest.json');
+            if (!file)
+                return failure({ taskId }, 'ARTIFACT_NOT_FOUND', '该任务没有 manifest.json。');
+            return success({ taskId, manifest: JSON.parse(file.data.toString('utf8')) });
+        }
+        const task = kernel.get(taskId);
+        if (!task)
+            return failure({ taskId }, 'TASK_NOT_FOUND', `任务不存在：${taskId}`);
+        return success(taskView(task));
+    }));
+    ctx.tools.register(tool('convert_ingest', 'Ingest a delivered conversion into the knowledge store: copies images into the knowledge root, rewrites local image references, writes the SourceRaw document in-process, and returns cardHints so a wiki card can carry the images into multimodal recall. Write operation: DSH asks the user once before execution. Set plan_only=true for a dry run.', {
+        convert_task_id: { type: 'string', required: true },
+        kb: { type: 'string', description: '目标知识库 id；省略则写入默认知识库' },
+        source_type: { type: 'string' },
+        title: { type: 'string' },
+        plan_only: { type: 'boolean' },
+        session_key: { type: 'string' },
+        task_id: { type: 'string' },
+        subtask_id: { type: 'string' },
+        parent_subtask_id: { type: 'string' },
+        run_id: { type: 'string' },
+        turn_id: { type: 'string' },
+        trace_id: { type: 'string' },
+        domain: { type: 'string' },
+    }, async (args, exec) => {
+        if (!config.ingestEnabled) {
+            return failure({ taskId: String(args.convert_task_id) }, 'INGEST_DISABLED', '当前设置禁止转换写入知识库（ingestEnabled=false）。', false, '在 Tita Data Agent → 设置 → 转换 中开启「允许一键入库」，或手动调用 add_source。');
+        }
+        const kernel = await ensureService();
+        if (!kernel)
+            return missingDependency({ taskId: String(args.convert_task_id) });
+        const target = targetFor(args.kb);
+        const result = await ingestDelivery({
+            service: kernel,
+            taskId: String(args.convert_task_id),
+            runtime: target.runtime,
+            knowledgeRoot: target.knowledgeRoot,
+            ...(typeof args.source_type === 'string' && args.source_type.trim() ? { sourceType: args.source_type.trim() } : {}),
+            ...(typeof args.title === 'string' && args.title.trim() ? { title: args.title.trim() } : {}),
+            planOnly: args.plan_only === true,
+            ...(lineageOf(args, exec) ? { lineage: lineageOf(args, exec) } : {}),
+        });
+        return {
+            ...result,
+            data: {
+                ...result.data,
+                knowledgeRootSource: 'knowledge-runtime',
+                ...(target.baseId ? { knowledgeBaseId: target.baseId } : {}),
+            },
+        };
+    }));
+    // ---------------------------------------------------------------- routes
+    ctx.inject(['webServer'], webCtx => {
+        const web = webCtx;
+        // Plugin-level facts the kernel cannot know about itself.
+        const pluginFacts = () => {
+            const knowledge = resolveKnowledgeRoot();
+            const root = deps.agentRoot();
+            return {
+                rootDir: service?.rootDir ?? tmpRoot(root),
+                outDir: service?.outRoot ?? workspaceOutputRoot(deps.workspace?.() ?? process.cwd()),
+                workDir: service?.workRoot ?? tmpRoot(root),
+                mountPath: MOUNT_PATH,
+                knowledgeRoot: knowledge.root,
+                knowledgeRootSource: knowledge.source,
+                knowledgeBaseUrl: knowledgeBaseUrl(),
+                ingestEnabled: config.ingestEnabled,
+                kernelLoaded: service !== undefined,
+            };
+        };
+        const dispatch = async (req, res) => {
+            const url = new URL(req.url ?? '/', 'http://127.0.0.1');
+            if (url.pathname === `${MOUNT_PATH}/api/ingest`) {
+                if (req.method !== 'POST')
+                    return send(res, 405, failure({}, 'METHOD_NOT_ALLOWED', '该 endpoint 只接受 POST'));
+                try {
+                    const body = await readJsonBody(req);
+                    const kernel = await ensureService();
+                    if (!kernel)
+                        return send(res, 503, missingDependency({ taskId: String(body.task_id ?? '') }));
+                    const target = targetFor(body.kb);
+                    const result = await ingestDelivery({
+                        service: kernel,
+                        taskId: String(body.task_id ?? ''),
+                        runtime: target.runtime,
+                        knowledgeRoot: target.knowledgeRoot,
+                        ...(typeof body.source_type === 'string' && body.source_type.trim() ? { sourceType: body.source_type.trim() } : {}),
+                        ...(typeof body.title === 'string' && body.title.trim() ? { title: body.title.trim() } : {}),
+                        planOnly: body.plan_only === true,
+                        ...(body.lineage && typeof body.lineage === 'object' ? { lineage: body.lineage } : {}),
+                    });
+                    return send(res, 200, {
+                        ...result,
+                        data: {
+                            ...result.data,
+                            knowledgeRootSource: 'knowledge-runtime',
+                            ...(target.baseId ? { knowledgeBaseId: target.baseId } : {}),
+                        },
+                    });
+                }
+                catch (cause) {
+                    return send(res, 400, failure({}, 'REQUEST_INVALID', cause instanceof Error ? cause.message : String(cause)));
+                }
+            }
+            if (url.pathname === `${MOUNT_PATH}/api/plugin`) {
+                if (req.method !== 'GET')
+                    return send(res, 405, failure({}, 'METHOD_NOT_ALLOWED', '该 endpoint 只接受 GET'));
+                return send(res, 200, success(pluginFacts()));
+            }
+            // Everything else belongs to the kernel console/API.
+            if (!kernelHandler)
+                await ensureService();
+            if (!kernelHandler)
+                return send(res, 503, missingDependency({ mountPath: MOUNT_PATH }));
+            return await kernelHandler(req, res);
+        };
+        const dispose = web.webServer.register({ kind: 'prefix', path: MOUNT_PATH, handler: dispatch });
+        return () => {
+            void dispose();
+            void resetService();
+        };
+    });
+    return {
+        reprocess: () => {
+            const next = { ...DEFAULT_CONVERT_CONFIG, ...readConfig() };
+            const changed = Object.keys(next).some(key => next[key] !== config[key]);
+            config = next;
+            // 只有真变了才重置内核：`loader/volatile-update` 是**这个 entry**的事件，但知识那组
+            // 的改动也会走到这里，无谓地关掉内核会让下一次转换重新起一遍内核。
+            if (changed)
+                void resetService();
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

package/lib/types/convert/host.js.map

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

package/lib/types/convert/ingest.d.ts

@@ -0,0 +1,125 @@
+/**
+ * The knowledge-ingestion seam.
+ *
+ * Rules this file obeys, and why:
+ *
+ * 1. **One write entry, in-process.** Since 0018 the convert host lives inside
+ *    the knowledge plugin, so ingestion calls `KnowledgeRuntime.addSource()`
+ *    directly instead of `POST /knowledge/sources`. That removes a JSON body
+ *    cap (the old transport 400'd above ~1.2 MB) and removes port discovery,
+ *    startup ordering and error-code re-translation from the failure surface.
+ *    The structural `IngestTarget` interface is deliberately the only knowledge
+ *    API this module may touch — conversion code must not reach into the store.
+ * 2. **The kernel never writes the knowledge store.** It only produces
+ *    `convert-out/<taskId>/`. This module is the translation step.
+ * 3. **`source_type` stays the knowledge side's decision.** We propose
+ *    candidates; if the store rejects the value we surface its error verbatim
+ *    instead of silently defaulting.
+ * 4. **Images must land inside the knowledge root**, because retrieval only
+ *    reads local relative paths — and only the *first* image of a unit reaches
+ *    the multimodal embedder, so we also emit card hints that tell the Agent how
+ *    to reference them.
+ */
+import type { ConvertService, IngestPayload } from 'dsh-convert-core';
+import type { LineageContext } from 'dsh-data-contracts/refs';
+import type { SourceType, SourceTypeDef } from '../types.js';
+import { KNOWLEDGE_WIKI_DIR, type Envelope } from './types.js';
+/**
+ * The only slice of the knowledge store this seam is allowed to use. Declared
+ * structurally so this module never imports `runtime.ts`.
+ */
+export interface IngestTarget {
+    addSource(input: {
+        sourceType: SourceType;
+        title?: string;
+        content: string;
+        externalId?: string;
+        metadata?: Record<string, unknown>;
+        sourceId?: string;
+        lineage?: LineageContext;
+    }): Promise<{
+        ok: boolean;
+        data: {
+            sourceId: string;
+            path: string;
+        };
+        error?: {
+            code?: string;
+            message?: string;
+            suggestion?: string;
+        } | null;
+    }>;
+    /**
+     * 该知识库的来源分类注册表（0013，**只读**）。
+     *
+     * 只用来把「候选分类」告诉调用方，转换模块不参与分类判定、也不改注册表，
+     * 所以它仍然是 knowledge 侧的能力，不算越界写。可选：老的测试替身可以不给。
+     */
+    sourceTypes?(): SourceTypeDef[];
+}
+export interface IngestOptions {
+    service: ConvertService;
+    taskId: string;
+    /** The live knowledge runtime; the write goes through `addSource` only. */
+    runtime: IngestTarget;
+    /** Absolute knowledge root the runtime currently writes to. */
+    knowledgeRoot: string;
+    /** Business classification. Omitted means "let the store decide/default". */
+    sourceType?: string;
+    title?: string;
+    metadata?: Record<string, unknown>;
+    lineage?: Record<string, unknown>;
+    /** Dry run: build the plan without copying assets or writing the source. */
+    planOnly?: boolean;
+}
+export interface PlacedAsset {
+    rel: string;
+    /** Absolute path inside the knowledge root. */
+    target: string;
+    bytes: number;
+}
+export interface IngestOutcome {
+    taskId: string;
+    sourceId?: string;
+    sourcePath?: string;
+    knowledgeRoot: string;
+    externalId: string;
+    contentHash: string;
+    sourceFormat: string;
+    parser: string;
+    sourceType: string;
+    sourceTypeSupplied: boolean;
+    sourceTypeCandidates: string[];
+    assets: PlacedAsset[];
+    /** Path to the source file relative to the knowledge root, e.g. `01_source_truth/x.md`. */
+    relativeSourcePath?: string;
+    cardHints: CardHints;
+    notes: string[];
+}
+export interface CardHints {
+    /** `entity_type` values accepted by the knowledge schema. */
+    entityTypes: string[];
+    sourceRefs: string[];
+    title: string;
+    summary: string;
+    /**
+     * Card body with image references already re-based to `02_wiki/<entityType>/`,
+     * so the first image actually reaches the multimodal embedder.
+     */
+    contentWithImages: string;
+    /** The image references as they must appear inside a card body. */
+    imageRefs: string[];
+}
+declare const ENTITY_TYPES: string[];
+/** Refuse any path that would escape the knowledge root. */
+export declare function safeJoin(root: string, ...parts: string[]): string | undefined;
+export declare function buildCardHints(input: {
+    payload: IngestPayload;
+    sourceId: string;
+    assetBucket: string;
+    assetMapping: Map<string, string>;
+    entityType?: string;
+}): CardHints;
+export declare function ingestDelivery(options: IngestOptions): Promise<Envelope<IngestOutcome>>;
+export { ENTITY_TYPES, KNOWLEDGE_WIKI_DIR };
+//# sourceMappingURL=ingest.d.ts.map

package/lib/types/convert/ingest.d.ts.map

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