ContextFragmentUsage

CORE · interface · Type contract

Accounting entry reported for one fragment that actually entered the context.

Import

TypeScript

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

JavaScript

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

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 ContextFragmentUsage

Field structure

Field	Type	Required	Description
id	string	Required	See the type definition and usage context.
sourceId	string	Required	See the type definition and usage context.
trust	ContextTrust	Required	See the type definition and usage context.
lifetime	ContextLifetime	Required	See the type definition and usage context.
chars	number	Required	Characters consumed after formatting.
maxChars	number	Required	Budget that applied to this fragment.

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

• ContextLifetime
• ContextTrust