dsh-data-domain-knowledge 0.1.1-alpha.2 → 0.1.1-alpha.3

package/lib/types/index.js

@@ -14,21 +14,16 @@ import { KnowledgeEnvironment } from './environment/service.js';
 import { DOC_PAGE_CHARS, DOC_PAGE_CHARS_MAX, documentContentPage } from './document-page.js';
 import { runWikiTrial, trialSummary } from './wiki-trial.js';
 import { extractionRunId } from './extraction-runs.js';
-import { agentLayout, defaultAgentRoot, ensureAgentLayout, intentRoot, knowledgeBaseRoot, memoryRoot, resourceRegistry, resourceRoot, } from './layout.js';
+import { agentLayout, defaultAgentRoot, ensureAgentLayout, knowledgeBaseRoot, memoryRoot, resourceRegistry, resourceRoot, } from './layout.js';
 import { PickerError, createDirectory, listDirectory, pickDirectory, pickerKind, pickerOf, } from './directory-picker.js';
 import { KNOWLEDGE_SETTINGS_SCHEMA, SETTINGS_NAMESPACE } from './settings-schema.js';
 import { DEFAULT_KB_ID, KnowledgeBases } from './knowledge-bases.js';
 import { ImagePublishError, publishKnowledgeImage } from './images.js';
 import { applyConvert, CONVERT_SETTINGS_NAMESPACE, CONVERT_SETTINGS_SCHEMA, MOUNT_PATH as CONVERT_MOUNT_PATH, } from './convert/host.js';
-import { applyIntent, INTENT_MOUNT_PATH, INTENT_SERVICE, } from './intent/host.js';
-import { registerIntentTools } from './intent/tools.js';
 export * from './types.js';
 export * from './runtime.js';
 export * from './knowledge-bases.js';
-export * from './intent/types.js';
-export * from './intent/engine.js';
 export { applyConvert as applyConvertHost, CONVERT_SETTINGS_NAMESPACE, CONVERT_MOUNT_PATH };
-export { applyIntent as applyIntentHost, INTENT_MOUNT_PATH, INTENT_SERVICE };
 export const name = 'dsh-data-domain-knowledge';
 /**
  * `settings` 在 0.1.7 之后**不再需要**：设置已经是本 entry 的 config
@@ -51,6 +46,7 @@ export { CONVERT_SETTINGS_SCHEMA };
  */
 import { Config } from './config-schema.js';
 import { buildModelRequest, callModelWithRetry, collectModelText } from './model-text.js';
