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

package/lib/types/intent/store.js

@@ -1,239 +0,0 @@
-/**
- * 意图审计的持久化层。
- *
- * 意图是 agent / session 级数据，不属于某一个知识库，所以它放在：
- *
- *   <agentRoot>/intent/intent.db
- *
- * SQLite 里有两张记录表：
- *
- * - `intent_records`：按 `session_key + turn_key` 保存当前版本，供面板与会话恢复读取；
- * - `intent_record_history`：每次保存都追加一版，保留审计轨迹。
- *
- * 旧版本的 `records.ndjson` 只作为一次性迁移输入，不再继续写入。
- */
-import { existsSync } from 'node:fs';
-import { mkdir, readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { loadSqlite } from '../fts.js';
-/** 新的持久化文件。 */
-export const INTENT_DB_FILE = 'intent.db';
-/** 迁移旧版本时仍会读取这个文件，但新写入不再使用它。 */
-export const INTENT_RECORDS_FILE = 'records.ndjson';
-const SCHEMA_VERSION = 1;
-const writeQueues = new Map();
-function dbPath(root) {
-    return join(root, INTENT_DB_FILE);
-}
-function isPlainObject(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-function asRecord(value) {
-    if (!isPlainObject(value))
-        return undefined;
-    if (typeof value.sessionKey !== 'string' || typeof value.turnKey !== 'string')
-        return undefined;
-    return value;
-}
-function schemaSql() {
-    return `
-    CREATE TABLE IF NOT EXISTS intent_records (
-      session_key TEXT NOT NULL,
-      turn_key TEXT NOT NULL,
-      record_id TEXT NOT NULL,
-      updated_at TEXT NOT NULL,
-      payload_json TEXT NOT NULL,
-      PRIMARY KEY (session_key, turn_key)
-    );
-    CREATE INDEX IF NOT EXISTS idx_intent_records_session_updated
-      ON intent_records (session_key, updated_at);
-    CREATE TABLE IF NOT EXISTS intent_record_history (
-      revision_id INTEGER PRIMARY KEY AUTOINCREMENT,
-      session_key TEXT NOT NULL,
-      turn_key TEXT NOT NULL,
-      record_id TEXT NOT NULL,
-      updated_at TEXT NOT NULL,
-      payload_json TEXT NOT NULL
-    );
-    CREATE INDEX IF NOT EXISTS idx_intent_history_session_updated
-      ON intent_record_history (session_key, updated_at);
-    CREATE TABLE IF NOT EXISTS intent_store_meta (
-      key TEXT PRIMARY KEY,
-      value TEXT NOT NULL
-    );
-    PRAGMA user_version = ${SCHEMA_VERSION};
-  `;
-}
-function updatedAtOf(record) {
-    return String(record.updatedAt ?? record.createdAt ?? '');
-}
-function insertRecord(db, record, history) {
-    const payload = JSON.stringify(record);
-    const updatedAt = updatedAtOf(record);
-    if (history) {
-        db.prepare(`
-      INSERT INTO intent_record_history
-        (session_key, turn_key, record_id, updated_at, payload_json)
-      VALUES (?, ?, ?, ?, ?)
-    `).run(record.sessionKey, record.turnKey, record.id, updatedAt, payload);
-    }
-    db.prepare(`
-    INSERT INTO intent_records
-      (session_key, turn_key, record_id, updated_at, payload_json)
-    VALUES (?, ?, ?, ?, ?)
-    ON CONFLICT(session_key, turn_key) DO UPDATE SET
-      record_id = excluded.record_id,
-      updated_at = excluded.updated_at,
-      payload_json = excluded.payload_json
-  `).run(record.sessionKey, record.turnKey, record.id, updatedAt, payload);
-}
-async function readLegacyRecords(root) {
-    const path = join(root, INTENT_RECORDS_FILE);
-    if (!existsSync(path))
-        return [];
-    let text;
-    try {
-        text = await readFile(path, 'utf8');
-    }
-    catch {
-        return [];
-    }
-    const records = [];
-    for (const line of text.split(/\r?\n/)) {
-        if (!line.trim())
-            continue;
-        try {
-            const record = asRecord(JSON.parse(line));
-            if (record)
-                records.push(record);
-        }
-        catch {
-            // 旧 JSONL 的最后半行可能是不完整的，只跳过这一行。
-        }
-    }
-    return records;
-}
-async function migrateLegacyIfNeeded(db, root) {
-    const marker = db.prepare('SELECT value FROM intent_store_meta WHERE key = ?').get('legacy_ndjson_migrated');
-    if (marker?.value === '1')
-        return;
-    const legacy = await readLegacyRecords(root);
-    db.exec('BEGIN');
-    try {
-        for (const record of legacy)
-            insertRecord(db, record, true);
-        db.prepare('INSERT OR REPLACE INTO intent_store_meta (key, value) VALUES (?, ?)').run('legacy_ndjson_migrated', '1');
-        db.exec('COMMIT');
-    }
-    catch (error) {
-        try {
-            db.exec('ROLLBACK');
-        }
-        catch { /* ignore rollback failure */ }
-        throw error;
-    }
-}
-async function openIntentDb(root) {
-    const sqlite = await loadSqlite();
-    if (!sqlite)
-        return null;
-    let db;
-    try {
-        await mkdir(root, { recursive: true });
-        db = new sqlite.DatabaseSync(dbPath(root));
-        db.exec('PRAGMA busy_timeout = 5000');
-        db.exec('PRAGMA journal_mode = WAL');
-        db.exec(schemaSql());
-        await migrateLegacyIfNeeded(db, root);
-        return db;
-    }
-    catch {
-        try {
-            db?.close();
-        }
-        catch { /* ignore close failure */ }
-        return null;
-    }
-}
-async function waitForWrites(path) {
-    await writeQueues.get(path)?.catch(() => undefined);
-}
-/**
- * 保存一条意图记录。
- *
- * 同一根目录的写入串行化，避免多个工具调用同时打开 SQLite 时互相抢写锁。
- * 持久化失败只影响留痕，不影响当前回答。
- */
-export async function appendIntentRecord(root, record) {
-    const path = dbPath(root);
-    const previous = writeQueues.get(path) ?? Promise.resolve();
-    const next = previous.catch(() => undefined).then(async () => {
-        const db = await openIntentDb(root);
-        if (!db)
-            return;
-        try {
-            db.exec('BEGIN IMMEDIATE');
-            insertRecord(db, record, true);
-            db.exec('COMMIT');
-        }
-        catch {
-            try {
-                db.exec('ROLLBACK');
-            }
-            catch { /* ignore rollback failure */ }
-        }
-        finally {
-            try {
-                db.close();
-            }
-            catch { /* already closed */ }
-        }
-    });
-    writeQueues.set(path, next);
-    try {
-        await next;
-    }
-    finally {
-        if (writeQueues.get(path) === next)
-            writeQueues.delete(path);
-    }
-}
-/**
- * 读取当前版本。
- *
- * `limit` 是每个会话的上限，不是全库总数；返回按更新时间升序，面板再反转显示最近一条。
- */
-export async function readIntentRecords(root, sessionKey, limit = 200) {
-    const path = dbPath(root);
-    await waitForWrites(path);
-    const db = await openIntentDb(root);
-    if (!db)
-        return [];
-    try {
-        const rows = sessionKey === undefined
-            ? db.prepare('SELECT payload_json FROM intent_records ORDER BY updated_at DESC LIMIT ?').all(Math.max(0, Math.round(limit)))
-            : db.prepare('SELECT payload_json FROM intent_records WHERE session_key = ? ORDER BY updated_at DESC LIMIT ?').all(sessionKey, Math.max(0, Math.round(limit)));
-        return rows.flatMap(row => {
-            const payload = row.payload_json;
-            if (typeof payload !== 'string')
-                return [];
-            try {
-                const record = asRecord(JSON.parse(payload));
-                return record ? [record] : [];
-            }
-            catch {
-                return [];
-            }
-        }).reverse();
-    }
-    catch {
-        return [];
-    }
-    finally {
-        try {
-            db.close();
-        }
-        catch { /* already closed */ }
-    }
-}
-//# sourceMappingURL=store.js.map

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

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

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

@@ -1,62 +0,0 @@
-/**
- * 两个 `intent_*` 工具的**注册器**：与「引擎住在哪个平面」解耦。
- *
- * ## 为什么要单独一个文件
- *
- * 工具由 Host 层注册，因此可以被标准模式调用。由于 Host 工具也可能出现在其他 preset
- * 中，执行端会检查会话，只接受 `standard`。
- *
- * @module
- */
-import { type ToolRunContext } from '@deepseek-ai/dsh-tools';
-import type { LineageContext } from '#contracts';
-/**
- * 注册这两个工具需要引擎提供的能力。
- *
- * 刻意是**结构化的最小面**而不是 `IntentEngine` 本身：宿主平面通过
- * `INTENT_SERVICE` 提供它，注册器只按这个形状使用引擎，不依赖其具体实现位置。
- */
-export interface IntentToolHost {
-    /** `intent_record` 的**工具描述就是路由提示词**（0023）。 */
-    routingPrompt(): string;
-    record(args: Record<string, unknown>, exec?: ToolRunContext): unknown;
-    view(sessionKey: string, includePrompt?: boolean): unknown;
-}
-/** 工具的最小注册面。测试替身与真实 `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(exec?: ToolRunContext): string | undefined;
-/**
- * 这个会话是不是**子代理**。
- *
- * 子代理会加入父会话的组合，所以它会继承到 `intent_*` 两个工具。而意图记录描述的是
- * 「用户在跟 Agent 要什么」：子代理做的是被拆出来的一个片段，它记一条只会污染任务树。
- *
- * 这条规矩原来写在 preset 的 delegation 行上（`toolFilter: { deny: [...] }`）。DSH 0.1.8
- * 起 `toolFilter`（与 `persona`）**不再被 `dsh-tool-subagent` 接受** —— 带上它的 preset
- * 直接挂载失败，整个组合都不会生效。平台给的替代是「在 Agent Preset 里配好工具，再用
- * `agentPreset` 选中它」，而那**只对 spawn provider 有效**：fork / codex / claude-code
- * 的子会话按定义继承父会话的组合，没有选择余地（`inheritsParentContext` 直接拒绝）。
- *
- * 所以判据搬进工具本身：看会话头，与「谁把子会话拉起来的」无关。四个 provider 一视同仁，
- * 也不会再出现「新增一个 delegation 行忘了 deny」这种漏法。
- *
- * 判据取两个字段：`origin === 'subagent'` 是产品分类，`delegationDepth > 0` 是递归深度
- * （持久化过，重启后仍然成立）。任一条成立就算子会话。
- */
-export declare function isSubagentSession(exec?: ToolRunContext): boolean;
-/**
- * 注册两个 `intent_*` 工具，返回一个把两者一起撤掉的 disposer。
- *
- * `intent_record` 的描述来自固定的会话审计契约，不依赖设置或注册表。
- *
- * 类型守卫（`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

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/intent/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD;;;;;GAKG;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;CAC3D;AAqBD,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,CAWnH;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAKhE;AAWD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,gBAAgB,CAAA;CAAE,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,IAAI,CAgCtG"}

package/lib/types/intent/tools.js

@@ -1,130 +0,0 @@
-/**
- * 两个 `intent_*` 工具的**注册器**：与「引擎住在哪个平面」解耦。
- *
- * ## 为什么要单独一个文件
- *
- * 工具由 Host 层注册，因此可以被标准模式调用。由于 Host 工具也可能出现在其他 preset
- * 中，执行端会检查会话，只接受 `standard`。
- *
- * @module
- */
-import { defineTool } from '@deepseek-ai/dsh-tools';
-import { envelopeFailure } from '#contracts';
-import { isIntentAgentSession } from './scope.js';
-/** `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: '本轮是新任务还是已有任务的子任务' },
-    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 = {};
-    // Session identity is execution context, never model-controlled input.
-    const sessionId = 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(exec) {
-    const sessionId = exec?.agent?.session?.header?.id;
-    return typeof sessionId === 'string' && sessionId.trim() ? sessionId.trim() : undefined;
-}
-/**
- * 这个会话是不是**子代理**。
- *
- * 子代理会加入父会话的组合，所以它会继承到 `intent_*` 两个工具。而意图记录描述的是
- * 「用户在跟 Agent 要什么」：子代理做的是被拆出来的一个片段，它记一条只会污染任务树。
- *
- * 这条规矩原来写在 preset 的 delegation 行上（`toolFilter: { deny: [...] }`）。DSH 0.1.8
- * 起 `toolFilter`（与 `persona`）**不再被 `dsh-tool-subagent` 接受** —— 带上它的 preset
- * 直接挂载失败，整个组合都不会生效。平台给的替代是「在 Agent Preset 里配好工具，再用
- * `agentPreset` 选中它」，而那**只对 spawn provider 有效**：fork / codex / claude-code
- * 的子会话按定义继承父会话的组合，没有选择余地（`inheritsParentContext` 直接拒绝）。
- *
- * 所以判据搬进工具本身：看会话头，与「谁把子会话拉起来的」无关。四个 provider 一视同仁，
- * 也不会再出现「新增一个 delegation 行忘了 deny」这种漏法。
- *
- * 判据取两个字段：`origin === 'subagent'` 是产品分类，`delegationDepth > 0` 是递归深度
- * （持久化过，重启后仍然成立）。任一条成立就算子会话。
- */
-export function isSubagentSession(exec) {
-    const header = exec?.agent?.session?.header;
-    if (!header)
-        return false;
-    if (header.origin === 'subagent')
-        return true;
-    return typeof header.delegationDepth === 'number' && header.delegationDepth > 0;
-}
-/** 子代理调这两个工具时统一回这一条：说清为什么，并给出该走的路。 */
-function subagentRefusal() {
-    return envelopeFailure({ sessionKey: null }, {
-        code: 'SUBAGENT_NOT_RECORDED',
-        message: '子代理不记录意图：意图描述的是用户与主 Agent 的交互。把要记的内容写进返回结果，由主 Agent 记录。',
-        retryable: false,
-    });
-}
-/**
- * 注册两个 `intent_*` 工具，返回一个把两者一起撤掉的 disposer。
- *
- * `intent_record` 的描述来自固定的会话审计契约，不依赖设置或注册表。
- *
- * 类型守卫（`typeof disposer === 'function'`）是因为测试替身的 `register` 不一定
- * 返回 disposer。
- */
-export function registerIntentTools(ctx, host) {
-    const disposeRecord = ctx.tools.register(jsonTool('intent_record', host.routingPrompt(), INTENT_RECORD_PARAMS, (args, exec) => (isSubagentSession(exec) ? subagentRefusal() : host.record(args, exec))));
-    const disposeView = ctx.tools.register(jsonTool('intent_store_view', 'View recent intent records and active task ids for the current session. Only standard sessions can use this tool.', { include_prompt: { type: 'boolean' } }, (args, exec) => {
-        if (isSubagentSession(exec))
-            return subagentRefusal();
-        const session = exec?.agent?.session;
-        if (session && !isIntentAgentSession(session)) {
-            return envelopeFailure({ sessionKey: null }, {
-                code: 'INTENT_PRESET_UNSUPPORTED',
-                message: '意图记录只支持标准模式。',
-                retryable: false,
-            });
-        }
-        const sessionKey = sessionKeyOf(exec);
-        if (!sessionKey) {
-            return envelopeFailure({ sessionKey: null }, {
-                code: 'SESSION_CONTEXT_REQUIRED',
-                message: '意图记录只能在有活动 DSH 会话的上下文中读取。',
-                retryable: false,
-            });
-        }
-        return host.view(sessionKey, args.include_prompt);
-    }));
-    return () => {
-        if (typeof disposeRecord === 'function')
-            disposeRecord();
-        if (typeof disposeView === 'function')
-            disposeView();
-    };
-}
-//# sourceMappingURL=tools.js.map

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

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

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

@@ -1,170 +0,0 @@
-import type { ToolStatus } from '#contracts';
-import type { LineageContext } from '#contracts';
-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 词表。它是会话审计的固定提示，不是知识召回配置，也不提供编辑入口。
- */
-export declare const DEFAULT_ACTS: IntentActDef[];
-/** Free-form act id; validated against the fixed audit vocabulary when possible. */
-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 data-turn backfill. */
-export type IntentSource = 'model' | 'fallback';
-export interface IntentSlotMap {
-    [name: string]: unknown;
-}
-export interface IntentRef {
-    id: string;
-    kind?: string;
-    label?: string;
-}
-/**
- * One built-in 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）：用户可能怎么表达这一类意图，每行一条。
-     *
-     * 固定词表中的 few-shot 说法。
-     */
-    examples?: string[];
-    enabled: boolean;
-}
-/**
- * Recorder settings. 只有审计运行参数保留为内部默认值；分类词表属于固定契约，
- * 不再作为用户配置暴露。
- */
-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 an eligible data turn ends without a model record. */
-    fallbackEnabled: boolean;
-}
-/**
- * 出厂预置的意图分类。
- *
- * 每一项都**必须**带 `description` 与 `examples`：只给标签（"数据分析"）时模型
- * 只能靠猜，同一句话在不同轮次会被分到不同类。这些文案是模型的匹配依据，全部
- * 词表随代码发布，不通过知识库配置或 UI 修改。
- */
-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 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;
-    prompt?: string;
-    /** True when the scoped tool call was intentionally ignored as a non-data turn. */
-    skipped?: boolean;
-    skipReason?: 'non_data_agent' | 'unsupported_preset' | 'non_data_turn';
-}
-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;
-    /** The turn entered the data intent scope through text, payload or a data tool. */
-    eligible: boolean;
-    /** A data tool ran during this turn; a later chat classification cannot revoke it. */
-    dataToolUsed: boolean;
-    committed: boolean;
-}
-//# sourceMappingURL=types.d.ts.map

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

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