/**
 * Pure, project-relative rendering for Init's managed agent guidance.
 */
import type { ToolScaffold } from '../shared.js';
import type { AgentGuidanceTargetResult } from '@opensip-cli/contracts';
export declare const AGENT_GUIDANCE_START = "<!-- opensip:agent-guidance start -->";
export declare const AGENT_GUIDANCE_END = "<!-- opensip:agent-guidance end -->";
export declare const MAX_AGENT_GUIDANCE_FILE_BYTES: number;
export interface AgentGuidanceTargetSpec {
    readonly relativePath: string;
    readonly create: 'always' | 'if-parent-exists' | 'never';
    readonly kind: 'playbook' | 'block';
}
type ToolScaffoldLayout = Pick<ToolScaffold, 'layout'>;
export type AgentGuidanceReadFailure = 'stat-error' | 'too-large' | 'read-error';
export type AgentGuidanceTargetSnapshot = {
    readonly relativePath: string;
    readonly status: 'missing';
    readonly parentExists: boolean;
} | {
    readonly relativePath: string;
    readonly status: 'present';
    readonly content: string;
} | {
    readonly relativePath: string;
    readonly status: 'unreadable';
    readonly reason: AgentGuidanceReadFailure;
};
export interface RenderedAgentGuidanceTarget {
    readonly relativePath: string;
    readonly action: AgentGuidanceTargetResult['action'];
    readonly reason?: string;
    /** Exact desired bytes for created, updated, and unchanged targets. */
    readonly content?: string;
}
export interface RenderedAgentGuidance {
    readonly changed: boolean;
    readonly targets: readonly RenderedAgentGuidanceTarget[];
}
export declare function listAgentGuidanceTargetSpecs(): readonly AgentGuidanceTargetSpec[];
export declare function buildManagedAgentGuidance(): string;
export declare function upsertManagedBlock(content: string, block: string): {
    readonly content: string;
    readonly changed: boolean;
};
export declare function renderAgentGuidanceTargets(snapshots: readonly AgentGuidanceTargetSnapshot[], opts: {
    readonly toolScaffolds: readonly ToolScaffoldLayout[];
}): RenderedAgentGuidance;
export {};
//# sourceMappingURL=agent-guidance-renderer.d.ts.map