Function auto_generate_for_workspace 

pub fn auto_generate_for_workspace(
    clients_cfg: &ClientsConfig,
    workspace_dir: &Path,
    idl_paths: &[PathBuf],
) -> Result<()>

Convenience entry point for the anchor build integration: reads the [clients] section of Anchor.toml, expands it into resolved (Language, output_path) targets, and runs Codama for each IDL produced by the build.

workspace_dir is the root of the workspace (the directory containing Anchor.toml); IDL files are expected at <workspace_dir>/target/idl/*.json (the standard anchor build output). When the workspace ships more than one program the configured per-language path is treated as a base directory and clients land at <base>/<program> to avoid clobbering.