+import { agentRecallEnvelope } from './recall-delivery.js';
 import { addSourceCallView, addSourceMetaOf, addSourceResultMarkdown, importCallView, importMetaOf, importResultMarkdown, recallCallView, recallMetaOf, recallResultMarkdown, rebuildCallView, rebuildMetaOf, rebuildResultMarkdown, writeCardsCallView, writeCardsMetaOf, writeCardsResultMarkdown, } from './present.js';
 export { Config };
 /**
@@ -137,7 +133,7 @@ function lineageOf(args, exec) {
     if (sessionId)
         lineage.sessionId = sessionId;
     const fields = [
-        ['turnId', 'turn_id'], ['intentId', 'intent_id'], ['taskId', 'task_id'],
+        ['turnId', 'turn_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)
@@ -149,7 +145,6 @@ function lineageFromUrl(url) {
     return lineageOf({
         session_key: url.searchParams.get('session_key') ?? undefined,
         turn_id: url.searchParams.get('turn_id') ?? undefined,
-        intent_id: url.searchParams.get('intent_id') ?? undefined,
         task_id: url.searchParams.get('task_id') ?? undefined,
         subtask_id: url.searchParams.get('subtask_id') ?? undefined,
         parent_subtask_id: url.searchParams.get('parent_subtask_id') ?? undefined,
@@ -335,8 +330,7 @@ export function apply(ctx, pluginConfig = {}) {
     /**
      * 这两组的把手，`loader/volatile-update` 时调 `reprocess()` 按新值重灌。
      *
-     * 先声明后赋值：事件只在运行时触发，而两组的装配在下面（`applyConvert` /
-     * `applyIntent`）。
+     * 先声明后赋值：事件只在运行时触发，转换宿主在下面的 `applyConvert` 中装配。
      */
     let convertHost;
     /**
@@ -725,7 +719,7 @@ export function apply(ctx, pluginConfig = {}) {
         /**
          * 交付物落在**工作项目**下：`<工作区>/output/<日期>/`，不是 Agent 根路径。
          *
-         * 根路径下的四段（知识 / 记忆 / 意图 / 家当）是**这个 Agent 自己的东西**，跨项目
+         * 根路径下的几段（知识 / 记忆 / 家当）是**这个 Agent 自己的东西**，跨项目
          * 累积；交付物是**某个项目的产物**，换一个项目打开就不该再看见。两者判据不同，
          * 所以落点也不同。
          *
@@ -745,26 +739,6 @@ export function apply(ctx, pluginConfig = {}) {
             return target ? { runtime: target, knowledgeRoot: target.rootDir } : undefined;
         },
     });
-    // 意图记录模块 (issue 0020). The 意图 view was already one of this plugin's
-    // five panel tabs, but its Host lived in a second mount unit; 0020 folds it in
-    // so the declared information architecture and the code layout agree again.
-    // It keeps the `intent_record` / `intent_store_view` tools and `/intent/**` audit endpoints,
-    // and — critically — the `titaDataAgentIntent` Cordis service that `data-table`
-    // resolves by name.
-    // 意图只保留固定的会话审计契约；可编辑词表不再属于插件配置。
-    applyIntent(ctx, {
-        intentRoot: () => intentRoot(config.agentRoot),
-    });
-    // `applyIntent` provides this service from the same plugin fiber. During
-    // `apply()`, that fiber is still starting, so Cordis's default strict lookup
-    // hides the just-provided service until startup completes. The non-strict
-    // lookup is safe here because `applyIntent` ran immediately above.
-    const intentService = ctx.get(INTENT_SERVICE, false);
-    /**
-     * `intent_*` 工具在 Host 层注册，使标准模式可以调用它们；工具执行端只接受
-     * standard 会话，其他 preset 不会写入或读取意图记录。
-     */
-    ctx.effect(() => registerIntentTools(ctx, intentService), 'tita knowledge: global intent tools');
     /**
      * 规则正文由当前会话 preset 决定；设置里的 volatile 引用在每次组装提示词时解包，
      * 因此开关保存后立即生效，不需要重建 Agent 会话。
@@ -806,12 +780,16 @@ export function apply(ctx, pluginConfig = {}) {
             return Promise.resolve({ kind: 'ask', reason: '该操作会写入 Tita Knowledge Store，需要本轮用户审批。' });
         return next();
     });
-    ctx.tools.register(tool('recall_knowledge', 'Recall Wiki Fact and Wiki Way through H2 title and body search. Use the current subquestion as query when seeking a Procedure. Return complete Wiki files with conditions and evidence. Use get_knowledge_cases for historical Case evidence; a past root cause does not establish the current root cause.', { query: { type: 'string', required: true }, limit: { type: 'integer' }, top_k: { type: 'integer' }, top_n: { type: 'integer' }, rerank: { type: 'boolean' }, context_max_chars: { type: 'integer', description: '这次召回的上下文字符上限；省略则用设置里的值（默认 20000，0 = 不限）。超出部分落在系统临时目录，响应里的 budget.overflow_path 就是它的绝对路径 —— 需要更多信息时直接读那个文件。' }, include_problems: { type: 'boolean' }, mode: { type: 'string', enum: ['fts', 'vector', 'hybrid'] }, kb: { type: 'string' }, 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) => withRuntime(args.kb, target => target.recall(args.query, args.top_k ?? args.limit, args.include_problems ?? false, args.mode, lineageOf(args, exec), { contextTopN: args.top_n, rerank: args.rerank, ...(typeof args.context_max_chars === 'number' ? { contextMaxChars: args.context_max_chars } : {}) })), {
+    ctx.tools.register(tool('recall_knowledge', 'Recall Wiki Fact and Wiki Way through H2 title and body search. Use the current subquestion as query when seeking a Procedure. Return complete Wiki files with conditions and evidence. Follow Wiki links with read_knowledge_wiki; browse Object coordinates with its object_id filter. Use get_knowledge_cases for historical Case evidence; a past root cause does not establish the current root cause.', { query: { type: 'string', required: true }, limit: { type: 'integer' }, top_k: { type: 'integer' }, top_n: { type: 'integer' }, rerank: { type: 'boolean' }, context_max_chars: { type: 'integer', description: '这次召回的上下文字符上限；省略则用设置里的值（默认 20000，0 = 不限）。超出部分落在系统临时目录，响应里的 budget.overflow_path 就是它的绝对路径 —— 需要更多信息时直接读那个文件。' }, include_problems: { type: 'boolean' }, mode: { type: 'string', enum: ['fts', 'vector', 'hybrid'] }, kb: { type: 'string' }, 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) => withRuntime(args.kb, async (target) => agentRecallEnvelope(await target.recall(args.query, args.top_k ?? args.limit, args.include_problems ?? false, args.mode, lineageOf(args, exec), { contextTopN: args.top_n, rerank: args.rerank, ...(typeof args.context_max_chars === 'number' ? { contextMaxChars: args.context_max_chars } : {}) }))), {
         call: recallCallView,
         // 查询词从参数来，命中从结果来 —— 两者拼成一张能看懂的账本。
         meta: (args, value) => recallMetaOf({ ...dataOf(value), query: args?.query }),
         result: resultViewOf(recallResultMarkdown),
     }));
+    ctx.tools.register(tool('read_knowledge_wiki', 'Read a complete Wiki through a [[type/entityId|label]] link or stable target. Browse an Object by object_id or unique object name; optional action_id, scene_id and wiki_kind select exact coordinates. Omitted axes mean all; empty axes match empty only. Object browsing returns a paged directory by default. Set include_content to read complete selected files. Follow outgoing links and backlinks as needed; do not fetch every neighbor automatically.', {
+        target: { type: 'string' }, object_id: { type: 'string' }, object: { type: 'string' }, action_id: { type: 'string' }, scene_id: { type: 'string' }, wiki_kind: { type: 'string', enum: ['fact', 'way'] },
+        include_content: { type: 'boolean' }, limit: { type: 'integer' }, offset: { type: 'integer' }, kb: { type: 'string' },
+    }, async (args) => withRuntime(args.kb, target => target.readWiki({ target: args.target, objectId: args.object_id, object: args.object, actionId: args.action_id, sceneId: args.scene_id, wikiKind: args.wiki_kind, includeContent: args.include_content, limit: args.limit, offset: args.offset }))));
     ctx.tools.register(tool('get_knowledge_cases', 'Read historical Case records referenced by Wiki metadata.case_refs. Timelines are evidence from a past instance, not proof of the present diagnosis.', {
         case_ids: { type: 'array', required: true, description: 'Case IDs from Wiki metadata.case_refs; maximum 50 IDs.' },
         version: { type: 'integer', description: 'Optional historical Case version from metadata.case_refs; requires exactly one case ID.' },
@@ -916,10 +894,10 @@ export function apply(ctx, pluginConfig = {}) {
      * 两者的差别只在「一次多少份」，落盘路径、分类闸门、编译链路完全共用 ——
      * 这个工具的 `execute` 就是循环调 `importSources`，而后者逐条调 `addSource`。
      *
-     * `compile` 默认开：批量导入的意图几乎总是「进来就能用」。关掉它的场景是「先全部
-     * 落盘、稍后统一编译」——那时卡片还没生成，工具返回里会明说 `compile: null`。
+     * `compile` 默认关闭：先保存来源，再由调用方决定何时处理。显式 true 才跑全链路；
+     * 未触发处理时工具返回 `compile: null`。
      */
