import type { PageContext, TranscriptSystemPrompt } from '../../shared/types.js';
import type { ResolvedSkill } from '../skills/types.js';
import type { ActivePlanContext, SystemPromptBlock } from '../system-prompts/types.js';
/**
 * Build structured system prompt blocks for the AI agent.
 * Returns an array of text blocks with optional cache hints.
 *
 * Prompts are sorted by cacheGroup (static → per-page → per-turn), then by weight.
 * A cacheHint is placed on the last block of each cacheable group boundary,
 * enabling providers to apply their caching strategy.
 */
export declare function buildSystemPrompt(context: PageContext, resolvedSkills: ResolvedSkill[], lazyTools?: {
    name: string;
    description: string;
}[], activePlan?: ActivePlanContext, loadedSkills?: ReadonlySet<string>): SystemPromptBlock[];
/**
 * Build a plain-text system prompt string (for transcript/debug use).
 */
export declare function buildSystemPromptText(context: PageContext, resolvedSkills: ResolvedSkill[], lazyTools?: {
    name: string;
    description: string;
}[], activePlan?: ActivePlanContext, loadedSkills?: ReadonlySet<string>): string;
/**
 * Build structured system prompt entries for the transcript.
 * Returns one entry per prompt definition with id, name, and content.
 */
export declare function buildSystemPromptEntries(context: PageContext, resolvedSkills: ResolvedSkill[], lazyTools?: {
    name: string;
    description: string;
}[], activePlan?: ActivePlanContext, loadedSkills?: ReadonlySet<string>): TranscriptSystemPrompt[];