/**
 * The Reflector.
 *
 * When the persisted observation log itself exceeds the reflection token
 * threshold, the Reflector runs ONE internal (tool-less) agent call to condense
 * the observations into higher-level reflections, and persists a
 * `tier: "reflection"` entry. Observations are kept (they remain the dense
 * mid-tier); the reflection sits above them.
 */
import { type ObservationalMemoryConfig } from "./config.js";
import { type InternalAgentRunFn } from "./internal-run.js";
import type { ObservationalMemoryEntry, ObservationalMemoryOwner } from "./types.js";
export interface RunReflectorOptions extends ObservationalMemoryOwner {
    threadId: string;
    config?: Partial<ObservationalMemoryConfig>;
    /** Internal-run seam — defaults to the real one; injected in tests. */
    runInternal?: InternalAgentRunFn;
}
export interface RunReflectorResult {
    /** True when a reflection was produced and persisted. */
    reflected: boolean;
    entry?: ObservationalMemoryEntry;
    /** Tokens in the observation log that was considered. */
    observationLogTokens: number;
}
/**
 * Condense the observation log into a reflection IF it exceeds the token
 * threshold; otherwise no-op.
 */
export declare function runReflector(options: RunReflectorOptions): Promise<RunReflectorResult>;
//# sourceMappingURL=reflector.d.ts.map