模型传输与阶段投影

从 Tool 定义生成封存目录与阶段投影，原生函数和 JSON 适配复用同一 Tool 合同。

createTextTransport 明确创建普通文本传输；createModelTransport 默认使用 nativeFunctionInteraction。需要 JSON 协议时显式传 jsonObjectInteraction，Core 不根据模型名称、URL 或失败次数猜测回退。

createStageModelTransport 使用 stages[{id,toolIds}] 约束每个模型阶段。静态源装配时核验，动态 source 工厂在本次 prepare 时获取快照；已准备调用固定 resolver 与接收者。未知阶段先拒绝，不调用动态 source；阶段外 Tool 不能通过运行时绕过。

modelInteractionCatalog 以 native-functions、json-object 两个真实适配器 ID 提供只读目录。App 可按明确的模型 Tool 配置选择目录项，不根据模型名称、URL 或失败次数自动猜测。直接使用适配器与通过目录 ID 代指使用同一 ModelInteractionAdapter 合同。

requireStrictArguments 请求适配器声明的严格参数能力；不支持则装配时拒绝。它不保证供应商一定正确响应，最终 collector 与 Schema 仍需校验。

createSessionModelTransport 允许一次响应同时包含正文与多个工具调用，并复用同一调用收集器；它只提供解析结果，不执行工具。prepareSessionFunctions 为各阶段准备工具声明，未知工具与非法参数以 problem 标记保留，由 App 在真实分派前校验。

由简到繁的同业务示例

创建具名文本传输

入门 · Node.js

TypeScript

import { ModelRunner, Support } from '@jangts/agent-core';
const text = Support.createTextTransport({ id: 'brief', options: { temperature: 0.2 } });
const runner = new ModelRunner({ provider: { async *stream() { yield '服务正常'; } }, transports: [text] });
console.log((await runner.invoke({ input: '简答服务状态', transport: text })).value);

JavaScript

import { ModelRunner, Support } from '@jangts/agent-core';
const text = Support.createTextTransport({ id: 'brief', options: { temperature: 0.2 } });
const runner = new ModelRunner({ provider: { async *stream() { yield '服务正常'; } }, transports: [text] });
console.log((await runner.invoke({ input: '简答服务状态', transport: text })).value);

从同源 Tool 生成两个阶段的传输

配置 · Node.js

TypeScript

import { Support } from '@jangts/agent-core';
const inputSchema = Support.defineSchema({
  jsonSchema: { type: 'object', properties: {}, additionalProperties: false },
  parse(value: unknown) {
    if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length) throw new TypeError('需要空对象');
    return {};
  },
});
const tools = Support.defineModelTools([
  { id: 'greet', description: '问候', inputSchema, resolve: () => 'greet' },
  { id: 'status', description: '状态查询', inputSchema, resolve: () => 'status' },
]);
const transport = Support.createStageModelTransport({ id: 'intent', tools,
  stages: [{ id: 'recognize', toolIds: ['greet', 'status'] }, { id: 'status-only', toolIds: ['status'] }],
});
console.log(transport.prepare('status-only').schemaChars);

JavaScript

import { Support } from '@jangts/agent-core';
const inputSchema = Support.defineSchema({
    jsonSchema: { type: 'object', properties: {}, additionalProperties: false },
    parse(value) {
        if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length)
            throw new TypeError('需要空对象');
        return {};
    },
});
const tools = Support.defineModelTools([
    { id: 'greet', description: '问候', inputSchema, resolve: () => 'greet' },
    { id: 'status', description: '状态查询', inputSchema, resolve: () => 'status' },
]);
const transport = Support.createStageModelTransport({ id: 'intent', tools,
    stages: [{ id: 'recognize', toolIds: ['greet', 'status'] }, { id: 'status-only', toolIds: ['status'] }],
});
console.log(transport.prepare('status-only').schemaChars);

保留 Tool，只替换明确的交互适配

扩展 · Node.js

模型调用仍是 invoke({input,transport}) 并返回 ModelResult；切换交互不重新设计业务结果。

TypeScript

import { Support } from '@jangts/agent-core';
const inputSchema = Support.defineSchema({
  jsonSchema: { type: 'object', properties: {}, additionalProperties: false },
  parse(value: unknown) {
    if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length) throw new TypeError('需要空对象');
    return {};
  },
});
const tools = Support.defineModelTools([
  { id: 'status', description: '查询服务状态', inputSchema, resolve: () => 'status' },
]);
const native = Support.createModelTransport({ id: 'native', tools });
const adapterId: keyof typeof Support.modelInteractionCatalog = 'json-object';
const json = Support.createModelTransport({ id: 'json', tools, adapter: Support.modelInteractionCatalog[adapterId] });
console.log(native.id, json.id);

JavaScript

import { Support } from '@jangts/agent-core';
const inputSchema = Support.defineSchema({
    jsonSchema: { type: 'object', properties: {}, additionalProperties: false },
    parse(value) {
        if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length)
            throw new TypeError('需要空对象');
        return {};
    },
});
const tools = Support.defineModelTools([
    { id: 'status', description: '查询服务状态', inputSchema, resolve: () => 'status' },
]);
const native = Support.createModelTransport({ id: 'native', tools });
const adapterId = 'json-object';
const json = Support.createModelTransport({ id: 'json', tools, adapter: Support.modelInteractionCatalog[adapterId] });
console.log(native.id, json.id);

策略与实现

• 阶段清单校验与动态源快照
• 显式模型交互适配器目录
• 正文与多工具调用的会话传输