@yss123/cage-ai 0.0.0-stage → 0.3.1

package/dist/tool-catalog.d.ts

@@ -0,0 +1,23 @@
+import { type RuntimeNode } from '@yss123/cage-ontology';
+import type { Execution } from './types.js';
+/**
+ * 判断节点能否作为助理业务工具：允许命名查询及 invokedBy 含 user 的命令。
+ * 可见性和能力过滤由目录调用方负责；内部 process/job/external 命令不会因名称被模型发现而获得用户入口。
+ */
+export declare function callable(node: RuntimeNode): boolean;
+/**
+ * 返回当前 ctx 在本体目录中可见且用户可调用的全部业务 key。
+ * 这是能力候选集合，目标对象范围和具体约束仍在工具执行时复核。
+ */
+export declare function authorizedToolKeys(execution: Pick<Execution, 'ontology' | 'ctx'>): string[];
+/** 仅排序候选，不在这里决定数量。完整定义的成本由请求规划器统一计算。 */
+/**
+ * 按已加载工具、当前草稿命令、任务关键词和页面聚合依次收集候选并去重。
+ * 页面仅提供排序线索，不限制整个业务目录；此处不按数量截断，完整定义成本由请求规划器统一计算。
+ */
+export declare function candidateToolKeys(execution: Pick<Execution, 'ontology' | 'ctx' | 'run'>): string[];
+/**
+ * 验证显式加载列表并返回去重 key，数量必须为 1 至 128。
+ * 逐项经过当前主体的目录访问与用户可调用检查，未知、不可见或内部命令立即拒绝；本函数不保证这些 schema 最终能装入预算。
+ */
+export declare function loadToolKeys(execution: Execution, requested: string[]): string[];

package/dist/tool-catalog.js

@@ -0,0 +1,53 @@
+/**
+ * 从运行时本体目录选择用户可调用的业务工具。
+ * 请求规划器用候选顺序决定优先装载哪些完整 schema；本模块只处理可见性、调用身份和 key，不执行业务，也不自行决定 Token 容量。
+ */
+import { cageError } from '@yss123/cage-kernel';
+import { ontologyCatalog } from '@yss123/cage-ontology';
+/**
+ * 判断节点能否作为助理业务工具：允许命名查询及 invokedBy 含 user 的命令。
+ * 可见性和能力过滤由目录调用方负责；内部 process/job/external 命令不会因名称被模型发现而获得用户入口。
+ */
+export function callable(node) {
+    return node.kind === 'query' || (node.kind === 'command' && node.data.invokedBy.includes('user'));
+}
+/**
+ * 返回当前 ctx 在本体目录中可见且用户可调用的全部业务 key。
+ * 这是能力候选集合，目标对象范围和具体约束仍在工具执行时复核。
+ */
+export function authorizedToolKeys(execution) {
+    return ontologyCatalog(execution.ontology).keys(execution.ctx, {}, callable);
+}
+/** 仅排序候选，不在这里决定数量。完整定义的成本由请求规划器统一计算。 */
+/**
+ * 按已加载工具、当前草稿命令、任务关键词和页面聚合依次收集候选并去重。
+ * 页面仅提供排序线索，不限制整个业务目录；此处不按数量截断，完整定义成本由请求规划器统一计算。
+ */
+export function candidateToolKeys(execution) {
+    const { ontology, ctx, run } = execution, catalog = ontologyCatalog(ontology);
+    const keys = new Set(run.tool_keys ?? []);
+    const draft = run.page_context?.draft?.command;
+    if (draft && ctx.capabilities.has(draft))
+        keys.add(`command:${draft}`);
+    for (const key of catalog.keys(ctx, { query: run.input }, callable))
+        keys.add(key);
+    const aggregate = run.page_context?.subject?.aggregate ?? run.page_context?.view?.aggregate ?? run.page_context?.selection?.aggregate;
+    if (aggregate)
+        for (const key of catalog.keys(ctx, { aggregate }, callable))
+            keys.add(key);
+    return [...keys];
+}
+/**
+ * 验证显式加载列表并返回去重 key，数量必须为 1 至 128。
+ * 逐项经过当前主体的目录访问与用户可调用检查，未知、不可见或内部命令立即拒绝；本函数不保证这些 schema 最终能装入预算。
+ */
+export function loadToolKeys(execution, requested) {
+    const catalog = ontologyCatalog(execution.ontology), unique = [...new Set(requested)];
+    if (!unique.length || unique.length > 128)
+        throw cageError('INVALID_INPUT', '工具加载数量必须在 1 至 128 之间');
+    for (const key of unique)
+        if (!callable(catalog.node(execution.ctx, key)))
+            throw cageError('INVALID_INPUT', '只能加载用户可调用的命令或查询');
+    return unique;
+}
+//# sourceMappingURL=tool-catalog.js.map

