mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-06-11 11:57:03 -07:00
Your Name
46 lines
1.3 KiB
TypeScript
46 lines
1.3 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright 2026 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
import type { EpisodeEditor } from './ir/episodeEditor.js';
|
|
|
|
/**
|
|
* State object passed through the processing pipeline.
|
|
* Contains global accounting logic and semantic protection rules.
|
|
*/
|
|
export interface ContextAccountingState {
|
|
readonly currentTokens: number;
|
|
readonly maxTokens: number;
|
|
readonly retainedTokens: number;
|
|
|
|
/** The exact number of tokens that need to be trimmed to reach the retainedTokens goal */
|
|
readonly deficitTokens: number;
|
|
|
|
/**
|
|
* Set of Episode IDs that the orchestrator has deemed highly protected.
|
|
* Processors should generally skip mutating these episodes unless doing proactive/required transforms.
|
|
*/
|
|
readonly protectedEpisodeIds: Set<string>;
|
|
|
|
/**
|
|
* True if currentTokens <= retainedTokens.
|
|
*/
|
|
readonly isBudgetSatisfied: boolean;
|
|
}
|
|
|
|
/**
|
|
* Interface for all context degradation strategies.
|
|
*/
|
|
export interface ContextProcessor {
|
|
/** Unique name for telemetry and logging. */
|
|
readonly name: string;
|
|
|
|
/**
|
|
* Processes the episodic history payload via the provided EpisodeEditor, based on the current accounting state.
|
|
* Processors should safely mutate or replace episodes using the editor's API.
|
|
*/
|
|
process(editor: EpisodeEditor, state: ContextAccountingState): Promise<void>;
|
|
}
|