ToolCallCollector

CORE · interface · Type contract

Aggregation entry point for streamed function-call deltas.

Import

TypeScript

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

JavaScript

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

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

Definition

interface ToolCallCollector

Field structure

Field	Type	Required	Description
push	(part: ModelPart) => void	Required	Feed one part; text parts are ignored and cannot satisfy or break a call.
calls	readonly AggregatedToolCall[]	Required	Read-only. Calls started so far, including incomplete ones, in index order.
complete	() => readonly AggregatedToolCall[]	Required	Finalize the calls.

Member index

Member	Purpose
push	Feed one part; text parts are ignored and cannot satisfy or break a call.
complete	Finalize the calls.

Member details

push

Feed one part; text parts are ignored and cannot satisfy or break a call.

ToolCallCollector.push(part: ModelPart): void

Feed one part; text parts are ignored and cannot satisfy or break a call.

Parameter	Type	Passing	Description
part	ModelPart	Required	—

Optional shapes of Parameter part: choose one shape; required fields for each branch are listed separately.

Branch 1

string

Branch 2

Field	Type	Required	Description
type	"function-call-delta"	Required	See the type definition and usage context.
index	number	Required	Index of the call within the response; deltas with the same index belong together.
id	string | undefined	Optional	Provider call id, usually delivered once with the first delta.
name	string | undefined	Optional	Function name, usually delivered once with the first delta.
arguments	string | undefined	Optional	Raw JSON argument fragment; concatenating all fragments yields the full arguments.

Returns: void.

complete

Finalize the calls.

ToolCallCollector.complete(): readonly AggregatedToolCall[]

Finalize the calls.

No call parameters.

Returns: readonly AggregatedToolCall[].

Examples

• Compatible Provider and custom Providers: Support owns the common Chat Completions HTTP/SSE lifecycle; an App can substitute its own ChatProvider.
• Support: the aggregate entry for recommended usage: Support aggregates recommended construction, policies, and same-source configuration generation; Core execution does not depend on this namespace.

Connect a common protocol with real server-side configuration

Beginner · Node.js

Running this example requires connection configuration for an available model service.

TypeScript

import { ModelRunner, Support } from '@jangts/agent-core';
const provider = new Support.CompatibleModelProvider({ config: {
  baseUrl: process.env.MODEL_BASE_URL!, apiKey: process.env.MODEL_API_KEY!, model: process.env.MODEL_NAME!,
} });
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);

JavaScript

import { ModelRunner, Support } from '@jangts/agent-core';
const provider = new Support.CompatibleModelProvider({ config: {
        baseUrl: process.env.MODEL_BASE_URL, apiKey: process.env.MODEL_API_KEY, model: process.env.MODEL_NAME,
    } });
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);

Declared fields and wire mapping for a direct tool thread

Configuration · Node.js

This only demonstrates message conversion, with no network request or tool execution. Raw tool_calls, tool_call_id, and host-attached data are not forwarded.

TypeScript

import { Support } from '@jangts/agent-core';
const messages: Support.ProviderMessage[] = [
  { role: 'user', content: '查询资料' },
  { role: 'assistant', content: '', toolCalls: [
    { id: 'call-1', name: 'lookup', arguments: '{"query":"资料"}' },
  ] },
  { role: 'tool', content: '{"found":true}', toolCallId: 'call-1' },
];
console.log(Support.chatCompletionMessages(messages));

JavaScript

import { Support } from '@jangts/agent-core';
const messages = [
    { role: 'user', content: '查询资料' },
    { role: 'assistant', content: '', toolCalls: [
            { id: 'call-1', name: 'lookup', arguments: '{"query":"资料"}' },
        ] },
    { role: 'tool', content: '{"found":true}', toolCallId: 'call-1' },
];
console.log(Support.chatCompletionMessages(messages));

Related policy source

• HTTP failure mapping and controlled request fields

Related definitions

• AggregatedToolCall
• FunctionCallDelta
• ModelPart