package/dist/tool-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalog.js","sourceRoot":"","sources":["../src/tool-catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAoB,MAAM,uBAAuB,CAAC;AAG1E;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAiB;IACxC,OAAO,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAK,IAAI,CAAC,IAAI,CAAC,SAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAClH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA8C;IAC/E,OAAO,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,wCAAwC;AACxC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAsD;IACtF,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,SAAS,EACtC,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC;IAC/C,IAAI,KAAK,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;IACvE,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnF,MAAM,SAAS,GACb,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,IAAI,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,CAAC;IACtH,IAAI,SAAS;QAAE,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AACD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAoB,EAAE,SAAmB;IACpE,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,EACjD,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,SAAS,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;IACpG,KAAK,MAAM,GAAG,IAAI,MAAM;QACtB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAAE,MAAM,SAAS,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IACvG,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,54 @@
+import { type InCodeEngine } from '@yss123/cage-approval';
+import { z } from 'zod';
+import { type Transaction } from 'kysely';
+import type { Execution, ModelTool } from './types.js';
+/**
+ * 模型工具的服务端可执行定义；公开 JSON Schema 与真实 Zod 校验同时保留。
+ * effect 决定运行时是否确认、暂停或在事务内完成；模型只看到名称、说明和 input，不获得 execute 函数或数据库连接。
+ */
+export interface Tool extends ModelTool {
+    /**
+     * 可选业务本体 key，供发现和预算选择；基础工具没有 key。
+     */
+    key?: string;
+    /**
+     * 真实执行前的输入 schema，与发送给模型的 JSON Schema 对应。
+     */
+    schema: z.ZodType;
+    /**
+     * 副作用分类：读、写、用户互动、审批裁决或工具发现/加载。
+     */
+    effect: 'read' | 'write' | 'interaction' | 'decision' | 'load' | 'discover';
+    /**
+     * 执行已解析参数；写工具要求运行时传入动作事务，读取工具通常不使用该事务。
+     */
+    execute(execution: Execution, args: any, tx?: Transaction<any>): Promise<unknown>;
+    /**
+     * 可选写入确认预览；应重新取当前可见事实并掩码，不在预览阶段提交业务变化。
+     */
+    preview?(execution: Execution, args: any): Promise<unknown>;
+}
+/**
+ * 从已注册 ROUTE 扩展解析进程内审批引擎，供待办、历史与审核工具复用。
+ * 只发现框架已注册引擎，不创建外部审批权限，也不按模型任意字符串动态加载实现。
+ */
+export declare function engines(execution: Pick<Execution, 'kernel'>): InCodeEngine[];
+/** 注册声明编译成工具；应用无需为每个业务对象重新实现工具。当前权限决定每轮可见目录。 */
+/**
+ * 按当前运行模式、主体权限和持久工具选择生成工具集合。
+ * 助理可取本体、安全读、已加载业务命令/查询、本人审批及交互/偏好工具；审批仅有上下文读取、策略白名单查询和 review_decide，不获得通用业务写入口。
+ * 命名查询要求所有 reads 能力并最多交付 200 行；业务写必须同动作回执事务执行，更新已有对象必须带 expectedVersion，确认预览重新读取并掩码。
+ * 发现/加载只产出候选，容量由请求规划器决定；工具名校验、当前授权和内核约束仍在每次实际动作中执行。
+ */
+export declare function toolsFor(execution: Execution, selection?: {
+    keys: string[];
+    discovery: boolean;
+}): Tool[];
+/**
+ * 按本轮实际工具列表精确匹配模型名称，再用工具的 Zod schema 解析参数。
+ * 未知或当前无权工具返回 FORBIDDEN，参数错误返回稳定输入错误；不允许模型直接指向任意导出函数。
+ */
+export declare function checkedTool(tools: Tool[], name: string, input: unknown): {
+    tool: Tool;
+    args: any;
+};

