import type { AgentMessage } from "./agent-types.js";
/**
 * Runtime attestation (ADR 0005 H9). Declares the implementation status
 * of each runtime export in this module. See CONTRIBUTING.md § Module
 * attestations for the category definitions and the convention for
 * updating these when sync or rebrand changes the surface.
 */
export declare const MODULE_ATTESTATIONS: {
    readonly sanitizeToolCallId: "live";
    readonly extractToolCallsFromAssistant: "live";
    readonly extractToolResultId: "live";
    readonly isValidCloudCodeAssistToolId: "live";
    readonly sanitizeToolCallIdsForCloudCodeAssist: "live";
};
export type ToolCallIdMode = "strict" | "strict9";
export type ToolCallLike = {
    id: string;
    name?: string;
};
/**
 * Sanitize a tool call ID to be compatible with various providers.
 *
 * - "strict" mode: only [a-zA-Z0-9]
 * - "strict9" mode: only [a-zA-Z0-9], length 9 (Mistral tool call requirement)
 */
export declare function sanitizeToolCallId(id: string, mode?: ToolCallIdMode): string;
export declare function extractToolCallsFromAssistant(msg: Extract<AgentMessage, {
    role: "assistant";
}>): ToolCallLike[];
export declare function extractToolResultId(msg: Extract<AgentMessage, {
    role: "toolResult";
}>): string | null;
export declare function isValidCloudCodeAssistToolId(id: string, mode?: ToolCallIdMode): boolean;
/**
 * Sanitize tool call IDs for provider compatibility.
 *
 * @param messages - The messages to sanitize
 * @param mode - "strict" (alphanumeric only) or "strict9" (alphanumeric length 9)
 */
export declare function sanitizeToolCallIdsForCloudCodeAssist(messages: AgentMessage[], mode?: ToolCallIdMode): AgentMessage[];