/**
 * PROV-AGENT Metadata Builder
 *
 * Builds agent metadata for provenance records.
 * Records model names, versions, parameters for AI operations.
 * Records user context for user-triggered actions.
 *
 * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
 *
 * @module services/provenance/agent-metadata
 */
export interface AgentMetadata {
    agent_type: 'ai_model' | 'user' | 'system';
    model_name?: string;
    model_version?: string;
    temperature?: number;
    max_tokens?: number;
    token_count?: {
        input: number;
        output: number;
    };
    confidence?: number;
    user_id?: string;
    session_id?: string;
    client_type?: string;
    duration_ms?: number;
}
/**
 * Build agent metadata for OCR processing operations.
 *
 * @param params - OCR operation parameters
 * @returns Serialized JSON string of agent metadata
 */
export declare function buildOCRAgentMetadata(params: {
    mode: string;
    durationMs: number;
    pageCount: number;
}): string;
/**
 * Build agent metadata for embedding generation operations.
 *
 * @param params - Embedding operation parameters
 * @returns Serialized JSON string of agent metadata
 */
export declare function buildEmbeddingAgentMetadata(params: {
    model: string;
    device: string;
    batchSize: number;
    chunkCount: number;
    durationMs: number;
}): string;
/**
 * Build agent metadata for VLM (Vision Language Model) operations.
 *
 * @param params - VLM operation parameters
 * @returns Serialized JSON string of agent metadata
 */
export declare function buildVLMAgentMetadata(params: {
    model: string;
    tokensUsed?: number;
    confidence?: number;
    durationMs?: number;
}): string;
/**
 * Build agent metadata for user-triggered actions.
 *
 * @param params - User action parameters
 * @returns Serialized JSON string of agent metadata
 */
export declare function buildUserAgentMetadata(params: {
    userId?: string;
    sessionId?: string;
    action: string;
}): string;
/**
 * Build agent metadata for system-triggered actions (migrations, background tasks).
 *
 * @param action - Description of the system action
 * @returns Serialized JSON string of agent metadata
 */
export declare function buildSystemAgentMetadata(action: string): string;
//# sourceMappingURL=agent-metadata.d.ts.map