assembleFragments
CORE · function · Runtime value
Build the model input from fragments.
Metadata remains program-side: data never becomes a system instruction.
Import
ts
import { assembleFragments } from '@jangts/agent-core/context';js
import { assembleFragments } from '@jangts/agent-core/context';Other public entry points:@jangts/agent-core, @jangts/agent-core/types, @jangts/agent-core/context, @jangts/agent-core/support, @jangts/agent-core/support/context.
Definition
Call
ts
assembleFragments(fragments: ContextFragment[], maxInputChars: number): BuiltContextBuild the model input from fragments.
Metadata remains program-side: data never becomes a system instruction.
| Parameter | Type | Passing | Description |
|---|---|---|---|
fragments | ContextFragment[] | Required | — |
maxInputChars | number | Required | — |
Returns: BuiltContext.
Return value structure
| Field | Type | Required | Description |
|---|---|---|---|
messages | ModelMessage[] | Required | Messages in final model order. |
fragmentUsage | ContextFragmentUsage[] | Required | Per-fragment accounting in the same order as the fragments were merged. |
inputChars | number | Required | Total counted characters across messages and usage. |
maxInputChars | number | Required | Budget the assembly was validated against; Infinity means unbounded. |
Examples
- Context fragments: explicit source, trust, and budget: Core recognizes fragments and the assembly contract, validates source metadata and budgets, and has no built-in business compression algorithm.
Assemble one input from bare configuration
Beginner · Node.js
ts
import { assembleFragments } from '@jangts/agent-core/context';
const input = assembleFragments([{ id: 'question', sourceId: 'request', trust: 'user',
lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }], 2000);
console.log(input.messages, input.fragmentUsage);js
import { assembleFragments } from '@jangts/agent-core/context';
const input = assembleFragments([{ id: 'question', sourceId: 'request', trust: 'user',
lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }], 2000);
console.log(input.messages, input.fragmentUsage);Add a candidate plan and final audit
Configuration · Node.js
An empty mutable fragment list means the original fragments may not be modified; no compression step is authorized automatically.
ts
import { assembleContextPlan } from '@jangts/agent-core/context';
import type { ContextFragment } from '@jangts/agent-core/types';
const fragments: ContextFragment[] = [{ id: 'question', sourceId: 'request', trust: 'user',
lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }];
const input = assembleContextPlan({ fragments, originalFragments: fragments, mutableFragmentIds: [], maxInputChars: 2000 });
console.log(input.inputChars);js
import { assembleContextPlan } from '@jangts/agent-core/context';
const fragments = [{ id: 'question', sourceId: 'request', trust: 'user',
lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }];
const input = assembleContextPlan({ fragments, originalFragments: fragments, mutableFragmentIds: [], maxInputChars: 2000 });
console.log(input.inputChars);