rafflesia 0.1.0

data/lib/rafflesia/datasets.rb

@@ -0,0 +1,1442 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+require 'json'
+
+module Rafflesia
+  class Datasets
+    def initialize(client)
+      @client = client
+    end
+
+    # POST /v1/datasets/builds/build
+    # @param compact [Boolean, nil]
+    # @param compact_shard_size [Integer, nil]
+    # @param dataset_name [String, nil]
+    # @param dataset_version [String, nil]
+    # @param dry_run [Boolean, nil]
+    # @param from_manifest_path [String, nil] Optional source dataset manifest to reuse matching structures and table artifacts from while materializing requested missing tables into a new manifest.
+    # @param input_dir [String]
+    # @param input_paths [Array<String>, nil]
+    # @param manifest_path [String, nil]
+    # @param max_failure_count [Integer, nil]
+    # @param output_dir [String, nil]
+    # @param pocket_backend [Rafflesia::Types::DatasetBuildRequestPocketBackend, nil]
+    # @param pocket_cache_mode [Rafflesia::Types::DatasetBuildRequestPocketCacheMode, nil]
+    # @param profile [Boolean, nil]
+    # @param recursive [Boolean, nil]
+    # @param response_mode [Rafflesia::Types::DatasetBuildRequestResponseMode, nil] Response payload mode; full includes the inline manifest, summary/compact returns counts, object refs, table summaries, and manifest_path without embedding the manifest rows
+    # @param resume [Boolean, nil]
+    # @param source [String, nil]
+    # @param tables [Array<String>, nil]
+    # @param target_namespace [String, nil]
+    # @param threshold [Float, nil]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetBuildData]
+    def buildsBuild(
+      input_dir:,
+      compact: nil,
+      compact_shard_size: nil,
+      dataset_name: nil,
+      dataset_version: nil,
+      dry_run: nil,
+      from_manifest_path: nil,
+      input_paths: nil,
+      manifest_path: nil,
+      max_failure_count: nil,
+      output_dir: nil,
+      pocket_backend: nil,
+      pocket_cache_mode: nil,
+      profile: nil,
+      recursive: nil,
+      response_mode: nil,
+      resume: nil,
+      source: nil,
+      tables: nil,
+      target_namespace: nil,
+      threshold: nil,
+      request_options: {}
+    )
+      body = {
+        'compact' => compact,
+        'compact_shard_size' => compact_shard_size,
+        'dataset_name' => dataset_name,
+        'dataset_version' => dataset_version,
+        'dry_run' => dry_run,
+        'from_manifest_path' => from_manifest_path,
+        'input_dir' => input_dir,
+        'input_paths' => input_paths,
+        'manifest_path' => manifest_path,
+        'max_failure_count' => max_failure_count,
+        'output_dir' => output_dir,
+        'pocket_backend' => pocket_backend,
+        'pocket_cache_mode' => pocket_cache_mode,
+        'profile' => profile,
+        'recursive' => recursive,
+        'response_mode' => response_mode,
+        'resume' => resume,
+        'source' => source,
+        'tables' => tables,
+        'target_namespace' => target_namespace,
+        'threshold' => threshold
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/builds/build',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetBuildData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/compact
+    # @param manifest_path [String]
+    # @param output_dir [String, nil]
+    # @param output_manifest_path [String, nil]
+    # @param replace [Boolean, nil]
+    # @param shard_size [Integer, nil]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetCompactData]
+    def compact(
+      manifest_path:,
+      output_dir: nil,
+      output_manifest_path: nil,
+      replace: nil,
+      shard_size: nil,
+      request_options: {}
+    )
+      body = {
+        'manifest_path' => manifest_path,
+        'output_dir' => output_dir,
+        'output_manifest_path' => output_manifest_path,
+        'replace' => replace,
+        'shard_size' => shard_size
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/compact',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetCompactData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/comparisons/compare
+    # @param manifest_path_a [String]
+    # @param manifest_path_b [String]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetCompareData]
+    def comparisonsCompare(
+      manifest_path_a:,
+      manifest_path_b:,
+      request_options: {}
+    )
+      body = {
+        'manifest_path_a' => manifest_path_a,
+        'manifest_path_b' => manifest_path_b
+      }
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/comparisons/compare',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetCompareData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # GET /v1/datasets/list
+    # @param limit [Integer, nil]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetListData]
+    def list(
+      limit: nil,
+      request_options: {}
+    )
+      params = {
+        'limit' => limit
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: '/v1/datasets/list',
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetListData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/manifests/inspect
+    # @param manifest_path [String] Dataset manifest JSON path.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetManifestInspectData]
+    def manifestsInspect(
+      manifest_path:,
+      request_options: {}
+    )
+      body = {
+        'manifest_path' => manifest_path
+      }
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/manifests/inspect',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetManifestInspectData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/manifests/scan
+    # @param dataset_name [String, nil] Only include manifests whose dataset_name equals this value.
+    # @param failure_free [Boolean, nil] Only include manifests with zero recorded build failures and at least one non-empty table artifact.
+    # @param limit [Integer, nil] Maximum matched manifests to return after sorting.
+    # @param require_tables [Array<String>, nil] Only include manifests that contain every one of these table families.
+    # @param root [String] Directory scanned recursively for dataset manifest JSON files (typically a lake root).
+    # @param sort [Rafflesia::Types::DatasetManifestScanRequestSort, nil] Ordering: modified (freshest file first, default) or version (dataset_version descending).
+    # @param version_contains [String, nil] Only include manifests whose dataset_version contains this substring.
+    # @param version_prefix [String, nil] Only include manifests whose dataset_version starts with this prefix.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetManifestScanData]
+    def manifestsScan(
+      root:,
+      dataset_name: nil,
+      failure_free: nil,
+      limit: nil,
+      require_tables: nil,
+      sort: nil,
+      version_contains: nil,
+      version_prefix: nil,
+      request_options: {}
+    )
+      body = {
+        'dataset_name' => dataset_name,
+        'failure_free' => failure_free,
+        'limit' => limit,
+        'require_tables' => require_tables,
+        'root' => root,
+        'sort' => sort,
+        'version_contains' => version_contains,
+        'version_prefix' => version_prefix
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/manifests/scan',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetManifestScanData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Stream one verified immutable relation-release object.
+    # @param expected_sha_256 [String]
+    # @param expected_size_bytes [Integer]
+    # @param kind [String, nil]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Hash{String => Object}]
+    def relationReleasesObjectsUpload(
+      expected_sha_256:,
+      expected_size_bytes:,
+      kind: nil,
+      request_options: {}
+    )
+      params = {
+        'expected_sha256' => expected_sha_256,
+        'expected_size_bytes' => expected_size_bytes,
+        'kind' => kind
+      }.compact
+      response = @client.request(
+        method: :put,
+        path: '/v1/datasets/relation-releases/objects/upload',
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      JSON.parse(response.body)
+    end
+
+    # POST /v1/datasets/relation-releases/publish
+    # @param artifacts [Array<Rafflesia::RelationReleasePublicationArtifact>, nil]
+    # @param created_at [String, nil]
+    # @param database [String]
+    # @param dataset_kind [String, nil]
+    # @param dry_run [Boolean, nil] Validate the immutable publication without uploading objects, materializing ClickHouse relations, or publishing the catalog release.
+    # @param manifest_object_id [String, nil] Immutable content-addressed release manifest uploaded before the atomic release commit.
+    # @param manifest_path [String, nil] Compatibility-only server-local path to the release manifest. Remote publishers should use manifest_object_id.
+    # @param manifest_sha_256 [String, nil] Expected SHA-256 digest for manifest_object_id.
+    # @param manifest_size_bytes [Integer, nil] Expected byte size for manifest_object_id.
+    # @param release [String]
+    # @param release_digest [String]
+    # @param source [String, nil]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeRelationReleasePublicationData]
+    def relationReleasesPublish(
+      artifacts:,
+      database:,
+      release:,
+      release_digest:,
+      created_at: nil,
+      dataset_kind: nil,
+      dry_run: nil,
+      manifest_object_id: nil,
+      manifest_path: nil,
+      manifest_sha_256: nil,
+      manifest_size_bytes: nil,
+      source: nil,
+      request_options: {}
+    )
+      body = {
+        'artifacts' => artifacts,
+        'created_at' => created_at,
+        'database' => database,
+        'dataset_kind' => dataset_kind,
+        'dry_run' => dry_run,
+        'manifest_object_id' => manifest_object_id,
+        'manifest_path' => manifest_path,
+        'manifest_sha256' => manifest_sha_256,
+        'manifest_size_bytes' => manifest_size_bytes,
+        'release' => release,
+        'release_digest' => release_digest,
+        'source' => source
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/relation-releases/publish',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeRelationReleasePublicationData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/audit
+    # @param audit_object_id [String, nil] Content-addressed audit object id to decode directly.
+    # @param corpus [String, nil] Immutable corpus name. Required when ref and audit_object_id are omitted.
+    # @param object_store_root [String, nil] Optional local or object-storage root. Defaults to the API server's release data root.
+    # @param ref [String, nil] Optional immutable release ref formatted as corpus:release_id. When set, the audit chain for the corpus is searched for this release.
+    # @param release_id [String, nil] Immutable release id. Required with corpus when ref and audit_object_id are omitted.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseAuditData]
+    def releasesAudit(
+      audit_object_id: nil,
+      corpus: nil,
+      object_store_root: nil,
+      ref: nil,
+      release_id: nil,
+      request_options: {}
+    )
+      body = {
+        'audit_object_id' => audit_object_id,
+        'corpus' => corpus,
+        'object_store_root' => object_store_root,
+        'ref' => ref,
+        'release_id' => release_id
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/audit',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseAuditData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/backfill
+    # @param corpus [String, nil] Optional corpus name. When omitted, all corpora under the release root are scanned.
+    # @param dry_run [Boolean, nil] When true, inspect release manifests without writing catalog rows.
+    # @param limit [Integer, nil] Maximum release manifests to scan. Defaults to 1000.
+    # @param object_store_root [String, nil] Optional local or object-storage release root. Defaults to the API server's release data root.
+    # @param publish_aliases [Boolean, nil] When true, sync object-store current pointers into catalog aliases. Defaults to true unless dry_run is set.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseBackfillData]
+    def releasesBackfill(
+      corpus: nil,
+      dry_run: nil,
+      limit: nil,
+      object_store_root: nil,
+      publish_aliases: nil,
+      request_options: {}
+    )
+      body = {
+        'corpus' => corpus,
+        'dry_run' => dry_run,
+        'limit' => limit,
+        'object_store_root' => object_store_root,
+        'publish_aliases' => publish_aliases
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/backfill',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseBackfillData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/benchmark
+    # @param calibrated_query_profiles_path [String, nil] Optional output path for calibrated rerun query profiles. Defaults beside query_profiles_path.
+    # @param calibrated_sequence_planner_mode [Rafflesia::Types::CorpuReleaseBenchmarkRequestCalibratedSequencePlannerMode, nil] Planner mode for the calibrated rerun. Defaults to v7.
+    # @param candidate_rank_strategy [Rafflesia::Types::CorpuReleaseBenchmarkRequestCandidateRankStrategy, nil] Candidate ranking key used before optional verification.
+    # @param corpus [String] Benchmark corpus name.
+    # @param exact_rerank [Boolean, nil] When true for structure_prefilter benchmarks, exact-rerank benchmark queries with a pairwise structure aligner.
+    # @param exact_rerank_backend [Rafflesia::Types::CorpuReleaseBenchmarkRequestExactRerankBackend, nil] Pairwise backend used by exact_rerank benchmark searches. Defaults to tmalign unless a preset fills it.
+    # @param exact_rerank_rank_key [Rafflesia::Types::CorpuReleaseBenchmarkRequestExactRerankRankKey, nil] Measurement used to order exact_rerank benchmark hits.
+    # @param family [Rafflesia::Types::CorpuReleaseBenchmarkRequestFamily, nil] Search family to build and benchmark. Defaults to sequence_prefilter.
+    # @param foldseek_binary_path [String, nil] Optional absolute Foldseek binary path used for 3Di-compatible raw-structure token extraction in structure_prefilter builds.
+    # @param input_path [String, nil] Input FASTA path for seed or sequence_prefilter families. For structure_prefilter, this may be a structure-token TSV path, a raw PDB/mmCIF file, or a directory of raw PDB/mmCIF files.
+    # @param kmer_size [Integer, nil] k-mer size used by seed and sequence prefilter releases.
+    # @param max_bytes_per_query [Float, nil] Optional query-profile audit gate limiting max bytes read per query.
+    # @param max_bytes_per_query_increase [Float, nil] Optional previous-run comparison gate limiting max bytes-per-query increase.
+    # @param max_candidates [Integer, nil] Optional cap on ranked candidates before max_hits.
+    # @param max_candidates_grid [Array<Integer>, nil] Candidate caps to sweep; overrides max_candidates when set.
+    # @param max_final_recall_regression [Float, nil] Optional previous-run comparison gate limiting recall regression.
+    # @param max_hits [Integer, nil] Maximum hits requested per recall query.
+    # @param max_latency_ms [Float, nil] Optional query-profile audit gate limiting max latency per query.
+    # @param max_latency_ms_increase [Float, nil] Optional previous-run comparison gate limiting max latency increase.
+    # @param max_object_bytes_total [Integer, nil] Optional gate limiting object bytes per benchmark row.
+    # @param max_object_reads_increase [Float, nil] Optional previous-run comparison gate limiting max object-read increase.
+    # @param max_object_reads_per_query [Float, nil] Optional query-profile audit gate limiting max object reads per query.
+    # @param max_object_reads_total [Integer, nil] Optional gate limiting object reads per benchmark row.
+    # @param max_postings_per_block [Array<Integer>, nil] Postings block sizes to sweep.
+    # @param max_query_posting_blocks [Integer, nil] Optional cap on selected query posting blocks.
+    # @param max_query_posting_blocks_grid [Array<Integer>, nil] Posting-block caps to sweep; use 0 for uncapped.
+    # @param max_shards [Integer, nil] Optional cap on routed shards per query.
+    # @param max_shards_grid [Array<Integer>, nil] Routed shard caps to sweep; use 0 for uncapped.
+    # @param max_token_frequency [Array<Integer>, nil] Token-frequency caps to sweep. Use 0 for uncapped.
+    # @param max_verifications [Integer, nil] Optional cap on candidates aligned in verification modes.
+    # @param max_verifications_grid [Array<Integer>, nil] Verification caps to sweep; overrides max_verifications when set.
+    # @param min_candidate_pool_recall [Float, nil] Optional query-profile audit gate requiring minimum candidate-pool recall.
+    # @param min_final_recall_at_k [Float, nil] Optional query-profile audit gate requiring minimum final recall@k.
+    # @param min_hit_rate_at_k [Float, nil] Optional gate requiring every benchmark row with recall data to meet this hit-rate@k threshold.
+    # @param min_mean_recall_at_k [Float, nil] Optional gate requiring every benchmark row with recall data to meet this mean recall@k threshold.
+    # @param minimizer_window [Integer, nil] Minimizer window used by the sequence prefilter family.
+    # @param object_store_root [String, nil] Optional local object-store root. Defaults to the API server's release data root.
+    # @param payload_records_per_block [Array<Integer>, nil] Payload block sizes to sweep.
+    # @param planner_delta_artifact_path [String, nil] Optional output path for the planner calibration delta artifact. Defaults beside query_profiles_path.
+    # @param postings_range_coalesce_gap_bytes [Integer, nil] Maximum gap in bytes between postings ranges that may be coalesced.
+    # @param postings_range_coalesce_gap_bytes_grid [Array<Integer>, nil] Postings range-coalescing gap values to sweep.
+    # @param postings_range_coalesce_max_span_bytes [Integer, nil] Maximum fused postings range span in bytes.
+    # @param postings_range_coalesce_max_span_bytes_grid [Array<Integer>, nil] Postings range-coalescing max-span values to sweep.
+    # @param previous_query_profile_audit_path [String, nil] Optional previous audit.json path for run-to-run planner regression comparison.
+    # @param queries_jsonl_path [String, nil] Optional recall query JSONL path. Each line contains query_id, sequence or structure_tokens, and expected_ids.
+    # @param query_mode [Rafflesia::Types::CorpuReleaseBenchmarkRequestQueryMode, nil] Query mode used by recall benchmark searches.
+    # @param query_profile_audit_engine [Rafflesia::Types::CorpuReleaseBenchmarkRequestQueryProfileAuditEngine, nil] Audit engine for query_profiles_path. Defaults to duckdb.
+    # @param query_profile_audit_limit [Integer, nil] Maximum rows per query-profile audit detail section.
+    # @param query_profile_audit_output_dir [String, nil] Optional output directory for audit.json and audit.md generated from query_profiles_path.
+    # @param query_profile_audit_timeout_ms [Integer, nil] Optional query-profile audit timeout in milliseconds.
+    # @param query_profile_audit_write_markdown [Boolean, nil] Whether to write audit.md alongside audit.json.
+    # @param query_profile_max_result_set_ids [Integer, nil] Maximum retained IDs per result_sets array during profile validation; 0 uses backend default.
+    # @param query_profiles_path [String, nil] Optional output path for Biosearch query-profile JSONL generated by the release benchmark. Sequence benchmarks write sequence_query_profile.v1; structure benchmarks write structure_query_profile.v1. Defaults under the local object-store root.
+    # @param release_prefix [String, nil] Prefix used for immutable release ids produced by the sweep.
+    # @param rerank_limit [Integer, nil] Maximum structure benchmark candidates to exact-rerank. Defaults to max_hits.
+    # @param routing_mode [Rafflesia::Types::CorpuReleaseBenchmarkRequestRoutingMode, nil] Router selection mode for sharded benchmark searches.
+    # @param routing_mode_grid [Array<String>, nil] Router modes to sweep.
+    # @param routing_shard_count [Array<Integer>, nil] Router shard counts to sweep. Defaults to 1 when omitted.
+    # @param routing_shard_layout [Array<String>, nil] Router shard assignment layouts to sweep: record_id_hash, token_minhash, or biological_minhash.
+    # @param run_planner_calibration_loop [Boolean, nil] When true for sequence_prefilter benchmarks, run baseline queries, compile a read-yield calibration profile, rerun calibrated queries, and write a planner-delta artifact.
+    # @param run_structure_pair_geometry_ab [Boolean, nil] When true for structure_prefilter, run baseline and residue-pair geometry searches over the same compiled release and emit comparison evidence artifacts.
+    # @param sequence_planner_calibration_output_path [String, nil] Optional output path for the benchmark-derived planner calibration profile. Defaults beside query_profiles_path.
+    # @param sequence_planner_calibration_path [String, nil] Optional input JSON planner calibration profile used by v7/v8 sequence benchmark searches.
+    # @param sequence_planner_mode [Rafflesia::Types::CorpuReleaseBenchmarkRequestSequencePlannerMode, nil] Planner mode used by sequence_prefilter benchmark searches.
+    # @param similar_kmer_max_variants [Integer, nil] Maximum similar posting grams retained per query gram when similar_kmer_threshold is set.
+    # @param similar_kmer_threshold [Integer, nil] Optional 3Di substitution-matrix threshold for expanding query grams to similar posting grams in structure_prefilter benchmarks.
+    # @param simulated_read_latency_ms [Integer, nil] Optional fixed read latency injected into object-store reads.
+    # @param structure_coordinate_paths [Hash{String => String}, nil] Optional structure_prefilter record id to raw PDB/mmCIF path map. Stored with every generated release so exact rerank can use release coordinates without caller-supplied targets.
+    # @param structure_gram_size [Integer, nil] Structure-token gram size used by the structure prefilter family.
+    # @param structure_pair_geometry_evidence_jsonl_path [String, nil] Optional output path for per-query baseline-vs-pair-geometry JSONL evidence. Defaults beside query_profiles_path.
+    # @param structure_pair_geometry_evidence_tsv_path [String, nil] Optional output path for per-query baseline-vs-pair-geometry TSV evidence. Defaults beside query_profiles_path.
+    # @param structure_pair_geometry_max_query_tokens [Integer, nil] Maximum residue-pair query tokens selected by increasing posting frequency. Defaults to max_query_posting_blocks, then 256.
+    # @param structure_pair_geometry_min_shared_pairs [Integer, nil] Minimum shared residue-pair tokens required for pair-only candidate promotion. Defaults to 1.
+    # @param structure_pair_geometry_shift_bins [Boolean, nil] When true, expand residue-pair query tokens to adjacent sequence-distance bins.
+    # @param structure_pair_geometry_summary_path [String, nil] Optional output path for the structure pair-geometry comparison summary JSON. Defaults beside query_profiles_path.
+    # @param structure_search_preset [Rafflesia::Types::CorpuReleaseBenchmarkRequestStructureSearchPreset, nil] Optional structure_prefilter search preset that fills unset candidate-generation and verification knobs in benchmark searches.
+    # @param structure_token_extractor [Rafflesia::Types::CorpuReleaseBenchmarkRequestStructureTokenExtractor, nil] Structure-token extractor for raw structure_prefilter inputs. auto preserves current behavior: use foldseek when foldseek_binary_path is set, otherwise use the native geometry tokenizer.
+    # @param structure_tokens_path [String, nil] Input structure-token TSV path for the structure_prefilter family. Each row is '<id><tab><structure-token-string>'.
+    # @param target_shard_score_coverage [Float, nil] Adaptive routing target score coverage.
+    # @param target_shard_score_coverage_grid [Array<Float>, nil] Adaptive routing score-coverage targets to sweep; use 0 for unset.
+    # @param tmalign_binary_path [String, nil] Optional absolute TM-align binary path used for structure_prefilter exact_rerank benchmark queries.
+    # @param ungapped_diagonal_top_n [Integer, nil] Maximum candidate diagonals rescored by ungapped 3Di matrix HSP when candidate_rank_strategy is ungapped_3di_matrix.
+    # @param use_structure_pair_geometry [Boolean, nil] When true, benchmark structure_prefilter candidate generation with deterministic residue-pair geometry postings.
+    # @param verification_band [Integer, nil] Optional diagonal band for bounded verification alignment.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseBenchmarkData]
+    def releasesBenchmark(
+      corpus:,
+      calibrated_query_profiles_path: nil,
+      calibrated_sequence_planner_mode: nil,
+      candidate_rank_strategy: nil,
+      exact_rerank: nil,
+      exact_rerank_backend: nil,
+      exact_rerank_rank_key: nil,
+      family: nil,
+      foldseek_binary_path: nil,
+      input_path: nil,
+      kmer_size: nil,
+      max_bytes_per_query: nil,
+      max_bytes_per_query_increase: nil,
+      max_candidates: nil,
+      max_candidates_grid: nil,
+      max_final_recall_regression: nil,
+      max_hits: nil,
+      max_latency_ms: nil,
+      max_latency_ms_increase: nil,
+      max_object_bytes_total: nil,
+      max_object_reads_increase: nil,
+      max_object_reads_per_query: nil,
+      max_object_reads_total: nil,
+      max_postings_per_block: nil,
+      max_query_posting_blocks: nil,
+      max_query_posting_blocks_grid: nil,
+      max_shards: nil,
+      max_shards_grid: nil,
+      max_token_frequency: nil,
+      max_verifications: nil,
+      max_verifications_grid: nil,
+      min_candidate_pool_recall: nil,
+      min_final_recall_at_k: nil,
+      min_hit_rate_at_k: nil,
+      min_mean_recall_at_k: nil,
+      minimizer_window: nil,
+      object_store_root: nil,
+      payload_records_per_block: nil,
+      planner_delta_artifact_path: nil,
+      postings_range_coalesce_gap_bytes: nil,
+      postings_range_coalesce_gap_bytes_grid: nil,
+      postings_range_coalesce_max_span_bytes: nil,
+      postings_range_coalesce_max_span_bytes_grid: nil,
+      previous_query_profile_audit_path: nil,
+      queries_jsonl_path: nil,
+      query_mode: nil,
+      query_profile_audit_engine: nil,
+      query_profile_audit_limit: nil,
+      query_profile_audit_output_dir: nil,
+      query_profile_audit_timeout_ms: nil,
+      query_profile_audit_write_markdown: nil,
+      query_profile_max_result_set_ids: nil,
+      query_profiles_path: nil,
+      release_prefix: nil,
+      rerank_limit: nil,
+      routing_mode: nil,
+      routing_mode_grid: nil,
+      routing_shard_count: nil,
+      routing_shard_layout: nil,
+      run_planner_calibration_loop: nil,
+      run_structure_pair_geometry_ab: nil,
+      sequence_planner_calibration_output_path: nil,
+      sequence_planner_calibration_path: nil,
+      sequence_planner_mode: nil,
+      similar_kmer_max_variants: nil,
+      similar_kmer_threshold: nil,
+      simulated_read_latency_ms: nil,
+      structure_coordinate_paths: nil,
+      structure_gram_size: nil,
+      structure_pair_geometry_evidence_jsonl_path: nil,
+      structure_pair_geometry_evidence_tsv_path: nil,
+      structure_pair_geometry_max_query_tokens: nil,
+      structure_pair_geometry_min_shared_pairs: nil,
+      structure_pair_geometry_shift_bins: nil,
+      structure_pair_geometry_summary_path: nil,
+      structure_search_preset: nil,
+      structure_token_extractor: nil,
+      structure_tokens_path: nil,
+      target_shard_score_coverage: nil,
+      target_shard_score_coverage_grid: nil,
+      tmalign_binary_path: nil,
+      ungapped_diagonal_top_n: nil,
+      use_structure_pair_geometry: nil,
+      verification_band: nil,
+      request_options: {}
+    )
+      body = {
+        'calibrated_query_profiles_path' => calibrated_query_profiles_path,
+        'calibrated_sequence_planner_mode' => calibrated_sequence_planner_mode,
+        'candidate_rank_strategy' => candidate_rank_strategy,
+        'corpus' => corpus,
+        'exact_rerank' => exact_rerank,
+        'exact_rerank_backend' => exact_rerank_backend,
+        'exact_rerank_rank_key' => exact_rerank_rank_key,
+        'family' => family,
+        'foldseek_binary_path' => foldseek_binary_path,
+        'input_path' => input_path,
+        'kmer_size' => kmer_size,
+        'max_bytes_per_query' => max_bytes_per_query,
+        'max_bytes_per_query_increase' => max_bytes_per_query_increase,
+        'max_candidates' => max_candidates,
+        'max_candidates_grid' => max_candidates_grid,
+        'max_final_recall_regression' => max_final_recall_regression,
+        'max_hits' => max_hits,
+        'max_latency_ms' => max_latency_ms,
+        'max_latency_ms_increase' => max_latency_ms_increase,
+        'max_object_bytes_total' => max_object_bytes_total,
+        'max_object_reads_increase' => max_object_reads_increase,
+        'max_object_reads_per_query' => max_object_reads_per_query,
+        'max_object_reads_total' => max_object_reads_total,
+        'max_postings_per_block' => max_postings_per_block,
+        'max_query_posting_blocks' => max_query_posting_blocks,
+        'max_query_posting_blocks_grid' => max_query_posting_blocks_grid,
+        'max_shards' => max_shards,
+        'max_shards_grid' => max_shards_grid,
+        'max_token_frequency' => max_token_frequency,
+        'max_verifications' => max_verifications,
+        'max_verifications_grid' => max_verifications_grid,
+        'min_candidate_pool_recall' => min_candidate_pool_recall,
+        'min_final_recall_at_k' => min_final_recall_at_k,
+        'min_hit_rate_at_k' => min_hit_rate_at_k,
+        'min_mean_recall_at_k' => min_mean_recall_at_k,
+        'minimizer_window' => minimizer_window,
+        'object_store_root' => object_store_root,
+        'payload_records_per_block' => payload_records_per_block,
+        'planner_delta_artifact_path' => planner_delta_artifact_path,
+        'postings_range_coalesce_gap_bytes' => postings_range_coalesce_gap_bytes,
+        'postings_range_coalesce_gap_bytes_grid' => postings_range_coalesce_gap_bytes_grid,
+        'postings_range_coalesce_max_span_bytes' => postings_range_coalesce_max_span_bytes,
+        'postings_range_coalesce_max_span_bytes_grid' => postings_range_coalesce_max_span_bytes_grid,
+        'previous_query_profile_audit_path' => previous_query_profile_audit_path,
+        'queries_jsonl_path' => queries_jsonl_path,
+        'query_mode' => query_mode,
+        'query_profile_audit_engine' => query_profile_audit_engine,
+        'query_profile_audit_limit' => query_profile_audit_limit,
+        'query_profile_audit_output_dir' => query_profile_audit_output_dir,
+        'query_profile_audit_timeout_ms' => query_profile_audit_timeout_ms,
+        'query_profile_audit_write_markdown' => query_profile_audit_write_markdown,
+        'query_profile_max_result_set_ids' => query_profile_max_result_set_ids,
+        'query_profiles_path' => query_profiles_path,
+        'release_prefix' => release_prefix,
+        'rerank_limit' => rerank_limit,
+        'routing_mode' => routing_mode,
+        'routing_mode_grid' => routing_mode_grid,
+        'routing_shard_count' => routing_shard_count,
+        'routing_shard_layout' => routing_shard_layout,
+        'run_planner_calibration_loop' => run_planner_calibration_loop,
+        'run_structure_pair_geometry_ab' => run_structure_pair_geometry_ab,
+        'sequence_planner_calibration_output_path' => sequence_planner_calibration_output_path,
+        'sequence_planner_calibration_path' => sequence_planner_calibration_path,
+        'sequence_planner_mode' => sequence_planner_mode,
+        'similar_kmer_max_variants' => similar_kmer_max_variants,
+        'similar_kmer_threshold' => similar_kmer_threshold,
+        'simulated_read_latency_ms' => simulated_read_latency_ms,
+        'structure_coordinate_paths' => structure_coordinate_paths,
+        'structure_gram_size' => structure_gram_size,
+        'structure_pair_geometry_evidence_jsonl_path' => structure_pair_geometry_evidence_jsonl_path,
+        'structure_pair_geometry_evidence_tsv_path' => structure_pair_geometry_evidence_tsv_path,
+        'structure_pair_geometry_max_query_tokens' => structure_pair_geometry_max_query_tokens,
+        'structure_pair_geometry_min_shared_pairs' => structure_pair_geometry_min_shared_pairs,
+        'structure_pair_geometry_shift_bins' => structure_pair_geometry_shift_bins,
+        'structure_pair_geometry_summary_path' => structure_pair_geometry_summary_path,
+        'structure_search_preset' => structure_search_preset,
+        'structure_token_extractor' => structure_token_extractor,
+        'structure_tokens_path' => structure_tokens_path,
+        'target_shard_score_coverage' => target_shard_score_coverage,
+        'target_shard_score_coverage_grid' => target_shard_score_coverage_grid,
+        'tmalign_binary_path' => tmalign_binary_path,
+        'ungapped_diagonal_top_n' => ungapped_diagonal_top_n,
+        'use_structure_pair_geometry' => use_structure_pair_geometry,
+        'verification_band' => verification_band
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/benchmark',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseBenchmarkData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/gc-plan
+    # @param corpus [String] Corpus whose catalog releases should be considered for GC.
+    # @param dry_run [Boolean, nil] Keep true for a planning-only run. This primitive does not delete object bytes.
+    # @param limit [Integer, nil] Maximum release catalog rows to inspect. Defaults to 1000.
+    # @param plan_id [String, nil] Optional stable GC plan id. Defaults to a deterministic timestamped id.
+    # @param retain_last [Integer, nil] Keep at least this many newest releases in addition to current and pinned releases. Defaults to 2.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseGcPlanData]
+    def releasesGcPlan(
+      corpus:,
+      dry_run: nil,
+      limit: nil,
+      plan_id: nil,
+      retain_last: nil,
+      request_options: {}
+    )
+      body = {
+        'corpus' => corpus,
+        'dry_run' => dry_run,
+        'limit' => limit,
+        'plan_id' => plan_id,
+        'retain_last' => retain_last
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/gc-plan',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseGcPlanData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/history
+    # @param corpus [String] Immutable corpus name whose current-pointer audit chain should be listed.
+    # @param include_audit_payload [Boolean, nil] Include each decoded audit object payload in the response.
+    # @param limit [Integer, nil] Maximum publish-audit entries to follow backward from the current pointer. Defaults to 100.
+    # @param object_store_root [String, nil] Optional local or object-storage root. Defaults to the API server's release data root.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseHistoryData]
+    def releasesHistory(
+      corpus:,
+      include_audit_payload: nil,
+      limit: nil,
+      object_store_root: nil,
+      request_options: {}
+    )
+      body = {
+        'corpus' => corpus,
+        'include_audit_payload' => include_audit_payload,
+        'limit' => limit,
+        'object_store_root' => object_store_root
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/history',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseHistoryData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/list
+    # @param corpus [String, nil] Optional corpus name. When omitted, all local corpora under the release root are listed.
+    # @param limit [Integer, nil] Maximum release records returned after deterministic sorting. Defaults to 100.
+    # @param object_store_root [String, nil] Optional local object-store root. Defaults to the API server's release data root.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseListData]
+    def releasesList(
+      corpus: nil,
+      limit: nil,
+      object_store_root: nil,
+      request_options: {}
+    )
+      body = {
+        'corpus' => corpus,
+        'limit' => limit,
+        'object_store_root' => object_store_root
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/list',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseListData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/publish-current
+    # @param corpus [String, nil] Immutable corpus name. Required when ref is omitted.
+    # @param expected_previous_ref [String, nil] Optional compare-and-swap guard requiring the current pointer to match this ref before publishing.
+    # @param max_object_bytes [Integer, nil] Optional hard object-byte budget for the smoke search.
+    # @param max_object_reads [Integer, nil] Optional hard object-read budget for the smoke search.
+    # @param object_store_root [String, nil] Optional local or object-storage root. Defaults to the API server's release data root.
+    # @param reason [String, nil] Optional operator reason stored in the current pointer.
+    # @param ref [String, nil] Optional immutable release ref formatted as corpus:release_id.
+    # @param release_id [String, nil] Immutable release id. Required when ref is omitted.
+    # @param require_no_previous [Boolean, nil] Require that no current pointer already exists before publishing.
+    # @param require_zero_materialization [Boolean, nil] Require the smoke search to materialize zero database bytes.
+    # @param smoke_family [Rafflesia::Types::CorpuReleasePublishCurrentRequestSmokeFamily, nil] Optional family used for smoke search. Defaults to the first release family.
+    # @param smoke_max_hits [Integer, nil] Maximum smoke-search hits. Defaults to 1.
+    # @param smoke_query [String, nil] Optional sequence or token query used to prove the newly current release can be searched.
+    # @param smoke_query_structure_path [String, nil] Optional raw PDB/mmCIF query path used to smoke-test structure_prefilter releases.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleasePublishCurrentData]
+    def releasesPublishCurrent(
+      corpus: nil,
+      expected_previous_ref: nil,
+      max_object_bytes: nil,
+      max_object_reads: nil,
+      object_store_root: nil,
+      reason: nil,
+      ref: nil,
+      release_id: nil,
+      require_no_previous: nil,
+      require_zero_materialization: nil,
+      smoke_family: nil,
+      smoke_max_hits: nil,
+      smoke_query: nil,
+      smoke_query_structure_path: nil,
+      request_options: {}
+    )
+      body = {
+        'corpus' => corpus,
+        'expected_previous_ref' => expected_previous_ref,
+        'max_object_bytes' => max_object_bytes,
+        'max_object_reads' => max_object_reads,
+        'object_store_root' => object_store_root,
+        'reason' => reason,
+        'ref' => ref,
+        'release_id' => release_id,
+        'require_no_previous' => require_no_previous,
+        'require_zero_materialization' => require_zero_materialization,
+        'smoke_family' => smoke_family,
+        'smoke_max_hits' => smoke_max_hits,
+        'smoke_query' => smoke_query,
+        'smoke_query_structure_path' => smoke_query_structure_path
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/publish-current',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleasePublishCurrentData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/search
+    # @param candidate_rank_strategy [Rafflesia::Types::CorpuReleaseSearchRequestCandidateRankStrategy, nil] Candidate ranking key before optional verification. Defaults to shared_token_count.
+    # @param corpus [String, nil] Immutable corpus name. Required when ref is omitted.
+    # @param exact_rerank [Boolean, nil] When true for structure_prefilter, rerank returned candidates with a pairwise structure aligner using caller-supplied target_structure_paths, target_structure_objects, or release-stored coordinates.
+    # @param exact_rerank_backend [Rafflesia::Types::CorpuReleaseSearchRequestExactRerankBackend, nil] Pairwise backend used by exact_rerank. Defaults to tmalign unless a preset fills it.
+    # @param exact_rerank_rank_key [Rafflesia::Types::CorpuReleaseSearchRequestExactRerankRankKey, nil] Measurement used to order exact_rerank hits. Defaults to the backend's measured primary structural score.
+    # @param family [String, nil] Search family inside the release. Defaults to seed. Supported values are seed, sequence_prefilter, and structure_prefilter.
+    # @param foldseek_binary_path [String, nil] Optional absolute Foldseek binary path used for query structure-token extraction.
+    # @param max_candidates [Integer, nil] Optional cap on ranked candidates before max_hits; truncation is reported in warnings.
+    # @param max_hits [Integer, nil] Maximum number of hits returned; defaults to 10.
+    # @param max_object_bytes [Integer, nil] Optional object-byte budget. The release router uses it for pre-read planning when possible, and the server enforces it against observed bytes.
+    # @param max_object_reads [Integer, nil] Optional object-read budget. The release router uses it for pre-read planning when possible, and the server enforces it against observed reads.
+    # @param max_query_posting_blocks [Integer, nil] Optional cap on selected query posting blocks; truncation is reported in warnings.
+    # @param max_shards [Integer, nil] Optional cap on routed release shards read for sharded corpus releases.
+    # @param max_verifications [Integer, nil] Optional cap on candidates aligned in verification modes.
+    # @param object_store_root [String, nil] Optional local object-store root. Defaults to the API server's release data root.
+    # @param postings_range_coalesce_gap_bytes [Integer, nil] Maximum gap in bytes between postings ranges that may be coalesced.
+    # @param postings_range_coalesce_max_span_bytes [Integer, nil] Maximum fused postings range span in bytes.
+    # @param query [String, nil] Query sequence, sequence ID, local FASTA path, structure-token string, or local structure-token file depending on family.
+    # @param query_mode [Rafflesia::Types::CorpuReleaseSearchRequestQueryMode, nil] Release-contract query mode. Verification modes use in-process alignment kernels for supported families while keeping candidate-generation warnings explicit. Defaults to candidate_only.
+    # @param query_sequence [String, nil] Optional one-letter amino-acid sequence aligned to a structure-token query for structure_prefilter verification.
+    # @param query_structure_file_name [String, nil] Stable filename used when staging query_structure_object_id for structure-token extraction.
+    # @param query_structure_object_id [String, nil] Optional raw PDB/mmCIF query object id for the structure_prefilter family. The server derives structure tokens before querying.
+    # @param query_structure_path [String, nil] Optional raw PDB/mmCIF query path for the structure_prefilter family. The server derives structure tokens before querying.
+    # @param ref [String, nil] Optional immutable release ref formatted as corpus:release_id, corpus:current, or corpus:latest.
+    # @param release_id [String, nil] Immutable release id. Required when ref is omitted.
+    # @param require_zero_materialization [Boolean, nil] Require the release-native path to materialize zero database bytes.
+    # @param rerank_limit [Integer, nil] Maximum returned candidates to exact-rerank. Defaults to max_hits.
+    # @param routing_mode [Rafflesia::Types::CorpuReleaseSearchRequestRoutingMode, nil] Router selection mode for sharded corpus releases. Defaults to auto.
+    # @param sequence_planner_calibration_path [String, nil] Optional local JSON planner calibration profile produced by a release benchmark. Used by v7/v8 sequence planners.
+    # @param sequence_planner_mode [Rafflesia::Types::CorpuReleaseSearchRequestSequencePlannerMode, nil] Planner mode for sequence_prefilter searches. Defaults to v4 unless a sequence_planner_calibration_path is provided.
+    # @param similar_kmer_max_variants [Integer, nil] Maximum similar posting grams retained per query gram when similar_kmer_threshold is set. Defaults to all matching grams.
+    # @param similar_kmer_threshold [Integer, nil] Optional 3Di substitution-matrix threshold for expanding query grams to similar posting grams in structure_prefilter.
+    # @param structure_pair_geometry_max_query_tokens [Integer, nil] Maximum residue-pair query tokens selected by increasing posting frequency. Defaults to max_query_posting_blocks, then 256.
+    # @param structure_pair_geometry_min_shared_pairs [Integer, nil] Minimum shared residue-pair tokens required for pair-only candidate promotion. Defaults to 1.
+    # @param structure_pair_geometry_shift_bins [Boolean, nil] When true, expand residue-pair query tokens to adjacent sequence-distance bins to test boundary-shift tolerance.
+    # @param structure_reverse_correction [Boolean, nil] When true, subtract a reverse-query 3Di/AA alignment score during native structure verification. This is Foldseek-inspired correction evidence, not exact upstream neural-net calibration.
+    # @param structure_search_preset [Rafflesia::Types::CorpuReleaseSearchRequestStructureSearchPreset, nil] Optional structure_prefilter search preset that fills unset candidate-generation and verification knobs from measured 3Di Pareto policies.
+    # @param structure_token_extractor [Rafflesia::Types::CorpuReleaseSearchRequestStructureTokenExtractor, nil] Structure-token extractor for raw structure queries. auto preserves current behavior: use foldseek when foldseek_binary_path is set, otherwise use the native geometry tokenizer.
+    # @param target_shard_score_coverage [Float, nil] Adaptive router target coverage over query-token shard scores, in (0,1].
+    # @param target_structure_objects [Hash{String => Rafflesia::CorpuReleaseStructureInputObject}, nil] Optional hit id to raw PDB/mmCIF object map used by exact_rerank.
+    # @param target_structure_paths [Hash{String => String}, nil] Optional hit id to local PDB/mmCIF path map used by exact_rerank.
+    # @param tmalign_binary_path [String, nil] Optional absolute TM-align binary path used for exact_rerank.
+    # @param ungapped_diagonal_top_n [Integer, nil] Maximum candidate diagonals rescored by ungapped 3Di matrix HSP when candidate_rank_strategy is ungapped_3di_matrix. Defaults to 4.
+    # @param use_structure_pair_geometry [Boolean, nil] When true, augment structure_prefilter candidate generation with deterministic residue-pair geometry postings.
+    # @param verification_band [Integer, nil] Optional diagonal band for bounded verification alignment.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseSearchData]
+    def releasesSearch(
+      candidate_rank_strategy: nil,
+      corpus: nil,
+      exact_rerank: nil,
+      exact_rerank_backend: nil,
+      exact_rerank_rank_key: nil,
+      family: nil,
+      foldseek_binary_path: nil,
+      max_candidates: nil,
+      max_hits: nil,
+      max_object_bytes: nil,
+      max_object_reads: nil,
+      max_query_posting_blocks: nil,
+      max_shards: nil,
+      max_verifications: nil,
+      object_store_root: nil,
+      postings_range_coalesce_gap_bytes: nil,
+      postings_range_coalesce_max_span_bytes: nil,
+      query: nil,
+      query_mode: nil,
+      query_sequence: nil,
+      query_structure_file_name: nil,
+      query_structure_object_id: nil,
+      query_structure_path: nil,
+      ref: nil,
+      release_id: nil,
+      require_zero_materialization: nil,
+      rerank_limit: nil,
+      routing_mode: nil,
+      sequence_planner_calibration_path: nil,
+      sequence_planner_mode: nil,
+      similar_kmer_max_variants: nil,
+      similar_kmer_threshold: nil,
+      structure_pair_geometry_max_query_tokens: nil,
+      structure_pair_geometry_min_shared_pairs: nil,
+      structure_pair_geometry_shift_bins: nil,
+      structure_reverse_correction: nil,
+      structure_search_preset: nil,
+      structure_token_extractor: nil,
+      target_shard_score_coverage: nil,
+      target_structure_objects: nil,
+      target_structure_paths: nil,
+      tmalign_binary_path: nil,
+      ungapped_diagonal_top_n: nil,
+      use_structure_pair_geometry: nil,
+      verification_band: nil,
+      request_options: {}
+    )
+      body = {
+        'candidate_rank_strategy' => candidate_rank_strategy,
+        'corpus' => corpus,
+        'exact_rerank' => exact_rerank,
+        'exact_rerank_backend' => exact_rerank_backend,
+        'exact_rerank_rank_key' => exact_rerank_rank_key,
+        'family' => family,
+        'foldseek_binary_path' => foldseek_binary_path,
+        'max_candidates' => max_candidates,
+        'max_hits' => max_hits,
+        'max_object_bytes' => max_object_bytes,
+        'max_object_reads' => max_object_reads,
+        'max_query_posting_blocks' => max_query_posting_blocks,
+        'max_shards' => max_shards,
+        'max_verifications' => max_verifications,
+        'object_store_root' => object_store_root,
+        'postings_range_coalesce_gap_bytes' => postings_range_coalesce_gap_bytes,
+        'postings_range_coalesce_max_span_bytes' => postings_range_coalesce_max_span_bytes,
+        'query' => query,
+        'query_mode' => query_mode,
+        'query_sequence' => query_sequence,
+        'query_structure_file_name' => query_structure_file_name,
+        'query_structure_object_id' => query_structure_object_id,
+        'query_structure_path' => query_structure_path,
+        'ref' => ref,
+        'release_id' => release_id,
+        'require_zero_materialization' => require_zero_materialization,
+        'rerank_limit' => rerank_limit,
+        'routing_mode' => routing_mode,
+        'sequence_planner_calibration_path' => sequence_planner_calibration_path,
+        'sequence_planner_mode' => sequence_planner_mode,
+        'similar_kmer_max_variants' => similar_kmer_max_variants,
+        'similar_kmer_threshold' => similar_kmer_threshold,
+        'structure_pair_geometry_max_query_tokens' => structure_pair_geometry_max_query_tokens,
+        'structure_pair_geometry_min_shared_pairs' => structure_pair_geometry_min_shared_pairs,
+        'structure_pair_geometry_shift_bins' => structure_pair_geometry_shift_bins,
+        'structure_reverse_correction' => structure_reverse_correction,
+        'structure_search_preset' => structure_search_preset,
+        'structure_token_extractor' => structure_token_extractor,
+        'target_shard_score_coverage' => target_shard_score_coverage,
+        'target_structure_objects' => target_structure_objects,
+        'target_structure_paths' => target_structure_paths,
+        'tmalign_binary_path' => tmalign_binary_path,
+        'ungapped_diagonal_top_n' => ungapped_diagonal_top_n,
+        'use_structure_pair_geometry' => use_structure_pair_geometry,
+        'verification_band' => verification_band
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/search',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseSearchData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/show
+    # @param corpus [String, nil] Immutable corpus name. Required when ref is omitted.
+    # @param include_evidence_channels [Boolean, nil] Include typed evidence-channel contracts derived from the release manifest.
+    # @param include_manifest [Boolean, nil] Include the parsed release manifest in the response.
+    # @param include_runtime_contract [Boolean, nil] Include release evidence-channel and cost-contract observations derived from the release manifest.
+    # @param object_store_root [String, nil] Optional local object-store root. Defaults to the API server's release data root.
+    # @param ref [String, nil] Optional immutable release ref formatted as corpus:release_id, corpus:current, or corpus:latest.
+    # @param release_id [String, nil] Immutable release id. Required when ref is omitted.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseShowData]
+    def releasesShow(
+      corpus: nil,
+      include_evidence_channels: nil,
+      include_manifest: nil,
+      include_runtime_contract: nil,
+      object_store_root: nil,
+      ref: nil,
+      release_id: nil,
+      request_options: {}
+    )
+      body = {
+        'corpus' => corpus,
+        'include_evidence_channels' => include_evidence_channels,
+        'include_manifest' => include_manifest,
+        'include_runtime_contract' => include_runtime_contract,
+        'object_store_root' => object_store_root,
+        'ref' => ref,
+        'release_id' => release_id
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/show',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseShowData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/releases/validate
+    # @param corpus [String, nil] Immutable corpus name. Required when ref is omitted.
+    # @param max_object_bytes [Integer, nil] Optional hard object-byte budget for the smoke search.
+    # @param max_object_reads [Integer, nil] Optional hard object-read budget for the smoke search.
+    # @param object_store_root [String, nil] Optional local or object-storage root. Defaults to the API server's release data root.
+    # @param ref [String, nil] Optional immutable release ref formatted as corpus:release_id, including corpus:current.
+    # @param release_id [String, nil] Immutable release id. Required when ref is omitted.
+    # @param require_zero_materialization [Boolean, nil] Require the smoke search to materialize zero database bytes.
+    # @param smoke_family [Rafflesia::Types::CorpuReleaseValidateRequestSmokeFamily, nil] Optional family used for smoke search. Defaults to the first release family.
+    # @param smoke_max_hits [Integer, nil] Maximum smoke-search hits. Defaults to 1.
+    # @param smoke_query [String, nil] Optional sequence or token query used to prove the release can be searched.
+    # @param smoke_query_structure_path [String, nil] Optional raw PDB/mmCIF query path used to smoke-test structure_prefilter releases.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeCorpusReleaseValidateData]
+    def releasesValidate(
+      corpus: nil,
+      max_object_bytes: nil,
+      max_object_reads: nil,
+      object_store_root: nil,
+      ref: nil,
+      release_id: nil,
+      require_zero_materialization: nil,
+      smoke_family: nil,
+      smoke_max_hits: nil,
+      smoke_query: nil,
+      smoke_query_structure_path: nil,
+      request_options: {}
+    )
+      body = {
+        'corpus' => corpus,
+        'max_object_bytes' => max_object_bytes,
+        'max_object_reads' => max_object_reads,
+        'object_store_root' => object_store_root,
+        'ref' => ref,
+        'release_id' => release_id,
+        'require_zero_materialization' => require_zero_materialization,
+        'smoke_family' => smoke_family,
+        'smoke_max_hits' => smoke_max_hits,
+        'smoke_query' => smoke_query,
+        'smoke_query_structure_path' => smoke_query_structure_path
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/releases/validate',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeCorpusReleaseValidateData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # GET /v1/datasets/show
+    # @param name [String]
+    # @param version [String, nil]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetShowData]
+    def show(
+      name:,
+      version: nil,
+      request_options: {}
+    )
+      params = {
+        'name' => name,
+        'version' => version
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: '/v1/datasets/show',
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetShowData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/source-snapshots/fetch
+    # @param artifact_kind [String] Artifact kind allowed by the selected source profile.
+    # @param expected_etag [String, nil] Expected strong HTTP entity tag from a prior preflight when the upstream publishes no checksum. Sent as If-Match; Rafflesia still computes SHA-256 as the content identity.
+    # @param expected_md_5 [String, nil] Expected upstream MD5 digest when that is the only checksum published by the source. Rafflesia always computes and records SHA-256 as the content identity.
+    # @param expected_sha_256 [String, nil] Expected SHA-256 digest, with or without the sha256: prefix. At least one expected checksum is required.
+    # @param expected_size_bytes [Integer, nil] Optional exact byte length checked before storing the artifact.
+    # @param max_bytes [Integer] Required explicit download ceiling. The fetch stops before exceeding it.
+    # @param source [String] Source profile name returned by datasets source-snapshots profiles.
+    # @param url [String] Exact HTTPS artifact URL on an allowlisted official host and path.
+    # @param version [String] Pinned upstream release label recorded in provenance.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotFetchData]
+    def sourceSnapshotsFetch(
+      artifact_kind:,
+      max_bytes:,
+      source:,
+      url:,
+      version:,
+      expected_etag: nil,
+      expected_md_5: nil,
+      expected_sha_256: nil,
+      expected_size_bytes: nil,
+      request_options: {}
+    )
+      body = {
+        'artifact_kind' => artifact_kind,
+        'expected_etag' => expected_etag,
+        'expected_md5' => expected_md_5,
+        'expected_sha256' => expected_sha_256,
+        'expected_size_bytes' => expected_size_bytes,
+        'max_bytes' => max_bytes,
+        'source' => source,
+        'url' => url,
+        'version' => version
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/source-snapshots/fetch',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotFetchData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/source-snapshots/import
+    # @param batch_rows [Integer, nil] Rows per durable Parquet checkpoint part in streaming mode. Defaults to 50000.
+    # @param checkpoint_path [String, nil] Explicit streaming checkpoint JSON path. Defaults below output_dir and is never server-side query state.
+    # @param database [String, nil] Logical database name carried into the emitted records relation. Defaults to source.
+    # @param format [String, nil] Input format. Defaults to fasta.
+    # @param import_mode [Rafflesia::Types::DatasetSourceSnapshotImportRequestImportMode, nil] catalog preserves the small-catalog entry manifest; streaming reads bounded batches and is required for full UniProt releases. Defaults to catalog for compatibility.
+    # @param input_object_id [String, nil] Object id containing FASTA bytes to import instead of input_path.
+    # @param input_path [String, nil] Local FASTA path to import as the source snapshot.
+    # @param output_dir [String, nil] Directory for local relation artifacts. Defaults under the server data root.
+    # @param parser [Rafflesia::Types::DatasetSourceSnapshotImportRequestParser, nil] Header parser used for alias extraction. Defaults from source.
+    # @param release [String, nil] Immutable release carried into the emitted records relation. Defaults to version.
+    # @param resume [Boolean, nil] Resume a streaming import from its explicit checkpoint after verifying the immutable input hash and parameters.
+    # @param source [String] Source database name, for example uniprot.
+    # @param version [String] Immutable source database version or release label.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotImportData]
+    def sourceSnapshotsImport(
+      source:,
+      version:,
+      batch_rows: nil,
+      checkpoint_path: nil,
+      database: nil,
+      format: nil,
+      import_mode: nil,
+      input_object_id: nil,
+      input_path: nil,
+      output_dir: nil,
+      parser: nil,
+      release: nil,
+      resume: nil,
+      request_options: {}
+    )
+      body = {
+        'batch_rows' => batch_rows,
+        'checkpoint_path' => checkpoint_path,
+        'database' => database,
+        'format' => format,
+        'import_mode' => import_mode,
+        'input_object_id' => input_object_id,
+        'input_path' => input_path,
+        'output_dir' => output_dir,
+        'parser' => parser,
+        'release' => release,
+        'resume' => resume,
+        'source' => source,
+        'version' => version
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/source-snapshots/import',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotImportData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/source-snapshots/ingest
+    # @param allow_duplicate [Boolean, nil] Insert rows even when this ingestion id already succeeded.
+    # @param dry_run [Boolean, nil] Return the deterministic ClickHouse ingest plan without mutating ClickHouse.
+    # @param ingest_mode [Rafflesia::Types::DatasetSourceSnapshotIngestRequestIngestMode, nil]
+    # @param manifest_object_id [String, nil] Object id containing a source snapshot manifest.
+    # @param ref [String, nil] Immutable source snapshot ref formatted source:version.
+    # @param source [String, nil] Source database name. Required when ref and manifest_object_id are omitted.
+    # @param version [String, nil] Source database version. Required when ref and manifest_object_id are omitted.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotIngestData]
+    def sourceSnapshotsIngest(
+      allow_duplicate: nil,
+      dry_run: nil,
+      ingest_mode: nil,
+      manifest_object_id: nil,
+      ref: nil,
+      source: nil,
+      version: nil,
+      request_options: {}
+    )
+      body = {
+        'allow_duplicate' => allow_duplicate,
+        'dry_run' => dry_run,
+        'ingest_mode' => ingest_mode,
+        'manifest_object_id' => manifest_object_id,
+        'ref' => ref,
+        'source' => source,
+        'version' => version
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/source-snapshots/ingest',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotIngestData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/source-snapshots/preflight
+    # @param additional_working_bytes [Integer, nil] Caller-supplied extra local working-space requirement for later import or normalization.
+    # @param artifact_kind [String] Artifact kind allowed by the selected source profile.
+    # @param minimum_free_bytes [Integer, nil] Local free-space reserve that must remain after acquisition. Defaults to 10 GiB.
+    # @param source [String] Source profile name returned by datasets source-snapshots profiles.
+    # @param url [String] Exact HTTPS artifact URL on an allowlisted official host and path.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotPreflightData]
+    def sourceSnapshotsPreflight(
+      artifact_kind:,
+      source:,
+      url:,
+      additional_working_bytes: nil,
+      minimum_free_bytes: nil,
+      request_options: {}
+    )
+      body = {
+        'additional_working_bytes' => additional_working_bytes,
+        'artifact_kind' => artifact_kind,
+        'minimum_free_bytes' => minimum_free_bytes,
+        'source' => source,
+        'url' => url
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/source-snapshots/preflight',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotPreflightData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # GET /v1/datasets/source-snapshots/profiles
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotProfileListData]
+    def sourceSnapshotsProfiles(request_options: {})
+      response = @client.request(
+        method: :get,
+        path: '/v1/datasets/source-snapshots/profiles',
+        auth: true,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotProfileListData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/source-snapshots/show
+    # @param include_manifest [Boolean, nil] Include the parsed source snapshot manifest in the response.
+    # @param manifest_object_id [String, nil] Object id containing a source snapshot manifest.
+    # @param ref [String, nil] Immutable source snapshot ref formatted source:version.
+    # @param source [String, nil] Source database name. Required when ref and manifest_object_id are omitted.
+    # @param version [String, nil] Source database version. Required when ref and manifest_object_id are omitted.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotShowData]
+    def sourceSnapshotsShow(
+      include_manifest: nil,
+      manifest_object_id: nil,
+      ref: nil,
+      source: nil,
+      version: nil,
+      request_options: {}
+    )
+      body = {
+        'include_manifest' => include_manifest,
+        'manifest_object_id' => manifest_object_id,
+        'ref' => ref,
+        'source' => source,
+        'version' => version
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/source-snapshots/show',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotShowData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/source-snapshots/status
+    # @param manifest_object_id [String, nil] Object id containing a source snapshot manifest.
+    # @param ref [String, nil] Immutable source snapshot ref formatted source:version.
+    # @param source [String, nil] Source database name. Required when ref and manifest_object_id are omitted.
+    # @param version [String, nil] Source database version. Required when ref and manifest_object_id are omitted.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotStatusData]
+    def sourceSnapshotsStatus(
+      manifest_object_id: nil,
+      ref: nil,
+      source: nil,
+      version: nil,
+      request_options: {}
+    )
+      body = {
+        'manifest_object_id' => manifest_object_id,
+        'ref' => ref,
+        'source' => source,
+        'version' => version
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/source-snapshots/status',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotStatusData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/source-snapshots/validate
+    # @param manifest_object_id [String, nil] Object id containing a source snapshot manifest.
+    # @param ref [String, nil] Immutable source snapshot ref formatted source:version.
+    # @param require_catalog [Boolean, nil] Require the sequence catalog manifest object to be reachable.
+    # @param require_relation [Boolean, nil] Require the published source_sequence_records relation to be reachable and row-count consistent.
+    # @param source [String, nil] Source database name. Required when ref and manifest_object_id are omitted.
+    # @param version [String, nil] Source database version. Required when ref and manifest_object_id are omitted.
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetSourceSnapshotValidateData]
+    def sourceSnapshotsValidate(
+      manifest_object_id: nil,
+      ref: nil,
+      require_catalog: nil,
+      require_relation: nil,
+      source: nil,
+      version: nil,
+      request_options: {}
+    )
+      body = {
+        'manifest_object_id' => manifest_object_id,
+        'ref' => ref,
+        'require_catalog' => require_catalog,
+        'require_relation' => require_relation,
+        'source' => source,
+        'version' => version
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/source-snapshots/validate',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetSourceSnapshotValidateData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # POST /v1/datasets/validation/validate
+    # @param manifest_path [String]
+    # @param require_no_failures [Boolean, nil]
+    # @param require_source_files [Boolean, nil]
+    # @param skip_row_count_check [Boolean, nil]
+    # @param tables [Array<String>, nil]
+    # @param request_options [Hash] (see Rafflesia::Types::RequestOptions)
+    # @return [Rafflesia::EnvelopeDatasetValidateData]
+    def validationValidate(
+      manifest_path:,
+      require_no_failures: nil,
+      require_source_files: nil,
+      skip_row_count_check: nil,
+      tables: nil,
+      request_options: {}
+    )
+      body = {
+        'manifest_path' => manifest_path,
+        'require_no_failures' => require_no_failures,
+        'require_source_files' => require_source_files,
+        'skip_row_count_check' => skip_row_count_check,
+        'tables' => tables
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/datasets/validation/validate',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Rafflesia::EnvelopeDatasetValidateData.new(response.body)
+      result.last_response = Rafflesia::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+  end
+end