import { type MessageTokenBreakdown } from "../../chat/message-prep.js";
import type { InferSchema } from "../../extensions/schema/index.js";
import type { AgentRuntimeMessage } from "../runtime/message-adapter.js";
export declare const AGENT_RUN_CONTEXT_COMPACTED_EVENT_TYPE: "AGENT_RUN_CONTEXT_COMPACTED";
export declare const getContextCompactionSummarySchema: () => import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
    text: import("../../internal-agents/schema.js").Schema<string>;
}>>;
export declare const getContextCompactionEventPayloadSchema: () => import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
    type: import("../../internal-agents/schema.js").Schema<"AGENT_RUN_CONTEXT_COMPACTED">;
    summary: import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
        text: import("../../internal-agents/schema.js").Schema<string>;
    }>>;
    firstKeptEntryId: import("../../internal-agents/schema.js").Schema<string>;
    tokensBefore: import("../../internal-agents/schema.js").Schema<number>;
    tokensAfter: import("../../internal-agents/schema.js").Schema<number>;
    tokenBudget: import("../../internal-agents/schema.js").Schema<number>;
    reserveTokens: import("../../internal-agents/schema.js").Schema<number>;
    reason: import("../../internal-agents/schema.js").Schema<"context_window" | "transport_body">;
}>>;
export type ContextCompactionSummary = InferSchema<ReturnType<typeof getContextCompactionSummarySchema>>;
export type ContextCompactionEventPayload = InferSchema<ReturnType<typeof getContextCompactionEventPayloadSchema>>;
export type ContextCompactionReason = ContextCompactionEventPayload["reason"];
export type ContextSummaryGenerator = (input: {
    messagesToSummarize: AgentRuntimeMessage[];
    retainedMessages: AgentRuntimeMessage[];
    customInstructions?: string;
}) => Promise<ContextCompactionSummary> | ContextCompactionSummary;
export type ContextBudgetManagerOptions = {
    tokenBudget: number;
    reserveTokens: number;
    recentTailTokens: number;
    minimumRecentTurns?: number;
    maxSummaryTokens?: number;
    customInstructions?: string;
    reason?: ContextCompactionReason;
    now?: () => number;
    summaryGenerator: ContextSummaryGenerator;
};
export type ContextBudgetDiagnostics = {
    compacted: boolean;
    tokensBefore: number;
    tokensAfter: number;
    beforeBreakdown: MessageTokenBreakdown;
    afterBreakdown: MessageTokenBreakdown;
    tokenBudget: number;
    reserveTokens: number;
    summaryTokens: number;
    retainedTailTokens: number;
    reason: ContextCompactionReason;
};
export type ContextBudgetManagerResult = {
    messages: AgentRuntimeMessage[];
    eventPayload?: ContextCompactionEventPayload;
    diagnostics: ContextBudgetDiagnostics;
};
export declare class ContextCompactionError extends Error {
    constructor(message: string, options?: {
        cause?: unknown;
    });
}
/** Apply hosted-chat context budget management. */
export declare function applyContextBudget(messages: readonly AgentRuntimeMessage[], options: ContextBudgetManagerOptions): Promise<ContextBudgetManagerResult>;
//# sourceMappingURL=context-budget-manager.d.ts.map