BuiltContext

CORE · interface · Type contract

Assembled context plus the accounting needed to explain the budget decision.

Import

TypeScript

import type { BuiltContext } from '@jangts/agent-core/context';

JavaScript

/** @typedef {import('@jangts/agent-core/context').BuiltContext} BuiltContext */

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

Definition

interface BuiltContext

Field 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

TypeScript

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

JavaScript

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.

TypeScript

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

JavaScript

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

Related policy source

• Fragment validation and budget rejection

Related definitions

• ContextFragmentUsage
• ModelMessage