import type { InbandTool } from "./types.js";
/**
 * Render a tool's examples as an `<examples>` block. Calls render in Python
 * keyword-argument syntax (`name(key="value", n=1)`) regardless of the model's
 * tool-call dialect, so example bytes stay identical across models. Multiline
 * string args render as verbatim `"""…"""` blocks, and a call whose only
 * argument is a string renders as the bare value — the block already names the
 * tool, and payload args (commands, code, patches) read best verbatim.
 */
export declare function renderToolExamples(tool: InbandTool, intentField?: string): string;
/**
 * Render a tool's examples as JSDoc-style `@example` lines for comment-gutter
 * contexts (the Harmony `namespace functions` inventory): `@example "caption"`
 * followed by the call in the same Python kwargs syntax as the wire block. The
 * tag line delimits each example, so no XML envelope is needed — which is why
 * the inventory uses this instead of `//`-prefixing the `<examples>` block.
 */
export declare function renderToolExamplesJsdoc(tool: InbandTool): string;