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

package/lib/types/intent/store.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 意图的**落盘**（0033）。
+ *
+ * ## 为什么需要它
+ *
+ * 0033 之前，意图的两半都不在磁盘上属于这个 Agent 的地方：
+ *
+ * - **分类 / act 注册表**住在宿主的 settings 文档（`settings.yaml`）里。它确实落盘了，
+ *   但那是**宿主的配置**，不是这个 Agent 的文件 —— 备份知识库不会带上它，换一台机器
+ *   也不跟着走，而它恰恰决定了「同一句话被理解成什么」。
+ * - **每轮记录**只在内存里（`IntentStore` 的 Map，TTL 600 秒）。重启即丢。而架构图上
+ *   写着「意图记录…都已落盘」——**那句话当时是假的**。
+ *
+ * 现在两份东西都在 `<agentRoot>/intent/`：
+ *
+ * ```
+ * <agentRoot>/intent/
+ *   registry.json      分类 / act 词表（可编辑，面板就地改）
+ *   records.ndjson     每轮一条记录，append-only
+ * ```
+ *
+ * ## 为什么记录是 append-only 而不是「覆盖写」
+ *
+ * 记录本身按 `sessionKey#turn` upsert（同一轮重复调用只算一条事实），但**文件是审计
+ * 留痕**：追加每一版比原地覆盖更能回答「这一轮改过什么」。读的时候按同一个 key 取
+ * 最后一条，于是内存里那份「一轮一条」的语义不变，而磁盘上留下了完整过程。
+ *
+ * 代价是文件会随使用增长。这是审计流的固有代价，且它是纯追加、没有读放大 ——
+ * 真到需要清理时应该按时间归档，而不是在这里改成覆盖写。
+ *
+ * @module
+ */
+import type { IntentActDef, IntentRecord } from './types.js';
+/** 注册表文件名。分类与 act 住一起：它们是一份词表的两半，分开存只会漂移。 */
+export declare const INTENT_REGISTRY_FILE = "registry.json";
+/** 记录文件名。NDJSON 而不是 JSON 数组：追加是 O(1)，且半行坏数据只坏一行。 */
+export declare const INTENT_RECORDS_FILE = "records.ndjson";
+export interface IntentRegistryFile {
+    version: 1;
+    acts: IntentActDef[];
+    categories: Array<{
+        id: string;
+        label: string;
+        route: string;
+        description: string;
+        examples: string[];
+        enabled: boolean;
+    }>;
+    updatedAt?: string;
+}
+/**
+ * 读注册表文件。
+ *
+ * **不抛异常**：文件坏了、被手改坏了、写了一半 —— 都返回 `undefined`，调用方按
+ * 出厂预置启动。注册表读不出来不该让整个意图引擎起不来，更不该让插件起不来。
+ */
+export declare function readIntentRegistry(root: string): IntentRegistryFile | undefined;
+/** 写注册表文件。`updatedAt` 由调用方给，便于测试与审计对齐。 */
+export declare function writeIntentRegistry(root: string, registry: {
+    acts: IntentActDef[];
+    categories: IntentRegistryFile['categories'];
+}, updatedAt?: string): IntentRegistryFile;
+/** 追加一条记录。失败不抛：留痕写不进去不该影响这一轮的回答。 */
+export declare function appendIntentRecord(root: string, record: IntentRecord): Promise<void>;
+/**
+ * 读记录（新→旧按时间，返回时升序）。
+ *
+ * 三条纪律：
+ * 1. **坏行只丢它自己。** 追加写天然会留下「最后一行写了一半」的可能（进程被杀），
+ *    一行 JSON.parse 失败不该让整份历史读不出来。
+ * 2. **按 `sessionKey#turnKey` 取最后一条。** 与内存里那份 upsert 语义一致。
+ * 3. `limit` 是**每个会话**的上限，不是总数：面板一次只显示一个会话。
+ */
+export declare function readIntentRecords(root: string, sessionKey?: string, limit?: number): Promise<IntentRecord[]>;
+//# sourceMappingURL=store.d.ts.map

