import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
/** Extract the exact source of a heading's section from a markdown string. */
export declare function extractMarkdownSection(source: string, heading: string): string | null;
/** Render a heading-tree outline (with section line ranges) for a markdown string. */
export declare function outlineMarkdown(source: string, name: string): string;
/** List heading texts (in document order) for a markdown string. */
export declare function listMarkdownHeadings(source: string): string[];
/**
 * Build the `forge_markdown` tool. Read-only structural access to a Markdown
 * file. `projectRoot` anchors relative paths.
 */
export declare function buildForgeMarkdown(projectRoot: string): ToolDefinition;