选择缩减步骤：顺序、固定、自动或模型
一套类型化策略表达多种场景，保留精确参数与 App 自定义选择。
sequence 保持登记顺序；fixed 选择某种 kind；auto 优先选择损失比例在阈值内的可裁切项，否则选择压缩；model 调用已登记 selector 返回唯一、可行的 stepIds。
auto 的 maxTrimLossRatio 默认 0.25，是 JSON 字符减少比例的启发式，不是语义信息损失百分比。auto/model 默认 reserveCalls=1，为最终回答保留调用；handler maxCalls 默认 1，本地算法可明确声明 0。
选择前根据真实可用调用额度排除不可行候选。空 stepIds 表示没有执行缩减，不隐式改为全部步骤；最终仍超预算就拒绝。选择器也不能通过返回未知 ID 或累计调用超额来扩大能力。
由简到繁的同业务示例
按已登记顺序处理
入门 · Node.js
ts
import { Support } from '@jangts/agent-core';
Support.validateContextSelection({ mode: 'sequence' }, []);
console.log(Object.keys(Support.contextSelectionCatalog));js
import { Support } from '@jangts/agent-core';
Support.validateContextSelection({ mode: 'sequence' }, []);
console.log(Object.keys(Support.contextSelectionCatalog));按场景选择策略并精确覆盖
配置 · Node.js
ts
import { Support } from '@jangts/agent-core';
const localOnly = { mode: 'fixed' as const, kind: 'trim' as const };
const preserveMore = { mode: 'auto' as const, maxTrimLossRatio: 0.1, reserveCalls: 2 };
Support.validateContextSelection(localOnly, []);
Support.validateContextSelection(preserveMore, []);
console.log(localOnly, preserveMore);js
import { Support } from '@jangts/agent-core';
const localOnly = { mode: 'fixed', kind: 'trim' };
const preserveMore = { mode: 'auto', maxTrimLossRatio: 0.1, reserveCalls: 2 };
Support.validateContextSelection(localOnly, []);
Support.validateContextSelection(preserveMore, []);
console.log(localOnly, preserveMore);