package/lib/types/intent/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/intent/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE5D,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,kBAAkB,CAAA;AACnD,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AAEnD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,YAAY,EAAE,CAAA;IACpB,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC1H,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAqBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAgB/E;AAED,0CAA0C;AAC1C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAAC,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAA;CAAE,EAAE,SAAS,SAA2B,GAAG,kBAAkB,CAI5L;AAED,oCAAoC;AACpC,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1F;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAyB/G"}

package/lib/types/intent/store.js

@@ -0,0 +1,139 @@
+/**
+ * 意图的**落盘**（0033）。
+ *
+ * ## 为什么需要它
+ *
+ * 0033 之前，意图的两半都不在磁盘上属于这个 Agent 的地方：
+ *
+ * - **分类 / act 注册表**住在宿主的 settings 文档（`settings.yaml`）里。它确实落盘了，
+ *   但那是**宿主的配置**，不是这个 Agent 的文件 —— 备份知识库不会带上它，换一台机器
+ *   也不跟着走，而它恰恰决定了「同一句话被理解成什么」。
+ * - **每轮记录**只在内存里（`IntentStore` 的 Map，TTL 600 秒）。重启即丢。而架构图上
+ *   写着「意图记录…都已落盘」——**那句话当时是假的**。
+ *
+ * 现在两份东西都在 `<agentRoot>/intent/`：
+ *
+ * ```
+ * <agentRoot>/intent/
+ *   registry.json      分类 / act 词表（可编辑，面板就地改）
+ *   records.ndjson     每轮一条记录，append-only
+ * ```
+ *
+ * ## 为什么记录是 append-only 而不是「覆盖写」
+ *
+ * 记录本身按 `sessionKey#turn` upsert（同一轮重复调用只算一条事实），但**文件是审计
+ * 留痕**：追加每一版比原地覆盖更能回答「这一轮改过什么」。读的时候按同一个 key 取
+ * 最后一条，于是内存里那份「一轮一条」的语义不变，而磁盘上留下了完整过程。
+ *
+ * 代价是文件会随使用增长。这是审计流的固有代价，且它是纯追加、没有读放大 ——
+ * 真到需要清理时应该按时间归档，而不是在这里改成覆盖写。
+ *
+ * @module
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+/** 注册表文件名。分类与 act 住一起：它们是一份词表的两半，分开存只会漂移。 */
+export const INTENT_REGISTRY_FILE = 'registry.json';
+/** 记录文件名。NDJSON 而不是 JSON 数组：追加是 O(1)，且半行坏数据只坏一行。 */
+export const INTENT_RECORDS_FILE = 'records.ndjson';
+/**
+ * 原子写：先写 `.tmp` 再 rename。半截的 registry.json 会让引擎按出厂预置启动。
+ *
+ * **同步**，与 `migrate.ts` 同一个理由：注册表的读发生在**设置解析的回调里**
+ * （`setSource` → `apply()` → 灌进引擎），而那条路径必须同步完成 —— 异步化会让
+ * 「设置改了，引擎还是旧的」重新出现，而且窗口期随磁盘快慢变化。文件只有几 KB，
+ * 一次启动读一次。
+ */
+function writeAtomicSync(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    const temp = `${path}.tmp`;
+    writeFileSync(temp, content, 'utf8');
+    renameSync(temp, path);
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 读注册表文件。
+ *
+ * **不抛异常**：文件坏了、被手改坏了、写了一半 —— 都返回 `undefined`，调用方按
+ * 出厂预置启动。注册表读不出来不该让整个意图引擎起不来，更不该让插件起不来。
+ */
+export function readIntentRegistry(root) {
+    const path = join(root, INTENT_REGISTRY_FILE);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (!isPlainObject(parsed))
+            return undefined;
+        if (!Array.isArray(parsed.acts) || !Array.isArray(parsed.categories))
+            return undefined;
+        return {
+            version: 1,
+            acts: parsed.acts,
+            categories: parsed.categories,
+            ...(typeof parsed.updatedAt === 'string' ? { updatedAt: parsed.updatedAt } : {}),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 写注册表文件。`updatedAt` 由调用方给，便于测试与审计对齐。 */
+export function writeIntentRegistry(root, registry, updatedAt = new Date().toISOString()) {
+    const payload = { version: 1, acts: registry.acts, categories: registry.categories, updatedAt };
+    writeAtomicSync(join(root, INTENT_REGISTRY_FILE), `${JSON.stringify(payload, null, 2)}\n`);
+    return payload;
+}
+/** 追加一条记录。失败不抛：留痕写不进去不该影响这一轮的回答。 */
+export async function appendIntentRecord(root, record) {
+    try {
+        await mkdir(root, { recursive: true });
+        await appendFile(join(root, INTENT_RECORDS_FILE), `${JSON.stringify(record)}\n`, 'utf8');
+    }
+    catch { /* 磁盘满 / 只读卷：这一轮照常回答，留痕缺失 */ }
+}
+/**
+ * 读记录（新→旧按时间，返回时升序）。
+ *
+ * 三条纪律：
+ * 1. **坏行只丢它自己。** 追加写天然会留下「最后一行写了一半」的可能（进程被杀），
+ *    一行 JSON.parse 失败不该让整份历史读不出来。
+ * 2. **按 `sessionKey#turnKey` 取最后一条。** 与内存里那份 upsert 语义一致。
+ * 3. `limit` 是**每个会话**的上限，不是总数：面板一次只显示一个会话。
+ */
+export async function readIntentRecords(root, sessionKey, limit = 200) {
+    const path = join(root, INTENT_RECORDS_FILE);
+    if (!existsSync(path))
+        return [];
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const latest = new Map();
+    for (const line of text.split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!isPlainObject(record) || typeof record.sessionKey !== 'string' || typeof record.turnKey !== 'string')
+            continue;
+        if (sessionKey !== undefined && record.sessionKey !== sessionKey)
+            continue;
+        latest.set(`${record.sessionKey}#${record.turnKey}`, record);
+    }
+    return [...latest.values()]
+        .sort((left, right) => String(left.updatedAt ?? left.createdAt).localeCompare(String(right.updatedAt ?? right.createdAt)))
+        .slice(-limit);
+}
+//# sourceMappingURL=store.js.map

package/lib/types/intent/store.js.map

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

package/lib/types/intent/tools.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 三个 `intent_*` 工具的**注册器**：与「引擎住在哪个平面」解耦。
+ *
+ * ## 为什么要单独一个文件
+ *
+ * 0029 之前这三个工具由宿主平面的 `applyIntent` 直接 `ctx.tools.register(...)`，
+ * 于是它们是**全局工具**：任何 agent、任何 preset 的会话都会在提示词里看到
+ * `intent_record`，也都能调它。而意图记录是这个方案自己的东西 —— 只有跑
+ * TitaAgent 那套组合的会话才该有它，别的 agent 场景（别的 preset、临时会话）
+ * 不该被塞一个用不上的工具。
+ *
+ * DSH 里「只有某个 preset 能用」的**唯一**支持形态是**注册作用域**：注册在哪个
+ * 作用域，就只在哪个作用域可见（`dsh-tools` 的 `register` 是 scope-layered）。
+ * `ctx.tools.restrict()` 只能做减法（从继承来的工具里减掉），宿主平面调它还会
+ * 直接抛 —— 没有「只给某一个作用域」的正向开关。所以正确的做法是把注册搬到
+ * **agent 平面**：一个只被自定义 preset 的 `agent.cordis.yml` 挂载的行
+ * （`./preset-tools.ts`），它注册的工具只覆盖那个 preset 的会话。
+ *
+ * 注册逻辑本身与平面无关，所以它留在这里：宿主平面负责「引擎怎么跑」（设置、
+ * 轮次记账、HTTP 只读面），agent 平面负责「模型看到什么工具」。两边共用这一份，
+ * 不各写一套工具定义。
+ *
+ * @module
+ */
+import { type ToolRunContext } from '@deepseek-ai/dsh-tools';
+import type { LineageContext } from 'dsh-data-contracts/refs';
+/**
+ * 注册这三个工具需要引擎提供的能力。
+ *
+ * 刻意是**结构化的最小面**而不是 `IntentEngine` 本身：宿主平面通过
+ * `INTENT_SERVICE` 提供它，agent 平面的行只按这个形状取用。这样 preset 行不必
+ * import 引擎、也不必知道引擎住在哪个模块里。
+ */
+export interface IntentToolHost {
+    /** `intent_record` 的**工具描述就是路由提示词**（0023）。 */
+    routingPrompt(): string;
+    record(args: Record<string, unknown>, exec?: ToolRunContext): unknown;
+    view(sessionKey: string, includePrompt?: boolean): unknown;
+    registry(): unknown;
+    /** 提示词 / 词表变化时通知，返回取消订阅。 */
+    subscribe(listener: () => void): () => void;
+}
+/** 工具的最小注册面。测试替身与真实 `ctx` 都满足它。 */
+export interface ToolRegistryLike {
+    register(definition: unknown): unknown;
+}
+export declare function jsonTool(name: string, description: string, parameters: Record<string, unknown>, execute: (args: any, exec?: ToolRunContext) => unknown): import("@deepseek-ai/dsh-tools").ToolDefinition;
+export declare function lineageOf(args: Record<string, unknown>, exec?: ToolRunContext): Partial<LineageContext> | undefined;
+export declare function sessionKeyOf(args: Record<string, unknown>, exec?: ToolRunContext): string;
+/**
+ * 注册三个 `intent_*` 工具，返回一个把三者一起撤掉的 disposer。
+ *
+ * `intent_record` 的描述是**动态**的：分类 / act 词表可以在设置里改，而工具描述
+ * 是静态字符串。所以设置一变就 dispose 旧的、按新文本重新注册 —— 下一轮模型看到
+ * 的规则就是新的。这是「保存后下一轮生效」在工具这一侧的实现。
+ *
+ * 类型守卫（`typeof disposer === 'function'`）是因为测试替身的 `register` 不一定
+ * 返回 disposer。
+ */
+export declare function registerIntentTools(ctx: {
+    tools: ToolRegistryLike;
+}, host: IntentToolHost): () => void;
+//# sourceMappingURL=tools.d.ts.map

package/lib/types/intent/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/intent/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,aAAa,IAAI,MAAM,CAAA;IACvB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAA;IACrE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IAC1D,QAAQ,IAAI,OAAO,CAAA;IACnB,4BAA4B;IAC5B,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAsBD,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAA;CACvC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,OAAO,mDAMtJ;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAUnH;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAGzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,gBAAgB,CAAA;CAAE,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,IAAI,CAiCtG"}

package/lib/types/intent/tools.js

@@ -0,0 +1,108 @@
+/**
+ * 三个 `intent_*` 工具的**注册器**：与「引擎住在哪个平面」解耦。
+ *
+ * ## 为什么要单独一个文件
+ *
+ * 0029 之前这三个工具由宿主平面的 `applyIntent` 直接 `ctx.tools.register(...)`，
+ * 于是它们是**全局工具**：任何 agent、任何 preset 的会话都会在提示词里看到
+ * `intent_record`，也都能调它。而意图记录是这个方案自己的东西 —— 只有跑
+ * TitaAgent 那套组合的会话才该有它，别的 agent 场景（别的 preset、临时会话）
+ * 不该被塞一个用不上的工具。
+ *
+ * DSH 里「只有某个 preset 能用」的**唯一**支持形态是**注册作用域**：注册在哪个
+ * 作用域，就只在哪个作用域可见（`dsh-tools` 的 `register` 是 scope-layered）。
+ * `ctx.tools.restrict()` 只能做减法（从继承来的工具里减掉），宿主平面调它还会
+ * 直接抛 —— 没有「只给某一个作用域」的正向开关。所以正确的做法是把注册搬到
+ * **agent 平面**：一个只被自定义 preset 的 `agent.cordis.yml` 挂载的行
+ * （`./preset-tools.ts`），它注册的工具只覆盖那个 preset 的会话。
+ *
+ * 注册逻辑本身与平面无关，所以它留在这里：宿主平面负责「引擎怎么跑」（设置、
+ * 轮次记账、HTTP 只读面），agent 平面负责「模型看到什么工具」。两边共用这一份，
+ * 不各写一套工具定义。
+ *
+ * @module
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+/** `intent_record` 的参数表。描述是路由提示词（工具级），所以这里只声明字段。 */
+const INTENT_RECORD_PARAMS = {
+    user_input: { type: 'string', required: true, description: '本轮用户原文' },
+    act: { type: 'string', description: '本轮动作 id，取自工具描述里的 act 词表' },
+    category: { type: 'string', description: '意图分类 id：先按预置分类匹配，命中就直接用它的 id；全不命中才自行新起一个 id 或落 unknown' },
+    predicate: { type: 'string', description: '要执行的动作，例如 query_babel_data' },
+    slots: { type: 'json', description: '从用户输入抽取的关键参数' },
+    confidence: { type: 'number', description: '0-1，用于标注 lowConfidence' },
+    refs: { type: 'array', description: '引用对象，例如 { id, kind, label }' },
+    relation: { type: 'string', enum: ['new_task', 'subtask_of'], description: '本轮是新任务还是已有任务的子任务' },
+    session_key: { type: 'string' },
+    turn_id: { type: 'string', description: '当前对话轮次 id；不传则由 Host 生成' },
+    task_id: { type: 'string', description: 'relation=subtask_of 时指向的已有业务任务 id；新任务不传' },
+    subtask_id: { type: 'string', description: '已有子任务 id；新子任务不传，由 Host 生成' },
+    parent_subtask_id: { type: 'string', description: '父任务节点 id；通常由 Host 生成' },
+    run_id: { type: 'string', description: '已有执行尝试 id；重试时传新值' },
+    trace_id: { type: 'string' },
+    domain: { type: 'string' },
+};
+export function jsonTool(name, description, parameters, execute) {
+    return defineTool({
+        name, description, parameters: parameters,
+        output: { schema: { type: 'json' }, render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }] },
+        execute: async (args, exec) => execute(args, exec),
+    });
+}
+export 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'], ['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();
+    return Object.keys(lineage).length > 0 ? lineage : undefined;
+}
+export function sessionKeyOf(args, exec) {
+    const explicit = typeof args.session_key === 'string' ? args.session_key.trim() : '';
+    return explicit || exec?.agent?.session.header.id || 'default';
+}
+/**
+ * 注册三个 `intent_*` 工具，返回一个把三者一起撤掉的 disposer。
+ *
+ * `intent_record` 的描述是**动态**的：分类 / act 词表可以在设置里改，而工具描述
+ * 是静态字符串。所以设置一变就 dispose 旧的、按新文本重新注册 —— 下一轮模型看到
+ * 的规则就是新的。这是「保存后下一轮生效」在工具这一侧的实现。
+ *
+ * 类型守卫（`typeof disposer === 'function'`）是因为测试替身的 `register` 不一定
+ * 返回 disposer。
+ */
+export function registerIntentTools(ctx, host) {
+    let disposeRecord;
+    let registeredDescription = '';
+    const ensureRecordTool = () => {
+        const description = host.routingPrompt();
+        if (registeredDescription === description && disposeRecord)
+            return;
+        disposeRecord?.();
+        disposeRecord = undefined;
+        registeredDescription = description;
+        const disposer = ctx.tools.register(jsonTool('intent_record', description, INTENT_RECORD_PARAMS, (args, exec) => host.record(args, exec)));
+        if (typeof disposer === 'function')
+            disposeRecord = disposer;
+    };
+    ensureRecordTool();
+    const disposeView = ctx.tools.register(jsonTool('intent_store_view', 'View recent intent records and the active task ids for the current session.', { session_key: { type: 'string' }, include_prompt: { type: 'boolean' } }, (args, exec) => host.view(sessionKeyOf(args, exec), args.include_prompt)));
+    const disposeRegistry = ctx.tools.register(jsonTool('intent_registry_list', 'List the configured intent acts, categories and predicates together with the routing prompt that ships as the intent_record tool description.', {}, () => host.registry()));
+    const unsubscribe = host.subscribe(ensureRecordTool);
+    return () => {
+        unsubscribe();
+        disposeRecord?.();
+        disposeRecord = undefined;
+        if (typeof disposeView === 'function')
+            disposeView();
+        if (typeof disposeRegistry === 'function')
+            disposeRegistry();
+    };
+}
+//# sourceMappingURL=tools.js.map