-    ctx.tools.register(tool('import_sources', 'Import many SourceRaw documents in one call. By default only stores sources. Explicit compile:true runs extract, normalize, materialize, and index publication for the imported documents. Per-source import failures are reported without aborting the batch. DSH requests one user approval before execution.', { sources: { type: 'array', required: true, description: `来源数组，每项 { title?, content, external_id?, metadata?, allow_duplicate_title? }；一次最多 ${MAX_IMPORT_SOURCES} 份，超了请分批。标题与已有来源重复的那一份会被拒（SOURCE_TITLE_DUPLICATED），逐条报出来而不是整批失败` }, compile: { type: 'boolean', description: '默认 false：只保存来源；显式 true 才运行完整抽取、归一与物化' }, kb: { type: 'string' }, session_key: { type: 'string' }, task_id: { type: 'string' }, subtask_id: { type: 'string' }, run_id: { type: 'string' }, turn_id: { type: 'string' }, trace_id: { type: 'string' }, domain: { type: 'string' } }, async (args, exec) => withRuntime(args.kb, target => target.importSources({ sources: (Array.isArray(args.sources) ? args.sources : []).map(item => ({ ...(item?.title ? { title: item.title } : {}), content: item?.content, ...(item?.external_id ? { externalId: item.external_id } : {}), ...(item?.metadata ? { metadata: item.metadata } : {}), ...(item?.allow_duplicate_title === true ? { allowDuplicateTitle: true } : {}) })), compile: args.compile === true, lineage: lineageOf(args, exec) })), { call: importCallView, meta: (_args, value) => importMetaOf(dataOf(value)), result: resultViewOf(importResultMarkdown) }));
+    ctx.tools.register(tool('import_sources', 'Import many SourceRaw documents in one call. By default only stores sources. Explicit compile:true runs extract, normalize, materialize, and index publication for the imported documents. Per-source import failures are reported without aborting the batch. DSH requests one user approval before execution.', { sources: { type: 'array', required: true, description: `来源数组，每项 { source_id?, title?, content, external_id?, metadata?, allow_duplicate_title? }；文件导入前分配唯一 source_id，重试沿用；更新旧来源必须传其 source_id；一次最多 ${MAX_IMPORT_SOURCES} 份，超了请分批。标题与已有来源重复的那一份会被拒（SOURCE_TITLE_DUPLICATED），逐条报出来而不是整批失败` }, compile: { type: 'boolean', description: '默认 false：只保存来源；显式 true 才运行完整抽取、归一与物化' }, kb: { type: 'string' }, session_key: { type: 'string' }, task_id: { type: 'string' }, subtask_id: { type: 'string' }, run_id: { type: 'string' }, turn_id: { type: 'string' }, trace_id: { type: 'string' }, domain: { type: 'string' } }, async (args, exec) => withRuntime(args.kb, target => target.importSources({ sources: (Array.isArray(args.sources) ? args.sources : []).map(item => ({ ...(item?.source_id ? { sourceId: item.source_id } : {}), ...(item?.title ? { title: item.title } : {}), content: item?.content, ...(item?.external_id ? { externalId: item.external_id } : {}), ...(item?.metadata ? { metadata: item.metadata } : {}), ...(item?.allow_duplicate_title === true ? { allowDuplicateTitle: true } : {}) })), compile: args.compile === true, lineage: lineageOf(args, exec) })), { call: importCallView, meta: (_args, value) => importMetaOf(dataOf(value)), result: resultViewOf(importResultMarkdown) }));
     /**
      * `propose_wiki_cards` —— 把一批卡片**直接写进 `02_wiki`**（工具名不变，语义在 0044 改了）。
      *
@@ -1063,6 +1041,18 @@ export function apply(ctx, pluginConfig = {}) {
                         return sendEnvelope(res, resolved.failure);
                     return send(res, 200, success(await resolved.runtime.stats()));
                 } },
+            { kind: 'exact', path: '/knowledge/wiki', handler: async (req, res) => {
+                    if (req.method !== 'GET')
+                        return send(res, 405, envelopeError('METHOD_NOT_ALLOWED', 'Wiki 读取只接受 GET'));
+                    const url = query(req);
+                    const resolved = resolveBase(url.searchParams.get('kb'));
+                    if ('failure' in resolved)
+                        return sendEnvelope(res, resolved.failure);
+                    return sendEnvelope(res, await resolved.runtime.readWiki({ target: url.searchParams.get('target') ?? undefined, objectId: url.searchParams.get('object_id') ?? undefined, object: url.searchParams.get('object') ?? undefined,
+                        actionId: url.searchParams.get('action_id') ?? undefined, sceneId: url.searchParams.get('scene_id') ?? undefined, wikiKind: (url.searchParams.get('wiki_kind') ?? undefined),
+                        includeContent: url.searchParams.has('include_content') ? url.searchParams.get('include_content') === 'true' : undefined,
+                        limit: url.searchParams.has('limit') ? Number(url.searchParams.get('limit')) : undefined, offset: url.searchParams.has('offset') ? Number(url.searchParams.get('offset')) : undefined }));
+                } },
             { kind: 'exact', path: '/knowledge/cases', handler: async (req, res) => {
                     if (req.method !== 'GET')
                         return send(res, 405, envelopeError('METHOD_NOT_ALLOWED', 'Case 只接受 GET'));
@@ -1323,8 +1313,10 @@ export function apply(ctx, pluginConfig = {}) {
                             sources: (Array.isArray(body.sources) ? body.sources : []).map((item) => ({
                                 ...(item?.title ? { title: String(item.title) } : {}),
                                 content: item?.content,
+                                ...(item?.source_id ? { sourceId: String(item.source_id) } : {}),
                                 ...(item?.external_id ? { externalId: String(item.external_id) } : {}),
                                 ...(item?.metadata && typeof item.metadata === 'object' ? { metadata: item.metadata } : {}),
+                                ...(item?.allow_duplicate_title === true ? { allowDuplicateTitle: true } : {}),
                             })),
                             compile: body.compile === true,
                             lineage: lineageOf(body),
@@ -1974,7 +1966,6 @@ export function apply(ctx, pluginConfig = {}) {
                          * /knowledge/pages/run?kb=<库 id>&run=<轨迹 id>   一次抽取的完整报告
                          * /knowledge/pages/tasks?kb=<知识库 id>    抽取任务
                          * /knowledge/pages/help/compile             编译链路
-                         * /knowledge/pages/help/intent              意图的逻辑
                          * /knowledge/pages/help/overview?node=...   五个 Tab 的方案说明
                          * ```
                          *
@@ -2003,11 +1994,9 @@ export function apply(ctx, pluginConfig = {}) {
                                     ? '抽取轨迹'
                                     : rest[1] === 'tasks'
                                         ? '抽取任务'
-                                        : rest[1] === 'help' && rest[2] === 'intent'
-                                            ? '意图的逻辑'
-                                            : rest[1] === 'help' && rest[2] === 'compile'
-                                                ? '编译链路'
-                                                : rest[1] === 'help' && rest[2] === 'overview' ? 'Agent 方案说明' : '整页';
+                                        : rest[1] === 'help' && rest[2] === 'compile'
+                                            ? '编译链路'
+                                            : rest[1] === 'help' && rest[2] === 'overview' ? 'Agent 方案说明' : '整页';
                             res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' });
                             res.end(standalonePageHtml(title));
                             return;