package/dist/tools.js

@@ -0,0 +1,259 @@
+/**
+ * 把注册表与运行时本体编译为当前主体可见、可校验的模型工具。
+ * 请求规划器选择完整定义，运行时按 effect 执行读、写、交互、发现或裁决；工具调用不会绕过内核安全读、领域命令、审批身份或动作回执事务。
+ */
+import { cageError, present } from '@yss123/cage-kernel';
+import { ontologyCatalog } from '@yss123/cage-ontology';
+import { aiDecisionSchema, queryPlanSchema } from '@yss123/cage-ai-protocol';
+import { z } from 'zod';
+import { sql } from 'kysely';
+import { randomUUID } from 'node:crypto';
+import { queryPlan } from './query.js';
+import { digest, parse } from './security.js';
+import { authorizedToolKeys, callable, loadToolKeys } from './tool-catalog.js';
+import { readContext } from './context-read.js';
+/**
+ * 工具参数通用标识符校验，与 params 共同构成基础输入片段。
+ * 名称长度为 1 至 160 字符；params 是默认空对象的参数字典，具体字段合法性由被调用内核读接口继续校验。
+ */
+const name = z.string().min(1).max(160), params = z.record(z.string(), z.unknown()).default({});
+/**
+ * 本体与证据目录的分页输入，offset 为零基，单页默认 10 项、最多 20 项。
+ * 这是目录/证据页限制，不替代业务列表和命名查询各自的行数边界。
+ */
+const paging = {
+    offset: z.number().int().nonnegative().default(0),
+    limit: z.number().int().min(1).max(20).default(10),
+};
+/**
+ * 严格的本体搜索输入：允许最长 500 字符关键词、可选聚合筛选和有界分页；空关键词用于浏览目录。
+ */
+const searchSchema = z
+    .object({ query: z.string().max(500).default(''), aggregate: name.optional(), ...paging })
+    .strict();
+/**
+ * 从已注册 ROUTE 扩展解析进程内审批引擎，供待办、历史与审核工具复用。
+ * 只发现框架已注册引擎，不创建外部审批权限，也不按模型任意字符串动态加载实现。
+ */
+export function engines(execution) {
+    return execution.kernel.registry.extensions
+        .filter((e) => e.kind === 'ROUTE')
+        .map((e) => e.value.engine(execution.kernel));
+}
+/**
+ * 按 Zod 实例缓存 JSON Schema，避免每轮重复转换完整参数定义；弱引用不会永久保留已废弃声明。
+ */
+const inputDefinitions = new WeakMap();
+/**
+ * 按命令声明对象缓存 input/expectedVersion 包装 schema；真实执行仍校验当前命令状态、权限与版本。
+ */
+const commandSchemas = new WeakMap();
+/**
+ * 把名称、说明、Zod schema 和服务端执行/预览函数组合为 Tool。
+ * JSON Schema 用于模型理解输入，真实 Zod schema 继续在执行前校验；转换缓存不等于校验缓存或授权缓存。
+ */
+function define(name, description, schema, effect, execute, preview) {
+    let input = inputDefinitions.get(schema);
+    if (!input) {
+        input = z.toJSONSchema(schema, { io: 'input', unrepresentable: 'any' });
+        inputDefinitions.set(schema, input);
+    }
+    return { name, description, schema, effect, execute, preview, input };
+}
+/** 注册声明编译成工具；应用无需为每个业务对象重新实现工具。当前权限决定每轮可见目录。 */
+/**
+ * 按当前运行模式、主体权限和持久工具选择生成工具集合。
+ * 助理可取本体、安全读、已加载业务命令/查询、本人审批及交互/偏好工具；审批仅有上下文读取、策略白名单查询和 review_decide，不获得通用业务写入口。
+ * 命名查询要求所有 reads 能力并最多交付 200 行；业务写必须同动作回执事务执行，更新已有对象必须带 expectedVersion，确认预览重新读取并掩码。
+ * 发现/加载只产出候选，容量由请求规划器决定；工具名校验、当前授权和内核约束仍在每次实际动作中执行。
+ */
+export function toolsFor(execution, selection) {
+    const { kernel, ctx, run, ontology } = execution, review = run.mode === 'approval';
+    const selected = new Set(selection?.keys ?? run.tool_keys ?? []);
+    // 动作执行使用模型调用前持久化的选择，不能在执行中重算并意外撤掉已提供的工具。
+    const needsDiscovery = !review &&
+        (selection?.discovery ??
+            (run.tool_plan ? run.tool_plan.mode === 'discovery' : selected.size < authorizedToolKeys(execution).length));
+    const tools = [];
+    tools.push(define('context_read', '按引用取回已收起的完整页面、工具回执或会话。先列目录，再用 runId/ref/path 和分页展开；不重新执行业务操作。', z
+        .object({
+        source: z.enum(['context', 'action', 'conversation']),
+        runId: z.uuid().optional(),
+        ref: z.uuid().optional(),
+        path: z
+            .array(z.union([name, z.number().int().nonnegative()]))
+            .max(16)
+            .default([]),
+        ...paging,
+    })
+        .strict(), 'read', readContext));
+    if (!review) {
+        tools.push(define('ontology_search', '检索当前权限内的本体摘要，空 query 分页浏览目录。未命中可缩短关键词；详细规则用 ontology_describe 展开。', searchSchema, 'read', async (_e, a) => ontologyCatalog(ontology).search(ctx, a)));
+        tools.push(define('ontology_describe', '按本体 key 查看完整规则、字段、参数或关联节点。字段与关系可分页；不会把未返回的部分当作不存在。', z
+            .object({
+            key: name,
+            section: z.enum(['overview', 'fields', 'input', 'related']).default('overview'),
+            ...paging,
+        })
+            .strict(), 'read', async (_e, a) => ontologyCatalog(ontology).describe(ctx, a.key, a.section, a.offset, a.limit)));
+        if (needsDiscovery) {
+            tools.push(define('tool_search', '检索可用业务命令和查询，支持分页。命中的候选会在预算内自动加载完整参数，下一轮即可调用；以回执 loaded 为准，未命中可缩短关键词或分页浏览。', searchSchema, 'discover', async (_e, a) => ontologyCatalog(ontology).search(ctx, a, callable)));
+            tools.push(define('tool_load', '已知本体 key 时显式加载完整业务工具定义。搜索已自动加载的工具无需再次加载；完整参数超出预算时需减少 keys。', z.object({ keys: z.array(name).min(1).max(128) }).strict(), 'load', async (e, a) => loadToolKeys(e, a.keys)));
+        }
+        tools.push(define('data_get', '按聚合名和 ID 读取当前权限内的对象。', z.object({ aggregate: name, id: z.uuid() }).strict(), 'read', (e, a) => kernel.read.get(a.aggregate, a.id, e.ctx)));
+        tools.push(define('data_list', '按声明字段过滤并分页读取；默认 20 条，最多 200 条。', z.object({ aggregate: name, params }).strict(), 'read', (e, a) => kernel.read.list(a.aggregate, a.params, e.ctx)));
+        tools.push(define('data_related', '按字段声明分页读取关联对象。', z.object({ aggregate: name, id: z.uuid(), field: name, params }).strict(), 'read', (e, a) => kernel.read.related(a.aggregate, a.id, a.field, a.params, e.ctx)));
+        tools.push(define('data_query', '执行有限查询计划，支持范围过滤和统计，不接受 SQL。', queryPlanSchema, 'read', (e, a) => queryPlan(kernel, e.ctx, a)));
+    }
+    // 查询同时受 reads 能力与审批策略白名单限制；助理还要求完整 schema 已装载，搜索命中不等于当前已可执行。
+    for (const query of kernel.registry.queries) {
+        if (!query.reads.every((agg) => ctx.capabilities.has(`${agg.name}.read`)) ||
+            (review && !run.policy.context.queries?.includes(query.name)))
+            continue;
+        if (!review && !selected.has(`query:${query.name}`))
+            continue;
+        tools.push(define(`query_${digest(query.name).slice(0, 16)}`, `${query.name}: ${query.description ?? '已声明查询'}`, query.input, 'read', async (e, a) => {
+            const rows = await kernel.read.run(query, a, e.ctx);
+            return { source: `query:${query.name}`, rows: rows.slice(0, 200), truncated: rows.length > 200, limit: 200 };
+        }));
+        tools[tools.length - 1].key = `query:${query.name}`;
+    }
+    if (review) {
+        tools.push(define('review_decide', '完成本审批节点：pass 通过，return 退回修改，manual 转人工。须说明理由并引用 subject 或已执行的 query:名称。', aiDecisionSchema, 'decision', async (_e, a) => a));
+        return tools;
+    }
+    // 只暴露用户身份入口。命令 schema 加 expectedVersion 包装，真实写入复用内核流水线并与持久动作回执同事务。
+    for (const command of kernel.registry.commands) {
+        if (!command.cmd.invokedBy.includes('user') || !ctx.capabilities.has(command.capability))
+            continue;
+        if (!selected.has(`command:${command.capability}`))
+            continue;
+        let schema = commandSchemas.get(command.cmd);
+        if (!schema) {
+            schema = z.object({ input: command.cmd.input, expectedVersion: z.number().int().positive().optional() }).strict();
+            commandSchemas.set(command.cmd, schema);
+        }
+        tools.push(define(`command_${digest(command.capability).slice(0, 16)}`, `${command.capability}: ${command.cmd.description ?? '领域命令'}。修改现有对象必须提供读取到的 expectedVersion。`, schema, 'write', async (e, a, tx) => {
+            if (!tx)
+                throw new Error('命令必须与动作回执在同一事务执行');
+            if (command.cmd.from !== 'new' && !a.expectedVersion)
+                throw cageError('INVALID_INPUT', '修改需要 expectedVersion');
+            return kernel.executePresentedIn(tx, command.cmd, { ...a.input, expectedVersion: a.expectedVersion }, { ...e.ctx, idempotencyKey: undefined });
+        }, async (e, a) => {
+            if (command.cmd.from !== 'new' && !a.expectedVersion)
+                throw cageError('INVALID_INPUT', '修改需要 expectedVersion');
+            const subject = command.cmd.from !== 'new' ? await kernel.read.get(command.cmd.agg, a.input.id, e.ctx) : null;
+            if (subject && subject.version !== a.expectedVersion)
+                throw cageError('CONFLICT');
+            return {
+                command: command.capability,
+                input: present(command.cmd.agg, a.input, e.ctx),
+                expectedVersion: a.expectedVersion,
+                subject,
+            };
+        }));
+        tools[tools.length - 1].key = `command:${command.capability}`;
+    }
+    // 进度查询面向可读单据，不能拿“本人待办为空”推断流程已结束或尚未开始。
+    tools.push(define('approval_history', '查询可读业务对象的审批进度、当前步骤、历史轮次及可见审核理由。询问单据到哪一步时使用；本人没有待办也能查看有权读取的单据进度。', z.object({ aggregate: name, id: z.uuid() }).strict(), 'read', async (e, a) => {
+        await kernel.read.get(a.aggregate, a.id, e.ctx);
+        return (await Promise.all(engines(e).map((engine) => engine.history(a.aggregate, a.id, e.ctx))))
+            .flat()
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }));
+    // 本人待办仍需逐个确认业务对象可读；不可读项被省略，不能用空列表推断整个审批流程不存在。
+    tools.push(define('approval_tasks', '读取当前用户的待办；决定必须通过 approval_decide。', z.object({}).strict(), 'read', async (e) => {
+        const result = [];
+        for (const engine of engines(e))
+            for (const task of await engine.tasksOf(e.ctx.userId, e.ctx.tenantId)) {
+                try {
+                    const record = await kernel.read.get(task.aggregate, task.businessKey, e.ctx);
+                    result.push({ ...task, vars: undefined, record });
+                }
+                catch (error) {
+                    if (!['FORBIDDEN', 'NOT_FOUND'].includes(error.code))
+                        throw error;
+                }
+            }
+        return result;
+    }));
+    const taskSchema = z
+        .object({
+        process: name,
+        taskId: z.uuid(),
+        outcome: z.enum(['approved', 'rejected', 'returned']),
+        comment: z.string().max(1000).optional(),
+        // 将用户确认绑定到待办版本；不能在执行时自动换成最新版本而让旧确认批准转回来的新任务。
+        expectedRevision: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER).optional(),
+    })
+        .strict();
+    tools.push(define('approval_decide', '对本人待办通过、拒绝或退回修改；携带 approval_tasks 返回的 revision 作为 expectedRevision，委派未归还时不能决定。', taskSchema, 'write', async (e, a, tx) => {
+        const engine = engines(e).find((v) => v.route.process === a.process);
+        if (!engine || !tx)
+            throw cageError('NOT_FOUND');
+        return engine.decideIn(tx, a.taskId, e.ctx.userId, e.ctx.tenantId, a.outcome, a.comment, a.expectedRevision);
+    }, async (e, a) => {
+        const engine = engines(e).find((v) => v.route.process === a.process);
+        const task = (await engine?.tasksOf(e.ctx.userId, e.ctx.tenantId))?.find((t) => t.id === a.taskId);
+        if (!task)
+            throw cageError('NOT_FOUND');
+        if (task.delegation === 'pending')
+            throw cageError('INVALID_TRANSITION');
+        if ((task.assignment === 'candidate' || Object.values(task.actions).some(Boolean)) && a.expectedRevision === undefined)
+            throw cageError('INVALID_INPUT');
+        if (a.expectedRevision !== undefined && a.expectedRevision !== task.revision)
+            throw cageError('CONFLICT');
+        return {
+            process: a.process,
+            taskId: a.taskId,
+            outcome: a.outcome,
+            comment: a.comment,
+            expectedRevision: a.expectedRevision,
+            subject: await kernel.read.get(task.aggregate, task.businessKey, e.ctx),
+        };
+    }));
+    tools.push(define('request_input', '缺少操作参数或意图不明确时向用户提问并暂停。', z.object({ prompt: z.string().min(1).max(2000) }).strict(), 'interaction', async (_e, a) => a));
+    tools.push(define('request_page_context', '请当前发起页面提供新快照并暂停；跨标签页快照不可替换。', z.object({ prompt: z.string().min(1).max(2000) }).strict(), 'interaction', async (_e, a) => a));
+    // 偏好按当前用户隔离并始终要求运行时确认。内容用途由工具说明约束，schema 只限制长度，不声称具有敏感语义识别能力。
+    tools.push(define('memory_remember', '经用户确认保存表达偏好；不能保存密码、授权或业务查询结果。', z.object({ key: z.string().min(1).max(100), value: z.string().min(1).max(1000) }).strict(), 'write', async (e, a, tx) => {
+        if (!tx)
+            throw new Error('记忆写入需要动作事务');
+        // 多个会话可以并发执行，偏好配额按用户串行核验，避免同时通过最后一个名额。
+        await sql `select pg_advisory_xact_lock(hashtext(${e.ctx.tenantId}), hashtext(${e.ctx.userId}))`.execute(tx);
+        const existing = await tx
+            .selectFrom('sys.ai_memory')
+            .select('id')
+            .where('tenant_id', '=', e.ctx.tenantId)
+            .where('user_id', '=', e.ctx.userId)
+            .where('key', '=', a.key)
+            .executeTakeFirst();
+        if (!existing) {
+            const count = await tx
+                .selectFrom('sys.ai_memory')
+                .select('id')
+                .where('tenant_id', '=', e.ctx.tenantId)
+                .where('user_id', '=', e.ctx.userId)
+                .execute();
+            if (count.length >= 50)
+                throw cageError('RATE_LIMITED', '最多保存 50 条偏好');
+        }
+        await tx
+            .insertInto('sys.ai_memory')
+            .values({ id: randomUUID(), tenant_id: e.ctx.tenantId, user_id: e.ctx.userId, ...a })
+            .onConflict((oc) => oc.columns(['tenant_id', 'user_id', 'key']).doUpdateSet({ value: a.value, updated_at: new Date() }))
+            .execute();
+        return { remembered: true, key: a.key };
+    }, async (_e, a) => a));
+    return tools;
+}
+/**
+ * 按本轮实际工具列表精确匹配模型名称，再用工具的 Zod schema 解析参数。
+ * 未知或当前无权工具返回 FORBIDDEN，参数错误返回稳定输入错误；不允许模型直接指向任意导出函数。
+ */
+export function checkedTool(tools, name, input) {
+    const tool = tools.find((t) => t.name === name);
+    if (!tool)
+        throw cageError('FORBIDDEN', '工具未注册或当前主体无权调用');
+    return { tool, args: parse(tool.schema, input) };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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