ContextFragment

CORE · interface · 类型合同

One piece of model-visible input before assembly.

导入

TypeScript

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

JavaScript

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

其他公开入口：@jangts/agent-core、@jangts/agent-core/types、@jangts/agent-core/structs、@jangts/agent-core/context、@jangts/agent-core/support、@jangts/agent-core/support/context。

定义

interface ContextFragment

字段结构

字段	类型	必需	说明
id	string	必需	Unique, stable id matching ^[a-z][a-zA-Z0-9:._-]*$; duplicates are rejected.
sourceId	string	必需	Owning source (module or registration) used to explain where the content came from.
trust	ContextTrust	必需	Producer trust level. user and tool content cannot become a system message.
lifetime	ContextLifetime	必需	Declared validity window of this content.
maxChars	number	必需	Hard upper bound in JSON characters; must be a positive safe integer.
role	"system" | "user"	必需	Message slot the fragment occupies when assembled.
value	string | Record<string, unknown>	必需	Rendered content. A system message accepts a string only, never a record.

使用示例

• 上下文片段：明确来源、信任和预算：Core 识别片段与装配合同，校验来源元数据和预算，不内置业务压缩算法。

用裸配置装配一份输入

入门 · 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);

增加候选计划与最终审计

配置 · Node.js

可变片段列表为空，表示不允许修改原片段；不会自动授权一个压缩步骤。

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

相关策略源码

• 片段校验与预算拒绝

相关定义

• ContextLifetime
• ContextTrust