package/lib/types/intent/tools.js.map

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

package/lib/types/intent/types.d.ts

@@ -0,0 +1,189 @@
+import type { ToolStatus } from 'dsh-data-contracts/envelope';
+import type { LineageContext } from 'dsh-data-contracts/refs';
+export type { ToolStatus };
+/**
+ * 一个动作类型（act）。
+ *
+ * act 回答"这一轮用户在**做什么**"，与 category（做什么**业务**）正交：同一句
+ * "帮我看下上个月的 GMV" 是 `query` × `data_analysis`。光有 id 时模型只能猜
+ * `query` 和 `request` 的区别，所以每一类都带 label 与 description。
+ */
+export interface IntentActDef {
+    id: string;
+    label: string;
+    description: string;
+    enabled: boolean;
+}
+/**
+ * 出厂 act 词表。16 个动作覆盖"提问 / 让做 / 补充 / 反馈 / 终止 / 闲聊"六种交互。
+ *
+ * 记录仍是自由文本（模型可以写没配置过的 act，只给 warning），这份词表是**先验**：
+ * 它进 routing prompt，也进设置页与 `intent_registry_list`。
+ */
+export declare const DEFAULT_ACTS: IntentActDef[];
+/** Free-form act id; configured in `IntentSettings.acts`. */
+export type IntentAct = string;
+/** How one turn relates to the session's existing tasks. */
+export type IntentRelation = 'new_task' | 'subtask_of' | 'unknown';
+/** `model` is a model-authored record; `fallback` is the Host's turn-end backfill. */
+export type IntentSource = 'model' | 'fallback';
+export interface IntentSlotMap {
+    [name: string]: unknown;
+}
+export interface IntentRef {
+    id: string;
+    kind?: string;
+    label?: string;
+}
+/**
+ * One configurable intent category; `route` names the act it usually maps to.
+ *
+ * 预置分类的作用是**把模型的自由判断收窄成一次匹配**：
+ * {@link description} 说明这一类"是什么"，{@link examples} 给出用户可能怎么说。
+ * 两者都会被拼进 routing prompt，模型先按它们匹配，命中就直接用该 id。
+ */
+export interface IntentCategory {
+    id: string;
+    label: string;
+    route: string;
+    description: string;
+    /**
+     * 预置说法（few-shot）：用户可能怎么表达这一类意图，每行一条。
+     *
+     * 可选——0012 时代的持久化配置没有这个字段，缺省按空数组处理，注册表 schema
+     * 也会补默认值。
+     */
+    examples?: string[];
+    enabled: boolean;
+}
+/**
+ * Recorder settings. The classification vocabulary is user-editable: nothing
+ * here constrains what a model may record, it only describes the options the
+ * routing prompt offers and what `intent_registry_list` reports.
+ */
+export interface IntentSettings {
+    /** Below this confidence a record is annotated lowConfidence; the model decides whether to clarify. */
+    clarifyThreshold: number;
+    ttlSeconds: number;
+    /**
+     * 0023：路由提示词**没有开关**。它随 `intent_record` 的工具描述一起下发，
+     * 分类规则必须始终在场——否则模型退化成每轮从零判断。
+     */
+    /** Backfill one `unknown` record when a turn ends without a model record. */
+    fallbackEnabled: boolean;
+    categories: IntentCategory[];
+    acts: IntentActDef[];
+    predicates: string[];
+}
+/**
+ * 出厂预置的意图分类。
+ *
+ * 每一项都**必须**带 `description` 与 `examples`：只给标签（"数据分析"）时模型
+ * 只能靠猜，同一句话在不同轮次会被分到不同类。这些文案是模型的匹配依据，全部
+ * 可以在「意图」页里改。
+ */
+export declare const DEFAULT_CATEGORIES: Array<IntentCategory & {
+    examples: string[];
+}>;
+export declare const DEFAULT_PREDICATES: string[];
+export declare const DEFAULT_INTENT_SETTINGS: IntentSettings;
+/** One recorded intent. The record is an audit fact; it never drives control flow. */
+export interface IntentRecord {
+    id: string;
+    sessionKey: string;
+    /** `sessionKey#turn` — the upsert key that keeps one record per turn. */
+    turnKey: string;
+    turnId: string;
+    userInput: string;
+    act: IntentAct;
+    category?: string;
+    predicate?: string;
+    slots: IntentSlotMap;
+    confidence?: number;
+    lowConfidence?: boolean;
+    refs: IntentRef[];
+    relation: IntentRelation;
+    source: IntentSource;
+    createdAt: string;
+    updatedAt: string;
+    lineage: LineageContext;
+    meta: Record<string, unknown>;
+}
+export interface IntentRecordInput {
+    userInput: string;
+    act?: string;
+    category?: string;
+    predicate?: string;
+    slots?: IntentSlotMap;
+    confidence?: number;
+    refs?: IntentRef[];
+    relation?: IntentRelation;
+    sessionKey: string;
+    turnId?: string;
+    lineage?: Partial<LineageContext>;
+    now?: number;
+}
+/** Compact task context returned to the model so it can pick the next relation. */
+export interface IntentTaskSummary {
+    taskId: string;
+    lastSubtaskId?: string;
+    category?: string;
+    ageSeconds: number;
+}
+export interface IntentRegistry {
+    /** 可编辑的 act 词表（带 label / description），面板就地增删改。 */
+    acts: IntentActDef[];
+    /**
+     * 可用的意图分类。带 `description` / `examples`，因为「意图」页要就地编辑它们，
+     * 而不是只渲染成一组只读徽标。
+     */
+    categories: Array<{
+        id: string;
+        label: string;
+        route: string;
+        description: string;
+        examples: string[];
+        enabled: boolean;
+    }>;
+    predicates: string[];
+}
+export interface IntentStoreView {
+    sessionKey: string;
+    activeTaskId?: string;
+    activeIntentId?: string;
+    tasks: IntentTaskSummary[];
+    recent: IntentRecord[];
+    expiresAt?: string;
+}
+export interface IntentResultData {
+    intentId?: string;
+    taskId?: string;
+    subtaskId?: string;
+    parentSubtaskId?: string;
+    runId?: string;
+    turnId?: string;
+    act?: string;
+    category?: string;
+    relation?: IntentRelation;
+    source?: IntentSource;
+    lowConfidence?: boolean;
+    activeTasks?: IntentTaskSummary[];
+    store?: IntentStoreView;
+    registry?: IntentRegistry;
+    prompt?: string;
+}
+export interface IntentResult {
+    ok: boolean;
+    status: ToolStatus;
+    data: IntentResultData;
+    warnings: string[];
+}
+/** Live turn state: the provisional ids allocated before the model records. */
+export interface IntentTurnState {
+    turn: number;
+    userInput: string;
+    subtaskId: string;
+    taskId?: string;
+    committed: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/intent/types.d.ts.map

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