ContextSelectionCandidate

SUPPORT · interface · Type contract

Candidate step considered by selection, with its measured cost.

Import

TypeScript

import type { ContextSelectionCandidate } from '@jangts/agent-core/support';

JavaScript

/** @typedef {import('@jangts/agent-core/support').ContextSelectionCandidate} ContextSelectionCandidate */

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

Definition

interface ContextSelectionCandidate

Field structure

Field	Type	Required	Description
id	string	Required	See the type definition and usage context.
kind	"trim" | "compress"	Required	See the type definition and usage context.
fragmentId	string	Required	See the type definition and usage context.
chars	number	Required	Current size of the candidate fragment, in JSON characters.
targetChars	number	Required	Size the step would reduce the fragment to.
requiredCalls	number	Required	Model calls required to apply the step; 0 for local steps.
projectedChars	number | undefined	Optional	Exact dry-run result for trim. Compression size is not predicted.
trimLossRatio	number | undefined	Optional	Fraction of characters removed by a trim step; meaningless for compression.

Examples

• Selecting reduction steps: sequence, fixed, automatic, or model: One typed policy set expresses multiple scenarios while preserving exact parameters and App-defined selection.

Process in registered order

Beginner · Node.js

TypeScript

import { Support } from '@jangts/agent-core';
Support.validateContextSelection({ mode: 'sequence' }, []);
console.log(Object.keys(Support.contextSelectionCatalog));

JavaScript

import { Support } from '@jangts/agent-core';
Support.validateContextSelection({ mode: 'sequence' }, []);
console.log(Object.keys(Support.contextSelectionCatalog));

Choose a policy per scenario with exact overrides

Configuration · Node.js

TypeScript

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

JavaScript

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

Related policy source

• Selection policy catalog, reserved quota, and feasibility filtering

Related definitions

• ContextReduction