import type { ContextItem, PackedItem } from '../types';
/**
 * Position-aware placement based on "Lost in the Middle" research.
 *
 * LLMs attend most to the beginning and end of the context window.
 * This function arranges items to exploit that:
 *
 * - Items with `position: 'beginning'` → pinned at the start (primacy)
 * - Items with `position: 'end'` → pinned at the end (recency)
 * - Floating items (no position) → edges-first by score:
 *   highest-scored items alternate between beginning and end,
 *   pushing lower-scored items toward the middle where attention is weakest.
 */
export declare function applyPlacement(items: ContextItem[]): PackedItem[];