/**
 * Helper utilities for SEO tool implementations.
 */
import type { AgentToolResult } from "../../../sdk/coding-agent/index.js";
/** Structured details for tool results. */
export interface ToolDetails<T = unknown> {
    isError?: boolean;
    result?: T;
    warnings?: string[];
    metadata?: Record<string, unknown>;
}
/** Version of the SEO tool result schema. Increment on breaking changes. */
export declare const SEO_RESULT_VERSION = 2;
/** Create a text tool result. Accepts either legacy (text, details) or new (text, result, warnings). */
export declare function textResult(text: string, detailsOrResult?: Record<string, unknown> | unknown, warnings?: string[]): AgentToolResult<ToolDetails>;
/** Create an error tool result. Accepts either legacy (msg, details) or new (msg, result, warnings). */
export declare function errorResult(message: string, detailsOrResult?: Record<string, unknown> | unknown, warnings?: string[]): AgentToolResult<ToolDetails>;
/** Format a JSON object as pretty-printed text for tool output. */
export declare function jsonText(obj: unknown): string;
/** Truncate text to a maximum length. */
export declare function truncate(text: string, maxLen: number): string;
/** Validate and normalize a tool URL input, enforcing length limits. */
export declare function validateToolUrl(raw: string, maxLen?: number): string;
//# sourceMappingURL=helpers.d.ts.map