ModelInteractionAdapter

CORE · interface · Type contract

Pluggable implementations all consume the same business registry. No automatic fallback.

Import

TypeScript

import type { ModelInteractionAdapter } from '@jangts/agent-core/support';

JavaScript

/** @typedef {import('@jangts/agent-core/support').ModelInteractionAdapter} ModelInteractionAdapter */

Other public entry points:@jangts/agent-core, @jangts/agent-core/types, @jangts/agent-core/structs, @jangts/agent-core/support, @jangts/agent-core/support/model.

Definition

interface ModelInteractionAdapter

Field structure

Field	Type	Required	Description
id	string	Required	Read-only. Adapter id, reported when a transport is validated or rejected.
features	{ readonly strictArguments: boolean; }	Required	Read-only. See the type definition and usage context.
prepare	(tools: readonly RegisteredModelTool[]) => Omit<PreparedModelInteraction, "resolve">	Required	Compiles one stage's tools.

Member index

Member	Purpose
prepare	Compiles one stage's tools.

Member details

prepare

Compiles one stage's tools.

ModelInteractionAdapter.prepare(tools: readonly RegisteredModelTool[]): Omit<PreparedModelInteraction, "resolve">

Compiles one stage's tools.

Parameter	Type	Passing	Description
tools	readonly Readonly<ModelTool<unknown, unknown, any>>[]	Required	—

Returns: Omit<PreparedModelInteraction<unknown>, "resolve">.

Return value structure

Field	Type	Required	Description
options	Pick<ModelOptions, "functions" | "json" | "toolChoice" | "parallelToolCalls">	Required	Read-only. Provider options produced from the stage's tools.
schemaChars	number	Required	Read-only. Characters the compiled schemas add to the input, counted against the schema budget.
instruction	string | undefined	Optional	Read-only. Instruction text that teaches the model how to answer; absent when the format is native.
createResponse	() => ModelResponseCollector	Required	Creates a fresh collector for one call; never reuse a collector across calls.

Examples

• Model transport and stage projection: Generate a sealed catalog and stage projections from tool definitions; native functions and JSON adapters share the same tool contract.

Create a named text transport

Beginner · 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);

Generate transports for two stages from same-source tools

Configuration · 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);

Related policy source

• Stage list validation and dynamic source snapshots
• Explicit model interaction adapter catalog
• Session transport for prose and multiple tool calls

Related definitions

• ModelTool
• PreparedModelInteraction
• RegisteredModelTool