ContextHandlerReference
SUPPORT · interface · 类型合同
Reference to a registered compressor or selector handler.
导入
ts
import type { ContextHandlerReference } from '@jangts/agent-core/support';js
/** @typedef {import('@jangts/agent-core/support').ContextHandlerReference} ContextHandlerReference */其他公开入口：@jangts/agent-core/support、@jangts/agent-core/support/context。
定义
ts
interface ContextHandlerReference字段结构
| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
handlerId | string | 必需 | 只读。Registered handler id; an unknown id is rejected before execution. |
使用示例
- 上下文策略：验证、缩减与审计：Support 给出可替换的策略实现，Core 保留最终输入合同和预算检查。
- 选择缩减步骤：顺序、固定、自动或模型：一套类型化策略表达多种场景，保留精确参数与 App 自定义选择。
- Support：推荐用法的聚合入口：Support 聚合推荐的构造、策略与同源配置生成；Core 运行不依赖这个命名空间。
- 从历史语义生成处理策略：复用片段身份与硬预算，生成 recent 或 continuity 的完整步骤和引用。
显式使用只校验策略
入门 · Node.js
ts
import { Support } from '@jangts/agent-core';
import type { ContextPolicy } from '@jangts/agent-core/support/context';
const policy: ContextPolicy = { mode: 'validate' };
Support.validateContextPolicy(policy, [], []);
console.log(policy.mode);js
import { Support } from '@jangts/agent-core';
const policy = { mode: 'validate' };
Support.validateContextPolicy(policy, [], []);
console.log(policy.mode);从真实业务片段配置缩减顺序
配置 · Node.js
这些数字是示例业务的显式选择，不是 SDK 推荐适用于所有模型的容量。
ts
import { Support } from '@jangts/agent-core';
import type { ContextPolicy } from '@jangts/agent-core/support/context';
const policy: ContextPolicy = { mode: 'reduce', triggerChars: 1800, targetInputChars: 1500,
selection: { mode: 'sequence' },
steps: [{ id: 'recent-history', kind: 'trim', fragmentId: 'history', field: 'messages',
grouping: { kind: 'user-turn' }, keepGroups: 2, targetChars: 1000 }],
};
Support.validateContextPolicy(policy, [], []);
console.log(policy.steps);js
import { Support } from '@jangts/agent-core';
const policy = { mode: 'reduce', triggerChars: 1800, targetInputChars: 1500,
selection: { mode: 'sequence' },
steps: [{ id: 'recent-history', kind: 'trim', fragmentId: 'history', field: 'messages',
grouping: { kind: 'user-turn' }, keepGroups: 2, targetChars: 1000 }],
};
Support.validateContextPolicy(policy, [], []);
console.log(policy.steps);