模型 Tool 与传输：完整校验后才得到类型化选择

Tool 定义提供 Schema 与 resolver；传输将 wire 输出翻译为统一的模型选择合同。

Tool 清单描述模型允许提出什么，不代表业务已获授权。inputSchema.parse 解析参数，resolve 根据完整、已校验的输入构造领域结果。两者同步，不能偷偷执行网络工具。

select 返回封存的阶段子集。未知 Tool、重复 ID、空选择或阶段外选择拒绝。App 在投影前决定 Tool 可见性；工具执行时仍应检查真实请求权限。

Core 通过 ModelTransportDefinition.prepare 取得 options、schemaChars、可选 instruction 和新的 collector。collector.push 接受分片；finish 完成协议与输入校验后返回结果。

Core 在 collector 工厂返回后、每次 push 后和 finish 后读取 outputChars：值必须是非负安全整数，NaN、Infinity、负数和小数均按协议错误拒绝。maxOutputChars 可以显式设为 Infinity，但不放宽 collector 计数合同。诊断保留各次有效观测的峰值，finish 可释放或规范化内部缓冲，不要求缓冲一直增长。

原生交互接收字符串或合法的 function-call-delta。函数分片必须是非数组对象，index 为 0；id 提供时必须是非空字符串，name 和 arguments 提供时必须是字符串。冲突 ID、多个调用、未登记 Tool、混合正文或不完整参数被拒绝，不执行工具。

collector 可选 call 元数据只尽力读取一次；getter 抛错不覆盖已取得的业务结果、原始错误或取消，也不阻止 model.end 收尾。outputChars 是执行校验字段，不适用这个容错规则。普通对象或类都可以实现这个接口；Support 提供推荐的 native/JSON 组合，无需 Core 依赖 Support。

由简到繁的同业务示例

声明两个可选择 Tool

入门 · Node.js

TypeScript

import { ModelToolRegistry } from '@jangts/agent-core';
const inputSchema = { jsonSchema: { type: 'object', properties: {}, additionalProperties: false },
  parse(value: unknown) {
    if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length) throw new Error('需要空对象');
    return {};
  } };
const tools = new ModelToolRegistry([
  { id: 'greet', description: '回答问候', inputSchema, resolve: () => 'greet' },
  { id: 'status', description: '查询状态', inputSchema, resolve: () => 'status' },
]).seal();
console.log(tools.resolve({ toolId: 'status', input: {} }, { stageId: 'recognize' }));

JavaScript

import { ModelToolRegistry } from '@jangts/agent-core';
const inputSchema = { jsonSchema: { type: 'object', properties: {}, additionalProperties: false },
    parse(value) {
        if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length)
            throw new Error('需要空对象');
        return {};
    } };
const tools = new ModelToolRegistry([
    { id: 'greet', description: '回答问候', inputSchema, resolve: () => 'greet' },
    { id: 'status', description: '查询状态', inputSchema, resolve: () => 'status' },
]).seal();
console.log(tools.resolve({ toolId: 'status', input: {} }, { stageId: 'recognize' }));

仅向一个阶段投影允许的子集

配置 · Node.js

TypeScript

import { ModelToolRegistry, Support } from '@jangts/agent-core';
const schema = Support.defineSchema({ jsonSchema: { type: 'object', properties: {} },
  parse(value: unknown) { if (!value || typeof value !== 'object' || Array.isArray(value)) throw new TypeError('需要对象'); return {}; } });
const registry = new ModelToolRegistry([
  { id: 'greet', description: '问候', inputSchema: schema, resolve: () => 'greet' },
  { id: 'status', description: '状态', inputSchema: schema, resolve: () => 'status' },
]).seal();
const readOnly = registry.select(['status']);
const transport = Support.createModelTransport({ id: 'recognize', tools: readOnly });
console.log(transport.id, readOnly.ids());

JavaScript

import { ModelToolRegistry, Support } from '@jangts/agent-core';
const schema = Support.defineSchema({ jsonSchema: { type: 'object', properties: {} },
    parse(value) { if (!value || typeof value !== 'object' || Array.isArray(value))
        throw new TypeError('需要对象'); return {}; } });
const registry = new ModelToolRegistry([
    { id: 'greet', description: '问候', inputSchema: schema, resolve: () => 'greet' },
    { id: 'status', description: '状态', inputSchema: schema, resolve: () => 'status' },
]).seal();
const readOnly = registry.select(['status']);
const transport = Support.createModelTransport({ id: 'recognize', tools: readOnly });
console.log(transport.id, readOnly.ids());